summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-04-02 21:16:13 +0000
committerKarl Berry <karl@freefriends.org>2018-04-02 21:16:13 +0000
commit1610548529befd1cb7d72da00a3a889261436642 (patch)
tree04d20de3c80be1f24b619689213ebb794979c0ee /Master/texmf-dist/source/latex/koma-script/doc
parent635bc4f06033428fe01440c71f242ec9b68fe092 (diff)
koma-script (2apr18)
git-svn-id: svn://tug.org/texlive/trunk@47249 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc')
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/bin/genhtmlidx.pl6
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/adrconvnote.tex44
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/authorpart.tex38
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-compatibility.tex190
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-dictum.tex192
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-draftmode.tex89
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-fontsize.tex175
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-footnotes.tex525
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-headfootheight.tex137
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-interleafpage.tex296
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-lists.tex606
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-marginpar.tex79
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-oddorevenpage.tex80
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-options.tex260
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-pagestylemanipulation.tex1086
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-parmarkup.tex209
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-textmarkup.tex612
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-titles.tex608
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-typearea.tex49
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/expertpart.tex20
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/guide-english.tex70
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/guide.tex10
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/introduction.tex395
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/japanlco.tex154
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/linkalias.tex5
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/preface.tex92
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scraddr.tex200
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrbase.tex1673
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex1568
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex5322
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex346
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrextend.tex162
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrhack.tex330
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrjura.tex978
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrjuraexample.tex141
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-notecolumn-example.tex62
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-notecolumn.tex904
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage-experts.tex679
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage.tex1271
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer.tex1911
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlfile.tex763
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2-experts.tex2157
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex3475
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2examples.dtx66
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrwfile.tex314
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex2479
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/typearea-experts.tex232
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/typearea.tex2232
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/guide.bib112
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/guide.tex10
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/linkalias.tex5
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/adrconvnote.tex8
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/authorpart.tex7
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-compatibility.tex81
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-dictum.tex76
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-draftmode.tex64
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-fontsize.tex84
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-footnotes.tex155
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-headfootheight.tex79
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-interleafpage.tex165
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-lists.tex191
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-marginpar.tex19
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-oddorevenpage.tex10
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-options.tex172
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-pagestylemanipulation.tex550
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-parmarkup.tex86
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-textmarkup.tex256
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-titles.tex201
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-typearea.tex24
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/expertpart.tex7
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide-ngerman.tex14
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide.tex10
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/introduction.tex29
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/linkalias.tex5
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/preface.tex48
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scraddr.tex72
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbase.tex950
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle-experts.tex814
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex1897
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrdatetime.tex32
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrextend.tex83
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrhack.tex93
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrjura.tex411
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrjuraexample.tex2
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-notecolumn.tex317
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage-experts.tex410
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage.tex659
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex662
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex180
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex954
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex1485
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2examples.dtx102
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrwfile.tex88
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/tocbasic.tex1121
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex84
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea.tex595
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/scrguide.cls298
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/scrguide.html1838
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/scrguide.pdfbin3142588 -> 3142480 bytes
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/scrguien.html1853
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/scrguien.pdfbin2940370 -> 2991664 bytes
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/scrpage2.tex8
102 files changed, 27425 insertions, 23343 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/bin/genhtmlidx.pl b/Master/texmf-dist/source/latex/koma-script/doc/bin/genhtmlidx.pl
index c0f7be336ae..da8837f8958 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/bin/genhtmlidx.pl
+++ b/Master/texmf-dist/source/latex/koma-script/doc/bin/genhtmlidx.pl
@@ -81,14 +81,14 @@ while ( $auxfile=shift ) {
open AUX,"<$auxfile" or die "Cannot read $auxfile!\n";
while (<AUX>) {
my $line=$_;
- if ( /^\\newlabel{(desc:[^}]+)}{(.*)}$/ ) {
+ if ( /^\\newlabel\{(desc:[^\}]+)\}\{(.*)\}$/ ) {
my $label=$1;
my $refargs=$2;
- if ( $refargs =~ /^{([^{}]*({((?:(?>[^{}]*)|(?1))*)})*)}{([^}]+)}(.*)$/ ) {
+ if ( $refargs =~ /^\{([^\{\}]*(\{((?:(?>[^\{\}]*)|(?1))*)\})*)\}\{([^\}]+)\}(.*)$/ ) {
my $ref=$1;
my $page=$4;
my $rest=$5;
- if ( $rest =~ /^{([^{}]*({((?:(?>[^{}]*)|(?1))*)})*)}{([^}]*)}{(.*)}$/ ) {
+ if ( $rest =~ /^\{([^\{\}]*(\{((?:(?>[^\{\}]*)|(?1))*)\})*)\}\{([^\}]*)\}\{(.*)\}$/ ) {
my $title=$1;
my $anchor=$4;
my $ignore=$5;
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/adrconvnote.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/adrconvnote.tex
index e9b26afb6b7..75b9b8f392c 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/adrconvnote.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/adrconvnote.tex
@@ -1,6 +1,6 @@
% ======================================================================
% adrconvnote.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% adrconvnote.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,12 +46,13 @@
% ======================================================================
\KOMAProvidesFile{adrconvnote.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (chapter: adrconv)]
-\translator{Jens-Uwe Morawski\and Gernot Hassenpflug\and Markus Kohm}
+\translator{Jens-Uwe Morawski\and Gernot Hassenpflug\and Markus Kohm\and
+ Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-01-29
\chapter{Creating Address Files from an Address Database}%
\labelbase{addrconv}%
@@ -59,12 +60,11 @@
\Index{address>database}%
\IndexPackage{addrconv}
-In former versions of {\KOMAScript} the package \Package{addrconv} was
-a permanent part of the {\KOMAScript} system. The chief involvement
-with {\KOMAScript} was that with the help of \Package{addrconv} it was
-possible from an address database in {\BibTeX} format to create
-address files compatible with the {\KOMAScript} letter class or with
-the package \Package{scraddr}.
+In previous versions of \KOMAScript{}, the \Package{addrconv} package was an
+integral part of the \KOMAScript{} system. The main connection to
+\KOMAScript{} was that with the help of this package, it was possible to
+create address files compatible with the \KOMAScript{} letter class or with
+the \Package{scraddr} package from an address database in \BibTeX{} format.
\begin{lstlisting}[morekeywords={@address}]
@address{HMUS,
@@ -80,19 +80,17 @@ the package \Package{scraddr}.
}
\end{lstlisting}
-From entries such as that given above, address files can be generated.
-For this \Package{addrconv} employs {\BibTeX} and various {\BibTeX}
-styles. Additionally, there are some {\LaTeX} files which can help to
-create various telephone and address lists for printing.
+From entries such as the one above, you can use \BibTeX{} and various
+{\BibTeX} styles to create address files. There are also some special \LaTeX{}
+files that make it possible to create various telephone and address lists from
+the address files.
-However, the package \Package{addrconv} was actually an independent
-package, since besides what is required for {\KOMAScript} it includes
-several more interesting features. Therefore, the package
-\Package{addrconv} has for some time already been removed from the
-{\KOMAScript} system. The package \Package{adrconv}, with a single
-\emph{d}, entirely replaces \Package{addrconv}. If it is not included
-in your {\TeX} distribution then it can be downloaded from
-\cite{package:adrconv} and you can install it separately.
+However, the \Package{addrconv} package was actually an independent package,
+including features beyond what is required for \KOMAScript{}. That is why
+\Package{addrconv} has not been included in \KOMAScript{} for some time. The
+\Package{adrconv} package, with a single \emph{d}, entirely replaces
+\Package{addrconv}. If it is not included in your \TeX{} distribution, you can
+download it from \cite{package:adrconv} and install it separately.
%%% Local Variables:
%%% mode: latex
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/authorpart.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/authorpart.tex
index 78be0e66a7c..37b4d7bc8a5 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/authorpart.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/authorpart.tex
@@ -1,6 +1,6 @@
% ======================================================================
% authorpart.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% authorpart.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,32 +46,30 @@
% ======================================================================
\ProvidesFile{authorpart.tex}[2012/04/02 Part KOMA-Script for Authors]
-\translator{Markus Kohm\and Krickette Murabayashi}
+\translator{Markus Kohm\and Krickette Murabayashi\and Karl Hagen}
\setpartpreamble{%
\vspace*{2\baselineskip}%
\setlength{\parindent}{1em}%
- \noindent In this part you may find information for authors of articles,
- reports, books, and letters. It is assumed that the average user is less
- interested in the implementation of \KOMAScript{} or in the problems of
- implementing \KOMAScript. Also, the average user isn't interested in
- obsolete options and instructions. He wants to know how he can achieve
- things using current options and instructions. Some users may be interested
- in typographic background information.
+ \noindent This part provides information for writers of articles, reports,
+ books, and letters. The average user is probably less interested in how
+ things are implemented in \KOMAScript{} and what pitfalls exist. Also,
+ normal users aren't interested in obsolete options and instructions. They
+ want to know how to achieve things using current options and instructions,
+ and perhaps in some background information about typography.
- In this part, the few passages that contain additional information and
- justification, and therefore are of less interest for the impatient reader,
- have been set in sans serif font and can be skipped if necessary. For those
- who are interested in more information about implementation, side effects
- with other packages, and obsolete options and instructions, please refer to
- \autoref{part:forExperts} on \autopageref{part:forExperts}. Furthermore,
- that part of the \KOMAScript{} guide describes all the features that were
- created specially for writers of packages and classes.%
+ The few passages in this part which contain extra information and
+ explanations that may be of less interest for the impatient reader are set
+ in a sans-serif typeface and can be skipped if desired. For those who are
+ interested in more information about the implementation, side-effects with
+ other packages, or obsolete options and instructions, please refer to
+ \autoref{part:forExperts} beginning on \autopageref{part:forExperts}. That
+ part of the \KOMAScript{} guide also describes all the features that were
+ created specially for authors of packages and classes.%
}
-\part{\KOMAScript{} for Authors}
-\label{part:forAuthors}
+\part{\KOMAScript{} for Authors\label{part:forAuthors}}
\endinput
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-compatibility.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-compatibility.tex
index f397b67f842..bed043d8d37 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-compatibility.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-compatibility.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-compatibility.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-compatibility.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,11 +46,11 @@
% ======================================================================
\KOMAProvidesFile{common-compatibility.tex}
- [$Date: 2017-03-22 09:50:43 +0100 (Wed, 22 Mar 2017) $
+ [$Date: 2018-02-28 13:23:23 +0100 (Wed, 28 Feb 2018) $
KOMA-Script guide (common paragraphs)]
-\translator{Markus Kohm\and Krickette Murabayashi}
+\translator{Markus Kohm\and Krickette Murabayashi\and Karl Hagen}
-% Date of the translated German file: 2017-03-22
+% Date of the translated German file: 2018-01-30
\section{Compatibility with Earlier Versions of \KOMAScript}
\seclabel{compatibilityOptions}
@@ -58,122 +58,138 @@
\BeginIndex{}{Compatibility}
\IfThisCommonFirstRun{}{%
- It applies, mutatis mutandis, what is written in
- \autoref{sec:\ThisCommonFirstLabelBase.compatibilityOptions}.
- \IfThisCommonLabelBase{scrlttr2}{However, this feature exists at
- \Class{scrlttr2} since version~2.9t. }%
- So if you have alread read and understood
- \autoref{sec:\ThisCommonFirstLabelBase.compatibilityOptions} you can
- switch to \autopageref{sec:\ThisCommonLabelBase.compatibilityOptions.next},
+ The information in
+ \autoref{sec:\ThisCommonFirstLabelBase.compatibilityOptions} applies equally
+ to this chapter.
+ \IfThisCommonLabelBase{scrlttr2}{However, this feature has existed in
+ \Class{scrlttr2} since version~2.9t, whereas \Package{scrletter} does not
+ offer it. }{}%
+ So if you have already read and understood
+ \autoref{sec:\ThisCommonFirstLabelBase.compatibilityOptions} you can skip
+ ahead to \autopageref{sec:\ThisCommonLabelBase.compatibilityOptions.next},
\autopageref{sec:\ThisCommonLabelBase.compatibilityOptions.next}.%
}
-\IfThisCommonLabelBase{typearea}{%
- Those who achieve their documents in source code set utmost value to the
- fact that future \LaTeX{} runs will yield exactly the same
- result. Nevertheless, in some cases improvement and bug corrections of
- packages will result in changes of the behaviour and make-up. But sometimes
- this is not wanted.%
+\IfThisCommonLabelBaseOneOf{typearea,maincls,scrlttr2,scrextend}{%
+ Those who produce their documents from source code typically attach the
+ utmost importance to the fact that future \LaTeX{} runs will yield exactly
+ the same result. In some cases, however, improvements and bug fixes to the
+ \IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{class}{package} will
+ result in changes of behaviour, especially to the layout. This, however,
+ may be undesirable.%
}{%
- \IfThisCommonLabelBase{maincls}{%
- Those who achieve their documents in source code set utmost value to the
- fact that future \LaTeX{} runs will yield exactly the same
- result. However, sometimes improvement and bug corrections of classes will
- result in changes of the behaviour and make-up. But sometimes this is not
- wanted. }{%
- \IfThisCommonLabelBase{scrextend}{%
- Those who achieve their documents in source code set utmost value to the
- fact that future \LaTeX{} runs will yield exactly the same result. In
- some cases improvement and bug corrections of packages will result in
- changes of the behaviour and make-up. But sometimes this is not wanted.%
- }{%
- \IfThisCommonLabelBase{scrlttr2}{%
- In some cases improvement and bug corrections of classes will result
- in changes of the behaviour and make-up. But sometimes this is not
- wanted.%
- }{\InternalCommonFileBaseError}%
- }%
- }%
-}
+ % \IfThisCommonLabelBase{scrextend}{%
+ % In some cases, improvements and bug fixes to the package will result
+ % in changes of behaviour, especially to the layout. This, however,
+ % may be undesirable. Those who produce their documents from source code
+ % typically attach the utmost importance to the fact that future
+ % \LaTeX{} runs will yield exactly the same result.%
+ % }{%
+ \ThisCommonLabelBaseFailure
+ % \IfThisCommonLabelBase{scrlttr2}{%
+ % In some cases, improvements and bug fixes to the package will result
+ % in changes of behaviour, especially to the layout. This, however,
+ % may be undesirable.
+ % }{}%
+ % }%
+}%
+
\begin{Declaration}
\OptionVName{version}{value}%
\OptionValue{version}{first}%
\OptionValue{version}{last}
\end{Declaration}
-\IfThisCommonLabelBase{scrextend}{At }{Since }%
-\ChangedAt{v2.96a}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
-\ChangedAt{v2.9t}{\Class{scrlttr2}}%
-\ChangedAt{v3.01b}{\Package{typearea}}%
-\IfThisCommonLabelBase{typearea}{%
- version~3.01b of \Package{typearea} }{%
- \IfThisCommonLabelBase{maincls}{%
- version~2.96a of \KOMAScript{} }{%
- \IfThisCommonLabelBase{scrlttr2}{%
- version~2.9t of \Class{scrlttr2} }{%
- \IfThisCommonLabelBase{scrextend}{%
- \Package{scrextend} }{\InternalCommonFileUsageError}%
+%\ChangedAt{v2.96a}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
+%\ChangedAt{v2.9t}{\Class{scrlttr2}}%
+%\ChangedAt{v3.01b}{\Package{typearea}}%
+\IfThisCommonLabelBase{scrextend}{With \Package{scrextend}, you can}{Since
+ \IfThisCommonLabelBase{typearea}{%
+ Version~3.01b, \Package{typearea}\ChangedAt{v3.01b}{\Package{typearea}}}{%
+ \IfThisCommonLabelBase{maincls}{%
+ Version~2.96a, \KOMAScript{}\ChangedAt{v2.96a}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}}}{%
+ \IfThisCommonLabelBase{scrlttr2}{%
+ Version~2.9t, \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}}%
+ \ChangedAt{v2.9t}{\Class{scrlttr2}}}{%
+ \InteralCommonFileUsageError}%
}%
}%
-}%
-it's your choice if your source code should result in the same make-up at
-future \LaTeX{} runs or if you like to participate in all improvements of new
-releases\IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{ of the class}{}. You
-may select the compatible version of \KOMAScript{} with option
-\Option{version}. Compatibility to the lowest supported \KOMAScript{} release
-may be achieved by
+\ has been able to }
+choose whether the source file should, as much as possible,
+continue to produce exactly the same result within a \LaTeX{} run or should
+be formatted according to the modifications of the latest version%
+\IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{ of the class}{}. You
+can specify the version with which you want your file to be compatible by
+using the \Option{version} option. Compatibility with the oldest supported
+\KOMAScript{} version can be achieved with
\OptionValue{version}{first}\important{\OptionValue{version}{first}} or
\OptionValue{version}{2.9} or \OptionValue{version}{2.9t}. Setting
\PName{value} to an unknown release number will result in a warning message
and selects \OptionValue{version}{first} for safety.
-With \OptionValue{version}{last} the most recent version will be selected at
-every \LaTeX{} run. Be warned, though, that using \OptionValue{version}{last}
-poses possibilities of compatibility issues for future \LaTeX{} runs. Option
-\Option{version} without any \PName{value} means the
-same. \ChangedAt{v3.01a}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}\and \Class{scrlttr2}\and \Package{scrextend}}This is the
-default behaviour as long as you do not use any deprecated options.
+With \OptionValue{version}{last}\important{\OptionValue{version}{last}}%
+\textnote{default}, you can select the latest version. In this case, you give
+up backwards compatibility. If the option is used without a value,
+\PValue{last} is assumed. This\ChangedAt{v3.01a}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}\and \Class{scrlttr2}\and
+ \Package{scrextend}} also corresponds to the default setting, as long as you
+do not use any deprecated options.
-If\textnote{Attention!} you use a deprecated option of \KOMAScript~2,
-\KOMAScript~3 will switch to \OptionValue{version}{first} automatically. This
-will also result in a warning message that explains how to prevent this
-switching. Alternatively you may select another adjustment using option
-\Option{version} with the wanted compatibility after the deprecated option.
+\IfThisCommonLabelBase{scrextend}{% scrextend doesn't recognize obsolete options
+}{%
+ If\textnote{Attention!} you use a deprecated option of \KOMAScript~2,
+ \KOMAScript~3 will switch to \OptionValue{version}{first} automatically.
+ This will also result in a warning message that explains how to prevent
+ this switch. Alternatively, you can choose a different setting for
+ \Option{version} with the desired compatibility after the deprecated
+ option.%
+}
-Compatibility is primarily make-up compatibility. New features not related to
-the mark-up will be available even if you switch compatibility to a version
-before first implementation of the feature. Option \Option{version} does not
-influence make-up changes that are motivated by bug fixes. If you need bug
-compatibility you should physically save the used \KOMAScript{} version
-together with your document.
+Compatibility is primarily a question of line and page breaks (wrapping). If
+you choose compatibility with an older version, new options that do not affect
+wrapping are still available. The \Option{version} option does not affect any
+wrapping changes that are the result of fixing unambiguous errors.
+If\textnote{Hint!} you need unconditional wrapping compatibility even in the
+case of bugs, you should physically save the old \KOMAScript{} version you
+need together with your document.
\IfThisCommonLabelBase{scrlttr2}{%
\begin{Example}
- The letter examples of this chapter should use and show all the features
- of the recent \KOMAScript{} release. To achieve this, we set the
- corresponding compatibility:%
+ The example letters in this chapter should use all the features of the
+ latest version of \KOMAScript{}. For this, the we set the compatibility
+ correspondingly when loading the class:%
\lstinputcode[xleftmargin=1em,lastline=1]{letter-0.tex}%
In this case the symbolic value \PValue{last} has been used to select the
latest version.%
- \end{Example}%
-}{}
+ \iftrue% Umbruchkorrektur
+ Here, the latest version was simply chosen with the symbolic value
+ \PValue{last}.%
+ \else%
+ In order not to have to specify a new version number for each new version,
+ the symbolic value \PValue{last} was chosen here.%
+ \fi
+ \end{Example}}{}
-Please note\textnote{Attention!} that you cannot change option
-\Option{version} anymore after loading the %
+Note\textnote{Attention!} that you cannot change the \Option{version} option
+after loading the %
\IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{class}{%
- package \IfThisCommonLabelBase{typearea}{\Package{typearea}}{%
- \IfThisCommonLabelBase{scrextend}{\Package{scrextend}}{%
+ \IfThisCommonLabelBase{typearea}{\Package{typearea}}{%
+ \IfThisCommonLabelBase{scrextend}{\Package{scrextend}}{%
\InternalCommonFileUsageError }%
}%
-}. Therefore, the usage of option \Option{version} within the argument of
+\ package}. Setting this option with
\DescRef{\ThisCommonLabelBase.cmd.KOMAoptions} or
-\DescRef{\ThisCommonLabelBase.cmd.KOMAoption} is not recommended and will
-cause an error.%
+\DescRef{\ThisCommonLabelBase.cmd.KOMAoption} will
+therefore cause an error.%
\EndIndexGroup
%
\EndIndexGroup
+\phantomsection
+\label{sec:\ThisCommonLabelBase.compatibilityOptions.end}
+\endinput
+
%%% Local Variables:
%%% mode: latex
%%% coding: us-ascii
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-dictum.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-dictum.tex
index c89b4e093a6..5dff550ac7d 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-dictum.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-dictum.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-dictum.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-dictum.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,42 +46,51 @@
% ======================================================================
\KOMAProvidesFile{common-dictum.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (common paragraphs)]
-\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi}
+\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and
+ Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-01-29
\section{Dicta}
\seclabel{dictum}%
\BeginIndexGroup
-\BeginIndex{}{smart slogan}%
+\BeginIndex{}{saying}%
\BeginIndex{}{dictum}%
-\BeginIndex{}{excerpt}%
+\BeginIndex{}{epigraph}%
\IfThisCommonFirstRun{}{%
- What is written in \autoref{sec:\ThisCommonFirstLabelBase.dictum} applies,
- mutatis mutandis. %
+ The information in \autoref{sec:\ThisCommonFirstLabelBase.dictum} applies
+ equally to this chapter. %
\IfThisCommonLabelBase{scrextend}{%
However, \Package{scrextend} does not support the commands
\DescRef{maincls.cmd.setchapterpreamble} and
- \DescRef{maincls.cmd.setpartpreamble}. You should read the manual of the
- used class, if you want to know, if that class does support similar
- commands. %
+ \DescRef{maincls.cmd.setpartpreamble}.
+ \iftrue% Umbruchvariante
+ Whether the class you are using offers an equivalent instruction
+ can be found in the documentation for the respective class .%
+ \fi%
}{}%
- So if you have alread read and understood
- \autoref{sec:\ThisCommonFirstLabelBase.dictum} you can jump to
- \autoref{sec:\ThisCommonLabelBase.dictum.next} on
+ So if you have already read and understood
+ \autoref{sec:\ThisCommonFirstLabelBase.dictum}, you can skip ahead to
+ \autoref{sec:\ThisCommonLabelBase.dictum.next},
\autopageref{sec:\ThisCommonLabelBase.dictum.next}.%
-}
-
-Sometimes you may find a dictum, a kind of smart slogan or excerpt, often
-ragged left above or below the heading of a chapter or section. The text and
-the source of the slogan often use special styles.
+}{}%
+\IfThisCommonLabelBase{scrextend}{% Umbruchkorrekturvarianten
+ A common element in a document is an epigraph or quotation that is set above
+ or below a chapter or section heading, typically right-justified. The
+ epigraph and its source are usually specially formatted.%
+}{%
+ A common element in a document is an epigraph or quotation that is set above
+ or below a chapter or section heading, along with a reference to the source
+ and its own formatting.%
+} %
+\KOMAScript{} refers to such an epigraph as a \emph{dictum}.
\begin{Declaration}
- \Macro{dictum}\OParameter{author}\Parameter{dictum}%
+ \Macro{dictum}\OParameter{author}\Parameter{text}%
\Macro{dictumwidth}%
\Macro{dictumauthorformat}\Parameter{author}%
\Macro{dictumrule}%
@@ -89,30 +98,34 @@ the source of the slogan often use special styles.
\Macro{raggeddictumtext}%
\Macro{raggeddictumauthor}
\end{Declaration}%
-The command \Macro{dictum} inserts such a dictum. %
+You can set such a saying with the help of the \Macro{dictum} command. %
\IfThisCommonLabelBase{maincls}{%
- This\textnote{Hint!} macro can be used as obligatory argument of either the
- command \DescRef{maincls.cmd.setchapterpreamble} or
- \DescRef{maincls.cmd.setpartpreamble}. However, this is not obligatory.\par%
+ This\textnote{Hint!} macro can be included in the mandatory argument of
+ either the \DescRef{maincls.cmd.setchapterpreamble} or the
+ \DescRef{maincls.cmd.setpartpreamble} command. However, this is not
+ obligatory.\par%
}{}%
-The dictum together with an optional \PName{author} is inserted in a
+The dictum, along with an optional \PName{author}, is inserted in a
\Macro{parbox}\IndexCmd{parbox} (see \cite{latex:usrguide}) of width
-\Macro{dictumwidth}. Yet \Macro{dictumwidth} is not a length which can be set
-with \Macro{setlength}. It is a macro that can be redefined using
-\Macro{renewcommand}. Default setting is \PValue{0.3333\Length{textwidth}},
-which is a third of the textwidth. The box itself is positioned with the
-command \Macro{raggeddictum}. Default here is
-\Macro{raggedleft}\IndexCmd{raggedleft}, that is, right justified. The
-command \Macro{raggeddictum} can be redefined using \Macro{renewcommand}.
+\Macro{dictumwidth}. However, \Macro{dictumwidth} is not a length which can be
+set with \Macro{setlength}. It is a macro that can be redefined using
+\Macro{renewcommand}. The default is \PValue{0.3333\Length{textwidth}}, which
+is one third of the text width. The box itself is aligned with the command
+\Macro{raggeddictum}. The default is \Macro{raggedleft}\IndexCmd{raggedleft},
+that is, right justified. \Macro{raggeddictum} can be redefined
+with \IfThisCommonLabelBase{scrextend}{% Umbruchoptimierung
+}{the help of }\Macro{renewcommand}.
+You can align the \PName{dictum} within the box using
+\Macro{raggeddictumtext}\important{\Macro{raggeddictumtext}}.
+The default is \Macro{raggedright}\IndexCmd{raggedright}, that is, left
+justified. You can also redefine this macro with \Macro{renewcommand}.%
\BeginIndexGroup
\BeginIndex{FontElement}{dictum}\LabelFontElement{dictum}%
-Within the box the \PName{dictum} is set using \Macro{raggeddictumtext}.
-Default setting is \Macro{raggedright}\IndexCmd{raggedright}, that is, left
-justified. Similarly to \Macro{raggeddictum} this can be redefined with
-\Macro{renewcommand}. The output uses the default font setting for the
-element \FontElement{dictum}, which can be changed with the commands
-\DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
+\LabelFontElement{dictumtext}%
+The output uses the default font setting for the element
+\FontElement{dictum}\important{\FontElement{dictum}}, which can be changed
+with the commands \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (see
\autoref{sec:\ThisCommonLabelBase.textmarkup},
\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}). Default settings are
@@ -141,9 +154,10 @@ listed in \autoref{tab:maincls.dictumfont}%
}{%
, \autopageref{tab:\ThisCommonFirstLabelBase.dictumfont}.%
}
+\EndIndexGroup
-If there is an \PName{author} name, it is separated from the \PName{dictum} by
-a rule to the full width of the \Macro{parbox}. This%
+If an \PName{author} is defined, it is separated from the \PName{dictum} by
+a horizontal rule spanning the full width of the \Macro{parbox}. This%
\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
@@ -152,81 +166,85 @@ a rule to the full width of the \Macro{parbox}. This%
\ChangedAt{v3.10}{\Package{scrextend}}%
}{\InternalCommonFileUsageError}%
} %
-rule is defined as vertical object to command \Macro{dictumrule}:
+rule is defined in \Macro{dictumrule}\important{\Macro{dictumrule}} as a
+vertical object with
\begin{lstcode}
\newcommand*{\dictumrule}{\vskip-1ex\hrulefill\par}
\end{lstcode}
-The alignment is defined with \Macro{raggeddictumauthor}. Default is
+The \Macro{raggeddictumauthor}\important{\Macro{raggeddictumauthor}} command
+defines the alignment for the rule and the \PName{author}. The default is
\Macro{raggedleft}. This command can also be redefined using
-\Macro{renewcommand}. The format of the output is defined with
-\Macro{dictumauthorformat}. This macro expects the \PName{author} as
-argument. As default \Macro{dictumauthorformat} is defined as:
+\Macro{renewcommand}. The format is defined with
+\Macro{dictumauthorformat}\important{\Macro{dictumauthorformat}}. This macro
+expects the \PName{author} text as its argument. By default
+\Macro{dictumauthorformat} is defined as
\begin{lstcode}
\newcommand*{\dictumauthorformat}[1]{(#1)}
\end{lstcode}
+Thus the \PName{author} is set enclosed in rounded parentheses.
+\BeginIndexGroup
\BeginIndex{FontElement}{dictumauthor}\LabelFontElement{dictumauthor}%
-Thus the \PName{author} is set enclosed in rounded parentheses. For the
-element \FontElement{dictumauthor}, a different font than for the element
-\DescRef{\LabelBase.fontelement.dictum} can be defined. Default settings are
+For the \FontElement{dictumauthor}\important{\FontElement{dictumauthor}}
+element, you can define a different font than that used for the
+\DescRef{\LabelBase.fontelement.dictum} element. The default settings are
listed in \autoref{tab:maincls.dictumfont}. Changes can be made using the
-commands \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
-\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (see
+\DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
+\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} commands (see
\autoref{sec:\ThisCommonLabelBase.textmarkup},
\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}).%
\EndIndexGroup
\IfThisCommonLabelBase{maincls}{%
- If \Macro{dictum} is used within the macro
+ If you use \Macro{dictum} within the
\DescRef{maincls.cmd.setchapterpreamble} or
- \DescRef{maincls.cmd.setpartpreamble} you have to take care of the
- following: the horizontal positioning is always done with
- \Macro{raggeddictum}. Therefore, the optional argument for horizontal
- positioning which is implemented for these two commands has no
- effect. \Length{textwidth} is not the width of the whole text corpus but the
- actually used text width. If \Macro{dictumwidth} is set to
+ \DescRef{maincls.cmd.setpartpreamble} macro, you must ensure that
+ the horizontal positioning is always done with
+ \Macro{raggeddictum}. Therefore, the optional argument for horizontal
+ positioning which is implemented for these two commands has no effect.
+ \Length{textwidth} is not the width of the whole text body but the
+ current text width. If \Macro{dictumwidth} is set to
\PValue{.5\Length{textwidth}} and \DescRef{maincls.cmd.setchapterpreamble}
has an optional width of \PValue{.5\Length{textwidth}} too, you will get a
- box with a width one quarter of the text width. Therefore, if you use
- \Macro{dictum} it is recommended to refrain from setting the optional width
- for \DescRef{maincls.cmd.setchapterpreamble} or
+ box with a width one quarter of the text width. Therefore, if you use
+ \Macro{dictum} you should refrain from setting the optional width for
+ \DescRef{maincls.cmd.setchapterpreamble} or
\DescRef{maincls.cmd.setpartpreamble}.
If\textnote{Hint!} you have more than one dictum, one under another, you
- should separate them by an additional vertical space, easily accomplished
- using the command \Macro{bigskip}\IndexCmd{bigskip}.%
+ should separate them by an additional vertical space, which is easily
+ accomplished using the \Macro{bigskip}\IndexCmd{bigskip} command.%
\iftrue%
}{\csname iffalse\endcsname}
- \begin{Example}
- You are writing a chapter on an aspect of weather forecasting. You
- have come across an aphorism which you would like to place at the
- beginning of the chapter beneath the heading. You could write:
+ \begin{Example}
+ You are writing a chapter about modern marriage, and you want to place a
+ dictum in the preamble to the chapter heading. You write:
\begin{lstcode}
\setchapterpreamble[u]{%
- \dictum[Anonymous]{Forecasting is the art of saying
- what is going to happen and then to explain
- why it didn't.}}
- \chapter{Weather forecasting}
+ \dictum[Schiller]{So pause ye who would link your fates~\dots}}
+ \chapter{Modern Marriage}
\end{lstcode}
- The output would look as follows:
- \begin{ShowOutput}
- {\usekomafont{disposition}\usekomafont{chapter}%
- 17\enskip Weather forecasting\par} \vspace{\baselineskip}
- \dictum[Anonymous]{Forecasting is the art of saying what is going to
- happen and then to explain why it didn't.}
- \end{ShowOutput}
-
- If you would rather the dictum span only a quarter of the text width
- rather than one third you can redefine \Macro{dictumwidth}:
+ The output would look as follows:
+ \begin{ShowOutput}
+ {\usekomafont{disposition}\usekomafont{chapter}%
+ 17\enskip Modern Marriage\par} \vspace{\baselineskip}
+ \dictum[Schiller]{So pause ye who would link
+ your fates~\dots}
+ \end{ShowOutput}
+
+ If you want the dictum to span only a quarter of the text width
+ rather than a third, you can redefine \Macro{dictumwidth} this way:
\begin{lstcode}
\renewcommand*{\dictumwidth}{.25\textwidth}
\end{lstcode}
- \end{Example}
+\end{Example}
- For a somewhat more sophisticated formatting of left- or right-aligned
- paragraphs including hyphenation you can use the
- package~\Package{ragged2e}~\cite{package:ragged2e}.%
+\IfThisCommonLabelBase{maincls}{}{% Umbruchkorrekturtext
+ At this point, note the \Package{ragged2e}\important{\Package{ragged2e}}%
+ \IndexPackage{ragged2e} package, with which you can produce unjustified text
+ that uses hyphenation (see \cite{package:ragged2e}).%
+}%
\fi
%
\EndIndexGroup
@@ -235,6 +253,8 @@ commands \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
%%% Local Variables:
%%% mode: latex
+%%% mode: flyspell
%%% coding: us-ascii
+%%% ispell-local-dictionary: "en_GB"
%%% TeX-master: "../guide"
-%%% End:
+%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-draftmode.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-draftmode.tex
index de1f947fcdb..383c9236c56 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-draftmode.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-draftmode.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-draftmode.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-draftmode.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,11 +46,12 @@
% ======================================================================
\KOMAProvidesFile{common-draftmode.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-02-28 13:23:23 +0100 (Wed, 28 Feb 2018) $
KOMA-Script guide (common paragraphs)]
-\translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi}
+\translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi\and
+ Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-01-30
\section{Draft Mode}
\seclabel{draft}%
@@ -58,45 +59,69 @@
\BeginIndex{}{draft mode}%
\IfThisCommonFirstRun{}{%
- What is written in \autoref{sec:\ThisCommonFirstLabelBase.draft}
- applies, mutatis mutandis. So if you have alread read and understood
- \autoref{sec:\ThisCommonFirstLabelBase.draft} you can jump to
- \autoref{sec:\ThisCommonLabelBase.draft.next} on
+ The information in \autoref{sec:\ThisCommonFirstLabelBase.draft} applies
+ equally to \IfThisCommonLabelBase{scrlttr2}{\Class{scrlttr2}%
+ \OnlyAt{\Class{scrlttr2}}}{this chapter}. So if you have already read
+ and understood \autoref{sec:\ThisCommonFirstLabelBase.draft}, you can skip
+ ahead to \autoref{sec:\ThisCommonLabelBase.draft.next} on
\autopageref{sec:\ThisCommonLabelBase.draft.next}.%
+ \IfThisCommonLabelBase{scrlttr2}{ The \Package{scrletter} package does not
+ provide a draft mode itself but relies upon the class you use.}{}%
}
-Many classes and packages provide a draft mode aside from the final
-typesetting mode. The difference of draft and final mode may be as manifold as
-the classes and package that support these modes. For instance, the
-\Package{graphics}\IndexPackage{graphics} and the
-\Package{graphicx}\IndexPackage{graphicx} packages do not actually output the
-graphics in their own draft mode. Instead they output a framed box of the
-appropriate size containing only the graphic's file name (see
-\cite{package:graphics}).%
+Many classes and packages provide a draft mode in addition to the normal
+typesetting mode. The differences between these two are as diverse as
+the classes and packages that offer this distinction.%
+\IfThisCommonLabelBase{scrextend}{% Umbruchkorrekturtext
+ \ The draft mode of some packages also results in changes to the output
+ that affect the document's layout. This is not the case with
+ \Package{scrextend}.%
+}{}
\begin{Declaration}
\OptionVName{draft}{simple switch}
+ \OptionVName{overfullrule}{simple switch}
\end{Declaration}%
-This option\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}\and \Class{scrlttr2}} is normally used to distinguish
-between the draft and final versions of a document. \PName{simple switch}
-value may be any standard value from \autoref{tab:truefalseswitch},
-\autopageref{tab:truefalseswitch}. In particular, switching on the option
-\important{\OptionValue{draft}{true}} activates small black boxes that are set
-at the end of overly long lines. The boxes help the untrained eye to find
-paragraphs that have to be treated manually. With the default
-\OptionValue{draft}{false} option no such boxes are shown. Such overly long
-lines often vanish using package
+The \Option{draft}\IfThisCommonLabelBase{maincls}{%
+ \ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrartcl}\and
+ \Class{scrreprt}}%
+}{%
+ \IfThisCommonLabelBase{scrlttr2}{%
+ \ChangedAt{v3.00}{\Class{scrlttr2}}\OnlyAt{\Class{scrlttr2}}%
+ }{}%
+} option distinguishes between documents being drafted and finished
+documents\Index{final version}. The \PName{simple switch} can be one of the
+standard values for simple switches from \autoref{tab:truefalseswitch},
+\autopageref{tab:truefalseswitch}. If you activate this
+option\important{\OptionValue{draft}{true}}, small black boxes will be output
+at the end of overly long lines. These boxes make it easier for the untrained
+eye to locate the paragraphs that require manual post-processing. By contrast,
+the default, \OptionValue{draft}{false}, shows no such boxes. Incidentally,
+such lines often disappear when you use the
\Package{microtype}\IndexPackage{microtype}\important{\Package{microtype}}
-\cite{package:microtype}.
+package \cite{package:microtype}.
+
+Since\IfThisCommonLabelBase{maincls}{%
+ \ChangedAt{v3.25}{\Class{scrbook}\and \Class{scrartcl}\and
+ \Class{scrreprt}}%
+}{%
+ \IfThisCommonLabelBase{scrlttr2}{%
+ \ChangedAt{v3.25}{\Class{scrlttr2}}%
+ }{%
+ \IfThisCommonLabelBase{scrextend}{%
+ \ChangedAt{v3.25}{\Package{scrextend}}%
+ }{}%
+ }%
+} the \Option{draft} option can lead to all sorts of unwanted effects with
+various packages, \KOMAScript{} allows you to control this marking of overly
+long lines separately with the
+\Option{overfullrule}\important{\OptionValue{overfullrule}{true}} option. If
+this option is enabled, the marker is again displayed.%
+%
\EndIndexGroup
%
\EndIndexGroup
-\phantomsection
-\label{sec:\ThisCommonLabelBase.draft.end}%
-\endinput
-
%%% Local Variables:
%%% mode: latex
%%% coding: us-ascii
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-fontsize.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-fontsize.tex
index 25a090c3f64..843f9482f2d 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-fontsize.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-fontsize.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-fontsize.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-fontsize.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,107 +46,132 @@
% ======================================================================
\KOMAProvidesFile{common-fontsize.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (common paragraphs: fontsize)]
-\translator{Markus Kohm\and Krickette Murabayashi}
+\translator{Markus Kohm\and Krickette Murabayashi\and Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2017-12-13
-\section{Selection of the Document Font Size}
+\section{Choosing the Document Font Size}
\seclabel{fontOptions}%
\BeginIndexGroup
\BeginIndex{}{font>size}%
-\IfThisCommonFirstRun{}{%
- What is described in \autoref{sec:\ThisCommonFirstLabelBase.fontOptions}
- applies, mutatis mutandis. So if you have alread read and understood
- \autoref{sec:\ThisCommonFirstLabelBase.fontOptions} you can jump to the
- \IfThisCommonLabelBase{scrlttr2}{example at the }{%
- \IfThisCommonLabelBase{last paragraph at the }{}%
- }%
- end of this section on
- \autopageref{sec:\ThisCommonLabelBase.fontOptions.end}.%
+\IfThisCommonFirstRun{%
+ The main font and its size are central elements in the design of a document.
+ As stated in \autoref{cha:typearea}, the division of the page into the text
+ area and the margins fundamentally depends on them. The main font is the one
+ that is used for most of the text in a document. All variations, whether in
+ shape, thickness, slant, or size, are related to the main font.%
+}{%
+ The information in \autoref{sec:\ThisCommonFirstLabelBase.fontOptions}
+ applies equally to
+ \IfThisCommonLabelBase{scrlttr2}{\Class{scrlttr2}\OnlyAt{scrlttr2}}%
+ {this chapter}. \IfThisCommonLabelBase{scrlttr2}{By contrast, the
+ \Package{scrletter} package by itself does not offer font-size selection
+ but depends completely on the class you use.}{} So if you have already
+ read and understood \autoref{sec:\ThisCommonFirstLabelBase.fontOptions}, you
+ can \IfThisCommonLabelBase{scrlttr2}{continue to
+ \autopageref{sec:\ThisCommonLabelBase.fontOptions.end} at the end of this
+ section. If you use \Package{scrletter}, you can }{}%
+ skip directly to \autoref{sec:\ThisCommonLabelBase.fontOptions.next},
+ \autopageref{sec:\ThisCommonLabelBase.fontOptions.next}.%
}
-The main document font size is one of the basic decisions for the document
-layout. The maximum width of the text area, and therefore splitting the page
-into text area and margins, depends on the font size as stated in
-\autoref{cha:typearea}. The main document font will be used for most
-of the text. All font variations either in mode, weight, declination, or size
-should relate to the main document font.
-
-
\begin{Declaration}
\OptionVName{fontsize}{size}
\end{Declaration}
-In contrast to the standard classes and most other classes that provide only
-a very limited number of font sizes, the \KOMAScript{} classes offer the
-feature of selection of any desired \PName{size} for the main document
-font. In this context, any well known \TeX{} unit of measure may be used and
-using a number without unit of measure means \PValue{pt}.\iffree{}{ More
- information about font size selection for experts and interested users may
- be found in \autoref{sec:maincls-experts.addInfos},
+While\IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{%
+ \textnote{\KOMAScript{} vs. standard classes}} the standard classes support
+only a very limited number of font sizes,
+\IfThisCommonLabelBase{scrlttr2}{\Class{scrlttr2}}{\KOMAScript} provides the
+ability to specify any \PName{size} for the main font. You can also use any
+known \TeX unit as a unit for the \PName{size}. If the \PName{size} is
+specified without a unit, it is assumed to be \PValue{pt}.\iffree{}{ The exact
+ procedure for setting the font size is documented for experts and interested
+ users in \autoref{sec:maincls-experts.addInfos},
\DescPageRef{maincls-experts.option.fontsize}.}
-If you use this option inside the document, the main document font size and
-all dependent sizes will change from this point. This may be useful, e.\,g.,
-if \IfThisCommonLabelBase{scrlttr2}{one more letter }{the appendix }%
-should be set using smaller fonts on the whole. It should be noted that
-changing the main font size does not result in an automatic recalculation of
-type area and margins (see
+If you set the option within the document, the main font size and the
+dependent font sizes of the commands \Macro{tiny}, \Macro{scriptsize},
+\Macro{footnotesize}, \Macro{small}, \Macro{normalsize}, \Macro{large},
+\Macro{Large}, \Macro{LARGE}, \Macro{huge} and \Macro{Huge} are changed. This
+can be useful, for example, if you want %
+\IfThisCommonLabelBase{scrlttr2}{another letter }{the appendix }%
+to be set in a smaller font size.
+
+Note\textnote{Attention!} that using this option after
+\IfThisCommonLabelBase{scrextend}{potentially loading
+ \hyperref[cha:typearea]{\Package{typearea}}\IndexPackage{typearea}%
+ \important{\hyperref[cha:typearea]{\Package{typearea}}}}{loading the class}
+does not automatically recalculate the type area and margins (see
\DescRef{typearea.cmd.recalctypearea}\IndexCmd{recalctypearea},
-\autoref{sec:typearea.options},
-\DescPageRef{typearea.cmd.recalctypearea}). On the other hand, each
-recalculation of type area and margins will be done on the basis of the
-current main font size. The effects of changing the main font size to other
-additionally loaded packages or the used document class depend on those
-packages and the class. This may even result in error messages or typesetting
-errors, which cannot be considered a fault of \KOMAScript, and even the
-\KOMAScript{} classes do not change all lengths if the main font size changes
-after loading the class.
+\autoref{sec:typearea.typearea},
+\DescPageRef{typearea.cmd.recalctypearea}). However, if this recalculation is
+performed, it will be based on the current main font size. The effects of
+changing the main font size upon other loaded packages or the class used
+depends on these packages and on the class. \IfThisCommonLabelBase{maincls}{%
+ This means that you can encounter errors which are not the fault of
+ \KOMAScript, and even the \KOMAScript{} classes themselves do not
+ recalculate all lengths if the main font size changes after loading the
+ class.%
+}{%
+ \IfThisCommonLabelBase{scrlttr2}{%
+ You can encounter errors which are not the fault of \KOMAScript{}, and
+ further, the \Class{scrlttr2} class itself does not recalculate all
+ lengths if the main font size changes after loading the class.%
+ }{%
+ This means that you can encounter errors which are not the fault of
+ \KOMAScript{}.%
+ }%
+}%
-This\textnote{Attention!} option is not intended to be a substitution for
-\Macro{fontsize} (see \cite{latex:fntguide}). Also, you should not use it
-instead of one of the main font depending font size commands \Macro{tiny} up
-to \Macro{Huge}!%
-\phantomsection\label{sec:\ThisCommonLabelBase.fontOptions.end}%
+This\textnote{Attention!} option should by no means be misinterpreted as a
+substitute for \Macro{fontsize} (see \cite{latex:fntguide}). Also, you should
+not use it in place of one of the font size commands that are relative to the
+main font, from \Macro{tiny} to \Macro{Huge}.
\IfThisCommonLabelBase{scrlttr2}{%
- \ Default at \Class{scrlttr2} is \OptionValue{fontsize}{12pt}.
+ For \Class{scrlttr2} the default is \OptionValue{fontsize}{12pt}.
\begin{Example}
- Assumed, the example is a letter to \emph{``The friends of insane font
- sizes''} and therefor it should be printed with 14\Unit{pt} instead of
- 12\Unit{pt}. Only a simple change of the first line is needed:%
+ \phantomsection\label{sec:\ThisCommonLabelBase.fontOptions.end}%
+ Suppose the organization in the sample letter is the \emph{``Friends of
+ Noxious Font Sizes''}, for which reason it should be set in 14\Unit{pt}
+ instead of 12\Unit{pt}. You can achieve this by making a small change to
+ the first line:%
\lstinputcode[xleftmargin=1em]{letter-6}%
- Alternatively the option may be set at the optional argument of the
- \DescRef{\LabelBase.env.letter} environment:%
+ Alternatively, the option could be set as an optional argument to
+ \DescRef{\LabelBase.env.letter}:
\lstinputcode[xleftmargin=1em]{letter-5}%
- In the case of this late change of the font size no recalculation of the
- type area will happen. Because of this, the two results of
- \autoref{fig:scrlttr2.letter-5-6} differ.
+ Since the text area is not recalculated in this late change of the font
+ size, the two results differ in \autoref{fig:scrlttr2.letter-5-6}.
\begin{figure}
\centering
\frame{\includegraphics[width=.4\textwidth]{letter-5}}\quad
\frame{\includegraphics[width=.4\textwidth]{letter-6}}
- \caption[{Example: letter with addressee, opening, text, closing,
- postscript, distribution list, enclosure, and insane large font
- size}]{%
- result of a small letter with addressee, opening, text, closing,
- postscript, distribution list, enclosure, and insane large font size
- (date and folding marks are defaults of DIN-letters): at left one the
- font size has been defined by the optional argument of
- \DescRef{\LabelBase.env.letter}, at the right one the optional
- argument of \DescRef{\LabelBase.cmd.documentclass} has been used}
+ \caption[{Example: letter with address, salutation, text, closing phrase,
+ postscript, enclosures, distribution list, and noxiously large font
+ size}]
+ {result of a short letter with recipient, opening, text, closing,
+ postscript, enclosures, distribution list, and a noxiously large font
+ (the date is set by default): in the left-hand version, the font size
+ has been defined by the optional argument of
+ \DescRef{\LabelBase.env.letter}; in the right-hand one, the optional
+ argument of \DescRef{\LabelBase.cmd.documentclass} has been used}
\label{fig:scrlttr2.letter-5-6}
\end{figure}
\end{Example}
}{%
\IfThisCommonLabelBase{maincls}{%
- The default at \Class{scrbook}, \Class{scrreprt}, and \Class{scrartcl} is
+ \par
+ \phantomsection\label{sec:\ThisCommonLabelBase.fontOptions.end}%
+ The default for \Class{scrbook}, \Class{scrreprt}, and \Class{scrartcl} is
\OptionValue{fontsize}{11pt}.\textnote{\KOMAScript{} vs. standard classes}
- In contrast, the default of the standard classes would be
- \Option{10pt}. You may attend to this if you switch from a standard class
- to a \KOMAScript{} class.%
+ In contrast, the default size in the standard classes is \Option{10pt}.
+ You may need to account for this difference if you switch from a standard
+ class to a \KOMAScript{} class\iffree{}{ or when using the
+ \DescRef{maincls-experts.option.emulatestandardclasses}%
+ \IndexOption{emulatestandardclasses} option}.%
}{}%
}%
%
@@ -154,10 +179,10 @@ to \Macro{Huge}!%
%
\EndIndexGroup
-\endinput
-
%%% Local Variables:
%%% mode: latex
+%%% mode: flyspell
%%% coding: us-ascii
+%%% ispell-local-dictionary: "en_GB"
%%% TeX-master: "../guide"
-%%% End:
+%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-footnotes.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-footnotes.tex
index a99f9abb53d..c08b203b298 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-footnotes.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-footnotes.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-footnotes.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-footnotes.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,11 +46,11 @@
% ======================================================================
\KOMAProvidesFile{common-footnotes.tex}
- [$Date: 2017-04-13 09:48:05 +0200 (Thu, 13 Apr 2017) $
+ [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (common paragraphs: Footnotes)]
-\translator{Markus Kohm\and Krickette Murabayashi}
+\translator{Markus Kohm\and Krickette Murabayashi\and Karl Hagen}
-% Date of the translated German file: 2017-04-13
+% Date of the translated German file: 2018-01-29
\section{Footnotes}
\seclabel{footnotes}%
@@ -58,40 +58,69 @@
\BeginIndex{}{footnotes}%
\IfThisCommonFirstRun{}{%
- All of what is described in
- \autoref{sec:\ThisCommonFirstLabelBase.footnotes} is generally
- applicable. So if you have alread read and understood
- \autoref{sec:\ThisCommonFirstLabelBase.footnotes} you can switch to
- \autoref{sec:\ThisCommonLabelBase.footnotes.next},
+ The information in \autoref{sec:\ThisCommonFirstLabelBase.footnotes} applies
+ equally to this chapter. So if you have already read and understood
+ \autoref{sec:\ThisCommonFirstLabelBase.footnotes}, you can skip ahead to
+ \autopageref{sec:\ThisCommonLabelBase.footnotes.next},
\autopageref{sec:\ThisCommonLabelBase.footnotes.next}.%
+ \IfThisCommonLabelBase{scrlttr2}{ %
+ If you do not use a \KOMAScript{} class, \Package{scrletter}%
+ \OnlyAt{\Package{scrletter}} relies on the
+ \hyperref[cha:scrextend]{\Package{scrextend}}\IndexPackage{scrextend}%
+ \important{\hyperref[cha:scrextend]{\Package{scrextend}}} package.
+ Therefore, see also \autoref{sec:scrextend.footnotes},
+ \autopageref{sec:scrextend.footnotes} when using \Package{scrletter}.%
+ \iffalse% Umbruchkorrekturtext
+ \ Note in particular that in this case some typical \KOMAScript{}
+ extensions are not active by default\textnote{default}. Instead, the
+ footnotes make use of the class used, or the \LaTeX{} kernel.%
+ \fi%
+ }{}%
}
\IfThisCommonLabelBase{maincls}{%
- \KOMAScript{}, unlike the standard classes, provides features for
- configuration of the footnote block format.%
+ Unlike\textnote{\KOMAScript{} vs. standard classes} the standard classes,
+ \KOMAScript{} offers the ability to configure the format of the footnote
+ block.%
}{%
\IfThisCommonLabelBase{scrlttr2}{%
- The commands for setting footnotes may be found at each introduction into
- \LaTeX, e.\,g., at \cite{lshort}. \KOMAScript{} provides additional
- features to change the footnote block format.%
+ You can find the basic commands to set footnotes in any introduction to
+ \LaTeX, for example \cite{lshort}. \KOMAScript{}%
+ \textnote{\KOMAScript{} vs. standard classes} provides additional features
+ to change the format of the footnote block. %
+ \iffalse % Umbruchoptimierung
+
+ Whether footnotes should be allowed for letters depends very much on the
+ type of letter and its layout. For example, you should not allow
+ footnotes to overlap visually with the letterhead footer or be confused
+ with the courtesy-copy list. Doing so is the responsibility of the
+ user.%
+
+ Since footnotes are rarely used in letters, examples in this section have
+ been omitted. If you need examples, you can find them in
+ \autoref{sec:\ThisCommonFirstLabelBase.footnotes},
+ \autopageref{sec:\ThisCommonFirstLabelBase.footnotes}.%
+ \fi%
}{%
\IfThisCommonLabelBase{scrextend}{%
- Package \Package{scrextend} supports all the footnote features of the
- \KOMAScript{} classes. Nevertheless, by default the footnotes are under
- full control of the used class. This changes as soon as command
- \DescRef{\ThisCommonLabelBase.cmd.deffootnote} (see
- \DescPageRef{\ThisCommonLabelBase.cmd.deffootnote}) has been used.
-
- Package \Package{scrextend} does not provide settings for the separation
- line above the footnotes.%
+ The footnote capabilities of the \KOMAScript{} classes are also
+ provided by \Package{scrextend}. By default, the formatting of
+ footnotes is left to the class used. This changes as soon as you
+ issue the \DescRef{\ThisCommonLabelBase.cmd.deffootnote} command,
+ which is explained in detail on
+ \DescPageRef{\ThisCommonLabelBase.cmd.deffootnote}.
+
+ The options for adjusting the dividing line above footnotes, however,
+ are not provided by \Package{scrextend}.%
}{\InternalCommonFileUsageError}%
}%
-}
+}%
\begin{Declaration}
\OptionVName{footnotes}{setting}
+ \Macro{multfootsep}
\end{Declaration}
-\IfThisCommonLabelBase{scrextend}{At several classes footnotes }{%
+\IfThisCommonLabelBase{scrextend}{Many classes mark footnotes }{%
Footnotes %
\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
@@ -101,49 +130,55 @@
\ChangedAt{v3.00}{\Class{scrlttr2}}%
}{}%
}%
+ are marked %
}%
-will be marked with a tiny superscript number in text by default. If more than
-one footnote falls at the same place, one may think that it is only one
-footnote with a very large number instead of multiple footnotes (i.\,e.,
-footnote 12 instead of footnotes 1 and 2). Using
-\important{\OptionValue{footnotes}{multiple}}
-\OptionValue{footnotes}{multiple}\IndexOption{footnotes=~multiple} will
-separate multiple footnotes immediately next to each other by a separator
-string. The predefined separator at
-\DescRef{\ThisCommonLabelBase.cmd.multfootsep}\IndexCmd{multfootsep}\important{\DescRef{\ThisCommonLabelBase.cmd.multfootsep}}
-is a single comma without space. The whole mechanism is compatible with
-package
-\Package{footmisc}\IndexPackage{footmisc}\important{\Package{footmisc}},
-Version~5.3d (see \cite{package:footmisc}). It is related not only to
-footnotes placed using
-\DescRef{\ThisCommonLabelBase.cmd.footnote}\IndexCmd{footnote}, but
-\DescRef{\ThisCommonLabelBase.cmd.footnotemark}\IndexCmd{footnotemark} too.
+by default in the text with a small superscript number. If several footnotes
+appear in succession at the same point, it gives the impression that there is
+one footnote with a large number rather than multiple footnotes (e.\,g.
+footnote 12 instead of footnotes 1 and 2).
+With\important{\OptionValue{footnotes}{multiple}}
+\OptionValue{footnotes}{multiple}\IndexOption{footnotes=~multiple}, footnotes
+that follow each other directly are separated with a delimiter instead. The
+default delimiter in \Macro{multfootsep}\important{\Macro{multfootsep}} is
+defined as a comma without a space:
+\begin{lstcode}
+ \newcommand*{\multfootsep}{,}
+\end{lstcode}
+This can be redefined.
-Command \DescRef{\ThisCommonLabelBase.cmd.KOMAoptions} or
-\DescRef{\ThisCommonLabelBase.cmd.KOMAoption} may be used to switch back to
-the default \OptionValue{footnotes}{nomultiple} at any time. If any problems
-using another package that influences footnotes occur, it is recommended not
-to use the option anywhere and not to change the \PName{setting} anywhere
+The whole mechanism is compatible with the
+\Package{footmisc}\IndexPackage{footmisc}\important{\Package{footmisc}}
+package, version~5.3d to 5.5b (see \cite{package:footmisc}). It affects
+footnote markers placed using
+\DescRef{\ThisCommonLabelBase.cmd.footnote}\IndexCmd{footnote}, as well as
+those placed directly with
+\DescRef{\ThisCommonLabelBase.cmd.footnotemark}\IndexCmd{footnotemark}.
+
+You can switch back to the default
+\OptionValue{footnotes}{nomultiple} at any time using the
+\DescRef{\ThisCommonLabelBase.cmd.KOMAoptions} or
+\DescRef{\ThisCommonLabelBase.cmd.KOMAoption} command. However, if you
+encounter any problems using another package that alters the footnotes, you
+should not use this option, nor should you change the \PName{setting} anywhere
inside the document.
-A summary of the available \PName{setting} values of \Option{footnotes} may
-be found at \autoref{tab:\ThisCommonFirstLabelBase.footnotes}%
+A summary of the available \PName{setting} values of \Option{footnotes} can
+be found in \autoref{tab:\ThisCommonFirstLabelBase.footnotes}%
\IfThisCommonFirstRun{%
.
\begin{table}
- \caption[{Available values for option \Option{footnotes}}]
- {Available values for option \Option{footnotes} setting up footnotes}
+ \caption[{Available values for the \Option{footnotes} option}]
+ {Available values for the \Option{footnotes} option to configure footnotes}
\label{tab:\ThisCommonLabelBase.footnotes}
\begin{desctabular}
\pventry{multiple}{%
- At sequences of immediately following footnote marks, consecutive
- marks will be separated by
+ Consecutive footnote marks will be separated by
\DescRef{\ThisCommonLabelBase.cmd.multfootsep}\IndexCmd{multfootsep}.%
- \IndexOption{footnotes~=\PValue{multiple}}}%
+ \IndexOption{footnotes~=\textKValue{multiple}}}%
\pventry{nomultiple}{%
- Immediately following footnotes will be handled like single footnotes
- and not separated from each other.%
- \IndexOption{footnotes~=\PValue{nomultiple}}}%
+ Consecutive footnote marks will be handled like single footnotes
+ and not separated from each other.%
+ \IndexOption{footnotes~=\textKValue{nomultiple}}}%
\end{desctabular}
\end{table}%
}{,
@@ -158,15 +193,14 @@ be found at \autoref{tab:\ThisCommonFirstLabelBase.footnotes}%
\Macro{footnotemark}\OParameter{number}%
\Macro{footnotetext}\OParameter{number}\Parameter{text}%
\Macro{multiplefootnoteseparator}%
- \Macro{multfootsep}
\end{Declaration}%
-Similar to the standard classes, footnotes in {\KOMAScript} are produced with
-the \Macro{footnote} command, or alternatively the paired usage of the
-commands \Macro{footnotemark} and \Macro{footnotetext}. As in the standard
-classes, it is possible that a page break occurs within a footnote. Normally
-this happens if the footnote mark is placed so near the bottom of a page as to
-leave {\LaTeX} no choice but to break the footnote onto the next page.
-\KOMAScript%
+Footnotes in \KOMAScript{} are produced, as they are in the standard classes,
+with the \Macro{footnote} command, or alternatively the pair of commands
+\Macro{footnotemark} and \Macro{footnotetext}. As in the standard classes,
+it is possible for a page break to occur within a footnote. Normally this
+happens if the footnote mark is placed so near the bottom of a page as to
+leave \LaTeX{} no choice but to move the footnote to the next page.
+Unlike\textnote{\KOMAScript{} vs. standard classes}
\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
@@ -175,95 +209,89 @@ leave {\LaTeX} no choice but to break the footnote onto the next page.
\ChangedAt{v3.00}{\Class{scrlttr2}}%
}{}%
} %
-, unlike the standard classes, can recognize and separate consecutive
-footnotes
-automatically. See\important{\DescRef{\ThisCommonLabelBase.option.footnote}}
-the previously documented option
-\DescRef{\ThisCommonLabelBase.option.footnotes} for this.
+the standard classes, \KOMAScript{} can recognize and separate consecutive
+footnotes automatically.
+See\important{\DescRef{\ThisCommonLabelBase.option.footnotes}} the previously
+documented option \DescRef{\ThisCommonLabelBase.option.footnotes}.
-If you want to set the separator manually, you may use
-\Macro{multiplefootnoteseparator}. Note that this command should not be
-redefined, because it has been defined not only to be the separator string but
-also the type style, i.\,e., font size and superscript. The separator string
-without type style may be found at \Macro{multfootsep}. The predefined default
-is
-\begin{lstcode}
- \newcommand*{\multfootsep}{,}
-\end{lstcode}
-and may be changed by redefining the command.
+If instead you want to place this delimiter manually, you can do so by calling
+\Macro{multiplefootnoteseparator}. However, users should not redefine this
+command, as it contains not only the delimiter but also the delimiter's
+formatting, for example the font size selection and the superscript. The
+delimiter itself is stored in the previously described
+\DescRef{\ThisCommonLabelBase.cmd.multfootsep}%
+\important{\DescRef{\ThisCommonLabelBase.cmd.multfootsep}}%
+\IndexCmd{multfootsep} command.
-\IfThisCommonLabelBase{scrlttr2}{%
- Examples and additional information may be found at
+\IfThisCommonFirstRun{\iftrue}{%
+ You can find examples and additional hints in
\autoref{sec:\ThisCommonFirstLabelBase.footnotes} from
- \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.footnote} onward.%
- \iffalse%
-}{\csname iftrue\endcsname}%
+ \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.footnote}.%
+ \csname iffalse\endcsname }%
\begin{Example}
\phantomsection\xmpllabel{cmd.footnote}%
- Assume you want to place two footnotes following a single word. First you
- may try
+ Suppose you want to put two footnotes after a single word. First you try
\begin{lstcode}
Word\footnote{1st footnote}\footnote{2nd footnote}
\end{lstcode}
- for this. Assume that the footnotes will be numbered with 1 and 2. Now the
- reader may think it's a single footnote 12, because the 2
- immediately follows the 1. You may change this using
+ Let's assume that the footnotes are numbered 1 and 2. Since the two
+ footnote numbers follow each other directly, it creates the impression
+ that the word has only one footnote numbered 12. You can change this
+ behaviour by using
\begin{lstcode}
\KOMAoptions{footnotes=multiple}
\end{lstcode}
- which would switch on the automatic recognition of footnote sequences. As
- an alternative you may use
+ to enable the automatic recognition of footnote sequences. Alternatively,
+ you can use
\begin{lstcode}
- Word\footnote{1st footnote}%
+ word\footnote{Footnote 1}%
\multiplefootnoteseparator
- \footnote{2nd footnote}
+ \footnote{Footnote 2}
\end{lstcode}
- This should give you the wanted result even if the automatic solution
- would fail or could not be used.
-
- Further, assume you want the footnotes separated not only by a single
- comma, but by a comma and a white space. In this case you may redefine
+ This should give you the desired result even if automatic detection
+ fails or cannot be used for some reason.
+
+ Now suppose you also want the footnote numbers to be separated not just by
+ a comma, but by a comma and a space. In this case, write
\begin{lstcode}
\renewcommand*{\multfootsep}{,\nobreakspace}
\end{lstcode}
- at the document preamble. \Macro{nobreakspace}\IndexCmd{nobreakspace}
- instead of a usual space character has been used in this case to avoid
- paragraph or at least page breaks within footnote sequences.
+ in the preamble of your document.
+ \Macro{nobreakspace}\IndexCmd{nobreakspace} was used here instead of a
+ normal space to avoid paragraph or page breaks within the sequence of
+ footnotes.
\end{Example}%
\fi%
+%
\EndIndexGroup
\begin{Declaration}
\Macro{footref}\Parameter{reference}
\end{Declaration}
-Sometimes%
-\IfThisCommonLabelBase{maincls}{%
+Sometimes\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
}{%
\IfThisCommonLabelBase{scrlttr2}{%
\ChangedAt{v3.00}{\Class{scrlttr2}}%
- }{}%
-} %
-there are single footnotes to multiple text passages. The least sensible way
-to typeset this would be to repeatedly use
-\DescRef{\ThisCommonLabelBase.cmd.footnotemark} with the same manually set
-number. The disadvantages of this method would be that you have to know the
-number and manually fix all the
-\DescRef{\ThisCommonLabelBase.cmd.footnotemark} commands, and if the number
-changes because of adding or removing a footnote before, each
-\DescRef{\ThisCommonLabelBase.cmd.footnotemark} would have to be
-changed. Because of this, \KOMAScript{} provides the use of the
-\Macro{label}\IndexCmd{label}\important{\Macro{label}} mechanism in such
-cases. After simply setting a \Macro{label} inside the footnote,
-\Macro{footref} may be used to mark all the other text passages with the same
-footnote mark.
-\IfThisCommonLabelBase{scrlttr2}{\iffalse}{\csname iftrue\endcsname}%
+ }{}} you have a footnote in a document to which there are several references
+in the text. An inconvenient way to typeset this would be to use
+\DescRef{\ThisCommonLabelBase.cmd.footnotemark} to set the number directly.
+The disadvantage of this method is that you need to know the number and
+manually set every \DescRef{\ThisCommonLabelBase.cmd.footnotemark} command.
+And if the number changes because you add or remove an earlier footnote, you
+will have to change each \DescRef{\ThisCommonLabelBase.cmd.footnotemark}.
+\KOMAScript{} thefore offers the \Macro{label}\IndexCmd{label}%
+\important{\Macro{label}} mechanism to handle such cases. After placing a
+\Macro{label} inside the footnote, you can use \Macro{footref} to set all the
+other marks for this footnote in the text.
+\IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}%
\begin{Example}
\phantomsection\xmpllabel{cmd.footref}%
- Maybe you have to mark each trade name with a footnote which states that
- it is a registered trade name. You may write, e.\,g.,
+ You are writing a text in which you must create a footnote each time a
+ brand name occurs, indicating that it is a registered trademark. You can
+ write, for example,
\begin{lstcode}
Company SplishSplash\footnote{This is a registered trade name.
All rights are reserved.\label{refnote}}
@@ -277,16 +305,20 @@ footnote mark.
commands. The footnote text will be produced by
\DescRef{\ThisCommonLabelBase.cmd.footnote}.
\end{Example}
-\fi
-Because of setting the additional footnote marks using the \Macro{label}
-mechanism, changes of the footnote numbers will need at least two \LaTeX{}
-runs to ensure correct numbers for all \Macro{footref} marks.%
-\IfThisCommonLabelBase{scrlttr2}{ %
- An example for the usage \Macro{footref} can be found in
- \autoref{sec:\ThisCommonFirstLabelBase.footnotes} on
- \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.footref}.%
-}{}%
-%
+ \fi When setting footnote marks with the \Macro{label} mechanism, any
+ changes to the footnote numbers will require at least two \LaTeX{} runs to
+ ensure correct numbers for all \Macro{footref} marks.%
+ \IfThisCommonLabelBaseOneOf{scrlttr2,scrextend}{\par%
+ You can find an example of how to use \Macro{footref} in
+ \autoref{sec:\ThisCommonFirstLabelBase.footnotes} on
+ \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.footref}.%
+ }{} \IfThisCommonLabelBase{scrlttr2}{}{%
+ \par
+ Note\textnote{Attention!} that statements like \Macro{ref}\IndexCmd{ref}
+ or \Macro{pageref}\IndexCmd{pageref} are fragile and therefore you should
+ put \Macro{protect}\IndexCmd{protect} in front of them if they appear in
+ moving arguments such as headings.%
+ }%
\EndIndexGroup
@@ -296,37 +328,48 @@ runs to ensure correct numbers for all \Macro{footref} marks.%
\Macro{deffootnotemark}\Parameter{definition}%
\Macro{thefootnotemark}
\end{Declaration}%
-Footnotes are formatted slightly differently in {\KOMAScript} to in the
-standard classes. As in the standard classes the footnote mark in the text is
-depicted using a small superscripted number. The same formatting is used in
-the footnote itself. The mark in the footnote is type-set right-aligned in a
-box with width \PName{mark width}. The first line of the footnote follows
-directly.
+\IfThisCommonLabelBase{maincls}{The \KOMAScript{} classes set}{\KOMAScript{}
+ sets}\textnote{\KOMAScript{} vs. standard classes} footnotes slightly
+differently than the standard classes do. As in the standard classes, the
+footnote mark in the text is rendered with small, superscript numbers. The
+same formatting is used in the footnote itself. The mark in the footnote is
+typeset right-justified in a box with a width of \PName{mark width}. The first
+line of the footnote follows directly.
-All following lines will be indented by the length of \PName{indent}. If the
+All subsequent lines will be indented by the length of \PName{indent}. If the
optional parameter \PName{mark width} is not specified, it defaults to
-\PName{indent}. If the footnote consists of more than one paragraph, then the
-first line of a paragraph is indented, in addition to \PName{indent}, by the
-value of \PName{parindent}.
+\PName{indent}. If the footnote consists of more than one paragraph, the first
+line of each paragraph is indented by the value of \PName{parindent}.
-\hyperref[fig:maincls.deffootnote]{Figure~\ref*{fig:maincls.deffootnote}} %
-\IfThisCommonFirstRun{at \autopageref{fig:maincls.deffootnote} }%
-illustrates the layout parameters. The default configuration of the
-{\KOMAScript} classes is:
+\autoref{fig:\ThisCommonFirstLabelBase.deffootnote} %
+\IfThisCommonFirstRun{}{on
+ \autopageref{fig:\ThisCommonFirstLabelBase.deffootnote} }{}%
+shows the different parameters%
+\IfThisCommonLabelBase{maincls}{ again}{}%
+. The default configuration of the \KOMAScript{} classes is as follows:
+\IfThisCommonLabelBase{scrextend}{\iftrue}{\csname iffalse\endcsname}%
+\begin{lstcode}
+ \deffootnote[1em]{1.5em}{1em}{%
+ \textsuperscript{\thefootnotemark}}
+\end{lstcode}
+\else
\begin{lstcode}
- \deffootnote[1em]{1.5em}{1em}
- {\textsuperscript{\thefootnotemark}}
+ \deffootnote[1em]{1.5em}{1em}{%
+ \textsuperscript{\thefootnotemark}%
+ }
\end{lstcode}
+\fi%
\DescRef{\ThisCommonLabelBase.cmd.textsuperscript} controls both the
-superscript and the smaller font size. Command \Macro{thefootnotemark} is the
-current footnote mark without any formatting.%
+superscript and the smaller font size. The command \Macro{thefootnotemark}
+contains the current footnote mark without any formatting.%
\IfThisCommonLabelBase{scrextend}{ %
- Package \Package{scrextend} in contrast to this does not change the default
- footnote settings of the used class. Loading the package does not change any
- type style of footnote marks or footnote text in general. You have to copy
- the above shown source to use the default settings of the \KOMAScript{}
- classes with \Package{scrextend}. This may be done immediately after loading
- package \Package{scrextend}.%
+ The \Package{scrextend} package, by contrast, does not change the default
+ footnote settings of the class you are using. Simply loading the package,
+ therefore, should not lead to any changes in the formatting of footnote
+ marks or footnote text. To use the default settings of the \KOMAScript{}
+ classes with \Package{scrextend}, you must change the settings above
+ yourself. For example, you can insert the line of code above immediately
+ after loading the \Package{scrextend} package.%
}{}%
\IfThisCommonLabelBase{maincls}{%
@@ -385,81 +428,76 @@ current footnote mark without any formatting.%
\BeginIndexGroup
\BeginIndex{FontElement}{footnote}\LabelFontElement{footnote}%
\BeginIndex{FontElement}{footnotelabel}\LabelFontElement{footnotelabel}%
-The%
-\IfThisCommonLabelBase{maincls}{%
+The footnote\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v2.8q}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}%
-}{}} font element \FontElement{footnote}\important{\FontElement{footnote}}
-determines the font of the footnote including the footnote mark. Using the
-element \FontElement{footnotelabel}\important{\FontElement{footnotelabel}} the
-font of the footnote mark can be changed separately with the commands
+}}{}, including the footnote mark, uses the font specified in the
+\FontElement{footnote}\important{\FontElement{footnote}} element. You can
+change the font of the footnote mark separately using the
\DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
-\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (see
+\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} commands (see
\autoref{sec:\ThisCommonLabelBase.textmarkup},
-\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}). Please refer also to
-\autoref{tab:\ThisCommonLabelBase.fontelements},
+\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont})
+for the \FontElement{footnotelabel}\important{\FontElement{footnotelabel}}
+element. See also \autoref{tab:\ThisCommonLabelBase.fontelements},
\autopageref{tab:\ThisCommonLabelBase.fontelements}.
-Default setting is no change in the font.%
+The default setting is no change to the font.%
\IfThisCommonLabelBase{scrextend}{ %
- With \Package{scrextend} the elements may change the fonts only if the
- footnotes are handled by the package, i.\,g., after using
+ However, with \Package{scrextend} these elements will only change the fonts
+ if footnotes are handled by the package, that is, after using
\Macro{deffootnote}.%
-}{} Please don't misuse the element for other purpose, i.e., to use ragged
-right footnotes (see also \DescRef{\LabelBase.cmd.raggedfootnote},
+}{} Please don't misuse this element for other purposes, for example to set
+the footnotes ragged right (see also \DescRef{\LabelBase.cmd.raggedfootnote},
\DescPageRef{\LabelBase.cmd.raggedfootnote}).
\BeginIndex{FontElement}{footnotereference}%
\LabelFontElement{footnotereference}%
The footnote mark in the text is defined separately from the mark in
front of the actual footnote. This is done with
-\Macro{deffootnotemark}. Default setting is:
+\Macro{deffootnotemark}. The default setting is:
\begin{lstcode}
\deffootnotemark{%
\textsuperscript{\thefootnotemark}}
\end{lstcode}
-In the above%
-\IfThisCommonLabelBase{maincls}{%
+With\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v2.8q}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
-}{} the font for the element
-\FontElement{footnotereference}\important{\FontElement{footnotereference}} is
-applied (see \autoref{tab:\ThisCommonLabelBase.fontelements},
-\autopageref{tab:\ThisCommonLabelBase.fontelements}). Thus the footnote marks
-in the text and in the footnote itself are identical. The font can be changed
+}{} this default, the font for the
+\FontElement{footnotereference}\important{\FontElement{footnotereference}}
+element is used (see \autoref{tab:\ThisCommonLabelBase.fontelements},
+\autopageref{tab:\ThisCommonLabelBase.fontelements}). Thus, the footnote marks
+in the text and in the footnote itself are identical. You can change the font
with the commands \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (see
\autoref{sec:\ThisCommonLabelBase.textmarkup},
\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont})%
-\IfThisCommonLabelBase{scrextend}{ after usage of \Macro{deffootnotemark}}{}.
+\IfThisCommonLabelBase{scrextend}{ after \Macro{deffootnotemark} is used}{}.
-\IfThisCommonLabelBase{scrlttr2}{%
- Examples may be found at \autoref{sec:\ThisCommonFirstLabelBase.footnotes},
- from \DescPageRef{\ThisCommonFirstLabelBase.cmd.deffootnote} onwards.%
- \iffalse%
-}{\csname iftrue\endcsname}%
+\IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}%
\begin{Example}
- \phantomsection\xmpllabel{cmd.deffootnote}%
- A\textnote{Hint!} feature often asked for is footnote marks which are
- neither in superscript nor in a smaller font size. They should not touch
- the footnote text but be separated by a small space. This can be
- accomplished as follows:
+ \phantomsection
+ \xmpllabel{cmd.deffootnote}%
+ One\textnote{Hint!} feature that is often requested is footnote marks
+ which are neither in superscript nor in a smaller font. They should not
+ touch the footnote text but be separated by a small space. You can
+ accomplish this as follows:
\begin{lstcode}
\deffootnote{1em}{1em}{\thefootnotemark\ }
\end{lstcode}
- The footnote mark and the following space are therefore set
- right-aligned into a box of width 1\Unit{em}. The following lines of
- the footnote text are also indented by 1\Unit{em} from the left
- margin.
-
- Another\textnote{Hint!} often requested footnote layout is left-aligned
- footnote marks. These can be obtained with:
+ This will set the footnote mark and subsequent space right-aligned in a
+ box of width 1\Unit{em}. The lines of the footnote text that follow are
+ also indented by 1\Unit{em} from the left margin.
+
+ Another\textnote{Hint!} layout that is often requested is footnote marks
+ that are left-aligned. You can obtain them with the following
+ definition:
\begin{lstcode}
\deffootnote{1.5em}{1em}{%
\makebox[1.5em][l]{\thefootnotemark}}
\end{lstcode}
- If you want however only to change the font for all footnotes, for example
- to sans serif, you can solve this problem simply by using the commands
+ If, however you want to change the font for all footnotes, for example
+ to sans serif, this can easily be done with the commands
\DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (see
\autoref{sec:\ThisCommonLabelBase.textmarkup},
@@ -469,21 +507,23 @@ with the commands \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
\end{lstcode}
\end{Example}%
\IfThisCommonLabelBase{scrextend}{}{%
- As demonstrated with the examples above, the simple user interface of
- {\KOMAScript} provides a great variety of different footnote
- formattings.%
+ As the examples show, {\KOMAScript} allows a wide variety of different
+ footnote formats with this simple user interface.%
}%
\fi%
+\IfThisCommonFirstRun{}{%
+ For examples, see \autoref{sec:\ThisCommonFirstLabelBase.footnotes},
+ \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.deffootnote}.%
+}{}%
%
\EndIndexGroup
\EndIndexGroup
-
+\IfThisCommonLabelBase{scrextend}{\iffalse}{\csname iftrue\endcsname}
\begin{Declaration}
\Macro{setfootnoterule}\OParameter{thickness}\Parameter{length}%
\end{Declaration}%
-Generally%
-\IfThisCommonLabelBase{maincls}{%
+Generally,\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v3.06}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
}{%
@@ -494,22 +534,20 @@ Generally%
\ChangedAt{v3.06}{\Package{scrextend}}%
}{}%
}%
-} %
-a horizontal rule will be placed between the text area and the footnote
-area. But normally this rule is not as long as the width of the typing
-area. With Command \Macro{setfootnoterule} you may change the thickness and
-the width of that rule. Thereby the parameters \PName{thickness} and
-\PName{length} will be evaluated not at definition time but when setting the
-rule itself. If optional argument \PName{thickness} ha been omitted the
-thickness of the rule will not be changed. Empty arguments \PName{thickness}
-or \PName{length} are also allowed and do not change the corresponding
-parameter. Using implausible values may result in warning messages not only
-setting the arguments but also when \KOMAScript{} uses the parameters.
+} a horizontal rule is set between the text area and the footnote area, but
+normally this rule does not extend the full width of the type area. With
+\Macro{setfootnoterule}, you can set the exact thickness and length of the
+rule. In this case, the parameters \PName{thickness} and \PName{length} are
+only evaluated when setting the rule itself. If the optional argument
+\PName{thickness} has been omitted, the thickness of the rule will not be
+changed. Empty arguments for \PName{thickness} or \PName{length} are also
+allowed and do not change the corresponding parameters. Using absurd values
+will result in warning messages both when setting and when using the
+parameters.
\BeginIndexGroup
\BeginIndex{FontElement}{footnoterule}\LabelFontElement{footnoterule}%
-With element \FontElement{footnoterule}\important{\FontElement{footnoterule}}
-the color%
+You can%
\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v3.07}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
@@ -522,21 +560,23 @@ the color%
}{}%
}%
} %
-of the rule may be changed using the commands
-\DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
-\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} for element
-\FontElement{footnoterule} (see \autoref{sec:\ThisCommonLabelBase.textmarkup},
-\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}). Default is no change of
-font or color. For color changes a color package like
-\Package{xcolor}\IndexPackage{xcolor}\important{\Package{xcolor}} would be
-needed.%
+change the colour of the rule with the
+\FontElement{footnoterule}\important{\FontElement{footnoterule}} element using
+the \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
+\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} commands (see
+\autoref{sec:\ThisCommonLabelBase.textmarkup},
+\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}). The default is no change
+of font or colour. In order to change the colour, you must also load a colour
+package like
+\Package{xcolor}\IndexPackage{xcolor}\important{\Package{xcolor}}.%
\EndIndexGroup
\EndIndexGroup
+\fi
\begin{Declaration}
\Macro{raggedfootnote}
\end{Declaration}
-The default%
+By default%
\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v3.23}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
@@ -549,24 +589,31 @@ The default%
}{}%
}%
} %
-for the alignment of footnotes in \KOMAScript{} is justified, same as the
-default in the standard classes. But \KOMAScript{} provides
-\Macro{raggedfootnote} to change this default. Valid definitions of
-\Macro{raggedfootnote} would be \Macro{raggedright}\IndexCmd{raggedright},
+\KOMAScript{} justifies footnotes just as in the standard classes.
+But\textnote{\KOMAScript{} vs. standard classes} you can also change the
+justification separately from the rest of the document by redefining
+\Macro{raggedfootnote}. Valid definitions are
+\Macro{raggedright}\IndexCmd{raggedright},
\Macro{raggedleft}\IndexCmd{raggedleft},
-\Macro{centering}\IndexCmd{centering}, \Macro{relax}\IndexCmd{relax} or the
-empty definition, which is the default. You can also use the alignment
-commands of package \Package{ragged2e}\IndexPackage{ragged2e} (see
-\cite{package:ragged2e}).
-
-\begin{Example}
- Assuming you are using footnotes only to show informations with very large
- links that cannot be printed justified accommdatingly. You can use
+\Macro{centering}\IndexCmd{centering}, \Macro{relax}\IndexCmd{relax} or an
+empty definition, which is the default. The alignment commands of the
+\Package{ragged2e}\IndexPackage{ragged2e} package are also valid (see
+\cite{package:ragged2e}). \IfThisCommonLabelBase{scrextend}{%
+ You can find a suitable example in
+ \autoref{sec:\ThisCommonFirstLabelBase.footnotes},
+ \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.raggedfootnote}.%
+ \iffalse }{\csname iftrue\endcsname}%
+ \begin{Example}
+ \phantomsection\xmpllabel{cmd.raggedfootnote}%
+ Suppose you are using footnotes only to provide references to very long
+ links, where line breaks would produce poor results if justified. You can
+ use
\begin{lstcode}
\let\raggedfootnote\raggedright
\end{lstcode}
- in your document preamble to switch to ragged-right footnotes.
-\end{Example}%
+ in your document's preamble to switch to ragged-right footnotes.
+ \end{Example}%
+\fi
\EndIndexGroup
%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-headfootheight.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-headfootheight.tex
index 54d1873bec5..8f9fcbb9462 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-headfootheight.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-headfootheight.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-headfootheight.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-headfootheight.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,82 +46,109 @@
% ============================================================================
\KOMAProvidesFile{common-headfootheight.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-02-28 13:23:23 +0100 (Wed, 28 Feb 2018) $
KOMA-Script guide (common paragraph: Head and Foot Height)]
-\translator{Markus Kohm\and Jana Schubert\and Jens H\"uhne}
+\translator{Markus Kohm\and Jana Schubert\and Jens H\"uhne\and Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-01-16
-\section{Head and Foot Height}
+\section{Header and Footer Height}
\seclabel{height}
\BeginIndexGroup
-\BeginIndex{Package}{scrlayer}%
-\BeginIndex{}{page>head>height}%
-\BeginIndex{}{page>foot>height}%
-
+\BeginIndex{}{header>height}%
+\BeginIndex{}{footer>height}%
\IfThisCommonLabelBase{scrlayer-scrpage}{%
- \begin{Explain}
- The \LaTeX{} standard classes do not use the page footer a lot and if they
- do use it, they put the contents into a \Macro{mbox} which results in the
+ \begin{Explain}%
+ The \LaTeX{} standard classes do not use the footer much, and if they do
+ use it, they put the contents into a \Macro{mbox} which results in the
footer being a single text line. This is probably the reason that \LaTeX{}
- itself does not have a well-defined foot height. Actually there is
- \Length{footskip}\IndexLength{footskip} giving the distance between the
- last base line of the text area and the base line of the footer. However,
- if the footer consists of more than one text line, there is no definite
- statement whether this length should be the distance to the first or the
- last base line of the footer.
+ itself does not have a well-defined footer height. Although the distance
+ between the last baseline of the text area and the baseline of the footer
+ is defined with \Length{footskip}\IndexLength[indexmain]{footskip}, if the
+ footer consists of more than one text line, there is no definite statement
+ whether this length should be the distance to the first or the last
+ baseline of the footer.
- Despite the fact that the page header of the standard classes will also be
- put into a horizontal box and therefore is a single text line too,
- \LaTeX{} indeed has a length to setup the height of the page header. The
- reason for this may be that the height will be needed to determine the
- start of the text area.
+ Although the page header of the standard classes will also be put into a
+ horizontal box, and therefore is also a single text line, \LaTeX{} in fact
+ provides a length to set the height of the header. The reason for this may
+ be that this height is needed to determine the start of the text area.
\end{Explain}%
}{%
- Page head and footer are the main elements not only of a page style. Layer
- can also be restricted to these using corresponding options (see
- \autoref{tab:scrlayer.layerkeys},
+ The header and footer of a page are central elements not just of a page
+ style. They can also serve to restrict layers using the appropriate options
+ (see \autoref{tab:scrlayer.layerkeys},
\autopageref{tab:scrlayer.layerkeys}). Therefore the heights of these
- elements are very important and have to be well defined.%
+ elements must be defined.%
}
\IfThisCommonFirstRun{}{%
- All of what is described in
- \autoref{sec:\ThisCommonFirstLabelBase.height} is generally
- applicable. So if you have alread read and understood
- \autoref{sec:\ThisCommonFirstLabelBase.height} you can switch to
+ The information in \autoref{sec:\ThisCommonFirstLabelBase.height} applies
+ equally to this chapter. So if you have already read and understood
+ \autoref{sec:\ThisCommonFirstLabelBase.height}, you can skip ahead to
\autoref{sec:\ThisCommonLabelBase.height.next},
\autopageref{sec:\ThisCommonLabelBase.height.next}.%
}
\begin{Declaration}
- \Length{footheight}%
+ \Length{footheight}
\Length{headheight}
+ \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \OptionVName{autoenlargeheadfoot}{simple switch}%
+ }{}%
\end{Declaration}
-The package \Package{scrlayer} introduces \Length{footheight} as a new length
-similar to \Length{headheight} of the \LaTeX{} kernel. Additionally
-\Package{scrlayer-scrpage} interprets \Length{footskip} to be the distance
-from the last possible base line of the text area to the first normal base
-line of the footer. Package \Package{typearea}\IndexPackage{typearea}
-interprets \Package{footheight} in the same way. So \Package{typearea}'s foot
-height options may also be used to setup the values for packages
-\Package{scrlayer} and \Package{scrlayer-scrpage}. See option
-\DescRef{typearea.option.footheight} and \DescRef{typearea.option.footlines}
-in \autoref{sec:typearea.typearea},
-\DescPageRef{typearea.option.footheight}) and option
-\DescRef{typearea.option.footinclude} at
+The \Package{scrlayer} package introduces a new length, \Length{footheight},
+analogous to \Length{headheight}%
+\IfThisCommonLabelBase{scrlayer-scrpage}{}{of the \LaTeX{} kernel}.
+Additionally,
+\Package{scrlayer\IfThisCommonLabelBase{scrlayer-scrpage}{-scrpage}{}}
+interprets \Length{footskip} to be the distance from the last baseline of the
+text area to the first normal baseline of the footer. The
+\hyperref[cha:typearea]{\Package{typearea}}\IndexPackage{typearea}%
+\important{\hyperref[cha:typearea]{\Package{typearea}}} package interprets
+\Length{footheight} in the same way, so \Package{typearea}'s options for the
+footer height can also be used to set the values for the \Package{scrlayer}
+package. See the \DescRef{typearea.option.footheight} and
+\DescRef{typearea.option.footlines} options in
+\autoref{sec:typearea.typearea}, \DescPageRef{typearea.option.footheight})
+and option \DescRef{typearea.option.footinclude} on
\DescPageRef{typearea.option.footinclude} of the same section.
-If you do not use package \Package{typearea}, you should setup the head and
-foot height using the lengths directly where necessary. At least for the head
-package \Package{geometry} provides similar settings. If you setup a head or
-foot height that is too small for the effective content,
-\Package{scrlayer-scrpage} will try to adjust the corresponding lengths
-properly. Furthermore, it will warn you and give you additional information
-about the changes and proper settings you may use yourself. The automatic
-changes will become valid immediately after the need for them has been
-detected. They will never be removed automatically, however, even if content
-with a lower height requirement should be detected at a later point in time.%
+If you do not use the \hyperref[cha:typearea]{\Package{typearea}}%
+\important{\hyperref[cha:typearea]{\Package{typearea}}} package, you should
+adjust the header and footer heights using appropriate values for the lengths
+where necessary. For the header, at least, the \Package{geometry} package, for
+example, provides similar settings.
+\IfThisCommonLabelBase{scrlayer-scrpage}{\par%
+ If you choose a header or footer height that is too small for the actual
+ content, \Package{scrlayer-scrpage} tries by default to adjust the lengths
+ appropriately. At the same time, it will issue a warning containing
+ suggestions for suitable settings. These automatic changes take effect
+ immediately after the need for them has been detected and are not
+ automatically reversed, for example, when the content of the header or
+ footer becomes smaller afterwards.
+ However,\ChangedAt{v3.25}{\Package{scrlayer-scrpage}}, this behaviour can be
+ changed by using the \Option{autoenlargeheadfoot} option. This option
+ recognizes the values for simple switches in \autoref{tab:truefalseswitch},
+ \autopageref{tab:truefalseswitch}. The option is activated by default. If it
+ is deactivated, the header and footer are no longer enlarged
+ automatically. Only a warning with hints for suitable settings is issued.%
+}{%
+ \IfThisCommonLabelBase{scrlayer}{\par%
+ If you choose a header or footer height that is too small for the actual
+ content, \Package{scrlayer} usually accepts this without issuing an error
+ message or a warning. The header then expands according to its height,
+ usually upwards, with the footer moved down accordingly. Information about
+ this change is not obtained automatically. However, packages like
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}%
+ \IndexPackage{scrlayer-scrpage} that build upon \Package{scrlayer} may
+ contain their own tests which can lead to their own actions (see
+ \DescRef{scrlayer-scrpage.length.headheight} and
+ \DescRef{scrlayer-scrpage.length.footheight} on
+ \DescPageRef{scrlayer-scrpage.length.headheight}).%
+ }{}%
+}%
\EndIndexGroup
%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-interleafpage.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-interleafpage.tex
index 28169a0c58d..36f9fb4ae4d 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-interleafpage.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-interleafpage.tex
@@ -46,11 +46,12 @@
% ======================================================================
\KOMAProvidesFile{common-interleafpage.tex}%
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (common paragraphs: Interleaf Pages)]
-\translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi}
+\translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi\and
+ Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2017-12-07
\section{Interleaf Pages}
\seclabel{emptypage}%
@@ -59,98 +60,117 @@
\BeginIndex{}{page>style}%
\IfThisCommonFirstRun{}{%
- What is described in \autoref{sec:\ThisCommonFirstLabelBase.emptypage}
- applies, mutatis mutandis. So if you have alread read and understood
- \autoref{sec:\ThisCommonFirstLabelBase.emptypage} you can switch to
+ The information in \autoref{sec:\ThisCommonFirstLabelBase.emptypage} applies
+ equally to this chapter. So if you have already read and understood
+ \autoref{sec:\ThisCommonFirstLabelBase.emptypage}, you can skip ahead to
\autoref{sec:\ThisCommonLabelBase.emptypage.next},
\autopageref{sec:\ThisCommonLabelBase.emptypage.next}.%
}
-Interleaf pages are pages that are intended to stay blank. Originally these
-pages were really completely white. \LaTeX{}, on the other hand, by default
-sets those pages with the current valid page style. So those pages may have a
-head and a pagination. \KOMAScript{} provides several extensions to this.
+Interleaf pages are pages that are inserted between parts of a document.
+Traditionally, these pages are completely blank. \LaTeX{}, however,
+sets them by default with the current page style. \KOMAScript{} provides
+several extensions to this functionality.
-Interleaf pages may be found in books mostly. Because chapters in books
-commonly start on odd pages, sometimes a left page without contents has to be
-added before. This is also the reason that interleaf pages only exist in
-double-sided printing. The unused back sides of the one-sided printings are
-not interleaf pages, really, although they may seem to be such pages.
+Interleaf pages are mostly found in books. Because book chapters commonly
+start on the right (recto) page of a two-page spread, an empty left (verso)
+page must be inserted if the previous chapter ends on a recto page. For this
+reason, interleaf pages really only exist for two-sided printing.
+%
+\iffalse % Umbruchkorrektur
+ The blank versos in one-sided printing are not true interleaf pages,
+ although they may appear as such in counting the printed sheets.
+\fi%
\IfThisCommonLabelBase{scrlttr2}{%
- At letters interleaf pages are unusual. This may be benefited by the case,
- that real two-sided letters are seldom, because binding of letters is not
- done often. Nevertheless \Class{scrlttr2} supports interleaf pages in the
- case of two-sided letters. Because the following described commands are
- seldom used in letters no examples are shown. If you need examples, please
- note them at \autoref{sec:maincls.emptypage} from
- \autopageref{sec:maincls.emptypage} upward.%
+ Interleaf pages are unusual in letters. This is not least because two-sided
+ letters are rare, as letters are usually not bound. Nevertheless,
+ \KOMAScript{} also supports interleaf pages for two-sided letters. However,
+ since the commands described here are seldom used in letters, you will not
+ find any examples here. If necessary, please refer to the examples in
+ \autoref{sec:maincls.emptypage}, starting on
+ \autopageref{sec:maincls.emptypage}.%
}{}%
\begin{Declaration}
\OptionVName{cleardoublepage}{page style}
\OptionValue{cleardoublepage}{current}
\end{Declaration}%
-With this option, %
-\IfThisCommonLabelBase{maincls}{%
+With this option,\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
}{%
\IfThisCommonLabelBase{scrlttr2}{%
\ChangedAt{v3.00}{\Class{scrlttr2}}%
}{}%
-} %
-you may define the page style of the interleaf pages created by the
+} you can define the page style of the interleaf pages created by the commands
\DescRef{\LabelBase.cmd.cleardoublepage},
\DescRef{\LabelBase.cmd.cleardoubleoddpage}, or
-\DescRef{\LabelBase.cmd.cleardoubleevenpage} to break until the wanted
-page. Every already defined \PName{page style} (see
+\DescRef{\LabelBase.cmd.cleardoubleevenpage} to advance to the desired page.
+You can use any previously defined \PName{page style} (see
\autoref{sec:\ThisCommonLabelBase.pagestyle} from
\autopageref{sec:\ThisCommonLabelBase.pagestyle} and
-\autoref{cha:scrlayer-scrpage} from \autopageref{cha:scrlayer-scrpage}) may be
-used. Besides this, \OptionValue{cleardoublepage}{current} is valid. This case
-is the default until \KOMAScript~2.98c and results in interleaf page without
-changing the page style. Since \KOMAScript~3.00%
-\IfThisCommonLabelBase{maincls}{%
+\autoref{cha:scrlayer-scrpage} from \autopageref{cha:scrlayer-scrpage}).
+In addition, \OptionValue{cleardoublepage}{current} is also possible.
+This case corresponds to the default prior to \KOMAScript~2.98c and creates an
+interleaf page without changing the page style. Starting with
+\KOMAScript~3.00\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
}{%
\IfThisCommonLabelBase{scrlttr2}{%
\ChangedAt{v3.00}{\Class{scrlttr2}}%
}{}%
-} %
-the default follows the recommendation of most typographers and has been
-changed to blank interleaf pages with page style \PageStyle{empty} unless you
-switch compatibility to an earlier version (see option
-\DescRef{\ThisCommonLabelBase.option.version},
+}, the default\textnote{default} follows the recommendation of most
+typographers and creates interleaf pages with the
+\IfThisCommonLabelBase{scrextend}{%
+ \DescRef{maincls.pagestyle.empty}}{%
+ \DescRef{\ThisCommonLabelBase.pagestyle.empty}}\IndexPagestyle{empty}
+page style unless you switch compatibility to earlier \KOMAScript{} versions
+(see option \DescRef{\ThisCommonLabelBase.option.version}%
+\important{\OptionValueRef{\LabelBase}{version}{2.98c}},
\autoref{sec:\ThisCommonLabelBase.compatibilityOptions},
\DescPageRef{\ThisCommonLabelBase.option.version}).
\IfThisCommonLabelBase{maincls}{\iftrue}{\csname iffalse\endcsname}
\begin{Example}
\phantomsection\xmpllabel{option.cleardoublepage}%
- Assume you want interleaf pages almost empty but with pagination. This
- means you want to use page style \PageStyle{plain}. You may use following
- to achieve this:
+ Suppose you want interleaf pages that are empty except for the pagination%
+ \iffree{, so they are created with \IfThisCommonLabelBase{scrextend}{%
+ \DescRef{maincls.pagestyle.plain}}{%
+ \DescRef{\LabelBase.pagestyle.plain}}}{}. You can achieve this,
+ for example, with:
\begin{lstcode}
\KOMAoptions{cleardoublepage=plain}
\end{lstcode}
- More information about page style \PageStyle{plain} may be found at
- \autoref{sec:maincls.pagestyle},
- \DescPageRef{maincls.pagestyle.plain}.
+ You can find more information about the
+ \IfThisCommonLabelBase{scrextend}{%
+ \DescRef{maincls.pagestyle.plain}}{\DescRef{\LabelBase.pagestyle.plain}}
+ page style in \IfThisCommonLabelBase{scrextend}{%
+ \autoref{sec:maincls.pagestyle}}{%
+ \autoref{sec:\LabelBase.pagestyle}},
+ \IfThisCommonLabelBase{scrextend}{%
+ \DescPageRef{maincls.pagestyle.plain}}{%
+ \DescPageRef{\LabelBase.pagestyle.plain}}.
\end{Example}
\else
- \IfThisCommonLabelBase{scrextend}{\iftrue}{\csname iffalse\endcsname}
+ \IfThisCommonLabelBase{scrextend}{%
+ You can find an example for setting the page style of interleaf pages in
+ \autoref{sec:\ThisCommonFirstLabelBase.emptypage},
+ \PageRefxmpl{\ThisCommonFirstLabelBase.option.cleardoublepage}.%
+ \iffalse% Umbruchvariante ohne Beispiel
+ }{\csname iffalse\endcsname}
\begin{Example}
\phantomsection\xmpllabel{option.cleardoublepage}%
- Assume you want interleaf pages almost empty but with pagination. This
- means you want to use page style \PageStyle{plain}. You may use
- following to achieve this:
+ Suppose you want interleaf pages that are empty except for the pagination,
+ so they are created with the \IfThisCommonLabelBase{scrextend}{%
+ \DescRef{maincls.pagestyle.plain}}{\DescRef{\LabelBase.pagestyle.plain}}
+ page style. You can achieve this with
\begin{lstcode}
\KOMAoptions{cleardoublepage=plain}
\end{lstcode}
- More information about page style \PageStyle{plain} may be found at
- \autoref{sec:maincls.pagestyle},
- \DescPageRef{maincls.pagestyle.plain}.
+ You can find more information about the
+ \DescRef{maincls.pagestyle.plain} page style in
+ \autoref{sec:maincls.pagestyle}, \DescPageRef{maincls.pagestyle.plain}.
\end{Example}%
\fi%
\fi%
@@ -175,81 +195,103 @@ switch compatibility to an earlier version (see option
\Macro{cleardoubleevenplainpage}%
\Macro{cleardoubleevenstandardpage}
\end{Declaration}%
-The {\LaTeX} kernel contains the \Macro{clearpage} command, which takes
-care that all not yet output floats are output, and then starts a new
-page. There exists the instruction \Macro{cleardoublepage} which
-works like \Macro{clearpage} but which, in the double-sided layouts
-(see layout option \Option{twoside} in
-\autoref{sec:typearea.options},
-\DescPageRef{typearea.option.twoside}) starts a new right-hand
-page. An empty left page in the current page style is output if
-necessary.
+The\textnote{standard classes} {\LaTeX} kernel provides the \Macro{clearpage}
+command, which ensures that all pending floats are output and then starts a
+new page. There is also the \Macro{cleardoublepage} command, which works like
+\Macro{clearpage} but which starts a new right-hand page in two-sided printing
+(see the \Option{twoside} layout option in \autoref{sec:typearea.options},
+\DescPageRef{typearea.option.twoside}). An empty left-hand page in the current
+page style is output if necessary.
-With%
-\IfThisCommonLabelBase{maincls}{%
+With\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
}{%
\IfThisCommonLabelBase{scrlttr2}{%
\ChangedAt{v3.00}{\Class{scrlttr2}}%
}{}%
-} %
-\Macro{cleardoubleoddstandardpage}, {\KOMAScript} works as described above.
-The \Macro{cleardoubleoddplainpage} command changes the page style of the
-empty left page to \PageStyle{plain}\IndexPagestyle{plain} in order to
-suppress the \IfThisCommonLabelBase{scrlttr2}{page}{running} head.
-Analogously, the page style \PageStyle{empty}\IndexPagestyle{empty} is applied
-to the empty page with \Macro{cleardoubleoddemptypage}, suppressing the page
-number as well as the \IfThisCommonLabelBase{scrlttr2}{page}{running}
-head. The page is thus entirely empty. If another \PName{page style} is wanted
-for the interleaf page is may be set with the argument of
-\Macro{cleardoubleoddusingpagestyle}. Every already defined \PName{page style}
-(see \autoref{cha:scrlayer-scrpage}) may be used.
+} \Macro{cleardoubleoddstandardpage}, {\KOMAScript}\textnote{\KOMAScript}
+works as exactly in the way just described for the standard classess. The
+\Macro{cleardoubleoddplainpage}%
+\important{\IfThisCommonLabelBase{scrextend}{%
+ \DescRef{maincls.pagestyle.plain}}{\DescRef{\LabelBase.pagestyle.plain}}}
+command, on the other hand, additionally changes the page style of the empty
+left page to \IfThisCommonLabelBase{scrextend}{%
+ \DescRef{maincls.pagestyle.plain}}{\DescRef{\LabelBase.pagestyle.plain}}%
+\IndexPagestyle{plain} in order to suppress the
+\IfThisCommonLabelBase{scrlttr2}{page header}{running title}. Likewise, the
+\Macro{cleardoubleoddemptypage}\important{%
+ \IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{%
+ \DescRef{\LabelBase.pagestyle.empty}}} command uses the
+\IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{%
+ \DescRef{\LabelBase.pagestyle.empty}}\IndexPagestyle{empty} page style to
+suppress both \IfThisCommonLabelBase{scrlttr2}{page header and page footer}%
+{running title and page number} on the empty left-hand side. The page is thus
+completely empty. If you want to specify your own \PName{page style} for the
+interleaf page, this should be given as an argument of
+\Macro{cleardoubleoddusingpagestyle}. You can use any previously defined
+\PName{page style} (see \autoref{cha:scrlayer-scrpage}).
\IfThisCommonLabelBase{scrlttr2}{}{%
- Sometimes chapters should not start on the right-hand page but the left-hand
- page. This is in contradition to the classic typography; nevertheless, it
- may be suitable, e.\,g., if the double-page spread of the chapter start is
- of special contents. \KOMAScript{} therefor provides the commands
- \Macro{cleardoubleevenstandardpage}, \Macro{cleardoubleevenplainpage},
- \Macro{cleardoubleevenemptypage}, and \Macro{cleardoubleevenpageusingstyle},
- which are equivalent to the odd-page commands.%
+ Sometimes\textnote{odd-side interleaf pages} you want chapters to start not
+ on the right-hand but on the left-hand page. Although this layout contradicts
+ classic typography, it can be appropriate if the double-page spread at the
+ beginning of the chapter very specific contents. For this reason,
+ \KOMAScript{} provides the \Macro{cleardoubleevenstandardpage} command,
+ which is equivalent to the \Macro{cleardoubleoddstandardpage} command
+ except that the next page is a left page. The same applies to the
+ \Macro{cleardoubleevenplainpage}, \Macro{cleardoubleevenemptypage}, and
+ \Macro{cleardoubleevenpageusingstyle} commands%
+ \IfThisCommonLabelBase{maincls}{% Umbruchoptimierungsalternative
+ , the last of which expects an argument}{}.%
}
-However, the approach used by the \KOMAScript{} commands
-\Macro{cleardoublestandardpage}, \Macro{cleardoubleemptypage},
-\Macro{cleardoubleplainpage}, and \Macro{cleardoublepageusingstyle} is
-dependent on the option
-\Option{cleardoublepage}\important{\Option{cleardoublepage}} described above
-and is similar to one of the corresponding commands above. The same is valid for
-the standard command \Macro{cleardoublepage}, that may be either
-\Macro{cleardoubleoddpage} or \Macro{cleardoubleevenpage}.
-
-\IfThisCommonLabelBase{scrlttr2}{%
- In \Class{scrlttr2} the other commands are there only for completeness. More
- information about them may be found at
- \autoref{sec:maincls.emptypage},
- \DescPageRef{maincls.cmd.cleardoublepage} if needed.%
-}{}%
-\IfThisCommonLabelBase{scrlttr2}{\iffalse}{\csname iftrue\endcsname}
-\begin{Example}
+The \Macro{cleardoublestandardpage}, \Macro{cleardoubleemptypage}, and
+\Macro{cleardoubleplainpage} commands, and the single-argument
+\Macro{cleardoublepageusingstyle} command, as well as the standard
+\Macro{cleardoublepage} command, %
+\IfThisCommonLabelBase{maincls}{%
+ depend on the \DescRef{maincls.option.open}\IndexOption{open}%
+ \important{\DescRef{maincls.option.open}} option explained in
+ \autoref{sec:maincls.structure}, \DescPageRef{maincls.option.open} and,
+ depending on that setting, correspond to one of the commands explained in
+ the preceding paragraphs. }{%
+ correspond to the commands previously explained for the
+ \IfThisCommonLabelBase{scrlttr2}{\Class{scrlttr2} class}{%
+ \IfThisCommonLabelBase{scrextend}{\Package{scrextend} package}{%
+ \InternalCommonFileUsageError}%
+ }%
+ \IfThisCommonLabelBase{scrlttr2}{. %
+ The remaining commands are defined in \Class{scrlttr2} for completeness
+ only. You can find more information on them in
+ \autoref{sec:maincls.emptypage}, \DescPageRef{maincls.cmd.cleardoublepage}
+ if necessary%
+ }{%
+ \ to transition to the next odd page%
+ }.%
+}%
+\IfThisCommonLabelBaseOneOf{scrlttr2,scrextend}{\iffalse}{\csname
+ iftrue\endcsname}
+ \begin{Example}
\phantomsection\xmpllabel{cmd.cleardoublepage}%
- Assume you want to set next in your document a double-page spread
- with a picture at the left-hand page and a chapter start at the
- right-hand page. The picture should have the same size as the text
- area without any head line or pagination. If the last chapter
- ends with a left-hand page, an interleaf page has to be added, which
- should be completely empty.
-
- First you will use
+ Suppose you want to insert a double-page spread into your document with a
+ picture on the left-hand page and a new chapter starting on the right-hand
+ page. If the previous chapter ends with a left-hand page, an interleaf
+ page has to be added, which should be completely empty. The picture should
+ be the same size as the text area without any header or footer.
+\iffalse% Umbruchkorrekturtext
+ First of all,
\begin{lstcode}
\KOMAoptions{cleardoublepage=empty}
\end{lstcode}
- to make interleaf pages empty. You may use this setting at the document
- preamble already. As an alternative you may set it as the optional
- argument of \DescRef{\ThisCommonLabelBase.cmd.documentclass}.
+ ensures that interleaf pages use the
+ \IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{%
+ \DescRef{\LabelBase.pagestyle.empty}} page style. You can put this
+ setting in the document preamble, or you can set it as an optional
+ argument of \DescRef{\ThisCommonLabelBase.cmd.documentclass}.
+\fi
- At the relevant place in your document, you'll write:
+ At the relevant place in your document, write:
\begin{lstcode}
\cleardoubleevenemptypage
\thispagestyle{empty}
@@ -257,24 +299,30 @@ the standard command \Macro{cleardoublepage}, that may be either
height=\textheight,%
keepaspectratio]%
{picture}
- \chapter{Chapter Headline}
+ \chapter{Chapter Heading}
\end{lstcode}
- The first of these lines switches to the next left page. If needed it also
- adds a completely blank right-hand page. The second line makes sure that
- the following left-hand page will be set using page style
- \PageStyle{empty} too. From third down to sixth line, an external picture
- of wanted size will be loaded without deformation. Package
- \Package{graphicx}\IndexPackage{graphicx} will be needed for this
- command. The last line starts a new chapter on the next page which will be
- a right-hand one.
+ The first of these lines switches to the next left-hand page. If needed it
+ also adds a completely blank right-hand page. The second line makes sure
+ that the following left-hand page will also be set using the
+ \IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{%
+ \DescRef{\LabelBase.pagestyle.empty}} page style. The third through
+ sixth lines load an image file named \File{picture} and scale it to the
+ desired size without distorting it. This command requires the
+ \Package{graphicx}\IndexPackage{graphicx} package (see
+ \cite{package:graphics}). The last line starts
+ a new chapter on the next page, which will be a right-hand one.
\end{Example}%
\fi%
-The commands \Macro{cleardoubleoddpage} respective \Macro{cleardoubleevenpage}
-leads to the next odd respectively even page. The page style of an interleaf
-page will be set depending on option
-\DescRef{\LabelBase.option.cleardoublepage}.%
-%
+In two-sided printing, \Macro{cleardoubleoddpage} always moves to the next
+left-hand page and \Macro{cleardoubleevenpage} to the next right-hand
+page. The style of the interleaf page to be inserted if necessary is defined
+with the \DescRef{\LabelBase.option.cleardoublepage} option.%
+\IfThisCommonLabelBase{scrextend}{\par%
+ For an example that uses \Macro{cleardoubleevenemptypage}, see
+ \autoref{sec:maincls.emptypage},
+ \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.cleardoublepage}.%
+}{}%
\EndIndexGroup
%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-lists.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-lists.tex
index 961ae6c4ed2..79a0a697fda 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-lists.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-lists.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-lists.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-lists.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,11 +46,12 @@
% ======================================================================
\KOMAProvidesFile{common-lists.tex}
- [$Date: 2017-01-30 20:46:35 +0100 (Mon, 30 Jan 2017) $
+ [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (common paragraphs)]
-\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi}
+\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and
+ Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-02-06
\section{Lists}
\seclabel{lists}%
@@ -58,91 +59,106 @@
\BeginIndex{}{lists}%
\IfThisCommonFirstRun{}{%
- All of what is described in \autoref{sec:\ThisCommonFirstLabelBase.lists} is
- generally applicable. So if you have alread read and understood
- \autoref{sec:\ThisCommonFirstLabelBase.lists} you can switch to
+ The information in \autoref{sec:\ThisCommonFirstLabelBase.lists} applies
+ equally to this chapter. So if you have already read and understood
+ \autoref{sec:\ThisCommonFirstLabelBase.lists}, you can skip ahead to
\autoref{sec:\ThisCommonLabelBase.lists.next},
\autopageref{sec:\ThisCommonLabelBase.lists.next}.%
- \IfThisCommonLabelBase{scrextend}{ %
- However, \Package{scrextend} does support only the environments
+ \IfThisCommonLabelBaseOneOf{scrextend,scrlttr2}{ %
+ \IfThisCommonLabelBase{scrlttr2}{%
+ The \Package{scrletter}\OnlyAt{\Package{scrletter}} package does not
+ define any list environments itself but leaves them to the class
+ used. If this is not a \KOMAScript{} class, it will load
+ \hyperref[cha:scrextend]{\Package{scrextend}}\IndexPackage{scrextend}%
+ \important{\hyperref[cha:scrextend]{\Package{scrextend}}}.%
+ }{} %
+ However, the \Package{scrextend} package only defines the
\DescRef{\ThisCommonLabelBase.env.labeling},
- \DescRef{\ThisCommonLabelBase.env.addmargin} and
- \DescRef{\ThisCommonLabelBase.env.addmargin*}. All the other list
- environments may be supported and controlled by the used class.%
+ \DescRef{\ThisCommonLabelBase.env.addmargin}, and
+ \DescRef{\ThisCommonLabelBase.env.addmargin*} environments. All other list
+ environments are left to the responsibility of the class used.%
}{}%
}
-Both {\LaTeX} and the standard classes offer different environments for
-lists. Though slightly changed or extended all these list are of course
-offered in {\KOMAScript} as well. In general, all lists\,---\,even of different
-kind\,---\,can be nested up to four levels. From a typographical view,
-anything more would make no sense, as more than three levels can no longer be
-easily perceived. The recommended\textnote{Hint!} procedure in such a case is
-to split the large list into several smaller ones.
+\IfThisCommonLabelBase{scrextend}{}{%
+ Both {\LaTeX} and the standard classes\textnote{\KOMAScript{} vs. standard
+ classes} offer different environments for lists. Naturally, {\KOMAScript}
+ also offers all these environments, though slightly modified or extended in
+ some cases. In general, all lists\,---\,even those of different
+ kinds\,---\,can be nested up to four levels deep. From a typographical view,
+ anything more would make no sense, as lists of more than three levels cannot
+ easily be apprehended. In such cases, I recommend\textnote{Hint!} that you
+ split a large list into several smaller ones.%
+}
\IfThisCommonFirstRun{}{%
- Because lists are standard elements of \LaTeX{} this section abandons on
- examples. Nevertheless, you may find examples either in
- \autoref{sec:\ThisCommonFirstLabelBase.lists} from
- \autopageref{sec:\ThisCommonFirstLabelBase.lists} or in almost every
- introduction to \LaTeX.%
+ Because lists are standard elements of \LaTeX{}, examples have been omitted
+ in this section. Nevertheless, you can find examples either in
+ \autoref{sec:\ThisCommonFirstLabelBase.lists},
+ \autopageref{sec:\ThisCommonFirstLabelBase.lists} or in any \LaTeX{}
+ tutorial.%
}
\IfThisCommonLabelBase{scrextend}{\iffalse}{\csname iftrue\endcsname}
\begin{Declaration}
- \begin{Environment}{itemize}\labelsuffix[itemize]
+ \begin{Environment}{itemize}
\begin{Body}
\Macro{item} \dots
\BodyDots
\end{Body}
\end{Environment}
- \Macro{labelitemi}%
- \Macro{labelitemii}%
- \Macro{labelitemiii}%
+ \Macro{labelitemi}
+ \Macro{labelitemii}
+ \Macro{labelitemiii}
\Macro{labelitemiv}
\end{Declaration}%
- The simplest form of a list is an \Environment{itemize} list.
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}%
+ The simplest form of a list is the itemized list\textnote{itemized list},
+ \Environment{itemize}. %
\iffalse % Umbruckoptimierungstext
- The users of a certain disliked word processing package often refer to
- this form of a list as \emph{bulletpoints}. Presumably, these users
- are unable to envisage that, depending on the level, a different
- symbol from a large dot could be used to introduce each
- point. %
+ The users of a certain disliked word processing package often refer to this
+ form of a list as \emph{bullet points}. Presumably, they cannot imagine
+ that, depending on the level, a symbol other than a large dot could be used
+ to introduce each point. %
\fi%
- Depending on the level, {\KOMAScript} uses the following marks:
- ``{\labelitemi}'', ``{\labelitemii}'', ``{\labelitemiii}'' and
+ Depending on the level, \KOMAScript{} classes use the following marks:
+ ``{\labelitemi}'', ``{\labelitemii}'', ``{\labelitemiii}'', and
``{\labelitemiv}''. The definition of these symbols is specified in
the macros \Macro{labelitemi}, \Macro{labelitemii},
- \Macro{labelitemiii} and \Macro{labelitemiv}, all of which can be
- redefined using \Macro{renewcommand}. Every item is introduced with
+ \Macro{labelitemiii}, and \Macro{labelitemiv}, all of which you can
+ redefine using \Macro{renewcommand}. Every item is introduced with
\Macro{item}.%
\IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}
\begin{Example}
\phantomsection\xmpllabel{env.itemize}%
- You have a simple list which is nested in several levels. You write
+ You have a simple list which is nested in several levels. You write,
for example:
\begin{lstcode}
- \minisec{Vehicles}
+ \minisec{Vehicles in the game}
\begin{itemize}
\item aeroplanes
\begin{itemize}
\item biplane
- \item jets
\item transport planes
\begin{itemize}
- \item single-engined
+ \item single-engine
\begin{itemize}
- \item jet-driven
- \item propeller-driven
+ \item jet propelled
+ \item propeller driven
\end{itemize}
- \item multi-engined
+ \item twin-engine
+ \begin{itemize}
+ \item jet propelled
+ \item propeller driven
+ \end{itemize}
\end{itemize}
\item helicopters
\end{itemize}
+ \item motorcycles
\item automobiles
\begin{itemize}
\item racing cars
- \item private cars
+ \item passenger cars
\item lorries
\end{itemize}
\item bicycles
@@ -150,34 +166,35 @@ to split the large list into several smaller ones.
\end{lstcode}
As output you get:
\begin{ShowOutput}[\baselineskip]
- \minisec{Vehicles}
+ \minisec{Vehicles in the game}
\begin{itemize}
\item aeroplanes
\begin{itemize}
\item biplanes
- \item jets
\item transport planes
\begin{itemize}
- \item single-engined
+ \item single-engine
\begin{itemize}
- \item jet-driven
+ \item jet-propelled
\item propeller-driven
\end{itemize}
- \item multi-engined
+ \item twin-engine
+ \begin{itemize}
+ \item jet propelled
+ \item propeller driven
+ \end{itemize}
\end{itemize}
\item helicopters
\end{itemize}
-% Falls fuer die Umbruchoptimierung erforderlich, kann die Liste
-% beispielsweise so erweitert werden:
-% \item motorcycles
-% \begin{itemize}
-% \item historically accurate
-% \item futuristic, not real
-% \end{itemize}
+ \item motorcycles
+ % \begin{itemize}
+ % \item historically accurate
+ % \item futuristic, not real
+ % \end{itemize}
\item automobiles
\begin{itemize}
\item racing cars
- \item private cars
+ \item passenger cars
\item lorries
\end{itemize}
\item bicycles
@@ -205,60 +222,59 @@ to split the large list into several smaller ones.
\Macro{labelenumiii}%
\Macro{labelenumiv}
\end{Declaration}%
- Another form of a list often used is a numbered list which is already
- implemented by the {\LaTeX} kernel. Depending on the level, the
- numbering\Index{numbering} uses the following characters: Arabic numbers,
- small letters, small roman numerals, and capital letters. The kind of
- numbering is defined with the macros \Macro{theenumi} down to
- \Macro{theenumiv}. The output format is determined by the macros
- \Macro{labelenumi} to \Macro{labelenumiv}. While the small letter of the
- second level is followed by a round parenthesis, the values of all other
- levels are followed by a dot. Every item is introduced with \Macro{item}.%
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}The numbered
+ list\textnote{numbered list} is also very common and already provided by the
+ {\LaTeX} kernel. The numbering\Index{numbering} differs according to the
+ level, with Arabic numbers, small letters, small Roman numerals, and capital
+ letters, respectively. The style of numbering is defined with the macros
+ \Macro{theenumi} down to \Macro{theenumiv}. The output format is determined
+ by the macros \Macro{labelenumi} to \Macro{labelenumiv}. While the small
+ letter of the second level is followed by a right parenthesis, the values of
+ all other levels are followed by a dot. Every item is introduced with
+ \Macro{item}.%
\IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}
\begin{Example}
\phantomsection\xmpllabel{env.enumerate}%
- Replacing every occurrence of an
- \DescRef{\ThisCommonLabelBase.env.itemize} environment with an
- \Environment{enumerate} environment in the example above we
- get the following result:
+ Let's shorten the previous example, using an
+ \DescRef{\ThisCommonLabelBase.env.itemize} environment instead of the
+ \Environment{enumerate} environment:
\begin{ShowOutput}[\baselineskip]
- \minisec{Vehicles}
+ \minisec{Vehicles in the game}
\begin{enumerate}
\item aeroplanes
\begin{enumerate}
\item biplanes
- \item jets
\item transport planes
\begin{enumerate}
- \item single-engined
+ \item single-engine
\begin{enumerate}
- \item jet-driven\label{xmp:maincls.jets}
+ \item jet-propelled\label{xmp:maincls.jets}
\item propeller-driven
\end{enumerate}
- \item multi-engined
+ \item twin-engine
\end{enumerate}
- \item helicopters
+ % \item helicopters
\end{enumerate}
- % Wie oben:
- % \item motorcycles
- % \begin{enumerate}
- % \item historically accurate
- % \item futuristic, not real
- % \end{enumerate}
- \item automobiles
+ \item motorcycles
\begin{enumerate}
- \item racing cars
- \item private cars
- \item lorries
+ \item historically accurate
+ \item futuristic, not real
\end{enumerate}
- \item bicycles
+ %\item automobiles
+ % \begin{enumerate}
+ % \item racing cars
+ % \item private cars
+ % \item lorries
+ % \end{enumerate}
+ %\item bicycles
\end{enumerate}
\end{ShowOutput}
- Using \Macro{label} within a list you can set labels which are
- referenced with \Macro{ref}. In the example above, a label was set
- after the jet-driven, single-engined transport planes with
- \Macro{label}\PParameter{xmp:jets}. The \Macro{ref} value is then
- \ref{xmp:maincls.jets}.
+ Within the list, you can set labels in the normal way with
+ \Macro{label} and then reference then with \Macro{ref}.
+ In the example above, a label was set after the jet-propelled,
+ single-engine transport planes with
+ ``\Macro{label}\PParameter{xmp:jets}''. The \Macro{ref} value is then
+ ``\ref{xmp:maincls.jets}''.
\end{Example}
\fi%
%
@@ -273,44 +289,44 @@ to split the large list into several smaller ones.
\end{Body}
\end{Environment}
\end{Declaration}%
- A further list form is the description list. Its main use is the description
- of several items. The item itself is an optional parameter in
- \Macro{item}. %
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Another list
+ form is the description list\textnote{description list}. It primarily serves
+ to describe individual items or keywords. The item itself is specified as an
+ optional parameter in \Macro{item}. %
\BeginIndex{FontElement}{descriptionlabel}%
\LabelFontElement{descriptionlabel}%
The font\Index{font>style}\ChangedAt{v2.8p}{%
\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
- which is responsible for emphasizing the item can be changed with the
- commands \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
- \DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (see
+ \ used to format the keyword can be changed with the
+ \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
+ \DescRef{\ThisCommonLabelBase.cmd.addtokomafont} commands (see
\autoref{sec:\ThisCommonLabelBase.textmarkup},
- \DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) for the element
- \FontElement{descriptionlabel} (see
- \autoref{tab:\ThisCommonLabelBase.fontelements},
- \autopageref{tab:\ThisCommonLabelBase.fontelements}). Default setting is
+ \DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) for the
+ \FontElement{descriptionlabel}\important{\FontElement{descriptionlabel}}
+ element (see \autoref{tab:\ThisCommonLabelBase.fontelements},
+ \autopageref{tab:\ThisCommonLabelBase.fontelements}). The default is
\Macro{sffamily}\linebreak[1]\Macro{bfseries}.%
\IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}
\begin{Example}
\phantomsection\xmpllabel{env.description}%
- Instead of items in sans serif and bold, you want them printed in the
- standard font in bold. Using
+ You want the keywords to be printed bold and in the normal font instead
+ of bold and sans serif. Using
\begin{lstcode}
\setkomafont{descriptionlabel}{\normalfont\bfseries}
\end{lstcode}
you redefine the font accordingly.
An example for a description list is the output of the page styles
- listed in \autoref{sec:maincls.pagestyle}. The heavily
- abbreviated source could be:
+ listed in \autoref{sec:maincls.pagestyle}. The (abbreviated) source is:
\begin{lstcode}
\begin{description}
- \item[empty] is the page style without any header or footer.
+ \item[empty] is the page style without any header or footer.
\item[plain] is the page style without headings.
\item[headings] is the page style with running headings.
\item[myheadings] is the page style for manual headings.
\end{description}
\end{lstcode}
- This abbreviated version gives:
+ This gives:
\begin{ShowOutput}
\begin{description}
\item[empty] is the page style without any header or footer.
@@ -326,8 +342,8 @@ to split the large list into several smaller ones.
\fi
\begin{Declaration}
- \begin{Environment}{labeling}
- \OParameter{delimiter}\Parameter{widest pattern}
+ \begin{Environment}{labeling}\OParameter{delimiter}
+ \Parameter{widest pattern}
\labelsuffix[labeling]
\begin{Body}
\Macro{item}\OParameter{keyword}\dots
@@ -335,17 +351,21 @@ to split the large list into several smaller ones.
\end{Body}
\end{Environment}
\end{Declaration}%
-An additional form of a description list is only available in the
-{\KOMAScript} classes%
-\IfThisCommonLabelBase{scrextend}{ and the package \Package{scrextend}}{}: the
-\Environment{labeling} environment. Unlike the %
+Another form of description list\textnote{alternative description list} is
+only available in the {\KOMAScript} classes%
+\IfThisCommonLabelBase{scrextend}{ and \Package{scrextend} }{%
+ \IfThisCommonLabelBase{scrlttr2}{ and
+ \hyperref[cha:scrextend]{\Package{scrextend}}}{}%
+}%
+: the \Environment{labeling} environment. Unlike
\IfThisCommonLabelBase{scrextend}{%
\DescRef{\ThisCommonFirstLabelBase.env.description}%
}{%
- \DescRef{\ThisCommonLabelBase.env.description}%
-} environment, you can provide a
-pattern whose length determines the indentation of all items. Furthermore, you
-can put an optional \PName{delimiter} between the item and its description.
+ the \DescRef{\ThisCommonLabelBase.env.description} described above%
+}, you can specify a pattern for \Environment{labeling} whose length
+determines the indentation of all items. Furthermore, you can put an optional
+\PName{delimiter} between the item and its description. %
+\BeginIndexGroup
\BeginIndex{FontElement}{labelinglabel}\LabelFontElement{labelinglabel}%
\BeginIndex{FontElement}{labelingseparator}%
\LabelFontElement{labelingseparator}%
@@ -361,10 +381,9 @@ The font\Index{font>style}%
\ChangedAt{v3.02}{\Package{scrextend}}%
}{\InternalCommonFileUsageError}%
}%
-}%
-which is responsible for emphasizing the item and the separator can be changed
-with the commands \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
-\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (see
+} used to format the item and the separator can be changed with the
+\DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
+\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} commands (see
\autoref{sec:\ThisCommonLabelBase.textmarkup},
\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) for the element
\FontElement{labelinglabel} and \FontElement{labelingseparator} (see
@@ -374,18 +393,18 @@ with the commands \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
\begin{Example}
\phantomsection\xmpllabel{env.labeling}%
\IfThisCommonLabelBase{scrextend}{%
- A small example of a list like this may be written:%
+ A small example of a list like this can be written as follows:%
}{%
Slightly changing the example from the
\DescRef{\ThisCommonLabelBase.env.description} environment, we could
- write:%
+ write the following:%
}%
\begin{lstcode}
\setkomafont{labelinglabel}{\ttfamily}
\setkomafont{labelingseparator}{\normalfont}
\begin{labeling}[~--]{myheadings}
\item[empty]
- Page style without header and footer
+ Page style without header or footer
\item[plain]
Page style for chapter beginnings without headings
\item[headings]
@@ -394,13 +413,13 @@ with the commands \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
Page style for manual headings
\end{labeling}
\end{lstcode}
- As the result we get:
+ The result is this:
\begin{ShowOutput}
\setkomafont{labelinglabel}{\ttfamily}
\setkomafont{labelingseparator}{\normalfont}
\begin{labeling}[~--]{myheadings}
\item[empty]
- Page style without header and footer
+ Page style without header or footer
\item[plain]
Page style for chapter beginnings without headings
\item[headings]
@@ -409,15 +428,16 @@ with the commands \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
Page style for manual headings
\end{labeling}
\end{ShowOutput}
- As can be seen in this example, a font changing command may be set
- in the usual way. But if you do not want the font of the separator to
- be changed in the same way as the font of the label, you have to set
- the font of the separator as well.
+ As this example shows, you can set a font-changing command in the usual
+ way. But if you do not want the font of the separator to be changed in the
+ same way as the font of the label, you have to set the font of the
+ separator as well.
\end{Example}
\fi%
-Originally, this environment was implemented for things like ``Precondition,
-Assertion, Proof'', or ``Given, Required, Solution'' that are often used in
-lecture hand-outs. By now this environment has found many different
+\EndIndexGroup
+Originally, this environment was implemented for things like ``Premise,
+Evidence, Proof'', or ``Given, Find, Solution'' that are often used in
+lecture handouts. These days, however, the environment has very different
applications. For example, the environment for examples in this guide was
defined with the \Environment{labeling} environment.%
%
@@ -428,25 +448,26 @@ defined with the \Environment{labeling} environment.%
\begin{Declaration}
\begin{Environment}{verse}\end{Environment}
\end{Declaration}%
- Usually the \Environment{verse} environment is not perceived as a list
- environment because you do not work with \Macro{item} commands. Instead,
- fixed line breaks are used within the \Environment{flushleft}
- environment. Yet internally in both the standard classes as well as
- {\KOMAScript} it is indeed a list environment.
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{} The
+ \Environment{verse} environment\textnote{verse} is not normally perceived
+ as a list environment because you do not work with \Macro{item} commands.
+ Instead, fixed line breaks are used within the \Environment{flushleft}
+ environment. Internally, however, both the standard classes as well as
+ {\KOMAScript} implement it as a list environment.
In general, the \Environment{verse} environment is used for
- poems\Index{poems}. Lines are indented both left and right. Individual
- lines of verse are ended by a fixed line break \verb|\\|. Verses are set as
+ poetry\Index{poetry}. Lines are indented both left and right. Individual
+ lines of verse are ended by a fixed line break: \verb|\\|. Verses are set as
paragraphs, separated by an empty line. Often also
\Macro{medskip}\IndexCmd{medskip} or \Macro{bigskip}\IndexCmd{bigskip} is
- used instead. To avoid a page break at the end of a line of verse you could,
+ used instead. To avoid a page break at the end of a line of verse you can,
as usual, insert \verb|\\*| instead of \verb|\\|.
\IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}
\begin{Example}
\phantomsection\xmpllabel{env.verse}%
-\iffalse
- As an example, the first lines of ``Little Red Riding Hood and the
- Wolf'' by Roald Dahl:
+ \iffalse
+ As an example, the first lines of ``Little Red Riding Hood and the
+ Wolf'' by Roald Dahl:
\begin{lstcode}
\begin{verse}
As soon as Wolf began to feel\\*
@@ -457,24 +478,24 @@ defined with the \Environment{labeling} environment.%
And Wolfie said, `May I come in?'
\end{verse}
\end{lstcode}
- The result is as follows:
- \begin{ShowOutput}
- \begin{verse}
- As soon as Wolf began to feel\\*
- That he would like a decent meal,\\*
- He went and knocked on Grandma's door.\\*
- When Grandma opened it, she saw\\*
- The sharp white teeth, the horrid grin,\\*
- And Wolfie said, `May I come in?'
- \end{verse}
- \end{ShowOutput}
-\else
- As an example, the sonnet of Emma Lazarus from the pedestal of Liberty
- Enlightening the World\footnote{The lines from Roald Dahl's poem
- ``Little Red Riding Hood and the Wolf'', that has been used in former
- releases, has been replaced, because in these times several
- politicians all over the world really seem to need ``The New
- Colossus'' as urgent reminder.}:
+ The result is as follows:
+ \begin{ShowOutput}
+ \begin{verse}
+ As soon as Wolf began to feel\\*
+ That he would like a decent meal,\\*
+ He went and knocked on Grandma's door.\\*
+ When Grandma opened it, she saw\\*
+ The sharp white teeth, the horrid grin,\\*
+ And Wolfie said, `May I come in?'
+ \end{verse}
+ \end{ShowOutput}
+ \else
+ As an example, Emma Lazarus's sonnet from the pedestal of Liberty
+ Enlightening the World\footnote{The lines from Roald Dahl's poem
+ ``Little Red Riding Hood and the Wolf'', which was used in former
+ releases, has been replaced, because in these times certain
+ politicians around the world really seem to need ``The New
+ Colossus'' as urgent reminder.}:
\begin{lstcode}
\begin{verse}
Not like the brazen giant of Greek fame\\*
@@ -493,81 +514,138 @@ defined with the \Environment{labeling} environment.%
I lift my lamp beside the golden door.''
\end{verse}
\end{lstcode}
- The result is as follows:
- \begin{ShowOutput}
- \begin{verse}
- Not like the brazen giant of Greek fame\\*
- With conquering limbs astride from land to land\\*
- Here at our sea-washed, sunset gates shall stand\\*
- A mighty woman with a torch, whose flame\\*
- Is the imprisoned lightning, and her name\\*
- Mother of Exiles. From her beacon-hand\\*
- Glows world-wide welcome; her mild eyes command\\*
- The air-bridged harbor that twin cities frame.\\*
- ``Keep, ancient lands, your storied pomp!'' cries she\\*
- With silent lips. ``Give me your tired, your poor,\\*
- Your huddled masses yearning to breathe free,\\*
- The wretched refuse of your teeming shore.\\*
- Send these, the homeless, tempest-tossed to me:\\*
- I lift my lamp beside the golden door.''
- \end{verse}
- \end{ShowOutput}
-\fi
- However, if you have very long lines of verse, for instance:
+ The result is as follows:
+ \begin{ShowOutput}
+ \begin{verse}
+ Not like the brazen giant of Greek fame\\*
+ With conquering limbs astride from land to land\\*
+ Here at our sea-washed, sunset gates shall stand\\*
+ A mighty woman with a torch, whose flame\\*
+ Is the imprisoned lightning, and her name\\*
+ Mother of Exiles. From her beacon-hand\\*
+ Glows world-wide welcome; her mild eyes command\\*
+ The air-bridged harbor that twin cities frame.\\*
+ ``Keep, ancient lands, your storied pomp!'' cries she\\*
+ With silent lips. ``Give me your tired, your poor,\\*
+ Your huddled masses yearning to breathe free,\\*
+ The wretched refuse of your teeming shore.\\*
+ Send these, the homeless, tempest-tossed to me:\\*
+ I lift my lamp beside the golden door.''
+ \end{verse}
+ \end{ShowOutput}
+ \fi
+ However, if you have very long lines of verse where a line
+ break occurs within a line of verse:
\begin{lstcode}
\begin{verse}
Both the philosopher and the house-owner
- have always something to repair.\\
+ always have something to repair.\\*
\bigskip
Don't trust a man, my son, who tells you
that he has never lied.
\end{verse}
\end{lstcode}
- where a line break occurs within a line of verse:
\begin{ShowOutput}
\begin{verse}
- Both the philosopher and the house-owner
- have always something to repair.\\
- \bigskip
- Don't trust a man, my son, who tells you
- that he has never lied.
+ Both the philosopher and the house-owner always have something to
+ repair.\\
+ \bigskip Don't trust a man, my son, who tells you that he has never
+ lied.
\end{verse}
\end{ShowOutput}
- there \verb|\\*| can not prevent a page break occurring within a verse
- at such a line break. To prevent such a page break, a
+ in this case \verb|\\*| can not prevent a page break occurring within a
+ verse at such a line break. To prevent such a page break, a
\Macro{nopagebreak}\IndexCmd{nopagebreak} would have to be inserted
somewhere in the first line:
\begin{lstcode}
\begin{verse}
- Both the philosopher and the house-owner\nopagebreak
- have always something to repair.\\
+ Both the philosopher and the house-owner\nopagebreak{}
+ always have something to repair.\\
\bigskip
- Don't trust a man, my son, who tells you\nopagebreak
+ Don't trust a man, my son, who tells you\nopagebreak{}
that he has never lied.
\end{verse}
\end{lstcode}
-
- In the above example, \Macro{bigskip} was used to separate the lines of
- verse.
+ \iftrue% Umbruchkorrekturtext
+ Here are two sayings that should always be considered when confronted
+ with seemingly strange questions about {\LaTeX} or its accompanying
+ explanations:
+\begin{lstcode}
+ \begin{verse}
+ A little learning is a dangerous thing.\\*
+ Drink deep, or taste not the Pierian Spring;\\
+ \bigskip
+ Our judgments, like our watches, none\\*
+ go just alike, yet each believes his own.
+ \end{verse}
+\end{lstcode}
+ \begin{ShowOutput}
+ \iffree{}{\vskip-.8\baselineskip}% Umbruchkorrektur
+ \begin{verse}
+ A little learning is a dangerous thing.\\*
+ Drink deep, or taste not the Pierian Spring;\\
+ \bigskip
+ Our judgments, like our watches, none\\*
+ go just alike, yet each believes his own.
+ \end{verse}
+ \end{ShowOutput}
+ \fi
+ Incidentally, \Macro{bigskip} was used in these examples to separate two
+ sayings.
\end{Example}
- \fi % \ifCommonmaincls
+ \fi
%
\EndIndexGroup
- \begin{Declaration}
- \begin{Environment}{quote}\end{Environment}
- \begin{Environment}{quotation}\end{Environment}
- \end{Declaration}%
- These two environments are also list environments and can be found both in
- the standard and the {\KOMAScript} classes. Both environments use justified
- text which is indented both on the left and right side. Usually they are
- used to separate long citations\Index{citations} from the main text. The
- difference between these two lies in the manner in which paragraphs are
- typeset. While \Environment{quote} paragraphs are highlighted by vertical
- space, in \Environment{quotation} paragraphs the first line is
- indented. This is also true for the first line of a \Environment{quotation}
- environment. To prevent indentation you have to insert a \Macro{noindent}
- command\IndexCmd{noindent} before the text.
+ \iftrue% Umbruchkorrekturvarianten
+ \begin{Declaration}
+ \begin{Environment}{quote}\end{Environment}
+ \end{Declaration}%
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}This is
+ internally also a list environment\textnote{block quote with paragraph
+ spacing} and can be found both in the standard classes and in
+ {\KOMAScript}. The content of the environment is set fully justified.
+ The environment is often used to format longer quotes\Index{quotes}.
+ Paragraphs within the environment are distinguished with vertical space.%
+ \EndIndexGroup
+
+ \begin{Declaration}
+ \begin{Environment}{quotation}\end{Environment}
+ \end{Declaration}%
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}This
+ environment\textnote{block quote with paragraph indent} is comparable to
+ \DescRef{\ThisCommonLabelBase.env.quote}. While
+ \DescRef{\ThisCommonLabelBase.env.quote} paragraphs are indicated by
+ vertical spacing, \Environment{quotation} indents the first line of each
+ paragraph horizontally. This also applies to the first paragraph of a
+ \Environment{quotation} environment. If you want to prevent the
+ indentation there, you must precede it with the
+ \Macro{noindent}\IndexCmd{noindent} command.%
+ \else
+ \begin{Declaration}
+ \begin{Environment}{quote}\end{Environment}
+ \begin{Environment}{quotation}\end{Environment}
+ \end{Declaration}%
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{} These two
+ environments\textnote{block quotes} are also set internally as list
+ environments and can be found in both the standard and the {\KOMAScript}
+ classes. Both environments use justified text which is indented on both
+ the left and the right side. Often they are used to separate longer
+ quotations\Index{quotations} from the main text. The difference between
+ the two lies in in the manner in which paragraphs are typeset. While
+ \Environment{quote} paragraphs are distinguished by vertical space, in
+ \Environment{quotation} paragraphs, the first line is indented. This also
+ applies to the first line of a \Environment{quotation}
+ environment% Umbruchkorrektur
+ \IfThisCommonLabelBase{maincls}{%
+ , unless it is preceded by \Macro{noindent}\IndexCmd{noindent}.%
+ }{%
+ \IfThisCommonLabelBase{scrlttr2}{%
+ . If you want to prevent the indentation there, you must precede it
+ with the \Macro{noindent} command\IndexCmd{noindent}.%
+ }{\InternalCommonFileUsageError}%
+ }%
+ \fi % Umbruchkorrekturvarianten
\IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}
\begin{Example}
\phantomsection\xmpllabel{env.quote}%
@@ -596,13 +674,13 @@ defined with the \Environment{labeling} environment.%
\begin{quotation}
The old year was turning brown; the West Wind was
calling;
-
+
Tom caught the beechen leaf in the forest falling.
``I've caught the happy day blown me by the breezes!
Why wait till morrow-year? I'll take it when me pleases.
This I'll mend my boat and journey as it chances
west down the withy-stream, following my fancies!''
-
+
Little Bird sat on twig. ``Whillo, Tom! I heed you.
I've a guess, I've a guess where your fancies lead you.
Shall I go, shall I go, bring him word to meet you?''
@@ -622,7 +700,7 @@ defined with the \Environment{labeling} environment.%
Why wait till morrow-year? I'll take it when me pleases.
This I'll mend my boat and journey as it chances
west down the withy-stream, following my fancies!''
-
+
Little Bird sat on twig. ``Whillo, Tom! I heed you.
I've a guess, I've a guess where your fancies lead you.
Shall I go, shall I go, bring him word to meet you?''
@@ -643,38 +721,38 @@ defined with the \Environment{labeling} environment.%
\OParameter{inner indentation}\Parameter{indentation}
\end{Environment}
\end{Declaration}
-Similar to %
-\IfThisCommonLabelBase{scrextend}{%
+Like \IfThisCommonLabelBase{scrextend}{%
\DescRef{\ThisCommonFirstLabelBase.env.quote} and
- \DescRef{\ThisCommonFirstLabelBase.env.quotation} which are available at the
- standard classes and also the \KOMAScript{} classes%
-}{%
+ \DescRef{\ThisCommonFirstLabelBase.env.quotation}, which are available in
+ the standard and the \KOMAScript{} classes}{%
\DescRef{\ThisCommonLabelBase.env.quote} and
\DescRef{\ThisCommonLabelBase.env.quotation}%
-} %
-the \Environment{addmargin} environment changes the margin\Index{margin}. In
-contrast to the first two environments, with \Environment{addmargin} the user
-can set the width of the indentation. Besides this, this environment does not
-change the indentation of the first line nor the vertical spacing between
-paragraphs.
+}, the \Environment{addmargin} environment changes the margin\Index{margin}.
+However, unlike the first two environments, \Environment{addmargin} lets the
+user change the width of the indentation. Apart from this change, this
+environment does not change the indentation of the first line nor the vertical
+spacing between paragraphs.
-If only the obligatory argument \PName{indentation} is given, both the
-left and right margin are expanded by this value. If the optional
-argument \PName{left indentation} is given as well, then at the left
-margin the value \PName{left indentation} is used instead of
-\PName{indentation}.
+If only the obligatory argument \PName{indentation} is given, both the left
+and right margin are expanded by this value. If the optional argument
+\PName{left indentation} is given as well, then the value \PName{left
+ indentation} is used for the left margin instead of \PName{indentation}.
-The starred \Environment{addmargin*} only differs from the normal
-version in a two-sided layout. Furthermore, the difference only occurs
-if the optional argument \PName{inner indentation} is used. In this
-case this value \PName{inner indentation} is added to the normal inner
-indentation. For right-hand pages this is the left margin, for
-left-hand pages the right margin. Then the value of
-\PName{indentation} determines the width of the opposite margin.
+The starred variant \Environment{addmargin*}%
+\important{\Environment{addmargin*}} differs from the normal version only in
+the two-sided mode. Furthermore, the difference only occurs if the optional
+argument \PName{inner indentation} is used. In this case, the value of
+\PName{inner indentation} is added to the normal inner indentation. For
+right-hand pages this is the left margin; for left-hand pages, the right
+margin. Then the value of \PName{indentation} determines the width of the
+opposite margin.
-Both versions of this environment take also negative values for all
-parameters. This has the effect of expanding the environment into the
-margin.
+Both versions of this environment allow negative values for all parameters.
+\IfThisCommonLabelBase{scrextend}{%
+ The environment then protrudes into the margin accordingly.%
+}{%
+ This can be done so that the environment protrudes into the margin.%
+}%
\IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}
\begin{Example}
\phantomsection\xmpllabel{env.addmargin}%
@@ -689,7 +767,7 @@ margin.
\end{addmargin*}%
}
\end{lstcode}
- If you now put your source code in such an environment it will show
+ If you now put your source code in such an environment, it will show
up as:
\begin{ShowOutput}
\newenvironment{SourceCodeFrame}{%
@@ -701,7 +779,7 @@ margin.
\end{minipage}%
\end{addmargin*}%
}
- You define yourself the following environment:
+ You define the following environment:
\begin{SourceCodeFrame}
\begin{lstcode}
\newenvironment{\SourceCodeFrame}{%
@@ -715,38 +793,38 @@ margin.
}
\end{lstcode}
\end{SourceCodeFrame}
- This may be feasible or not. In any case it shows the usage of this
+ This may be feasible or not. In any case, it shows the usage of this
environment.
\end{ShowOutput}
The optional argument of the \Environment{addmargin*} environment
makes sure that the inner margin is extended by 1\Unit{em}. In turn
the outer margin is decreased by 1\Unit{em}. The result is a shift
- by 1\Unit{em} to the outside. Instead of \PValue{1em} you can of
+ by 1\Unit{em} to the outside. Instead of \PValue{1em}, you can of
course use a length, for example, \PValue{2\Macro{parindent}}.
\end{Example}
\fi%
-Whether a page is going to be on the left or right side of the book can not be
-determined for certain in the first {\LaTeX} run. For details please refer to
+Whether a page is going to be on the left or right side of the book cannot be
+determined reliably on the first {\LaTeX} run. For details please refer to
the explanation of the commands
\DescRef{\ThisCommonLabelBase.cmd.ifthispageodd}
(\autoref{sec:\ThisCommonLabelBase.oddOrEven},
\DescPageRef{\ThisCommonLabelBase.cmd.ifthispageodd}) and
\iffree{\Macro{ifthispagewasodd}}{%
- \DescRef{\ThisCommonLabelBase.cmd.ifthispagewasodd}}
-(\autoref{sec:maincls-experts.addInfos},
-\DescPageRef{maincls-experts.cmd.ifthispageodd}).
-
+ \DescRef{maincls-experts.cmd.ifthispagewasodd}}
+(\autoref{sec:maincls-experts.addInfos}\iffree{}{,
+\DescPageRef{maincls-experts.cmd.ifthispageodd}}).
+\IfThisCommonLabelBase{scrlttr2}{}{%
\begin{Explain}
- There may be several questions about coexistence of lists and
- paragraphs. Because of this additional information may be found at the
- description of option \Option{parskip} in
+ The interplay of environments such as lists and paragraphs gives rise to
+ frequent questions. Therefore, you can find further explanation in the
+ description of the \Option{parskip} option in
+ \autoref{sec:maincls-experts.addInfos}\iffree{}{,
+ \DescPageRef{maincls-experts.option.parskip}. Also in the expert section, in
\autoref{sec:maincls-experts.addInfos},
- \DescPageRef{maincls-experts.option.parskip}. Also at the expert part,
- in \autoref{sec:maincls-experts.addInfos},
- \DescPageRef{maincls-experts.env.addmargin*}, you may find additional
- information about page breaks inside of \Environment{addmargin*}.%
-\end{Explain}%
+ \DescPageRef{maincls-experts.env.addmargin*}, you can find additional
+ information about page breaks inside \Environment{addmargin*}}.%
+\end{Explain}}%
%
\EndIndexGroup
%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-marginpar.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-marginpar.tex
index ff57abce762..4ef54b7e68e 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-marginpar.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-marginpar.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-marginpar.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-marginpar.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,33 +46,33 @@
% ======================================================================
\KOMAProvidesFile{common-marginpar.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (common paragraphs)]
-\translator{Gernot Hassenpflug\and Markus Kohm}
+\translator{Gernot Hassenpflug\and Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-01-29
-\section{Margin Notes}
+\section{Marginal Notes}
\seclabel{marginNotes}%
\BeginIndexGroup
-\BeginIndex{}{margin>notes}%
+\BeginIndex{}{marginal notes}%
\IfThisCommonFirstRun{}{%
- All of what is described in
- \autoref{sec:\ThisCommonFirstLabelBase.marginNotes} is generally
- applicable. So if you have alread read and understood
- \autoref{sec:\ThisCommonFirstLabelBase.marginNotes} you can switch to
+ The information in \autoref{sec:\ThisCommonFirstLabelBase.marginNotes}
+ applies equally to this chapter. So if you have already read and understood
+ \autoref{sec:\ThisCommonFirstLabelBase.marginNotes}, you can skip ahead to
\autoref{sec:\ThisCommonLabelBase.marginNotes.next},
\autopageref{sec:\ThisCommonLabelBase.marginNotes.next}.%
}
-Aside from the text area, that normally fills the typing area, usually a
-marginalia column may be found. Margin notes will be printed at this area.
+In addition to the text area, which normally fills the type area, documents
+often contain a column for marginalia. You can set marginal notes in this
+area.
\IfThisCommonLabelBase{scrlttr2}{%
- Nevertheless, margin notes are unusual at letters and should be used
- seldomly.%
+ In letters, however, marginal notes are unusual and should be used
+ sparingly.%
}{%
- At lot of them may be found in this \iffree{manual}{book}.%
+ This \iffree{guide}{book} makes frequent use of them.%
}%
@@ -80,31 +80,30 @@ marginalia column may be found. Margin notes will be printed at this area.
\Macro{marginpar}\OParameter{margin note left}\Parameter{margin note}%
\Macro{marginline}\Parameter{margin note}
\end{Declaration}%
-Usually margin notes\Index[indexmain]{margin>notes} in {\LaTeX} are
-inserted with the command \Macro{marginpar}. They are placed in the
-outer margin. In documents with one-sided layout the right border is
-used. Though \Macro{marginpar} can take an optional different margin
-note argument in case the output is in the left margin, margin notes
-are always set in justified layout. However, experience has shown
-that many users prefer left- or right-aligned margin notes instead.
-To facilitate this, {\KOMAScript} offers the command
-\Macro{marginline}.
+Marginal notes\Index[indexmain]{marginal notes} in {\LaTeX} are usually
+inserted with the \Macro{marginpar} command. They are placed in the outer
+margin. One-sided documents use the right border. Although you can specify a
+different marginal note for \Macro{marginpar} in case it winds up in the left
+margin, marginal notes are always fully justified. However, experience has
+shown that many users prefer left- or right-justified marginal notes
+instead. For this purpose, {\KOMAScript} offers the \Macro{marginline}
+command.
\IfThisCommonFirstRun{%
\iftrue%
}{%
- An example for this may be found in
+ For a detailed example, see
\autoref{sec:\ThisCommonFirstLabelBase.marginNotes} at
\PageRefxmpl{\ThisCommonFirstLabelBase.cmd.marginline}.%
\csname iffalse\endcsname%
}%
\begin{Example}
\phantomsection\xmpllabel{cmd.marginline}%
- In this \iffree{document}{book}, sometimes, the class name
- \Class{scrartcl} can be found in the margin. This can be produced with:%
- \iffalse% Umbruchkorrekturtext
- \footnote{In fact, instead of \Macro{texttt}, a semantic highlighting
- was used. To avoid confusion this was replaced in the example.}%
+ In some parts of this \iffree{guide}{book}, the class name
+ \Class{scrartcl} can be found in the margin. You can produced this with:%
+ \iftrue% Umbruchkorrekturtext
+ \footnote{Actually, instead of \Macro{texttt}, a semantic markup
+ was used. To avoid confusion, this has been replaced in the example.}%
\fi
\begin{lstcode}
\marginline{\texttt{scrartcl}}
@@ -116,15 +115,23 @@ To facilitate this, {\KOMAScript} offers the command
\marginpar[\raggedleft\texttt{scrartcl}]
{\raggedright\texttt{scrartcl}}
\end{lstcode}
- Thus \Macro{marginline} is really only an abbreviated writing of the
+ Thus \Macro{marginline} is really just a shorthand notation for the
code above.%
\end{Example}%
\fi
-Experts\textnote{Attention!} and advanced users may find information about
-problems using \Macro{marginpar} at \autoref{sec:maincls-experts.addInfos},
-\DescPageRef{maincls-experts.cmd.marginpar}. These are valid for
-\Macro{marginline} also.%
+Advanced users\textnote{Attention!} will find notes about difficulties that
+can arise using \Macro{marginpar} in \autoref{sec:maincls-experts.addInfos}%
+\iffree{}{, on \DescPageRef{maincls-experts.cmd.marginpar}}. These remarks
+also apply to \Macro{marginline}. In addition,
+\autoref{cha:scrlayer-notecolumn} introduces a package that you can use to
+create note columns with their own page breaks.%
+\iftrue% Umbruchkorrektur
+ \ However, the
+ \hyperref[cha:scrlayer-notecolumn]{\Package{scrlayer-notecolumn}}%
+ \IndexPackage{scrlayer-notecolumn} package is more a proof of concept than a
+ finished package.%
+\fi%
%
\EndIndexGroup
%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-oddorevenpage.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-oddorevenpage.tex
index 1ec1edd6b97..04ff2b91ac0 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-oddorevenpage.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-oddorevenpage.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-oddorevenpage.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-oddorevenpage.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,51 +46,46 @@
% ======================================================================
\KOMAProvidesFile{common-oddorevenpage.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (common paragraph: Detection of Odd and
Even Pages)]
-\translator{Markus Kohm\and Krickette Murabayashi}
+\translator{Markus Kohm\and Krickette Murabayashi\and Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-01-30
-\section{Detection of Odd and Even Pages}
+\section{Detecting Odd and Even Pages}
\seclabel{oddOrEven}%
\BeginIndexGroup%
\BeginIndex{}{page>odd}%
\BeginIndex{}{page>even}%
\IfThisCommonFirstRun{}{%
- What is described in
- \autoref{sec:maincls.oddOrEven} applies, mutatis mutandis.
- So if you have alread read and understood
- \autoref{sec:\ThisCommonFirstLabelBase.oddOrEven} you can
- switch to \autopageref{sec:\ThisCommonLabelBase.oddOrEven.next},
+ The information in \autoref{sec:maincls.oddOrEven} applies equally to this
+ chapter. So if you have already read and understood
+ \autoref{sec:\ThisCommonFirstLabelBase.oddOrEven}, you can skip ahead to
+ \autopageref{sec:\ThisCommonLabelBase.oddOrEven.next},
\autopageref{sec:\ThisCommonLabelBase.oddOrEven.next}.%
}
-In double-sided documents we distinguish left and right pages. Left pages
-always have an even page number, right pages always have an odd page
-number. % For this they are mostly called even and odd pages so they
- % are
-Thus, they are most often referred to as even and odd pages
-in this
-\iffree{guide}{book}. %
+In two-sided documents we distinguish left and right pages. Left pages always
+have an even page number, and right pages always have an odd page number. %
\IfThisCommonLabelBase{maincls}{%
- This also means that the detection
- of a left or right page is same as detection of even and odd page
- numbers.
+ Identifying right and left pages is equivalent to identifying even- or
+ odd-numbered pages, and so we normally refer to them as even and odd pages
+ in this \iffree{guide}{book}.
-% Umbruchkorrekturtext
+ % Umbruchkorrekturtext
\iftrue%
- There's no distinction in left and right pages in single-sided
- documents. Nevertheless there are pages with even or odd page numbers.%
+ In one-sided documents, the distinction between left and right pages does
+ not exist. Nevertheless, there are still pages with even and odd page
+ numbers.%
\fi%
}{%
\IfThisCommonLabelBase{scrlttr2}{%
- Letters will be set single-side mostly. Nevertheless, printing letters
- with single-side layout using both paper sides or exceptionally generating
- real double-side letters it may be useful to know whether producing
- currently an even or odd page.%
+ As a rule, letters will be set one-sided. However, if you need to print
+ letters using both sides of the paper or, in exceptional cases, are
+ generating real two-sided letters, it may be useful to know whether you
+ are currently on an even or odd page.%
}{}%
}
@@ -98,34 +93,33 @@ in this
\begin{Declaration}
\Macro{ifthispageodd}\Parameter{true part}\Parameter{false part}
\end{Declaration}%
-If one wants to find out with {\KOMAScript} whether a text falls on an
-even or odd page, one can use the \Macro {ifthispageodd} command. The
-\PName{true part} argument is executed only if the command falls on an odd
-page. Otherwise the \PName{false part} argument is executed.
+If you want to determine whether text appears on an even or odd page,
+\KOMAScript{} provides the \Macro {ifthispageodd} command. The \PName{true
+ part} argument is executed only if you are currently on an odd page.
+Otherwise the \PName{false part} argument is executed.
\begin{Example}
- Assume that you simply want to show whether a text will be placed onto an
+ Suppose you simply want to show whether a text will be placed onto an
even or odd page. You may achieve that using
\begin{lstcode}
This page has an \ifthispageodd{odd}{even}
page number.
\end{lstcode}
- which will result in the output
+ This results in the output
\begin{quote}
This page has an \ifthispageodd{odd}{even} page number.
\end{quote}
\end{Example}
-Because the \Macro{ifthispageodd} command uses a mechanism that is
-very similar to a label and a reference to it, at least two {\LaTeX}
-runs are required after every text modification. Only then the
-decision is correct. In the first run a heuristic is used to make the
-first choice.
+Because the \Macro{ifthispageodd} command uses a mechanism that is very
+similar to a label and a reference to it, at least two {\LaTeX} runs are
+required after each change to the text. Only then will the decision be
+correct. In the first run, a heuristic is used to make the initial choice.
-At \autoref{sec:maincls-experts.addInfos},
-\DescPageRef{maincls-experts.cmd.ifthispageodd} experts may find more
-information about the problems detecting left and right pages or even and odd
-page number.%
+\iffree{}{In \autoref{sec:maincls-experts.addInfos},
+\DescPageRef{maincls-experts.cmd.ifthispageodd}, advanced users can find more
+information about the problems of detecting left and right pages, or even and
+odd page numbers.}%
%
\EndIndexGroup
%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-options.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-options.tex
index 5d97ff8d26a..241a6f2200f 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-options.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-options.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-options.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-options.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,57 +46,55 @@
% ======================================================================
\KOMAProvidesFile{common-options.tex}
- [$Date: 2016-11-14 21:06:12 +0100 (Mo, 14. Nov 2016) $
+ [$Date: 2017-12-07 23:10:55 -0800 (Thu, 07 Dec 2017) $
KOMA-Script guide (common paragraphs)]
-\translator{Gernot Hassenpflug\and Krickette Murabayashi}
+\translator{Gernot Hassenpflug\and Krickette Murabayashi\and Karl Hagen}
-% Date of the translated German file: 2017-06-23
+% Date of the translated German file: 2017-12-07
-\section{Early or late Selection of Options}
+\section{Early or Late Selection of Options}
\seclabel{options}
\BeginIndexGroup
\BeginIndex{}{options}%
-\IfThisCommonFirstRun{}{%
- All of what is described in
- \autoref{sec:\ThisCommonFirstLabelBase.options} is generally
- applicable. So if you have alread read and understood
- \autoref{sec:\ThisCommonFirstLabelBase.options} you can switch to
+\IfThisCommonFirstRun{%
+ This section introduces a special feature of \KOMAScript{} which, in
+ addition to \IfThisCommonLabelBase{typearea}{\Package{typearea}}{%
+ \IfThisCommonLabelBase{maincls}{\Class{scrbook}, \Class{scrreprt}, and
+ \Class{scrartcl}}{%
+ \IfThisCommonLabelBase{scrlttr2}{the \Class{scrlttr2} class}{%
+ \IfThisCommonLabelBase{scrextend}{the classes and
+ \Package{scrextend}}{%
+ \IfThisCommonLabelBase{scrhack}{\Package{scrhack}}{%
+ \IfThisCommonLabelBase{scrjura}{\Package{scrjura}}{%
+ \IfThisCommonLabelBase{scrlayer}{\Package{scrlayer}}{%
+ \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \Package{scrlayer-scrpage}}{%
+ \IfThisCommonLabelBase{scrlayer-notecolumn}{%
+ \Package{scrlayer-notecolumn}}{%
+ \InternalCommonFileUsageError}}}}}}}}}%
+ , is also relevant to other \KOMAScript{} packages and classes. %
+ \IfThisCommonLabelBase{scrlttr2}{So that each chapter may stand on its own,
+ this section appears in nearly identical form in several chapters, but if
+ you are studying all of \KOMAScript{}, you of course only need to read it
+ one time.%
+ }{This section appears in nearly identical form in several chapters, so you
+ can find all the information about a single package or class in the
+ relevant chapter. Users who are interested not just in a particular
+ package or class but in getting an overview of \KOMAScript{} as a whole
+ only need to read this section in one of the chapters and can
+ \IfThisCommonLabelBase{maincls}{skip the rest of the chapter.}{%
+ then skip it as they study the guide.}%
+ }%
+}{%
+ The information in \autoref{sec:\ThisCommonFirstLabelBase.options} applies
+ equally to this chapter. So if you have already read and understood
+ \autoref{sec:\ThisCommonFirstLabelBase.options}, you can skip ahead to
\autoref{sec:\ThisCommonLabelBase.options.next},
\autopageref{sec:\ThisCommonLabelBase.options.next}.%
}
-In this section a peculiarity of {\KOMAScript} is presented, which, apart
-from %
-\IfThisCommonLabelBase{typearea}{the \Package{typearea} package, is also
- relevant to other {\KOMAScript} packages and classes}{%
- \IfThisCommonLabelBase{maincls}{the classes \Class{scrbook},
- \Class{scrreprt}, and \Class{scrartcl} is also relevant to other
- {\KOMAScript} classes and packages}{%
- \IfThisCommonLabelBase{scrlttr2}{the class \Class{scrlttr2} is also
- relevant to other {\KOMAScript} classes and packages}{%
- \IfThisCommonLabelBase{scrextend}{the classes and the
- \Package{scrextend} package is also relevant to several other
- {\KOMAScript} packages}{%
- \IfThisCommonLabelBase{scrhack}{the \Package{scrhack} package, is also
- relevant to other \KOMAScript{} packages and classes}{%
- \IfThisCommonLabelBase{scrjura}{the \Package{scrjura} package, is
- also relevant to other \KOMAScript{} packages and classes}{%
- \IfThisCommonLabelBase{scrlayer}{the \Package{scrlayer} package,
- is also relevant to other \KOMAScript{} packages and classes}{%
- \IfThisCommonLabelBase{scrlayer-scrpage}{the
- \Package{scrlayer-scrpage} package, is also relevant to other
- \KOMAScript{} packages and classes}{%
- \IfThisCommonLabelBase{scrlayer-notecolumn}{the
- \Package{scrlayer-notecolumn} package, is also relevant to
- other \KOMAScript{} packages and classes}{%
- \InternalCommonFileUsageError}}}}}}}}}%
-. Such that the user can find all information corresponding to a single
-package or a single class in the relevant chapter, this section is found
-almost identically in several chapters. Users who are not only interested in a
-particular package or class, but wish to gain an overview of {\KOMAScript} as
-a whole, may read the section in one chapter and may thereafter skip it
-wherever coming across it in the document.
+
\begin{Declaration}
\Macro{documentclass}\OParameter{option list}%
@@ -104,49 +102,59 @@ wherever coming across it in the document.
\Macro{usepackage}\OParameter{option list}%
\Parameter{package list}
\end{Declaration}
-In \LaTeX{}, provision is made for the user to pass class options as a
-comma-separated list of keywords as optional arguments to
-\Macro{documentclass}.
-Apart from being passed to the class,
-these options are also passed on to all packages which can understand
-the options. Provision is also made for the user to pass optional
-arguments as a comma-separated list of keywords as optional arguments
-to \Macro{usepackage}. {\KOMAScript}
-expands\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}\and \Package{scrextend}\and \Package{typearea}} the
-option mechanism for the {\KOMAScript} classes and various packages to
-use further possibilities. Thus, most {\KOMAScript} options can also
-take a value. An option may have not only the form \PName{Option}, but
-may also have the form \PName{option}\texttt{=}\PName{value}. Apart
-from this difference \Macro{documentclass} and \Macro{usepackage}
-function the same in {\KOMAScript} as described in
-\cite{latex:usrguide} or any introduction to \LaTeX, for example
+\LaTeX{} allows users to pass class options\textnote{class options} as a
+comma-separated list of keywords in the optional argument to
+\Macro{documentclass}. In addition to being passed to the class, these options
+are also passed on to all packages\textnote{global options} that can
+understand them. Users can also pass a similar comma-separated list of
+keywords in the optional argument of \Macro{usepackage}\textnote{packet
+ options}. \KOMAScript{} extends\ChangedAt{v3.00}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}\and \Package{scrextend}\and
+ \Package{typearea}} the option mechanism for
+\IfThisCommonLabelBaseOneOf{scrextend,scrjura}{}{the \KOMAScript{} classes and
+} some packages with further options. Thus most \KOMAScript{} options can also
+take a value, so an option does not necessarily take the form \PName{option},
+but can also take the form \PName{option}\texttt{=}\PName{value}%
+\important{\PName{option}\texttt{=}\PName{value}}. Except for this difference,
+\Macro{documentclass} and \Macro{usepackage} in \KOMAScript{} function as
+described in \cite{latex:usrguide} or any introduction to \LaTeX, for example
\cite{lshort}.%
+%
+\iffree{}{\IfThisCommonLabelBase{scrlayer-scrpage}{\par
+ Incidentally, the \Package{scrpage2}\IndexPackage{scrpage2}%
+ \important{\Package{scrpage2}} package, which is considered obsolete, does
+ not have this extension. It therefore understands only simple options without
+ an assigned value.\par}{}}%
\IfThisCommonLabelBaseNotOneOf{%
scrjura,scrhack,scrlayer,scrlayer-scrpage,scrlayer-notecolumn,scrextend%
}{%
+ When using a \KOMAScript{} class\textnote{Attention!}, you should not
+ specify options when loading the \Package{typearea} or \Package{scrbase}
+ packages. The reason for this restriction is that the class already loads
+ these packages without options, and \LaTeX{} refuses to load a package
+ multiple times with different option settings.%
+ \IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{ In general, it is not
+ necessary to load either one of these packages explicitly when using any
+ \KOMAScript{} class.}{}%
+ \par
+}
- When using a {\KOMAScript} class, no options should be passed on
-% Die Alternativen an dieser Stelle dienen der Verbesserung des Umbruchs
- \IfThisCommonLabelBase{typearea}{unnecessary, explicit }{}%
- loading of the \Package{typearea} or \Package{scrbase} packages. The reason
- for this is that the class already loads these packages without options and
- \LaTeX{} refuses multiple loadings of a package with different option
- settings.%
- \IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{\ Actually, it is no longer
- necessary when using any {\KOMAScript} class to explicity load either one
- of these packages.}{}%
-}{}
-
-You should note\textnote{Attention!}, that in opposite to the interface
-described below the options interface of \Macro{documentclass} and
-\Macro{usepackage} is not robust. So commands, lengths, counters and such
-constructs may break inside the optional argument of these commands. Because
-of this, the usage of a \LaTeX{} length inside the value of an option would
-cause an error before \KOMAScript{} can get the control over the option
-execution. So, if you want to use a \LaTeX{} length, counter or command as part
-of the value of an option, you have to use
+% Umbruchoptimierung!!!
+\IfThisCommonLabelBase{typearea}{Setting the options with
+ \Macro{documentclass} or \Macro{usepackage} has one\textnote{Attention!}
+ major disadvantage:
+}{%
+ Note that the \Macro{documentclass} and \Macro{usepackage} have one drawback
+ when using the option interface described bellow\textnote{Attention!}:
+}%
+unlike the interface described below, the options in \Macro{documentclass} and
+\Macro{usepackage} are not robust. So commands, lengths, counters, and such
+constructs may break inside the optional argument of these commands. For
+example, using a \LaTeX{} length in the value of an option results in an error
+before the value is passed to \KOMAScript{} and it can take control of the
+option execution. So if you want to use a \LaTeX{} length, counter, or command
+as part of the value of an option, you have to use
\DescRef{\LabelBase.cmd.KOMAoptions} or
\DescRef{\LabelBase.cmd.KOMAoption}. These commands will be described next.%
%
@@ -157,58 +165,66 @@ of the value of an option, you have to use
\Macro{KOMAoptions}\Parameter{option list}
\Macro{KOMAoption}\Parameter{option}\Parameter{value list}
\end{Declaration}
-\KOMAScript{}\ChangedAt{v3.00}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}\and \Package{scrextend}\and
- \Package{typearea}} offers most class and package options the
-opportunity to change the value of options even after loading of the
-class or package. One may then change the values of a list of options
-at will with the \Macro{KOMAoptions} command. Each option in the
-\PName{option list} has the form
-\PName{option}\texttt{=}\PName{value}.
-
-Some options also have a default value. If one does not give a value,
-i.\,e., gives the option simply in the form \PName{option}, then the
-default value will be used.
-
-Some options can assume several values simultaneously. For such options there
-exists the possibility, with the help of \Macro{KOMAoption}, to pass a single
-\PName{option} a list of values. The individual values are given as a
-comma-separated \PName{value list}.
+\KOMAScript{}\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}\and \Package{typearea}} also
+provides the ability to change the values of most
+\IfThisCommonLabelBaseOneOf{scrextend,scrjura}{}{class and }package options
+even after loading the \IfThisCommonLabelBaseOneOf{scrextend,scrjura}{}{%
+ class or} package. You can use the \Macro{KOMAoptions} command to change the
+values of a list of options, as in
+\DescRef{\ThisCommonLabelBase.cmd.documentclass} or
+\DescRef{\ThisCommonLabelBase.cmd.usepackage}. Each option in the
+\PName{option list} has the form \PName{option}\texttt{=}\PName{value}%
+\important{\PName{option}\texttt{=}\PName{value},\dots}.
+
+Some options also have a default value. If you do not specify a value, that is
+if you give the option simply as \PName{option}, then this default value will
+be used.
+
+Some options can have several values simultaneously. For such options, it is
+possible, with the help of \Macro{KOMAoption}, to pass a list of values to a
+single \PName{option}. The individual values are given as a comma-separated
+\PName{value list}\important{\PName{value},\dots}.
\begin{Explain}
- % If in the \PName{option list} one sets an option to a disallowed
- % value, or the \PName{value list} contains an invalid value, then an
- % error is produced. If \LaTeX{} is run in an interactive mode, then
- % it stops at this point. Entering ``\texttt{h}'' displays a help
- % screen, in which also the valid values for the corresponding option
- % are given.
-
- % If a \PName{value} includes an equal sign or a comma, then the
- % \PName{value} must be enclosed in curly brackets.
-
- To implement this possibility {\KOMAScript} uses the commands
- \DescRef{scrbase.cmd.FamilyOptions} and \DescRef{scrbase.cmd.FamilyOption}
- with the family ``\PValue{KOMA}''.
-\iffalse % Umbruchkorrektur
- More information on these commands %
- \IfThisCommonLabelBase{maincls}{for experts }{%
- \IfThisCommonLabelBase{scrlttr2}{for experts }{}}%
- is found in \autoref{sec:scrbase.keyvalue},
- \DescPageRef{scrbase.cmd.FamilyOptions}.
-\else
- For more information in these commands see \autoref{part:forExperts},
- \autoref{sec:scrbase.keyvalue},
- \DescPageRef{scrbase.cmd.FamilyOptions}.
-\fi
+ \KOMAScript{} uses the commands \DescRef{scrbase.cmd.FamilyOptions} and
+ \DescRef{scrbase.cmd.FamilyOption} with the family ``\PValue{KOMA}'' to
+ implement this ability.
+ \IfThisCommonLabelBaseOneOf{typearea}{% Umbruchkorrektur
+ Advanced users will find more on these instructions in
+ \autoref{sec:scrbase.keyvalue}, \DescPageRef{scrbase.cmd.FamilyOptions}.
+ }{%
+ See \autoref{part:forExperts}, \autoref{sec:scrbase.keyvalue},
+ \DescPageRef{scrbase.cmd.FamilyOptions}. }%
\end{Explain}
+
+Options set with \Macro{KOMAoptions} or \Macro{KOMAoption} will reach
+\IfThisCommonLabelBase{scrextend}{}{both the \KOMAScript{} class and }any
+previously loaded \KOMAScript{} packages that recognise these options. If an
+option or a value is unknown, \hyperref[cha:scrbase]{\Package{scrbase}}%
+\IndexPackage{scrbase}\important{\hyperref[cha:scrbase]{\Package{scrbase}}}
+will report it as an error.%
+%
+\iffalse% Umbruchkorrekturtext
+\iffree{}{\IfThisCommonLabelBase{scrlayer-scrpage}{\par
+ Incidentally, the \Package{scrpage2}\IndexPackage{scrpage2}%
+ \important{\Package{scrpage2}}, which is considered obsolete, does not have
+ this extension. Options can therefore only be set when the package is loaded
+ with the option explained previously.}{}}%
+\fi%
%
\EndIndexGroup
%
\EndIndexGroup
+\phantomsection
+\label{sec:\ThisCommonLabelBase.options.end}
+\endinput
%%% Local Variables:
%%% mode: latex
-%%% coding: iso-latin-1
+%%% mode: flyspell
+%%% coding: us-ascii
+%%% ispell-local-dictionary: "en_GB"
%%% TeX-master: "../guide"
-%%% End:
+%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-pagestylemanipulation.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-pagestylemanipulation.tex
index 8c85bf399fc..422721ad15d 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-pagestylemanipulation.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-pagestylemanipulation.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-pagestylemanipulation.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-pagestylemanipulation.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,166 +46,188 @@
% ============================================================================
\KOMAProvidesFile{common-pagestylemanipulation.tex}
- [$Date: 2013-10-22 11:17:09 +0200 (Di, 22 Okt 2013) $
+ [$Date: 2018-02-05 01:50:56 -0800 (Mon, 05 Feb 2018) $
KOMA-Script guide (common paragraph:
- Manipulation of defined page styles)]
-\translator{Markus Kohm\and Jana Schubert}
+ Setting up defined page styles)]
+\translator{Markus Kohm\and Jana Schubert\and Karl Hagen}
-% Date version of the translated file: 2015-06-18
+% Date version of the translated file: 2018-02-05
-\section{Manipulation of Defined Page Styles}
+\section{Manipulating Page Styles}
\seclabel{pagestyle.content}
\BeginIndexGroup
\BeginIndex{}{page>style}
\IfThisCommonLabelBase{scrlayer}{%
- Even though \Package{scrlayer} itself does not define a concrete page style
- with content\,---\,the already mentioned page styles
- \PageStyle{@everystyle@} and \PageStyle{empty} are initially defined without
- any level and so empty and without content\,---\,, it provides some options
- and commands for the manipulation of the contents.%
+ Although \Package{scrlayer} itself does not define concrete page styles with
+ content\,---\,the previously mentioned page styles
+ \DescRef{\LabelBase.pagestyle.@everystyle@} and \PageStyle{empty} are
+ initially defined without any layers, i.\,e., without content\,---\,, the
+ package provides some options and commands to manipulate their contents.%
}{%
\IfThisCommonLabelBase{scrlayer-scrpage}{%
- \hyperref[sec:scrlayer-scrpage.predefined.pagestyles]%
- {Section~\ref*{sec:scrlayer-scrpage.predefined.pagestyles}} states the
- predefined defaults for the page style \PageStyle{scrheadings} and
- \PageStyle{plain.scrheadings} and how they can be adapted. But
- information about the generation of, i.\,e., the running heads, the
- manipulation of the widths of page head and footer, and how you can get
- horizontal lines printed above or below the page head or footer are still
- missing. Even though all these are features of package \Package{scrlayer},
- they will be described consecutively, because these basic features of
- \Package{scrlayer} are also a fundamental part of the features of
- \Package{scrlayer-scrpage}.%
+ \autoref{sec:scrlayer-scrpage.predefined.pagestyles} explains how the page
+ styles \DescRef{\LabelBase.pagestyle.scrheadings} and
+ \DescRef{\LabelBase.pagestyle.plain.scrheadings} are defined and how these
+ defaults can be changed. But topics such as creating running headers,
+ changing the widths of the header and footer, and putting horizontal lines
+ above or below the header or footer have yet to be described. Although
+ these capabilities are actually part of the
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ \important{\hyperref[cha:scrlayer]{\Package{scrlayer}}} package, they will
+ be explained below because these basic features of
+ \hyperref[cha:scrlayer]{\Package{scrlayer}} make up an important part of
+ \IfThisCommonLabelBase{scrlayer-scrpage}{\Package{scrlayer-scrpage}%
+ }{%
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ }.%
}{%
\IfThisCommonLabelBase{scrlayer-scrpage-experts}{%
- This section is an add-on to
+ This section is a supplement to
\autoref{sec:scrlayer.pagestyle.content}. It describes features that may
- be to complicated for beginners.%
+ be too complicated for beginners.%
}{\InternalCommonFileUsageError}%
}%
}
-
\IfThisCommonLabelBase{scrlayer-scrpage-experts}{\iffalse}{%
\csname iftrue\endcsname}%
\begin{Declaration}
- \Macro{automark}\OParameter{section level of the right mark}%
- \Parameter{section level of the left mark}%
- \Macro{automark*}\OParameter{section level of the right mark}%
- \Parameter{section level of the left mark}%
- \Macro{manualmark}%
- \Option{automark}%
- \OptionVName{autooneside}{simple switch}%
- \Option{manualmark}
+ \Macro{automark}\OParameter{section level of the right mark}
+ \Parameter{section level of the left mark}
+ \Macro{automark*}\OParameter{section level of the right mark}
+ \Parameter{section level of the left mark}
+ \Macro{manualmark}
\end{Declaration}
\IfThisCommonLabelBase{scrlayer-scrpage}{%
\begin{Explain}
- With the \LaTeX{} standard classes or the \KOMAScript{} classes the
- decision whether using automatic running heads\Index{running
- heads>automatic}, or static or manual running heads\Index{running
- heads>static}\Index{running heads>manual} would be done using either
- page style \PageStyle{headings} or \PageStyle{myheadings}. Automatic
- running heads are replications of a significant, characterizing text
- snippet of the page mostly inside the page head, sometimes in the page
- footer.
-
- The article classes\OnlyAt{\Class{article}\and \Class{scrartcl}}
- \Class{article} or \Class{scrartcl} with page style
- \PageStyle{headings}\IndexPagestyle{headings} use the section heading,
- which is either the mandatory or the optional argument of
- \DescRef{maincls.cmd.section}, for the automatic running head of single side
- documents. Double side documents use this section heading as the
- \emph{left mark} and at once use the subsection heading as the
- \emph{right mark}. The left mark will be printed on left pages, which
- founds the name \emph{left mark}. The right mark will be printed on
- right\,---\,in single side mode this means every\,---\,page. The classes
- by default also remove the right mark whenever they put the section
- heading into the left mark.
-
- The report and book classes \OnlyAt{\Class{report}\and
- \Class{scrreprt}\and \Class{book}\and \Class{scrbook}} start one level
- higher. So they use the chapter heading to be the right mark in single
- side layout. In double side layout they use the chapter heading to be
- the left mark and the section heading to be the right mark.
-
- If you are using \PageStyle{myheadings} instead of
- \PageStyle{headings}\IndexPagestyle{myheadings}, the marks in the page
- header still exists and would be printed same like using
- \PageStyle{headings}. But section commands will not automatically set
- the marks any longer. So\important{%
- \DescRef{\ThisCommonLabelBase.cmd.markright}\\
- \DescRef{\ThisCommonLabelBase.cmd.markboth}}%
- you can fill them only using the commands
+ In both the standard \LaTeX{} classes and the \KOMAScript{} classes, the
+ decision of whether to use automatic or static running
+ heads\Index{running heads>automatic}\Index{running heads>static} is made
+ by using the appropriate page style. Running heads repeat some
+ descriptive text, such as a title, that is appropriate to the page or
+ column, usually in the header, more rarely in the footer. As already
+ explained in
+ \autoref{sec:maincls.pagestyle}, you get automatic running heads with
+ \DescRef{maincls.pagestyle.headings}\IndexPagestyle{headings}%
+ \important{\DescRef{maincls.pagestyle.headings}}
+
+ In the article classes\OnlyAt{\Class{article}\and \Class{scrartcl}}
+ \Class{article} or \hyperref[cha:maincls]{\Class{scrartcl}}, the
+ \PageStyle{headings}\IndexPagestyle{headings} page style uses the
+ section heading, which is either the mandatory or the optional argument
+ of \DescRef{maincls.cmd.section}, for the running head%
+ \textnote{automatic running head} of one-sided documents. Two-sided
+ documents use this section heading as the \emph{left mark} and the
+ subsection heading as the \emph{right mark}. The left mark is printed,
+ as the name indicates, on left-hand (verso) pages. The right mark is
+ printed on right-hand (recto)\,---\,in one-sided printing this means on
+ all\,---\,pages. The classes by default also delete the right mark
+ whenever they put the section heading into the left mark.
+
+ The report and book classes \OnlyAt{\Class{report}\and
+ \Class{scrreprt}\and \Class{book}\and \Class{scrbook}} start one level
+ higher. Thus they use the chapter heading as the right mark in one-sided
+ printing. In two-sided printing, the chapter heading is the left mark
+ and the section heading is the right mark.
+
+ If you use \DescRef{maincls.pagestyle.myheadings}%
+ \IndexPagestyle{myheadings}%
+ \important{\DescRef{maincls.pagestyle.myheadings}}\textnote{manual
+ running head}, the marks in the page header still exist, and the page
+ numbers are placed in the same way, but section commands no longer set
+ the marks automatically. You can set them manually\important{%
+ \DescRef{\ThisCommonLabelBase.cmd.markright}\\
+ \DescRef{\ThisCommonLabelBase.cmd.markboth}} using the commands
\DescRef{\ThisCommonLabelBase.cmd.markright} and
- \DescRef{\ThisCommonLabelBase.cmd.markboth}, which will be described
- later in this section.
+ \DescRef{\ThisCommonLabelBase.cmd.markboth}, which are described later
+ in this section.
\end{Explain}\par
}{%
\IfThisCommonLabelBase{scrlayer}{%
- In common classes the decision for a page style\,---\,generally
- \PageStyle{headings} and \PageStyle{myheading}\,---\,is also a decision
- to use either automatic or manual running heads. %
+ For most classes, the choice of a page style\,---\,generally
+ \PageStyle{headings} or \PageStyle{myheading}\,---\,determines whether
+ the running heads are created automatically or manually. %
}{\InternalCommonFileUsageError}%
}%
- This difference between those two page styles has been abolished by
- \Package{scrpage2} and also by \Package{scrlayer}. Instead of distinguishing
- between automatic and manual running head by the selection of a page style,
- two new commands, \Macro{automark} and \Macro{manualmark}, are provided.
-
- The command \Macro{manualmark} switches to manual marks and deactivates the
- automatic filling of the marks. In contrast to this \Macro{automark} and
- \Macro{automark*} can be used to define, which section levels should be used
- for the automatic mark filling. The optional argument is the \PName{section
- level of the right mark}, the mandatory argument the \PName{section level
- of the left mark}. The arguments always should be the name of a section
- level like \PValue{part}, \PValue{chapter}, \PValue{section},
- \PValue{subsection}, \PValue{subsubsection}, \PValue{paragraph}, or
- \PValue{subparagraph}.
-
- Generally the higher level should be used for the left mark and the lower
- level for the right mark. This is only a convention and not a need, but it
- makes sense.
-
- Please note\textnote{Attention} that not every class provides running heads
- for every section level. For example the standard classes never setup the
- running head of \DescRef{maincls.cmd.part}. The \KOMAScript{} classes
- provide running heads for every section level.
-
- The difference in \Macro{automark} and \Macro{automark*} is, that
- \Macro{automark} deletes all prior usages of \Macro{automark} or
- \Macro{automark*}, while \Macro{automark*} changes only the behaviour of the
- section levels of its arguments. So you can even build more complex cases.
+ This distinction has been eliminated by %
+ \iffalse \Package{scrpage2} and now also by \fi%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}\IndexPackage{scrlayer}. Instead
+ of distinguishing between automatic\textnote{automatic and manual running
+ heads} and manual running heads by which page style is selected, there are
+ two new commands: \Macro{automark} and \Macro{manualmark}.
+
+ The \Macro{manualmark}\important{\Macro{manualmark}} command switches to
+ manual marks and deactivates the automatic filling of the marks. In contrast,
+ \Macro{automark}\important{\Macro{automark}} and \Macro{automark*} define
+ which section levels should be used to set the mark automatically. The
+ optional argument is the \PName{section level of the right mark}, the
+ mandatory argument the \PName{section level of the left mark}. The
+ arguments should always be the name of a section level like
+ \PValue{part}, \PValue{chapter}, \PValue{section}, \PValue{subsection},
+ \PValue{subsubsection}, \PValue{paragraph}, or \PValue{subparagraph}.
+
+ Normally, the higher level should be used for the left mark and the lower
+ level for the right mark. This is only a convention and not a requirement,
+ but it makes sense.
+
+ Please note\textnote{Attention!} that not every class provides running heads
+ for every section level. For example, the standard classes\textnote{%
+ \KOMAScript{} vs. standard classes} never use \DescRef{maincls.cmd.part}
+ in the heading. The \KOMAScript{} classes, on the other hand, support all
+ levels.
+
+ The difference between \Macro{automark} and \Macro{automark*}%
+ \important{\Macro{automark*}} is that \Macro{automark} overrides all
+ previous commands to automatically set the mark, while \Macro{automark*}
+ changes only the behaviour of the section levels specified in its
+ arguments.%
+ \IfThisCommonLabelBase{scrlayer-scrpage}{}{ With this feature you can handle
+ relatively complex cases.}% Umbruchoptimierung
\IfThisCommonLabelBase{scrlayer-scrpage}{\iftrue}{\csname
iffalse\endcsname}%
+ \iffalse% Umbruchkorrekturtext
+ \iffree{}{\par
+ The obsolete package
+ \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}
+ understands both \Macro{manualmark} and \Macro{automark}, but not
+ \Macro{automark*}. Therefore the following examples are not completely
+ transferable when using \Package{scrpage2}.%
+ }%
+ \fi
+ %
\begin{Example}
\phantomsection\xmpllabel{mark}%
- Assume you want the chapter heading to be the running head of even pages
- and the section heading to be the running head of odd pages like this is
- usual for books. But on odd pages you also want the chapter headings as
- a running head as long as the first section appears. To do so, you first
- have to load \Package{scrlayer-scrpage} and select page style
- \PageStyle{scrheadings}. So you're document starts with:
+ Suppose you want chapter headings to be used as the running head of even
+ pages and the section heading to be the running head of odd pages, as
+ usual. But on odd pages you also want the chapter headings to be used as
+ the running head until the first section appears. To do so, you first
+ have to load \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \Package{scrlayer-scrpage}%
+ }{%
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}
+ and select the \DescRef{\LabelBase.pagestyle.scrheadings} page style,
+ so the document starts with:
\begin{lstcode}
\documentclass{scrbook}
\usepackage{scrlayer-scrpage}
\pagestyle{scrheadings}
\end{lstcode}
- Next you will setup the chapter heading to be not only the left but also
- the right mark:
+ Next, ensure that the chapter headings set both the left and the right
+ marks:
\begin{lstcode}
\automark[chapter]{chapter}
\end{lstcode}
- Then the section heading should also become a right mark:
+ Then the section heading should also set right marks:
\begin{lstcode}
\automark*[section]{}
\end{lstcode}
- Here the star version is used, because the prior \Macro{automark}
- command should be still valid. Additionally the mandatory argument for
- the \PName{section level of the left mark} is empty, because this mark
- should be unchanged.
+ Here the starred version is used, since the previous \Macro{automark}
+ command should remain in effect. Additionally, the mandatory argument
+ for the \PName{section level of the left mark} is empty because this
+ mark should remain unchanged.
- Now you just need some document contents to see a result:
+ All that's missing now is a bit of document content to show the result:
\begin{lstcode}
\usepackage{lipsum}
\begin{document}
@@ -215,50 +237,70 @@
\lipsum[21-40]
\end{document}
\end{lstcode}
- We once again use package \Package{lipsum}\IndexPackage{lipsum} to
- generate some dummy text with command
- \Macro{lipsum}\IndexCmd{lipsum}. The package is really useful.
-
- If you'd test the example, you'd see, that the chapter start page does
- not have a running head as usual. This is, because it automatically uses
- the \PageStyle{plain} page style
- \PageStyle{plain.scrheadings}. Pages~2--4 have the chapter headings in
- the running head. After the section heading on page~4 the running head
- of page~5 changes into this section heading. From this page to the end
- the running head alternates between chapter and section heading from
- page to page.
+ We use the extremely useful \Package{lipsum}\IndexPackage{lipsum}
+ package to generate some dummy text with command
+ \Macro{lipsum}\IndexCmd{lipsum}.
+
+ If you test the example, you will see that the first page of the chapter
+ appears, as usual, without a running head, since this page automatically
+ uses the \PageStyle{plain} page style
+ \DescRef{\LabelBase.pagestyle.plain.scrheadings} (see the
+ \DescRef{maincls.cmd.chapterpagestyle} on
+ \DescPageRef{maincls.cmd.chapterpagestyle}). Pages~2--4 have the
+ chapter headings in the running head. After the section heading on
+ page~4, the running head of page~5 changes to this section heading. From
+ this page to the end, the running head alternates from page to page
+ between the chapter and section headings.%
\end{Example}
\fi
- Instead of the commands you may also use the options \Option{manualmark} and
- \Option{automark} to switch between manual and automatic running
- heads. Thereby \Option{automark} always uses the default
+ \begin{Declaration}
+ \Option{automark}
+ \OptionVName{autooneside}{simple switch}
+ \Option{manualmark}
+ \end{Declaration}
+ Instead of the commands described previously, you can also use the
+ \Option{manualmark}\important{\Option{manualmark}\\\Option{automark}} and
+ \Option{automark} options to switch between automatic and manual running
+ heads. \Option{automark} always uses the default\textnote{default}
+ \IfThisCommonLabelBase{scrlayer-scrpage}{\iftrue}{\csname
+ iffalse\endcsname}%
+ \lstinline|\automark[section]{chapter}| for classes with
+ \DescRef{maincls.cmd.chapter} and
+ \lstinline|\automark[subsection]{section}| for other classes.
+ \else
\begin{lstcode}
\automark[section]{chapter}
\end{lstcode}
- for classes with \DescRef{maincls.cmd.chapter} and
+ for classes with \DescRef{maincls.cmd.chapter} and
\begin{lstcode}
\automark[subsection]{section}
\end{lstcode}
- for classes without \DescRef{maincls.cmd.chapter}.
-
- But normally in single side mode you do not want that the lower level
- influences the right mark, you want the higher level, that will fill only
- the left mark in double side layout, to be the running head of all
- pages. The default option \Option{autooneside} corresponds to this
- behaviour. The option understands the values for simple switches, that can
- be found in \autoref{tab:truefalseswitch} on
- \autopageref{tab:truefalseswitch}. If you'd deactivate the option, in single
- side layout the optional and the obligatory arguments of \Macro{automark}
- and \Macro{automark*} will influence the running head again.%
+ for other classes.
+ \fi
+
+ \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ In one-sided printing, you normally want only the higher section levels
+ to provide the running title.%
+ }{%
+ In one-sided printing, you normally do not want the lower section level
+ to influence the right mark. Instead, you want the higher section
+ level, which would appear in only the left mark in two-sided printing, to
+ be the running head of all pages.%
+ } The default option \Option{autooneside}\important{\Option{autooneside}}
+ corresponds to this behaviour. The option accepts the values for
+ simple switches listed in \autoref{tab:truefalseswitch},
+ \autopageref{tab:truefalseswitch}. If you deactivate this option, the
+ optional and mandatory arguments of \Macro{automark} and \Macro{automark*}
+ will again control the running head in one-sided printing.%
\IfThisCommonLabelBase{scrlayer-scrpage}{\iftrue}{\csname
iffalse\endcsname}%
\begin{Example}
\phantomsection\xmpllabel{mark.oneside}%
- Assume you have a single sided report but want similar running heads as
- in the book example before. The chapter headings should be used as a
- running head as long as the first section appears. From the first
- section on, the section heading should be used. So we modify the
+ Suppose you have a one-sided report but want running heads similar to
+ those in the previous book example. Specifically, the chapter headings
+ should be used as the running head until the first section appears.
+ From the then on, the section heading should be used. So we modify the
previous example a little bit:
\begin{lstcode}
\documentclass{scrreprt}
@@ -273,77 +315,116 @@
\lipsum[21-40]
\end{document}
\end{lstcode}
- You can see, that we do not need a \Macro{automark*} command in this
- case. Please try the example also with \Option{autooneside} set to
- \PValue{true} or remove the option and its value. You should find a
- difference at the running head in the pages' head from page~4 on.
+ As you can see an \DescRef{\LabelBase.cmd.automark*} command is not
+ required in this case. You should try the example with
+ \Option{autooneside} set to \PValue{true}, or remove the option, for
+ comparison. You will notice a difference in the running head from
+ page~4 on.
\end{Example}
\fi
- Please note\textnote{Attention!}, only loading the package does not have any
- effect on the fact whether automatic or manual running heads are used or
- what kind of section headings do fill up the marks. Only using an explicit
- option \Option{automark} or \Option{manualmark} or one of the commands
- \Macro{automark} or \Macro{manualmark} can reach a well defined state.%
+ Note\textnote{Attention!} that merely loading the package does not have any
+ effect on whether automatic or manual running heads are used, or what kind
+ of sectioning headings fill the marks. Only by explicitly using the option
+ \Option{automark} or \Option{manualmark}, or the command
+ \DescRef{\LabelBase.cmd.automark} or \DescRef{\LabelBase.cmd.manualmark},
+ will the conditions here be initialized.%
+ \IfThisCommonLabelBase{scrlayer-scrpage}{\par%
+ You can find additional background information and examples of how to use
+ these commands in the documentation for the \Package{scrlayer} package
+ \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \Package{scrlayer-scrpage}%
+ }{%
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ } in \autoref{sec:scrlayer-scrpage.pagestyle.content}, starting on
+ \DescPageRef{scrlayer-scrpage.cmd.manualmark}.%
+ }{}%
+ \EndIndexGroup
\EndIndexGroup
\begin{Declaration}
\OptionVName{draft}{simple switch}
\end{Declaration}
- This \KOMAScript{} option understands the values for simple switches, that
- are shown in \autoref{tab:truefalseswitch} on
- \autopageref{tab:truefalseswitch}. If the option is active, all elements of
- the page styles will also show dimension lines. This might be useful while
- draft editing.%
- \IfThisCommonLabelBase{scrlayer-scrpage}{%
- If the option has been set as a global option (see the optional argument
- of \DescRef{\LabelBase.cmd.documentclass}), but you do not want the
- dimension lines, you can deactivate them for the package only using
+ This \KOMAScript{} option accepts the values for simple switches
+ listed in \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}.
+ If this option is active, all elements of the page styles will also show
+ rulers\index{ruler}%
+ \IfThisCommonLabelBase{scrlayer}{ for}{%
+ . This can sometimes be useful during}
+ the drafting process.%
+ \IfThisCommonLabelBase{scrlayer-scrpage}{ %
+ If this option has been set globally (see the optional argument
+ of \DescRef{\LabelBase.cmd.documentclass}) but you do not want the
+ rulers, you can deactivate them for this package alone by using
\OptionValue{draft}{false} as an optional argument of
\DescRef{\LabelBase.cmd.usepackage} while loading the package.%
}{}%
\EndIndexGroup
\begin{Declaration}
- \Macro{MakeMarkcase}\Parameter{string}
+ \Macro{MakeMarkcase}\Parameter{text}
\end{Declaration}
- The automatic running head and only this uses \Macro{MakeMarkcase} for its
- output. If the command has not been defined, e.\,g., by the class, while
- loading \Package{scrlayer}, it would be defined with the default of
- outputting the argument \PName{string} without changes. But the default can
- be change either redefining \Macro{MakeMarkcase} or using option
- \DescRef{\LabelBase.option.markcase}, that will be described next.
- Depending on the setting the argument could, e.\,g., be converted into upper
- or lower cases.
- %
+ Automatic running heads, but not manual ones, use \Macro{MakeMarkcase} for
+ their output. If the command has not been defined, e.\,g., by the class
+ while loading \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ }, it is defined by default to output the argument \PName{text} without
+ changes. But the default can be changed either by redefining
+ \Macro{MakeMarkcase} or by using the \DescRef{\LabelBase.option.markcase}%
+ \IndexOption{markcase}\important{\DescRef{\LabelBase.option.markcase}}
+ option, which will be described next. Depending on the setting, the
+ argument can, e.\,g., be converted into upper or lower case.%
\EndIndexGroup
\begin{Declaration}
- \OptionVName{markcase}{Wert}
+ \OptionVName{markcase}{value}
\end{Declaration}
- As already mentioned with \Package{scrlayer} you may switch between manual
- and automatic running heads. Using automatic running heads the corresponding
- marks will be filled by the section heading commands. Some culture areas do
- convert the running heads into upper case letters in opposite to the German
- typographic habit. The \LaTeX{} standard classes do so by default. Package
- \Package{scrlayer} optionally provides this too. Therefor you'd use option
- \OptionValue{markcase}{upper} which results in a redefinition of
- \DescRef{scrlayer.cmd.MakeMarkcase}\IndexCmd[indexmain]{MakeMarkcase}, a
- command, that is used by \Package{scrlayer} for automatic running heads.
-
- Unfortunately \LaTeX's command for upper case letter typesetting,
- \Macro{MakeUppercase}\IndexCmd{MakeUppercase} results in an very inadequate
- typesetting, because it neither uses letter spacing nor does it space
- balancing. One reason for this behaviour might be, that a glyph analyzing
- would be needed, to incorporate the letter shapes and their combination
- while space balancing. Because of this \KOMAScript{} author suggests to
- abstain from upper case letter typesetting for running heads. This could be
- achieved using \OptionValue{markcase}{used}. Nevertheless, some classes
- would add \Macro{MarkUppercase} or even \TeX{} command \Macro{uppercase}
- into the running heads. For such cases option
- \OptionValue{markcase}{noupper} can be used. This will also deactivate
+ As explained earlier, with \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } you can choose between manual and automatic running heads. Using automatic
+ running heads, the corresponding marks are set using the section heading
+ commands. In some cultures, in contrast to the typography of German-speaking
+ countries, it is common practice to set the running heads in upper-case
+ letters. The \LaTeX{} standard classes do so by default. The
+ \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } package also offers this as an option. To do so, use the
+ \OptionValue{markcase}{upper}\important{\OptionValue{markcase}{upper}}%
+ \IndexOption[indexmain]{markcase~=upper} option, which redefines
+ \DescRef{scrlayer.cmd.MakeMarkcase}\IndexCmd[indexmain]{MakeMarkcase}.
+
+ \IfThisCommonLabelBase{scrlayer}{%
+ Because of the poor typographical quality of the primitive capitalisation
+ routine (see the explanation of \DescRef{scrlayer-scrpage.option.markcase}
+ in \autoref{sec:scrlayer-scrpage.pagestyle.content},
+ \autopageref{expl:scrlayer-scrpage.MakeUppercase}) the author of
+ \KOMAScript recommends that you avoid upper-case typesetting for running
+ heads.%
+ }{%
+ Unfortunately,\phantomsection\label{expl:\ThisCommonLabelBase.MakeUppercase}
+ the \LaTeX{} command for converting text to upper case\Index{upper case},
+ \Macro{MakeUppercase}\IndexCmd{MakeUppercase}, does not produce good
+ results because it neither spaces characters nor balances lines
+ appropriately. This is certainly in part due to the fact that a
+ typographically correct upper-case conversion requires analysing the
+ glyphs to account for the different letter shapes \iffree{and their
+ combinations}{} while balancing the block. I therefore recommend that
+ you avoid upper-case typesetting for running heads.%
+ } This is usually possible with \OptionValue{markcase}{used}\important{%
+ \OptionValue{markcase}{used}}\IndexOption[indexmain]{markcase~=used}.
+ However, some classes insert \Macro{MarkUppercase}, or even the \TeX{}
+ command \Macro{uppercase}, into the running heads. For such cases, you can
+ use the option \OptionValue{markcase}{noupper}%
+ \important{\OptionValue{markcase}{noupper}}%
+ \IndexOption[indexmain]{markcase~=noupper}. This will also deactivate
\Macro{MakeUppercase} and \Macro{uppercase} inside the running heads.
You can find all valid values for \Option{markcase} in
@@ -353,19 +434,19 @@
\IfThisCommonLabelBase{scrlayer-scrpage}{%
\begin{table}
\centering
- \caption[Possible values for option \Option{markcase}]{Possible values
+ \caption[Available values for option \Option{markcase}]{Available values
for option \Option{markcase} to select upper/lower case letter
typesetting in automatic running heads}%
\label{tab:\ThisCommonLabelBase.markcase}%
\begin{desctabular}
\pventry{lower}{\IndexOption[indexmain]{markcase~=lower}%
redefines \DescRef{\LabelBase.cmd.MakeMarkcase} to convert the
- automatic running heads into lower case letters using
+ automatic running heads into lower-case letters using
\Macro{MakeLowercase} (lower case typesetting).%
}%
\pventry{upper}{\IndexOption[indexmain]{markcase~=upper}%
redefines \DescRef{\LabelBase.cmd.MakeMarkcase} to convert the
- automatic running heads into upper case letters using
+ automatic running heads into upper-case letters using
\Macro{MakeUppercase} (upper case typesetting).%
}%
\pventry{used}{\IndexOption[indexmain]{markcase~=used}%
@@ -376,104 +457,137 @@
\PValue{ignoreupper},
\PValue{noupper}}{\IndexOption[indexmain]{markcase~=noupper}%
redefines not only \DescRef{\LabelBase.cmd.MakeMarkcase} but also
- locally to the running heads \Macro{MakeUppercase} and
- \Macro{uppercase} to leave the automatic running heads unchanged.%
+ \Macro{MakeUppercase} and \Macro{uppercase} locally to the running
+ heads to leave the automatic running heads unchanged.%
}%
\end{desctabular}
\end{table}
}{}%
\EndIndexGroup
+
\begin{Declaration}
- \Macro{leftmark}%
- \Macro{rightmark}%
- \Macro{headmark}%
+ \Macro{leftmark}
+ \Macro{rightmark}
+ \Macro{headmark}
\Macro{pagemark}
\end{Declaration}
- If you want to differ from the predefined page styles, usually you need to
- decide, where to place the marks' contents. With \Macro{leftmark} you can
- state the contents of the left mark.
-
- Similar you can use \Macro{rightmark} to state the contents of the right
- mark. For more information about some intricacies of this see the further
- description of \DescRef{maincls-experts.cmd.rightmark} in
+ If you want to depart from the predefined page styles, you typically need to
+ decide where to place the marks' contents. With
+ \Macro{leftmark}\important{\Macro{leftmark}} you can define what will
+ appear in the left mark when the page is output.
+
+ Similarly, you can use \Macro{rightmark}\important{\Macro{rightmark}} to
+ define the contents of the right mark.\iffree{}{ For information about some
+ subtleties when using these commands, see further
+ \DescRef{maincls-experts.cmd.rightmark} in
\autoref{sec:maincls-experts.addInfos},
- \DescPageRef{maincls-experts.cmd.rightmark}.
+ \DescPageRef{maincls-experts.cmd.rightmark}.}
- Somehow easier would be usage of \Macro{headmark}. This extension of
- \Package{scrlayer} aliases either \Macro{leftmark} or \Macro{rightmark}
- depending on whether the current page is even or odd.
+ You can make life easier with \Macro{headmark}\important{\Macro{headmark}}.
+ This extension of \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } is a shorthand that resolves to either \Macro{leftmark} or
+ \Macro{rightmark} depending on whether the current page is even or odd.
- Strictly thought command \Macro{pagemark} is not involved by \TeX's mark
- mechanism. It is only used to output a formatted page number.
+ The \Macro{pagemark}\important{\Macro{pagemark}} command has nothing to do
+ with \TeX's mark mechanism. It is serves to output a formatted page number.
\BeginIndex{FontElement}{pagenumber}\LabelFontElement{pagenumber}%
The font of element
\FontElement{pagenumber}\important{\FontElement{pagenumber}} will be used
- for the output. This can be changed using command \Macro{setkomafont} or
- \DescRef{maincls.cmd.addtokomafont} (see also
+ for the output. This can be changed using the \Macro{setkomafont} or
+ \DescRef{maincls.cmd.addtokomafont} commands (see also
\autoref{sec:maincls.textmarkup}, \DescPageRef{maincls.cmd.setkomafont}).%
\EndIndex{FontElement}{pagenumber}%
\IfThisCommonLabelBase{scrlayer-scrpage}{\iftrue}{%
\par %
- If you are interested in an example about usage of commands
- \Macro{headmark} and \Macro{pagemark}, have a look into
+ If you are interested in an example showing the usage of the
+ \Macro{headmark} and \Macro{pagemark} commands, see
\autoref{sec:scrlayer-scrpage.pagestyle.content},
- \PageRefxmpl{scrlayer-scrpage.cmd.headmark}. The package
- \Package{scrlayer-scrpage} internally uses a lot of such features of
- \Package{scrlayer}.%
+ \PageRefxmpl{scrlayer-scrpage.cmd.headmark}. Internally, the
+ \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \Package{scrlayer-scrpage}%
+ }{%
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ } package uses many such features of
+ \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ }{%
+ \Package{scrlayer}%
+ }.%
\csname iffalse\endcsname}%
\begin{Example}
\phantomsection\xmpllabel{cmd.headmark}%
- Assume you want to use a left aligned running head and right aligned
- page number in the head of the pages of a document in single side
- layout. The following minimal but working examples would do so:
+ Suppose you want the running head to be aligned to the left margin and
+ the page number to the right margin in one-sided printing. The following
+ minimal working example does just this:
\begin{lstcode}
\documentclass{scrreprt}
\usepackage{blindtext}
\usepackage[automark]{scrlayer-scrpage}
\pagestyle{scrheadings}
\ihead{\headmark}
- \ohead[\pagemark]{\pagemark}
+ \ohead*{\pagemark}
\chead{}
\cfoot[]{}
\begin{document}
\blinddocument
\end{document}
\end{lstcode}
- Here package \Package{blindtext}\IndexPackage{blindtext} with its
- command \Macro{blinddocument}\IndexCmd{blinddocument} has been used to
- easily generate content for an example document.
-
- Commands \DescRef{scrlayer-scrpage.cmd.ihead}\IndexCmd{ihead} and
- \DescRef{scrlayer-scrpage.cmd.ohead}\IndexCmd{ohead} have been used to
- place the wanted marks. Although the page mark will be place not only to
- pages in page style \PageStyle{scrheadings} but using the optional
- argument also to pages in page style \PageStyle{plain.scrheadings}.
-
- Because of both page styles already have marks in the middle of the page
- head and page foot, those elements will be cleared using
+ The \Package{blindtext}\IndexPackage{blindtext} package and its
+ \Macro{blinddocument}\IndexCmd{blinddocument} command have been used
+ here to quickly generate sample document content for the example.
+
+ The \DescRef{scrlayer-scrpage.cmd.ihead}\IndexCmd{ihead} and
+ \DescRef{scrlayer-scrpage.cmd.ohead*}\IndexCmd{ohead*} commands
+ configure the desired marks. The starred variant
+ \DescRef{scrlayer-scrpage.cmd.ohead*} %
+ \iffalse% Umbruchvarianten
+ configures the page number mark not only on the pages set with the
+ \DescRef{\LabelBase.pagestyle.scrheadings}%
+ \IndexPagestyle{scrheadings} page style but also those set
+ with the \PageStyle{plain} %
+ \else%
+ also configures the page number with the %
+ \fi%
+ \DescRef{\LabelBase.pagestyle.plain.scrheadings}%
+ \IndexPagestyle{plain.scrheadings} page style used on the first page of
+ a chapter.%
+
+ Because these page styles have predefined marks in the centre of the
+ header and footer, those elements are cleared by using
\DescRef{scrlayer-scrpage.cmd.chead} and
- \DescRef{scrlayer-scrpage.cmd.cfoot}\IndexCmd{cfoot} with empty
- arguments. Alternatively you'd use
+ \DescRef{scrlayer-scrpage.cmd.cfoot} with empty arguments. Alternatively
+ you could use
\DescRef{scrlayer-scrpage-experts.cmd.clearpairofpagestyles}
\IndexCmd{clearpairofpagestyles} \emph{before}
- \DescRef{scrlayer-scrpage.cmd.ihead}. You will find a description of
- this command in \autoref{sec:scrlayer-scrpage-experts.pagestyle.pairs}.
+ \DescRef{scrlayer-scrpage.cmd.ihead}. You will find this command
+ described in \autoref{sec:scrlayer-scrpage-experts.pagestyle.pairs}.
\end{Example}
- Please note\textnote{Attention!}, that the empty optional argument of
+ Please note\textnote{Attention!} that the empty optional argument of
\DescRef{scrlayer-scrpage.cmd.cfoot} in the example above is not the same
- like omitting the optional argument. Please try it out and have a look at
- the difference in the footer of the first page.%
+ as omitting the optional argument. You should try it yourself and have a
+ look at the difference in the footer of the first page.%
\fi
- If all the mark features described above are not sufficient, experienced
- users can find more of them on \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \IfThisCommonLabelBase{scrlayer-scrpage}{% Umbruchvarianten
+ Advanced users can find more mark-setting commands%
+ }{%
+ If the options for the marks described above are not sufficient,
+ additional commands for advanced users are documented%
+ } %
+ starting on \IfThisCommonLabelBase{scrlayer-scrpage}{%
\DescPageRef{scrlayer-scrpage-experts.cmd.righttopmark}}{%
- \DescPageRef{scrlayer.cmd.righttopmark}}. For example, you can find there
- \DescRef{scrlayer-scrpage-experts.cmd.leftfirstmark} and
- \DescRef{scrlayer-scrpage-experts.cmd.rightbotmark}, which seem to be useful
- for lexicon like documents.%
+ \DescPageRef{\ThisCommonLabelBase.cmd.righttopmark}}.%
+ \iffalse% Umbruchkorrektur
+ \ For example, there you can find
+ \DescRef{scrlayer-scrpage-experts.cmd.leftfirstmark} and
+ \DescRef{scrlayer-scrpage-experts.cmd.rightbotmark}, which are quite useful
+ for documents like lexicons.%
+ \fi%
\EndIndexGroup
@@ -486,11 +600,14 @@
\Macro{paragraphmarkformat}%
\Macro{subparagraphmarkformat}
\end{Declaration}
- Usually the \KOMAScript{} classes and package \Package{scrlayer} use these
- commands internally to bring the section numbers into wanted form and
- additionally they support the \DescRef{maincls.cmd.autodot} mechanism of the
- \KOMAScript{} classes. If wanted these commands may be redefined to get
- another form of section numbers.%
+ \KOMAScript{} classes and the \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } package typically use these commands internally to format the section
+ numbers. They also support the \DescRef{maincls.cmd.autodot} mechanism of
+ the \KOMAScript{} classes. If desired, these commands can be redefined to
+ achieve a different formatting of section numbers.%
\IfThisCommonLabelBase{scrlayer-scrpage}{\iftrue}{%
\ See the example in \autoref{sec:scrlayer-scrpage.pagestyle.content},
\PageRefxmpl{scrlayer-scrpage.cmd.sectionmarkformat} for more
@@ -499,15 +616,19 @@
}%
\begin{Example}
\phantomsection\xmpllabel{cmd.sectionmarkformat}%
- Assume you do not want section numbers but section heading text only in
- the running head. So:
-\begin{lstcode}
+ \iftrue
+ For example, if you want to have running heads without a section
+ number, this is how you do it:
+ \else
+ Suppose you want section headings without the section number to appear
+ in the running head. This can be accomplished easily with the
+ following:
+ \fi
+\begin{lstcode}[belowskip=-\dp\strutbox]
\renewcommand*{\sectionmarkformat}{}
\end{lstcode}
- would be a simple solution for this.
\end{Example}
- \fi
- %
+ \fi%
\EndIndexGroup
@@ -520,28 +641,33 @@
\Macro{paragraphmark}\Parameter{Text}%
\Macro{subparagraphmark}\Parameter{Text}
\end{Declaration}
- Most classes use these commands to setup marks corresponding to the section
- commands. Thereby the only argument is the text without the number of the
- section heading, that should be used for the running head. For the number
- simply the number of the current section level will be used, if the current
- level uses numbers.
-
- Unfortunately\textnote{Attention!}, not all classes use such a command for
- every section level. The standard classes for example do not call
- \Macro{partmark}. The \KOMAScript{} classes support such commands for all
- section levels and therefore also use \Macro{partmark}.
-
- If users redefine these commands, they should\textnote{Attention!} take care
- to also use the counter \DescRef{maincls.counter.secnumdepth} for the test
- whether or not the section level should output a number, even in the case
- the user does not change counter \DescRef{maincls.counter.secnumdepth}
- himself, because packages and classes may do so locally and rely on correct
- handling of \DescRef{maincls.counter.secnumdepth}.
-
- However, package \Package{scrlayer} redefines these commands whenever you
- use \DescRef{scrlayer.cmd.automark} or \DescRef{scrlayer.cmd.manualmark} or
- the corresponding options, to activate or deactivate the wanted running
- heads.%
+ Most classes use these commands internally to set the marks according to the
+ sectioning commands. The argument should contain the text without the number
+ of the sectioning unit. The number is automatically determined using the
+ current section level if you use numbered headings.
+
+ However\textnote{Attention!}, not all classes use such a command for
+ every section level. The standard classes\textnote{\KOMAScript{} vs.
+ standard classes}, for example, do not call \Macro{partmark}
+ \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ upon a \Macro{part} command}{%
+ , whereas the \KOMAScript{} classes naturally support \Macro{partmark} as
+ well}.
+
+ If you redefine these commands, be sure\textnote{Attention!} to check
+ whether the numbers will be output via the
+ \DescRef{maincls.counter.secnumdepth} before setting the number even if you
+ do not change the \DescRef{maincls.counter.secnumdepth} counter yourself,
+ because packages and classes may do so locally and rely on correct handling
+ of \DescRef{maincls.counter.secnumdepth}.
+
+ The \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } package also redefines these commands whenever you use
+ \DescRef{scrlayer.cmd.automark} or \DescRef{scrlayer.cmd.manualmark} or the
+ corresponding options, to activate or deactivate the desired running heads.%
\EndIndexGroup
@@ -550,36 +676,50 @@
\Macro{markright}\Parameter{right mark}%
\Macro{markboth}\Parameter{left mark}\Parameter{right mark}
\end{Declaration}
- Independent of whether currently manual or automatic running heads are
- active, you may change the contents of the \PName{left mark} or the
- \PName{right mark} at any time using these commands. You should note, that
- the resulting contents of \Macro{leftmark}\IndexCmd{leftmark} is the
- \PName{left mark} of the last \Macro{markleft} or \Macro{markboth} command
- of the current page. In opposite to this the resulting contents of
- \Macro{rightmark}\IndexCmd{rightmark} is the \PName{right mark} of the first
- \Macro{rightmark} or \Macro{markboth} command of the current page.
-
- If you are using manual running heads, the marks will stay valid until one
- of the corresponding commands will be used again. If you are using automatic
- running heads the marks can loose their validity with the next section
- heading depending on the configuration of the automatism.
-
- You may also use these commands together with the star versions of the
- section commands.%
+ Regardless of whether you are working with manual or automatic running
+ heads, you can always change the contents of the \PName{left mark} or the
+ \PName{right mark} using these commands. Note that the left-hand mark
+ resulting from \Macro{leftmark}\IndexCmd{leftmark}%
+ \important{\Macro{leftmark}} will be the last mark placed on the
+ corresponding page, while the right-hand mark resulting from
+ \Macro{rightmark}\IndexCmd{rightmark}\important{\Macro{rightmark}} is the
+ first mark placed on the corresponding page. For more details, see
+ \iffree{}{the additional explanation of
+ \DescRef{maincls-experts.cmd.rightmark} in
+ \autoref{sec:maincls-experts.addInfos},
+ \DescPageRef{maincls-experts.cmd.rightmark} or} to
+ \DescRef{scrlayer.cmd.rightfirstmark}\IfThisCommonLabelBase{scrlayer}{}{ in
+ \autoref{sec:scrlayer.pagestyle.content}},
+ \DescPageRef{scrlayer.cmd.rightfirstmark}.
+
+ If you are using manual running heads\Index{running head>manual}, the marks
+ remain valid until they are explicitly replaced by reusing the corresponding
+ commands. However, if you are using automatic running heads, the marks can
+ become invalid with the next section heading, depending on the automatic
+ configuration.
+
+ You can also use these commands in conjunction with the starred versions of
+ the sectioning commands.%
\IfThisCommonLabelBase{scrlayer-scrpage}{\iftrue}{%
- \ You can find a detailed example about usage of \Macro{markboth} with
- \Package{scrlayer-scrpage} in
+ \ You can find detailed examples illustrating usage of \Macro{markboth}
+ with the \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ }{%
+ \Package{scrlayer}%
+ }-derived package \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \Package{scrlayer-scrpage}%
+ }{%
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ } in
\autoref{sec:scrlayer-scrpage.pagestyle.content},
- \PageRefxmpl{scrlayer-scrpage.cmd.markboth}. Package
- \Package{scrlayer-scrpage} is a kind of extension of \Package{scrlayer}.%
+ \PageRefxmpl{scrlayer-scrpage.cmd.markboth}.%
\csname iffalse\endcsname%
}%
\begin{Example}
\phantomsection\xmpllabel{cmd.markboth}%
- Assume you are using a preface with several pages just before the table
- of contents, that should not have an entry at the table of contents
- itself. Because of using a separation line at the page head, you want
- also a running head for this preface:
+ Suppose you write a preface of several pages placed just before the
+ table of contents but not appearing in it. However, since you use
+ dividing lines in your header, you want a running head for this preface:
\begin{lstcode}
\documentclass[headsepline]{book}
\usepackage{scrlayer-scrpage}
@@ -593,9 +733,10 @@
\blinddocument
\end{document}
\end{lstcode}
- First of all this seems to produce the wanted result. But have a closer
- look: In difference to the other running heads ``\texttt{Preface}'' is
- not in upper case letters. But you can fix this easily:
+ At first glance, this seems to produce the desired result. Taking a
+ second look, however, you can see that the running title
+ ``\texttt{Preface}'' does not appear in upper-case letters, unlike the
+ other running heads. But that's easy to change:
\begin{lstcode}
\documentclass[headsepline]{book}
\usepackage{scrlayer-scrpage}
@@ -612,14 +753,14 @@
Using command \DescRef{\LabelBase.cmd.MakeMarkcase} results in getting
the same letter case as for automatic running heads.
- Now, let's move command \DescRef{maincls.cmd.tableofcontents} in front
- of the preface. Let's remove the \Macro{markboth} command too. You'll
- realise, that the preface now has the running head
- ``\texttt{CONTENTS}''. This is because of a quirk of
+ Now, let's move the \DescRef{maincls.cmd.tableofcontents} in front
+ of the preface and remove the \Macro{markboth} command. You'll
+ discover that the preface now has the running head
+ ``\texttt{CONTENTS}''. This is due to a quirk of
\DescRef{maincls.cmd.chapter*} (see also \autoref{sec:maincls.structure}
- on \DescPageRef{maincls.cmd.chapter*}). If in such cases the running
- head should be removed, \Macro{markboth} with two empty arguments would
- be useful:
+ on \DescPageRef{maincls.cmd.chapter*}). If you do not want a running
+ head here, you can easily accomplish this by passing two empty arguments
+ to \Macro{markboth}:
\begin{lstcode}
\documentclass[headsepline]{book}
\usepackage{scrlayer-scrpage}
@@ -634,8 +775,7 @@
\end{document}
\end{lstcode}
\end{Example}
- \fi
- %
+ \fi%
\EndIndexGroup
\fi
@@ -644,39 +784,49 @@
\begin{Declaration}
\Macro{GenericMarkFormat}\Parameter{name of the section level}
\end{Declaration}
- At the running head this command will be used by default for the formatting
- of all section numbers below the subsection and with classes without
- \DescRef{maincls.cmd.chapter} also for the section level and the subsection
- level, if the mark commands for those numbers have not been defined before
- loading \Package{scrlayer}. Thereby the package uses
- \Macro{@seccntmarkformat} if such a command has been defined, like the
- \KOMAScript{} classes do. Otherwise \Macro{@seccntformat} will be used,
- which is provided by the \LaTeX{} kernel. The expected, mandatory argument
- of the command is the \PName{name of a section level}, i.\,e.,
- \PValue{chapter} or \PValue{section} \emph{without} the backslash prefix.
-
- You can change the default formatting of the numbers, that use this command,
- by redefining only this single command. Classes can change the default
+ By default, this command is used to format all section numbers in running
+ heads below the subsection level, and for classes without
+ \DescRef{maincls.cmd.chapter}, also for the section and subsection levels,
+ unless the respective mark commands for those levels are defined before
+ loading \Package{scrlayer}. The command causes the package to use
+ \Macro{@seccntmarkformat}\IndexCmd{@seccntmarkformat}%
+ \important{\Macro{@seccntmarkformat}} if this internal command is defined,
+ as it is in the \KOMAScript{} classes. Otherwise \Macro{@seccntformat}%
+ \IndexCmd{@seccntformat}\important{\Macro{@seccntformat}} will be used,
+ which is provided by the \LaTeX{} kernel. The mandatory argument of the
+ command contains the name of a sectioning command, such as \PValue{chapter}
+ or \PValue{section} \emph{without} the backslash prefix.
+
+ By redefining this command, you can change the default number format for all
+ sectioning commands that use it. Classes can also change the default
formatting also by defining this command.%
\IfThisCommonLabelBase{scrlayer-scrpage-experts}{\iftrue}{%
\par %
- A detailed example about cooperation of command \Macro{GenericMarkFormat}
- and the commands \DescRef{\ThisCommonLabelBase.cmd.sectionmarkformat} and
- \DescRef{\ThisCommonLabelBase.cmd.subsectionmarkformat} that are described
- at \DescPageRef{\ThisCommonLabelBase.cmd.chaptermark} is shown in
- \autoref{sec:scrlayer-scrpage-experts.pagestyle.content},
+ A detailed example illustrating the interplay of the
+ \Macro{GenericMarkFormat} command with the
+ \DescPageRef{\ThisCommonLabelBase.cmd.chaptermark} command and
+ \DescRef{\ThisCommonLabelBase.cmd.sectionmarkformat} or
+ \DescRef{\ThisCommonLabelBase.cmd.subsectionmarkformat} when using
+ the \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ }-derived package \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \Package{scrlayer-scrpage}%
+ }{%
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ } is shown in \autoref{sec:scrlayer-scrpage-experts.pagestyle.content},
\PageRefxmpl{scrlayer-scrpage-experts.cmd.GenericMarkFormat}.%
\csname iffalse\endcsname}%
\begin{Example}
- \phantomsection
+ \phantomsection
\xmpllabel{cmd.GenericMarkFormat}%
- Assume you want the section numbers of all levels at the running head of
- an article to be printed in white colour inside a black coloured
- box. Using standard \LaTeX{} \Class{article} class, package
- \Package{scrlayer} defines the number mark commands
- \Macro{sectionmarkformat} and \Macro{subsectionmarkformat} using
- \Macro{GenericMarkFormat}. So you need to redefine only this single
- command:
+ Suppose you want the section numbers of all levels in the running head
+ of an article to be printed in white within a black box. Since the
+ commands \Macro{sectionmarkformat} and \Macro{subsectionmarkformat} of
+ the \Package{scrlayer} package are defined with
+ \Macro{GenericMarkFormat} for articles using the standard \LaTeX{}
+ \Class{article} class, you need to redefine only this one command:
\begin{lstcode}
\documentclass{article}
\usepackage{blindtext}
@@ -691,40 +841,39 @@
\blinddocument
\end{document}
\end{lstcode}
- The colour has been done using package
- \Package{xcolor}\IndexPackage{xcolor}. See the package manual for more
- information about this.
+ The colour has been changed using the
+ \Package{xcolor}\IndexPackage{xcolor} package. More details can be found
+ in that package's manual (see \cite{package:xcolor}).
- Additionally a not visible strut has been used. Every complete \LaTeX{}
+ This example also uses an invisible strut. Any detailed \LaTeX{}
introduction should explain the related command \Macro{strut}.
- A helper macro \Macro{numberbox} has been defined for the formatting of
- the number within a box. In the redefinition of
- \Macro{GenericMarkFormat} this has been prefixed by \Macro{protect} to
- protect it from expansion. This is necessary because otherwise the upper
- case letter conversion of \Macro{MakeUppercase} that will be used for
- the running head, would result in an ask for colours ``\texttt{BLACK}''
- and ``\texttt{WHITE}'' instead of ``\texttt{black}'' and
- ``\texttt{white}'' and those colours are undefined. Alternatively you
- may define \Macro{numberbox} using \Macro{DeclareRobustCommand*} instead
- of \Macro{newcommand*} and then omit \Macro{protect} (see
- \cite{latex:clsguide}).
-
- If you'd do the same with a \KOMAScript{} class or with one of the
- \LaTeX{} standard classes \Class{book} or \Class{report}, you'd
- additionally have to redefine \DescRef{scrlayer.cmd.sectionmarkformat}%
- \IndexCmd{sectionmarkformat}%
+ A helper macro, \Macro{numberbox}, has been defined to format the number
+ within a box. This command is prefixed in the redefinition of
+ \Macro{GenericMarkFormat} by \Macro{protect} in order to protect it from
+ expansion. This is necessary because otherwise the upper-case letter
+ conversion of \Macro{MakeUppercase} for the running head, would result
+ in using the colours ``\texttt{BLACK}'' and ``\texttt{WHITE}'' instead
+ of ``\texttt{black}'' and ``\texttt{white}'', and those colours are
+ undefined. Alternatively, you could define \Macro{numberbox} using
+ \Macro{DeclareRobustCommand*} instead of \Macro{newcommand*} and omit
+ \Macro{protect} (see \cite{latex:clsguide}).
+
+ If you wanted to achieve the same effect with a \KOMAScript{} class or
+ with the standard \LaTeX{} classes \Class{book} or \Class{report}, you
+ would also have to redefine, respectively,
+ \DescRef{scrlayer.cmd.sectionmarkformat}\IndexCmd{sectionmarkformat}%
\important{\DescRef{scrlayer.cmd.sectionmarkformat}} and
\DescRef{scrlayer.cmd.subsectionmarkformat}%
\IndexCmd{subsectionmarkformat}%
- \important{\DescRef{scrlayer.cmd.subsectionmarkformat}} respectively
+ \important{\DescRef{scrlayer.cmd.subsectionmarkformat}}, or
\DescRef{scrlayer.cmd.chaptermarkformat}%
\IndexCmd{chaptermarkformat}%
\important{\DescRef{scrlayer.cmd.chaptermarkformat}} and
\DescRef{scrlayer.cmd.sectionmarkformat}%
\IndexCmd{sectionmarkformat}%
- \important{\DescRef{scrlayer.cmd.sectionmarkformat}} and too, because
- then these would not have been defined using \Macro{GenericMarkFormat}:
+ \important{\DescRef{scrlayer.cmd.sectionmarkformat}}, because
+ these are not by default defined using \Macro{GenericMarkFormat}:
\begin{lstcode}
\documentclass{scrbook}
\usepackage{blindtext}
@@ -742,8 +891,7 @@
\end{document}
\end{lstcode}
\end{Example}
- \fi
- %
+ \fi%
\EndIndexGroup
@@ -755,66 +903,79 @@
\Macro{leftbotmark}%
\Macro{leftfirstmark}
\end{Declaration}
- For page styles \LaTeX\ChangedAt{v3.16}{\Package{scrlayer}} uses a bipartite
- \TeX{} mark. Running heads can use the left part of that mark by
- \DescRef{scrlayer.cmd.leftmark}%
+ \LaTeX\ChangedAt{v3.16}{\Package{scrlayer}} typically uses a two-part
+ \TeX{} mark for page styles. Running heads can access the left part of that
+ mark with \DescRef{scrlayer.cmd.leftmark}%
\important{\DescRef{scrlayer.cmd.leftmark}}\IndexCmd{leftmark} and the right
- part by \DescRef{scrlayer.cmd.rightmark}%
- \important{\DescRef{scrlayer.cmd.rightmark}}\IndexCmd{rightmark}. Indeed, it
- seems that it was suggested to use \DescRef{scrlayer.cmd.leftmark} for the
- running head of left, even pages and \DescRef{scrlayer.cmd.rightmark} for
- the running head of right, odd pages of double-sided documents. Within
- single-sided layouts the standard classes even do not set the left part of
- the mark.
-
- \TeX{} itself knows three alternatives to make usage of a mark. The
- \Macro{botmark} is the last valid mark of the page that has been build
- last. If there has not been set any mark on the page, it is the last mark of
- the already shipped out pages. \LaTeX{} command
- \DescRef{scrlayer.cmd.leftmark} uses exactly this mark. So it shows the left
- part of the last mark of the page. This is the same like
- \Macro{leftbotmark}. In opposite to this \Macro{rightbotmark} shows the
- right part of that mark.
-
- \Macro{firstmark} is the first mark of the page that has been build
- last. This means the first mark, that has been set on the page. If there has
- not been set any mark on the page, this is the last mark of the already
- shipped out pages. \LaTeX{} command \DescRef{scrlayer.cmd.rightmark} uses
- exaclty this mark. So it shows the right part of the first mark of the
- page. This is the same like \Macro{rightfirstmark}. In opposite to this
- \Macro{leftfirstmark} shows the left part of that mark.
-
- \Macro{topmark} is the content of \Macro{botmark} before building the
- current page. \LaTeX{} itself does not use it. Nevertheless,
- \Package{scrlayer} provides \Macro{lefttopmark} to show the left part of it
- and \Macro{righttopmark} to show the right part of it.
-
- Note\textnote{Attention!} that the left part and the right part of the mark
- can be made all together only. Even if you use
+ part with \DescRef{scrlayer.cmd.rightmark}%
+ \important{\DescRef{scrlayer.cmd.rightmark}}\IndexCmd{rightmark}. In fact,
+ it was probably intended to use \DescRef{scrlayer.cmd.leftmark} for the
+ running head of left (even) pages and \DescRef{scrlayer.cmd.rightmark} for
+ the running head of right (odd) pages of two-sided documents. In
+ one-sided printing, however, the standard classes do not even set the left
+ part of the mark.
+
+ \TeX{} itself knows three ways to access a mark. The \Macro{botmark}%
+ \IndexCmd{botmark}\important{\Macro{botmark}} is the last valid mark of the
+ most recent page that has been built. If no mark has been set on the page,
+ it corresponds to the last mark set on the pages that have already been
+ shipped out. The \LaTeX{} command \DescRef{scrlayer.cmd.leftmark} uses
+ precisely this mark, so it returns the left part of the last mark of the
+ page. This corresponds exactly to \Macro{leftbotmark}%
+ \important{\Macro{leftbotmark}}. By comparison, \Macro{rightbotmark}%
+ \important{\Macro{rightbotmark}} prints the right part of this mark.
+
+ \Macro{firstmark}\IndexCmd{firstmark}\important{\Macro{firstmark}} is the
+ first mark of the last page that has been built. This is the first mark that
+ has been set on the page. If no mark has been set on the page, it
+ corresponds to the last mark of the pages that have already been shipped
+ out. The \LaTeX{} command \DescRef{scrlayer.cmd.rightmark} uses precisely
+ this mark, so it returns the right part of the first mark of the page. This
+ corresponds exactly to \Macro{rightfirstmark}%
+ \important{\Macro{rightfirstmark}}. By comparison, \Macro{leftfirstmark}%
+ \important{\Macro{leftfirstmark}} prints the left part of this mark.
+
+ \Macro{topmark}\IndexCmd{topmark}\important{\Macro{topmark}} is the content
+ that \Macro{botmark} had before building the current page. \LaTeX{} itself
+ does not use it. Nevertheless, \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } provides \Macro{lefttopmark}\important{\Macro{lefttopmark}} to access the
+ left part of this mark and \Macro{righttopmark}%
+ \important{\Macro{righttopmark}} to access the right part.
+
+ Note\textnote{Attention!} that the left and right portions of the mark
+ can only be set together. Even if you use
\DescRef{scrlayer.cmd.markright}\IndexCmd{markright} to change only the
- right part, the left part will be made again (unchanged). Accordingly in
- double-side mode using page style
- \PageStyle{headings\important{\PageStyle{headings}}\IndexPagestyle{headings}}
- the higher section levels always make both parts. For example
+ right part, the left part will set again (unchanged). Accordingly, in
+ two-sided printing, using the \PageStyle{headings}%
+ \important{\PageStyle{headings}}\IndexPagestyle{headings} page style,
+ the higher section levels always make both parts. For example,
\DescRef{scrlayer.cmd.chaptermark} uses \DescRef{scrlayer.cmd.markboth} with
- an empty right argument in this case. This is the reason why
+ an empty right argument in this case. This is the reason
\DescRef{scrlayer.cmd.rightmark} or \Macro{rightfirstmark} always shows an
- empty value on pages with chapter beginnings, even if there was a
+ empty value on pages which start a chapter, even if there was a
\DescRef{scrlayer.cmd.sectionmark} or \DescRef{maincls.cmd.section} on the
same page to make the right part of the mark.
Please note\textnote{Attention!} that using any of these commands to show
- the left or right part of the mark as part of the page content could have
- unexpected results. They are recommended to be used in the head or foot of a
- page style only. So with \Package{scrlayer} they should be part of the
- contents of a layer. But it does not matter whether or not a layer is
- restricted to the background or the foreground. Both kind of layers are
- shipped out after building the current page.
-
- If you need more information about the mark mechanism of \TeX, please have a
- look at \cite[chapter~23]{knuth:texbook}. You will find, that marks are an
- issue for real experts. So if the explanation above was at least more
- confusing than illuminative: Please don't worry.%
+ the left or right part of the mark as part of the page content may lead to
+ unexpected results. They are really meant for use in the header or footer
+ of a page style only. Therefore, they should always be part of the contents
+ of a layer when using \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ }. But it does not matter whether the layer is restricted to the background
+ or the foreground, since all layers are shipped out after building the
+ current page.
+
+ If you need more information about the mark mechanism
+ \iffree{of \TeX{}}{\unskip}, please have a look at
+ \cite[chapter~23]{knuth:texbook}. The topic is flagged there as an issue for
+ real experts. \IfThisCommonLabelBase{scrlayer}{% Umbruchkorrektur
+ So if the explanation above confused you, please don't worry about it.}{}%
\EndIndexGroup
@@ -824,40 +985,45 @@
\Macro{@mkdouble}\Parameter{mark}%
\Macro{@mkboth}\Parameter{left mark}\Parameter{right mark}
\end{Declaration}
- Sometimes inside classes and packages the marks for running heads should be
- filled up only if automatic running heads are active (see option
- \DescRef{scrlayer.option.automark} and command
- \DescRef{scrlayer.cmd.automark} on
- \DescPageRef{scrlayer-scrpage.cmd.automark}). In the \LaTeX{} standard
- classes only \Macro{@mkboth} has been used for this. This command is either
- \Macro{@gobbletwo}, that simply destroys both mandatory arguments, or
- \DescRef{scrlayer.cmd.markboth}, a command that fills up the left and
- \PValue{left mark} and the \PValue{right mark}. Packages like
- \Package{babel} also change \Macro{\@mkboth}, i.\,e., to add language
- switching to the running head.
-
- But if a class or package author only wants to change either the \PName{left
- mark} or the \PName{right mark} without the other one, a proper command is
- missing. Package \Package{scrlayer} itself needs such commands for the
- implementation of all cases of automatic running heads. So if command
- \Macro{@mkleft} to fill up only the left mark or \Macro{@mkright} to fill up
- only the right mark or \Macro{@mkdouble} to fill up both marks with the same
- content is undefined while loading \Package{scrlayer}, the package will
- define them. Thereby the actual definition of \Macro{@mkboth} will be used
- as an indicator whether or not automatic running heads should be used. The
- new commands will full up the marks only in the case of automatic running
- heads.
-
- Class and package authors can use these commands too, if they want to fill
- up only one of the marks or both marks with the same content but only if
- automatic running heads are activated. This condition is also the difference
- to the commands \Macro{markleft}, \Macro{markright}, and \Macro{markboth}.%
- \EndIndexGroup
-\fi
-
+ Within classes and packages, you may only want to use running heads if
+ automatic running heads are active (see the
+ \DescRef{scrlayer.option.automark} option and the
+ \DescRef{scrlayer.cmd.automark} command on
+ \DescPageRef{scrlayer-scrpage.cmd.automark}). In the standard \LaTeX{}
+ classes, this only works with \Macro{@mkboth}. This command corresponds to
+ either \Macro{@gobbletwo}, which simply consumes both mandatory arguments,
+ or \DescRef{scrlayer.cmd.markboth}, which sets both the \PValue{left mark}
+ and the \PValue{right mark}. Packages like \Package{babel} also change
+ \Macro{\@mkboth}, e.\,g., to enable language switching in the running head.
+
+ However, if you want to change only the \PName{left mark} or the
+ \PName{right mark} without changing the other one, there is no corresponding
+ command. The \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } package itself needs such commands to implement automatic running heads.
+ So if \Macro{@mkleft}, for setting the left mark only, or \Macro{@mkright},
+ for setting the right mark only, or \Macro{@mkdouble}, for setting both
+ marks with the same content, is undefined when loading
+ \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ }, this package will define them. This definition uses the state of
+ \Macro{@mkboth} as an indication of whether to use automatic running heads.
+ The commands will set the marks only in the case of automatic running heads.
+
+ Class and package authors can also fall back on these commands as appropriate
+ if they want to set the left or right the marks only if automatic running
+ heads are activated.%
+ \EndIndexGroup%
+\fi%
+%
\IfThisCommonLabelBase{scrlayer}{%
- For more information about manipulation of the contents of page styles see
- also \autoref{sec:scrlayer-scrpage.pagestyle.content} from
+ \par
+ For more information about manipulating the contents of page styles, see
+ also \autoref{sec:scrlayer-scrpage.pagestyle.content} starting at
\autopageref{sec:scrlayer-scrpage.pagestyle.content}.%
}{}%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-parmarkup.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-parmarkup.tex
index dad2091a6f1..647d09dde34 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-parmarkup.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-parmarkup.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-parmarkup.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-parmarkup.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,94 +46,107 @@
% ======================================================================
\KOMAProvidesFile{common-parmarkup.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (common paragraph: Paragraph Markup)]
-\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi}
+\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and
+ Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-01-31
-\section{Paragraph Markup}
+\section{Marking Paragraphs}
\seclabel{parmarkup}%
\BeginIndexGroup
-\BeginIndex{}{paragraph>markup}%
+\BeginIndex{}{paragraph>marking}%
\IfThisCommonLabelBase{maincls}{%
The\textnote{paragraph indent vs. paragraph spacing} standard classes
normally set paragraphs\Index[indexmain]{paragraph} indented and without any
- vertical inter-paragraph space. This is the best solution when using a
- regular page layout, like the ones produced with the \Package{typearea}
+ vertical, inter-paragraph space. This is the best solution when using a
+ regular page layout like the ones produced with the \Package{typearea}
package. If neither indentation nor vertical space is used, only the length
- of the last line would give the reader a reference point. In extreme cases,
- it is very difficult to detect whether a line is full or not. Furthermore,
- it is found that a marker at the paragraph's end tends to be easily
- forgotten by the start of the next line. A marker at the paragraph's
- beginning is more easily remembered. Inter-paragraph spacing has the
+ of the last line would give the reader a guide to the paragraph break. In
+ extreme cases, it is very difficult to tell whether a line is full or not.
+ Furthermore, typographers find that a signal given at the paragraph's end is
+ easily forgotten by the start of the next line. A signal at the paragraph's
+ beginning is more easily remembered. Inter-paragraph spacing has the
drawback of disappearing in some contexts. For instance, after a displayed
formula it would be impossible to detect if the previous paragraph continues
- or if a new one begins. Also, when starting to read at the top of a new page
- it might be necessary to look at the previous page in order determine if a
- new paragraph has been started or not. All these problems disappear when
- using indentation. A combination of indentation and vertical inter-paragraph
- spacing is extremely redundant and therefore should be avoided. The
- indentation\Index[indexmain]{indentation} is perfectly sufficient by
- itself. The only drawback of indentation is the reduction of the line
- length. The use of inter-paragraph spacing\Index{paragraph>spacing} is
- therefore justified when using short lines, for instance in a newspaper.%
+ or a new one begins. Also, at the top of a new page, it might be necessary
+ to look at the previous page to determine if a new paragraph has been
+ started or not. All these problems disappear when using indentation. A
+ combination of indentation and vertical inter-paragraph spacing is redundant
+ and therefore should be avoided. Indentation\Index[indexmain]{indentation}
+ alone is sufficient. The only drawback of indentation is that it shortens
+ the line length. The use of inter-paragraph spacing\Index{paragraph>spacing}
+ is therefore justified when using short lines, such as in a newspaper.%
}{%
\IfThisCommonLabelBase{scrlttr2}{%
- In the preliminaries of \autoref{sec:maincls.parmarkup},
- \autopageref{sec:maincls.parmarkup} it was argued why paragraph indent is
- preferred over paragraph spacing. But the elements the argumentation
- depends on, i.\,e., figures, tables, lists, equations, and even new pages,
- are rare. Often letters are not so long that an oversighted paragraph will
- have serious consequences to the readability of the document. Because of
- this, the arguments are less serious for standard letters. This may be one
- reason that in letters you often encounter paragraphs marked not with
- indentation of the first line, but with a vertical skip between them. But
- there may be still some advantages of the paragraph indent. One may be
- that such a letter is highlighted in the mass of letters. Another may be
- that the \emph{corporate identity} need not be broken for letters only.%
+ The preliminaries of \autoref{sec:maincls.parmarkup},
+ \autopageref{sec:maincls.parmarkup} explain why paragraph indentation is
+ preferred to paragraph spacing. But the elements to which this explanation
+ refers, for example figures, tables, lists, equations, and even new pages,
+ are rare in normal letters. Letters are usually not so long that an
+ unrecognised paragraph will have serious consequences to the readability
+ of the document. The arguments for indentation, therefore, are less
+ consequential for standard letters. This may be one reason that you often
+ find paragraphs in letters marked with vertical spacing. But two
+ advantages of paragraph indentation remain. One is that such a letter
+ stands out from the crowd. Another is that it maintains the \emph{brand
+ identity}, that is the uniform appearance, of all documents from a single
+ source.%
}{\InternalCommonFileUsageError}%
} %
\IfThisCommonFirstRun{}{%
- Apart from these suggestions, everything that has been written at
+ Apart from these suggestions, the information described in
\autoref{sec:\ThisCommonFirstLabelBase.parmarkup} for the other
- \KOMAScript{} classes is valid for letters too. So if you have alread read
+ \KOMAScript{} classes is valid for letters too. So if you have already read
and understood \autoref{sec:\ThisCommonFirstLabelBase.parmarkup} you can
- jump to \autoref{sec:\ThisCommonLabelBase.parmarkup.next} on
+ skip ahead to \autoref{sec:\ThisCommonLabelBase.parmarkup.next} on
\autopageref{sec:\ThisCommonLabelBase.parmarkup.next}.%
+ \IfThisCommonLabelBase{scrlttr2}{ %
+ This also applies if you work not with the
+ \Class{scrlttr2}\OnlyAt{scrlttr2} class but with the \Package{scrletter}
+ package. The package does not provide its own settings for paragraph
+ formatting but relies entirely on the class being used.%
+ }{}%
}
\begin{Declaration}
- \OptionVName{parskip}{manner}
+ \OptionVName{parskip}{method}
\end{Declaration}
\IfThisCommonLabelBase{maincls}{%
- Once in a while there are requests for a document layout with vertical
- inter-paragraph spacing instead of indentation. The \KOMAScript{} classes
- provide with option \Option{parskip}\ChangedAt{v3.00}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}} several capabilities to use
- inter-paragraph spacing instead of paragraph indent.%
+ Once in a while you may require a document layout with vertical
+ inter-paragraph spacing instead of indentation. The \KOMAScript{} classes
+ provide several ways to accomplish this with the
+ \Option{parskip}\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} option.%
}{%
\IfThisCommonLabelBase{scrlttr2}{%
- Especially in letters you often encounter paragraphs marked not with
- indentation of the first line, but with a vertical skip between
- them. \KOMAScript{} class \Class{scrlttr2} provides several capabilities for
- this.%
+ In letters, you often encounter paragraphs marked not by indentation of
+ the first line but by a vertical space between them. The \KOMAScript{}
+ class \Class{scrlttr2}\OnlyAt{scrlttr2} provides ways to accomplish this
+ with the \Option{parskip} option.%
}{\InternalCommonFileUsageError}%
} %
-The \PName{manner} consists of two elements. The first element is either
-\PValue{full} or \PValue{half}, meaning the space amount of one line or only
-half of a line. The second element is ``\PValue{*}'', ``\PValue{+}'', or
-``\PValue{-}'', and may be omitted. Without the second element the last line
-of a paragraph will end with white space of at least 1\Unit{em}. With the plus
-character as second element the white space amount will be a third, and with
-the asterisk a fourth, of the width of a normal line. The minus variant does
-not take care about the white space at the end of the last line of a
-paragraph.
+The \PName{method} consists of two elements. The first element is either
+\PValue{full}\important{\OptionValue{parskip}{full}\\
+ \OptionValue{parskip}{half}} or \PValue{half}, where \PValue{full} stands
+for a paragraph spacing of one line and \PValue{half} stands for a paragraph
+spacing of half a line. The second element consists of one of the characters
+``\PValue{*}'', ``\PValue{+}'', or ``\PValue{-}'' and can be omitted. Without
+the second element\important{\OptionVName{parskip}{distance}}, the final line
+of a paragraph will end with a white space of at least 1\Unit{em}. With the
+plus character as the second element%
+\important{\OptionValue{parskip}{\PName{distance}+}}, the white space will be
+at least one third\,---\,and with the
+asterisk\important{\OptionValue{parskip}{\PName{distance}*}} one
+fourth\,---\,the width of a normal line. With the minus variant%
+\important{\OptionValue{parskip}{\PName{Abstand}-}}, no provision is made for
+white space in the last line of a paragraph.
-The setting may be changed at any place inside the document. In this case the
-command \Macro{selectfont}\IndexCmd{selectfont}%
+You can change the setting at any time. If you change it inside the document,
+the \Macro{selectfont}\IndexCmd{selectfont}%
\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v3.08}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
@@ -144,19 +157,20 @@ command \Macro{selectfont}\IndexCmd{selectfont}%
\InternalComonFileUsageError%
}%
} %
-will be called implicitly. The change will be valid and may be seen from the
-next paragraph.
+command will be called implicitly. Changes to paragraph spacing within a
+paragraph will not be visible until the end of the paragraph.
-Besides the resulting eight possible combinations for \PName{manner}, the values
-for simple switches shown at \autoref{tab:truefalseswitch},
-\autopageref{tab:truefalseswitch} may be used. Switching on the option would
-be the same as using \PValue{full} without annex and therefore will result in
-inter-paragraph spacing of one line with at least 1\Unit{em} white space at
-the end of the last line of each paragraph. Switching off the options would
-reactivate the default of 1\Unit{em} indent at the first line of the
-paragraph instead of paragraph spacing. All the possible values of option
-\Option{parskip} are shown in
-\autoref{tab:\ThisCommonFirstLabelBase.parskip}%
+In addition to the resulting eight combinations for \PName{method}, you can
+use the values for simple switches shown in \autoref{tab:truefalseswitch},
+\autopageref{tab:truefalseswitch}. Activating the option%
+\important{\Option{parskip}\\\OptionValue{parskip}{true}} corresponds to using
+\PValue{full} with no second element and therefore results in inter-paragraph
+spacing of one line with at least 1\Unit{em} white space at the end of the
+last line of each paragraph. Deactivating%
+\important{\OptionValue{parskip}{false}} the option re-activates the default
+indentation of 1\Unit{em} at the first line of the paragraph instead of
+paragraph spacing. A summary of all possible values for \PName{method} are
+shown in \autoref{tab:\ThisCommonFirstLabelBase.parskip}%
\IfThisCommonFirstRun{.%
\begin{desclist}
% Umbruchkorrektur
@@ -165,54 +179,55 @@ paragraph instead of paragraph spacing. All the possible values of option
% \begin{table}
\desccaption
% \caption
- [{Possible values of option \Option{parskip}}]{%
- Possible values of option \Option{parskip} to select
- the paragraph mark\label{tab:\ThisCommonFirstLabelBase.parskip}%
+ [{Available values of option \Option{parskip}}]{%
+ Available values of option \Option{parskip} to select
+ how paragraph are
+ distinguished\label{tab:\ThisCommonFirstLabelBase.parskip}%
}%
{%
- Possible values of option \Option{parskip} (\emph{continuation})%
+ Available values of option \Option{parskip} (\emph{continuation})%
}%
% \begin{desctabular}
\entry{\PValue{false}, \PValue{off}, \PValue{no}%
- \IndexOption{parskip~=\PValue{false}}}{%
+ \IndexOption{parskip~=\textKValue{false}}}{%
paragraph indentation instead of vertical space; the last line of a
- paragraph may be arbitrarily filled}%
+ paragraph can be arbitrarily filled}%
\entry{\PValue{full}, \PValue{true}, \PValue{on}, \PValue{yes}%
- \IndexOption{parskip~=\PValue{full}}%
+ \IndexOption{parskip~=\textKValue{full}}%
}{%
one line vertical space between paragraphs; there must be at least
1\Unit{em} free space in the last line of a paragraph}%
\pventry{full-}{%
one line vertical space between paragraphs; the last line of a paragraph
- may be arbitrarily filled\IndexOption{parskip~=\PValue{full-}}}%
+ can be arbitrarily filled\IndexOption{parskip~=\textKValue{full-}}}%
\pventry{full+}{%
one line vertical space between paragraphs; there must be at least a third
- of a line free space at the end of a
- paragraph\IndexOption{parskip~=\PValue{full+}}}%
+ of a line of free space at the end of a
+ paragraph\IndexOption{parskip~=\textKValue{full+}}}%
\pventry{full*}{%
one line vertical space between paragraphs; there must be at least a
- quarter of a line free space at the end of a
- paragraph\IndexOption{parskip~=\PValue{full*}}}%
+ quarter of a line of free space at the end of a
+ paragraph\IndexOption{parskip~=\textKValue{full*}}}%
\pventry{half}{%
half a line vertical space between paragraphs; there must be at least
1\Unit{em} free space in the last line of a
- paragraph\IndexOption{parskip~=\PValue{half}}}%
+ paragraph\IndexOption{parskip~=\textKValue{half}}}%
\pventry{half-}{%
one line vertical space between
- paragraphs\IndexOption{parskip~=\PValue{half-}}}%
+ paragraphs\IndexOption{parskip~=\textKValue{half-}}}%
\pventry{half+}{%
half a line vertical space between paragraphs; there must be at least a
- third of a line free space at the end of a
- paragraph\IndexOption{parskip~=\PValue{half+}}}%
+ third of a line of free space at the end of a
+ paragraph\IndexOption{parskip~=\textKValue{half+}}}%
\pventry{half*}{%
half a line vertical space between paragraphs; there must be at least a
- quarter of a line free space at the end of a
- paragraph\IndexOption{parskip~=\PValue{half+}}}%
+ quarter of a line of free space at the end of a
+ paragraph\IndexOption{parskip~=\textKValue{half*}}}%
\pventry{never}{%
there%
\IfThisCommonLabelBase{maincls}{%
- \ChangedAt{v3.08}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}}%
+ \ChangedAt{v3.08}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
}{%
\IfThisCommonLabelBase{scrlttr2}{%
\ChangedAt{v3.08}{\Class{scrlttr2}}%
@@ -221,7 +236,7 @@ paragraph instead of paragraph spacing. All the possible values of option
will be no inter-paragraph spacing even if additional vertical spacing is
needed for the vertical adjustment with
\Macro{flushbottom}\IndexCmd{flushbottom}%
- \IndexOption{parskip~=\PValue{never}}}%
+ \IndexOption{parskip~=\textKValue{never}}}%
% \end{desctabular}
% \end{table}%
\end{desclist}%
@@ -229,17 +244,17 @@ paragraph instead of paragraph spacing. All the possible values of option
All\textnote{Attention!} eight \PValue{full} and \PValue{half} option values
also change the spacing before, after, and inside list environments. This
-avoids the problem of these environments or the paragraphs inside them having
-a larger separation than the separation between the paragraphs of normal text.%
+prevents these environments or the paragraphs inside them from having
+a larger separation than that between the paragraphs of normal text.%
\IfThisCommonLabelBase{maincls}{ %
Additionally, these options ensure that the table of contents and the lists
of figures and tables are set without any additional spacing.%
}{ %
- Several element of the first letter page will be set without inter-paragraph
- spacing always.%
+ Several elements of the letterhead are always set without inter-paragraph
+ spacing.%
}%
-The default behaviour of {\KOMAScript} follows
+The default\textnote{default} behaviour of \KOMAScript{} is
\OptionValue{parskip}{false}. In this case, there is no spacing between
paragraphs, only an indentation of the first line by 1\Unit{em}.%
%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-textmarkup.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-textmarkup.tex
index 9746ed6ee99..58dd710110a 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-textmarkup.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-textmarkup.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-textmarkup.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-textmarkup.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,11 +46,12 @@
% ======================================================================
\KOMAProvidesFile{common-textmarkup.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-21 10:37:34 +0100 (Wed, 21 Mar 2018) $
KOMA-Script guide (common paragraphs)]
-\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi}
+\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and
+ Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-02-06
\section{Text Markup}
\seclabel{textmarkup}%
@@ -59,46 +60,57 @@
\BeginIndex{}{font}%
\IfThisCommonFirstRun{}{%
- What is described in \autoref{sec:\ThisCommonFirstLabelBase.textmarkup}
- applies, mutatis mutandis. So if you have alread read and understood
- \autoref{sec:\ThisCommonFirstLabelBase.textmarkup.next} you can switch
- to \autopageref{sec:\ThisCommonLabelBase.textmarkup.next}.%
- \IfThisCommonLabelBaseOneOf{scrextend,scrjura,scrlayer-notecolumn}{}{ %
- But you should have a look at
+ The information in in \autoref{sec:\ThisCommonFirstLabelBase.textmarkup}
+ largely applies to this chapter. So if you have already read and understood
+ \autoref{sec:\ThisCommonFirstLabelBase.textmarkup.next}, you can
+ \IfThisCommonLabelBaseOneOf{scrextend,scrjura,scrlayer-notecolumn}{}{%
+ limit yourself to examining
\autoref{tab:\ThisCommonLabelBase.fontelements},
- \autopageref{tab:\ThisCommonLabelBase.fontelements}.%
- }%
+ \autopageref{tab:\ThisCommonLabelBase.fontelements} and then }%
+ skip ahead to \autoref{sec:\ThisCommonLabelBase.textmarkup.next},
+ \autopageref{sec:\ThisCommonLabelBase.textmarkup.next}.%
+ \IfThisCommonLabelBase{scrextend}{\ In this case, however,
+ note\textnote{limitation} that \Package{scrextend} supports only the
+ elements for the document title, the dictum, the footnotes, and the
+ \DescRef{maincls.env.labeling} environment. from
+ \autoref{tab:maincls.fontelements},
+ \autopageref{tab:maincls.fontelements}. Although the
+ \DescRef{maincls.fontelement.disposition} element exists,
+ \Package{scrextend} uses it only for the document title.%
+ }{}%
}
-{\LaTeX} offers different possibilities for logical and direct
-markup\Index{logical markup}\Index{markup} of text.
-Selection of the
-font family commands, as well as choosing the font size and width is
-supported. More information about the standard font facilities may be found at
-\cite{lshort}, \cite{latex:usrguide}, and \cite{latex:fntguide}.
-
+% Umbruchkorrektur
+\IfThisCommonLabelBase{scrlayer-scrpage}{}{%
+ {\LaTeX} offers different possibilities for logical and direct
+ markup\Index{logical markup}\Index{markup} of text. %
+ \IfThisCommonLabelBaseOneOf{scrlttr2}{}{%
+ In addition to the choice of the font, this includes commands for choosing
+ the font size and orientation. %
+ } For more information about the standard font facilities, see
+ \cite{lshort}, \cite{latex:usrguide}, and \cite{latex:fntguide}.}
\IfThisCommonLabelBaseOneOf{scrlayer-scrpage,scrjura,scrlayer-notecolumn}{%
\iffalse}{%
\csname iftrue\endcsname}%
\begin{Declaration}
- \Macro{textsuperscript}\Parameter{Text}%
- \Macro{textsubscript}\Parameter{Text}
+ \Macro{textsuperscript}\Parameter{text}%
+ \Macro{textsubscript}\Parameter{text}
\end{Declaration}
- The \LaTeX-Kern already defines the command
- \Macro{textsuperscript}\IndexCmd{textsuperscript} to
- superscript\Index{text>superscript}\Index{superscript} text. Unfortunately,
- until release 2015/01/01 {\LaTeX} itself does not offer a command to produce
- text in subscript\Index{text>subscript}\Index{subscript} instead of
- superscript\Index{text>superscript}\Index{superscript}. {\KOMAScript}
- defines \Macro{textsubscript} for this purpose. %
+ The \LaTeX{} kernel defines the command
+ \Macro{textsuperscript}\IndexCmd{textsuperscript} to put text in
+ superscript\Index{text>superscript}\Index{superscript}. Unfortunately,
+ \LaTeX{}\textnote{\Latex~2015/01/01} itself did not offer a command to
+ produce text in subscript\Index{text>subscript}\Index{subscript} until
+ release 2015/01/01. \KOMAScript{} defines \Macro{textsubscript} for this
+ purpose. %
\ifthiscommonfirst
\begin{Example}
\phantomsection
\xmpllabel{cmd.textsubscript}%
You are writing a text on human metabolism. From time to time you
have to give some simple chemical formulas in which the numbers are
- in subscript. For enabling logical markup you first define in the
+ in subscript. To allow for logical markup, you first define in the
document preamble or in a separate package:
\begin{lstcode}
\newcommand*{\molec}[2]{#1\textsubscript{#2}}
@@ -106,16 +118,16 @@ supported. More information about the standard font facilities may be found at
\newcommand*{\molec}[2]{#1\textsubscript{#2}}
Using this you then write:
\begin{lstcode}
- The cell produces its energy partly from reaction of \molec C6\molec
+ The cell produces its energy partly from the reaction of \molec C6\molec
H{12}\molec O6 and \molec O2 to produce \molec H2\Molec O{} and
- \molec C{}\molec O2. However, arsenic (\molec{As}{}) has a quite
+ \molec C{}\molec O2. However, arsenic (\molec{As}{}) has quite a
detrimental effect on the metabolism.
\end{lstcode}
The output looks as follows:
\begin{ShowOutput}
- The cell produces its energy from reaction of \molec C6\molec
+ The cell produces its energy partly from the reaction of \molec C6\molec
H{12}\molec O6 and \molec O2 to produce \molec H2\molec O{} and
- \molec C{}\molec O2. However, arsenic (\molec{As}{}) has a quite
+ \molec C{}\molec O2. However, arsenic (\molec{As}{}) has quite a
detrimental effect on the metabolism.
\end{ShowOutput}
@@ -129,30 +141,31 @@ supported. More information about the standard font facilities may be found at
\renewcommand*{\molec}[2]{\textsf{#1\textsubscript{#2}}}
Now the output in the whole document changes to:
\begin{ShowOutput}
- The cell produces its energy partly from reaction of \molec
+ The cell produces its energy partly from the reaction of \molec
C6\molec H{12}\molec O6 and \molec O2 to produce \molec H2\molec
O{} and \molec C{}\molec O2. However, arsenic (\molec{As}{}) has
- a quite detrimental effect on the metabolism.
+ quite a detrimental effect on the metabolism.
\end{ShowOutput}
\end{Example}
\iftrue
\begin{Explain}
- In the example above, the notation ``\verb|\molec C6|'' is used.
+ The example above uses the notation ``\verb|\molec C6|''.
This makes use of the fact that arguments consisting of only one
character do not have to be enclosed in parentheses. That is why
``\verb|\molec C6|'' is similar to ``\verb|\molec{C}{6}|''. You
- might already know this from indices or powers in mathematical
- environments, such as ``\verb|$x^2$|'' instead of ``\verb|$x^{2}$|''
+ may already be familiar with this notation from indices or powers in
+ mathematical environments, such as ``\verb|$x^2$|'' instead of
+ ``\verb|$x^{2}$|''
for ``$x^2$''.
\end{Explain}
\else % maybe some time I've made an English book
- Experts can find information about the reason why the example above does
- work unless putting all arguments of \Macro{molec} into braces in
+ Advanced users can find information about the reason the example above
+ does work unless you put all arguments of \Macro{molec} into braces in
\autoref{sec:experts.knowhow},
\DescPageRef{experts.macroargs}.%
- \fi
- \else
- You may find an example of usage at
+ \fi%
+ \else%
+ You can find an example that uses it in
\autoref{sec:\ThisCommonFirstLabelBase.textmarkup},
\PageRefxmpl{\ThisCommonFirstLabelBase.cmd.textsubscript}.
\fi%
@@ -165,58 +178,83 @@ supported. More information about the standard font facilities may be found at
\Macro{addtokomafont}\Parameter{element}\Parameter{commands}%
\Macro{usekomafont}\Parameter{element}
\end{Declaration}%
-With\ChangedAt{v2.8p}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} the help of the two commands \Macro{setkomafont} and
-\Macro{addtokomafont}, it is possible to define the \PName{commands} that
-change the characteristics of a given \PName{element}. Theoretically, all
-possible statements including literal text could be used as \PName{commands}.
-You should\textnote{Attention!}, however, absolutely limit yourself to those
-statements that really switch only one font attribute. This will usually be
-the commands \Macro{normalfont}, \Macro{rmfamily}, \Macro{sffamily},
-\Macro{ttfamily}, \Macro{mdseries}, \Macro{bfseries}, \Macro{upshape},
-\Macro{itshape}, \Macro{slshape}, and \Macro{scshape}, as well as the font
-size commands \Macro{Huge}, \Macro{huge}, \Macro{LARGE}, \Macro{Large},
-\Macro{large}, \Macro{normalsize}, \Macro{small}, \Macro{footnotesize},
-\Macro{scriptsize}, and \Macro{tiny}. The description of these commands can be
-found in \cite{lshort}, \cite{latex:usrguide}, or \cite{latex:fntguide}. Color
-switching commands like \Macro{normalcolor} (see \cite{package:graphics} and
-\cite{package:xcolor}) are also acceptable. The behavior when using other
-commands, especially those that make redefinitions or generate output, is not
-defined. Strange behavior is possible and does not represent a bug.
+With%
+\IfThisCommonLabelBase{maincls}{%
+ \ChangedAt{v2.8p}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+}{} the help of the \Macro{setkomafont} and \Macro{addtokomafont}
+commands, you can attach particular font styling \PName{commands} that change
+the appearance of a given \PName{element}. Theoretically, all statements,
+including literal text, can be used as \PName{commands}. You
+should\textnote{Attention!}, however, limit yourself to those statements that
+really change font attributes only. These are usually commands like
+\Macro{rmfamily}, \Macro{sffamily}, \Macro{ttfamily}, \Macro{upshape},
+\Macro{itshape}, \Macro{slshape}, \Macro{scshape}, \Macro{mdseries},
+\Macro{bfseries}, \Macro{normalfont}, as well as the font size commands
+\Macro{Huge}, \Macro{huge}, \Macro{LARGE}, \Macro{Large}, \Macro{large},
+\Macro{normalsize}, \Macro{small}, \Macro{footnotesize}, \Macro{scriptsize},
+and \Macro{tiny}. You can find these commands explained in \cite{lshort},
+\cite{latex:usrguide}, or \cite{latex:fntguide}. Colour switching commands
+like \Macro{normalcolor} (see \cite{package:graphics} and
+\cite{package:xcolor}) are also acceptable.%
+\iffalse % Umbruchkorrekturtext
+ \ The behaviour when using other commands, especially those that lead to
+ redefinitions or generate output, is undefined. Strange behaviour is possible
+ and does not represent a bug.
+\else
+ \ The use of other commands, in particular those that redefine things or
+ or lead to output, is not supported. Strange behaviour is possible in these
+ cases and does not represent a bug.
+\fi
-The command \Macro{setkomafont} provides a font switching command with a
-completely new definition. In contrast to this, the \Macro{addtokomafont}
-command merely extends an existing definition. It is recommended to not use
-both commands inside the document body, but only in the document preamble.
-Usage examples can be found in the paragraphs on the corresponding element.%
-\IfThisCommonLabelBaseOneOf{scrjura,scrlayer-notecolumn}{}{%
- \ Names\IfThisCommonLabelBase{scrlayer-scrpage}{, defaults,}{} and meanings
- of the individual items are listed in %
- \IfThisCommonLabelBase{scrextend}{%
+The command \Macro{setkomafont} provides an element with a completely new
+definition of its font styling. In contrast, the \Macro{addtokomafont} command
+merely extends an existing definition. You should not use either command
+inside the document body but only in the preamble. For examples of their use,
+refer to the sections for the respective element.%
+\IfThisCommonLabelBase{scrlayer-notecolumn}{}{%
+ \ The name and meaning of each element
+ \IfThisCommonLabelBaseOneOf{scrlayer-scrpage,scrjura}{, as well as their
+ defaults,}{} are listed in \IfThisCommonLabelBase{scrextend}{%
\autoref{tab:maincls.fontelements}, \autopageref{tab:maincls.fontelements}
}{%
\autoref{tab:\ThisCommonLabelBase.fontelements} %
}.%
\IfThisCommonLabelBase{scrextend}{ %
- However only the listed elements for the document title, dicta, footnotes,
- and the \DescRef{maincls.env.labeling} environment are supported. Though
- element \DescRef{maincls.fontelement.disposition} exists, it will also be
- used for the document title only. This has been done for compatibility
- with the \KOMAScript{} classes.%
- }{}%
- \IfThisCommonLabelBase{scrlayer-scrpage}{}{ %
- The default values are shown in the corresponding paragraphs.%
+ However, in \Package{scrextend} only\textnote{limitation} the listed
+ elements for the document title, dictum, footnotes, and the
+ \DescRef{maincls.env.labeling} environment are supported. Although the
+ \DescRef{maincls.fontelement.disposition} element exists,
+ \Package{scrextend} uses it only for the document title.%
+ }{%
+ \IfThisCommonLabelBase{scrlayer-scrpage}{ %
+ The specified defaults apply only if the corresponding element has not
+ already been defined before loading \Package{scrlayer-scrpage}. For
+ example, the \KOMAScript classes define
+ \DescRef{maincls.fontelement.pageheadfoot}, and then
+ \Package{scrlayer-scrpage} uses the setting it finds.%
+ }{%
+ \IfThisCommonLabelBase{scrjura}{}{ %
+ The default values can be found in the corresponding sections.%
+ }%
+ }%
}%
}%
-With command \Macro{usekomafont} the current font style may be changed into
-the font style of the selected \PName{element}.%
+\IfThisCommonLabelBaseOneOf{scrlttr2,scrextend}{% Umbruchvarianten
+ The \Macro{usekomafont} command can be used to switch the current font style
+ to the specified \PName{Element}.%
+}{%
+ With the \Macro{usekomafont} command, the current font style can be changed
+ to the one defined for the specified \PName{element}.%
+}
+
\IfThisCommonLabelBase{maincls}{\iftrue}{\csname iffalse\endcsname}
\begin{Example}
\phantomsection\xmpllabel{cmd.setkomafont}%
- Assume that you want to use for the element
- \DescRef{\ThisCommonLabelBase.fontelement.captionlabel} the same font
- specification that is used with
+ Suppose you want to use the same font specification for the element
+ \DescRef{\ThisCommonLabelBase.fontelement.captionlabel}
+ that is used with
\DescRef{\ThisCommonLabelBase.fontelement.descriptionlabel}. This can be
easily done with:
\begin{lstcode}
@@ -224,86 +262,92 @@ the font style of the selected \PName{element}.%
\usekomafont{descriptionlabel}%
}
\end{lstcode}
- You can find other examples in the paragraphs on each element.
+ You can find other examples in the explanation of each element.
\end{Example}
\begin{desclist}
\desccaption{%
- Elements whose type style can be changed with the {\KOMAScript} command
- \Macro{setkomafont} or
+ Elements whose font style can be changed in \Class{scrbook},
+ \Class{scrreprt} or \Class{scrartcl} with \Macro{setkomafont} and
\Macro{addtokomafont}%
\label{tab:maincls.fontelements}%
\label{tab:scrextend.fontelements}%
}{%
- Elements whose type style can be changed (\emph{continuation})%
+ Elements whose font style can be changed (\emph{continued})%
}%
\feentry{author}{%
\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}\and \Package{scrextend}}%
- author of the document on the main title, i.\,e., the argument of
+ author of the document in the title, i.\,e., the argument of
\DescRef{\ThisCommonLabelBase.cmd.author} when
- \DescRef{\ThisCommonLabelBase.cmd.maketitle} will be used (see
+ \DescRef{\ThisCommonLabelBase.cmd.maketitle} is used (see
\autoref{sec:maincls.titlepage}, \DescPageRef{maincls.cmd.author})}%
- \feentry{caption}{text of a table or figure caption (see
- \autoref{sec:maincls.floats}, \DescPageRef{maincls.cmd.caption})}%
- \feentry{captionlabel}{label of a table or figure caption; used according
- to the element \DescRef{\ThisCommonLabelBase.fontelement.caption} (see
+ \feentry{caption}{text of a figure or table caption (see
\autoref{sec:maincls.floats}, \DescPageRef{maincls.cmd.caption})}%
- \feentry{chapter}{title of the sectional unit
+ \feentry{captionlabel}{label of a figure or table caption; applied in
+ addition to the \DescRef{\ThisCommonLabelBase.fontelement.caption}
+ element (see \autoref{sec:maincls.floats},
+ \DescPageRef{maincls.cmd.caption})}%
+ \feentry{chapter}{title of the sectioning command
\DescRef{\ThisCommonLabelBase.cmd.chapter} (see
\autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.chapter})}%
\feentry{chapterentry}{%
- table of contents entry of the sectional unit
+ table of contents entry for the sectioning command
\DescRef{\ThisCommonLabelBase.cmd.chapter} (see
\autoref{sec:maincls.toc}, \DescPageRef{maincls.cmd.tableofcontents})}%
+ \feentry{chapterentrydots}{%
+ \ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}}%
+ optional points connecting table-of-content entries for the
+ \DescRef{\ThisCommonLabelBase.cmd.chapter} level, differing from the
+ \DescRef{\ThisCommonLabelBase.fontelement.chapterentrypagenumber}
+ element (see \autoref{sec:maincls.toc},
+ \DescPageRef{maincls.cmd.tableofcontents})}%
\feentry{chapterentrypagenumber}{%
- page number of the table of contents entry of the sectional unit
- \DescRef{\ThisCommonLabelBase.cmd.chapter}, variation on the element
+ page number of the table of contents entry for the sectioning command
+ \DescRef{\ThisCommonLabelBase.cmd.chapter}, differing from the element
\DescRef{\ThisCommonLabelBase.fontelement.chapterentry} (see
\autoref{sec:maincls.toc}, \DescPageRef{maincls.cmd.tableofcontents})}%
\feentry{chapterprefix}{%
- chapter number line at setting
- \OptionValueRef{maincls}{chapterprefix}{true} or
+ label, e.\,g., ``Chapter'', appearing before the chapter number in both
+ \OptionValueRef{maincls}{chapterprefix}{true} and
\OptionValueRef{maincls}{appendixprefix}{true} (see
\autoref{sec:maincls.structure},
\DescPageRef{maincls.option.chapterprefix})}%
\feentry{date}{%
\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}\and \Package{scrextend}}%
- date of the document on the main title, i.\,e., the argument of
+ date of the document in the main title, i.\,e., the argument of
\DescRef{\ThisCommonLabelBase.cmd.date} when
- \DescRef{\ThisCommonLabelBase.cmd.maketitle} will be used (see
+ \DescRef{\ThisCommonLabelBase.cmd.maketitle} is used (see
\autoref{sec:maincls.titlepage}, \DescPageRef{maincls.cmd.date})}%
\feentry{dedication}{%
\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}\and \Package{scrextend}}%
dedication page after the main title, i.\,e., the argument of
\DescRef{\ThisCommonLabelBase.cmd.dedication} when
- \DescRef{\ThisCommonLabelBase.cmd.maketitle} will be used (see
+ \DescRef{\ThisCommonLabelBase.cmd.maketitle} is used (see
\autoref{sec:maincls.titlepage}, \DescPageRef{maincls.cmd.dedication})}%
\feentry{descriptionlabel}{labels, i.\,e., the optional argument of
\DescRef{\ThisCommonLabelBase.cmd.item.description} in the
\DescRef{\ThisCommonLabelBase.env.description} environment (see
\autoref{sec:maincls.lists}, \DescPageRef{maincls.env.description})}%
- \feentry{dictum}{dictum, wise saying, or smart slogan (see
- \autoref{sec:maincls.dictum}, \DescPageRef{maincls.cmd.dictum})}%
- \feentry{dictumauthor}{author of a dictum, wise saying, or smart slogan;
- used according to the element
- \DescRef{\ThisCommonLabelBase.fontelement.dictum} (see
+ \feentry{dictum}{dictum or epigraph (see \autoref{sec:maincls.dictum},
+ \DescPageRef{maincls.cmd.dictum})}%
+ \feentry{dictumauthor}{author of a dictum or epigraph; applied in addition
+ to the element \DescRef{\ThisCommonLabelBase.fontelement.dictum} (see
\autoref{sec:maincls.dictum}, \DescPageRef{maincls.cmd.dictum})}%
- \feentry{dictumtext}{another name for
+ \feentry{dictumtext}{alternative name for
\DescRef{\ThisCommonLabelBase.fontelement.dictum}}%
- \feentry{disposition}{all sectional unit titles, i.\,e., the arguments of
- \DescRef{\ThisCommonLabelBase.cmd.part} down to
+ \feentry{disposition}{all sectioning command titles, i.\,e., the arguments
+ of \DescRef{\ThisCommonLabelBase.cmd.part} down to
\DescRef{\ThisCommonLabelBase.cmd.subparagraph} and
\DescRef{\ThisCommonLabelBase.cmd.minisec}, including the title of the
- abstract; used before the element of the corresponding unit (see
- \autoref{sec:maincls.structure} ab
- \autopageref{sec:maincls.structure})}%
+ abstract; applied before the element of the respective unit (see
+ \autoref{sec:maincls.structure}, \autopageref{sec:maincls.structure})}%
\feentry{footnote}{footnote text and marker (see
\autoref{sec:maincls.footnotes}, \DescPageRef{maincls.cmd.footnote})}%
- \feentry{footnotelabel}{mark of a footnote; used according to the element
- \DescRef{\ThisCommonLabelBase.fontelement.footnote} (see
+ \feentry{footnotelabel}{marker for a footnote; applied in addition to the
+ element \DescRef{\ThisCommonLabelBase.fontelement.footnote} (see
\autoref{sec:maincls.footnotes}, \DescPageRef{maincls.cmd.footnote})}%
\feentry{footnotereference}{footnote reference in the text (see
\autoref{sec:maincls.footnotes}, \DescPageRef{maincls.cmd.footnote})}%
@@ -317,8 +361,8 @@ the font style of the selected \PName{element}.%
\DescRef{\ThisCommonLabelBase.env.labeling} environment (see
\autoref{sec:maincls.lists}, \DescPageRef{maincls.env.labeling})}%
\feentry{labelingseparator}{separator, i.\,e., the optional argument of
- the \DescRef{\ThisCommonLabelBase.env.labeling} environment; used
- according to the element
+ the \DescRef{\ThisCommonLabelBase.env.labeling} environment; applied in
+ addition to the element
\DescRef{\ThisCommonLabelBase.fontelement.labelinglabel} (see
\autoref{sec:maincls.lists}, \DescPageRef{maincls.env.labeling})}%
\feentry{minisec}{title of \DescRef{\ThisCommonLabelBase.cmd.minisec} (see
@@ -326,68 +370,68 @@ the font style of the selected \PName{element}.%
\feentry{pagefoot}{only used if package \Package{scrlayer-scrpage} has
been loaded (see \autoref{cha:scrlayer-scrpage},
\DescPageRef{scrlayer-scrpage.fontelement.pagefoot})}%
- \feentry{pagehead}{another name for
+ \feentry{pagehead}{alternative name for
\DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}}%
- \feentry{pageheadfoot}{the head of a page, but also the foot of a page
- (see \autoref{sec:maincls.pagestyle} ab
+ \feentry{pageheadfoot}{the header and footer of a page (see
+ \autoref{sec:maincls.pagestyle} from
\autopageref{sec:maincls.pagestyle})}%
\feentry{pagenumber}{page number in the header or footer (see
\autoref{sec:maincls.pagestyle})}%
- \feentry{pagination}{another name for
+ \feentry{pagination}{alternative name for
\DescRef{\ThisCommonLabelBase.fontelement.pagenumber}}%
- \feentry{paragraph}{title of the sectional unit
+ \feentry{paragraph}{title of the sectioning command
\DescRef{\ThisCommonLabelBase.cmd.paragraph} (see
\autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.paragraph})}%
\feentry{part}{title of the \DescRef{\ThisCommonLabelBase.cmd.part}
- sectional unit, without the line containing the part number (see
+ sectioning command, without the line containing the part number (see
\autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.part})}%
\feentry{partentry}{%
- table of contents entry of the sectional unit
+ table of contents entry for the sectioning command
\DescRef{\ThisCommonLabelBase.cmd.part} (see \autoref{sec:maincls.toc},
\DescPageRef{maincls.cmd.tableofcontents})}%
\feentry{partentrypagenumber}{%
- Page number of the table of contents entry of the sectional unit
- \DescRef{\ThisCommonLabelBase.cmd.part} variation on the element
- \DescRef{\ThisCommonLabelBase.fontelement.partentry} (see
+ page number of the table of contents entry for the sectioning command
+ \DescRef{\ThisCommonLabelBase.cmd.part}; applied in addition to the
+ element \DescRef{\ThisCommonLabelBase.fontelement.partentry} (see
\autoref{sec:maincls.toc}, \DescPageRef{maincls.cmd.tableofcontents})}%
\feentry{partnumber}{line containing the part number in a title of the
- sectional unit \DescRef{\ThisCommonLabelBase.cmd.part} (see
+ sectioning command \DescRef{\ThisCommonLabelBase.cmd.part} (see
\autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.part})}%
\feentry{publishers}{%
\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}\and \Package{scrextend}}%
- publishers of the document on the main title, i.\,e., the argument of
+ publishers of the document in the main title, i.\,e., the argument of
\DescRef{\ThisCommonLabelBase.cmd.publishers} when
- \DescRef{\ThisCommonLabelBase.cmd.maketitle} will be used (see
+ \DescRef{\ThisCommonLabelBase.cmd.maketitle} is used (see
\autoref{sec:maincls.titlepage}, \DescPageRef{maincls.cmd.publishers})}%
- \feentry{section}{title of the sectional unit
+ \feentry{section}{title of the sectioning command
\DescRef{\ThisCommonLabelBase.cmd.section} (see
\autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.section})}%
\feentry{sectionentry}{%
- table of contents entry of sectional unit
+ table of contents entry for sectioning command
\DescRef{\ThisCommonLabelBase.cmd.section} (only available in
\Class{scrartcl}, see \autoref{sec:maincls.toc},
\DescPageRef{maincls.cmd.tableofcontents})}%
\feentry{sectionentrypagenumber}{%
- page number of the table of contents entry of the sectional unit
- \DescRef{\ThisCommonLabelBase.cmd.section}, variation on element
- \DescRef{\ThisCommonLabelBase.fontelement.sectionentry} (only available
- in \Class{scrartcl, see \autoref{sec:maincls.toc},
+ page number of the table of contents entry for the sectioning command
+ \DescRef{\ThisCommonLabelBase.cmd.section}; applied in addition to
+ element \DescRef{\ThisCommonLabelBase.fontelement.sectionentry} (only
+ available in \Class{scrartcl, see \autoref{sec:maincls.toc},
\DescPageRef{maincls.cmd.tableofcontents}})}%
- \feentry{sectioning}{another name for
+ \feentry{sectioning}{alternative name for
\DescRef{\ThisCommonLabelBase.fontelement.disposition}}%
\feentry{subject}{%
- categorization of the document, i.\,e., the argument of
+ topic of the document, i.\,e., the argument of
\DescRef{\ThisCommonLabelBase.cmd.subject} on the main title page (see
\autoref{sec:maincls.titlepage}, \DescPageRef{maincls.cmd.subject})}%
- \feentry{subparagraph}{title of the sectional unit
+ \feentry{subparagraph}{title of the sectioning command
\DescRef{\ThisCommonLabelBase.cmd.subparagraph} (see
\autoref{sec:maincls.structure},
\DescPageRef{maincls.cmd.subparagraph})}%
- \feentry{subsection}{title of the sectional unit
+ \feentry{subsection}{title of the sectioning command
\DescRef{\ThisCommonLabelBase.cmd.subsection} (see
\autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.subsection})}%
- \feentry{subsubsection}{title of the sectional unit
+ \feentry{subsubsection}{title of the sectioning command
\DescRef{\ThisCommonLabelBase.cmd.subsubsection} (see
\autoref{sec:maincls.structure},
\DescPageRef{maincls.cmd.subsubsection})}%
@@ -402,112 +446,122 @@ the font style of the selected \PName{element}.%
\feentry{titlehead}{%
\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}\and \Package{scrextend}}%
- head above the main title of the document, i.\,e., the argument of
+ heading above the main title of the document, i.\,e., the argument of
\DescRef{\ThisCommonLabelBase.cmd.titlehead} when
- \DescRef{\ThisCommonLabelBase.cmd.maketitle} will be used (see
+ \DescRef{\ThisCommonLabelBase.cmd.maketitle} is used (see
\autoref{sec:maincls.titlepage}, \DescPageRef{maincls.cmd.titlehead})}%
\end{desclist}
\else
\IfThisCommonLabelBase{scrextend}{\iftrue}{\csname iffalse\endcsname}
\begin{Example}
- Assumed, you want to print the document title in a serif font and with
- red colour. You may do this using:
+ Suppose you want to print the document title in a red serif font.
+ You can do this using:
\begin{lstcode}
\setkomafont{title}{\color{red}}
\end{lstcode}
- Package \Package{color} or \Package{xcolor} will be needed for command
- \Macro{color}\PParameter{red}. The additional usage of
- \Macro{normalfont} is not needed in this case, because it is already
- part of the definition of the title itself. This\textnote{Attention!}
- example also needs option
- \OptionValueRef{scrextend}{extendedfeature}{title} (see
+ You will need the \Package{color} or the \Package{xcolor} package for
+ the \Macro{color}\PParameter{red} command. Using \Macro{normalfont} is
+ unnecessary in this case because it is already part of the definition of
+ the title itself. This\textnote{Attention!} example also needs the
+ \OptionValueRef{scrextend}{extendedfeature}{title} option (see
\autoref{sec:scrextend.optionalFeatures},
\DescPageRef{scrextend.option.extendedfeature}).
\end{Example}
\else
\IfThisCommonLabelBase{scrlttr2}{%
- A general example for the usage of \Macro{setkomafont} and
- \Macro{usekomafont} may be found in \autoref{sec:maincls.textmarkup} at
+ You can find a general example that uses both \Macro{setkomafont} and
+ \Macro{usekomafont} in \autoref{sec:maincls.textmarkup} on
\PageRefxmpl{maincls.cmd.setkomafont}.
\begin{desclist}
\desccaption{%
- Alphabetical list of elements whose font can be changed in
- \Class{scrlttr2} using the commands \Macro{setkomafont} and
- \Macro{addtokomafont}\label{tab:scrlttr2.fontelements}%
+ Elements whose font style can be changed in the \Class{scrlttr2}
+ class or the \Package{scrletter} package with the
+ \Macro{setkomafont} and \Macro{addtokomafont}
+ commands\label{tab:scrlttr2.fontelements}%
}{%
- Elements whose font can be changed (\emph{continuation})%
+ Elements whose font style can be changed (\emph{continued})%
}%
- \feentry{addressee}{name und address in address field %
+ \feentry{addressee}{recipient's name and address in the address field
(\autoref{sec:scrlttr2.firstpage},
\DescPageRef{scrlttr2.option.addrfield})}%
\feentry{backaddress}{%
- return address for a window envelope %
+ return address for a window envelope
(\autoref{sec:scrlttr2.firstpage},
\DescPageRef{scrlttr2.option.backaddress})}%
\feentry{descriptionlabel}{%
- label, i.\,e., the optional argument of
+ label, i.\,e. the optional argument of
\DescRef{\ThisCommonLabelBase.cmd.item.description}, in a
- \DescRef{\ThisCommonLabelBase.env.description} environment %
+ \DescRef{\ThisCommonLabelBase.env.description} environment
(\autoref{sec:scrlttr2.lists},
\DescPageRef{scrlttr2.env.description})}%
\feentry{foldmark}{%
- foldmark on the letter page; intended for color settings %
+ fold mark on the letterhead page; allows change of line colour
(\autoref{sec:scrlttr2.firstpage},
\DescPageRef{scrlttr2.option.foldmarks})}%
\feentry{footnote}{%
- footnote text and marker %
- (see \autoref{sec:scrlttr2.footnotes},
+ footnote text and marker (\autoref{sec:scrlttr2.footnotes},
\DescPageRef{scrlttr2.cmd.footnote})}%
\feentry{footnotelabel}{%
- mark of a footnote; used according to the element
- \DescRef{\ThisCommonLabelBase.fontelement.footnote} %
- (see \autoref{sec:scrlttr2.footnotes},
+ footnote marker; applied in addition to the
+ \DescRef{\ThisCommonLabelBase.fontelement.footnote} element
+ (\autoref{sec:scrlttr2.footnotes},
\DescPageRef{scrlttr2.cmd.footnote})}%
\feentry{footnotereference}{%
- footnote reference in the text %
- (see \autoref{sec:scrlttr2.footnotes},
+ footnote reference in the text (\autoref{sec:scrlttr2.footnotes},
\DescPageRef{scrlttr2.cmd.footnote})}%
\feentry{footnoterule}{%
horizontal rule\ChangedAt{v3.07}{\Class{scrlttr2}} above the
- footnotes at the end of the text area %
- (see \autoref{sec:maincls.footnotes},
+ footnotes at the end of the text area
+ (\autoref{sec:maincls.footnotes},
\DescPageRef{maincls.cmd.setfootnoterule})}%
+ \feentry{fromaddress}{%
+ sender's address in the letterhead
+ (\autoref{sec:scrlttr2.firstpage},
+ \DescPageRef{scrlttr2.variable.fromaddress})}%
+ \feentry{fromname}{%
+ sender's name in the letterhead, not including
+ \PValue{fromaddress} (\autoref{sec:scrlttr2.firstpage},
+ \DescPageRef{scrlttr2.variable.fromname})}%
+ \feentry{fromrule}{%
+ horizontal rule in the letterhead; intended for
+ colour changes (\autoref{sec:scrlttr2.firstpage},
+ \DescPageRef{scrlttr2.option.fromrule})}%
\feentry{labelinglabel}{%
- labels, i.\,e., the optional argument of
+ labels, i.\,e. the optional argument of
\DescRef{\ThisCommonLabelBase.cmd.item.labeling} in the
\DescRef{\ThisCommonLabelBase.env.labeling} environment %
(see \autoref{sec:scrlttr2.lists},
\DescPageRef{scrlttr2.env.labeling})}%
\feentry{labelingseparator}{%
- separator, i.\,e., the optional argument of the
- \DescRef{\ThisCommonLabelBase.env.labeling} environment; used
- according to the element
- \DescRef{\ThisCommonLabelBase.fontelement.labelinglabel} %
+ separator, i.\,e. the optional argument of the
+ \DescRef{\ThisCommonLabelBase.env.labeling} environment; applied
+ in addition to the
+ \DescRef{\ThisCommonLabelBase.fontelement.labelinglabel} element
(see \autoref{sec:scrlttr2.lists},
\DescPageRef{scrlttr2.env.labeling})}%
\feentry{pagefoot}{%
- used after element
- \DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot} for the page
- foot, that has been defined with variable
- \DescRef{scrlttr2.variable.nextfoot}\IndexVariable{nextfoot}, or for
- the page foot of package \Package{scrlayer-scrpage} %
- (\autoref{cha:scrlayer-scrpage},
+ used after the
+ \DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot} element for
+ the footer defined with the
+ \DescRef{scrlttr2.variable.nextfoot}\IndexVariable{nextfoot}
+ variable, or for the footer of the \Package{scrlayer-scrpage}
+ package (\autoref{cha:scrlayer-scrpage},
\DescPageRef{scrlayer-scrpage.fontelement.pagefoot})}%
\feentry{pagehead}{%
- another name for
+ alternative name for
\DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}}%
\feentry{pageheadfoot}{%
- the head of a page, but also the foot of a page at all page style,
- that has been defined using \KOMAScript{} %
- (see \autoref{sec:scrlttr2.pagestyle},
- \DescPageRef{scrlttr2.fontelement.pageheadfoot})}%
+ the header and footer of a page for all page styles
+ that have been defined using \KOMAScript{}
+ (\autoref{sec:maincls.pagestyle},
+ \DescPageRef{\ThisCommonLabelBase.fontelement.pageheadfoot})}%
\feentry{pagenumber}{%
page number in the header or footer %
- (see \autoref{sec:scrlttr2.pagestyle},
- \DescPageRef{scrlttr2.fontelement.pagenumber})}%
+ (\autoref{sec:maincls.pagestyle},
+ \DescPageRef{\ThisCommonLabelBase.fontelement.pagenumber})}%
\feentry{pagination}{%
- another name for
+ alternative name for
\DescRef{\ThisCommonLabelBase.fontelement.pagenumber}}%
\feentry{placeanddate}{%
\ChangedAt{v3.12}{\Class{scrlttr2}}%
@@ -523,7 +577,7 @@ the font style of the selected \PName{element}.%
(\autoref{sec:scrlttr2.firstpage},
\DescPageRef{scrlttr2.variable.yourref})}%
\feentry{specialmail}{%
- mode of dispatch in the address field %
+ delivery type in the address field %
(\autoref{sec:scrlttr2.firstpage},
\DescPageRef{scrlttr2.variable.specialmail})}%
\feentry{lettersubject}{%
@@ -537,109 +591,154 @@ the font style of the selected \PName{element}.%
(\autoref{sec:scrlttr2.firstpage},
\DescPageRef{scrlttr2.variable.title})}%
\feentry{toaddress}{%
- variation of the element
- \DescRef{\ThisCommonLabelBase.fontelement.addressee} for setting the
- addressee address (less the name) in the address field %
- (\autoref{sec:scrlttr2.firstpage},
+ variation of the
+ \DescRef{\ThisCommonLabelBase.fontelement.addressee} element to
+ format the recipient's address, not including the name, in the
+ address field (\autoref{sec:scrlttr2.firstpage},
\DescPageRef{scrlttr2.variable.toaddress})}%
\feentry{toname}{%
- variation of the element
- \DescRef{\ThisCommonLabelBase.fontelement.addressee} for the name
- (only) of the addressee in the address field %
+ variation of the
+ \DescRef{\ThisCommonLabelBase.fontelement.addressee} element to
+ format the recipient's name in the address field
(\autoref{sec:scrlttr2.firstpage},
\DescPageRef{scrlttr2.variable.toname})}%
\end{desclist}
}{%
\IfThisCommonLabelBase{scrlayer-scrpage}{%
\begin{desclist}
- \desccaption[{Elements of \Package{scrlayer-scrpage} whose type
- style can be changed with \KOMAScript{} command
- \Macro{setkomafont} or \Macro{addtokomafont}}]%
- {Elements of \Package{scrlayer-scrpage} whose type style can be
- changed with \KOMAScript{} command \Macro{setkomafont} or
- \Macro{addtokomafont} and the default of those, if they have not
- been defined before loading \Package{scrlayer-scrpage}%
+ \desccaption[{Elements of \Package{scrlayer-scrpage} whose font
+ styles can be changed with the \Macro{setkomafont} and
+ \Macro{addtokomafont} commands}]%
+ {Elements of \Package{scrlayer-scrpage} whose font styles can be
+ changed with the \Macro{setkomafont} and \Macro{addtokomafont}
+ commands, and their defaults, if they have not been defined
+ before loading \Package{scrlayer-scrpage}%
\label{tab:scrlayer-scrpage.fontelements}%
}%
- {Elements whose type style can be changed (\emph{continuation})}%
+ {Elements whose font style can be changed (\emph{continued})}%
\feentry{footbotline}{%
- Horizontal line below the footer of a page style defined using
- \Package{scrlayer-scrpage}. The font will be used after
+ horizontal line below the footer of a page style defined using
+ \Package{scrlayer-scrpage}. The font will be applied after
\Macro{normalfont}\IndexCmd{normalfont} and the fonts of elements
\DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}%
\IndexFontElement{pageheadfoot} and
\DescRef{\ThisCommonLabelBase.fontelement.pagefoot}%
\IndexFontElement{pagefoot}. It is recommended to use this element
for colour changes only.\par
- Default: \emph{empty}%
+ \mbox{Default: \emph{empty}}%
}%
\feentry{footsepline}{%
- Horizontal line above the footer of a page style defined using
- \Package{scrlayer-scrpage}. The font will be used after
+ horizontal line above the footer of a page style defined using
+ \Package{scrlayer-scrpage}. The font will be applied after
\Macro{normalfont}\IndexCmd{normalfont} and the fonts of elements
\DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}%
\IndexFontElement{pageheadfoot} and
\DescRef{\ThisCommonLabelBase.fontelement.pagefoot}%
\IndexFontElement{pagefoot}. It is recommended to use this element
for colour changes only.\par
- Default: \emph{empty}%
+ \mbox{Default: \emph{empty}}%
}%
\feentry{headsepline}{%
- Horizontal line below the header of a page style defined using
- \Package{scrlayer-scrpage}. The font will be used after
+ horizontal line below the header of a page style defined using
+ \Package{scrlayer-scrpage}. The font will be applied after
\Macro{normalfont}\IndexCmd{normalfont} and the fonts of elements
\DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}%
\IndexFontElement{pageheadfoot} and
- \DescRef{\ThisCommonLabelBase.fontelement.pagehead}%
+ \DescRef{scrlayer-scrpage.fontelement.pagehead}%
\IndexFontElement{pagehead}. It is recommended to use this element
for colour changes only.\par
Default: \emph{empty}%
}%
\feentry{headtopline}{%
- Horizontal line above the header of a page style defined using
- \Package{scrlayer-scrpage}. The font will be used after
+ horizontal line above the header of a page style defined using
+ \Package{scrlayer-scrpage}. The font will be applied after
\Macro{normalfont}\IndexCmd{normalfont} and the fonts of elements
\DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}%
\IndexFontElement{pageheadfoot} and
- \DescRef{\ThisCommonLabelBase.fontelement.pagehead}%
+ \DescRef{scrlayer-scrpage.fontelement.pagehead}%
\IndexFontElement{pagehead}. It is recommended to use this element
for colour changes only.\par
- Default: \emph{empty}%
+ \mbox{Default: \emph{empty}}%
}%
\feentry{pagefoot}{%
- Contents of the page footer of a page style defined using
- \Package{scrlayer-scrpage}. The font will be used after
+ contents of the page footer of a page style defined using
+ \Package{scrlayer-scrpage}. The font will be applied after
\Macro{normalfont}\IndexCmd{normalfont} and the font of element
\DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}%
\IndexFontElement{pageheadfoot}.\par
- Default: \emph{empty}%
+ \mbox{Default: \emph{empty}}%
}%
\feentry{pagehead}{%
- Contents of the page header of a page style defined using
- \Package{scrlayer-scrpage}. The font will be used after
+ contents of the page header of a page style defined using
+ \Package{scrlayer-scrpage}. The font will be applied after
\Macro{normalfont}\IndexCmd{normalfont} and the font of element
\DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}%
\IndexFontElement{pageheadfoot}.\par
- Default: \emph{empty}%
+ \mbox{Default: \emph{empty}}%
}%
\feentry{pageheadfoot}{%
- Contents of the page header or footer of a page style defined
- using \Package{scrlayer-scrpage}. The font will be used after
+ contents of the page header or footer of a page style defined
+ using \Package{scrlayer-scrpage}. The font will be applied after
\Macro{normalfont}\IndexCmd{normalfont}.\par
- Default: \Macro{normalcolor}\Macro{slshape}%
+ \mbox{Default: \Macro{normalcolor}\Macro{slshape}}%
}%
\feentry{pagenumber}{%
- Pagination set with
+ pagination set with
\DescRef{\ThisCommonLabelBase.cmd.pagemark}. If you redefine
- \DescRef{\ThisCommonLabelBase.cmd.pagemark}, you have to take care
+ \DescRef{\ThisCommonLabelBase.cmd.pagemark}, you have to be sure
that your redefinition also uses
\Macro{usekomafont}\PParameter{pagenumber}!\par
- Default: \Macro{normalfont}%
+ \mbox{Default: \Macro{normalfont}}%
}%
\end{desclist}
}{%
- \IfThisCommonLabelBaseOneOf{scrjura,scrlayer-notecolumn}{}{%
- \InternalCommonFileUsageError%
+ \IfThisCommonLabelBase{scrjura}{%
+ \begin{table}
+ \caption{Elements whose \Package{scrjura} font styles can be
+ changed with \Macro{setkomafont} and \Macro{addtokomafont},
+ including their default settings}%
+ \label{tab:scrjura.fontelements}%
+ \begin{desctabular}
+ \feentry{Clause}{%
+ alias for \FontElement{\PName{environment name}.Clause}
+ within a contract environment, for example
+ \FontElement{contract.Clause} within
+ \DescRef{\ThisCommonLabelBase.env.contract}; if no
+ corresponding element is defined,
+ \FontElement{contract.Clause} is used%
+ }%
+ \feentry{contract.Clause}{%
+ heading of a paragraph within
+ \DescRef{\ThisCommonLabelBase.env.contract} (see
+ \autoref{sec:\ThisCommonLabelBase.contract},
+ \DescPageRef{\ThisCommonLabelBase.fontelement.contract.Clause});
+ \par
+ \mbox{Default: \Macro{sffamily}\Macro{bfseries}\Macro{large}}%
+ }%
+ \entry{\DescRef{\ThisCommonLabelBase.fontelement./Name/.Clause}}{%
+ \IndexFontElement[indexmain]{\PName{name}.Clause}%
+ heading of a paragraph within a \PName{name} environment
+ defined with
+ \DescRef{\ThisCommonLabelBase.cmd.DeclareNewJuraEnvironment}
+ as long as the setting was made with \Option{ClauseFont} or
+ the item was subsequently defined (see
+ \autoref{sec:\ThisCommonLabelBase.newenv},
+ \DescPageRef{\ThisCommonLabelBase.fontelement./Name/.Clause});
+ \par
+ \mbox{Default: \emph{none}}%
+ }%
+ \feentry{parnumber}{%
+ paragraph numbers within a contract environment (see
+ \autoref{sec:\ThisCommonLabelBase.par},
+ \DescPageRef{\ThisCommonLabelBase.fontelement.parnumber});\par
+ \mbox{Default: \emph{empty}}%
+ }%
+ \end{desctabular}
+ \end{table}
+ }{%
+ \IfThisCommonLabelBase{scrlayer-notecolumn}{}{%
+ \InternalCommonFileUsageError%
+ }%
}%
}%
}%
@@ -657,23 +756,34 @@ the font style of the selected \PName{element}.%
\Macro{useshapeofkomafont}\Parameter{element}
\end{Declaration}
Sometimes\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}\and \Package{scrextend}} and despite the recommendation
-users use the font setting feature of elements not only for font settings but
-for other settings too. In this case it may be useful to switch only to the
-font setting of an element but not to those other settings. You may use
-\Macro{usefontofkomafont} in such cases. This will activate the font size and
-baseline skip, the font encoding, the font family, the font series, and the
-font shape of an element, but no further settings as long as those further
-settings are local.
-
-You may also switch to one of those attributes only using one of the other
-commands. Note, that \Macro{usesizeofkomafont} will activate both, the font
-size and the baseline skip.
+ \Class{scrartcl}\and \Package{scrextend}}, although this is not recommended,
+the font setting of an element is used for settings that are not actually
+related to the font. If you want to apply only the font setting of an element
+but not those other settings, you can use \Macro{usefontofkomafont} instead of
+\DescRef{\ThisCommonLabelBase.cmd.usekomafont}. This will activate the font
+size and baseline skip, the font encoding, the font family, the font series,
+and the font shape of an element, but no further settings as long as those
+further settings are local.
-You should not misunderstand these commands as a legitimation of using all
-kind of commands at the font setting of an element. Hence this would result
-in errors sooner or later (see \autoref{sec:maincls-experts.experts},
-\DescPageRef{maincls-experts.cmd.addtokomafontrelaxlist}).%
+You can also switch to a single one of those attributes using one of the other
+commands. Note that \Macro{usesizeofkomafont} uses both the font
+size and the baseline skip.%
+%
+\IfThisCommonLabelBase{scrextend}{% Umbruchvariante!
+}{%
+ \IfThisCommonLabelBase{scrjura}{%
+ \par%
+ However, the misuse of the font settings is strongly discouraged (see
+ \autoref{sec:maincls-experts.experts},
+ \DescPageRef{maincls-experts.cmd.addtokomafontrelaxlist})!%
+ }{%
+ \par%
+ However, you should not take these commands as legitimizing the insertion
+ of arbitrary commands in an element's font setting. To do so can lead
+ quickly to errors (see \autoref{sec:maincls-experts.experts},
+ \DescPageRef{maincls-experts.cmd.addtokomafontrelaxlist}).%
+ }%
+}%
\EndIndexGroup
%
\EndIndexGroup
@@ -685,5 +795,3 @@ in errors sooner or later (see \autoref{sec:maincls-experts.experts},
%%% ispell-local-dictionary: "en_GB"
%%% TeX-master: "../guide"
%%% End:
-
-% LocalWords: mutatis mutandis
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-titles.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-titles.tex
index 5f178c218c5..e0617438062 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-titles.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-titles.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-titles.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-titles.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,88 +46,94 @@
% ======================================================================
\KOMAProvidesFile{common-titles.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (common paragraphs)]
-\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi}
+\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and
+ Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-01-30
\section{Document Titles}
\seclabel{titlepage}%
\BeginIndexGroup
\BeginIndex{}{title}%
-\BeginIndex{}{document>title}%
\IfThisCommonFirstRun{}{%
- What is written in \autoref{sec:\ThisCommonFirstLabelBase.titlepage}
- applies, mutatis mutandis. So if you have alread read and understood
- \autoref{sec:\ThisCommonFirstLabelBase.titlepage} you can jump to
- \autoref{sec:\ThisCommonLabelBase.titlepage.next} on
+ This information in \autoref{sec:\ThisCommonFirstLabelBase.titlepage}
+ largely applies to this chapter. So if you have already read and understood
+ \autoref{sec:\ThisCommonFirstLabelBase.titlepage}, you can skip to
+ \autoref{sec:\ThisCommonLabelBase.titlepage.next},
\autopageref{sec:\ThisCommonLabelBase.titlepage.next}.%
}%
\IfThisCommonLabelBase{scrextend}{\iftrue}{\csname iffalse\endcsname}%
- \ But there's a difference: The\textnote{Attention!} document title
- capabilities of \Package{scrextend} are part of the optional, advanced
+ \ However,\textnote{Attention!} the capabilities of \Package{scrextend}
+ for handling the document title are part of the optional, advanced
features. Therfore they are only available, if
- \OptionValueRef{\ThisCommonLabelBase}{extendedfeature}{title} has been
+ \OptionValueRef{\ThisCommonLabelBase}{extendedfeature}{title} is
selected while loading the package (see
\autoref{sec:\ThisCommonLabelBase.optionalFeatures},
\DescRef{\ThisCommonLabelBase.option.extendedfeature}).
- Beyond that \Package{scrextend} cannot be used with a \KOMAScript{}
- class together. Because of this
+ Furthermore, \Package{scrextend} cannot be used with a \KOMAScript{}
+ class. Because of this, you should replace
\begin{lstcode}
\documentclass{scrbook}
\end{lstcode}
- must be replaced by
+ with
\begin{lstcode}
\documentclass{book}
\usepackage[extendedfeature=title]{scrextend}
\end{lstcode}
- at all examples from \autoref{sec:maincls.titlepage}, if \Package{scrextend}
- should be used.
+ for all examples from \autoref{sec:maincls.titlepage}, if you want to
+ try them with \Package{scrextend}.
\fi
-In general we distinguish two kinds of document titles. First known are title
-pages. In this case the document title will be placed together with additional
-document information, like the author, on a page of its own. Besides the main
-title page, several further title pages may exist, like the half-title or
-bastard title, publisher data, dedication, or similar. The second known kind
-of document title is the in-page title. In this case, the document title is
-placed at the top of a page and specially emphasized, and may be accompanied
-by some additional information too, but it will be followed by more material
-in the same page, for instance by an abstract, or the table of contents, or
-even a section.
+In general, we distinguish two kinds of document titles. First, there are
+title pages. These include title of the document, together with additional
+information such as the author, on a separate page. In addition to the main
+title page, there may be several other title pages, such as the half-title or
+bastard title, publisher data, dedication, and so on. Second, there is the
+in-page title. This kind of title appears at the top of a new page, usually
+the first, and is specially emphasized. It too may be accompanied by
+additional information, but it will be followed by more material on the same
+page, for example by an abstract, the table of contents, or even a section.
\begin{Declaration}
\OptionVName{titlepage}{simple switch}%
\OptionValue{titlepage}{firstiscover}
+ \Macro{coverpagetopmargin}
+ \Macro{coverpageleftmargin}
+ \Macro{coverpagerightmargin}
+ \Macro{coverpagebottommargin}
\end{Declaration}%
-Using \DescRef{\ThisCommonLabelBase.cmd.maketitle} (see
-\DescPageRef{\ThisCommonLabelBase.cmd.maketitle}), this option%
-\IfThisCommonLabelBase{maincls}{%
- \ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}}%
-}{} switches between document title pages\Index{title>pages} and in-page
-title\Index{title>in-page}. For \PName{simple switch}, any value from
-\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} may be used.
-
-The option
-\OptionValue{titlepage}{true}\important{\OptionValue{titlepage}{true}}
-\IfThisCommonLabelBase{scrextend}{}{or \Option{titlepage} }makes {\LaTeX} use
-separate pages for the titles. Command
-\DescRef{\ThisCommonLabelBase.cmd.maketitle} sets these pages inside a
-\DescRef{\ThisCommonLabelBase.env.titlepage} environment and the pages
-normally have neither header nor footer. In comparison with standard {\LaTeX},
-{\KOMAScript} expands the handling of the titles significantly.
-
-The option
+This option\IfThisCommonLabelBase{maincls}{%
+ \ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+}{} determines whether to use document title pages\Index{title>pages} or
+in-page titles\Index{title>in-page} when using
+\DescRef{\ThisCommonLabelBase.cmd.maketitle} (see
+\DescPageRef{\ThisCommonLabelBase.cmd.maketitle}). Any value from
+\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} can be used
+for \PName{simple switch}.
+
+With the \OptionValue{titlepage}{true}%
+\important{\OptionValue{titlepage}{true}}
+\IfThisCommonLabelBase{scrextend}{}{or \Option{titlepage}} option,
+invoking \DescRef{\ThisCommonLabelBase.cmd.maketitle} creates titles on
+separate pages. These pages are set inside a
+\DescRef{\ThisCommonLabelBase.env.titlepage} environment, and they
+normally have neither header nor footer. Compared to standard {\LaTeX},
+{\KOMAScript} significantly expands the handling of the titles. These
+additional elements can be found on the following pages.
+
+In contrast, with the
\OptionValue{titlepage}{false}\important{\OptionValue{titlepage}{false}}
-specifies that an \emph{in-page} title is used. This means that the title is
-specially emphasized, but it may be followed by more material on the same
-page, for instance by an abstract or a section.%
+option, invoking \DescRef{\ThisCommonLabelBase.cmd.maketitle} creates an
+\emph{in-page} title. This means that the title is specially emphasized, but
+it may be followed by more material on the same page, for instance an abstract
+or a section.%
The third choice,%
\IfThisCommonLabelBase{maincls}{%
@@ -138,34 +144,27 @@ The third choice,%
\ChangedAt{v3.12}{\Package{scrextend}}%
}{\InternalCommonFileUseError}%
} \OptionValue{titlepage}{firstiscover}%
-\important{\OptionValue{titlepage}{firstiscover}} does not only select title
-pages. It additionally prints the first title page of
-\DescRef{\ThisCommonLabelBase.cmd.maketitle}\IndexCmd{maketitle}, this is
-either the extra title or the main title, as a cover\Index{cover} page. Every
-other setting of option \Option{titlepage} would cancel this setting. The
-margins\important{%
- \Macro{coverpagetopmargin}\\
- \Macro{coverpagebottommargin}\\
- \Macro{coverpageleftmargin}\\
- \Macro{coverpagerightmargin}} of the cover page are given by
-\Macro{coverpagetopmargin}\IndexCmd[indexmain]{coverpagetopmargin},
-\Macro{coverpagebottommargin}\IndexCmd[indexmain]{coverpagebottommargin},
-\Macro{coverpageleftmargin}\IndexCmd[indexmain]{coverpageleftmargin} und
-\Macro{coverpagerightmargin}\IndexCmd[indexmain]{coverpagerightmargin}. The
-defaults of these depend on the lengths
-\Length{topmargin}\IndexLength{topmargin} and
-\Length{evensidemargin}\IndexLength{evensidemargin} and can be changed using
-\Macro{renewcommand}.
+\important{\OptionValue{titlepage}{firstiscover}} not only activates title
+pages but also prints the first title page of
+\DescRef{\ThisCommonLabelBase.cmd.maketitle}\IndexCmd{maketitle}, i.\,e.
+either the half-title or the main title, as a cover\Index{cover} page. Any
+other setting of the \Option{titlepage} option will cancel this setting. The
+margins\important{\Macro{coverpage\dots margin}} of the cover page are given
+by \Macro{coverpagetopmargin}, \Macro{coverpageleftmargin},
+\Macro{coverpagerightmargin}, and \Macro{coverpagebottommargin}. The defaults
+of these depend on the lengths of \Length{topmargin}\IndexLength{topmargin}
+and \Length{evensidemargin}\IndexLength{evensidemargin} and can be changed
+with \Macro{renewcommand}.
\IfThisCommonLabelBase{maincls}{%
- The default of classes \Class{scrbook} and \Class{scrreprt} is usage of
- title pages. Class \Class{scrartcl}, on the other hand, uses in-page titles
- as default.%
+ The default of the \Class{scrbook} and \Class{scrreprt} classes is to use
+ title pages. The \Class{scrartcl} class, on the other hand, uses in-page
+ titles by default.%
}{%
\IfThisCommonLabelBase{scrextend}{%
- The default depends on the used class and \Package{scrextend} handles it
- compatible to the standard class. If a class does not set up a comparable
- default, in-page title will be used.%
+ The default depends on the class used and \Package{scrextend} recognizes
+ it in a way that compatible with the standard class. If a class does not
+ set up a comparable default, it will be an in-page title.%
}{\InternalCommonFileUsageError}%
}%
%
@@ -175,16 +174,16 @@ defaults of these depend on the lengths
\begin{Declaration}
\begin{Environment}{titlepage}\end{Environment}%
\end{Declaration}%
-With the standard classes and with {\KOMAScript}, all title pages are defined
-in a special environment, the \Environment{titlepage} environment. This
-environment always starts a new page\,---\,in the two-sided layout a new right
-page\,---\,and in single column mode. For this page, the style is changed by
-\DescRef{maincls.cmd.thispagestyle}\PParameter{empty}, so that
-neither page number nor running heading are output. At the end of the
-environment the page is automatically shipped out. Should you not be able to
-use the automatic layout of the title pages provided by
-\DescRef{\ThisCommonLabelBase.cmd.maketitle}, that will be described next; it
-is advisable to design a new one with the help of this environment.
+The standard classes and {\KOMAScript} set all title pages in a special
+environment: the \Environment{titlepage} environment. This environment always
+starts a new page\,---\,in two-sided printing a new right-hand page\,---\,and
+in single-column mode. For this page, the style is changed to
+\DescRef{maincls.cmd.thispagestyle}%
+\PParameter{\DescRef{maincls.pagestyle.empty}}, so that neither page number
+nor running head is output. At the end of the environment, the page is
+automatically shipped out. Should you not be able to use the automatic layout
+of the title pages provided by \DescRef{\ThisCommonLabelBase.cmd.maketitle},
+described next, you should design a new one with the help of this environment.
\IfThisCommonFirstRun{\iftrue}{%
A simple example for a title page with \Environment{titlepage} is shown in
@@ -194,7 +193,7 @@ is advisable to design a new one with the help of this environment.
}%
\begin{Example}
\phantomsection\xmpllabel{env.titlepage}
- Assume you want a title page on which only the word ``Me'' stands at
+ Suppose you want a title page on which only the word ``Me'' stands at
the top on the left, as large as possible and in bold\,---\,no
author, no date, nothing else. The following document creates just
that:
@@ -215,71 +214,79 @@ is advisable to design a new one with the help of this environment.
\begin{Declaration}
\Macro{maketitle}\OParameter{page number}
\end{Declaration}%
-While the the standard classes produce at least one title page that may have
-the three items title, author, and date, with {\KOMAScript} the
-\Macro{maketitle} command can produce up to six pages. In contrast to the
-standard classes, the \Macro{maketitle} macro in {\KOMAScript} accepts an
-optional numeric argument. If it is used, this number is made the page number
-of the first title page. However, this page number is not output, but affects
-only the numbering. You should choose an odd number, because otherwise the
-whole count gets mixed up. In my opinion there are only two meaningful
-applications for the optional argument. On the one hand, one could give to the
-half-title\Index[indexmain]{half-title} the logical page number \(-\)1 in
-order to give the full title page the number 1. On the other hand, it could be
-used to start at a higher page number, for instance, 3, 5, or 7, to
+While\textnote{\KOMAScript{} vs. standard classes} the standard classes
+produce at most one title page that can have three items (title, author, and
+date), with \KOMAScript{} \Macro{maketitle} can produce up to six pages. In
+contrast to the standard classes, \Macro{maketitle} in {\KOMAScript} accepts
+an optional numeric argument. If it is used, this number is the page number of
+the first title page. This page number is not output, but it affects the
+subsequent numbering. You should definitely choose an odd number, because
+otherwise the whole count gets mixed up. In my opinion, there are only two
+useful applications for the optional argument. On the one hand, you could give
+the the logical page number -1 to the half-title\Index[indexmain]{half-title}
+in order to give the full title page the number 1. On the other hand, you
+could use it to start at a higher page number, for example, 3, 5, or 7, to
accommodate other title pages added by the publishing house. The optional
-argument is ignored for \emph{in-page} titles. However, the page style of such
-a title page can be changed by redefining the
-\DescRef{\ThisCommonLabelBase.cmd.titlepagestyle} macro. For that see
-\autoref{sec:maincls.pagestyle}, \DescPageRef{maincls.cmd.titlepagestyle}.
-
-The following commands do not lead immediately to the ship-out of the
-titles. The typesetting and ship-out of the title pages are always done by
-\Macro{maketitle}. By the way, you should note that \Macro{maketitle} should
-not be used inside a \DescRef{\ThisCommonLabelBase.env.titlepage}
-environment. Like\textnote{Attention!} shown in the examples, one should use
-either \Macro{maketitle} or \DescRef{\ThisCommonLabelBase.env.titlepage} only,
-but not both.
-
-The commands explained below only define the contents of the title
-pages. Because of this, they have to be used before \Macro{maketitle}. It is,
-however, not necessary and, when using, e.\,g., the \Package{babel}
-package\IndexPackage{babel}, not recommended to use these in the preamble
-before \Macro{begin}\PParameter{document} (see \cite{package:babel}). Examples
-can be found at the end of this section.
+argument is ignored for \emph{in-page} titles. You can change the page style
+of such a title page by redefining the
+\DescRef{\ThisCommonLabelBase.cmd.titlepagestyle} macro (see
+\autoref{sec:maincls.pagestyle}, \DescPageRef{maincls.cmd.titlepagestyle}).
+
+The following commands do not lead immediately to the ship-out of the titles.
+The typesetting and ship-out of the title pages are always done by
+\Macro{maketitle}. Note also that \Macro{maketitle} should not be used inside
+a \DescRef{\ThisCommonLabelBase.env.titlepage} environment.
+As\textnote{Attention!} shown in the examples, you should use either
+\Macro{maketitle} or \DescRef{\ThisCommonLabelBase.env.titlepage}, but not
+both.
+
+The following commands only define the contents of the title. Therefore they
+must be used before \Macro{maketitle}. It is, however, not necessary and, when
+using the \Package{babel} package\IndexPackage{babel} not recommended, to
+include these in the preamble before \Macro{begin}\PParameter{document} (see
+\cite{package:babel}). You can find examples
+\IfThisCommonFirstRun{in the descriptions of the other commands in this
+ section}{in \autoref{sec:\ThisCommonFirstLabelBase.titlepage}, starting on
+ \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.extratitle}}.
\begin{Declaration}
\Macro{extratitle}\Parameter{half-title}
+ \Macro{frontispiece}\Parameter{frontispiece}
\end{Declaration}%
\begin{Explain}%
- In earlier times the inner book was often not protected from dirt by a cover.
- This task was then taken over by the first page of the book which
- carried mostly a shortened title called the \emph{half-title}.
- Nowadays the extra page is often applied before the real full title
- and contains information about the publisher, series number and similar
- information.
+ In earlier times the inner book was often not protected from dirt by a
+ cover. This function was then assumed by the first page of the book, which
+ usually had just a short title, known as the \emph{half-title}. Nowadays the
+ extra page often appears before the real main title and contains information
+ about the publisher, series number, and similar information.
\end{Explain}
-With {\KOMAScript} it is possible to include a page before the real title
-page. The \PName{half-title} can be arbitrary text\,---\,even several
-paragraphs. The contents of the \PName {half-title} are output by
-{\KOMAScript} without additional formatting. Their organisation is completely
-left to the user. The back of the half-title remains empty. The half-title
-has its own title page even when \emph{in-page} titles are used. The output of
-the half-title defined with \Macro{extratitle} takes place as part of the
-titles produced by \DescRef{\ThisCommonLabelBase.cmd.maketitle}.
+With {\KOMAScript}, it is possible to include a page before the real title
+page. The \PName{half-title} can be arbitrary text\,---\,even several
+paragraphs. The contents of the \PName{half-title} are output by {\KOMAScript}
+without additional formatting. Their organisation is completely left to the
+user. The verso of the half-title\IfThisCommonLabelBase{maincls}{%
+ \ChangedAt{v3.25}{\Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}}%
+}{%
+ \IfThisCommonLabelBase{scrextend}{%
+ \ChangedAt{v3.25}{\Package{scrextend}}%
+ }{\ThisCommonLabelBaseFailure}%
+} is the frontispiece. The half-title is set on its own page even when in-page
+titles are used. The output of the half-title defined with \Macro{extratitle}
+takes place as part of the title produced by
+\DescRef{\ThisCommonLabelBase.cmd.maketitle}.
\IfThisCommonFirstRun{\iftrue}{%
- A simple example for a title page with extra title and main title is shown
+ An example of a simple title page with half-title and main title is shown
in \autoref{sec:\ThisCommonFirstLabelBase.titlepage} on
\PageRefxmpl{\ThisCommonFirstLabelBase.cmd.extratitle}%
\csname iffalse\endcsname%
}%
\begin{Example}
\phantomsection\xmpllabel{cmd.extratitle}
- Let's go back to the previous example and assume
- that the spartan ``Me'' is the half-title. The full title should
- still follow the half-title. One can proceed as follows:
+ Let's return to the previous example and suppose
+ that the Spartan ``Me'' is the half-title. The full title should
+ still follow the half-title. You can proceed as follows:
\begin{lstcode}
\documentclass{scrbook}
\begin{document}
@@ -288,7 +295,7 @@ titles produced by \DescRef{\ThisCommonLabelBase.cmd.maketitle}.
\maketitle
\end{document}
\end{lstcode}
- You can center the half-title horizontally and put it a little lower down
+ You can centre the half-title horizontally and put it a little lower down
the page:
\begin{lstcode}
\documentclass{scrbook}
@@ -318,84 +325,101 @@ titles produced by \DescRef{\ThisCommonLabelBase.cmd.maketitle}.
\Macro{and}%
\Macro{thanks}\Parameter{footnote}
\end{Declaration}%
-The contents of the full title page are defined by seven elements. The output
-of the full title page occurs as part of the title pages of
-\DescRef{\ThisCommonLabelBase.cmd.maketitle}, whereas the now listed elements
-only define the corresponding elements.
-
-\BeginIndexGroup
-\BeginIndex{FontElement}{titlehead}\LabelFontElement{titlehead}%
-The\important{\Macro{titlehead}} \PName{title
- head}\Index[indexmain]{title>head} is defined with the command
-\Macro{titlehead}. It is typeset with the font of the homonymous element in
-regular justification and full width at the top of the page. It can be freely
-designed by the user.%
+There are seven elements available for the content of the main title page. The
+main title page is output as part of the title pages created by
+\DescRef{\ThisCommonLabelBase.cmd.maketitle}, while the definitions given here
+only apply to the respective elements.
+
+\BeginIndexGroup\BeginIndex{FontElement}{titlehead}%
+\LabelFontElement{titlehead}%
+The\important{\Macro{titlehead}} \PName{title head}%
+\Index[indexmain]{title>head} is defined with the command
+\Macro{titlehead}. It occupies the entire text width, at the top of the page,
+in normal justification, and it can be freely designed by the user. It uses
+the font element\important{\FontElement{titlehead}} with same name (see
+\autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
+\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup
-\BeginIndexGroup
-\BeginIndex{FontElement}{subject}\LabelFontElement{subject}%
+\BeginIndexGroup\BeginIndex{FontElement}{subject}\LabelFontElement{subject}%
The\important{\Macro{subject}} \PName{subject}\Index[indexmain]{subject} is
-output with the font of the homonymous element immediately above the
-\PName{title}.%
+output with the font element\important{\FontElement{subject}} of the same name
+immediately above the \PName{title}.%
\EndIndexGroup
-\BeginIndexGroup
-\BeginIndex{FontElement}{title}\LabelFontElement{title}%
-The\important{\Macro{title}} \PName{title} is output with a very large font
-size. Beside\IfThisCommonLabelBase{maincls}{%
+\BeginIndexGroup\BeginIndex{FontElement}{title}\LabelFontElement{title}%
+The\important{\Macro{title}} \PName{title} is set in a very large font size.
+Along\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v2.8p}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}}}{} all other element the font size\textnote{Attention!}
-is, however, not affected by the font switching element \FontElement{title}
-(see \autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
+ \Class{scrartcl}}}{} with the font size, the font element
+\FontElement{title}\IndexFontElement[indexmain]{title}%
+\important{\FontElement{title}} is applied (see
+\autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup
-\BeginIndexGroup
-\BeginIndex{FontElement}{subtitle}\LabelFontElement{subtitle}%
+\BeginIndexGroup\BeginIndex{FontElement}{subtitle}\LabelFontElement{subtitle}%
The\important{\Macro{subtitle}}
\PName{subtitle}\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v2.97c}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}}}{} is output with the font of the homonymous element
-just below the title.%
+ \Class{scrartcl}}}{} is set just below the title using the font
+element\important{\FontElement{subtitle}} of the same name (see
+\autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
+\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup
-\BeginIndexGroup
-\BeginIndex{FontElement}{author}\LabelFontElement{author}%
+\BeginIndexGroup\BeginIndex{FontElement}{author}\LabelFontElement{author}%
Below\important{\Macro{author}} the \PName{subtitle} appears the
-\PName{author}\Index[indexmain]{author}. Several authors can be specified in
-the argument of \Macro{author}. They should be separated by \Macro{and}. The
-font of element \FontElement{author} is used for the output of the authors.%
+\PName{author}\Index[indexmain]{author}. Several authors can be specified in
+the argument of \Macro{author}. They should be separated by
+\Macro{and}\important{\Macro{and}}. The output uses the font
+element\important{\FontElement{author}} of the same name. (see
+\autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
+\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup
-\BeginIndexGroup
-\BeginIndex{FontElement}{date}\LabelFontElement{date}%
+\BeginIndexGroup\BeginIndex{FontElement}{date}\LabelFontElement{date}%
Below\important{\Macro{date}} the author or authors appears the
-date\Index{date} in the font of the homonymous element. The default value is
-the present date, as produced by \Macro{today}\IndexCmd{today}. The
+date\Index{date} in the font of the element of the same name. The default
+value is the current date, as produced by \Macro{today}\IndexCmd{today}. The
\Macro{date} command accepts arbitrary information\,---\,even an empty
-argument.%
+argument. The output uses the font element\important{\FontElement{date}} of
+the same name (see \autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
+\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup
-\BeginIndexGroup
-\BeginIndex{FontElement}{publishers}\LabelFontElement{publishers}%
+\BeginIndexGroup\BeginIndex{FontElement}{publishers}%
+\LabelFontElement{publishers}%
Finally\important{\Macro{publishers}} comes the
\PName{publisher}\Index[indexmain]{publisher}. Of course this command can also
-be used for any other information of little importance. If necessary, the
+be used for any other information of minor importance. If necessary, the
\Macro{parbox} command can be used to typeset this information over the full
-page width like a regular paragraph instead of centering it. Then it is to be
-considered equivalent to the title head. However, note that this field is put
-above any existing footnotes. The font of element \FontElement{publishers} is
-used for the output.%
+page width like a regular paragraph instead of centring it. It should then be
+considered equivalent to the title head. Note, however, that this field is
+placed above any existing footnotes. The output uses the font
+element\important{\FontElement{publishers}} of the same name (see
+\autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
+\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup
Footnotes\important{\Macro{thanks}}\Index{footnotes} on the title page are
produced not with \Macro{footnote}, but with \Macro{thanks}. They serve
typically for notes associated with the authors. Symbols are used as footnote
-markers instead of numbers. Note\textnote{Attention!}, that \Macro{thanks} has
-to be used inside the argument of another command, e.\,g., at the argument
-\PName{author} of the command \Macro{author}.
-
-While%
+markers instead of numbers. Note\textnote{Attention!} that \Macro{thanks} has
+to be used inside the argument of another command, such as in the
+\PName{author} argument of the command \Macro{author}.
+\IfThisCommonLabelBase{scrextend}{%
+ However, in order for the \DescRef{\ThisCommonLabelBase.fontelement.footnote}
+ element to be aware of the \Package{scrextend} package, not only does the
+ title extension need to be enabled, it must also be set to use footnotes
+ with this package (see the introduction to
+ \autoref{sec:\ThisCommonLabelBase.footnotes},
+ \autopageref{sec:\ThisCommonLabelBase.footnotes}). Otherwise, the font
+ specified by the class or other packages used for the footnotes will be
+ used.%
+}{}%
+
+For%
\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
@@ -403,104 +427,118 @@ While%
\IfThisCommonLabelBase{scrextend}{%
\ChangedAt{v3.12}{\Package{scrextend}}%
}{\InternalCommonFileUsageError}%
-} printing the title elements the equal named font switching elements will be
-used for all them. The defaults, that may be found in
-\autoref{tab:\ThisCommonFirstLabelBase.titlefonts}, %
-\IfThisCommonFirstRun{}{%
- \autopageref{tab:\ThisCommonFirstLabelBase.titlefonts}, %
-}%
-may be changed using the commands
-\DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
-\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (see
+} the output of the title elements, the font\textnote{font} can be set using
+the \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
+\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} command (see
\autoref{sec:\ThisCommonLabelBase.textmarkup},
-\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}).%
+\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}). The defaults are listed
+in \autoref{tab:\ThisCommonFirstLabelBase.titlefonts}%
+\IfThisCommonFirstRun{}{%
+ , \autopageref{tab:\ThisCommonFirstLabelBase.titlefonts}%
+}.%
\IfThisCommonFirstRun{%
\begin{table}
% \centering
+% \caption
\KOMAoptions{captions=topbeside}%
\setcapindent{0pt}%
-% \caption
+% \addtokomafont{caption}{\raggedright}%
\begin{captionbeside}
[{Font defaults for the elements of the title}]
{\label{tab:\ThisCommonLabelBase.titlefonts}%
- Font defaults for the elements of the title}
+ \hspace{0pt plus 1ex}Font defaults for the elements of the title}
[l]
\begin{tabular}[t]{ll}
\toprule
Element name & Default \\
\midrule
- \DescRef{\ThisCommonLabelBase.fontelement.author} & \Macro{Large} \\
- \DescRef{\ThisCommonLabelBase.fontelement.date} & \Macro{Large} \\
- \DescRef{\ThisCommonLabelBase.fontelement.dedication} & \Macro{Large} \\
- \DescRef{\ThisCommonLabelBase.fontelement.publishers} & \Macro{Large} \\
- \DescRef{\ThisCommonLabelBase.fontelement.subject} &
- \Macro{normalfont}\Macro{normalcolor}\Macro{bfseries}\Macro{Large} \\
- \DescRef{\ThisCommonLabelBase.fontelement.subtitle} &
- \Macro{usekomafont}\PParameter{title}\Macro{large} \\
- \DescRef{\ThisCommonLabelBase.fontelement.title} & \Macro{usekomafont}\PParameter{disposition} \\
- \DescRef{\ThisCommonLabelBase.fontelement.titlehead} & \\
+ \FontElement{author} & \Macro{Large} \\
+ \FontElement{date} & \Macro{Large} \\
+ \FontElement{dedication} & \Macro{Large} \\
+ \FontElement{publishers} & \Macro{Large} \\
+ \FontElement{subject} &
+ \Macro{normalfont}\Macro{normalcolor}%
+ \Macro{bfseries}\Macro{Large} \\
+ \FontElement{subtitle} &
+ \DescRef{\ThisCommonLabelBase.cmd.usekomafont}%
+ \PParameter{title}\Macro{large} \\
+ \FontElement{title} &
+ \DescRef{\ThisCommonLabelBase.cmd.usekomafont}%
+ \PParameter{disposition} \\
+ \FontElement{titlehead} & \\
\bottomrule
\end{tabular}
\end{captionbeside}
\end{table}%
-}{}
-
-With the exception of \PName{titlehead} and possible footnotes, all
-the items are centered horizontally. The information is summarised in
-\autoref{tab:\ThisCommonFirstLabelBase.mainTitle}%
-\IfThisCommonFirstRun{}{%
- , \autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}}.
+}{}%
+
+With the exception of \PName{title head} and any footnotes, all output is
+centred horizontally. %
+\iffree{%
+ \IfThisCommonLabelBase{scrextend}{The formatting of each element is}{These
+ details are} briefly summarized in
+ \autoref{tab:\ThisCommonFirstLabelBase.mainTitle}\IfThisCommonFirstRun{}{%
+ , \autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}}.%
+}{%
+ \IfThisCommonLabelBase{scrextend}{%
+ The alignment of individual elements can also be found in
+ \autoref{tab:\ThisCommonFirstLabelBase.mainTitle}\IfThisCommonFirstRun{}{%
+ , \autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}}.%
+ }{%
+ For a summary, see \autoref{tab:\ThisCommonFirstLabelBase.mainTitle}.%
+ }%
+}%
\IfThisCommonFirstRun{%
\begin{table}
-% \centering
+ % \centering
\KOMAoptions{captions=topbeside}%
\setcapindent{0pt}%
% \caption
\begin{captionbeside}[Main title]{%
- Font and horizontal positioning of the
- elements in the main title page in the order of their vertical
- position from top to bottom when typeset with
- \DescRef{\ThisCommonLabelBase.cmd.maketitle}}
+ \hspace{0pt plus 1ex}%
+ Font and horizontal positioning of the elements in the main title page
+ in the order of their vertical position from top to bottom when
+ typeset with \DescRef{\ThisCommonLabelBase.cmd.maketitle}}
[l]
\setlength{\tabcolsep}{.85\tabcolsep}% Umbruchoptimierung
\begin{tabular}[t]{llll}
\toprule
- Element & Command & Font & Orientation \\
+ Element & Command & Font & Alignment \\
\midrule
Title head & \Macro{titlehead} & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{titlehead} & justified \\
- Subject & \Macro{subject} & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{subject} & centered \\
- Title & \Macro{title} & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{title}\Macro{huge} & centered \\
- Subtitle & \Macro{subtitle} & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{subtitle} & centered \\
- Authors & \Macro{author} & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{author} & centered \\
- Date & \Macro{date} & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{date} & centered \\
- Publishers & \Macro{publishers} & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{publishers} & centered \\
+ Subject & \Macro{subject} & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{subject} & centred \\
+ Title & \Macro{title} & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{title}\Macro{huge} & centred \\
+ Subtitle & \Macro{subtitle} & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{subtitle} & centred \\
+ Authors & \Macro{author} & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{author} & centred \\
+ Date & \Macro{date} & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{date} & centred \\
+ Publishers & \Macro{publishers} & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{publishers} & centred \\
\bottomrule
\end{tabular}
\end{captionbeside}
\label{tab:maincls.mainTitle}
\end{table}
-}{} %
-Please note\textnote{Attention!}, that for the main title \Macro{huge} will be
-used after the font switching element
+}{}
+
+Note\textnote{Attention!} that for the main title, \Macro{huge} will be used
+after the font switching element
\DescRef{\ThisCommonLabelBase.fontelement.title}\IndexFontElement{title}. So
you cannot change the size of the main title using
\DescRef{\ThisCommonLabelBase.cmd.setkomafont} or
\DescRef{\ThisCommonLabelBase.cmd.addtokomafont}.%
\IfThisCommonFirstRun{\iftrue}{%
- An example for a title page with all elements provided by \KOMAScript{} for
- the main title page is shown in
- \autoref{sec:\ThisCommonFirstLabelBase.titlepage} on
+ An example for a title page using all the elements offered by \KOMAScript{}
+ is shown in \autoref{sec:\ThisCommonFirstLabelBase.titlepage} on
\PageRefxmpl{\ThisCommonFirstLabelBase.maintitle}.%
\csname iffalse\endcsname%
}%
\begin{Example}
\phantomsection\xmpllabel{maintitle}%
- Assume you are writing a dissertation. The title page should have the
+ Suppose you are writing a dissertation. The title page should have the
university's name and address at the top, flush left, and the semester,
- flush right. As usual, a title is to be used, including author and
- delivery date. The adviser must also be indicated, together with the fact
- that the document is a dissertation. This can be obtained as follows:
+ flush right. As usual, a title including author and submission date
+ should be given. The adviser must also be indicated, together with the
+ fact that the document is a dissertation. You can do this as follows:
\begin{lstcode}
\documentclass{scrbook}
\usepackage[english]{babel}
@@ -523,30 +561,31 @@ you cannot change the size of the main title using
\fi
\begin{Explain}
- A frequent misunderstanding concerns the role of the full title page. It is
- often erroneously assumed that the cover\Index{cover} or dust cover is
- meant. Therefore, it is frequently expected that the title page does not
- follow the normal page layout, but has equally large left and right margins.
-
- However, if one takes a book and opens it, one notices very quickly at least
- one title page under the cover within the so-called inner book. Precisely
+ A common misconception concerns the function of the full title page. It is
+ often erroneously assumed to be the cover\Index{cover} or dust jacket.
+ Therefore, it is frequently expected that the title page will not follow the
+ normal layout for two-sided typesetting but will have equally large left and
+ right margins.
+
+ But if you pick up a book and open it, you will quickly find at least one
+ title page inside the cover, within the so-called book block. Precisely
these title pages are produced by
\DescRef{\ThisCommonLabelBase.cmd.maketitle}.
- As is the case with the half-title, the full title page belongs to the inner
- book, and therefore should have the same page layout as the rest of the
- document. A cover is actually something that should be created in a
- separate document. The cover often has a very individual format. It can also
- be designed with the help of a graphics or DTP program. A separate document
- should also be used because the cover will be printed on a different medium,
- possibly cardboard, and possibly with another printer.
-
- Nevertheless, since \KOMAScript~3.12 the first title page of
- \DescRef{\ThisCommonLabelBase.cmd.maketitle} can be printed as a cover page
- with different margins. For more information about this see the description
- of option
+ As is the case with the half-title, the full title page belongs to the book
+ block, and therefore should have the same page layout as the rest of the
+ document. A cover is actually something that you should create in a
+ separate document. After all, it often has a very distinct format. It can
+ also be designed with the help of a graphics or DTP program. A separate
+ document should also be used because the cover will be printed on a
+ different medium, such as cardboard, and possibly with another printer.
+
+ Nevertheless, since \KOMAScript~3.12 the first title page issued by
+ \DescRef{\ThisCommonLabelBase.cmd.maketitle} can be formatted as a cover
+ page with different margins. Changes to the margins on this page do not
+ affect the other margins. For more information about this option, see
\OptionValueRef{\ThisCommonLabelBase}{titlepage}{firstiscover}%
- \IndexOption{titlepage~=\PValue{firstiscover}} on
+ \IndexOption{titlepage~=\textKValue{firstiscover}} on
\DescPageRef{\ThisCommonLabelBase.option.titlepage}.
\end{Explain}
%
@@ -557,15 +596,15 @@ you cannot change the size of the main title using
\Macro{uppertitleback}\Parameter{titlebackhead}%
\Macro{lowertitleback}\Parameter{titlebackfoot}
\end{Declaration}%
-With the standard classes, the back of the title page of a double-side print
-is left empty. However, with {\KOMAScript} the back of the full title page
-can be used for other information. Exactly two elements which the user can
-freely format are recognized: \PName
-{titlebackhead}\Index{title>back}\Index{title>rear side}\Index{title>flipside}
-and \PName {titlebackfoot}. The head can reach up to the foot and vice
-versa. \iffree{If one takes this manual as an example, the exclusion of
- liability was set with the help of the \Macro{uppertitleback} command.}{The
- publishers information of this book. e.\,g., could have been set either with
+In\textnote{\KOMAScript{} vs. standard classes} two-sided printing, the
+standard classes leave the back (verso) of the title page empty. However, with
+{\KOMAScript} the back of the full title page can be used for other
+information. There are exactly two elements which the user can freely format:
+\PName{titlebackhead}\Index{title>back}\Index{title>verso} and
+\PName{titlebackfoot}. The header can extend to the footer and vice versa.
+\iffree{Using this guide as an example, the legal disclaimer was set with the
+ help of the \Macro{uppertitleback} command.}{The publishers information of
+ this book, for example, could have been set either with
\Macro{uppertitleback} or \Macro{lowertitleback}.}%
%
\EndIndexGroup
@@ -574,18 +613,27 @@ versa. \iffree{If one takes this manual as an example, the exclusion of
\begin{Declaration}
\Macro{dedication}\Parameter{dedication}
\end{Declaration}%
-\BeginIndexGroup
-\BeginIndex{FontElement}{dedication}\LabelFontElement{dedication}%
-{\KOMAScript} provides a page for dedications. The
-dedication\Index{dedication} is centered and uses a slightly larger type size
-given by the font of the homonymous element. The font can be changed using
-command \DescRef{\ThisCommonLabelBase.cmd.setkomafont} or
-\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (see
+{\KOMAScript} offers its own dedication page. This
+dedication\Index{dedication} is centred and set by default with a slightly
+larger font\textnote{font}.
+\BeginIndexGroup\BeginIndex{FontElement}{dedication}%
+\LabelFontElement{dedication}
+The%
+\IfThisCommonLabelBase{maincls}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+}{%
+ \IfThisCommonLabelBase{scrextend}{%
+ \ChangedAt{v3.12}{\Package{scrextend}}%
+ }{\InternalCommonFileUseError}%
+}\important{\FontElement{dedication}} exact font setting for the
+\FontElement{dedication} element, which is taken from
+\autoref{tab:\ThisCommonFirstLabelBase.titlefonts},
+\autopageref{tab:\ThisCommonFirstLabelBase.titlefonts}, can be changed with
+the \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
+\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} commands (see
\autoref{sec:\ThisCommonLabelBase.textmarkup},
-\autopageref{sec:\ThisCommonLabelBase.textmarkup}). The back is empty like
-the back page of the half-title. The dedication page is produced by
-\DescRef{\ThisCommonLabelBase.cmd.maketitle} and must therefore be defined
-before this command is issued.%
+\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}).%
\EndIndexGroup
\IfThisCommonFirstRun{\iftrue}{%
@@ -596,8 +644,8 @@ before this command is issued.%
}%
\begin{Example}
\phantomsection\xmpllabel{fulltitle}%
- This time assume that you have written a poetry book and you want to
- dedicate it to your wife. A solution would look like this:
+ Suppose you have written a book of poetry and want to
+ dedicate it to your spouse. A solution would look like this:
\begin{lstcode}
\documentclass{scrbook}
\usepackage[english]{babel}
@@ -608,14 +656,14 @@ before this command is issued.%
\date{1412}
\lowertitleback{This poem book was set with%
the help of {\KOMAScript} and {\LaTeX}}
- \uppertitleback{Selfmockery Publishers}
- \dedication{To my treasure hazel-hen\\
+ \uppertitleback{Self-mockery Publishers}
+ \dedication{To my treasured hazel-hen\\
in eternal love\\
from your dormouse.}
\maketitle
\end{document}
\end{lstcode}
- Please use your own favorite pet names.
+ Please use your own favourite pet names to personalize it.
\end{Example}%
\fi%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-typearea.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-typearea.tex
index 0ca2f88ad3f..30b89d03311 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-typearea.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-typearea.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-typearea.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-typearea.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,40 +46,43 @@
% ======================================================================
\KOMAProvidesFile{common-typearea.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (common paragraphs: typearea)]
-\translator{Markus Kohm\and Krickette Murabayashi}
+\translator{Markus Kohm\and Krickette Murabayashi\and Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-02-01
\section{Page Layout}
\seclabel{typearea}
\BeginIndexGroup
\BeginIndex{}{page>layout}
-Each page of a document is separated into several different layout elements,
-e.\,g., margins, head, foot, text area, margin note column, and the distances
-between all these elements. \KOMAScript{} additionally distinguishes the page
-as a whole also known as the paper and the viewable area of the page. Without
-doubt, the separation of the page into the several parts is one of the basic
-features of a class. Nevertheless at \KOMAScript{} the classes delegate that
-business to the package \Package{typearea}. This package may be used with other
-classes too. In difference to those other classes the \KOMAScript{} classes
-load \Package{typearea} on their own. Because of this, there's no need to load
-the package explicitly with \Macro{usepackage} while using a \KOMAScript{}
-class. Nor would this make sense or be useful. See also
-\autoref{sec:\csname label@base\endcsname.options}.
+Each page of a document consists of different layout elements, such as the
+margins, the header, the footer, the text area, the marginal note column, and
+the distances between these elements. \KOMAScript{} additionally distinguishes
+the entire page, also known as the paper, and the visible page. Without doubt,
+the separation of the page into these different parts is one of the basic
+features of a class\IfThisCommonLabelBase{scrlttr2}{\OnlyAt{scrlttr2}}{}.
+\KOMAScript{} delegates this work to the package \Package{typearea}. This
+package can also be used with other classes. The \KOMAScript{} classes,
+however, load \Package{typearea} on their own. Therefore, it's neither
+necessary nor sensible to load the package explicitly with \Macro{usepackage}
+while using a \KOMAScript{} class. See also
+\autoref{sec:\ThisCommonLabelBase.options},
+\autopageref{sec:\ThisCommonLabelBase.options}.
-Some settings of \KOMAScript{} classes do influence the page layout. Those
-effects will be documented at the corresponding settings.
+Some settings of \KOMAScript{} classes affect the page layout and vice versa.
+Those effects are documented at the corresponding settings.
-For more information about page size, separation of pages into margins and
-type area, and about selection of one or two column typesetting see the
-documentation of package \Package{typearea}. You may find it at
-\autoref{cha:typearea} from \autopageref{cha:typearea} onwards.
+For more information about the choice of paper format, the division of the
+page into margins and type area, and the choice between one- and two-column
+typesetting, see the documentation for the \Package{typearea} package. You can
+find it in \autoref{cha:typearea}, starting on \autopageref{cha:typearea}.
%%% Local Variables:
%%% mode: latex
+%%% mode: flyspell
%%% coding: us-ascii
+%%% ispell-local-dictionary: "en_GB"
%%% TeX-master: "../guide"
%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/expertpart.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/expertpart.tex
index a2d84d41846..60dd17e9b3a 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/expertpart.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/expertpart.tex
@@ -1,6 +1,6 @@
% ======================================================================
% expertpart.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% expertpart.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,20 +46,20 @@
% ======================================================================
\KOMAProvidesFile{expertpart.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-02-28 13:23:23 +0100 (Wed, 28 Feb 2018) $
Part KOMA-Script for Experts]
-\translator{Markus Kohm}
+\translator{Markus Kohm\and Karl Hagen}
\setpartpreamble{%
\vspace*{2\baselineskip}%
\setlength{\parindent}{1em}%
- \noindent In this part information for the authors of LaTeX packages and
- classes can be found. This applies not only instructions that are useful for
- implementation of new packages and classes, but also interfaces to allow
- further intervention in \KOMAScript. Moreover, in this part, information on
- obsolete options and instructions are provided as well as background
- information on the implementation of KOMAScript.
+ \noindent In this part, you can find information for the authors of LaTeX
+ packages and classes. This applies not only to commands that are useful for
+ implementing new packages and classes, but also to interfaces that allow
+ further alteration of \KOMAScript{}. Moreover, this part provides
+ information on obsolete options and instructions, as well as background
+ information on the implementation of \KOMAScript{}.
This part is intended to supplement the information for authors of articles,
reports, books and letters in \autoref{part:forAuthors}. More information
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/guide-english.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/guide-english.tex
index 7f9529ea7a3..edebaee2b9d 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/guide-english.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/guide-english.tex
@@ -1,6 +1,6 @@
% ======================================================================
% guide-english.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% guide-english.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
%
\KOMAProvidesFile{guide-english.tex}
- [$Date: 2017-08-08 18:17:31 +0200 (Tue, 08 Aug 2017) $
+ [$Date: 2018-03-21 10:37:34 +0100 (Wed, 21 Mar 2018) $
KOMA-Script guide language dependencies]
%
% \section{Extra Packages}
@@ -73,7 +73,7 @@
\vfill
\noindent Note: This document is a translation of the German \KOMAScript{}
manual. Several authors have been involved to this translation. Some of them
- are native English speakers, others like me are not. Improvements of the
+ are native English speakers. Others, like me, are not. Improvements of the
translation by native speakers or experts are welcome at all times!%
}%
\newcommand*{\GuideAuthorHeadline}{Authors of the {\KOMAScript} Bundle}%
@@ -81,7 +81,7 @@
} \newcommand*{\GuideWarrantyHeadline}{Legal Notes:}%
\newcommand*{\GuideWarranty}{There is no warranty for any part of the
documented software. The authors have taken care in the preparation of this
- book, but make no expressed or implied warranty of any kind and assume no
+ guide, but make no expressed or implied warranty of any kind and assume no
responsibility for errors or omissions. No liability is assumed for
incidental or consequential damages in connection with or arising out of the
use of the information or programs contained here.\par\medskip%
@@ -93,11 +93,11 @@
paragraph and page breaks\par\medskip%
This guide is part of {\KOMAScript}, which is free under the terms and
conditions of {\LaTeX} Project Public License Version 1.3c. A version of
- this license, which is valid to {\KOMAScript}, is part of {\KOMAScript} (see
+ this license, which is valid for {\KOMAScript}, is part of {\KOMAScript} (see
\File{lppl.txt}). Distribution of this manual\,---\,even if it is
printed\,---\,is allowed provided that all parts of {\KOMAScript} are
- distributed. Distribution without the other parts of {\KOMAScript} needs an
- explicit, additional authorization by the authors.}%
+ distributed with it. Distribution without the other parts of {\KOMAScript}
+ requires an explicit, additional authorization by the authors.}%
\newcommand*{\GuideDedication}{To all my friends all over the world!}%
% \end{macrocode}
% \end{macro}
@@ -331,8 +331,8 @@
% Note, that the non free manual contains more information.
% \begin{macrocode}
\newcommand*{\GuideLoadNonFree}{%
- Sorry, currently additional information to this may be found at the same
- point of the German \KOMAScript{} book \cite{book:komascript} only.
+ Currently, additional information on this topic can be found at the same
+ point in the German \KOMAScript{} book \cite{book:komascript} only.
}
% \end{macrocode}
% \end{macro}
@@ -354,14 +354,14 @@
% The titles and short titles of each single index.
\newcommand*{\GuidegenIndex}{General Index}%
\newcommand*{\GuidecmdIndex}{Index of Commands, Environments, and Variables}%
-\newcommand*{\GuidecmdIndexShort}{Index of Commands etc.}%
+\newcommand*{\GuidecmdIndexShort}{Index of Commands, etc.}%
\newcommand*{\GuidelenIndex}{Index of Lengths and Counters}%
-\newcommand*{\GuidelenIndexShort}{Index of Lengths etc.}%
-\newcommand*{\GuideelmIndex}{Index of Elements with Capability of
- Font Adjustment}%
+\newcommand*{\GuidelenIndexShort}{Index of Lengths, etc.}%
+\newcommand*{\GuideelmIndex}{Index of Elements Capable of
+ Adjusting Fonts}%
\newcommand*{\GuideelmIndexShort}{Index of Elements}%
\newcommand*{\GuidefilIndex}{Index of Files, Classes, and Packages}%
-\newcommand*{\GuidefilIndexShort}{Index of Files etc.}%
+\newcommand*{\GuidefilIndexShort}{Index of Files, etc.}%
\newcommand*{\GuideoptIndex}{Index of Class and Package Options}%
\newcommand*{\GuideoptIndexShort}{Index of Options}%
% \end{macro}
@@ -379,9 +379,9 @@
% \begin{macro}{\GuideIndexPreamble}
% The preamble text of the whole index.
\newcommand*{\GuideIndexPreamble}{%
- There are two kinds of page numbers at this index. The bold printed numbers
- show the pages of declaration or explanation of the topic. The normal
- printed numbers show the pages of using a topic.%
+ There are two kinds of page numbers in this index. The numbers in bold
+ show the pages where the topic is defined or explained. The numbers in
+ ordinary type show the pages of where the topic is mentioned.%
}
% \end{macro}
%
@@ -403,21 +403,20 @@
% \begin{macro}{\GuideBibPreamble}
% \begin{macrocode}
\newcommand*{\GuideBibPreamble}{%
- In the following you can find many references. All of them are referenced
- from the main text. In many cases the reference points to documents or
- directories which can be accessed via Internet. In these cases the
- reference includes a URL instead of a publisher. If the reference points to
+ In the following, you will find many references. All of them are referenced
+ in the main text. In many cases the reference points to documents or
+ directories which can be accessed via the Internet. In these cases, the
+ reference includes a URL instead of a publisher. If the reference points to
a {\LaTeX} package then the URL is written in the form
``\url{CTAN://}\emph{destination}''. The prefix ``\url{CTAN://}'' means the
- \TeX{} archive on a CTAN server or mirror. For example, you can substitute
- the prefix with \url{http://mirror.ctan.org/}. For {\LaTeX}
- packages it is also important to mention that we have tried to give a
- version number appropriate to the text that cites the reference. But for
- some packages is is very difficult to find a consistent version number and
- release date. Additionally the given version is not always the current
- version. If you want install new packages take care that the package is the
- most up-to-date version and check first whether the package is already
- available on your system or not.%
+ \TeX{} archive on a CTAN server or mirror. For example, you can replace the
+ prefix with \url{http://mirror.ctan.org/}. For {\LaTeX} packages, it is also
+ important to mention that we have tried to give a version number appropriate
+ to the text that cites the reference. But for some packages is is very
+ difficult to find a consistent version number and release date.
+ Additionally, the given version is not always the current version. If you
+ want install new packages, be sure that the package is the most up-to-date
+ version and check first if the package is already available on your system.%
}
% \end{macrocode}
% \end{macro}
@@ -429,12 +428,11 @@
% The preamble of the change log index.
% \begin{macrocode}
\newcommand*{\GuideChangeLogPreamble}{%
- At this list of changes you will find all significant changes of the user
+ In this list of changes, you will find all significant changes to the user
interface of the {\KOMAScript} bundle at the last few versions. The list was
- sorted about the names of the classes and packages and their version. The
- numbers behind the versions are the pages, where the changes are
- described. At the margins of these pages you will find corresponding version
- marks.%
+ sorted by the names of the classes and packages and their version. The
+ numbers after the version are the pages where the changes are described. In
+ the margins of these pages, you will find corresponding version marks.%
}
% \end{macrocode}
% \end{macro}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/guide.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/guide.tex
index e22f7c8e590..7386ccba9c7 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/guide.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/guide.tex
@@ -1,6 +1,6 @@
% ======================================================================
% guide.tex
-% Copyright (c) Markus Kohm, 2002-2015
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% guide.tex
-% Copyright (c) Markus Kohm, 2002-2015
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -48,7 +48,7 @@
\documentclass[\languagename]{scrguide}
\KOMAProvidesFile{guide.tex}
- [$Date: 2015-04-21 10:08:26 +0200 (Tue, 21 Apr 2015) $
+ [$Date: 2018-02-07 13:47:54 +0100 (Wed, 07 Feb 2018) $
KOMA-Script (guide main file)]
\begin{document}
@@ -72,8 +72,8 @@
\dedication{\GuideDedication}
\pdfbookmark[-1]{\KOMAScript}{title}
-\bookmark[level=0,gotor=scrguide.pdf]{Deutsch}
-\bookmark[level=0,gotor=scrguien.pdf]{English}
+\iffree{\bookmark[level=0,gotor=scrguide.pdf]{Deutsch}
+\bookmark[level=0,gotor=scrguien.pdf]{English}}{}
\bookmarksetup{startatroot}
\maketitle
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/introduction.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/introduction.tex
index c3383f83345..2d556d09737 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/introduction.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/introduction.tex
@@ -1,6 +1,6 @@
% ======================================================================
% introduction.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% introduction.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,107 +46,102 @@
% ======================================================================
\KOMAProvidesFile{introduction.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide introduction]
\translator{Kevin Pfeiffer\and Gernot Hassenpflug\and
- Krickette Murabayashi\and Markus Kohm}
+ Krickette Murabayashi\and Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-02-05
\chapter{Introduction}
\labelbase{introduction}
-This chapter includes important information about the structure of the manual
-and the history of KOMA-Script, which begins years before the first
-version. You will also find information for those who have not installed
-KOMA-Script or encounter errors.
+This chapter contains, among other things, important information about the
+structure of the manual and the history of {\KOMAScript}, which begins
+years before the first version. You will also find information on how to
+install {\KOMAScript} and what to do if you encounter errors.
\section{Preface}\seclabel{preface}
-\KOMAScript{} is very complex. This is evidenced by the fact that it
-consists of
-not only a single class or a single package, but a bundle of many classes and
-packages. Although the classes are designed as a counterpart to the standard
-classes, that does not necessarily mean that they only have the commands,
-environments, and setting of the standard classes or imitate their
-appearance. The capabilities of \KOMAScript{} surpass the capabilities of the
-standard classes considerably. Some of them are to be regarded as a supplement
-to the basic skills of the \LaTeX{} kernel.
-
-The foregoing means that the documentation of \KOMAScript{} has to be
-extensive. In addition, \KOMAScript{} usually is not taught. That means there
-is no teacher who knows his students and can therefore choose the teaching and
-learning materials and adapt them accordingly. It would be easy to write the
-documentation for any specific audience. The difficulty is, however, that the
-guide must service all potential audiences. We, the authors, have tried to
-create a guide that is suited for the computer scientist as well as the
-secretary or the fishmonger. We have tried, although this is actually % dealing
-% with
-an impossible task. The result consists of several compromises and we
-hope that you will keep this in mind when using it. Your suggestions for
-improvement are, of course, always welcome.
-
-Despite the volume of the manual, % in case of problems
-it is recommended to
-consult the documentation. Attention is drawn to the multi-part index at the
-end of this document. In addition to this guide, documentation includes all the
-text documents that are part of the bundle. See \File{manifest.tex} for a list
-of all of them.
-
+{\KOMAScript} is very complex. This is due to the fact that it consists of not
+just a single class or a single package but a bundle of many classes and
+packages. Although the classes are designed as counterparts to the standard
+classes, that does not mean they provide only the commands, environments, and
+settings of the standard classes, or that they imitate their appearance. The
+capabilities of {\KOMAScript} sometimes far surpass those of the standard
+classes. Some of them should be considered extensions to the basic
+capabilities of the \LaTeX{} kernel.
+
+The foregoing means that the documentation of {\KOMAScript} has to be
+extensive. In addition, {\KOMAScript} is not normally taught. That means there
+are no teachers who know their students and can therefore choose the teaching
+materials and adapt them accordingly. It would be easy to write documentation
+for a specific audience. The difficulty facing the author, however, is that
+the manual must serve all potential audiences. I have tried to create a guide
+that is equally suitable for the computer scientist and the fishmonger's
+secretary. I have tried, although this is actually an impossible task. The
+result is numerous compromises, and I would ask you to take this issue into
+account if you have any complaints or suggestions to help improve the current
+situation.
+
+Despite the length of this manual, I would ask you to consult the
+documentation first in case you have problems. You should start by referring
+to the multi-part index at the end of this document. In addition to this
+manual, documentation includes all the text documents that are part of the
+bundle. See \File{manifest.tex} for a complete list.
\section{Structure of the Guide}\seclabel{structure}
-This manual consists of several parts. There's a part for average users,
-another part for advanced users and experts, and an appendix with additional
-examples and information for those who always want to know more.
-
-\hyperref[part:forAuthors]{Part~\ref{part:forAuthors}} is recommended for all
-\KOMAScript{} users. This means that you may find here even some information
-for newcomers to \LaTeX. In particular, this part is enhanced by many examples
-to the average user that are intended to illustrate the explanations. Do not
-be afraid to try these examples yourself and in modifying them to find out how
-\KOMAScript{} works. Nevertheless the {\KOMAScript} user guide is not intended
-to be a {\LaTeX} primer. Those new to {\LaTeX} should look at \emph{The Not
- So Short Introduction to {\LaTeXe}} \cite{lshort} or \emph{{\LaTeXe} for
- Authors} \cite{latex:usrguide} or a {\LaTeX} reference book. You will also
-find useful information in the many {\LaTeX} FAQs, including the \emph{{\TeX}
- Frequently Asked Questions on the Web} \cite{UK:FAQ}.
-Although the length of the \emph{{\TeX} Frequently Asked Questions
-on the Web} is considerably long, it is nevertheless
-quite useful not only to those having problems using \LaTeX{} or \KOMAScript.
-
-\hyperref[part:forExperts]{Part~\ref{part:forExperts}} is recommended for
-advanced \KOMAScript{} users. These are all of you who already know
-\LaTeX{}, maybe worked with \KOMAScript{} for a while, and want to
-learn more about \KOMAScript{} internals, interaction of \KOMAScript{}
-with other packages, and how to use \KOMAScript{} as an answer to
-special demands. For this purpose we will have a closer look at some
-aspects from \autoref{part:forAuthors} again. In addition some
-instructions that have been implemented for advanced users and
-experts, especially, will be documented. This is complemented by the
-documentation of packages that are normally hidden to the user insofar
-as they do their work under the surface of the classes and user
-packages. These packages are specifically designed to be used by other
-authors of classes and packages.
-
-The appendix, which may be found only in the German book version, contains
-information which is beyond what is covered in \autoref{part:forAuthors} and
-\autoref{part:forExperts}. Advanced users may find background information on
-issues of typography to give them a basis for their own decisions. In
-addition, the appendix provides examples for aspiring authors of
-packages. These examples are less intended to be simply transferred. Rather,
-they convey knowledge of planning and implementation of projects as well as
-some basic \LaTeX{} instructions for authors of packages.
-
-If you are only interested in using a single {\KOMAScript} class or package
-you can probably successfully avoid reading the entire guide. Each class and
-package typically has its own chapter; however, the three main classes
-(\Class{scrbook}, \Class{scrrprt}, and \Class{scrartcl}) are introduced
-together in \autoref{cha:maincls}. Where an example or note only
-applies to one or two of the three classes, e.\,g.,
-\Class{scrartcl}\OnlyAt{\Class{scrartcl}}, it is called out in the
-margin, as
-shown here with \Class{scrartcl}.
+This manual is divided into several parts: There is a section for average
+users, one for advanced users and experts, and an appendix with further
+information and examples for those who want to understand {\KOMAScript}
+thoroughly.
+
+\autoref{part:forAuthors} is intended for all {\KOMAScript} users. This means
+that some information in this section is directed at newcomers to \LaTeX. In
+particular, this part contains many examples that are intended to clarify the
+explanations. Do not hesitate to try these examples yourself and discover how
+{\KOMAScript} works by modifying them. That said, the {\KOMAScript} user guide
+is not intended to be a {\LaTeX} primer. Those new to {\LaTeX} should look at
+\emph{The Not So Short Introduction to {\LaTeXe}} \cite{lshort} or
+\emph{{\LaTeXe} for Authors} \cite{latex:usrguide} or a {\LaTeX} reference
+book. You will also find useful information in the many {\LaTeX} FAQs,
+including the \emph{{\TeX} Frequently Asked Questions on the Web}
+\cite{UK:FAQ}. Although the length of the \emph{{\TeX} Frequently Asked
+ Questions on the Web} is considerable, you should get at least a rough
+overview of it and consult it in case you have problems, as well as this
+\iffree{guide}{book}.
+
+\autoref{part:forExperts} is intended for advanced {\KOMAScript} users, those
+who are already familiar with \LaTeX{} or who have been working with
+{\KOMAScript} for a while and want to understand more about how {\KOMAScript}
+works, how it interacts with other packages, and how to perform more
+specialized tasks with it. For this purpose, we return to some aspects of the
+class descriptions from \autoref{part:forAuthors} and explain them in more
+detail. In addition we document some commands that are particularly intended
+for advanced users and experts. This is supplemented by the documentation of
+packages that are normally hidden from the user, insofar as they do their work
+beneath the surface of the classes and user packages. These packages are
+specifically designed to be used by authors of classes and packages.
+
+The appendix\iffree{, which can only be found in the German book version,}{}
+contains information beyond that which is covered in \autoref{part:forAuthors}
+and \autoref{part:forExperts}. Advanced users will find background information
+on issues of typography to give them a basis for their own decisions. In
+addition, the appendix provides examples for aspiring package authors. These
+examples are not intended simply to be copied. Rather, they provide
+information about planning and implementing projects, as well as some basic
+\LaTeX{} commands for package authors.
+
+The guide's layout should help you read only those parts that are actually of
+interest. Each class and package typically has its own chapter.
+Cross-references to another chapter are thus usually also references to
+another part of the overall package. However, since the three main classes
+(\Class{scrbook}, \Class{scrrprt}, and \Class{scrartcl}) largely agree, they
+are introduced together in \autoref{cha:maincls}. Differences between the
+classes, e.\,g., for something that only affects the class
+\Class{scrartcl}\OnlyAt{\Class{scrartcl}}, are clearly highlighted in the
+margin, as shown here with \Class{scrartcl}.
\begin{Explain}
The primary documentation for {\KOMAScript} is in German and has been
@@ -157,21 +152,24 @@ shown here with \Class{scrartcl}.
and useful to you.
\end{Explain}
+At this point you should know enough to understand the this guide.
+It might, however, still be worth reading the rest of this chapter.
\section{History of {\KOMAScript}}\seclabel{history}
-In the early 1990s, Frank Neukam needed a method to publish an
-instructor's lecture notes. At that time {\LaTeX} was {\LaTeX}2.09 and there
-was no distinction between classes and packages\,---\,there were only
-\emph{styles}. Frank felt that the standard document styles were not
-good enough for his work; he wanted additional commands and
-environments. At the same time he was interested in typography and,
-after reading Tschichold's \emph{Ausgew\"ahlte Aufs\"atze \"uber Fragen der
-Gestalt des Buches und der Typographie} (Selected Articles on the
-Problems of Book Design and Typography) \cite{JTsch87}, he decided to
-write his own document style\,---\,and not just a one-time solution to his
-lecture notes, but an entire style family, one specifically designed for
-European and German typography. Thus {\Script} was born.
+%\begin{Explain}
+In the early 1990s, Frank Neukam needed a method to publish an instructor's
+lecture notes. At that time {\LaTeX} was {\LaTeX}2.09 and there was no
+distinction between classes and packages\,---\,there were only \emph{styles}.
+Frank felt that the standard document styles were not good enough for his
+work; he wanted additional commands and environments. At the same time he was
+interested in typography and, after reading Tschichold's \emph{Ausgew\"ahlte
+ Aufs\"atze \"uber Fragen der Gestalt des Buches und der Typographie}
+(Selected Articles on the Problems of Book Design and Typography)
+\cite{JTsch87}, he decided to write his own document style\,---\,and not just
+a one-time solution to his lecture notes, but an entire style family, one
+specifically designed for European and German typography. Thus {\Script} was
+born.
Markus Kohm, the developer of {\KOMAScript}, came across {\Script} in December
1992 and added an option to use the A5 paper format. At that time neither the
@@ -180,27 +178,26 @@ not take long until Markus made the first changes to {\Script}. This and other
changes were then incorporated into {\ScriptII}, released by Frank in December
1993.
-Beginning in mid-1994, {\LaTeXe} became available and brought with it
-many changes. Users of {\ScriptII} were faced with either limiting their
-usage to {\LaTeXe}'s compatibility mode or giving up {\Script}
-altogether. This situation led Markus to put together a new {\LaTeXe}
-package, released on 7~July 1994 as {\KOMAScript}; a few months later
-Frank declared {\KOMAScript} to be the official successor to {\Script}.
-{\KOMAScript} originally provided no \emph{letter} class, but this
-deficiency was soon remedied by Axel Kielhorn, and the result became part
-of {\KOMAScript} in December 1994. Axel also wrote the first true
-German-language user guide, which was followed by an English-language
-guide by Werner Lemberg.
-
-Since then much time has passed. {\LaTeX} has changed in only minor
-ways, but the {\LaTeX} landscape has changed a great deal; many new
-packages and classes are now available and {\KOMAScript} itself has
-grown far beyond what it was in 1994. The initial goal was to provide
-good {\LaTeX} classes for German-language authors, but today its
-primary purpose is to provide more-flexible alternatives to the
-standard classes. {\KOMAScript}'s success has led to e-mail from users
-all over the world, and this has led to many new macros\,---\,all
-needing documentation; hence this ``small guide.''
+In mid-1994, {\LaTeXe} became available and brought with it many changes.
+Users of {\ScriptII} were faced with either limiting their usage to
+{\LaTeXe}'s compatibility mode or giving up {\Script} altogether. This
+situation led Markus to put together a new {\LaTeXe} package, released on
+7~July 1994 as {\KOMAScript}. A few months later, Frank declared {\KOMAScript}
+to be the official successor to {\Script}. {\KOMAScript} originally provided
+no \emph{letter} class, but this deficiency was soon remedied by Axel
+Kielhorn, and the result became part of {\KOMAScript} in December 1994. Axel
+also wrote the first true German-language user guide, which was followed by an
+English-language guide by Werner Lemberg.
+
+Since then much time has passed. {\LaTeX} has changed in only minor ways, but
+the {\LaTeX} landscape has changed a great deal; many new packages and classes
+are now available and {\KOMAScript} itself has grown far beyond what it was in
+1994. The initial goal was to provide good {\LaTeX} classes for
+German-language authors, but today its primary purpose is to provide
+more-flexible alternatives to the standard classes. {\KOMAScript}'s success
+has led to e-mail from users all over the world, and this has led to many new
+macros\,---\,all needing documentation; hence this ``small guide.''
+%\end{Explain}
\section{Special Thanks}
@@ -209,9 +206,9 @@ needing documentation; hence this ``small guide.''
Acknowledgements in the introduction? No, the proper acknowledgements can be
found in the addendum. My comments here are not intended for the authors of
this guide\,---\,and those thanks should rightly come from you, the reader,
-anyhow. I, the author of {\KOMAScript}, would like to extend my personal thanks
-to Frank Neukam. Without his {\Script} family, {\KOMAScript} would not have
-come about. I am indebted to the many persons who have contributed to
+anyhow. I, the author of {\KOMAScript}, would like to extend my personal
+thanks to Frank Neukam. Without his {\Script} family, {\KOMAScript} would not
+have come about. I am indebted to the many persons who have contributed to
{\KOMAScript}, but with their indulgence, I would like to specifically mention
Jens-Uwe Morawski and Torsten Kr\"uger. The English translation of the guide
is, among many other things, due to Jens's untiring commitment. Torsten was
@@ -220,76 +217,132 @@ usability of \Class{scrlttr2} and \Class{scrpage2}. Many thanks to all who
encouraged me to go on, to make things better and less error-prone, or to
implement additional features.
-Thanks go as well to DANTE, Deutschsprachige
-Anwendervereinigung {\TeX}~e.V\kern-.18em, (the German-Language {\TeX} User Group).
-Without the DANTE server, {\KOMAScript} could not have been released and
-distributed. Thanks as well to everybody in the {\TeX} newsgroups and mailing
-lists who answer questions and have helped me to provide support for
-{\KOMAScript}.
+Special thanks go as well to the founders and members of DANTE,
+Deutschsprachige Anwendervereinigung {\TeX}~e.V\kern-.18em, (the
+German-Language {\TeX} User Group). Without the DANTE server, {\KOMAScript}
+could not have been released and distributed. Thanks as well to everybody on
+the {\TeX} newsgroups and mailing lists who answer questions and have helped
+me provide support for {\KOMAScript}.
+My thanks also go to all those who have always encouraged me to go further and
+to implement this or that feature better, with fewer flaws, or simply as an
+extension. I would also like to thank the very generous donor who has given me
+the most significant amount of money I have ever been paid for the work done
+so far on \KOMAScript{}.
\section{Legal Notes}
\seclabel{legal}
-{\KOMAScript} was released under the {\LaTeX} Project Public License. You
-will find it in the file \File{lppl.txt}. An unofficial German-language
-translation is also available in \File{lppl-de.txt} and is valid for all
-German-speaking countries.
+{\KOMAScript} is released under the {\LaTeX} Project Public License. You will
+find it in the file \File{lppl.txt}. An unofficial German-language translation
+is also available in \File{lppl-de.txt} and is valid for all German-speaking
+countries.
\iffree{This document and the {\KOMAScript} bundle are provided ``as is'' and
-without warranty of any kind.}%
+ without warranty of any kind.}%
{Please note: the printed version of this guide is not free under the
-conditions of the {\LaTeX} Project Public Licence. If you need a free version
-of this guide, use the version that is provided as part of the {\KOMAScript}
-bundle.}
+ conditions of the {\LaTeX} Project Public Licence. If you need a free
+ version of this guide, use the version that is provided as part of the
+ {\KOMAScript} bundle.}
\section{Installation}
\seclabel{installation}
-The three most important \TeX{} distributions, Mac\TeX, MiK\TeX, and \TeX{}
-Live, make \KOMAScript{} available by their package management software. It is
-recommended to make installations and updates of \KOMAScript{} using these
-tools. Nevertheless the manual installation without using the package managers
-has been described in the file \File{INSTALL.txt}, that is part of every legal
-\KOMAScript{} bundle. You should also read the documentation that comes with
-the {\TeX} distribution you are using.
+The three most important \TeX{} distributions, Mac\TeX, MiK\TeX, and
+\TeX{}~Live, make {\KOMAScript} available through their package management
+software. You should install and update {\KOMAScript} using these tools, if
+possible. Manual installation without using the package managers is described
+in the file \File{INSTALL.txt}, which is part of every {\KOMAScript}
+distribution. You should also read the documentation that comes with the
+{\TeX} distribution you are using.
\section{Bug Reports and Other Requests}
\seclabel{errors}
If you think you have found an error in the documentation or a bug in one of
-the {\KOMAScript} classes, one of the {\KOMAScript} packages, or another part
-of {\KOMAScript}, please do the following: first have a look on CTAN to see if
-a newer version of {\KOMAScript} is available; if a newer version is
-available, % in this case
-install the
-applicable section and try again.
-
-If you are using the most recent version of {\KOMAScript} and still have a
-bug, please provide a short {\LaTeX} document that demonstrates the
-problem. You should only use the packages and definitions needed to
-demonstrate the problem; do not use any unusual packages.
-
-By preparing such an example it often becomes clear whether the problem is
-truly a {\KOMAScript} bug or something else. To find out the version numbers
-of all packages in use, simply put \Macro{listfiles} in the preamble of your
-example and read the end of the \File{log}-file.
+the {\KOMAScript} classes, packages, or another part of {\KOMAScript}, please
+do the following: First check on CTAN to see if a newer version of
+{\KOMAScript} has been released. If a newer version is available, install this
+new version and check if the problem persists.
-Please report {\KOMAScript} (only) bugs to
-\href{mailto:komascript@gmx.info}{komascript@gmx.info}. If you want to ask
-your question in a Usenet group, mailing list, or Internet forum, you should
-also include such an example as part of your question.
+If the bug still occurs and your installation is fully up to date, please
+provide a short {\LaTeX} file that demonstrates the problem. Such a file is
+known as a minimal working example (MWE). You should include only minimal text
+and use only the packages and definitions essential to demonstrate the
+problem. Avoid using any unusual packages as much as possible.
+By preparing such an example it often becomes clear whether the problem is
+truly a {\KOMAScript} bug or caused by something else. To check if another
+package or class is actually causing the problem, you can also test your
+example with the corresponding standard class instead of a {\KOMAScript}
+class. If your problem still occurs, you should address your error report to
+the author of the appropriate package than to the author of {\KOMAScript}.
+Finally, you should carefully review the instructions for the appropriate
+package, classes, and {\KOMAScript} component. A solution to your problem may
+already exist, in which case an error report is unnecessary.
+
+If you think you have found a previously unreported error, or if for some
+other reason you need to contact the author of {\KOMAScript}, don't forget the
+following:
+
+\begin{itemize}
+\item Does the problem also occur if a standard class is used instead of a
+ {\KOMAScript} class? In this case, the error is most likely not with
+ {\KOMAScript}, and it makes more sense to ask your question in a public
+ forum, a mailing list, or Usenet.
+\item Which {\KOMAScript} version do you use? For related information, see the
+ \File{log} file of the \LaTeX{} run of any document that uses a
+ {\KOMAScript} class.
+\item Which operating system and which \TeX{} distribution do you use? This
+ information might seem rather superfluous for a system-independent package
+ like {\KOMAScript} or {\LaTeX}, but time and again they have certainly been
+ shown to play a role.
+\item What exactly is the problem or the error? Describe the problem. It's
+ better to be too detailed than too short. Often it makes sense to explain
+ the background.
+\item What does a minimal working example look like? You can easily create one
+ by commenting out content and packages from the document step by step. The
+ result is a document that only contains the packages and parts necessary to
+ reproduce the problem. In addition, all loaded images should be replaced by
+ \Macro{rule} statements of the appropriate size. Before sending your
+ MWE,remove the commented-out parts, insert the command \Macro{listfiles} in
+ the preamble, and perform another {\LaTeX} run. At the end of the \File{log}
+ file, you will see an overview of the packages used. Add the MWE and the log
+ file to the end of your description of the problem.
+\end{itemize}
+
+Do not send packages, PDF, PS, or DVI files. If the entire issue or bug
+description, including the minimal example and the \File{log} file is larger
+than a few tens of kilobytes, you're likely doing something wrong.
+
+If you've followed all these steps, please send your {\KOMAScript} (only) bug
+report to \href{mailto:komascript@gmx.info}{komascript@gmx.info}.
+
+If you want to ask your question in a Usenet group, mailing list, or Internet
+forum, you should follow the procedures mentioned above and include a minimal
+working example as part of your question, but usually you don't need to
+provide the \File{log}-file. Instead, just add the list of packages and
+package versions from the \File{log}-file and, if your MWE compiles with
+errors, you should quote those messages from the \File{log} file.
+
+Please note that default settings which are not typographically optimal do not
+represent errors. For reasons of compatibility, defaults are preserved
+whenever possible in new versions of {\KOMAScript}. Furthermore, typographical
+best practices are partly a matter of language and culture, and so the default
+settings of {\KOMAScript} are necessarily a compromise.
\section{Additional Information}
\seclabel{moreinfos}
-Once you become an experienced {\KOMAScript} user you may want to look at some
-more advanced examples and information. These you will find on the
-{\KOMAScript} documentation web site \cite{homepage}. The main language of the
-site is German, but nevertheless English is welcome.
+Once you become familiar with {\KOMAScript}, you may want examples that show
+how to accomplish more difficult tasks. Such examples go beyond the basic
+instructional scope of this manual and so are not included. However, you will
+find more examples on the website of the {\KOMAScript} Documentation Project
+\cite{homepage}. These examples are designed for advanced {\LaTeX} users and
+are not particularly suitable for beginners. The main language of the site
+is German, but English is also welcome.
\endinput
%%% Local Variables:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/japanlco.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/japanlco.tex
index 8d16d34e560..6503afae061 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/japanlco.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/japanlco.tex
@@ -1,6 +1,6 @@
% ======================================================================
% japanlco.tex
-% Copyright (c) Gernot Hassenpflug and Markus Kohm, 2001-2017
+% Copyright (c) Gernot Hassenpflug and Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% japanlco.tex
-% Copyright (c) Gernot Hassenpflug und Markus Kohm, 2001-2017
+% Copyright (c) Gernot Hassenpflug und Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -50,22 +50,22 @@
%
\KOMAProvidesFile{japanlco.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-21 10:37:34 +0100 (Wed, 21 Mar 2018) $
KOMA-Script guide (appendix: japanlco)]
\appendix
\chapter[{Japanese Letter Support for \Class{scrlttr2}}]
-{Japanese Letter Support for \Class{scrlttr2}\footnote{This chapter has been
- written originally by Gernot Hassenpflug.}}
+{Japanese Letter Support for \Class{scrlttr2}\footnote{This chapter was
+ originally written by Gernot Hassenpflug.}}
\labelbase{japanlco}
\Index{letter>Japanese}
-Since version~2.97e \Class{scrlttr2} provides support not only for European
-ISO~envelope sizes and window envelopes, but also for Japanese envelopes, in
-the form of \File{lco} files which set the layout of the paper. This chapter
-documents the support, and provides a few examples of using the provided
-\File{lco} files for printing letters intended for Japanese envelopes.
+Since version~2.97e, \Class{scrlttr2} has provided support not only for
+European ISO~envelope sizes and window envelopes but also for Japanese
+envelopes, in the form of \File{lco} files which set the layout of the paper.
+This chapter documents this support and provides a few examples of using the
+provided \File{lco} files to print letters intended for Japanese envelopes.
\section{Japanese standard paper and envelope sizes}
\seclabel{PaperEnvelope}
@@ -74,7 +74,7 @@ The Japan Industrial Standard (JIS) defines paper sizes and envelope sizes for
national use, which both overlap with the ISO and US sizes and include some
metricated traditional Japanese sizes. Envelope window size and position have
not been defined internationally as yet; hence, there exists a plethora of
-envelopes with differing window sizes and positions. The below subsections
+envelopes with differing window sizes and positions. The following subsections
give some background on Japanese paper sizes and envelopes.
\subsection{Japanese paper sizes}
@@ -82,7 +82,7 @@ give some background on Japanese paper sizes and envelopes.
The JIS defines two main series of paper sizes:
\begin{enumerate}
-\item the JIS A-series, which is identical to the ISO A-series, but
+\item the JIS A-series, which is identical to the ISO A-series but
with slightly different tolerances; and
\item the JIS B-series, which is not identical to the ISO/DIN
B-series. Instead, the JIS B-series paper has an area 1.5 times that
@@ -94,7 +94,7 @@ The JIS defines two main series of paper sizes:
Both JIS A-series and B-series paper is widely available in Japan and most
photocopiers and printers are loaded with at least A4 and B4 paper. The
-ISO/JIS~A-series, and the different ISO and JIS~B-series sizes are listed in
+ISO/JIS~A-series and the different ISO and JIS~B-series sizes are listed in
\autoref{tab:japanlco.jpapersizes1}.
%% ISO/JIS standard comparison
@@ -125,7 +125,7 @@ A12 & 13 & 18 & & \multicolumn2l{} & B12 & 16 & 22 \\
\end{tabular}
\label{tab:japanlco.jpapersizes1}
\footnotetext[1]{Although Japan's official postcard size
- appears to be A6, it is actually 100$\times$148\Unit{mm}, 5 millimeters
+ appears to be A6, it is actually 100$\times$148\Unit{mm}, 5 millimetres
narrower than A6.}
\end{minipage}
\end{table}
@@ -134,9 +134,9 @@ There are also a number of traditional paper sizes, which are now used
mostly only by printers. The most common of these old series are the
Shiroku-ban and the Kiku paper sizes. The difference of these types compared
to the JIS~B-series are shown in \autoref{tab:japanlco.jpapersizes2}.
-Finally, there are some common stationary sizes, listed in
+Finally, there are some common stationery sizes, listed in
\autoref{tab:japanlco.jpapersizes3}. You may come across these when buying
-stationary.
+stationery.
%% JIS B-series variants
\begin{table}
@@ -160,8 +160,8 @@ Size & \multicolumn{2}{l}{W$\times$H in mm} & \multicolumn{2}{l}{W$\times$H in
%% Japanese contemporary sizes
\begin{table}
\centering
-\caption[{Main Japanese contemporary stationary}]
-{Main Japanese contemporary stationary}%; trim sizes are given with width
+\caption[{Main Japanese contemporary stationery}]
+{Main Japanese contemporary stationery}%; trim sizes are given with width
% preceding height, both in millimeters}
\begin{tabular}{lr@{$\times$}ll}\toprule
Name & \multicolumn{2}{l}{W$\times$H in mm} & Usage and Comments \\ \midrule
@@ -179,28 +179,26 @@ Ippitsu sen & 82 & 185 & ``note paper'' \\
\label{tab:japanlco.jpapersizes3}
\end{table}
-The ISO~C-series is not a paper size as such, but is a standard
-developed for envelopes, intended for the corresponding A-series
-paper, and is discussed in the next subsection.
+The ISO~C-series is not a paper size as such but a standard developed for
+envelopes and intended for the corresponding A-series paper. It is discussed
+in the next subsection.
%\clearpage
\subsection{Japanese envelope sizes}
\seclabel{envelope}
-ISO (International Organization for Standardization) envelope sizes
-are the official international metric envelope sizes; however, Japan
-uses also JIS and metricated traditional envelope sizes. Sizes
-identified as nonstandard do not conform to Universal Postal Union
-requirements for correspondence envelopes.
+ISO (International Organization for Standardization) envelope sizes are the
+official international metric envelope sizes; however, Japan uses also JIS and
+metricated traditional envelope sizes. Sizes identified as non-standard do not
+conform to Universal Postal Union requirements for correspondence envelopes.
\subsubsection{ISO envelope sizes}
-The ISO C-series envelope sizes, and possibly B-series envelope sizes,
-are available in Japan. C-series envelopes can hold the corresponding
-A-series paper, while B-series envelopes can hold either the
-corresponding A-series paper or the corresponding C-series
-envelope. The ISO envelope sizes commonly for Japan are listed in
-\autoref{tab:japanlco.jenvsizes1}, with the corresponding paper they
-are intended for, and the folding required.
+The ISO C-series envelope sizes, and possibly B-series envelope sizes, are
+available in Japan. C-series envelopes can hold the corresponding A-series
+paper, while B-series envelopes can hold either the corresponding A-series
+paper or the corresponding C-series envelope. The ISO envelope sizes commonly
+for Japan are listed in \autoref{tab:japanlco.jenvsizes1}, with the
+corresponding paper they are intended for, and the folding required.
%%%%%% JIS Japanese Envelopes
@@ -230,19 +228,19 @@ Name & \multicolumn2l{W$\times$H in mm} & Usage and Comments \\
%\endlastfoot
\midrule
C0 & 917 & 1297 & for flat A0 sheet; \\*
- & \multicolumn2l{} & nonstandard \\
+ & \multicolumn2l{} & non-standard \\
C1 & 648 & 917 & for flat A1 sheet; \\*
- & \multicolumn2l{} & nonstandard \\
+ & \multicolumn2l{} & non-standard \\
C2 & 458 & 648 & for flat A2 sheet, A1 sheet folded in half; \\*
- & \multicolumn2l{} & nonstandard \\
+ & \multicolumn2l{} & non-standard \\
C3 & 324 & 458 & for flat A3 sheet, A2 sheet folded in half; \\*
- & \multicolumn2l{} & nonstandard \\
+ & \multicolumn2l{} & non-standard \\
B4 & 250 & 353 & C4 envelope \\
C4 & 229 & 324 & for flat A4 sheet, A3 sheet folded in half; \\*
- & \multicolumn2l{} & very common; nonstandard \\
+ & \multicolumn2l{} & very common; non-standard \\
B5 & 176 & 250 & C5 envelope \\
C5 & 162 & 229 & for flat A5 sheet, A4 sheet folded in half; \\*
- & \multicolumn2l{} & very common; nonstandard \\
+ & \multicolumn2l{} & very common; non-standard \\
B6 & 125 & 176 & C6 envelope; A4 folded in quarters; \\*
& \multicolumn2l{} & very common \\
C6 & 114 & 162 & for A5 sheet folded in half, \\*
@@ -251,9 +249,9 @@ C6 & 114 & 162 & for A5 sheet folded in half, \\*
C6/C5 & 114 & 229 & A4 sheet folded in thirds; \\*
& \multicolumn2l{} & very common \\
C7/6 & 81 & 162 & for A5 sheet folded in thirds; uncommon; \\*
- & \multicolumn2l{} & nonstandard \\
+ & \multicolumn2l{} & non-standard \\
C7 & 81 & 114 & for A5 sheet folded in quarters; uncommon; \\*
- & \multicolumn2l{} & nonstandard \\
+ & \multicolumn2l{} & non-standard \\
C8 & 57 & 81 & \\
C9 & 40 & 57 & \\
C10 & 28 & 40 & \\
@@ -274,7 +272,7 @@ DL\footnotemark[1] & 110 & 220 & for A4 sheet folded in thirds, \\*
\subsubsection{JIS and traditional envelope sizes}
The JIS classifies envelopes into three categories based on the
-general shape of the envelope, and where the flap is located:
+general shape of the envelope and where the flap is located:
\begin{description}
\item[You:] these envelopes are of the `commercial' type, rectangular,
@@ -292,9 +290,8 @@ general shape of the envelope, and where the flap is located:
rates. `Kaku-kei' means square-style.
\end{description}
-The main JIS and traditional envelope sizes and the corresponding
-paper and its required folding are listed in
-\autoref{tab:japanlco.jenvsizes2}.
+The main JIS and traditional envelope sizes, the corresponding paper, and
+its required folding are listed in \autoref{tab:japanlco.jenvsizes2}.
%% JIS and other envelope sizes
%\begin{table}
@@ -322,9 +319,9 @@ JIS & Name & \multicolumn2l{W$\times$ in mm} & Usage and Comments \\
\endlastfoot
\midrule
& Chou 1 & 142 & 332 & for A4 folded in half lengthwise;\\*
- & & \multicolumn2l{} & nonstandard \\
+ & & \multicolumn2l{} & non-standard \\
Yes & Chou 2 & 119 & 277 & for B5 folded in half lengthwise;\\*
- & & \multicolumn2l{} & nonstandard \\
+ & & \multicolumn2l{} & non-standard \\
Yes & Chou 3 & 120 & 235 & for A4 folded in thirds;\\*
& & \multicolumn2l{} & very common \\
& Chou 31 & 105 & 235 & for A4 folded in thirds \\
@@ -333,27 +330,27 @@ Yes & Chou 3 & 120 & 235 & for A4 folded in thirds;\\*
Yes & Chou 4 & 90 & 205 & for JIS B5 folded in fourths\footnotemark[3];\\*
& & \multicolumn2l{} & very common \\
& Kaku A3 & 320 & 440 & for A3 flat, A2 folded in half\\*
- & & \multicolumn2l{} &; nonstandard \\
+ & & \multicolumn2l{} &; non-standard \\
& Kaku 0 & 287 & 382 & for B4 flat, B3 folded in half;\\*
- & & \multicolumn2l{} & nonstandard \\
+ & & \multicolumn2l{} & non-standard \\
& Kaku 1 & 270 & 382 & for B4 flat, B3 folded in half;\\*
- & & \multicolumn2l{} & nonstandard \\
+ & & \multicolumn2l{} & non-standard \\
Yes & Kaku 2 & 240 & 332 & for A4 flat, A3 folded in half;\\*
- & & \multicolumn2l{} & nonstandard \\
+ & & \multicolumn2l{} & non-standard \\
& Kaku & 229 & 324 & for A4 flat, A3 folded in half;\\*
& Kokusai A4 & \multicolumn2l{} & same size as ISO C4;\\*
- & & \multicolumn2l{} & nonstandard \\
+ & & \multicolumn2l{} & non-standard \\
Yes & Kaku 3 & 216 & 277 & for B5 flat, B4 folded in half;\\*
- & & \multicolumn2l{} & nonstandard \\
+ & & \multicolumn2l{} & non-standard \\
Yes & Kaku 4 & 197 & 267 & for B5 flat, B4 folded in half;\\*
- & & \multicolumn2l{} & nonstandard \\
+ & & \multicolumn2l{} & non-standard \\
Yes & Kaku 5 & 190 & 240 & for A5 flat, A4 folded in half\\*
- & & \multicolumn2l{} &; nonstandard \\
+ & & \multicolumn2l{} &; non-standard \\
Yes & Kaku 6 & 162 & 229 & for A5 flat, A4 folded in half;\\*
& & \multicolumn2l{} & same size as ISO C5;\\*
- & & \multicolumn2l{} & nonstandard \\
+ & & \multicolumn2l{} & non-standard \\
Yes & Kaku 7 & 142 & 205 & for B6 flat, B5 folded in half;\\*
- & & \multicolumn2l{} & nonstandard \\
+ & & \multicolumn2l{} & non-standard \\
Yes & Kaku 8 & 119 & 197 & pay envelope (for salaries, wages)\\*
& & \multicolumn2l{} &; common for direct mail \\
Yes & You 0\footnotemark[1] & 235 & 120 & for A4 folded in thirds;\\*
@@ -361,7 +358,7 @@ Yes & You 0\footnotemark[1] & 235 & 120 & for A4 folded in thirds;\\*
& & \multicolumn2l{} & `Open Side' style flap \\
& You 0\footnotemark[1] & 197 & 136 & for kyabine\footnotemark[1] (cabinet) size photos \\*
& & \multicolumn2l{} & (165\Unit{mm}$\times$120\Unit{mm});\\*
- & & \multicolumn2l{} & nonstandard \\
+ & & \multicolumn2l{} & non-standard \\
& You 1\footnotemark[2] & 176 & 120 & for B5 folded in quarters \\
& You 1\footnotemark[2] & 173 & 118 & for B5 folded in quarters \\
Yes & You 2 & 162 & 114 & for A5 folded in half,\\*
@@ -398,8 +395,8 @@ sizes and locations are listed in \autoref{tab:japanlco.jwinsizes1}.
\begin{table}
\begin{minipage}{\textwidth}\renewcommand*{\footnoterule}{}
\centering
-\caption[{Supported Japanese envelope types and the window sizes and
- locations}] {Supported Japanese envelope types and the window sizes and
+\caption[{Supported Japanese envelope types, window sizes, and
+ locations}] {Supported Japanese envelope types, window sizes, and
locations.}
\begin{tabular}{lllll}
\toprule
@@ -437,8 +434,8 @@ You 4 & A & 90$\times$45 & l 23, t 13 & \Option{NipponEL} \\
\bottomrule
\end{tabular}%
\footnotetext[1]{Names (acting as subtype information) are taken from
- the manufacturer catalog.}%
-\footnotetext[2]{Given as width by height in millimeters.}%
+ the manufacturer catalogue.}%
+\footnotetext[2]{Given as width by height in millimetres.}%
\footnotetext[3]{Given as offset from left (l) or right (r), followed by
offset from bottom (b) or top (t).}%
\footnotetext[4]{The \File{lco} file, which provides support (see
@@ -451,18 +448,17 @@ You 4 & A & 90$\times$45 & l 23, t 13 & \Option{NipponEL} \\
\end{table}
\section{Provided \File{lco} files}
-In \Class{scrlttr2} support is provided for Japanese envelope and
+In \Class{scrlttr2}, support is provided for Japanese envelope and
window sizes through a number of \File{lco} files which customize the
-foldmarks required for different envelope sizes and subvariants with
+fold marks required for different envelope sizes and subvariants with
different window positions and sizes.
-The provided \File{lco} files together with the envelope types for
-which they provide support are listed at
-\autoref{tab:japanlco.lcolist}. See \autoref{tab:japanlco.jenvsizes1}
-for the full list of Japanese envelopes and the paper they take, and
-\autoref{tab:japanlco.jwinsizes1} for the common window sizes and
-locations. The rightmost column indicates which \File{lco} file
-provides the support.
+The \File{lco} files provided together with the envelope types that they
+support are listed at \autoref{tab:japanlco.lcolist}. See
+\autoref{tab:japanlco.jenvsizes1} for the full list of Japanese envelopes and
+the paper they take, and \autoref{tab:japanlco.jwinsizes1} for the common
+window sizes and locations. The rightmost column indicates which \File{lco}
+file provides the support.
The tolerances for location is about 2\Unit{mm}, so it is possible to
accommodate all the envelope and window variants of
@@ -495,8 +491,8 @@ location\footnotemark[1] \\
\end{minipage}
\end{table}
-\section{Examples of Japanese letter usage}
-Assume you want to write a letter on A4 size paper and will post it in
+\section{Examples of Japanese Letter Usage}
+Suppose you want to write a letter on A4 size paper and will post it in
a Japanese envelope. If the envelope has no window, then it is enough
to determine whether the envelope dimensions match a European
one\,---\,the standard \File{DIN.lco} style may suffice for many such
@@ -504,18 +500,18 @@ cases.
If you wish to use a windowed envelope, please note that owing to the
large variety, not all existing subvariants are currently
-supported. If you should note that you particular windowed envelope
-has its window dimensions and positions significantly (more than
-approximately 2\Unit{mm}) different from any of the supported subvariants,
+supported. If you notice that the window dimensions and positions
+of your particular windowed envelope differ significantly (more than
+approximately 2\Unit{mm}) from those of any of the supported subvariants,
please contact the author of {\KOMAScript} to obtain support as soon as
-possible, and in the meanwhile create a customized \File{lco} file for your
+possible, and in the meantime, create a customized \File{lco} file for your
own use, using one of the existing ones as a template and reading the
{\KOMAScript} documentation attentively.
If your window envelope subvariant is supported, this is how you would
go about using it: simply select the required \File{lco} file and
-activate the horizontal and vertical foldmarks as required. Another,
-independent, mark is the punching mark which divides a sheet in two
+activate the horizontal and vertical fold marks as required. Another,
+independent, mark is the hole-punch mark, which divides a sheet in two
horizontally for easy punching and filing.
\subsection{Example 1:}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/linkalias.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/linkalias.tex
index 16dcdc1d4e8..3d4328a4891 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/linkalias.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/linkalias.tex
@@ -39,7 +39,7 @@
%
\KOMAProvidesFile{linkalias.tex}
- [$Date: 2016-11-20 17:40:30 +0100 (Sun, 20 Nov 2016) $
+ [$Date: 2017-12-03 22:49:27 +0100 (Sun, 03 Dec 2017) $
link aliases for the free version]
\makeatletter
@@ -67,3 +67,6 @@
\lalias{desc:maincls-experts.cmd.AfterBibliographyPreamble}{sec:maincls-experts.addInfos}
\lalias{desc:maincls-experts.option.fontsize}{sec:maincls-experts.addInfos}
\lalias{desc:maincls-experts.cmd.raggedsection}{sec:maincls-experts.coexistence}
+\lalias{desc:maincls-experts.cmd.thepage}{sec:maincls-experts.addInfos}
+\lalias{desc:maincls-experts.cmd.pagemark}{sec:maincls-experts.addInfos}
+\lalias{desc:maincls-experts.cmd.the/Zaehler/}{sec:maincls-experts.addInfos}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/preface.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/preface.tex
index 3047b682368..873f3039879 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/preface.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/preface.tex
@@ -1,6 +1,6 @@
% ======================================================================
% preface.tex
-% Copyright (c) Markus Kohm, 2008-2017
+% Copyright (c) Markus Kohm, 2008-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% preface.tex
-% Copyright (c) Markus Kohm, 2008-2017
+% Copyright (c) Markus Kohm, 2008-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -36,28 +36,82 @@
% ======================================================================
\KOMAProvidesFile{preface.tex}
- [$Date: 2017-01-16 07:48:29 +0100 (Mon, 16 Jan 2017) $
- Preface to the KOMA-Script book]
-%\translator{Markus Kohm}
+ [$Date: 2018-03-28 11:44:09 +0200 (Wed, 28 Mar 2018) $
+ Preface to version 3.25]
+\translator{Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-03-12
-\addchap{Preface to the English \KOMAScript{} Guide}
+\addchap{Preface to \KOMAScript~3.25}
-The translation of the German \KOMAScript{} guide is still a work in progress
-and a never ending story. I always try to have an English user guide with all
-descriptions of the German one. But as long as I have to do the primary
-translation, these translations not only can but should be improved.
+The \KOMAScript~3.25 manual,\---\,especially the German version\,---\,once
+again benefits from the fact that a new edition of the print version
+\cite{book:komascript} and the eBook version \cite{ebook:komascript} will be
+published at almost the same time as this version. This has led to many
+improvements which also affect the free manual, in both the German and the
+English version.
-The translation of \autoref{cha:tocbasic} has still an example in German. A
-proficient English speaker with basic TeX knowledge could improve the
-translation. A large part of \autoref{cha:scrjura} has been translated by
-Alexander Willand. The remaining part may need improvement.
+One of these improvements is the linking to the explanations of commands,
+environments, options, etc., within the manual. To avoid the temptation to
+jump to the beginning of the explanation within the explanation itself, and
+so to avoid reading recursively, as it were, these links only take effect
+if they actually lead away from the current location.
-So this English guide is complete but nevertheless not as good as the German
-one. Currently there are only a few editors for the English guide, who improve
-my translation for free. Many thanks to them for their very good job!
-Nevertheless, additional editors or translators would be welcome!
+Another important improvement to the English guide has been accomplished by
+Karl Hagen, who has newly translated the entire manual. Many, many thanks to
+him! Additional editors or translators, however, would still be welcome!
+
+\iffree{Readers of this free, screen version, however, still have to live with
+ some restrictions. So some information\,---\,mainly intended for advanced
+ users or capable of turning an ordinary user into an advanced one\,---\,is
+ reserved for the printed book, which currently exists only in German. As a
+ result, some links in this manual lead to a page that simply mentions this
+ fact. In addition, the free version is scarcely suitable for making a
+ hard-copy. The focus, instead, is on using it on screen, in parallel with
+ the document you are working on. It still has no optimized wrapping but is
+ almost a first draft, in which both the paragraph and page breaks are in
+ some cases quite poor. Corresponding optimizations are reserved for the
+ German book editions.}{}
+
+It is not just about the manual that I now receive little criticism. For the
+classes and packages as well, there are hardly any requests for new features.
+For me, this means that my knowledge about user desires stagnates. So for a
+few years, I mostly implemented things that I thought could be useful.
+However, the feedback that I have received about these new possibilities was
+largely limited to complaints that old \emph{hacks} based on undocumented
+\KOMAScript{} features sometimes no longer work. Little was said about the
+happiness that such dirty workarounds were no longer necessary. Therefore, I
+have decided to limit extensions and improvements to \KOMAScript{} more and
+more to those things that are explicitly requested by users. Could it be that
+\KOMAScript{}, after only 25 years, has reached the level that it fulfils all
+desires?
+
+Unfortunately, the declining number of error reports is not purely gratifying.
+Over this period, I have often observed that those who discover a problem no
+longer report it directly to me but work around it with the help of some
+Internet forums. Often, there are more or less ingenious workarounds in these
+forums. Although this is generally helpful, it unfortunately, as a rule,
+causes the problem to remain unreported and therefore never really eliminated.
+It goes without saying that such workarounds can sometimes become a problem
+themselves, as mentioned in the previous paragraph.
+
+Thankfully, there are third parties who occasionally point out such issues.
+This applies to individual contributions in a very few forums. Direct contact
+with the person for whom the problem occurred is in this case usually not
+possible, although it would sometimes be desirable.
+
+Therefore, let me please ask again explicitly that you report all suspected
+bugs directly, either in German or in English. Linguistic perfection is less
+important. The message should be reasonably understandable and the problem
+comprehensible. A code example that is as short as possible is generally
+independent of the language used. With direct contact, I can ask further
+questions, if necessary. Please do not rely on anyone else to report the
+problem at some point. Assume that it will only be fixed if you report it
+yourself. More about error messages can be found in the first chapter of the
+manual.
+
+\bigskip\noindent
+Markus Kohm, Neckarhausen in the March rain, 2018.
\endinput
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scraddr.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scraddr.tex
index a4a7c5454e2..ac5ef90a5e7 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scraddr.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scraddr.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scraddr.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scraddr.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,36 +46,40 @@
% ======================================================================
\KOMAProvidesFile{scraddr.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-27 11:46:14 +0200 (Tue, 27 Mar 2018) $
KOMA-Script guide (chapter: scraddr)]
-\translator{Jens-Uwe Morawski\and Gernot Hassenpflug\and Markus Kohm}
+\translator{Jens-Uwe Morawski\and Gernot Hassenpflug\and Markus Kohm\and Karl
+ Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-02-05
-\chapter{Access to Address Files with \Package{scraddr}}%
+\chapter{Accessing Address Files with \Package{scraddr}}%
\labelbase{scraddr}%
\BeginIndexGroup
\BeginIndex{Package}{scraddr}
+The \Package{scraddr} package is a small extension to \KOMAScript{}'s letter
+class and letter package. Its goal is to make access to the data in address
+files easier and more flexible.
+
\section{Overview}\seclabel{overview}
-The package \Package{scraddr} is a small extension to the {\KOMAScript} letter
-class. Its aim is to make access to the data of address files more flexible
-and easier. Basically, the package implements a new loading mechanism for
-address files which contain address entries in the form of \DescRef{\LabelBase.cmd.adrentry}
-and newer \DescRef{\LabelBase.cmd.addrentry} commands, as described in \autoref{cha:scrlttr2}
-from \DescPageRef{scrlttr2.cmd.adrentry}.
+Basically, the package provides a new loading mechanism for address files
+consisting of \DescRef{\LabelBase.cmd.adrentry} and the newer
+\DescRef{\LabelBase.cmd.addrentry} format entries, as described in
+\autoref{cha:scrlttr2} starting on \DescPageRef{scrlttr2.cmd.adrentry}.
\begin{Declaration}
\Macro{InputAddressFile}\Parameter{file name}
\end{Declaration}%
-The command \Macro{InputAddressFile} is the main command of the
-\Package{scraddr}, and reads the content of the address
-file\Index{address>file} given as its parameter. If the file does not
-exist the command returns an error message.
+The \Macro{InputAddressFile} command is the main command of \Package{scraddr}.
+It reads the content of the address file\Index{address>file} given as its
+parameter. If the file is not found, an error message is issued.
-For every entry in the address file the command generates a set of
-macros for accessing the data. For large address files this will take
-a lot of {\TeX} memory.
+For each entry in this address file, the command generates a set of
+macros to access the data. For large address files, this will require
+a lot of \TeX{} memory.
+%
+\EndIndexGroup
\begin{Declaration}%
\Macro{adrentry}\Parameter{Lastname}\Parameter{Firstname}%
@@ -89,15 +93,12 @@ a lot of {\TeX} memory.
\Macro{adrchar}\Parameter{initial}%
\Macro{addrchar}\Parameter{initial}%
\end{Declaration}%
-The structure of the address entries in the address file was discussed
-in detail in \autoref{sec:scrlttr2.addressFile} from
-\DescPageRef{scrlttr2.cmd.adrentry} onwards. The division of
-the address file with the help of \Macro{adrchar} or \Macro{addrchar},
-also discussed therein, has no meaning for \Package{scraddr} and is
-simply ignored.
-
-The commands for accessing the data are given by the name of the data
-field they are intended for.
+The structure of the address entries in the address file was discussed in
+detail in \autoref{sec:scrlttr2.addressFile}, starting on
+\DescPageRef{scrlttr2.cmd.adrentry}. The subdivision of the address file with
+the help of \Macro{adrchar} or \Macro{addrchar}, also discussed there, has no
+meaning for \Package{scraddr} and is simply ignored by the package.%
+\EndIndexGroup
\begin{Declaration}
\Macro{Name}\Parameter{key}%
@@ -111,35 +112,32 @@ field they are intended for.
\Macro{FreeIII}\Parameter{key}%
\Macro{FreeIV}\Parameter{key}
\end{Declaration}%
-These commands give access to data of your address file. The last
-parameter, i.\,e., parameter 8 for the \DescRef{\LabelBase.cmd.adrentry} entry and
-parameter 9 for the \DescRef{\LabelBase.cmd.addrentry} entry, is the identifier of an
-entry, thus the \PName{key} has to be unique and non-blank. The
-\PName{key} should only be composed of multiple uppercase letters out of the
-namespace of \TeX{} macro names.
+These commands give access to data of your address file. The last parameter,
+that is, parameter 8 for the \DescRef{\LabelBase.cmd.adrentry} entry and
+parameter 9 for the \DescRef{\LabelBase.cmd.addrentry} entry, is the
+identifier of an entry, thus the \PName{key} has to be unique and non-empty.
+To guarantee safe functioning, you should use only ASCII letters in the
+\PName{key}.
-If the file contains more than one entry with the same \PName{key}
-value, the last occurrence will be used.%
-%
-\EndIndexGroup
-%
-\EndIndexGroup
+Furthermore, if the file contains more than one entry with the same
+\PName{key} name, the last occurrence will be used.%
%
\EndIndexGroup
\section{Usage}\seclabel{usage}
-
-First of all, we need an address file with valid address entries. In
-this example the file has the name \File{lotr.adr} and contains the
-following entries.
+\BeginIndexGroup
+\BeginIndex[indexother]{Cmd}{addrentry}%
+\BeginIndex[indexother]{Cmd}{adrentry}%
+To use the package, we need a valid address file. For example, the file
+\File{lotr.adr} contains the following entries:
\begin{lstcode}
\addrentry{Baggins}{Frodo}%
{The Hill\\ Bag End/Hobbiton in the Shire}{}%
{Bilbo Baggins}{pipe-weed}%
{the Ring-bearer}{Bilbo's heir}{FRODO}
\adrentry{Gamgee}{Samwise}%
- {Bagshot Row 3\\Hobbiton in the Shire}{}%
+ {3 Bagshot Row\\Hobbiton in the Shire}{}%
{Rosie Cotton}{taters}%
{the Ring-bearer's faithful servant}{SAM}
\adrentry{Bombadil}{Tom}%
@@ -148,64 +146,85 @@ following entries.
{The Master of Wood, Water and Hill}{TOM}
\end{lstcode}
-The 4th parameter, the telephone number, has been
-left blank. If you know the story behind these addresses you will
-agree that a telephone number makes no sense here, and besides, it
-should simply be possible to leave them out.
+The fourth parameter, the telephone number, has been left blank, since there
+are no phones in Middle Earth. And as you can see, blank fields are possible.
+On the other hand, you cannot simply omit an argument altogether.
-The command
-\Macro{InputAddressFile} is used to load the address file shown above:
+\BeginIndexGroup
+\BeginIndex[indexother]{Cmd}{InputAddressFile}
+With the \Macro{InputAddressFile} command described above, we read the address
+file into our letter document:
\begin{lstcode}
\InputAddressFile{lotr}
\end{lstcode}
+\EndIndexGroup
-
-With the help of the commands introduced in this chapter we can now
-write a letter to old \textsc{Tom Bombadil}. In this letter we ask
-him if he can remember two fellow-travelers from Elder Days.
+\BeginIndexGroup
+\BeginIndex[indexother]{Cmd}{Name}%
+\BeginIndex[indexother]{Cmd}{Address}%
+\BeginIndex[indexother]{Cmd}{FirstName}%
+\BeginIndex[indexother]{Cmd}{LastName}%
+\BeginIndex[indexother]{Cmd}{FreeI}%
+\BeginIndex[indexother]{Cmd}{FreeII}%
+\BeginIndex[indexother]{Cmd}{FreeIII}%
+\BeginIndex[indexother]{Cmd}{FreeIV}%
+\BeginIndex[indexother]{Cmd}{Comment}%
+With the help of the commands introduced in this chapter we can now write a
+letter to old \textsc{Tom Bombadil}, in which we ask him if he can remember
+two companions from olden times.
\begin{lstcode}
\begin{letter}{\Name{TOM}\\\Address{TOM}}
\opening{Dear \FirstName{TOM} \LastName{TOM},}
- or \FreeIII{TOM}, how your delightful \FreeI{TOM} calls you. Can
- you remember Mr.\,\LastName{FRODO}, strictly speaking
- \Name{FRODO}, since there was Mr.\,\FreeI{FRODO} too. He was
- \Comment{FRODO} in the Third Age and \FreeIV{FRODO} \Name{SAM},
- \Comment{SAM}, has attended him.
+ Or \FreeIII{TOM}, as your beloved \FreeI{TOM} calls you. Do
+ you still remember Mr \LastName{FRODO}, or more precisely
+ \Name{FRODO}, since there was also Mr \FreeI{FRODO}. He was
+ \Comment{FRODO} in the Third Age and \FreeIV{FRODO}. \Name{SAM},
+ \Comment{SAM}, accompanied him.
- Their passions were very worldly. \FirstName{FRODO} enjoyed
- smoking \FreeII{FRODO}, his attendant appreciated a good meal with
- \FreeII{SAM}.
+ Their passions were very worldly. \FirstName{FRODO} enjoyed
+ smoking \FreeII{FRODO}. His companion appreciated a good meal
+ with \FreeII{SAM}.
Do you remember? Certainly Mithrandir has told you much
- about their deeds and adventures .
+ about their deeds and adventures.
\closing{``O spring-time and summer-time
and spring again after!\\
O wind on the waterfall,
and the leaves' laughter!''}
\end{letter}
\end{lstcode}
-In the address of letters often both firstname and lastname are required, als
-shown above in \DescRef{scrlttr2.cmd.opening}. Thus, the command
-\Macro{Name}\PParameter{key} is an abridgement for
-\Macro{FirstName}\PParameter{key} \Macro{LastName}\PParameter{key}.
-
-The 5th and 6th parameters of the \DescRef{\LabelBase.cmd.adrentry} or \DescRef{\LabelBase.cmd.adrentry}
-commands are for free use. They are accessible with the commands
-\Macro{FreeI} and \Macro{FreeII}. In this example, the 5th parameter contains
-the name of a person who is the most important in the life of the entry's
-person, the 6th contains the person's passion. The 7th parameter is a comment
-or in general also a free parameter. The commands \Macro{Comment} or
-\Macro{FreeIII} give access to this data. Use of \Macro{FreeIV} is only valid
-for \DescRef{\LabelBase.cmd.addrentry} entries; for \DescRef{\LabelBase.cmd.adrentry} entries
-it results in an error. More on this is covered in the next section.
+You can also produce the combination of \Macro{FirstName}\Parameter{key} and
+\Macro{LastName}\Parameter{key} used in the \DescRef{scrlttr2.cmd.opening} of
+this letter with \Macro{Name}\PParameter{key}.
+
+You can use the fifth and sixth parameters of the
+\DescRef{\LabelBase.cmd.adrentry} or \DescRef{\LabelBase.cmd.adrentry} for any
+purpose you wish. You can access them with the \Macro{FreeI} and
+\Macro{FreeII} commands. In this example, the fifth parameter contains the
+name of the most important person in the life of the person in the entry. The
+sixth contains the person's favourite thing. The seventh parameter is a
+comment or in general also a free parameter. You can access it with the
+\Macro{Comment} or \Macro{FreeIII} commands. \Macro{FreeIV} is only valid for
+\DescRef{\LabelBase.cmd.addrentry} entries. For
+\DescRef{\LabelBase.cmd.adrentry} entries, it results in an error. You can
+find more details in the next section.
+%
+\EndIndexGroup
+\EndIndexGroup
\section{Package Warning Options}
-As mentioned above, the command \Macro{FreeIV} leads to an error if it is used
-for \DescRef{\LabelBase.cmd.adrentry} entries. How \Package{scraddr} reacts in
-such a situation is decide by package options.
+As mentioned above, you cannot use the \Macro{FreeIV} command with
+\DescRef{\LabelBase.cmd.adrentry} entries. However, you can configure how
+\Package{scraddr} reacts in such a situation by package options.
+Note\textnote{Attention!} that this package does not support the extended
+options interface with \DescRef{maincls.cmd.KOMAoptions} and
+\DescRef{maincls.cmd.KOMAoption}. You should therefore specify the options
+either as global options in \DescRef{maincls.cmd.documentclass} or as local
+options in \DescRef{maincls.cmd.usepackage}
+
\begin{Declaration}
\Option{adrFreeIVempty}%
@@ -213,25 +232,22 @@ such a situation is decide by package options.
\Option{adrFreeIVwarn}%
\Option{adrFreeIVstop}%
\end{Declaration}%
-These four options allow the user to choose between \emph{ignore} and
-\emph{rupture} during the {\LaTeX} run if \Macro{FreeIV} has been used
-with an \DescRef{\LabelBase.cmd.adrentry} entry.
+These four options let you choose from four different reactions, ranging
+from \emph{ignore} to \emph{abort}, if \Macro{FreeIV} is used
+within an \DescRef{\LabelBase.cmd.adrentry} entry.
\begin{labeling}[~--]{\Option{adrFreeIVempty}}
\item[\Option{adrFreeIVempty}]
the command \Macro{FreeIV} will be ignored
\item[\Option{adrFreeIVshow}]
- ``(entry FreeIV undefined at \PName{key})'' will be
- written as warning in the text
+ the warning ``(entry FreeIV undefined at \PName{key})'' will be
+ written in the text
\item[\Option{adrFreeIVwarn}]
- writes a warning in the logfile
+ a warning is written in the logfile
\item[\Option{adrFreeIVstop}]
- the {\LaTeX} run will be interrupted with an error message
+ the \LaTeX{} run will abort with an error message
\end{labeling}
-To choose the desired reaction, one of these options can be given in
-the optional argument of the \Macro{usepackage} command. The default
-setting is \Option{adrFreeIVshow}.%
-%
+The default setting is \Option{adrFreeIVshow}.%
\EndIndexGroup
%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbase.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbase.tex
index a6f4778ea9c..714e020a933 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbase.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbase.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrbase.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrbase.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,146 +46,106 @@
% ======================================================================
\KOMAProvidesFile{scrbase.tex}
- [$Date: 2017-04-22 16:16:15 +0200 (Sat, 22 Apr 2017) $
+ [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
KOMA-Script package scrbase]
-\translator{Markus Kohm\and Melvin Hendrix}
+\translator{Markus Kohm\and Melvin Hendrix\and Karl Hagen}
-% Date of the translated German file: 2017-04-13
+% Date of the translated German file: 2018-02-15
-\chapter{Basic Functions of Package \Package{scrbase}}
+\chapter{Basic Functions in the \Package{scrbase} Package}
\labelbase{scrbase}
\BeginIndexGroup
\BeginIndex{Package}{scrbase}%
-The package \Package{scrbase} provides basic features designed and implemented
-for use by authors of packages and classes. However, \Package{scrbase} cannot
-only by used for wrapper classes related to \KOMAScript{} class. Authors of
-classes that have nothing to do with \KOMAScript{} can benefit from
-\Package{scrbase} functionality.
+The \Package{scrbase} package provides basic features intended for use by
+authors of packages and classes. Its use is not limited merely to wrapper
+classes which in turn load a \KOMAScript{} class. Authors of classes that
+otherwise have nothing to do with \KOMAScript{} can also benefit from the
+functionality of \Package{scrbase}.
\section{Loading the Package}
\seclabel{loadit}
-Whereas users load packages using \Macro{usepackage}, authors of packages or
+Whereas users load packages with \Macro{usepackage}, authors of packages or
classes should use \Macro{RequirePackage}\IndexCmd{RequirePackage}. Authors of
-wrapper packages may also use \Macro{RequirePackageWithOptions}. Command
-\Macro{RequirePackage} has the same optional argument for package options like
-\Macro{usepackage}. In contrast, \Macro{RequirePackageWithOptions} does not
-have an optional argument but passes all options given when loading the
-wrapper package to the required package. See \cite{latex:clsguide} for more
-information about these commands.
-
-The package \Package{scrbase} needs the functionality of package
-\Package{keyval}\IndexPackage{keyval} internally. This may be provided by
-package \Package{xkeyval} alternatively. Package \Package{scrbase} loads
-\Package{keyval} as needed.
-
-The package \Package{keyval} provides definition of keys and assignment of
-values to these keys. The options provided by \Package{scrbase} also use
-\Package{keyval} syntax: \PName{key}\texttt{=}\PName{value}.
+wrapper packages can also use \Macro{RequirePackageWithOptions}. The
+\Macro{RequirePackage} command has the same optional argument for package
+options as \Macro{usepackage}. In contrast, \Macro{RequirePackageWithOptions}
+does not have an optional argument but passes to this package all the options
+that were previously given when loading the wrapper package or class. See
+\cite{latex:clsguide} for more information about these commands.
-\begin{Declaration}
- \OptionVName{internalonly}{value}
-\end{Declaration}
-Package \Package{scrbase} provides some commands for conditional
-execution. The primary names for these are builds like
-\Macro{scr@\PName{name}}, which are internal commands. \KOMAScript{} only uses
-these internal commands internally. Authors of packages and classes may use
-these internal commands, too, but should not redefine them. Because some of
-these commands are useful for users, too, they are provided as
-\Macro{\PName{name}} normally. But eventually, other packages may provide
-commands with the same name but different syntax or different
-functionality. As this would result in an conflict, \Package{scrbase} can
-suppress the definition of the user commands \Macro{\PName{name}}. Using
-option \Option{internalonly} without \PName{value} will define only the
-internal commands and suppress definition of all the user commands for
-conditional execution. Alternatively, the user may give all the commands that
-should not be defined as \PName{value}, but replaces ``\Macro{}'' by
-``\texttt{/}''.
-
-Authors of packages and classes normally should not use this option. Users may
-use it with or without \PName{value} either as a global option with
-\Macro{documentclass} or using \Macro{PassOptionsToPackage}.
-\begin{Example}
- The user does not want \Package{scrbase} to define commands \Macro{ifVTeX}
- and \DescRef{\LabelBase.cmd.ifundefinedorrelax}. Because of this, to load the class, the user
- writes:
-\begin{lstcode}
- \documentclass%
- [internalonly=/ifVTeX/ifundefinedorrelax]%
- {foo}
-\end{lstcode}
- Class name \Class{foo} is, therefore, an placeholder
- for any class in this example. The meanings of commands \Macro{ifVTeX} and
- \DescRef{\LabelBase.cmd.ifundefinedorrelax} and many more commands for conditional execution
- is located in \autoref{sec:scrbase.if}.
-\end{Example}
-%
-\EndIndexGroup
+The \Package{scrbase} package needs the functionality of the
+\Package{keyval}\IndexPackage{keyval} package internally. This can also be
+provided by the \Package{xkeyval} package. If needed, \Package{scrbase} itself
+loads \Package{keyval}.
+
+The \Package{keyval} package lets you define keys and assign values to them.
+The options provided by \Package{scrbase} also use \Package{keyval} syntax:
+\PName{key}\texttt{=}\PName{value}.
\section{Keys as Attributes of Families and their Members}
\seclabel{keyvalue}
As already mentioned in \autoref{sec:scrbase.loadit}, \Package{scrbase} uses
-package \Package{keyval} for keys and values of keys. Nevertheless
-\Package{scrbase} extends the functionality of \Package{keyval}. Whereas only
-one family owns all keys of \Package{keyval}, \Package{scrbase} recognises
-also family members. Therefore, a key may be owned by a family or by one or
-more family members. Additionally, a value may be assigned to the key of a
-family member, to the key of a family, or to the keys of all family members.
+the \Package{keyval} package to set keys and their values. However,
+\Package{scrbase} extends this functionality. Whereas with \Package{keyval} a
+key belongs to only one family, \Package{scrbase} also recognizes family
+members. A key can therefore belong to both a family and one or more family
+members. Additionally, you can assign a value to the key of a family member,
+to the key of a family, or to the keys of all family members.
\begin{Declaration}
\Macro{DefineFamily}\Parameter{family}%
- \Macro{DefineFamilyMember}\OParameter{family member}\Parameter{family}%
+ \Macro{DefineFamilyMember}\OParameter{member}\Parameter{family}%
\end{Declaration}
-\Package{scrbase} needs to know the members of a family for different
-reasons. First, you have to define a new family using
-\Macro{DefineFamily}, which produces an empty member list. If the family
-has already been defined nothing would happen. Nothing also means that an
-already existing member list would not be overwritten.
-
-Next, a new member can be added to the family using
-\Macro{DefineFamilyMember}. If the family does not exist, this would result in
-an error message. If the member already exists, nothing happens. If the
-optional \PName{family member} is omitted, the default value
-``\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}'' is used. During
-class or package loading \Macro{@currname} and \Macro{@currext} together
-represent the file name of the class or package.
+\Package{scrbase} needs to know the members of a family for various reasons.
+Therefore, you must first define a new family using \Macro{DefineFamily},
+which produces an empty member list. If the family has already been defined,
+nothing happens. Therefore an existing member list will not be overwritten.
+
+Next, you can add a new member to the family using \Macro{DefineFamilyMember}.
+If the family does not exist, this will result in an error message. If the
+member already exists, nothing happens. If the optional \PName{member} is
+omitted, the default value
+``\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}'' is used. While
+the class or package is being loaded, \Macro{@currname} and \Macro{@currext}
+together represent the file name of the class or package.
Theoretically, it is possible, to define a member without a name using an
-empty optional \PName{family member} argument. But this is the same as the
-family itself. It is recommended that only letters and digits be used for
-\PName{family} and the first character of \PName{family member} should not be
-a letter or digit. Otherwise, it could happen that members of one family are
-the same as members of another family.
-
-\Package{scrbase} assigns family ``\PValue{KOMA}'' to itself and adds member
-``\PValue{.scrbase.sty}'' to it. Family ``\PValue{KOMA}'' is reserved to
-\KOMAScript{}. For your own packages, use the name of the bundle as
-\PName{family} and the name of the package as \PName{family member} of that
-\PName{family}.
+empty optional \PName{member} argument. But this is the same as the family
+itself. You should use only letters and digits for the \PName{family} name,
+and the first character of \PName{member} should be something else, preferably
+a point. Otherwise, it could happen that the members of one family will clash
+with the members of other families.
+
+\Package{scrbase} assigns the family ``\PValue{KOMA}'' to itself and adds the
+member ``\PValue{.scrbase.sty}''. The values ``\PValue{KOMA}'' and
+``\PValue{KOMAarg}'' are reserved for \KOMAScript{}. If you are creating a
+bundle of packages, you should use the name of the bundle as \PName{family}
+and the name of each package as \PName{member} of that \PName{family}.
%
\begin{Example}
- Assume you are writing a bundle called ``master butcher''. Within that
- bundle you have packages \File{salami.sty}, \File{liversausage.sty}, and
- \File{kielbasa.sty}. Therefore, you decide to use family name
- ``\PValue{butcher}'' and,to each of the package file, you add the lines
+ Suppose you are writing a bundle called ``master butcher''. Within that
+ bundle, you have the packages \File{salami.sty}, \File{mettwurst.sty},
+ and \File{kielbasa.sty}. Therefore, you decide to use family name
+ ``\PValue{butcher}'' and you add the lines
\begin{lstcode}
\DefineFamily{butcher}
\DefineFamilyMember{butcher}
\end{lstcode}
- When loading the three packages, this will
- add the members ``\PValue{.salami.sty}'', ``\PValue{.liversausage.sty}'',
+ to each of the package files. When loading the three packages, this will
+ add the members ``\PValue{.salami.sty}'', ``\PValue{.mettwurst.sty}'',
and ``\PValue{.kielbasa.sty}'' to the family ``\PValue{butcher}''. After
- loading all three packages, all three member will be defined.
+ loading all three packages, all three members will be defined.
\end{Example}
%
\EndIndexGroup
\begin{Declaration}
- \Macro{DefineFamilyKey}\OParameter{family member}\Parameter{family}%
+ \Macro{DefineFamilyKey}\OParameter{member}\Parameter{family}%
\Parameter{key}%
\OParameter{default}\Parameter{action}%
\Macro{FamilyKeyState}%
@@ -194,71 +154,77 @@ the same as members of another family.
\Macro{FamilyKeyStateUnknownValue}%
\Macro{FamilyKeyStateNeedValue}
\end{Declaration}
-The command \Macro{DefineFamilyKey} defines a \PName{key}. If a \PName{family
- member} is given, the \PName{key} becomes an attribute of that member in the
-given \PName{family}. If a \PName{family member} is not given, the member
-``\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}'' is assumed. If,
-later, a value is assigned to the \PName{key}, the \PName{action} will be
-executed and the value made an argument of \PName{action}. So inside
-\PName{action} ``\lstinline{#1}'' would be that value. If the value is
-omitted, the \PName{default} is used instead. If there is no \PName{default},
-the \PName{key} can be used only with a value being defined.
-
-\begin{Explain}
+The \Macro{DefineFamilyKey} command defines a \PName{key}. If you specify a
+\PName{member}, the \PName{key} becomes an attribute of that member in the
+given \PName{family}. If you do not specify a \PName{member}, the member
+``\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}'' is assumed. If you
+later assign a value to the \PName{key}, the \PName{action} will be
+executed and the value made an argument of \PName{action}. Within
+\PName{action}, ``\lstinline{#1}'' stands for that value. If you omit the value,
+the \PName{default} is used instead. If you do not specify a \PName{default},
+the \PName{key} then always requires you to pass an explicit value.
+
+%\begin{Explain}
\phantomsection\label{explain:scrbase.macro.DefineFamilyKey}%
- At least
+ Ultimately,
\begin{lstcode}[escapeinside=`']
\DefineFamilyKey[`\PName{member}']{`\PName{family}'}{`\PName{key}'}
[`\PName{default}']{`\PName{action}'}
\end{lstcode}
- will result in a call of
+ results in a call to
\begin{lstcode}[moretexcs={define@key},escapeinside=`']
\define@key{`\PName{family\,member}'}{`\PName{key}'}
[`\PName{default}']{`\PName{extended action}'}
\end{lstcode}
- with \Macro{define@key} provided by package
- \Package{keyval}\IndexPackage{keyval} (see \cite{package:keyval}). However,
- the call of \Macro{define@key} and the \PName{action} is, in fact,
- extended by additional arrangements.
-\end{Explain}
-
-Success\ChangedAt{v3.12}{\Package{scrbase}} or failure of the execution of the
-\PName{action} should be reported back to \Package{scrbase} by
-\Macro{FamilyKeyState}. The package itself will take care of additional
-procedures if needed. You should not report errors by yourself! The default
-state before execution of \PName{action} is
-\Macro{FamilyKeyStateUnknown}. This signals that it is not known whether or
-not the execution is successful. If this state does not change until end of
-execution of the \PName{action}, \Package{scrbase} will write a message into
-the \File{log} file and assumes state \Macro{FamilyKeyStateProcessed} during
-the further procedure.
-
-State \Macro{FamilyKeyStateProcessed} signals that the option and the value
-assignment to the option are completely and successfully finished. You may
-switch to this state by using \Macro{FamilyKeyStateProcessed} itself.
-
-State \Macro{FamilyKeyStateUnknownValue} indicates that the option was
-handled, but the value, that should be assigned to the key, was unknown or not
-allowed. You should use \Macro{FamilyKeyStateUnknownValue} to switch to
-this state.
-
-State \Macro{FamilyKeyStateNeedValue} signals that the option could not be
-set because it needs a value, but no value was assigned to the
-key. This state is used automatically, whenever an option has been
-defined without \PName{default} value and is used without value
-assignment. You should not set the state using \Macro{FamilyKeyStateNeedValue}
-yourself.
-
-Last but not least you may switch to additional failure states, simply
-re-defining \Macro{FamilyKeyState} with a very short text message.
-Generally, the four predefined states should be sufficient.
+ where \Macro{define@key} is provided by the
+ \Package{keyval}\IndexPackage{keyval} package (see \cite{package:keyval}).
+ However, there are some additional precautions taken with the call to
+ \Macro{define@key}, and the \PName{action} will be extended to include these
+ precautions.
+%\end{Explain}
+
+Success\ChangedAt{v3.12}{\Package{scrbase}} or failure in executing the
+\PName{action} should be reported back to \Package{scrbase} through
+\Macro{FamilyKeyState} so that the package itself can take further action as
+needed. This could be, for example, an error message or merely warning of an
+unknown option. You should not report errors directly!
+
+The default state of \PName{action} before execution is
+\Macro{FamilyKeyStateUnknown}. This indicates that it is not known whether or
+not the key could be processed successfully. If this state remains unchanged
+after the \PName{action} has been executed, \Package{scrbase} writes a
+message to the \File{log} file and assumes the that state is
+\Macro{FamilyKeyStateProcessed}.
+
+The \Macro{FamilyKeyStateProcessed} state indicates that the key and the value
+assigned to it have been successfully processed and everything is OK. You can
+switch to this state by calling \Macro{FamilyKeyStateProcessed} itself.
+
+The \Macro{FamilyKeyStateUnknownValue} state indicates that the key has been
+processed but that the value passed to it was either unknown or not allowed.
+For example, \hyperref[cha:typearea]{\Package{typearea}} reports this
+condition if you try to set the \DescRef{typearea.option.twoside} option to
+\PValue{unknown}. You can set this state by simply calling
+\Macro{FamilyKeyStateUnknownValue}.
+
+The \Macro{FamilyKeyStateNeedValue} state indicates that the key could not be
+processed because it expects a value, but it was called without such a value.
+This state is set automatically if you use a key that does not have a
+\PName{default} value without assigning a value. Theoretically, you could
+set this state explicitly with \Macro{FamilyKeyStateNeedValue}, but you should
+not need to set it yourself.
+
+In addition, you can define additional error conditions by redefining
+\Macro{FamilyKeyState} with a short text message. Generally, however, the four
+predefined states should be sufficient.
\begin{Example}
- Assume each of the three packages from the previous example should get a
- key named \PValue{coldcuts}. When used, a switch is set at each of
- the packages. For package \Package{salami} this may be:
+ Suppose each of the three packages from the previous example should have a
+ key named \PValue{coldcuts}. When used, a switch should be set in each of
+ the packages. For the \Package{salami} package, for example, this could look
+ like this:
\begin{lstcode}
- \newif\if@Salami@Aufschnitt
+ \newif\if@salami@coldcuts
\DefineFamilyKey{butcher}%
{coldcuts}[true]{%
\expandafter\let\expandafter\if@salami@coldcuts
@@ -266,67 +232,75 @@ Generally, the four predefined states should be sufficient.
\FamilyKeyStateProcessed
}
\end{lstcode}
- Available values for the key are \PValue{true} or \PValue{false} in this
- case. Instead of testing on inappropriate values, success will be signalled
- for any case in this example. If the key is used later, it is executed with
- one of the allowed values or without assignment. In the second case, the
- default \PName{true} will be used.
-
- The definitions in the other packages are similar. Only ``\texttt{salami}''
- has to be replaced by the corresponding names.
+ When called, the value will therefore be either \PValue{true} or
+ \PValue{false}. This example does not test for illegal values. Instead,
+ it is always reported that the key was processed completely and correctly.
+ If the key is used later, one of the permitted values, or no value, must be
+ used. In the second case, the default \PName{true} value will be used.
+
+ The definitions for the other packages are similar. Only ``\texttt{salami}''
+ has to be replaced by the respective names.
\end{Example}
%
\EndIndexGroup
\begin{Declaration}
- \Macro{RelaxFamilyKey}\OParameter{family member}\Parameter{family}%
+ \Macro{RelaxFamilyKey}\OParameter{member}\Parameter{family}%
\Parameter{key}
\end{Declaration}
-If\ChangedAt{v3.15}{\Package{scrbase}} the \PName{key} of the \PName{family
- member} of \PName{family} has been defined before, that definition will be
-cancelled. Afterwards the \PName{key} will not be defined for the \PName{family
- member} of \PName{family} any longer. Usage of \Macro{RelaxFamilyKey} for a
-not yet defined \PName{key} of the \PName{family member} of the \PName{family}
-is also allowed.%
+If\ChangedAt{v3.15}{\Package{scrbase}} a \PName{key} has been previously
+defined as a \PName{member} of a \PName{family}, that definition will be
+cancelled. Afterwards the \PName{key} will no longer be defined for this
+\PName{member} of the \PName{family}. You can use \Macro{RelaxFamilyKey} for a
+\PName{key} that is not defined for this \PName{member} of the \PName{family}.
+
+If you do not specify a \PName{member}, then the member
+``\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}'' is assumed, just as
+with \DescRef{\LabelBase.cmd.DefineFamilyKey}. However, \Macro{RelaxFamilyKey}
+is only rarely used while loading a package rather than at runtime. Therefore
+the \PName{member} should usually be specified explicitly as well.%
\EndIndexGroup
\begin{Declaration}
- \Macro{FamilyProcessOptions}\OParameter{family member}\Parameter{family}
+ \Macro{FamilyProcessOptions}\OParameter{member}\Parameter{family}
\end{Declaration}
-Generally the extension of keys of families to keys of families and family
-members, as mentioned earlier, uses keys or key-value settings as class or
-package options. The command \Macro{FamilyProcessOptions} is an extension of
-\Macro{ProcessOption*} from \LaTeX{} kernel (see \cite{latex:clsguide}, which
-processes not only options that has been declared using \Macro{DeclareOption},
-it processes all keys of the given family member. If the optional argument
-\PName{family member} is omitted, family member
+In essence, extending keys from families to both families and family members
+means that either keys or key-value pairs can be used as normal class or
+package options. The \Macro{FamilyProcessOptions} command is an extension of
+\Macro{ProcessOption*} from the \LaTeX{} kernel (see \cite{latex:clsguide},
+which processes not only options declared with \Macro{DeclareOption}, but also
+all keys of the given member. If you omit the optional argument
+\PName{member}, the member
``\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}'' is used.
-Somehow special are keys that are not attached to a family member, but to a
-family. These are keys with an empty family member. Such keys are set before
-the keys of the family members.
+One feature worth noting is that keys which are attached not to a family
+member but to a family have an empty family member. Such keys are set before
+the keys of the members.
\begin{Example}
- If a package in the previous example would be extended by the line
+ If, in the packages from the previous example, you add the line
\begin{lstcode}
\FamilyProcessOptions{butcher}
\end{lstcode}
- then the user may select the option \Option{coldcuts} when loading the
- package. If the option is used globally, this means at the optional
- argument of \Macro{documentclass}, then the option would be passed
- automatically to all three packages, if all three packages are loaded
- later.
+ after you define the key, you can specify the \Option{coldcuts} option when
+ loading the package. If you specify the option globally in
+ \Macro{documentclass}, the option will be passed automatically to all three
+ packages if they are loaded later.
\end{Example}
-Please note\textnote{Attention!} that packages always process global options
-before local options. When processing unknown options initiate an entry in the
-\File{log}-file and the option is otherwise ignored. By contrast, unknown
-options assigned to the package locally leads to an error message.
+Note\textnote{Attention!} that packages always process global options
+before local options. While unknown global options result in an entry in the
+\File{log} file and the option being otherwise ignored, unknown local
+options result in an error message.
-\Macro{FamilyProcessOptions} may be interpreted either as an extension of
-\Macro{ProcessOption*} or as an extension of the \PName{key=value} mechanism
+You can think of \Macro{FamilyProcessOptions} as an extension of either
+\Macro{ProcessOption*} or the \PName{key=value} mechanism
of \Package{keyval}. Ultimately, with the help of
\Macro{FamilyProcessOptions}, \PName{key=value} pairs become options.%
+
+As with\textnote{Attention!} \Macro{ProcessOptions},
+\Macro{FamilyProcessOptions} must not be used while executing options code.
+In particular, you cannot load packages while processing options.%
%
\EndIndexGroup
@@ -335,60 +309,60 @@ of \Package{keyval}. Ultimately, with the help of
\Macro{BeforeFamilyProcessOptions}\OParameter{member}\Parameter{family}%
\Parameter{code}%
\end{Declaration}
-Especially\ChangedAt{v3.18}{\Package{scrbase}} authors of wrapper classes or
-wrapper packages sometimes need a hook to execute \PName{code} just before
-\DescRef{\LabelBase.cmd.FamilyProcessOptions}. The package \Package{scrbase}
-provides such a hook and you can add \PName{code} to it using
-\Macro{BeforeFamilyProcessOptions}. The parameters \PName{member} and
-\PName{family} are same to \DescRef{\LabelBase.cmd.FamilyProcessOptions}. In
-difference to \DescRef{\LabelBase.cmd.FamilyProcessOptions} you can add
-\PName{code} also to the hook of not yet defined \PName{family} or
-\PName{member}.
-
-Note, the hook of a family member will be cleaned after execution. But if you
-use an empty \PName{member} the \PName{code} will be executed before the
-\DescRef{\LabelBase.cmd.FamilyProcessOptions} of every member of the \PName{family} and will
-never be deleted.
+Authors\ChangedAt{v3.18}{\Package{scrbase}} of wrapper classes in particular
+sometimes need a hook to execute \PName{code} before
+\DescRef{\LabelBase.cmd.FamilyProcessOptions}. The \Package{scrbase} package
+provides such a hook, and you can add \PName{code} to it with
+\Macro{BeforeFamilyProcessOptions}. The \PName{member} and \PName{family}
+parameters are same as those of \DescRef{\LabelBase.cmd.FamilyProcessOptions}.
+However, you can also add \PName{code} to the hook for families or members
+that have not yet been defined.
+
+Note that the hook of a family member is automatically deleted after it is
+executed. But if you use an empty \PName{member}, this hook\Index{hook} will
+be executed for every member of the \PName{family} and will not be deleted.
\begin{Example}
- Now, you are writing a package that loads \Package{liversausage}. But you do
- not provide option \Option{coldcut} with this package. So you use
- \Macro{BeforeFamilyProcessOptions} to deactivate
- that option before loading the package:
+ You are writing a \Package{smokedsausage} package that loads
+ \Package{mettwurst}. But you do not want to be able to set the
+ \Option{coldcut} option with this package. So you use
+ \Macro{BeforeFamilyProcessOptions} to deactivate that option before you load
+ the package:
\begin{lstcode}
\RequirePackage{scrbase}
- \BeforeFamilyProcessOptions[.liversausage.sty]{butcher}{%
- \RelaxFamilyKey[.liversausage.sty]{butcher}{coldcut}%
+ \BeforeFamilyProcessOptions[.mettwurst.sty]{butcher}{%
+ \RelaxFamilyKey[.mettwurst.sty]{butcher}{coldcut}%
}
- \RequirePackageWithOptions{liversausage}
+ \RequirePackageWithOptions{mettwurst}
\end{lstcode}
- If after this a user tries to load your package with option
- \Option{coldcut}, package \Package{liversausage} will throw an undefined
- option error. If \Option{coldcut} is used as a global option, package
- \Package{liversausage} will ignore it. But default settings inside
- \Package{liversausage}, e.\,g., using \DescRef{\LabelBase.cmd.FamilyExecuteOptions} before
- \DescRef{\LabelBase.cmd.FamilyProcessOptions} are not effected.
+ If a user tries to load your package with the \Option{coldcut} option, the
+ \Package{mettwurst} package will throw an undefined option error. If
+ \Option{coldcut} is used as a global option, the \Package{mettwurst}
+ package will ignore it. But default settings inside \Package{mettwurst},
+ for example using \DescRef{\LabelBase.cmd.FamilyExecuteOptions} before
+ \DescRef{\LabelBase.cmd.FamilyProcessOptions} are not affected. Of course,
+ you can also insert your own default for \Package{smokedsausage} via
+ \Macro{BeforeFamilyProcessOptions} in \Package{mettwurst}.
\end{Example}
\EndIndexGroup
\begin{Declaration}
- \Macro{FamilyExecuteOptions}\OParameter{family member}\Parameter{family}%
+ \Macro{FamilyExecuteOptions}\OParameter{member}\Parameter{family}%
\Parameter{options list}
\end{Declaration}
This command is an extension of \Macro{ExecuteOptions} from the \LaTeX{}
kernel (see \cite{latex:clsguide}). The command processes not only options
-that are defined using \Macro{DeclareOption}, but also processes all keys of
-the given \PName{family member}. If the optional argument \Macro{family
- member} is omitted, then
+defined with \Macro{DeclareOption} but also all keys of the given
+\PName{family}. If you omit the optional argument \Macro{member},
``\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}'' is used.
-Somehow special are keys of empty family members, which are not attached to a
-family member, but to a family. Such keys are set before the keys of family
-members.
+One feature worth noting is that keys which are attached not to a family
+member but to a family have an empty family member. Such keys are set before
+the keys of the members.
\begin{Example}
- Assume option \Option{coldcuts} should be set by default in the
- previous example. In this case only line
+ Suppose the \Option{coldcuts} option should be set by default in the
+ previous examples. In this case only line
\begin{lstcode}
\FamilyExecuteOptions{butcher}{coldcuts}
\end{lstcode}
@@ -396,14 +370,15 @@ members.
\end{Example}
If\ChangedAt{v3.20}{\Package{scrbase}} you call \Macro{FamilyExecuteOptions}
-with an unknown option inside the \PName{options list}, you will get an
-error. But you will not get an error, if the \PName{family member} has an
-option \Option{@else@}. In this case option \Option{@else@} will be used
-instead of the unknown option. \KOMAScript{} itself uses this feature, e.\,g.,
-inside the definition of section like commands to prior the style attribute
-above all other attributes.
-
-Usage of the command inside the execution of an option is provided.%
+with an unknown option inside the \PName{options list}, you will get an error.
+An exception to this rule occurs when the \PName{member} has an option called
+\Option{@else@}. In this case, the \Option{@else@} option will be used instead
+of the unknown option. \KOMAScript{} itself uses this feature, for example
+inside the definition of sectioning commands, to evaluate the style option
+before all other attributes.
+
+You can also use this command inside the code executed when processing the
+option.%
%
\EndIndexGroup
@@ -411,27 +386,27 @@ Usage of the command inside the execution of an option is provided.%
\begin{Declaration}
\Macro{FamilyOptions}\Parameter{family}\Parameter{options list}%
\end{Declaration}
-Hence \PName{options list} is like:
+Unlike normal options defined with \Macro{DeclareOption}, the \PName{key}s can
+also be set after loading a class or package. To do this, you call
+\Macro{FamilyOptions}. The \PName{options list} has the form
\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
\PName{key}\texttt{=}\PName{value}\texttt{,}%
\PName{key}\texttt{=}\PName{value}\dots
\end{tabular}\vskip\dp\strutbox\end{flushleft}
-after which the value assignment may be omitted for \PName{key}s that have a
+after which the value assignment can be omitted for \PName{key}s that have a
defined default.
-In contrast to average options that are defined using \Macro{DeclareOption},
-the \PName{key}s also may be set after loading a class or package. For this,
-the user calls \Macro{FamilyOptions}. Thereafter, the \PName{key}s of all
-members of the specified family are set. If a \PName{key} also exists as a
-family attribute, then the family key is set first. After this, the member
-keys follow in the order in which the members have been defined. If a given
-\PName{key} does not exist, either for the family or for any member of the
-family, then \Macro{FamilyOptions} will result in an error. Package
-\Package{scrbase} reports an error also if there are members with key
-\PName{key}, but all those members signal failure via \DescRef{\LabelBase.cmd.FamilyKeyState}.
+The statement sets the keys of all members of the specified family. If a
+\PName{key} also exists as an attribute of the family itself, then the family
+key is set first, followed by the member keys in the order in which they were
+defined. If a given \PName{key} does not exist, either for the family or for
+any member of the family, then \Macro{FamilyOptions} will throw an error. An
+error also occurs if a \PName{key} exists for some members but each of those
+members returns an error through \DescRef{\LabelBase.cmd.FamilyKeyState}.
\begin{Example}
- You extend your butcher project by a package \Package{sausagesalad}. If this
- package has been loaded, all sausage package should generate cold cuts:
+ You extend your butcher project with a \Package{sausagesalad} package. If
+ this package has been loaded, all sausage packages should generate cold
+ cuts:
\begin{lstcode}
\ProvidesPackage{sausagesalad}%
[2008/05/06 nonsense package]
@@ -440,16 +415,16 @@ family, then \Macro{FamilyOptions} will result in an error. Package
\FamilyProcessOptions{butcher}\relax
\FamilyOptions{butcher}{coldcuts}
\end{lstcode}
- If currently none of the sausage packages are loaded, the undefined option
- \Option{coldcuts} leads to an error message. This is avoided by adding
- before the last line of the code above:
+ If no sausage package has yet been loaded, the undefined option
+ \Option{coldcuts} leads to an error message. You can avoid this by defining
+ a corresponding key for the package before the last line of the code above:
\begin{lstcode}
\DefineFamilyKey{butcher}%
{coldcuts}[true]{}%
\end{lstcode}
- However, sausage packages loaded after
- \Package{sausagesalad} still do not produce cold cuts. This may be corrected
- by editing the last line of the code again to:
+ However, sausage packages loaded after \Package{sausagesalad} still do not
+ produce cold cuts. You can correct this by replacing the previous command
+ with:
\begin{lstcode}
\AtBeginDocument{%
\DefineFamiyKey[.sausagesalad.sty]%
@@ -462,39 +437,45 @@ family, then \Macro{FamilyOptions} will result in an error. Package
{coldcuts=#1}}%
}%
\end{lstcode}
- This code does following: First the option will be defined while
- \Macro{begin}\PParameter{document} to do nothing for package
- \Package{sausagesalad}. Because \Macro{@currname} and \Macro{@currext} are
- not longer valid at this time, the optional argument on
- \DescRef{\LabelBase.cmd.DefineFamilyKey} has to be used. But until this re-definition of the
- option, a second definition is made, that calls the option again while
- \Macro{begin}\PParameter{document} for the whole family and so also for
- other sausage salad packages.
+ Thus, the option is defined during \Macro{begin}\PParameter{document} so
+ that it no longer functions for the \Package{sausagesalad} package. Because
+ \Macro{@currname} and \Macro{@currext} no longer contain the file name of
+ the package, you must use the optional argument of
+ \DescRef{\LabelBase.cmd.DefineFamilyKey}.
+
+ But until this redefinition is performed, it uses a definition that executes
+ the option again for the family and all its members during
+ \Macro{begin}\PParameter{document}, thus setting it for other sausage
+ packages. The delay in executing \Macro{FamilyOptions} is crucial here. For
+ one thing, it includes only the packages loaded afterwards. For another, it
+ ensures that its own \Option{coldcuts} option has already been redefined.
+ This avoids endless recursion.
\end{Example}
%
\EndIndexGroup
+\vskip-\ht\strutbox% Umbruchkorrektur wegen Beispiel am Ende
\begin{Declaration}
\Macro{FamilyOption}\Parameter{family}%
- \Parameter{option}\Parameter{values list}%
+ \Parameter{option}\Parameter{value list}%
\end{Declaration}
-Besides options that have concurrently excluding values, there may be options
-that produce several values at the same time. Using \DescRef{\LabelBase.cmd.FamilyOptions} for
-that type of option would result in using the same option several times with
-different value assignments. Instead of this, \Macro{FamilyOption} may be used
-to assign a whole \PName{values list} to the same \PName{option}. The
-\PName{values list} is a comma separated list of values, also known as
-\emph{csv}:
-\begin{flushleft}\begin{tabular}{l}
+In addition to options that have mutually exclusive values, there may be
+options that can take multiple values at the same time. To use
+\DescRef{\LabelBase.cmd.FamilyOptions} for that type of option, it would be
+necessary to invoke the same option several times with different value
+assignments. Instead, you can easily assign a whole list of values to a single
+\PName{option} using \Macro{FamilyOption}. The \PName{value list} is a comma
+separated list of values, also known as \emph{csv}:
+%\begin{flushleft}\begin{tabular}{l}
\PName{value}\texttt{,}\PName{value}\dots
-\end{tabular}\end{flushleft}
-By the way, please note that usage of a comma inside a value may be done only
-if the value is put inside braces. The general functionality of this command
-is the same as that of the previous command \DescRef{\LabelBase.cmd.FamilyOptions}.
+%\end{tabular}\end{flushleft}
+Note in this context that you can use a comma in a value by putting the value
+inside braces. This command's other functionality is the same previously
+described for \DescRef{\LabelBase.cmd.FamilyOptions}.
\begin{Example}
- Package \Package{sausagesalad} should have one mire option, to add
- additional ingredients. Each of the ingredients sets a switch as was done
+ The \Package{sausagesalad} package should have one more option to add
+ additional ingredients. Each of the ingredients sets a switch, as was done
previously for the cold cuts.
\begin{lstcode}
\newif\if@saladwith@onions
@@ -505,15 +486,14 @@ is the same as that of the previous command \DescRef{\LabelBase.cmd.FamilyOption
}
\end{lstcode}
Here the three ingredients ``onions'', ``gherkins'', and ``chillies'' have
- been defined. An error message for ``not defined'' ingredients does not
- exist.
+ been defined. There is no error message for unknown ingredients.
- For a salad with onions and gherkins the user may use
+ For a salad with onions and gherkins, you can use
\begin{lstcode}
\FamilyOptions{butcher}{%
ingredient=onions,ingredient=gherkins}
\end{lstcode}
- or shorter
+ or simply
\begin{lstcode}
\FamilyOption{butcher}
{ingredient}{onions,gherkins}
@@ -530,63 +510,65 @@ is the same as that of the previous command \DescRef{\LabelBase.cmd.FamilyOption
Sometimes\ChangedAt{v3.12}{\Package{scrbase}} it is useful to delay the
execution of an \PName{action} that is part of a value assignment to a key
until all assignments inside one
-\DescRef{\LabelBase.cmd.FamilyProcessOptions},
-\DescRef{\LabelBase.cmd.FamilyExecuteOptions},
-\DescRef{\LabelBase.cmd.FamilyOptions}, or
-\DescRef{\LabelBase.cmd.FamilyOption} is finished. This may be done using
-\Macro{AtEndOfFamilyOptions} or its star
-variation\ChangedAt{v3.23}{\Package{scrbase}} inside an option
-definition. Reporting failure states of \PName{action} is not possible in this
-case. Furthermore, the command should not be used outside an option
-definition.
-
-The variations differ in cases when execution of an option results in further
-option calls. In this case all actions of \Macro{AtEndOfFamilyOptions} will be
-executed when the inner-most option call returns. The actions of
-\Macro{AtEndOfFamilyOptions*} will be executed when the top-most option call
-returns. Nevertheless, the order of the actions of both commands is
-undefined!%
+\DescRef{\LabelBase.cmd.FamilyProcessOptions}\IndexCmd{FamilyProcessOptions},
+\DescRef{\LabelBase.cmd.FamilyExecuteOptions}\IndexCmd{FamilyExecuteOptions},
+\DescRef{\LabelBase.cmd.FamilyOptions}\IndexCmd{FamilyOptions}, or
+\DescRef{\LabelBase.cmd.FamilyOption}\IndexCmd{FamilyOptions} is finished.
+You can do this using \Macro{AtEndOfFamilyOptions} or its starred
+variant\ChangedAt{v3.23}{\Package{scrbase}} inside an option definition.
+However, reporting failure states of \PName{action} is not possible with this
+command, nor should it be used outside an option definition.
+
+The two variants differ in case there are nested option definitions, when
+executing an option requires further option calls. In this case all actions
+specified by \Macro{AtEndOfFamilyOptions} will be executed when the innermost
+option call returns. In contrast, the actions of \Macro{AtEndOfFamilyOptions*}
+are not executed until the outermost option call returns.
+However,\textnote{Attention!} the order of the actions of both commands is
+emphatically undefined! It is not guaranteed that the action requested first
+will be executed first, nor the converse.%
\EndIndexGroup
\begin{Declaration}
- \Macro{FamilyBoolKey}\OParameter{family member}\Parameter{family}%
+ \Macro{FamilyBoolKey}\OParameter{member}\Parameter{family}%
\Parameter{key}\Parameter{switch name}%
\Macro{FamilySetBool}\Parameter{family}%
\Parameter{key}\Parameter{switch name}\Parameter{value}
\end{Declaration}
-In the previous examples, boolean switches often have been used. In the example
-with option \Option{coldcuts}, it is necessary that the user assigns either
-value \PValue{true} or value \PValue{false}. There is no error message for
-wrong value assignment. Because of this, boolean switches are a necessary
-feature. Package \Package{scrbase} provides \Macro{FamilyBoolKey} for definition of
-such options. Therefore, the arguments \PName{family member}, \PName{family}, and
-\PName{key} are the same as that used by \DescRef{\LabelBase.cmd.DefineFamilyKey} (see
-\DescPageRef{scrbase.cmd.DefineFamilyKey}). Argument \PName{switch name}
-is the name of the switch without the prefix \Macro{if}. If a switch with this
-name does not exist already, \Macro{FamilyBoolKey} will define it and
-initialize it to \PName{false}. Internally \Macro{FamilyBooKey} uses
-\Macro{FamilySetBool} as \PName{action} of \DescRef{\LabelBase.cmd.DefineFamilyKey}. The
-\PName{default} for those options is always \PValue{true}.
-
-On the other hand, \Macro{FamilySetBool} understands \PName{value} \PValue{on}
-and \PValue{yes} beside \PName{true} for switching on and \PName{off} and
-\PName{no} beside \PName{false} for switching off. Unknown values will result
-in a call of \DescRef{\LabelBase.cmd.FamilyUnknownKeyValue} with the arguments
-\PName{family}, \PName{key}, and \PName{value}, which results in setting of
-\DescRef{\LabelBase.cmd.FamilyKeyState}. Depending on the command used and
-other family members, this may result in an error message about unknown value
-assignment (see also \DescPageRef{scrbase.cmd.FamilyUnknownKeyValue} and
+Boolean switches have been used several times in the previous examples. In the
+example with \Option{coldcuts} option, the user had to assign either
+\PValue{true} or \PValue{false} as a value. There was no error message if the
+user provided the wrong value. Because boolean switches are a common use case,
+you can easily define them with \Package{scrbase} using \Macro{FamilyBoolKey}.
+The \PName{member}, \PName{family}, and \PName{key} arguments are the same as
+those used by \DescRef{\LabelBase.cmd.DefineFamilyKey} (see
+\DescPageRef{scrbase.cmd.DefineFamilyKey}). The \PName{switch name} is the
+name of the switch without the prefix \Macro{if}. If a switch with this name
+does not exist already, \Macro{FamilyBoolKey} will define it and initialize it
+to \PName{false}. Internally, \Macro{FamilyBooKey} uses \Macro{FamilySetBool}
+as the \PName{action} of \DescRef{\LabelBase.cmd.DefineFamilyKey}. The
+\PName{default} for such an option is always \PValue{true}.
+
+\Macro{FamilySetBool}, on the other hand, accepts \PValue{on} and
+\PValue{yes}, in addition to \PName{true}, to turn the switch on, and
+\PName{off} and \PName{no}, in addition to \PName{false}, to turn it off.
+Unknown values will result in a call to
+\DescRef{\LabelBase.cmd.FamilyUnknownKeyValue} with the arguments
+\PName{family}, \PName{key}, and \PName{value}, which sets
+\DescRef{\LabelBase.cmd.FamilyKeyState} accordingly. As a result, an error
+message about an unknown value assignment is printed if necessary (see also
+\DescPageRef{scrbase.cmd.FamilyUnknownKeyValue} and
\DescPageRef{scrbase.cmd.FamilyKeyState}).
\begin{Example}
- The key \Option{coldcuts} should be declared somehow more
- robust. Additionally, all sausage packages should use the same key. So
- either all or none of them will produce cold cuts.
+ The key \Option{coldcuts} should be defined more robustly in the sausage
+ packages. Additionally, all sausage packages should use the same key, so
+ that either all sausage packages will produce cold cuts or none will.
\begin{lstcode}
\FamilyBoolKey{butcher}{coldcuts}%
{@coldcuts}
\end{lstcode}
- A test, whether or not to produce cold cuts, may be:
+ A test of whether to produce cold cuts would look like this:
\begin{lstcode}
\if@coldcuts
...
@@ -594,7 +576,7 @@ assignment (see also \DescPageRef{scrbase.cmd.FamilyUnknownKeyValue} and
...
\fi
\end{lstcode}
- This would be the same in each of the three sausage packages, thereby
+ This would be the same in all three sausage packages, thereby
defining the attribute ``coldcuts'' as a family option:
\begin{lstcode}[moretexcs={define@key}]
\@ifundefined{if@coldcuts}{%
@@ -611,55 +593,71 @@ assignment (see also \DescPageRef{scrbase.cmd.FamilyUnknownKeyValue} and
\FamilyBoolKey[]{butcher}{coldcuts}%
{@coldcuts}
\end{lstcode}
- using the additional information at
- \autopageref{explain:scrbase.macro.DefineFamilyKey}, this is not only valid
- for \DescRef{\LabelBase.cmd.DefineFamilyKey} but for \Macro{FamilyBoolKey} too.
+ taking advantage of the treatment of empty family members as opposed to
+ omitting the optional argument explained on
+ \autopageref{explain:scrbase.macro.DefineFamilyKey}, which applies not only
+ to \DescRef{\LabelBase.cmd.DefineFamilyKey} but also for
+ \Macro{FamilyBoolKey}.
+
+ Since \DescRef{\LabelBase.cmd.FamilyKeyState} is already set by
+ \Macro{FamilySetBool}, you can check its status with the help of
+ \DescRef{\LabelBase.cmd.DefineFamilyKey}. For example, in the first case you
+ could add an equivalence test to \Macro{FamilySetBool} to perform additional
+ actions depending on whether \Macro{FamilySetBool} succeeded or not:
+ \begin{lstcode}
+ \ifx\FamilyKeyState\FamilyKeyStateProcessed
+ ...
+ \else
+ ...
+ \fi
+ \end{lstcode}
+ Note\textnote{Attention!} that it is essential to perform the test with
+ \Macro{ifx} at this point. Fully expanding tests like \Macro{ifstr} should
+ be avoided here. Depending on the current status and the comparison status,
+ they can lead to different error messages as well as incorrect results.
\end{Example}
%
\EndIndexGroup
\begin{Declaration}
- \Macro{FamilyNumericalKey}\OParameter{family member}\Parameter{family}%
+ \Macro{FamilyNumericalKey}\OParameter{member}\Parameter{family}%
\Parameter{key}%
\OParameter{default}\Parameter{command}%
- \Parameter{values list}%
+ \Parameter{value list}%
\Macro{FamilySetNumerical}\Parameter{family}\Parameter{key}%
- \Parameter{command}\Parameter{values list}%
+ \Parameter{command}\Parameter{value list}%
\Parameter{value}
\end{Declaration}
-In contrast to switches that may be either true or false, a key exists
-that accept several values. For example an alignment may not only be left or
-not left, but left, centered, or right. Internally such
-differentiation often is made using \Macro{ifcase}. This \TeX{} command
-expects a numerical value. Because of this the command to define a macro by
-a \PName{key} has been named \Macro{FamilyNumericalKey} in
-\Package{scrbase}. The \PName{values list} thereby has the form:
-\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
- \Parameter{value}\Parameter{definition}\texttt{,}%
- \Parameter{value}\Parameter{definition}\texttt{,}%
- \dots
-\end{tabular}\vskip\dp\strutbox\end{flushleft}
-Therefore, the \PName{values list} does not solely define the supported values to the
-\PName{key}. For each of the \PName{value}s, the
-\PName{definition} of macro \Macro{\PName{command}} also is given. Usually,
-\PName{definition} is just a numerical value. Nevertheless, other content is
-possible and allowed. Currently, the only limitation is that
-\PName{definition} has to be fully expandable and will be expanded during the
-assignment.
+While switches can accept only two values, there are also keys that recognize
+several values. For example an alignment can be not just left or not-left, but
+left, centred, or right. Internally, such differentiation is often made using
+\Macro{ifcase}. This \TeX{} command expects a numerical value. Therefore in
+\Package{scrbase} the command to define a macro by a \PName{key} has been
+named \Macro{FamilyNumericalKey}. The \PName{value list} has the form:
+%\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
+ \Parameter{value}\Parameter{definition}\texttt{,}\linebreak[1]%
+ \Parameter{value}\Parameter{definition}\texttt{,}~\dots
+%\end{tabular}\vskip\dp\strutbox\end{flushleft}
+The \PName{value list} defines not just the values permitted for the
+\PName{key}. For each \PName{value}, the \PName{definition} of the macro
+\Macro{\PName{command}} also is given. Usually, the \PName{definition} is just
+a numerical value. Although other content is possible, there is currently a
+restriction that the \PName{definition} must be fully expandable, and it will
+be expanded during the assignment.
\begin{Example}
- The sausage may be cut different. For example the cold cuts may stay uncut or
- will be cut roughly or may be cut thinly. This information should be stored
- in command \Macro{cuthow}.
+ The sausage for the sausage salad can be cut differently. For example, the
+ cold cuts could simply remain uncut or be cut into thick or thin slices.
+ This information should be stored in the command \Macro{cuthow}.
\begin{lstcode}
\FamilyNumericalKey{butcher}%
{saladcut}{cuthow}{%
{none}{none},{no}{none},{not}{none}%
- {rough}{rough},%
+ {thick}{thick},%
{thin}{thin}%
}
\end{lstcode}
- Not cutting anything may be selected either by
+ Not cutting anything can be selected by
\begin{lstcode}
\FamilyOptions{butcher}{saladcut=none}
\end{lstcode}
@@ -671,182 +669,192 @@ assignment.
\begin{lstcode}
\FamilyOptions{butcher}{saladcut=not}
\end{lstcode}
- In all three cases \Macro{cuthow} would be defined with content
- \PValue{none}. It may be very useful to provide several values for the same
- result as shown in this example.
+ In all three cases \Macro{cuthow} would be defined with the content
+ \PValue{none}. It can be useful to provide several values for the same
+ result, as shown in this example.
- Now, it's most likely, that the kind of cutting will not be printed, but
- should be evaluated later. In this case a textual definition would not be
- useful. If the key is defined like this:
+ Now it's very likely that the manner of cutting will not be printed but
+ should be evaluated later. In this case, a textual definition would be
+ rather impractical. If the key is defined like this:
\begin{lstcode}
\FamilyNumericalKey{butcher}%
{saladcut}{cuthow}{%
{none}{0},{no}{0},{not}{0}%
- {rough}{1},%
+ {thick}{1},%
{thin}{2}%
}
\end{lstcode}
- then a condition like the following may be used:
+ then you can use a condition like the following:
\begin{lstcode}
\ifcase\cuthow
- % no cut
+ % uncut
\or
- % rough cut
+ % thickly cut
\else
- % thin cut
+ % thinly cut
\fi
\end{lstcode}
\end{Example}
-Internally, \Macro{FamilyNumericalKey} uses \Macro{FamilySetNumerical} as
-\PName{action} of \DescRef{\LabelBase.cmd.DefineFamilyKey}. If a unknown value
-is assigned to such a key, \Macro{FamilySetNumerical} will call
-\DescRef{\LabelBase.cmd.FamilyUnknownKeyValue} with the arguments
-\PName{family}, \PName{key} and \PName{value}. This will normally result in an
-error message about assigning an unknown value.
+Internally, \Macro{FamilyNumericalKey} uses \Macro{FamilySetNumerical} as the
+\PName{action} of \DescRef{\LabelBase.cmd.DefineFamilyKey}. If an unknown
+value is assigned to such a key, \Macro{FamilySetNumerical} will call
+\DescRef{\LabelBase.cmd.FamilyUnknownKeyValue} with the \PName{family},
+\PName{key} and \PName{value} arguments. This leads to an error signalled with
+the \DescRef{\LabelBase.cmd.FamilyKeyStateUnknownValue} status in
+\DescRef{\LabelBase.cmd.FamilyKeyState}. Similarly, when calling
+\Macro{FamilySetNumerical} the success is signalled via
+\DescRef{\LabelBase.cmd.FamilyKeyStateProcessed} in
+\DescRef{\LabelBase.cmd.FamilyKeyState}.%
%
\EndIndexGroup
\begin{Declaration}
- \Macro{FamilyCounterKey}\OParameter{family member}\Parameter{family}%
+ \Macro{FamilyCounterKey}\OParameter{member}\Parameter{family}%
\Parameter{key}%
\OParameter{default}\Parameter{\LaTeX{} counter}%
\Macro{FamilySetCounter}\Parameter{family}%
\Parameter{key}\Parameter{\LaTeX{} counter}\Parameter{value}
\end{Declaration}
-Beside\ChangedAt{v3.12}{\Package{scrbase}}
-\DescRef{\LabelBase.cmd.FamilyNumericalKey} that defines a macro to a numeric
-value depending on a symbolic value, there are circumstances when a
-\PName{key} directly represents a \PName{\LaTeX{} counter}, that should be
-assigned directly to a numeric value. In those cases, \Macro{FamilyCounterKey}
-can be used that internally will call \Macro{FamilySetCounter}. A primary test
-of the \PName{value} argument is done that only detects whether or not usage
-of \PName{value} as a number is plausible. The assignment is done, only if
-this plausibility test is successful. Nevertheless the assignment can still
-fail and result in a \TeX{} error. But if the plausibility test fails already,
-this is signalled by \DescRef{\LabelBase.cmd.FamilyKeyStateUnknownValue}.
+While\ChangedAt{v3.12}{\Package{scrbase}}
+\DescRef{\LabelBase.cmd.FamilyNumericalKey} defines a macro in which a numeric
+value corresponds to a symbolic value, there are, of course, circumstances
+when a \PName{key} directly represents a \PName{\LaTeX{} counter} to which a
+numeric value should be assigned immediately. For this case, you can use
+\Macro{FamilyCounterKey}, which calls \Macro{FamilySetCounter} internally.
+There are some basic tests of the \PName{value} argument to determine if the
+\PName{value} argument appears to be suitable for assignment to a counter. The
+assignment will only be made if these tests succeed. However, not all errors
+can be detected here, so an incorrect assignment can also lead to an error
+message from \TeX{} itself. Errors that are detected, however, are signalled
+by \DescRef{\LabelBase.cmd.FamilyKeyStateUnknownValue}.
If\ChangedAt{v3.15}{\Package{scrbase}} the value is omitted, the
\PName{default} is used instead. If there is no \PName{default}, the
-\PName{key} can be used only with a value being defined.%
+\PName{key} can be used only with an explicit value.%
\EndIndexGroup
\begin{Declaration}
- \Macro{FamilyCounterMacroKey}\OParameter{family member}\Parameter{family}%
+ \Macro{FamilyCounterMacroKey}\OParameter{member}\Parameter{family}%
\Parameter{key}%
\OParameter{default}\Parameter{macro}%
\Macro{FamilySetCounterMacro}\Parameter{family}%
\Parameter{key}\Parameter{macro}\Parameter{value}%
\end{Declaration}
These\ChangedAt{v3.12}{\Package{scrbase}} two commands differ from the
-previously described \DescRef{\LabelBase.cmd.FamilyCounterKey} and \DescRef{\LabelBase.cmd.FamilySetCounter}
-only by the fact, that they do not assign a \PName{value} to a \PName{\LaTeX
- counter}, but define a \Macro{macro} with the
-\PName{value}.%
+previously described \DescRef{\LabelBase.cmd.FamilyCounterKey} and
+\DescRef{\LabelBase.cmd.FamilySetCounter} only by the fact that they do not
+assign a \PName{value} to a \LaTeX{} counter, but define a \Macro{macro} with
+the \PName{value}. This \PName{value} is locally assigned to a counter and
+then its expanded value is used. Therefore, its value at the time the option
+is called applies.%
\EndIndexGroup
\begin{Declaration}
- \Macro{FamilyLengthKey}\OParameter{family member}\Parameter{family}%
+ \Macro{FamilyLengthKey}\OParameter{member}\Parameter{family}%
\Parameter{key}%
\OParameter{default}\Parameter{length}%
\Macro{FamilySetLength}\Parameter{family}%
\Parameter{key}\Parameter{length}\Parameter{value}%
- \Macro{FamilyLengthMacroKey}\OParameter{family member}\Parameter{family}%
+ \Macro{FamilyLengthMacroKey}\OParameter{member}\Parameter{family}%
\Parameter{key}%
\OParameter{default}\Parameter{Makro}%
\Macro{FamilySetLengthMacro}\Parameter{family}%
\Parameter{key}\Parameter{Makro}\Parameter{value}%
\end{Declaration}
-With\ChangedAt{v3.12}{\Package{scrbase}} \Macro{FamilyLengthKey} you can
+With\ChangedAt{v3.12}{\Package{scrbase}} \Macro{FamilyLengthKey}, you can
define a \PName{key} that represents a \PName{length}. It does not matter
-whether the \PName{length} is a \LaTeX{} length, a \TeX{} skip or a \TeX{}
+whether the \PName{length} is a \LaTeX{} length, a \TeX{} skip, or a \TeX{}
dimension. Internally the \PName{length} will be set to the \PName{value}
-using \Macro{FamilySetLength}. Thereby a primary test is used to decide,
-whether or not it is plausible to assign \PName{length} to \PName{value}. The
-assignment is done only if this plausibility test is successful. Nevertheless,
-not all assignment errors can be recognised, so an inaccurate \PName{value}
-can still result in \TeX{} error. Recognised errors however will be signalled
-by \DescRef{\LabelBase.cmd.FamilyKeyStateUnknownValue}.
+using \Macro{FamilySetLength}. There are some basic tests to decide whether
+this \PName{value} is valid to assign to \PName{length}. The assignment will
+only take place if these tests succeed. However, not all errors can be
+detected, so an inaccurate \PName{value} can still result in a \TeX{} error.
+Errors that are detected, however, are signalled by
+\DescRef{\LabelBase.cmd.FamilyKeyStateUnknownValue}.
-If\ChangedAt{v3.15}{\Package{scrbase}} the value is omitted,
-the \PName{default} is used instead. If there is no \PName{default}, the
-\PName{key} can be used only with a value being defined.
+If\ChangedAt{v3.15}{\Package{scrbase}} the value is omitted, the
+\PName{default} is used instead. If there is no \PName{default}, the
+\PName{key} can be used only with an explicit value.
-In difference to this, \Macro{FamilyLengthMacroKey} and
-\Macro{FamilySetLengthMacro} do not assign \PName{value} to a \PName{length},
-but define a \Macro{macro} with this
-\PName{value}.%
+\Macro{FamilyLengthMacroKey} and \Macro{FamilySetLengthMacro} store the
+\PName{value} not in a \PName{length} but in a \Macro{macro}.%
\EndIndexGroup
\begin{Declaration}
- \Macro{FamilyStringKey}\OParameter{family member}\Parameter{family}%
+ \Macro{FamilyStringKey}\OParameter{member}\Parameter{family}%
\Parameter{key}%
\OParameter{default}\Parameter{command}
+ \Macro{FamilyCSKey}\OParameter{member}\Parameter{family}%
+ \Parameter{key}%
+ \OParameter{default}\Parameter{command name}
\end{Declaration}
This defines\ChangedAt{v3.08}{\Package{scrbase}} a \PName{key} that accepts
-every value. The value will be stored into the given \Macro{command}. If there
+any value. The value will be stored in the specified \Macro{command}. If there
is no optional argument for the \PName{default}, \Macro{FamilyStringKey} is
the same as:
-\begin{quote}
-\DescRef{\LabelBase.cmd.DefineFamilyKey}\OParameter{family member}\Parameter{family}%
-\Parameter{key}\\
-\hphantom{\DescRef{\LabelBase.cmd.DefineFamilyKey}}%
-\PParameter{\Macro{def}\PName{command}\string{\#1\string}%
-\DescRef{\LabelBase.cmd.FamilyKeyStateProcessed}}.
-\end{quote}
-If an optional argument \PName{default} is used, \Macro{FamilyStringKey}
-is the same as:
-\begin{quote}
-\DescRef{\LabelBase.cmd.DefineFamilyKey}\OParameter{family member}\Parameter{family}%
-\Parameter{key}\\
-\hphantom{\DescRef{\LabelBase.cmd.DefineFamilyKey}}%
-\OParameter{default}%
-\PParameter{\Macro{def}\PName{command}\string{\#1\string}}.
-\end{quote}
-If \PName{command} is not been defined, an empty macro will be defined.
+\begin{lstcode}[escapeinside=`']
+ \DefineFamilyKey[`\PName{member}']{`\PName{family}'}{`\PName{key}'}
+ {\def`\PName{command}'{#1}}
+\end{lstcode}
+If you use the optional argument \PName{default}, \Macro{FamilyStringKey}
+corresponds to:
+\begin{lstcode}[escapeinside=`']
+ \DefineFamilyKey[`\PName{member}']{`\PName{family}'}{`\PName{key}'}
+ [`\PName{default}']
+ {\def`\PName{command}'{#1}\FamilyKeyStateProcessed}
+\end{lstcode}
+
\begin{Example}
- By default an amount of 250\Unit{g} sausage salad should be produced. The
- amount should be configurable by an option. The wanted amount will be stored
- in the macro \Macro{saladweight}. The option should be named
- \PValue{saladweight}, too:
+ By default 250\Unit{g} of sausage salad should be produced. However, the
+ amount should be configurable by an option. To do so, the quantity to be
+ created is stored in the macro \Macro{saladweight}. The option to change
+ the weight should also be called \PValue{saladweight}:
\begin{lstcode}
\newcommand*{\saladweight}{250g}
\FamilyStringKey{butcher}%
{saladweight}[250g]{\saladweight}
\end{lstcode}
- To switch back to the default weight after changing it, the user may simply
- use the option without weight:
+ To switch back to the default weight after changing it, you can simply
+ call the option without the weight:
\begin{lstcode}
\FamilyOptions{butcher}{saladweight}
\end{lstcode}
- This may be done, because the default weight has been set as default at the
- definition of the option above.
+ This is possible because the default quantity was also set as the default
+ value in the definition.
\end{Example}
-In this case there are not unknown values because all values are simply used
-for a macro definition. Nevertheless, you should note that paragraph breaks
-at the value assignment to the key are not allowed.
+In this case, there are no unknown values because all values are simply used
+for a macro definition. Note, however, that paragraph breaks are not allowed
+when assigning a value to the key.
+
+In contrast\ChangedAt{v3.25}{\Package{scrbase}} to \Macro{FamilyStringKey},
+the \Macro{FamilyCSKey} command expects for the final argument not a macro but
+only the name of a command, for example \PParameter{saladweight} instead of
+\PParameter{\Macro{saladweight}}.%
%
\EndIndexGroup
\begin{Declaration}
\Macro{FamilyUnknownKeyValue}\Parameter{family}\Parameter{key}%
- \Parameter{value}\Parameter{values list}%
+ \Parameter{value}\Parameter{value list}%
\end{Declaration}
-The command \Macro{FamilyUnknownKeyValue} throws and error message about
-unknown values assigned to a known key. The \PName{values list} is a comma
-separated list of allowed values in the form:
-\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
- `\PName{value}'\texttt{,} `\PName{value}' \dots
-\end{tabular}\vskip\dp\strutbox\end{flushleft}
-Currently\ChangedAt{v3.12}{\Package{scrbase}}, \PName{values list} is
-not used by \Package{scrbase}.
+The command \Macro{FamilyUnknownKeyValue} throws an error message due to an
+unknown or illegal values by means of \DescRef{\LabelBase.cmd.FamilyKeyState}.
+The \PName{value list} is a comma separated list of permissible values in the
+form
+%\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
+ `\PName{value}'\texttt{,} `\PName{value}' \dots
+%\end{tabular}\vskip\dp\strutbox\end{flushleft}
+However\ChangedAt{v3.12}{\Package{scrbase}}, the \PName{value list} is
+currently not evaluated by \Package{scrbase}.
\begin{Example}
- Now, for the cold cuts, the choices should be cut or no-cut and in case of cut
- rough or thin. Rough should be the default for cutting.
+ The user should now also be able to select whether the cold cuts should be
+ cut thick or thin. Thick should be the default setting, which should be used
+ even if the user does not specify how to cut the coldcuts.
\begin{lstcode}
\@ifundefined{if@thincut}{%
\expandafter
@@ -857,36 +865,44 @@ not used by \Package{scrbase}.
\DefineFamilyKey{butcher}%
{coldcuts}[true]{%
\FamilySetBool{butcher}{coldcuts}%
- {@coldcuts}%
- {#1}%
+ {@coldcuts}%
+ {#1}%
\ifx\FamilyKeyState\FamilyKeyStateProcessed
\@thincutfalse
- \else
+ \else
\ifstr{#1}{thin}{%
- \@coldcutstrue
- \@thincuttrue
+ \@coltcutstrue
+ \@finecuttrue
\FamilyKeyStateProcessed
- }{}%
+ }{%
+ \FamilyUnknownKeyValue{butcher}%
+ {coldcuts}%
+ {#1}{%
+ `true', `on', `yes',
+ `false`, `off`, `no',
+ `thin'%
+ }%
+ }%
\fi
}%
\end{lstcode}
- Let's have a look at the definition of \Option{butcher}:
- First of all, we try to set the boolean switch of cold cuts using
- \DescRef{\LabelBase.cmd.FamilySetBool}. After this command, we test whether
- or not \DescRef{\LabelBase.cmd.FamilyKeyState} signals the success of the
- command with state \DescRef{\LabelBase.cmd.FamilyKeyStateProcessed}. If so,
- only the thin cut has to be deactivated.
-
- In the other case, the value will be tested to be equal to \PValue{thin}. In
- that case, cold cuts and thin cut are activated and the state will be
- switched to \DescRef{\LabelBase.cmd.FamilyKeyStateProcessed}. If the last
- test failed also, the failure state of
- \DescRef{\LabelBase.cmd.FamilySetBool} is still valid at the end of the
- execution.
-
- Command \Macro{ifstr} is used for the thin test. It is
- described on \DescPageRef{scrbase.cmd.ifstr} in
- \autoref{sec:scrbase.if}.
+ First we try to set the boolean coldcuts switch using
+ \DescRef{\LabelBase.cmd.FamilySetBool}. If this succeeds, i.\,e. if
+ \DescRef{\LabelBase.cmd.FamilyKeyState} corresponds to
+ \DescRef{\LabelBase.cmd.FamilyKeyStateProcessed}, thincut will be
+ deactivated. Otherwise, we check if the value is equal to \PValue{thin}
+ rather than one of the valid values for a boolean switch. In this case, both
+ coldcuts and thincut are activated and the state will be switched to
+ \DescRef{\LabelBase.cmd.FamilyKeyStateProcessed}. If the previous test
+ fails, the error state signalled by \DescRef{\LabelBase.cmd.FamilySetBool}
+ is reset to \DescRef{\LabelBase.cmd.FamilyKeyStateUnknownValue}. The list of
+ the permissible values will be added to it. However, since this list is no
+ longer used, it would have been easy to skip the call to
+ \Macro{FamilyUnknownKeyValue} in the example and thus assume the error
+ status of \DescRef{\LabelBase.cmd.FamilySetBool}.
+
+ The \Macro{ifstr} command used in the test is explained on
+ \DescPageRef{scrbase.cmd.ifstr} in \autoref{sec:scrbase.if}.
\end{Example}
%
\EndIndexGroup
@@ -895,26 +911,27 @@ not used by \Package{scrbase}.
\begin{Declaration}
\Macro{FamilyElseValues}
\end{Declaration}
-With former releases\ChangedAt{v3.12}{\Package{scrbase}} of \Package{scrbase},
-additional allowed values reported by
-\DescRef{\LabelBase.cmd.FamilyUnknownKeyValue} can be set re-defining
-\Macro{FamilyElseValues} in the form:
-\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
- \texttt{,} `\PName{value}'\texttt{,} `\PName{value}' \dots
-\end{tabular}\vskip\dp\strutbox\end{flushleft}
-Since release~3.12 \DescRef{\LabelBase.cmd.FamilyUnknownKeyValue} does not
-report errors itself, but signals them using
-\DescRef{\LabelBase.cmd.FamilyKeyState}. Therefore, \Macro{FamilyElseValues}
-became deprecated. Nevertheless, its former usage is recognised by
-\Package{scrbase} and results in a code change demand message.%
+In\ChangedAt{v3.12}{\Package{scrbase}} previous\textnote{Obsolete!} versions
+of \Package{scrbase}, you could use the \Macro{FamilyElseValues} command to
+define additional values for processing by
+\DescRef{\LabelBase.cmd.FamilyUnknownKeyValue} in the form
+%\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
+ \texttt{,} `\PName{value}'\texttt{,} `\PName{value}' \dots,
+ %\end{tabular}\vskip\dp\strutbox\end{flushleft}
+which were then output in an error message. Since version~3.12,
+\DescRef{\LabelBase.cmd.FamilyUnknownKeyValue} no longer issues error messages
+itself but signals them using \DescRef{\LabelBase.cmd.FamilyKeyState}.
+Therefore, \Macro{FamilyElseValues} is now deprecated. Nevertheless,
+\Package{scrbase} detects its use and issues a message requesting that you
+update the code accordingly.%
\EndIndexGroup
\section{Conditional Execution}
\seclabel{if}
-The package \Package{scrbase} provides several commands for conditional
-execution. other than the \TeX{} syntax of conditionals, e.\,g.,
+The \Package{scrbase} package provides several commands for conditional
+execution. It does not rely on the \TeX{} syntax of conditionals such as
\begin{lstcode}
\iftrue
...
@@ -922,334 +939,401 @@ execution. other than the \TeX{} syntax of conditionals, e.\,g.,
...
\fi
\end{lstcode}
-yet the \LaTeX{} syntax also known from \LaTeX{} commands like
-\Macro{IfFileExists}, \Macro{@ifundefined}, \Macro{@ifpackageloaded}, and many
-others, is used. Nevertheless, some package authors prefer to use the \TeX{}
-syntax even for users at the \LaTeX{} interface level that could inevitably
-lead to naming conflicts with the \Package{scrbase} conditionals. In fact, the
-conditionals of \Package{scrbase} are very basic. Because of this
-\Package{scrbase} firstly defines these conditionals as internal commands with
-prefix \Macro{scr@}. Additional user commands without this prefix are
-subsequently defined. But the definition of the user commands may be
-suppressed with option \DescRef{\LabelBase.option.internalonly} (see
-\autoref{sec:scrbase.loadit}, \DescPageRef{scrbase.option.internalonly}).
-
-Authors of packages and classes should use the internal commands as
-\KOMAScript{} itself does. Nevertheless, for completeness the user commands
-are described separately.
+but uses the \LaTeX{} syntax with arguments similar to those used by \LaTeX{}
+commands like \Macro{IfFileExists}, \Macro{@ifundefined},
+\Macro{@ifpackageloaded}, and many others. Some package authors, however,
+prefer to use the syntax of \TeX{} conditionals even for users working at the
+\LaTeX{} interface level. Since the \Package{scrbase} conditionals are fairly
+low-level instructions, it is possible that such packages could provide
+commands with the same names but a different syntax, leading to problems even
+if the underlying semantics were actually the same. Therefore,
+\Package{scrbase} plays it safe.
+
+\begin{Declaration}
+ \OptionVName{internalonly}{value}
+\end{Declaration}
+The \Package{scrbase} package provides some commands for conditional
+execution. It primarily uses names like
+\Macro{scr@\PName{name}}\textnote{package authors}, which are internal
+commands. \KOMAScript{} also uses these commands internally. Authors of
+packages and classes can also use these commands but should not redefine them.
+Because some of these commands may also be useful for users, they are provided
+as \Macro{\PName{name}}\textnote{users} normally. Since other packages may
+provide conflicting commands with the same name but different syntax or
+functionality, \Package{scrbase} can suppress the definition of
+\Macro{\PName{name}}. Using the \Option{internalonly} option without a
+\PName{value} will define only the internal commands and suppress definition
+of all the user commands for conditional execution. Alternatively, the user
+can list all the commands that should not be defined as the \PName{value},
+replacing ``\Macro{}'' with ``\texttt{/}''.
+
+Authors of packages and classes normally should not use this option. Users can
+specify it with or without the \PName{value} either as a global option with
+\DescRef{maincls.cmd.documentclass} or using
+\Macro{PassOptionsToPackage}\IndexCmd{PassOptionsToPackage}.
+\begin{Example}
+ The user does not want \Package{scrbase} to define the
+ \DescRef{\LabelBase.cmd.ifVTeX} and
+ \DescRef{\LabelBase.cmd.ifundefinedorrelax} commands. So to load the class,
+ the user writes:
+\begin{lstcode}
+ \documentclass%
+ [internalonly=/ifVTeX/ifundefinedorrelax]%
+ {foo}
+\end{lstcode}
+ The class name \Class{foo} is used here as a placeholder for any class. The
+ commands \DescRef{\LabelBase.cmd.ifVTeX} and
+ \DescRef{\LabelBase.cmd.ifundefinedorrelax} are explained later in this
+ section.
+\end{Example}
+
+Authors of packages and classes should use the same internal names as
+\KOMAScript{} itself. For completeness, the user commands are also given in
+the following explanations.%
+\EndIndexGroup
\begin{Declaration}
\Macro{scr@ifundefinedorrelax}%
- \Parameter{name}\Parameter{then instructions}\Parameter{else instructions}%
+ \Parameter{name}\Parameter{then code}\Parameter{else code}%
\Macro{ifundefinedorrelax}%
- \Parameter{name}\Parameter{then instructions}\Parameter{else instructions}
+ \Parameter{name}\Parameter{then code}\Parameter{else code}
\end{Declaration}
-This command has almost the same functionality as \Macro{@ifundefined} from
-the \LaTeX{} kernel (see \cite{latex:source2e}). So the \PName{then
- instructions} will be executed if \PName{name} is the name of a command
-that is currently either not defined or \Macro{relax}. Otherwise, the
-\PName{else instructions} will be executed. In contrast to
-\Macro{@ifundefined}, \Macro{\PName{name}} is not defined to be \Macro{relax}
-in the event it was not defined before. Moreover, using \eTeX{} this case will
-not consume any hash memory.%
-%
+This command works like \Macro{@ifundefined} from the \LaTeX{} kernel (see
+\cite{latex:source2e}). So the \PName{then code} will be executed if
+\PName{name} is the name of a command that is currently either not defined or
+\Macro{relax}. Otherwise, the \PName{else code} will be executed. Unlike
+\Macro{@ifundefined}, no hash memory is allocated nor is \Macro{\PName{Name}}
+set to \Macro{relax} if \Macro{\PName{name}} was previously undefined.%
+\EndIndexGroup
+
+\begin{Declaration}
+ \Macro{ifnotundefined}\Parameter{name}%
+ \Parameter{then code}\Parameter{else code}
+\end{Declaration}
+If the command with the given name has already been defined, the \PName{then
+code} will be executed. Otherwise, the \PName{else code} will be executed.
+Since \eTeX{} already has a primitive \Macro{ifdefined}, this somewhat
+unwieldy name, unfortunately, had to be chosen. There is no corresponding
+internal command.%
+\EndIndexGroup
+
+
+\begin{Declaration}
+ \Macro{scr@ifluatex}
+ \Parameter{then code}\Parameter{else code}
+\end{Declaration}
+If\ChangedAt{v3.21}{\Package{scrbase}} you use lua\TeX{}, the \PName{then
+code} will be executed. Otherwise, the \PName{else code} will be executed.
+\iftrue% Umbruchkorrekturtext
+This test is rarely useful. %
+\fi%
+As a rule, it is better to test directly for the command you want.
+There\textnote{Attention!} is no user equivalent for this instruction. Use the
+\Package{ifluatex}\important{\Package{ifluatex}} package instead (see
+\cite{package:ifluatex}).%
\EndIndexGroup
+\iffalse% It makes no sense to document this instruction yet
+\begin{Declaration}
+ \Macro{scr@ifpdforluatex}
+ \Parameter{then code}\Parameter{else code}
+\end{Declaration}
+Until lua\TeX~0.85, it was mostly irrelevant whether you used pdf\TeX{} or
+lua\TeX{}. This command, which executes the \PName{then code} in both cases,
+derives from that fact. If neither pdf\TeX{} nor lua\TeX{} is used, the
+\PName{else code} will be executed. Since version~0.85, lua\TeX{} has given up
+compatibility with many of its commands. Therefore this distinction is no
+longer useful in practice and is no longer used by \KOMAScript{} itself. There
+is no user equivalent of this statement.%
+\EndIndexGroup
+\fi
+
\begin{Declaration}
\Macro{scr@ifpdftex}%
- \Parameter{then instructions}\Parameter{else instructions}%
+ \Parameter{then code}\Parameter{else code}%
\Macro{ifpdftex}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-If pdf\TeX{} has been used, the \PName{then instructions} will be executed,
-otherwise the \PName{else instructions}. Whether or not a PDF-file is
-generated does not matter, and the pdf\TeX{} test is rarely useful. In
-general, test for the desired command instead (see previous
-\Macro{scr@ifundefinedorrelax} and
-\DescRef{\LabelBase.cmd.ifundefinedorrelax}).
-%
+If you use pdf\TeX{}, the \PName{then code} will be executed. Otherwise, the
+\PName{else code} will be executed. It does not matter whether a PDF-file is
+actually generated or not. This test is rarely useful. As a rule, you should
+test directly for the command you want instead.%
\EndIndexGroup
\begin{Declaration}
\Macro{scr@ifVTeX}%
- \Parameter{then instructions}\Parameter{else instructions}%
+ \Parameter{then code}\Parameter{else code}%
\Macro{ifVTeX}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-If V\TeX{} has been used, the \PName{then instructions} will be executed,
-otherwise the \PName{else instructions}. This test is seldom useful. Test for
-the desired command instead (see previous \Macro{scr@ifundefinedorrelax} and
-\DescRef{\LabelBase.cmd.ifundefinedorrelax}).
+If you use V\TeX{}, the \PName{then code} will be executed. Otherwise, the
+\PName{else code} will be executed. This test is seldom useful. As a rule,
+you should test directly for the command you want instead.%
%
\EndIndexGroup
\begin{Declaration}
\Macro{scr@ifpdfoutput}%
- \Parameter{then instructions}\Parameter{else instructions}%
+ \Parameter{then code}\Parameter{else code}%
\Macro{ifpdfoutput}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-When generating a PDF-file the \PName{then instructions} will be executed,
-otherwise the \PName{else instructions}. Whether pdf\TeX{} or V\TeX{} or
-another \TeX{} engine is used to generate the PDF-file does not matter.
-%
+If a PDF file is generated, the \PName{then code} will be executed. Otherwise,
+the \PName{else code} will be executed. It does not matter whether PDF file is
+created using lua\TeX{}, pdf\TeX{}, or V\TeX{}, or \XeTeX{}.%
\EndIndexGroup
\begin{Declaration}
\Macro{scr@ifpsoutput}%
- \Parameter{then instructions}\Parameter{else instructions}%
+ \Parameter{then code}\Parameter{else code}%
\Macro{ifpsoutput}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-When generating a PostScript-file the \PName{then instructions} will be
-executed, otherwise the \PName{else instructions}. V\TeX{} provides direct
-PostScript generation that will be recognised here. If V\TeX{} is not used,
-but a switch \Macro{if@dvips} has been defined, the decision depends on that
-switch. \KOMAScript{} provides \Macro{if@dvips} in \Package{typearea}.
+If a PostScript file is generated, the \PName{then code} will be executed.
+Otherwise, the \PName{else code} will be executed. V\TeX{} can generate
+PostScript directly, which is recognized here. However, if V\TeX{} is not used
+but the switch \Macro{if@dvips} has been defined, the decision depends on that
+switch. \KOMAScript{} provides \Macro{if@dvips} in
+\hyperref[cha:typearea]{\Package{typearea}}\IndexPackage{typearea}%
+\IndexCmd{if@dvips}.
%
\EndIndexGroup
\begin{Declaration}
\Macro{scr@ifdvioutput}%
- \Parameter{then instructions}\Parameter{else instructions}%
+ \Parameter{then code}\Parameter{else code}%
\Macro{ifdvioutput}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-When generating a DVI-file the \PName{then instructions} will be executed,
-otherwise the \PName{else instructions}. If neither a direct PDF-file
-generation nor a direct PostScript-file generation has been detected, DVI-file
-generation is assumed.
-%
+If a DVI-file is generated, the \PName{then code} will be executed. Otherwise,
+the \PName{else code} will be executed. A DVI file is always assumed to be
+generated if no direct output of a PDF file or a PostScript file can be
+detected.%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifnotundefined}\Parameter{name}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Macro{if@atdocument}\ \PName{then code}\ %
+ \textMacro{else}\ \PName{else code}\ \textMacro{fi}
\end{Declaration}
-\eTeX{} will be used to test, whether or not a command with the given
-\PName{name} has already been defined. The \PName{then instructions} will be
-executed if the command is defined, otherwise the \PName{else
- instructions}. There is no corresponding internal command.
+This conditional command intentionally exists only as an internal command. In
+the document preamble, \Macro{if@atdocument} corresponds to \Macro{iffalse}.
+After \Macro{begin}\PParameter{document}, it corresponds to \Macro{iftrue}.
+Authors of classes and packages may find this command useful if a command
+should behave differently depending on whether it is used in the preamble or
+inside document body. Note\textnote{Attention!} that this command is a
+condition using \TeX{} syntax and not \LaTeX{} syntax!
%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifstr}\Parameter{string}\Parameter{string}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Macro{ifstr}\Parameter{string 1}\Parameter{string 2}%
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-Both \PName{string} arguments are expanded and afterwards compared. If the
-expansions are the same, the \PName{then instructions} will be executed,
-otherwise the \PName{else instructions}. There is no corresponding internal
+Both \PName{string} arguments are expanded and then compared. If the
+expansions are the same, the \PName{then code} will be executed. Otherwise the
+\PName{else code} will be executed. There is no corresponding internal
command.
%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifstrstart}\Parameter{string}\Parameter{string}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Macro{ifstrstart}\Parameter{string 1}\Parameter{string 2}%
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-Both\ChangedAt{v3.12}{\Package{scrbase}} \PName{string} arguments are
-expanded and afterwards compared. If aside from white spaces the first string
-starts with the second one, the \PName{then instructions} will be executed,
-otherwise the \PName{else instructions}. The command is not completely
-expandable and there is no corresponding internal command.%
+Both\ChangedAt{v3.12}{\Package{scrbase}} \PName{string} arguments are expanded
+and then compared. If \PName{string 1}, apart from white space, begins with
+\PName{string 2}, the \PName{then code} will be executed. Otherwise, the
+\PName{else code} will be executed. There is no corresponding internal
+command.%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifisdimen}\Parameter{code}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Macro{ifisdimen}\Parameter{expression}%
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-If\ChangedAt{v3.12}{\Package{scrbase}} the expansion of\PName{code} results in
-a \Macro{dimen}, which is also known as \TeX{} length register, the
-\PName{then instructions} will be executed, otherwise the \PName{else
- instructions}. The command is not completely expandable and there is no
-corresponding internal command.%
+If\ChangedAt{v3.12}{\Package{scrbase}} \PName{expression} expands to a
+\Macro{dimen}, i.\,e. a \TeX{} length register, the \PName{then code} will be
+executed. Otherwise the \PName{else code} will be executed. The command is not
+completely expandable, and there is no corresponding internal command.%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifisdimension}\Parameter{code}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Macro{ifisdimension}\Parameter{expression}%
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-If\ChangedAt{v3.12}{\Package{scrbase}} \PName{code} expands to something with
-the syntax of the value of a length, the \PName{then instructions} will be
-executed, otherwise the \PName{else instructions}. Please
-note\textnote{Attention!} that currently an invalid unit will result in an
-error message. The command is not completely expandable and there is no
-corresponding internal command.%
+If\ChangedAt{v3.12}{\Package{scrbase}} \PName{expression} expands to something
+syntactically equivalent to a length, the \PName{then code} will be executed.
+Otherwise the \PName{else code} will be executed. Note\textnote{Attention!}
+that unknown units will cause an error message. The command is not completely
+expandable, and there is no corresponding internal command.%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifisdimexpr}\Parameter{code}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Macro{ifdimen}\Parameter{string}%
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-If\ChangedAt{v3.12}{\Package{scrbase}} the expansion of\PName{code} results in
-a \Macro{dimexpr}, which is also known as \TeX{} length expression, the
-\PName{then instructions} will be executed, otherwise the \PName{else
- instructions}. Note\textnote{Attention!} that illegal expressions will
-result in error messages. The command is not completely expandable and there
-is no corresponding internal command.%
+The \PName{then code} will be executed if the first-order expansion of
+\PName{string} consists of digits and a valid length unit. Otherwise, the
+\PName{else code} will be used. There is no corresponding internal command.%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifisskip}\Parameter{code}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Macro{ifisdimexpr}\Parameter{expression}%
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-If\ChangedAt{v3.12}{\Package{scrbase}} the expansion of\PName{code} results in
-a \Macro{skip}, which is also known as \TeX{} distance register, the
-\PName{then instructions} will be executed, otherwise the \PName{else
- instructions}. The command is not completely expandable and there is no
-corresponding internal command.%
+If\ChangedAt{v3.12}{\Package{scrbase}} \PName{expression} expands to an \eTeX{}
+\Macro{dimexpr}\IndexCmd{dimexpr}, the \PName{then code} will be executed.
+Otherwise, the \PName{else code} will be executed. Note\textnote{Attention!}
+that illegal expressions will result in error messages. The command is not
+completely expandable, and there is no corresponding internal command.%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifisglue}\Parameter{code}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Macro{ifisskip}\Parameter{expression}%
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-If\ChangedAt{v3.12}{\Package{scrbase}} \PName{code} expands to something with
-the syntax of the value of a skip, the \PName{then instructions} will be
-executed, otherwise the \PName{else instructions}. Please
-note\textnote{Attention!} that currently an invalid unit will result in an
-error message. The command is not completely expandable and there is no
-corresponding internal command.%
+If\ChangedAt{v3.12}{\Package{scrbase}} \PName{expression} expands to a
+\Macro{skip}, i.\,e. a \TeX{} distance, the \PName{then code} will be
+executed. Otherwise, the \PName{else code} will be executed. The command is not
+completely expandable, and there is no corresponding internal command.%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifisglueexpr}\Parameter{code}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Macro{ifisglue}\Parameter{expression}%
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-If\ChangedAt{v3.12}{\Package{scrbase}} the expansion of\PName{code} results in
-a \Macro{glueexpr}, which is also known as \TeX{} distance expression, the
-\PName{then instructions} will be executed, otherwise the \PName{else
- instructions}. Note,\textnote{Attention!} that illegal expressions will
-result in error messages. The command is not completely expandable and there
-is no corresponding internal command.%
+If\ChangedAt{v3.12}{\Package{scrbase}} \PName{expression} expands to something
+syntactically equivalent of the value of a skip, the \PName{then code} will be
+executed. Otherwise, the \PName{else code} will be executed.
+Note\textnote{Attention!} that invalid units will result in an error message.
+The command is not completely expandable, and there is no corresponding
+internal command.%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifiscount}\Parameter{code}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Macro{ifisglueexpr}\Parameter{expression}%
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-If\ChangedAt{v3.12}{\Package{scrbase}} the expansion of\PName{code} results in
-a \Macro{count}, which is also known as \TeX{} counter register, the
-\PName{then instructions} will be executed, otherwise the \PName{else
- instructions}. The command is not completely expandable and there is no
-corresponding internal command. For test with \LaTeX{} counters, see
-\DescRef{\LabelBase.cmd.ifiscounter}.%
+If\ChangedAt{v3.12}{\Package{scrbase}} \PName{expression} expands to a
+\Macro{glueexpr}, i.\,e. an \eTeX{} distance expression, the \PName{then
+code} will be executed. Otherwise, the \PName{else code} will be executed.
+Note,\textnote{Attention!} that illegal expressions will result in error
+messages. The command is not completely expandable, and there is no
+corresponding internal command.%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifisinteger}\Parameter{code}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Macro{ifiscounter}\Parameter{counter}%
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-If\ChangedAt{v3.12}{\Package{scrbase}} \PName{code} expands to something with
-the syntax of the value of a counter, which would be a negative or positive
-integer, the \PName{then instructions} will be executed, otherwise the
-\PName{else instructions}. The command is not completely expandable and there
-is no corresponding internal command.%
+If\ChangedAt{v3.12}{\Package{scrbase}} \PName{counter} is defined as a
+\LaTeX{} counter, the \PName{then code} will be executed. Otherwise, the
+\PName{else code} will be executed. The command is not completely expandable,
+and there is no corresponding internal command.%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifisnumexpr}\Parameter{code}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Macro{ifiscount}\Parameter{count}%
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-If\ChangedAt{v3.12}{\Package{scrbase}} the expansion of\PName{code} results in
-a \Macro{numexpr}, which is also known as \TeX{} number expression, the
-\PName{then instructions} will be executed, otherwise the \PName{else
- instructions}. Note\textnote{Attention!} that illegal expressions will
-result in error messages. The command is not completely expandable and there
-is no corresponding internal command.%
+If\ChangedAt{v3.12}{\Package{scrbase}} \PName{count} expands to a
+\Macro{count}, i.\,e. a \TeX{} counter, the \PName{then code} will be
+executed. Otherwise, the \PName{else code} will be executed. The command is
+not completely expandable, and there is no corresponding internal command. For
+tests of \LaTeX{} counters, see \DescRef{\LabelBase.cmd.ifiscounter}.%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifiscounter}\Parameter{counter}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Macro{ifisinteger}\Parameter{expression}%
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-If\ChangedAt{v3.12}{\Package{scrbase}} \PName{counter} is an already defined
-\LaTeX{} counter, the \PName{then instructions} will be executed, otherwise
-the \PName{else instructions}. The command is not completely expandable and
-there is no corresponding internal command.%
+If\ChangedAt{v3.12}{\Package{scrbase}} \PName{expression} expands to something
+syntactically equivalent to of the value of a counter, i.\,e. a negative or
+positive integer, the \PName{then code} will be executed. Otherwise, the
+\PName{else code} will be executed. The command is not completely expandable,
+and there is no corresponding internal command.%
\EndIndexGroup
\begin{Declaration}
\Macro{ifnumber}\Parameter{string}%
- \Parameter{then instructions}\Parameter{else instructions}
-\end{Declaration}
-Note that this does not compare numbers. The \PName{then instructions} will
-be executed if the one step expansion of \PName{string} consists of digits
-only. Otherwise the \PName{else instructions} will be used. There is no
-corresponding internal command.
-%
-\EndIndexGroup
-
-
-\begin{Declaration}
- \Macro{ifdimen}\Parameter{string}%
- \Parameter{then instructions}\Parameter{else instructions}
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-Note that this does not compare dimensions. The \PName{then instructions} will
-be executed, if the one step expansion of \PName{string} consists of digits
-and a valid unit of length. Otherwise, the \PName{else instructions} will be
-used. There is no corresponding internal command.
+The \PName{then code} will be executed if the first-order expansion of
+\PName{string} consists only of digits. Otherwise, the \PName{else code} will
+be used. There is no corresponding internal command.
%
\EndIndexGroup
\begin{Declaration}
- \Macro{if@atdocument}\ \PName{the instructions}\ %
- \textMacro{else}\ \PName{else instructions}\ \textMacro{fi}
+ \Macro{ifisnumexpr}\Parameter{expression}%
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-This command exists intentionally as internal command only. In the document
-preamble \Macro{if@atdocument} is same as \Macro{iffalse}. After
-\Macro{begin}\PParameter{document} it's the same as \Macro{iftrue}. Authors of
-classes and packages may use this if a command should work somehow different
-depending on whether it has been used in the preamble or inside the documents
-body. Please note\textnote{Attention!} that this is a condition in \TeX{}
-syntax not in \LaTeX{} syntax!
-%
+If\ChangedAt{v3.12}{\Package{scrbase}} \PName{expression} expands to a
+\Macro{numexpr}, i.\,e. an \eTeX{} number expression, the \PName{then code}
+will be executed. Otherwise, the \PName{else code} will be executed.
+Note\textnote{Attention!} that illegal expressions will result in error
+messages. The command is not completely expandable, and there is no
+corresponding internal command.%
\EndIndexGroup
-\section{Definition of Language-Dependent Terms}
+\section{Defining Language-Dependent Terms}
\seclabel{languageSupport}
\BeginIndexGroup
\BeginIndex{}{language>definition}
\index{language>dependent terms|see{language definition}}
\index{terms>language-dependent|see{language definition}}
-Normally, one has to change or define language-dependent terms like
-\Macro{captionsenglish} in such a way that, in addition to the available terms,
-the new or redefined terms are defined. This is made more difficult by the
+Beginners often find it difficult to change language-dependent terms
+\Macro{listfigurename}\IndexCmd{listfigurename}, by default usually ``List of
+Figures.'' For example, if these are simply redefined with
+\Macro{renewcommand} in the document preamble, they will not survive a later
+change of language. If you use \Package{babel}\IndexCmd{babel}, the
+redefinition in the preamble is overwritten with
+\Macro{begin}\PParameter{document}.
+
+To define or change language-dependent terms, you normally have to redefine
+commands like \Macro{captionsenglish} so that the new or redefined terms are
+defined in addition to the previous terms. This is made more difficult by the
fact that some packages like \Package{german}\IndexPackage{german} or
-\Package{ngerman}\IndexPackage{ngerman} redefine those settings when the
-packages are loaded. These definitions unfortunately occur in such a manner as
-to destroy all previous private settings. That is also the reason why it makes
-sense to delay changes with \Macro{AtBeginDocument} until
-\Macro{begin}\PParameter{document}; that is, after package loading is
-completed. The user can also use \Macro{AtBeginDocument} or redefine the
-language-dependent terms after \Macro{begin}\PParameter{document}; that is,
-not put them in the preamble at all. The package \Package{scrbase}
-provides some additional commands for defining language-dependent terms.
-
+\Package{ngerman}\IndexPackage{ngerman} redefine those settings when they are
+loaded. These definitions, unfortunately, occur in a way that undoes all the
+previous changes. For this reason, it makes sense to delay changes until
+\Macro{begin}\PParameter{document} by using \Macro{AtBeginDocument}, that is,
+after all packages have been loaded. A user can also use
+\Macro{AtBeginDocument} or redefine the language-dependent terms not in the
+preamble but after \Macro{begin}\PParameter{document}.
+
+Adding further to the difficulty, some packages define additional
+language-dependent terms in \Macro{captions\PName{language}}, while others use
+\Macro{extras\PName{language}}. So the user must understand the commands very
+well in order to use the correct one in the right way.
+
+The \Package{scrbase} package therefore provides additional commands to define
+or modify language-dependent terms, relieving the user of many of these
+problems. These commands also let you simultaneously define or change the
+language-dependent terms of several dialects or forms of a language.
\begin{Declaration}
\Macro{defcaptionname}%
@@ -1269,46 +1353,45 @@ provides some additional commands for defining language-dependent terms.
\Macro{renewcaptionname*}%
\Parameter{language list}\Parameter{term}\Parameter{definition}
\end{Declaration}
-Using one of these commands, the user can assign a \PName{definition} for a
-particular language to a \PName{term}. Several languages can be concatenated
-with comma to a \PName{language list}. The \PName{term} is always a
-macro. The commands differ depending on whether a given language or a
-\PName{term} within a given language are already defined or not at the
-time the command is called.
-
-If a language is not defined, then \Macro{providecaptionname} does
-nothing other than write a message in the log file. This happens only once
-for each language. If a language is defined, but \PName{term} is not yet
-defined for it, then it will be defined using \PName{definition}. The
+With these four commands and their starred variants, you can assign a
+\PName{definition} for a particular language to a \PName{term}. Several
+languages can be concatenated with comma in the \PName{language list}.
+
+The \PName{term} is always a macro. The commands differ depending on whether a
+given language or a \PName{term} within a given language is already defined at
+the time the command is called.
+
+If a language is not defined, \Macro{providecaptionname} does nothing other
+than write a message to the log file. This happens only once for each
+language. If a language is defined but does not yet contain a corresponding
+\PName{term}, it will be defined using \PName{definition}. However, the
\PName{term} will not be redefined if the language already has such a
definition; instead, an appropriate message is written to the log file.
-The command \Macro{newcaptionname} has a slightly different behaviour. If a
-language is not yet defined, then a new language command will be
-created and a message written to the log file. For language
-\PValue{USenglish}, for example, this would be the language command
-\Macro{captionsUSenglish}. If \PName{term} is not yet defined in a
-language, then it will be defined using \PName{definition}. If
-\PName{term} already exists in a language, then this results in an error
-message.
-
-The command \Macro{renewcaptionname} again behaves differently. It requires an
-existing definition of \PName{term} in the languages. If neither
-a language nor \PName{term} exist or \PName{term} is unknown in a
-defined language, then an error message is given. Otherwise, the
-\PName{term} for the language will be redefined according to
-\PName{definition}.
-
-The\ChangedAt{v3.12}{\Package{scrbase}} command \Macro{defcaptionname} always
-defines the \PName{term}. So previous definitions of \PName{term} for the
-given \PName{language} will be overwritten. You may use this command even for
-undefined languages.
-
-\KOMAScript{} employs \Macro{providecaptionname} in order to define the
-commands in \autoref{sec:scrlttr2-experts.languages}.
+On the other hand, if a language has not yet been defined,
+\Macro{newcaptionname} defines a new language command will be created. For the
+language \PValue{USenglish}, for example, this would be the language command
+\Macro{captionsUSenglish}. This definition will also be noted in the log file.
+If \PName{term} is not yet defined in this language, it will be defined using
+\PName{definition}. If the \PName{term} already exists in a language, an error
+message is issued.
+
+The \Macro{renewcaptionname} command behaves still differently. If a language
+is undefined, an error message is issued. If the \PName{term} is not defined
+in this language, an error message is also issued. If the \PName{term} is
+defined in the language, it will be redefined to \PName{definition}.
+
+The\ChangedAt{v3.12}{\Package{scrbase}} \Macro{defcaptionname} command always
+defines the \PName{term}, thus overwriting any previous definition. As with
+\Macro{providecaptionname}, the language specified need not be previously
+defined.
+
+\KOMAScript{} itself uses \Macro{providecaptionname} to define the commands in
+\autoref{sec:scrlttr2-experts.languages}.
+\DescPageRef{scrlttr2-experts.cmd.yourrefname}.
\begin{Example}
- If you prefer ``fig.'' instead of ``figure'' in \PValue{USenglish}, you may
+ If you prefer ``fig.'' instead of ``figure'' in \PValue{USenglish}, you can
achieve this using:
\begin{lstcode}
\renewcaptionname{USenglish}{\figurename}{fig.}
@@ -1322,35 +1405,35 @@ commands in \autoref{sec:scrlttr2-experts.languages}.
\begin{lstcode}
\renewcaptionname{USenglish,UKenglish}{\figurename}{fig.}
\end{lstcode}
- You can extend the \PName{language list} in the same manner by
+ You can extend the \PName{language list} in the same manner with
\PValue{american}, \PValue{australian}, \PValue{british}, \PValue{canadian},
and \PValue{newzealand}.
\end{Example}
-
-Since \KOMAScript~3.12\ChangedAt{v3.12}{\Package{scrbase}} you do not need to
-delay the definition or redefinition until \Macro{begin}\PParameter{document}
-using \Macro{AtBeginDocument} any longer because \Package{scrbase} does the
-delay automatically for (re)definitions in the document's
-preamble. Additionally, \Package{scrbase} tests if a redefinition should be
-made in \Macro{extras\PName{language}} instead of
-\Macro{captions\PName{language}} and does so automatically. The new star
-variants of the commands always use \Macro{extras\PName{language}}. So
-redefinition of language dependent terms for packages like \Package{hyperref}
-that use \Macro{extras\PName{language}} should work as expected by the user.
-
-Language dependent terms usually defined by classes and language
-packages are listed and described in \autoref{tab:scrbase.commonNames}.
+
+Since \KOMAScript~3.12\ChangedAt{v3.12}{\Package{scrbase}}, you no longer need
+to delay the definition or redefinition until
+\Macro{begin}\PParameter{document} using \Macro{AtBeginDocument} because
+\Package{scrbase} does this itself if the commands are called in the
+document's preamble. Additionally, \Package{scrbase} now checks if a term
+should be redefined in \Macro{extras\PName{language}} instead of
+\Macro{captions\PName{language}}. The new starred variants of the commands
+always use \Macro{extras\PName{language}}. So redefining language-dependent
+terms for packages like \Package{hyperref} that use
+\Macro{extras\PName{language}} should work as expected.
+
+Language-dependent terms that are commonly defined by classes and language
+packages are described in \autoref{tab:scrbase.commonNames}.
\begin{desclist}
\renewcommand*{\abovecaptionskipcorrection}{-\normalbaselineskip}%
\desccaption[{%
- Overview of usual language dependent terms%
+ Overview of common language-dependent terms%
}]{%
- Overview of language dependent terms of usual language packages%
+ Overview of language-dependent terms of typical language packages%
\label{tab:scrbase.commonNames}%
}{%
- Overview of usual language dependent terms
- (\emph{continuation})%
+ Overview of common language dependent terms
+ (\emph{continued})%
}%
\entry{\Macro{abstractname}}{%
heading of the abstract%
@@ -1381,7 +1464,7 @@ packages are listed and described in \autoref{tab:scrbase.commonNames}.
\IndexCmd{contentsname}%
}%
\entry{\Macro{enclname}}{%
- prefix heading for the enclosure of a letter%
+ prefix heading for the enclosures of a letter%
\IndexCmd{enclname}%
}%
\entry{\Macro{figurename}}{%
@@ -1443,58 +1526,60 @@ packages are listed and described in \autoref{tab:scrbase.commonNames}.
\EndIndexGroup
-\section{Identification of \KOMAScript}
+\section{Identifying \KOMAScript}
\seclabel{identify}
-Package \Package{scrbase} may be used independent of \KOMAScript{} with
-other packages and classes. Nevertheless, it is a \KOMAScript{} package. For
-this, \Package{scrbase} also provides commands to identify \KOMAScript{} and
-to identify itself as a \KOMAScript{} package.
+Although\,---\,or especially because\,---\,\Package{scrbase} is generally
+designed as a package for authors of classes and packages, it is of course
+used by the \KOMAScript{} classes and most \KOMAScript{} packages. It
+therefore contains two commands that are present in all \KOMAScript{} classes
+and all basic \KOMAScript{} packages.
\begin{Declaration}
\Macro{KOMAScript}
\end{Declaration}
-This command only sets the word ``\KOMAScript'' with sans-serif font and
-a little bit tracking for the capitals. By the way: All \KOMAScript{} classes
-and packages define this command, if it has not been defined already. The
-definition is robust using \Macro{DeclareRobustCommand}.
-%
+This command simply sets the word ``\KOMAScript'' in sans-serif font and with
+a slight tracking for the capitals. By the way, all \KOMAScript{} classes and
+packages define this command as required. The definition is robust using
+\Macro{DeclareRobustCommand}. Since packages that do not belong to
+\KOMAScript{} can also define this command, its existence should not be
+interpreted as an indication that a \KOMAScript{} package is in use.%
\EndIndexGroup
\begin{Declaration}
\Macro{KOMAScriptVersion}
\end{Declaration}
-\KOMAScript{} defines the main version of \KOMAScript{} in this command. It
-has the form ``\PName{date} \PName{version} \texttt{KOMA-Script}''. This main
-version is same for all \KOMAScript{} classes and the \KOMAScript{} packages
-that are essential for the classes. Because of this, it may be inquired after
-loading \Package{scrbase}, too. For example, this document has been made using
+\KOMAScript{} defines the major version of \KOMAScript{} in this command. It
+has the form ``\PName{date} \PName{version} \texttt{KOMA-Script}''. This major
+version is same for all \KOMAScript{} classes and all \KOMAScript{} packages
+used by the classes. For this reason, it can be queried after you
+load \Package{scrbase}, too. For example, this guide was made using
\KOMAScript{} version ``\KOMAScriptVersion''.
%
\EndIndexGroup
-\section{Extension of the \LaTeX{} Kernel}
+\section{Extensions to the \LaTeX{} Kernel}
\seclabel{latexkernel}
-Sometimes the \LaTeX{} kernel itself provides commands, but lacks other,
-similar commands that would often be useful, too. Some of those commands for
-authors of packages and classes are provided by \Package{scrbase}.
+Sometimes the \LaTeX{} kernel itself provides commands but lacks other very
+similar commands that would often be useful. A few such commands are provided
+by \Package{scrbase} for authors of packages and classes.
\begin{Declaration}
\Macro{ClassInfoNoLine}\Parameter{class name}\Parameter{information}%
\Macro{PackageInfoNoLine}\Parameter{package name}\Parameter{information}%
\end{Declaration}%
-For authors of classes and package the \LaTeX{} kernel already provides
-commands like \Macro{ClassInfo} and \Macro{PackageInfo} to write information.
-together with the current line number, into the log-file. Besides
-\Macro{PackageWarning} and \Macro{ClassWarning} to throw warning messages with
-line numbers, it also provides \Macro{PackageWarningNoLine} and
-\Macro{ClassWarningNoLine} for warning messages without line
-numbers. Nevertheless, the commands \Macro{ClassInfoNoLine} and
-\Macro{PackageInfoNoLine} for writing information without line numbers into the
-log-file are missing. Package \Package{scrbase} provides them.
+The \LaTeX{} kernel already provides authors of classes and packages commands
+like \Macro{ClassInfo} and \Macro{PackageInfo} to write information, along
+with the current line number, to the log file. In addition to
+\Macro{PackageWarning} and \Macro{ClassWarning}, which throw warning messages
+with line numbers, it also provides \Macro{PackageWarningNoLine} and
+\Macro{ClassWarningNoLine} for warning messages without line numbers. However
+the obvious commands \Macro{ClassInfoNoLine} and \Macro{PackageInfoNoLine},
+for writing information without line numbers into the log file, are missing.
+The \Package{scrbase} package provides them.
%
\EndIndexGroup
@@ -1502,47 +1587,47 @@ log-file are missing. Package \Package{scrbase} provides them.
\begin{Declaration}
\Macro{l@addto@macro}\Parameter{command}\Parameter{extension}%
\end{Declaration}%
-The \LaTeX{} kernel already provides an internal command \Macro{g@addto@macro}
-to extend the definition of macro \Macro{command} by \PName{extension}
-globally. This may be used only for macros that have no
-arguments. Nevertheless, sometimes a command like this, that works locally to
-a group instead of globally, could be useful. Package \Package{scrbase}
-provides such a command with \Macro{l@addto@macro}. An alternative may be
-usage of package \Package{etoolbox}\IndexPackage{etoolbox}, which provides
-several of such commands for different purposes (see \cite{package:etoolbox}).
-%
+The \LaTeX{} kernel provides an internal command \Macro{g@addto@macro} to
+extend the definition of macro \Macro{command} globally with
+\PName{extension}. This works in this form only for macros that have no
+arguments. However, sometimes you may need a command like this that works
+locally within the current group. The \Package{scrbase} package provides such
+a command with \Macro{l@addto@macro}. An alternative is to use the
+\Package{etoolbox}\IndexPackage{etoolbox} or
+\Package{xpatch}\IndexPackage{xpatch} package, which offers a whole range of
+such commands for different purposes (see \cite{package:etoolbox} or
+\cite{package:xpatch}).%
\EndIndexGroup
-\section{Extension of the Mathematical Features of \eTeX}
+\section{Extensions to the Mathematical Features of \eTeX}
\seclabel{etex}
-\eTeX{}, that is meanwhile used by \LaTeX{} and needed by \KOMAScript{},
-provided with \Macro{numexpr}\IndexCmd{numexpr}, an extended feature for
-calculation of simple arithmetic with \TeX{} counters and
-integers. The four basic arithmetic operations and brackets are
-supported. Correct rounding is done while division. Sometimes additional
-operators would be useful.
+\eTeX{}, which is used by \LaTeX{} and loaded by \KOMAScript{}, has extended
+capabilities for calculating simple arithmetic with \TeX{} counters and
+integers using \Macro{numexpr}\IndexCmd{numexpr}. The four basic arithmetic
+operations and parentheses are supported. Division is rounded
+correctly. Sometimes additional operators would be useful.
\begin{Declaration}
\Macro{XdivY}\Parameter{dividend}\Parameter{divisor}%
\Macro{XmodY}\Parameter{dividend}\Parameter{divisor}%
\end{Declaration}%
-Having a division with remainder command\ChangedAt{v3.05a}{\Package{scrbase}}
-\Macro{XdivY} gives the value of the integer quotient, with command
-\Macro{XmodY} giving the value of the remainder. This kind of division is
-defined:
+The command\ChangedAt{v3.05a}{\Package{scrbase}}
+\Macro{XdivY} returns the value of the integer quotient, with command
+\Macro{XmodY} giving the value of the remainder. This type of of division is
+defined by the equation
\[
\textit{dividend} = \textit{divisor} \cdot
\textit{integer quotient} + \textit{remainder}
\]
-with \textit{dividend} and \textit{remainder} are integer, \textit{remainder}
-is greater or equal to \textit{divisor}, and \textit{divisor} is a natural
-number greater than 0.
+where \textit{dividend}, \textit{divisor}, and \textit{remainder} are
+integers, \textit{remainder} is greater or equal to 0 and less than
+\textit{divisor}, and \textit{divisor} is a natural number greater than 0.
-The value may be used for assignment to a counter or directly in the
-expression of \Macro{numexpr}. For output the value as an Arabic number has
-to be prefixed by \Macro{the}.%
+You can assign the value to a counter or use it directly within an expression
+using \Macro{numexpr}. To output the value as an Arabic number, you must
+prefix it with \Macro{the}.%
%
\EndIndexGroup
%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex
index 5eba7be2753..c01bbdada5d 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrbookreportarticle-experts.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrbookreportarticle-experts.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -48,13 +48,13 @@
% ============================================================================
\KOMAProvidesFile{scrbookreportarticle-experts.tex}
- [$Date: 2017-05-12 13:41:47 +0200 (Fri, 12 May 2017) $
+ [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl for
experts)]
-\translator{Gernot Hassenpflug\and Markus Kohm}
+\translator{Gernot Hassenpflug\and Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2017-05-08
+% Date of the translated German file: 2018-02-13
\chapter[{Additional Information about the Main Classes and
\Package{scrextend}}]{Additional Information about the Main Classes
@@ -67,29 +67,29 @@
\BeginIndex{Class}{scrbook}%
\BeginIndex{Class}{scrreprt}%
\BeginIndex{Package}{scrextend}%
-
-This chapter gives additional information about the \KOMAScript{} classes
-\Class{scrbook}, \Class{scrreprt}, and \Class{scrartcl}. Some of the features
-are also available for package \Package{scrextend}. \iffree{Some parts of the
- chapter are subject to the \KOMAScript{} book \cite{book:komascript}
- only. This should not be a problem, because the}{The} average user, who only
-want to use the package, will not need the information, that is addressed to
-users with non-standard requirements or who want to write their own classes
-using a \KOMAScript{} class. Another part of the information describes features
-of the classes that exist only because of compatibility to former
-releases of \KOMAScript{} or the standard classes. The features, that exist
-only because of compatibility to former \KOMAScript{} releases, are printed
-with a sans serif font. You should not use them any longer.
+This chapter provides additional information about the \KOMAScript{} classes
+\Class{scrbook}, \Class{scrreprt}, and \Class{scrartcl} and some commands that
+are also available in \Package{scrextend}. \iffree{Some parts of the chapter
+ are found only in the German \KOMAScript{} book \cite{book:komascript}. This
+ should not be a problem because the}{The} average user, who only wants to
+use the classes, will seldom need this information. Some of this information
+is addressed to users with non-standard requirements or who want to write
+their own classes based on a \KOMAScript{} class. Other parts describe
+features that exist only for the sake of compatibility with the standard
+classes or earlier versions of \KOMAScript{}. Portions that describe features
+that exist only for reasons of compatibility with earlier versions of
+\KOMAScript{} are printed in sans serif font. You should not use them any
+longer.
\LoadNonFree{scrbookreportarticle-experts}{0}
-\section{Additional Information to User Commands}
+\section{Extensions to User Commands}
\seclabel{addInfos}
\LoadNonFree{scrbookreportarticle-experts}{1}
-\section{Cooperation and Coexistence of \KOMAScript{} and Other Packages}
+\section{\KOMAScript's Interaction with Other Packages}
\seclabel{coexistence}
\LoadNonFree{scrbookreportarticle-experts}{2}
@@ -98,9 +98,9 @@ with a sans serif font. You should not use them any longer.
\section{Expert Commands}
\seclabel{experts}
-This sections described commands, that are more or less out of average user's
-interest. Nevertheless these commands provide additional features for
-experts. Because the information is addressed to experts it's condensed.
+This sections describes commands that are of little or no interest to the
+average user. These commands offer additional features for experts. Because
+the information is addressed to experts, it is condensed.
% \subsection{Identification}
% \seclabel{identification}
@@ -109,17 +109,16 @@ experts. Because the information is addressed to experts it's condensed.
\Macro{KOMAClassName}%
\Macro{ClassName}
\end{Declaration}
-\Macro{KOMAClassName} stores the name of the currently used \KOMAScript{}
-class. If someone wants to know, whether or not or a \KOMAScript{} class is
-used or which \KOMAScript{} is used this may be tested with this command. In
-difference to this, \Macro{ClassName} tells which would be the standard class,
-that has been replaced by a \KOMAScript{} class.
-
-Please note\textnote{Attention!}, that the existence of
-\DescRef{scrbase.cmd.KOMAScript}\IndexCmd{KOMAScript} is not a indication for
-the usage of a \KOMAScript{} class. First of all: Every \KOMAScript{} package
-and not only \KOMAScript{} classes define \Macro{KOMAScript}. Furthermore
-other packages may also define the \KOMAScript{} word mark with this name.%
+\Macro{KOMAClassName} stores the name of the \KOMAScript{} class currently in
+use. So if you want to know if a \KOMAScript{} class is used, you can easily
+test for this command. In contrast, \Macro{ClassName} indicates which standard
+class has been replaced by this \KOMAScript{} class.
+
+Note\textnote{Attention!} in this context, however, that the existence of
+\DescRef{scrbase.cmd.KOMAScript}\IndexCmd{KOMAScript} cannot guarantee that a
+\KOMAScript{} class is in use. For one thing, all \KOMAScript{} packages
+define this command. For another, other packages may find it useful to define
+the \KOMAScript{} label using this name.%
%
\EndIndexGroup
@@ -133,27 +132,26 @@ other packages may also define the \KOMAScript{} word mark with this name.%
The\ChangedAt{v3.08}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} \KOMAScript{} classes do not use
\Macro{addcontentsline}\IndexCmd{addcontentsline}%
-\important{\Macro{addcontentsline}} directly. Instead they
-call \Macro{addtocentrydefault} with similar arguments. The command may be used
-for both, entries with and without number. Thereby \PName{level} is the
-textual sectioning level, i.\,e., \PValue{part},
+\important{\Macro{addcontentsline}} directly to make entries in the table of
+contents. Instead, they call \Macro{addtocentrydefault} with similar
+arguments. The command can be used for both numbered and unnumbered entries.
+The \PName{level} is the sectioning level, that is \PValue{part},
\PValue{chapter}, \PValue{section}, \PValue{subsection},
\PValue{subsubsection}, \PValue{paragraph}, or \PValue{subparagraph}. The
-already formatted sectioning number is given by the second argument,
-\PName{number}. This argument may be empty. The text of the entry is given by
-argument \PName{heading}. It is recommended to protect fragile commands inside
-this argument with prefix
+formatted sectioning number is given the second argument, \PName{number}. This
+argument can be empty. The text of the entry is given by the \PName{heading}
+argument. You should protect fragile commands inside this argument with
\Macro{protect}\IndexCmd{protect}\important{\Macro{protect}}.
-There's one speciality for argument \PName{number}. An empty argument
-signalizes, that an entry without number should be generated. \KOMAScript{}
-uses
+One notable feature of the \PName{number} argument is that an empty argument
+indicates that an unnumbered entry should be generated. By default,
+\KOMAScript{} uses
\begin{quote}
\Macro{addcontentsline}\PParameter{toc}\Parameter{level}%
\Parameter{heading}
\end{quote}
-for this. Nevertheless, if the argument is not empty an entry with number
-will be made and \PName{number} is the already formatted heading
+for this. If the argument is not empty, however, an entry with number
+will be created and \PName{number} is the formatted heading
number. \KOMAScript{} uses
\begin{quote}\raggedright
\Macro{addcontentsline}\PParameter{toc}\Parameter{level}%
@@ -162,10 +160,10 @@ number. \KOMAScript{} uses
\PName{heading}\%\\
}
\end{quote}
-to make this.
+to create this entry.
-Package authors an authors of wrapper classes may redefined this command to
-manipulate the entries. For example\textnote{Example} one could suggest
+Package authors and authors of wrapper classes can redefine this command to
+alter the entries. For example\textnote{Example}, you could use
\begin{lstcode}
\renewcommand{\addtocentrydefault}[3]{%
\ifstr{#3}{}{%
@@ -177,22 +175,22 @@ manipulate the entries. For example\textnote{Example} one could suggest
}%
}%
\end{lstcode}
-to omit entries with empty \PName{heading}. In real live this would not be
-needed, because the \KOMAScript{} classes already use another method to
-suppress empty entries. See the description of the structuring commands in
-\autoref{sec:maincls.structure} from \DescPageRef{maincls.cmd.part}
-onward for this.%
+to\IndexCmd{ifstr} omit entries with an empty \PName{heading}. In practice,
+such a change is not necessary because the \KOMAScript{} classes already use
+another method to suppress empty entries. See the description of the
+sectioning commands in \autoref{sec:maincls.structure}, starting on
+\DescPageRef{maincls.cmd.part} for this.%
%
\EndIndexGroup
\begin{Declaration}
- \Macro{addparttocentry}\Parameter{number}\Parameter{heading}%
- \Macro{addchaptertocentry}\Parameter{number}\Parameter{heading}%
- \Macro{addsectiontocentry}\Parameter{number}\Parameter{heading}%
- \Macro{addsubsectiontocentry}\Parameter{number}\Parameter{heading}%
- \Macro{addsubsubsectiontocentry}\Parameter{number}\Parameter{heading}%
- \Macro{addparagraphtocentry}\Parameter{number}\Parameter{heading}%
+ \Macro{addparttocentry}\Parameter{number}\Parameter{heading}
+ \Macro{addchaptertocentry}\Parameter{number}\Parameter{heading}
+ \Macro{addsectiontocentry}\Parameter{number}\Parameter{heading}
+ \Macro{addsubsectiontocentry}\Parameter{number}\Parameter{heading}
+ \Macro{addsubsubsectiontocentry}\Parameter{number}\Parameter{heading}
+ \Macro{addparagraphtocentry}\Parameter{number}\Parameter{heading}
\Macro{addsubparagraphtocentry}\Parameter{number}\Parameter{heading}
\end{Declaration}%
The\ChangedAt{v3.08}{\Class{scrbook}\and \Class{scrreprt}\and
@@ -201,10 +199,9 @@ command
\DescRef{\LabelBase.cmd.addtocentrydefault}\IndexCmd{addtocentrydefault}%
\important{\DescRef{\LabelBase.cmd.addtocentrydefault}} directly only if no
individual command for the \PName{level} has been defined or if that command
-is \Macro{relax}\IndexCmd{relax}\important{\Macro{relax}}. Nevertheless, the
-default definition of all these individual commands simply call
-\DescRef{\LabelBase.cmd.addtocentrydefault} with their own \PName{level}
-passing their arguments through.%
+is \Macro{relax}\IndexCmd{relax}\important{\Macro{relax}}. By default, all
+these commands simply pass their own \PName{level} and arguments directly to
+\DescRef{\LabelBase.cmd.addtocentrydefault}.%
%
\EndIndexGroup
@@ -212,29 +209,33 @@ passing their arguments through.%
\begin{Declaration}
\Macro{raggedchapterentry}
\end{Declaration}
-Previous\ChangedAt{v3.21}{\Class{scrbook}\and \Class{scrreprt}} versions of
-\KOMAScript{} provide a feature for printing chapter entries at the table of
-contents left-aligned instead of justified by defining command
-\Macro{raggedchapterentry} to be \Macro{raggedright}. Officially this feature
-has been removed from \KOMAScript{} version 3.21 on.
-
-Indeed attribute \PValue{raggedentrytext} of toc-entry style \PValue{tocline}
-of package \Package{tocbasic}\IndexPackage{tocbasic} has been implemented to
-use such a macro \Macro{ragged\PName{entry level}entry} as an indicator for
-left-aligned text. If such a macro is \Macro{raggedright}, the text is printed
-left-aligned. With any other definition the text is printed justified.
-
-With this implementation of \PValue{raggedentrytext} full compatibility to the
-previous documentation of \Macro{raggedchapterentry} is reached. As
-stated formerly, other definitions of \Macro{raggedchapterentry}\,---\,and now
-also of \Macro{raggedsectionentry} and similar macros for other entry
-levels\,---\,could result in the potentially unexpected effect of justified
-text.
-
-Nevertheless, it is recommended to use the attribute of style \PValue{tocline}
-to select justified or left-aligned text.%
+In\ChangedAt{v3.21}{\Class{scrbook}\and \Class{scrreprt}} earlier versions of
+\KOMAScript{}, it was possible to define the \Macro{raggedchapterentry} macro
+as \Macro{raggedright} to print chapter entries in the table of contents
+left-aligned instead of fully justified. Officially, this feature has not
+existed in \KOMAScript{} since version~3.21.
+
+In fact, the \PValue{raggedentrytext} attribute for the \PValue{tocline}
+TOC-entry style of the \Package{tocbasic}\IndexPackage{tocbasic} package is
+implemented by setting the \Macro{ragged\PName{entry level}entry} macro to
+either \Macro{relax} or \Macro{raggedright}. This attribute is evaluated by
+checking whether the corresponding macro is defined as \Macro{raggedright}. If
+so, the text is printed left-aligned. With any other definition, no ragged
+margins are used.
+
+Since it was previously documented that \Macro{raggedchapterentry} should not
+be defined as anything other than \Macro{raggedright}, this behaviour is
+compatible with the documented behaviour of earlier versions. As noted in
+earlier releases, other definitions of \Macro{raggedchapterentry}\,---\,and
+now also of \Macro{raggedsectionentry} and similar macros for other entry
+levels\,---\,may lead to unexpected results.
+
+You should select the desired justification for the all table-of-contents
+entries using the \PValue{raggedentrytext} attribute of \PValue{tocline}
+rather than attempting to set the attribute for specific entry levels.%
\EndIndexGroup
+
% \subsection{Font Settings}
% \seclabel{fonts}
@@ -243,53 +244,53 @@ to select justified or left-aligned text.%
\Macro{@fontsizefilebase}%
\Macro{changefontsizes}\Parameter{font size}
\end{Declaration}
-The prefix \File{scrsize} for file names of font size files, that has been
-mentioned\iffree{ in \autoref{sec:maincls-experts.addInfos}}{} at
-\DescPageRef{maincls-experts.option.fontsize} is only the default of the
-internal macro \Macro{@fontsizefilebase}\IndexCmd{@fontsizefilebase}. This
-default is used only, if the macro has not already be defined when loading a
-\KOMAScript{} class or package \Package{scrextend}. Authors of wrapper classes
-may define this macro with another file name prefix to use completely
-different font size files. Also\textnote{Hint!} authors of wrapper classes
-could change or deactivate the \emph{fallback} solution for unknown font sizes
-by redefinition of macro
-\Macro{changefontsizes}\important{\Macro{changefontsizes}}. This macro has
-exactly one argument: the wanted \PName{font size}.%
-%
+The \File{scrsize} prefix for file names of font-size files described
+in \autoref{sec:maincls-experts.addInfos}\iffree{}{ on
+\DescPageRef{maincls-experts.option.fontsize}} is just the default for the
+internal \Macro{@fontsizefilebase}\IndexCmd{@fontsizefilebase} macro. This
+default is used only when the macro is not yet defined when loading a
+\KOMAScript{} class or the \Package{scrextend} package. Authors of wrapper
+classes can redefine this macro to use completely different font-size files.
+Similarly\textnote{Hint!} authors of wrapper classes can change or deactivate
+the fallback solution for unknown font sizes by redefining the
+\Macro{changefontsizes}\important{\Macro{changefontsizes}} macro. This macro
+has exactly one argument: the desired \PName{font size}.
+However\textnote{Attention!}, the \Macro{changefontsizes} macro is not
+designed as an end-user instruction.%
\EndIndexGroup
\begin{Declaration}
- \Macro{newkomafont}\OParameter{warning message}\Parameter{element}%
+ \Macro{newkomafont}\OParameter{warning}\Parameter{element}%
\Parameter{default}%
- \Macro{aliaskomafont}\Parameter{alias name}\Parameter{element}
+ \Macro{aliaskomafont}\Parameter{alias}\Parameter{element}
\end{Declaration}
-Experts may use \Macro{newkomafont} to define a \PName{default} for the font
-style of an \PName{element}. After this that default may be changed using
-commands \DescRef{maincls.cmd.setkomafont} and
-\DescRef{maincls.cmd.addtokomafont} (see \autoref{sec:maincls.textmarkup},
-\DescPageRef{maincls.cmd.setkomafont}). Of course this is not enough to use
-the defined font style. The expert himself has to prepare his code to use
-command \DescRef{maincls.cmd.usekomafont}%
-\important{\DescRef{maincls.cmd.usekomafont}}\IndexCmd{usekomafont} (see
-\DescPageRef{maincls.cmd.usekomafont}) with that \PName{element} at his code
-definitions.
-
-The optional argument \PName{warning message} defines a warning message,
-that \KOMAScript{} will show whenever the default font style of that
-\PName{element} will be changed. The sender of the warning in such cases will
-be the used \KOMAScript{} class or package \Package{scrextend}.
-
-Command \Macro{aliaskomafont} defines an \PName{alias name} to an already
-defined \PName{element}. \KOMAScript{} will inform the user automatically
-about the real name of the element, whenever an \PName{alias name} will be
-used. An\textnote{Hint!} \PName{alias name} may be used, e.\,g., if a
-developer finds a better name for an element, that has been defined formerly
-with another name, if the old name should still be usable because of
-compatibility. Also an \PName{alias name}s may increase usability, because
-different users may find different names more or less intuitive. \KOMAScript{}
-itself defines a lot of \PName{alias name}s for several \PName{element}s.
-%
+Experts can use \Macro{newkomafont} to define a \PName{default} for the font
+style of an \PName{element}. Subsequently, that default can be changed with
+the \DescRef{maincls.cmd.setkomafont} and \DescRef{maincls.cmd.addtokomafont}
+commands (see \autoref{sec:maincls.textmarkup},
+\DescPageRef{maincls.cmd.setkomafont}). Of course, merely defining the font
+style does not actually put it to use. You must make sure you include the
+\DescRef{maincls.cmd.usekomafont}%
+\important{\DescRef{maincls.cmd.usekomafont}}\IndexCmd{usekomafont} command
+(see \DescPageRef{maincls.cmd.usekomafont}) for this \PName{element} in your
+code at the appropriate places. Calling \Macro{newkomafont} for an existing
+element will result in error messages.
+
+The optional \PName{warning} argument defines a warning message. The
+\KOMAScript{} classes output it with \Macro{ClassWarning}, and the
+\Package{scrextend} package with \Macro{PackageWarning}, whenever the default
+font style of that \PName{element} is changed. The package \Package{scrkbase}
+is listed as the generator of the warning.
+
+The \Macro{aliaskomafont} command defines an \PName{alias} for a previously
+defined \PName{element}. \KOMAScript{} informs the user in the \File{log} file
+about the actual name of the element if it uses an \PName{alias}.
+You\textnote{Hint!} can use an \PName{alias}, for example, if you think of a
+better name for an element and the old name should remain usable for the sake
+of compatibility. It can also increase user-friendliness by creating aliases
+for all the terms that different users may intuitively choose. \KOMAScript{}
+itself makes use of this possibility.%
\EndIndexGroup
@@ -299,21 +300,21 @@ itself defines a lot of \PName{alias name}s for several \PName{element}s.
\Macro{addtokomafontgobblelist}\Parameter{macro}
\end{Declaration}
As already mentioned in \autoref{part:forAuthors} of this manual, font
-settings of elements should consist only in commands to select the size,
-family, coding, series, shape, or colour. At least changing the colour is not
-always transparent in \LaTeX{} and therefore could result in unwanted effects
-if someone uses \DescRef{maincls.cmd.usekomafont} at an inappropriate state.
-
-Users tend to use different, somehow critical things in the font setting of an
-element, e.\,g., \Macro{MakeUppercase} at the very end of the setting. As long
-as possible, the internal usage of font settings has been implemented so that
-such forbidden settings do not matter. Even using a command that expects an
-argument, e.\,g., \Macro{textbf} instead of \Macro{bfseries}, would work
-mostly, if it the last one in the font setting of an element\,---\,but without
-warranty.
-
-Inside \KOMAScript, sometimes, it was necessary to restrict the font change to
-real font settings. This has been done, e.\,g., using
+settings of elements should consist only of commands to select the size,
+family, encoding, series, shape, or colour. Colour changes are not
+always transparent in \LaTeX{} and therefore can cause in unwanted side-effects
+if you use \DescRef{maincls.cmd.usekomafont} at an inappropriate place.
+
+Users tend to put very different, sometimes critical, things into the font
+setting of an element, such as \Macro{MakeUppercase} at the very end of the
+setting. As much as possible, the internal use of the font settings has been
+implemented so that many of these prohibited elements still do no harm, and it
+usually works even if the last command in a font setting expects an argument,
+for example using \Macro{textbf} instead of \Macro{bfseries}. But there is no
+guarantee for that.
+
+Internally, \KOMAScript{} must sometimes limit font changes to real font
+settings. This is accomplished, for example, by using
\DescRef{maincls.cmd.usefontofkomafont}%
\IndexCmd{usefontofkomafont}%
\IndexCmd{usesizeofkomafont}\IndexCmd{useencodingofkomafont}%
@@ -322,102 +323,108 @@ real font settings. This has been done, e.\,g., using
(see \autoref{sec:maincls.textmarkup},
\DescPageRef{maincls.cmd.usefontofkomafont}).
-Nevertheless, command \DescRef{maincls.cmd.usefontofkomafont} and it's
-siblings have some limitations. Therefore you must not use a command that
+Nevertheless, the \DescRef{maincls.cmd.usefontofkomafont} command and its
+siblings have their limitations. Therefore you must not use a command that
always needs a fully expandable argument inside the font setting of an
-element. But this is exactly what \Macro{MakeUppercase}
-needs. Therefore\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} \KOMAScript{} holds a list of macros, which should become
-\Macro{relax} inside \DescRef{maincls.cmd.usefontofkomafont} and it's
-siblings. Since \KOMAScript~3.24\ChangedAt{v3.24}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}} only \Macro{normalcolor} is added to
+element. But this is exactly what \Macro{MakeUppercase} needs.
+Therefore\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
+\Class{scrartcl}} \KOMAScript{} maintains an internal list of macros that
+should become \Macro{relax} inside \DescRef{maincls.cmd.usefontofkomafont} and
+its siblings. Since \KOMAScript~3.24\ChangedAt{v3.24}{\Class{scrbook}\and
+\Class{scrreprt}\and \Class{scrartcl}} only \Macro{normalcolor} is added to
this list by default.
-Amongst others, \Macro{normalcolor}, \Macro{MakeUppercase}, and
-\Macro{MakeLowercase} are part of that list. More macros can be added one by
-one using \Macro{addtokomafontrelaxlist}.
-
-Note that \PName{macro} will be set simply to \Macro{relax}. So if
-\PName{macro} really has an argument, the argument will be execute
-locally. Therefore you must not add commands like \Macro{setlength} to the
-list. The user himself is responsible for all errors resulting in the usage of
-\Macro{addtokomafontrelaxlist}. Additionally this command should not be
-misunderstood as a legitimation for adding all kind of commands to the font
-setting of an element!
+Note that the given \PName{macro} is actually just set to \Macro{relax}. So
+any arguments within the font setting will be executed locally, if applicable.
+Therefore you should never add commands like \Macro{setlength} to the list.
+You are responsible for all errors resulting caused by using
+\Macro{addtokomafontrelaxlist}. Also, do not take this command as license to
+add all sorts of commands to the font settings!
For\ChangedAt{v3.24}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} some commands you may prefere to execute the first
-argument unchanged. These commands can be added to another list using
-\Macro{addtokomatfontonearglist}. By default \Macro{MakeUppercase} and
+\Class{scrartcl}} commands whose first argument should be executed without an
+additional group, there is \Macro{addtokomatfontonearglist}. The specified
+macro is set to \Macro{@firstofone}. By default \Macro{MakeUppercase} and
\Macro{MakeLowercase} are added to this list.
-If\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}
-a \PName{macro} and it's first argument should be ignored locally inside
-\DescRef{maincls.cmd.usefontofkomafont} and it's siblings, you can use
-\Macro{addtokomafontgobblelist} instead of \Macro{addtokomafontrelaxlist}. An
-example for this is the command \Macro{color}, that has to be ignored with the
-colour name and therefore is a default member of the gobble-list.
-
-Note, the defaults of the three lists can change. If you need a command inside
-one of the lists you should add it yourself.%
+If\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}\and
+\Class{scrartcl}}, on the other hand, a \PName{macro} and its first argument
+should be ignored locally inside \DescRef{maincls.cmd.usefontofkomafont} and
+its siblings, you can use \Macro{addtokomafontgobblelist} instead of
+\Macro{addtokomafontrelaxlist}. An example of this is the command
+\Macro{color}, which must be ignored along with the colour name and therefore
+is a member of this list by default.
+
+Note the defaults of these three lists may change in future version. If you
+need a certain commands in one of the lists, you should should explicitly add
+them yourself.%
\EndIndexGroup
\begin{Declaration}
\Macro{IfExistskomafont}\Parameter{element}\Parameter{then code}%
- \Parameter{else code}
+ \Parameter{else code}
+ \Macro{IfIsAliaskomafont}\Parameter{element}\Parameter{then code}%
+ \Parameter{else code}
\end{Declaration}
Which\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}\and \Class{scrlttr2}} elements are defined depends on the
-version of \KOMAScript. So sometimes it may be useful to be able to test,
-whether or not an \PName{element} exists. The command executes the \PName{then
- code} only if an \PName{element} has been defined using
-\DescRef{\LabelBase.cmd.newkomafont} or \DescRef{\LabelBase.cmd.aliaskomafont}
-and therefore can be changed using \DescRef{maincls.cmd.setkomafont} or
-\DescRef{maincls.cmd.addtokomafont} and can be used by one of the
-\Macro{use\dots komafont} commands. Otherwise it executes the \PName{else
- code}.%
+version of \KOMAScript. So it sometimes makes sense to test in advance whether
+a specific \PName{element} even exists. The \Macro{IfExistskomafont} command
+executes the \PName{then code} if and only if an \PName{element} has been
+defined using \DescRef{\LabelBase.cmd.newkomafont} or
+\DescRef{\LabelBase.cmd.aliaskomafont} and therefore can also be changed using
+\DescRef{maincls.cmd.setkomafont} or \DescRef{maincls.cmd.addtokomafont} and
+can be used by one of the \Macro{use\dots komafont} commands. Otherwise it
+executes the \PName{else code}.%
+
+In contrast, \Macro{IfIsAliaskomafont}\ChangedAt{v3.25}{\Class{scrbook}\and
+\Class{scrreprt}\and \Class{scrartcl}\and \Class{scrlttr2}} executes
+\PName{then code} only if \PName{element} has been defined with
+\DescRef{\LabelBase.cmd.aliaskomafont} as an alias of another element. For
+undefined elements as well as for elements defined with
+\DescRef{\LabelBase.cmd.newkomafont}, however, it executes the
+\PName{else code}.%
\EndIndexGroup
% \subsubsection{Paragraph Indention or Gap}
% \seclabel{parskip}
\begin{Declaration}
- \Macro{setparsizes}\Parameter{indent}\Parameter{distance}%^^A
- \Parameter{last line end space}
+ \Macro{setparsizes}\Parameter{indent}\Parameter{distance}
+ \Parameter{last-line end space}
\end{Declaration}
-With this command \KOMAScript{} provides to set the indent of the first line
-of a new paragraph, the distance between paragraphs and the white space that
-has to be at the end of the last line of each paragraph. This command should
-be used whenever changes should also be recognized by option
-\OptionValueRef{maincls}{parskip}{relative}. \KOMAScript{}\textnote{Beispiel}
-itself uses this command, e.\,g., with
+\KOMAScript{} provides the option to set the indent of the first line of a new
+paragraph, the distance between paragraphs, and the white space required at the
+end of the last line of each paragraph. You should use this command whenever
+the \OptionValueRef{maincls}{parskip}{relative} option should recognize these
+changes. \KOMAScript{}\textnote{example} itself uses this command, for
+example, in the form
\begin{lstcode}
\setparsizes{0pt}{0pt}{0pt plus 1fil}
\end{lstcode}
-to switch of paragraph indent and distance between paragraphs and to allow any
-white space at the end of the last line of paragraphs. This make sense, if a
-paragraph consists of a box only, that should be printed without vertical
-distance but with the whole column width. If, in opposite to that, the box
-should only span the whole width but should be printed with the current
-settings of paragraph indent and distance between paragraphs, usage of
+to eliminate both the paragraph indentation and inter-paragraph spacing, as
+well as to allow any amount of white space at the end of the last line of the
+paragraph. Such values are useful if a paragraph consists of only a box that
+should be printed without vertical spacing and filling the whole column
+width. If, on the other hand, the box should only span the whole width but use
+the current settings for indentation and distance between paragraphs, then
\begin{lstcode}
\setlength{\parfillskip}{0pt plus 1fil}
\end{lstcode}
-would be recommended.
-
-Since \KOMAScript~3.17\ChangedAt{v3.17}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}} changing or
-reactivation\IndexCmd{activateareas} of the typing area or the margins (see
-\autoref{cha:typearea}) will also reactivate the values of \Macro{setparsizes}
-if they have not been changed since the last usage of this command. This is
-one more reason not to change these values without using \KOMAScript. With
-compatibility to a \KOMAScript{} version prior to 3.17 (see
+is preferable.
+
+Starting with \KOMAScript~3.17\ChangedAt{v3.17}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}}, recalculating or
+reactivating\IndexCmd{activateareas} the type area or the margins (see
+\autoref{cha:typearea}) also readjusts the values of \Macro{setparsizes} if
+they have not been changed in the meantime. This is one more reason not to
+change these values without using \KOMAScript. Setting compatibility to a
+\KOMAScript{} version prior to 3.17 (see
\autoref{sec:maincls.compatibilityOptions},
-\DescPageRef{maincls.option.version}, option
-\DescRef{maincls.option.version}%
+\DescPageRef{maincls.option.version}, option \DescRef{maincls.option.version}%
\IndexOption{version}\important{\OptionValueRef{maincls}{version}{3.17}})
-this reactivation of the \Macro{setparsizes} values is deactivated.%
+disables this recalculation.%
%
\EndIndexGroup
@@ -436,70 +443,74 @@ this reactivation of the \Macro{setparsizes} values is deactivated.%
\Macro{ProvideSectionCommand}\OParameter{attributes}\Parameter{name}
\end{Declaration}
With\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} these commands you can either define a new section-like
-command \Macro{\PName{name}} or change an already defined sectioning command
-\Macro{\PName{name}}. To do so you use the optional argument to setup several
+ \Class{scrartcl}} these commands you can either define a new sectioning
+command, \Macro{\PName{name}}, or modify an existing sectioning command,
+\Macro{\PName{name}}. To do so, you use the optional argument to set several
\PName{attributes}. The \PName{attributes} are a comma-separated list of
-\PName{key}=\PName{value} assignments. Beside the style-independent attributes
-shown in \autoref{tab:maincls-experts.declaresection.keys}, there are style
-dependent attributes, too. Currently the following styles are provided:
-\begin{labeling}{\PValue{chapter}:}
+\PName{key}=\PName{value} assignments. In addition to the style-independent
+attributes shown in\autoref{tab:maincls-experts.declaresection.keys},
+\autopageref{tab:maincls-experts.declaresection.keys}, there are also
+attributes that depend on the style. Currently the following styles are
+available:
+\begin{description}\setkomafont{descriptionlabel}{}
\item[\PValue{chapter}:] \ChangedAt{v3.18}{\Class{scrbook}\and
- \Class{scrreprt}}Style of chapter headings. This style is currently used
- for \DescRef{maincls.cmd.chapter}\IndexCmd{chapter} and indirectly for
- \DescRef{maincls.cmd.addchap}\IndexCmd{addchap}. You can define new
- section-like commands using this style. To define new or to reconfigure
- existing commands you can also use the additional attributes of
+ \Class{scrreprt}}The style for chapter headings. This style is used by
+ default for \DescRef{maincls.cmd.chapter}\IndexCmd{chapter} and indirectly
+ for \DescRef{maincls.cmd.addchap}\IndexCmd{addchap}. You can define new
+ sectioning commands using this style, but then they do not automatically
+ have an \Macro{add\dots} variant. To configure existing or new sectioning
+ commands, you can also use the attributes of
\autoref{tab:maincls-experts.declarechapterstyle.keys},
\autopageref{tab:maincls-experts.declarechapterstyle.keys}.
- Note\textnote{Attention!} that command \DescRef{maincls.cmd.addchap} and the
- star variants are configured automatically together with
- \DescRef{maincls.cmd.chapter} and should not be changed independently. Note
+ Note\textnote{Attention!} that the \DescRef{maincls.cmd.addchap} command,
+ like the starred variants, is configured automatically with
+ \DescRef{maincls.cmd.chapter} and cannot be modified independently. Note
that \Class{scrartcl}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} does not
provide this style.
\item[\PValue{part}:] \ChangedAt{v3.18}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}}Style part headings. This style is
- currently used for \DescRef{maincls.cmd.part}\IndexCmd{part} and indirectly
- for \DescRef{maincls.cmd.addpart}\IndexCmd{addpart}. You can define new
- section-like commands using this style. To define new or to reconfigure
- existing commands you can also use the additional attributes of
+ \Class{scrreprt}\and \Class{scrartcl}}The style for part headings. This
+ style is used by default for \DescRef{maincls.cmd.part}\IndexCmd{part} and
+ indirectly for \DescRef{maincls.cmd.addpart}\IndexCmd{addpart}. You can
+ define new sectioning commands using this style, but then they do not
+ automatically have an \Macro{add\dots} variant. To configure existing or new
+ sectioning commands, you can also use the attributes of
\autoref{tab:maincls-experts.declarepartstyle.keys},
\autopageref{tab:maincls-experts.declarepartstyle.keys}.
- Note\textnote{Attention!} that command \DescRef{maincls.cmd.addpart} and the
- star variants are configured automatically together with
- \DescRef{maincls.cmd.part} and should not be changed independently.
-\item[\PValue{section}:] Style of section headings. This style is currently
+ Note\textnote{Attention!} that the \DescRef{maincls.cmd.addpart} command,
+ like the starred variants, is configured automatically with
+ \DescRef{maincls.cmd.part} and cannot be modified independently.
+\item[\PValue{section}:] The style for section headings. This style is currently
used for \DescRef{maincls.cmd.section}\IndexCmd{section},
\DescRef{maincls.cmd.subsection}\IndexCmd{subsection},
\DescRef{maincls.cmd.subsubsection}\IndexCmd{subsubsection},
\DescRef{maincls.cmd.paragraph}\IndexCmd{paragraph}, and
\DescRef{maincls.cmd.subparagraph}\IndexCmd{subparagraph}. You can define
- new section-like commands using this style. To define new or to reconfigure
- existing commands you can also use the additional attributes of
+ new sectioning commands using this style. To configure existing or new
+ sectioning commands, you can also use the attributes of
\autoref{tab:maincls-experts.declaresectionstyle.keys},
- \autopageref{tab:maincls-experts.declaresectionstyle.keys}. Definitions of
- new commands need\ChangedAt{v3.24}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} at least the \PName{key}s \PValue{style},
- \PValue{afterskip}, \PValue{beforeskip}, and \PValue{level}. \PValue{font}
- and \PValue{indent} are recommended. Need for \PValue{tocindent} and
- \PValue{tocnumwidth} depend on the command \PName{name}. This is also true
- if a command that was not a section-like command before will be redefined as
- a section-like command using
- \Macro{RedeclareSectionCommand}. Note\textnote{Attention!} that command
- \Macro{addsec} and the star variants are configured automatically together
- with \DescRef{maincls.cmd.section} and should not be changed
- independently. Defining a new section-like command with this style will also
- define an element with the same \PName{name} and the possibility to change
- its font using \DescRef{maincls.cmd.setkomafont} or
- \DescRef{maincls.cmd.addtokomafont} (see \autoref{sec:maincls.textmarkup},
- \DescPageRef{maincls.cmd.setkomafont}), if such an element does not already
- exist.
-\end{labeling}
-
+ \autopageref{tab:maincls-experts.declaresectionstyle.keys}. When redefining
+ a command, you need\ChangedAt{v3.24}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}} at least the \PName{key}s
+ \PValue{style}, \PValue{afterskip}, \PValue{beforeskip}, and \PValue{level}.
+ \PValue{font} and \PValue{indent} are recommended. \PValue{tocindent} and
+ \PValue{tocnumwidth} may also be required depending on the command's
+ \PName{name}. This also applies if a command that was not previously a
+ sectioning command is redefined as a sectioning command using
+ \Macro{RedeclareSectionCommand}. Note\textnote{Attention!} that the
+ \Macro{addsec} command and its starred variants are configured automatically
+ with \DescRef{maincls.cmd.section} and cannot be changed independently.
+\end{description}
+Defining a sectioning command also creates an element with the same
+\PName{name}, if it does not already exist. For \PValue{chapter} and
+\PValue{part}, elements are also created for the prefix line. You can change
+its font settings using \DescRef{maincls.cmd.setkomafont} or
+\DescRef{maincls.cmd.addtokomafont} (see \autoref{sec:maincls.textmarkup},
+\DescPageRef{maincls.cmd.setkomafont}).
+
\begin{table}
- \caption[{Style-independent attributes at the declaration of section-like
- commands}]{Available \PName{key}s and \PName{value}s for the
- style-independent \PName{attributes} declaring a section-like command}%
+ \caption[{Style-independent attributes for declaring sectioning
+ commands}]{Available \PName{key}s and \PName{value}s for
+ style-independent \PName{attributes} when declaring sectioning command}%
\label{tab:maincls-experts.declaresection.keys}%
\begin{tabularx}{\linewidth}{llX}
\toprule
@@ -508,48 +519,46 @@ dependent attributes, too. Currently the following styles are provided:
\PValue{counterwithin} & \PName{counter name} & The value of the
counter of the heading should depend on \PName{counter name}. Whenever
\Macro{stepcounter} or \Macro{refstepcounter} increases the value of
- \PName{counter name}, the value of the counter of this heading should be
- set to 0. Also the output of the value of this heading should be prefixed
- by \Macro{the\PName{counter name}}
- followed by a dot.\\
+ \PName{counter name}, the value of the counter of this heading is
+ reset to 0. In addition, \Macro{the\PName{counter name}} is prefixed
+ with a dot when this counter is output.\\
\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartl}}%
\PValue{counterwithout} & \PName{counter name} & Cancels a prior
\PValue{counterwithin} setting. Therefore it makes sense only if you
- re-define an existing
- section-like command.\\
- \PValue{expandtopt} & \PName{switch}& If the switch is on, all following
- values for lengths will be completely expanded, evaluated and stored as
- \texttt{pt} values. If the switch is off, all following values for
- lengths will be completely expanded, tentatively evaluated but only
- expanded stored. Any values from \autoref{tab:truefalseswitch},
- \autopageref{tab:truefalseswitch} may be used. Default is
- \PValue{false}.\\
- \PValue{level} & \PName{integer} & A number, denoting depth of section
- (see counter \DescRef{maincls.counter.secnumdepth},
+ redefine an existing sectioning command.\\
+ \PValue{expandtopt} & \PName{switch}& If the switch is on, all subsequent
+ values for lengths will be completely expanded, evaluated, and stored as
+ \texttt{pt} values when they are defined. This means lengths no longer
+ depend on the current font size. If the switch is off, all subsequent
+ values for lengths will be tentatively expanded and evaluated but stored
+ for full evaluation at application time. You can use any values from
+ \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. The
+ default is \PValue{false}.\\
+ \PValue{level} & \PName{integer} & The numerical value of the sectioning level
+ (see the \DescRef{maincls.counter.secnumdepth} counter,
\autoref{sec:maincls.structure},
\DescPageRef{maincls.counter.secnumdepth});
- the value should be unique.\\
+ the value should be unique and is mandatory for new levels.\\
\PValue{style} & \PName{name} & Defines the style of the
heading.\\
\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
- \PValue{tocstyle} & \PName{name} & Defines the style of the entries into
- the table of contents. You can use every already defined toc-entry style
+ \PValue{tocstyle} & \PName{name} & Defines the style of the entries in
+ the table of contents. You can use every previously defined TOC-entry style
(see \autoref{sec:tocbasic.tocstyle}). An empty \PName{name} prevents a
- new definition of the toc-entry
+ new definition of the TOC-entry
command \Macro{l@\dots}.\\
\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
\PValue{toc\PName{option}} & \PName{value} & Additional options depending
- on the TOC-entry style given by \Option{tocstyle}. See
+ on the TOC-entry style selected with \Option{tocstyle}. See
\autoref{sec:tocbasic.tocstyle}, \autopageref{sec:tocbasic.tocstyle} for
- additional information about TOC-entry styles. See
+ additional information about TOC-entry styles. You can find the attributes
+ that can be used as \PName{option}s for the predefined TOC-entry styles of
+ the \Package{tocbasic} package in
\autoref{tab:tocbasic.tocstyle.attributes},
- \autopageref{tab:tocbasic.tocstyle.attributes} for information about the
- attributes of the predefined TOC-entry styles of package
- \Package{tocbasic}, that can be used
- as \PName{option}.\\
+ \autopageref{tab:tocbasic.tocstyle.attributes}.\\
% \PValue{tocindent} & \PName{length} & Total indentation from the left
% margin of the entry in the table of
% contents corresponding to this
@@ -575,250 +584,205 @@ dependent attributes, too. Currently the following styles are provided:
\end{table}
\begin{table}
- \caption[{Attributes of the style \PValue{section} declaring a section-like
- command}]{Additional \PName{keys} and \PName{value}s of attributes
- declaring a section-like command with style \PValue{section}}%
+ \caption[{Attributes of the \PValue{section} style when declaring a
+ sectioning command}]{Additional \PName{key}s and \PName{value}s for
+ attributes when declaring a sectioning command with the \PValue{section}
+ style}%
\label{tab:maincls-experts.declaresectionstyle.keys}%
\begin{tabularx}{\linewidth}{llX}
\toprule
\PName{key} & \PName{value} & Description \\
\midrule
\PValue{afterskip} & \PName{length} & A negative value activates a run-in
- heading. The absolute value is the
- skip to leave to right of the run-in
- heading. A positive value is the
- vertical skip below the heading.\\
- \PValue{beforeskip} & \PName{length}& The absolute value of the vertical
- skip before the heading. If the
- value is negative, then the
- paragraph indent of the text
- following the heading is
- suppressed.\\
- \PValue{font} & \PName{font commands} &
- The initial font setting that
- should be used beside
- \DescRef{maincls.fontelement.disposition} for the
- heading. You can use all settings,
- that are allowed for
- \DescRef{maincls.cmd.setkomafont} and
- \DescRef{maincls.cmd.addtokomafont} for the
- element of the heading.\\
- \PValue{indent} & \PName{length} & Indentation of heading from the left
- margin.\\
+ heading. The absolute value is the horizontal space after the heading. A
+ positive value is the vertical skip below the heading.\\
+ \PValue{beforeskip} & \PName{length} & The amount indicates the vertical
+ skip before the heading. If the value is negative, a positive distance
+ is still inserted, but in this case the paragraph indent of the text
+ following the heading is suppressed.\\
+ \PValue{font} & \PName{font commands} & The font settings that should be
+ used for the heading in addition to
+ \DescRef{maincls.fontelement.disposition}. You can use all settings that
+ are allowed for \DescRef{maincls.cmd.setkomafont} and
+ \DescRef{maincls.cmd.addtokomafont} for the element of the heading.\\
+ \PValue{indent} & \PName{length} & The indentation of heading from the
+ left margin.\\
\bottomrule
\end{tabularx}
\end{table}
\begin{table}
- \caption[{Attributes of the style \PValue{chapter} declaring a section-like
- command}]{Additional \PName{keys} and \PName{value}s of attributes
- declaring a section-like command with style \PValue{chapter}}%
+ \caption[{Attributes of the \PValue{chapter} style when declaring a
+ sectioning command}]{Additional \PName{keys} and \PName{value}s for
+ attributes when declaring a sectioning command with the \PValue{chapter}
+ style}%
\label{tab:maincls-experts.declarechapterstyle.keys}%
\begin{tabularx}{\linewidth}{llX}
\toprule
\PName{key} & \PName{value} & Description \\
\midrule
- \PValue{afterskip} & \PName{length} & The absolute value is the
- vertical skip below the heading.\\
- \PValue{beforeskip} & \PName{length}& The absolute value of the vertical
- skip before the heading. If the
- value is negative, then the
- paragraph indent of the text
- following the heading is
- suppressed. This will be done also
- for positive values if class option
- \DescRef{maincls.option.version} is
- set to a value less than 3.22.\\
- \PValue{font} & \PName{font commands} &
- The initial font setting that
- should be used beside
- \DescRef{maincls.fontelement.disposition} for the
- heading. You can use all settings,
- that are allowed for
- \DescRef{maincls.cmd.setkomafont} and
- \DescRef{maincls.cmd.addtokomafont} for the
- element of the heading.\\
+ \PValue{afterskip} & \PName{length} & The value is the vertical skip below
+ the heading.\\
+ \PValue{beforeskip} & \PName{length} & The value of the vertical skip
+ before the heading. If the value is negative, then the positive distance
+ is nevertheless inserted, and the paragraph indent of the text following
+ the heading is suppressed. There will also be no indentation even for
+ positive values if the \DescRef{maincls.option.version} class option is
+ set to a value less than 3.22.\\
+ \PValue{font} & \PName{font commands} & The font setting to use for the
+ heading in addition to \DescRef{maincls.fontelement.disposition}. You
+ can use all settings, that are allowed for
+ \DescRef{maincls.cmd.setkomafont} and
+ \DescRef{maincls.cmd.addtokomafont} for this element.\\
\PValue{innerskip} & \PName{length} & The vertical skip between the prefix
- line and the heading's text, if a
- prefix line is used.\\
- \PValue{pagestyle} & \PName{page style name} &
- The name of the page style that
- should be used automatically on
- pages with the heading. There is no
- validation whether or not
- \PName{page style name} is really
- the name of a page style. Therefore,
- wrong names will result in error
- messages at usage of the
- section-like command.\\
- \PValue{prefixfont} & \PName{font commands} &
- The initial font setting that
- should be used beside
- \DescRef{maincls.fontelement.disposition}
- and the
- element of the heading for the
- prefix line of the heading. You can
- use all settings that are allowed
- for
- \DescRef{maincls.cmd.setkomafont}
- and
- \DescRef{maincls.cmd.addtokomafont}
- for the element of the prefix
- line.\\
+ line and the heading's text, if a prefix line is used.\\
+ \PValue{pagestyle} & \PName{page style name} & The name of the page style
+ to use automatically for pages with the heading. There is no check to
+ see if the \PName{page style name} is valid. Therefore, incorrect names
+ will result in error messages when the sectioning command is used.\\
+ \PValue{prefixfont} & \PName{font commands} & The font setting to use
+ for the prefix line of the heading, in addition to the
+ \DescRef{maincls.fontelement.disposition} and sectioning command
+ elements. You can use all settings that are allowed for
+ \DescRef{maincls.cmd.setkomafont} and
+ \DescRef{maincls.cmd.addtokomafont} for the element of the prefix
+ line.\\
\bottomrule
\end{tabularx}
\end{table}
\begin{table}
- \caption[{Attributes of the style \PValue{part} declaring a section-like
- command}]{Additional \PName{keys} and \PName{value}s of attributes
- declaring a section-like command with style \PValue{part}}%
+ \caption[{Attributes of the \PValue{part} style when declaring a sectioning
+ command}]{Additional \PName{keys} and \PName{value}s for attributes
+ when declaring a sectioning command with the \PValue{part} style}%
\label{tab:maincls-experts.declarepartstyle.keys}%
\begin{tabularx}{\linewidth}{llX}
\toprule
\PName{key} & \PName{value} & Description \\
\midrule
- \PValue{afterskip} & \PName{length} & The absolute value is the
- vertical skip below the heading.\\
- \PValue{beforeskip} & \PName{length}& The absolute value of the vertical
- skip before the heading.\\
- \PValue{font} & \PName{font commands} &
- The initial font setting that
- should be used beside
- \DescRef{maincls.fontelement.disposition}
- for the
- heading. You can use all settings,
- that are allowed for
- \DescRef{maincls.cmd.setkomafont} and
- \DescRef{maincls.cmd.addtokomafont}
- for the element of the heading.\\
+ \PValue{afterskip} & \PName{length} & The value is the vertical skip below
+ the heading.\\
+ \PValue{beforeskip} & \PName{length}& The value is the vertical skip above
+ the heading.\\
+ \PValue{font} & \PName{font commands} & The font setting to use for the
+ heading in addition to \DescRef{maincls.fontelement.disposition}. You
+ can use all settings that are allowed for
+ \DescRef{maincls.cmd.setkomafont} and
+ \DescRef{maincls.cmd.addtokomafont} for the element of the heading.\\
\PValue{innerskip} & \PName{length} & % \OnlyAt{\Class{scrbook}\and
% \Class{scrreprt}}%
- The vertical skip between the prefix
- line and the heading's text of
- \Class{scrbook} and
- \Class{scrreprt}.\\
+ The vertical skip between the prefix line and the heading text in
+ \Class{scrbook} and \Class{scrreprt}.\\
\PValue{pagestyle} & \PName{page style name} &
% \OnlyAt{\Class{scrbook}\and
% \Class{scrreprt}}%
- The name of the page style that
- should be used automatically on
- pages with the heading. There is no
- validation whether or not
- \PName{page style name} is really
- the name of a page style. Therefore,
- wrong names will result in error
- messages at usage of the
- section-like command. This feature
- is only available with
- \Class{scrbook} or
- \Class{scrreprt}.\\
- \PValue{prefixfont} & \PName{font commands} &
- The initial font setting that
- should be used beside
- \DescRef{maincls.fontelement.disposition}
- and the
- element of the heading for the
- prefix line of the heading. You can
- use all settings that are allowed
- for
- \DescRef{maincls.cmd.setkomafont}
- and
- \DescRef{maincls.cmd.addtokomafont}
- for the element of the prefix
- line.\\
+ The name of the page style to use automatically on pages with the
+ heading. There is no check to see if \PName{page style name} is valid.
+ Therefore, incorrect names will result in error messages when the
+ sectioning command is used. This feature only exists in \Class{scrbook}
+ and\Class{scrreprt}.\\
+ \PValue{prefixfont} & \PName{font commands} & The font setting to use for
+ the prefix line of the heading, in addition to the
+ \DescRef{maincls.fontelement.disposition} and sectioning command
+ elements. You can use all settings that are allowed for
+ \DescRef{maincls.cmd.setkomafont} and
+ \DescRef{maincls.cmd.addtokomafont} for the element of the prefix
+ line.\\
\bottomrule
\end{tabularx}
\end{table}
-\Macro{DeclareNewSectionCommand} defines a new section-like command. If the
+\Macro{DeclareNewSectionCommand} defines a new sectioning command. If the
same \PName{name} is already used by \TeX{} for something else, the command
will result in an error message and will not define anything.
-\Macro{ProvideSectionSommand} is similar but does not show any error message.
+\Macro{ProvideSectionSommand} behaves similarly but does not issue an error
+message.
-\Macro{RedeclareSectionCommand} can only change an existing command to a
-section-like command with given \PName{attributes}. There is no pre-validation
-to make sure that \Macro{\PName{name}} was a section-like command
-before. However, it has to be an already used command sequence \PName{name}.
+\Macro{RedeclareSectionCommand}, on the other hand, can only change an
+existing command to a sectioning command with the specified
+\PName{attributes}. It does not check whether \Macro{\PName{name}} is already
+a sectioning command. It only needs to be a \PName{name} already a \TeX
+command.
\Macro{DeclareSectionCommand} does not check whether or not \PName{name} is
-an already used \TeX{} command sequence. It just defines a section-like
-command \Macro{\PName{name}} with the given \PName{attributes}.
-
-Every section-like command has also a corresponding counter with the same
-\PName{name}, that will be allocated using \Macro{newcounter} if
-necessary. The same rule applies to the corresponding output of the counter:
-\Macro{the\PName{name}}, the output format: \Macro{\PName{name}format}, the
-command to generate a running head: \Macro{\PName{name}mark}, the counter
-format of the running head: \Macro{\PName{name}markformat}, the font element:
-\FontElement{\PName{name}}, and the section depth number:
-\Macro{\PName{name}numdepth}. The command for the running head
-\Macro{\PName{name}mark} will be defined to not generate any running head. The
-output of the counter, \Macro{the\PName{name}}, will show an Arabic number. If
-the \PName{key} \PValue{counterwithin} defines a counter the heading number
-depends on, the output of the counter will be prefixed by the output of that
-counter followed by a dot.
-
-Beside\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} the section-like command, a command for corresponding
-entries to the table of contents is defined also. This is done using package
-\Package{tocbasic}\important{\Package{tocbasic}}\IndexPackage{tocbasic}.
-Attribute \PName{tocstyle} defines the style of those entries. If you set an
-empty \PName{name}, e.\,g., using \OptionValue{tocstyle}{} or
-\OptionValue{tocstyle}{\{\}}, the entry command will not be changed. This is
-important, if you use another package to modify the table of contents. If you
-do not set attribute \PValue{tocstyle} the already configured style will be
-used again.
+an existing \TeX{} command name. It just defines a sectioning
+command \Macro{\PName{name}} with the specified \PName{attributes}.
+
+Each sectioning command also has a corresponding counter with the same
+\PName{name} that is allocated with \Macro{newcounter} if necessary. The same
+naming rule applies to the corresponding output of the counter
+(\Macro{the\PName{name}}), the counter's format (\Macro{\PName{name}format}),
+the command to generate a running head (\Macro{\PName{name}mark}), the format
+of the counter in the running head (\Macro{\PName{name}markformat}), the font
+element (\FontElement{\PName{name}}), and the section-depth number
+(\Macro{\PName{name}numdepth}). The command for the running head,
+\Macro{\PName{name}mark}, is defined by default not to generate a running
+head. The default output of the counter \Macro{the\PName{name}} is an Arabic
+number. If the counter is defined as depending on another counter with the
+\PValue{counterwithin} \PName{key}, the output of this counter will be
+prefixed by a dot.
+
+In\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} addition to the sectioning command itself, a command for
+corresponding entries to the table of contents is also defined. This is done
+using the \hyperref[cha:tocbasic]{\Package{tocbasic}}%
+\important{\hyperref[cha:tocbasic]{\Package{tocbasic}}}\IndexPackage{tocbasic}
+package. The \PName{tocstyle} attribute defines the style of those entries. If
+you set an empty \PName{name}, e.\,g. using \OptionValue{tocstyle}{} or
+\OptionValue{tocstyle}{\{\}}, the command for the TOC entry will not be
+changed. This is important, for example, if you use another package to modify
+the table of contents. If you do not set the \PValue{tocstyle} attribute, the
+previous style will be used again during the redefinition.
The\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} different toc-entry styles also have different, additional
-attributes. You can set them here too, if you prefix them with
-\PValue{toc}. For example, you can setup the level of the toc-entries,
-\PValue{level}, using \PValue{toclevel}, the indention, \PValue{indent}, using
-\PValue{tocindent}, or the number width, \PValue{numwidth}, using
-\PValue{tocnumwidth}. For more toc-entry style attributes see
-\autoref{sec:tocbasic.tocstyle}, \autopageref{sec:tocbasic.tocstyle}.
+ \Class{scrartcl}} different TOC-entry styles also have different additional
+attributes. You can set them directly if you prefix them with \PValue{toc}.
+For example, you can set the level of the TOC entries, \PValue{level}, using
+\PValue{toclevel}, the indention, \PValue{indent}, using \PValue{tocindent},
+or the number width, \PValue{numwidth}, using \PValue{tocnumwidth}. For more
+TOC-entry style attributes see \autoref{sec:tocbasic.tocstyle},
+\autopageref{sec:tocbasic.tocstyle}.
\begin{Example}
- Because of incomprehensible reasons, the headings of
- \DescRef{maincls.cmd.paragraph} shouldn't be run-in headings any longer but
- headings similar to \DescRef{maincls.cmd.subsubsection}. The vertical skip
- above the heading should be 10\,pt and the following text should be set
- without any vertical distance. To do so, you can simply use:
+ For some unknown reason, you want to redefine the
+ \DescRef{maincls.cmd.paragraph} headings so that they are no longer run-in
+ headings but are similar to \DescRef{maincls.cmd.subsubsection}. The
+ vertical skip above the heading should be 10\Unit{pt} and no additional
+ vertical skip below the heading. To do so, you can use:
\begin{lstcode}
\RedeclareSectionCommand[%
beforeskip=-10pt,%
afterskip=1sp%
]{paragraph}
\end{lstcode}
- The negative value of \PValue{beforeskip} does not only result in a
- positive vertical skip before the heading, but also deactivates the paragraph
- indentation of the following text. Despite the specification of no vertical
- skip after the heading a value of 1\,sp has been given to
- \PValue{afterskip}. This is because \LaTeX{} here doesn't accept 0\,pt as
- positive value. So 1\,sp is the lowest possible positive value.
-
- Generally, for the vertical adjustment it is better to have some
- tolerance in the declaration of gaps\,---\,the so called \emph{glue}:
+ The negative value of \PValue{beforeskip} creates a positive vertical skip
+ before the heading and simultaneously disables the paragraph indentation of
+ the following text. Even though the specification did not want any vertical
+ skip after the heading, a value of 1\Unit{sp} has been given here. This is
+ because \LaTeX{} doesn't recognize 0\Unit{pt} as positive value. So
+ 1\Unit{sp} is the smallest possible positive value.
+
+ Generally, it is better to have some tolerance for adjusting the vertical
+ spacing, the so-called \emph{glue}:
\begin{lstcode}
\RedeclareSectionCommand[%
beforeskip=-10pt plus -2pt minus -1pt,%
afterskip=1sp plus -1sp minus 1sp%
]{paragraph}
\end{lstcode}
- Doing so you have to know, that the glue also switches the algebraic sign
- before becoming a skip, if the value is negative. That is the reason for the
- negative glue values in the example. Additionally we used the occasion to
- minimize the vertical skip after the heading using glue too.
+ Note that the glue also switches the algebraic sign before becoming a skip,
+ if the value is negative. That is the reason for the negative glue values in
+ the example. Additionally we used the occasion to minimize the vertical skip
+ after the heading using glue too.
\end{Example}
-In the example above only \PValue{beforeskip} and \PValue{afterskip} were
-needed, because since v3.15 \KOMAScript{} defines
-\DescRef{maincls.cmd.paragraph} itself using
-\Macro{DeclareSectionCommand}. All other values are just reused with their
-initial definition. Furthermore, the original definition of
-\DescRef{maincls.cmd.paragraph} in \Class{scrartcl} reads:
+In the example above, we only needed to define the keys \PValue{beforeskip}
+and \PValue{afterskip} because since v3.15 \KOMAScript{} has defined
+\DescRef{maincls.cmd.paragraph} internally using
+\Macro{DeclareSectionCommand}, and therefore the other settings can be adopted
+unchanged. The original definition of \DescRef{maincls.cmd.paragraph} in
+\Class{scrartcl} reads:
\begin{lstcode}
\DeclareSectionCommand[%
level=4,
@@ -833,23 +797,24 @@ initial definition. Furthermore, the original definition of
\end{lstcode}
\Class{scrreprt} and \Class{scrbook} use slightly different values.
-Some settings of \DescRef{maincls.cmd.chapter} depend on option
-\DescRef{maincls.option.headings} (see \autoref{sec:maincls.structure},
+Some settings of \DescRef{maincls.cmd.chapter} depend on the
+\DescRef{maincls.option.headings} option (see \autoref{sec:maincls.structure},
\DescPageRef{maincls.option.headings}).
\hyperref[tab:maincls.chapter.skips]{Table~\ref*{tab:maincls.chapter.skips}}
shows the default values of these settings. An overview of all settings is
shown in \autoref{tab:maincls.section.defaults}. For more
information\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} about the default of the toc-entry styles see
+\Class{scrartcl}} about the default of the TOC-entry styles see
\autoref{sec:tocbasic.tocstyle}\important{\Package{tocbasic}},
-\autopageref{sec:tocbasic.tocstyle}. Please note, that \PValue{1ex} and
+\autopageref{sec:tocbasic.tocstyle}. Note that \PValue{1ex} and
\Length{baselineskip} depend on the default font size of the heading or the
table of contents entry.%
-%
+
\begin{table}
\centering
- \caption{Defaults of the chapter headings of \Class{scrbook}
- and \Class{scrreprt} subject to option \DescRef{maincls.option.headings}}
+ \caption{Defaults for the chapter headings of \Class{scrbook}
+ and \Class{scrreprt} depending on the \DescRef{maincls.option.headings}
+ option}
\label{tab:maincls.chapter.skips}
\begin{tabular}{ll}
\multicolumn{2}{@{}l}{\bfseries
@@ -894,12 +859,12 @@ table of contents entry.%
%begin{table}
% \centering
\begin{longtable}{@{}p{\columnwidth}@{}}
- \caption{Default of the headings of \Class{scrbook} and
+ \caption{Defaults for the headings of \Class{scrbook} and
\Class{scrreprt}}%
\label{tab:maincls.section.defaults}\\
\endfirsthead
- \caption[]{Default of the headings of \Class{scrbook} and
- \Class{scrreprt} \emph{(Continuation)}}\\
+ \caption[]{Default for the headings of \Class{scrbook} and
+ \Class{scrreprt} \emph{(continued)}}\\
\addlinespace[-\normalbaselineskip]
\endhead
\raggedleft\dots\\
@@ -938,7 +903,7 @@ table of contents entry.%
\PValue{font} & see element \DescRef{maincls.fontelement.chapter},
\autoref{tab:maincls.structureElementsFont},
\autopageref{tab:maincls.structureElementsFont} \\
- \PValue{innerskip} & \PValue{0pt} \\
+ \PValue{innerskip} & \PValue{0.5\Length{baselineskip}} \\
\PValue{level} & 0 \\
\PValue{prefixfont} & see element
\DescRef{maincls.fontelement.chapterprefix},
@@ -1050,7 +1015,10 @@ table of contents entry.%
\end{tabularx}
\end{longtable}
%end{table}
-%
+Incidentally, the internal macro \Macro{scr@parindent} used in the settings
+for \DescRef{maincls.cmd.subparagraph} is the paragraph indent set by the
+\DescRef{maincls.option.parskip} option or the
+\DescRef{maincls-experts.cmd.setparsizes} command.
\EndIndexGroup
@@ -1064,98 +1032,111 @@ table of contents entry.%
\Macro{ProvideSectionCommands}\OParameter{attributes}
\Parameter{list of names}
\end{Declaration}
-With\ChangedAt[2014/11]{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} these commands you can either define or change several
-section-like commands at once. The names of the section-like commands are
-given by the comma-separated \PName{list of names}.
-
-There are two more differences to the previously described commands that only
-define or change a single section-like command. Firstly, in case of error\,---\,if \Macro{DeclareNewSectionCommands} is used for an already defined \TeX{}
-command sequence or if \Macro{RedeclareSectionCommands} is used for an
-undefined \TeX{} command sequence\,---\,the definition will be done in spite
-of raising an error message.
-
-Secondly, there is one more attribute \PValue{increaselevel} with an optional
-integer argument. This attribute changes the meaning of the attributes
-\PValue{level} and \PValue{toclevel} (see
-\autoref{tab:maincls-experts.declaresection.keys}) so their values become
-start values for the first section-like command of the \PName{list of
- names}. From section-like command to section-like command of the \PName{list
- of names} the value of \PValue{level} and \PValue{toclevel}
-will be increased by the value of \PValue{increaselevel}. If attribute
-\PValue{increaselevel} is used without an assignment the increase value is 1.
+These\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} commands can define or change a whole series of
+sectioning commands at once. The names of the sectioning commands are given by
+the comma-separated \PName{list of names}.
+
+These commands differ in two other ways from the previously described commands
+that only define or change a single sectioning command. First, in case of
+error\,---\,that is if a command already exists with
+\Macro{DeclareNewSectionCommands} or is undefined with
+\Macro{RedeclareSectionCommands}\,---\,the definition will be performed
+regardless. An appropriate an error message will, of course, be reported
+anyway.
+
+Second, there is another attribute,
+\important{\PValue{increaselevel}}\OptionVName{increaselevel}{integer}. This
+attribute changes the meaning of the attributes \PValue{level} and
+\PValue{toclevel} (see \autoref{tab:maincls-experts.declaresection.keys}) so
+that their values become starting values for the first sectioning command of
+the \PName{list of names}. For all other sectioning command in the \PName{list
+of names}, the values of \PValue{level} and \PValue{toclevel} are successively
+increased by the value of \PValue{increaselevel}. If the
+\PValue{increaselevel} attribute is used without assigning a value, 1 is
+assumed.
%
\EndIndexGroup
\begin{Declaration}
- \Macro{chapterheadstartvskip}%
- \Macro{chapterheadmidvskip}%
- \Macro{chapterheadendvskip}%
- \Macro{partheadstartvskip}%
- \Macro{partheadmidvskip}%
- \Macro{partheadendvskip}%
+ \Macro{chapterheadstartvskip}
+ \Macro{chapterheadmidvskip}
+ \Macro{chapterheadendvskip}
+ \Macro{partheadstartvskip}
+ \Macro{partheadmidvskip}
+ \Macro{partheadendvskip}
\Macro{partheademptypage}
\end{Declaration}
These\important[i]{\DescRef{maincls.cmd.chapter}\\
\DescRef{maincls.cmd.part}\\
\DescRef{maincls.cmd.addchap}\\
- \DescRef{maincls.cmd.addpart}} commands are used inside of the definition of the headings
-\DescRef{maincls.cmd.chapter}\IndexCmd{chapter}, \DescRef{maincls.cmd.part}, \DescRef{maincls.cmd.addchap},
-\DescRef{maincls.cmd.addpart} and their star-variations. Thereby
-\Macro{chapterheadstartvskip} is designed to be a command, that inserts a
-vertical distance before the chapter heading. Analogues
-\Macro{chapterheadendvskip} is designed to be a command, that inserts a vertical
-distance after the chapter heading. If\ChangedAt{v3.15}{\Class{scrbook}\and
+ \DescRef{maincls.cmd.addpart}\\
+ \DescRef{maincls.cmd.chapter*}\\
+ \DescRef{maincls.cmd.part*}\\
+ \DescRef{maincls.cmd.addchap*}\\
+ \DescRef{maincls.cmd.addpart*}} commands are used inside the headings of the
+previously described \PValue{chapter} and \PValue{part} styles and thus for
+the definitions of \DescRef{maincls.cmd.chapter}\IndexCmd{chapter},
+\DescRef{maincls.cmd.part}\IndexCmd{part},
+\DescRef{maincls.cmd.addchap}\IndexCmd{addchap}, and
+\DescRef{maincls.cmd.addpart}\IndexCmd{addpart}, as well as their starred
+variants \DescRef{maincls.cmd.chapter*}\IndexCmd{chapter*},
+\DescRef{maincls.cmd.part*}\IndexCmd{part*},
+\DescRef{maincls.cmd.addchap*}\IndexCmd{addchap*}, and
+\DescRef{maincls.cmd.addpart*}\IndexCmd{addpart*}.
+The \Macro{chapterheadstartvskip} command is intended to insert a
+vertical skip before the chapter heading. Similarly,
+\Macro{chapterheadendvskip} is a command intended to insert a vertical
+skip after the chapter heading. If\ChangedAt{v3.15}{\Class{scrbook}\and
\Class{scrreprt}} the chapter heading has a prefix number line (see option
\DescRef{maincls.option.chapterprefix} in \autoref{sec:maincls.structure},
\DescPageRef{maincls.option.chapterprefix}), \Macro{chapterheadmidvskip}
-will be used between the number line and the heading text.
+is also used between the number line and the heading text.
-Vertical distance above and below part headings will be inserted using the
-commands \Macro{partheadstartvskip} and \Macro{partheadendvskip}. A page break
-would be interpreted to be part of the vertical distance and therefore is
-already part of the default of \Macro{partheadendvskip} in
+The \Macro{partheadstartvskip} and \Macro{partheadendvskip} commands insert
+vertical skips above and below part headings. A page break is interpreted as
+part of the vertical distance. Such a page break is part of the default
+definitions of \Macro{partheadendvskip} in
\Class{scrbook}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} and
-\Class{scrreprt}. Command
+\Class{scrreprt}. The
\Macro{partheademptypage}\ChangedAt{v3.02}{\Class{scrbook}\and
- \Class{scrreprt}} is used to produce the empty page after the part heading
-page of \Class{scrbook} and \Class{scrreprt}.
+\Class{scrreprt}} command produces an empty page after the part heading page
+of \Class{scrbook} and \Class{scrreprt}.
-Since \KOMAScript~3.15\ChangedAt{v3.15}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}} the defaults of these seven commands
-are independent from option \DescRef{maincls.option.headings} (see
+Starting with \KOMAScript~3.15\ChangedAt{v3.15}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}}, the defaults of these seven commands
+are independent from the \DescRef{maincls.option.headings} option (see
\autoref{sec:maincls.structure},
-\DescPageRef{maincls.option.headings}). The original definitions of the
-chapter heading reads since
-\KOMAScript~3.157\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}}:\IndexLength{@tempskipa}
+\DescPageRef{maincls.option.headings}). The default definitions for the
+chapter headings starting with
+\KOMAScript~3.17\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} correspond to:\IndexLength{@tempskipa}
\begin{lstcode}
\newcommand*{\chapterheadstartvskip}{\vspace{\@tempskipa}}
\newcommand*{\chapterheadmidvskip}{\par\nobreak\vskip\@tempskipa}
\newcommand*{\chapterheadendvskip}{\vskip\@tempskipa}
\end{lstcode}
-Every usage of \OptionValueRef{maincls}{headings}{big}\IndexOption{headings},
+These defaults are reactivated every time you use
+\OptionValueRef{maincls}{headings}{big}\IndexOption{headings},
\OptionValueRef{maincls}{headings}{normal}, or
-\OptionValueRef{maincls}{headings}{small} reactivates these default
-definitions.
-
-Command \DescRef{maincls.cmd.chapter} automatically sets the internal length
-\Length{@tempskipa} to the value of the
-\DescRef{\LabelBase.cmd.DeclareSectionCommand}\IndexCmd{DeclareSectionCommand} attribute
-\PValue{beforeskip} before calling
-\Macro{chapterheadstartvskip}. Correspondingly it sets the length to the value
-of attribute \PValue{afterskip} before calling \Macro{chapterheadendvskip} and
-\PValue{innerskip} before calling \Macro{chapterheadmidvskip}. If you redefine
-\Macro{chapterheadstartvskip}, \Macro{chapterheadmidvskip}, or
-\Macro{chapterheadendvskip} you should also correspond the new definition to
-\Length{@tempskipa} to respect the values of \DescRef{\LabelBase.cmd.DeclareSectionCommand}.
-
-The default values of the distances of \DescRef{maincls.cmd.part} do not depend on option
-\DescRef{maincls.option.headings}. So the corresponding commands will not be redefined using
-the options. The\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} original definitions of these commands of \Class{scrbook}
-and \Class{scrreprt} read:
+\OptionValueRef{maincls}{headings}{small}. As a side effect, these options may
+affect not only chapter titles but all headings in the \PValue{chapter} style
+
+The \PValue{chapter} style automatically sets the internal length
+\Length{@tempskipa} to the value that results from the
+\DescRef{\LabelBase.cmd.DeclareSectionCommand}\IndexCmd{DeclareSectionCommand}
+attribute \PValue{beforeskip} before calling \Macro{chapterheadstartvskip}.
+Similarly, it sets this length to the value of the \PValue{afterskip}
+attribute before calling \Macro{chapterheadendvskip}, and to
+\PValue{innerskip} before calling \Macro{chapterheadmidvskip}.
+
+The default values of the distances of \DescRef{maincls.cmd.part} do not
+depend on the \DescRef{maincls.option.headings} option. So the corresponding
+commands will not be redefined by this option.
+Their\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
+\Class{scrartcl}} default definitions in \Class{scrbook} and \Class{scrreprt}
+correspond to:
\begin{lstcode}
\newcommand*{\partheadstartvskip}{%
\null\vskip-\baselineskip\vskip\@tempskipa
@@ -1180,45 +1161,135 @@ and of \Class{scrartcl}:
\vskip\@tempskipa
}
\end{lstcode}
-Again \DescRef{maincls.cmd.part} sets
-\Length{@tempskipa}\IndexLength{@tempskipa} to the values of
+The \PValue{part} style once again sets the internal length
+\Length{@tempskipa}\IndexLength{@tempskipa} according to the settings of
\DescRef{\LabelBase.cmd.DeclareSectionCommand}\IndexCmd{DeclareSectionCommand}
-before the internal usage of the command.
-
-It\ChangedAt[2015/03]{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} is not recommended to redefine the command for the
-distances above or below the headings only for changing these distances,
-because you can reconfigure these distances much easier using
-\DescRef{\LabelBase.cmd.RedeclareSectionCommand}. Redefinition of the commands
-should be reserved to more complex changes. An\textnote{Example!} example
-that redefines \Macro{chapterheadstartvskip} and \Macro{chapterheadendvskip}
-to print extra rules above and below the chapter heading may be found at
-\cite{homepage} (in German).%
+before using the commands.
+
+If you redefine one of the commands used for the vertical skip in the original
+\Length{@tempskipa} but still want to be able to configure the lengths, for
+example with \DescRef{\LabelBase.cmd.RedeclareSectionCommand}, you should also
+use \Length{@tempskipa} in the new definition.
+Since\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} you can more easily configure the distances above, within,
+and below the headings using \DescRef{\LabelBase.cmd.RedeclareSectionCommand},
+you generally should not redefine the commands described here. Changing them
+should be reserved for more complex changes that cannot be accomplished with
+\DescRef{\LabelBase.cmd.RedeclareSectionCommand}. An\textnote{Example!}
+example that redefines \Macro{chapterheadstartvskip} and
+\Macro{chapterheadendvskip} to print extra rules above and below the chapter
+heading can be found at \cite{homepage} (in German).%
%
\EndIndexGroup
\begin{Declaration}
+ \Macro{partlineswithprefixformat}%
+ \Parameter{level}\Parameter{number}\Parameter{text}%
+\end{Declaration}
+This\ChangedAt{v3.25}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} command is used by headings with the \PValue{part} style to
+output the heading number and heading text. The \PName{number} and
+\PName{text} arguments are already formatted, including the font
+selections. Ultimately, this command controls the arrangement of the two parts
+of the heading. For unnumbered headings, \PName{number} is a completely empty
+argument, so it does not contain any formatting commands.
+
+The default definition is rather Spartan:
+\begin{lstcode}
+ \newcommand{\partlineswithprefixformat}[3]{%
+ #2#3%
+ }
+\end{lstcode}
+
+\begin{Example}
+ You want to have part headings in a light blue box with blue frame. The
+ box should occupy only about three quarters of full width of the text
+ area. So you try:
+\begin{lstcode}
+ \documentclass{scrbook}
+ \usepackage{xcolor}
+ \renewcommand*{\partlineswithprefixformat}[3]{%
+ \fcolorbox{blue}{blue!25}{%
+ \parbox{.75\linewidth}{#2#3}%
+ }%
+ }
+ \begin{document}
+ \part{Framed Part}
+ \end{document}
+\end{lstcode}
+ But surprisingly the heading is not longer centred\,---\,neither the box
+ itself nor the text inside the box.
+
+ The reason for the missing centring of the box is that the end of the
+ paragraph is hidden in the third argument of the command. So it still
+ finishes the paragraph of the text inside the box but not the paragraph of
+ the \Macro{parbox} itself. To solve this you add a \Macro{par} at the end of
+ the definition.
+
+ The reason for the missing centring inside the box is that the alignment of
+ \DescRef{maincls.cmd.raggedpart} is valid outside the box but not
+ automatically inside a \Macro{parbox}. To solve this you add
+ \Macro{raggedpart} inside the box.
+
+ With
+\begin{lstcode}
+ \documentclass{scrbook}
+ \usepackage{xcolor}
+ \renewcommand*{\partlineswithprefixformat}[3]{%
+ \fcolorbox{blue}{blue!25}{%
+ \parbox{.75\linewidth}{\raggedpart #2#3}%
+ }%
+ }
+ \par
+ \begin{document}
+ \part{Framed Part}
+ \end{document}
+\end{lstcode}
+ you get the expected result.
+\end{Example}
+
+As the example shows, users who redefine this command must watch out for
+several side effects. In addition to preserving the text alignment, they also
+must prevent page breaks within the headings, for example if they insert extra
+paragraphs or space. The example above does not have this problem. Not only
+does the box prevent a page breaks anyway, but \KOMAScript{} itself also
+changes \Macro{interlinepenalty} as part of \PName{text} so to prevent page
+breaks there. It also finishes \PName{text} with an internal paragraph break
+using \Macro{@@par}.
+
+The default definition of \Macro{partlineswithprefixformat} does not use the
+first argument, \PName{level}, nor is it needed in the example above. It is of
+interest only if you want to define several commands with the \PValue{part}
+style and need to distinguish the different levels. The predefined commands
+\DescRef{maincls.cmd.part}, \DescRef{maincls.cmd.part*},
+\DescRef{maincls.cmd.addpart}, and \DescRef{maincls.cmd.addpart*} all share
+the same \PName{level} \PName{part}.%
+\EndIndexGroup
+
+
+\begin{Declaration}
\Macro{chapterlineswithprefixformat}%
\Parameter{level}\Parameter{number}\Parameter{text}%
\Macro{chapterlinesformat}%
\Parameter{level}\Parameter{number}\Parameter{text}
\end{Declaration}
These\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}} commands are used
-by headings with style \PValue{chapter} to output the heading number and
-heading text depending on option
+by headings with the \PValue{chapter} style to output the heading number and
+heading text, depending on the
\DescRef{maincls.option.chapterprefix}\IndexOption{chapterprefix}%
-\textnote{\DescRef{maincls.option.chapterprefix}} (see \autoref{sec:maincls.structure},
-\DescPageRef{maincls.option.chapterprefix}). If the option is
-\PValue{true} \Macro{chapterlineswithprefixformat} is used, otherwise
-\Macro{chapterlinesformat}.
+\textnote{\DescRef{maincls.option.chapterprefix}} option (see
+\autoref{sec:maincls.structure},
+\DescPageRef{maincls.option.chapterprefix}). If the option is \PValue{true},
+\Macro{chapterlineswithprefixformat} is used. Otherwise
+\Macro{chapterlinesformat} determines the ouput.
-The arguments \PName{number} and \PName{text} are already formatted, i.\,e.,
-they contain font selections. At least the order and layout of both has to be
-done with these commands. If a heading has no number argument \PName{number}
-will be completely empty also without any format or font commands.
+The \PName{number} and \PName{text} arguments are already formatted, including
+the font selections. Ultimately, these commands thus control the arrangement
+of the two parts of the heading. For unnumbered headings, the \PName{number}
+argument is completely empty, so it does not contain any formatting commands.
-The default definitions are very simple:
+The\textnote{default} defaults for these commands are:
\begin{lstcode}
\newcommand{\chapterlinesformat}[3]{%
\@hangfrom{#2}{#3}%
@@ -1230,7 +1301,8 @@ The default definitions are very simple:
\begin{Example}
You want to have chapter headings with yellow background. For the headings
- without prefix line you use the follow definition in the document preamble:
+ without a prefix line, you use the following definition in the document
+ preamble:
\begin{lstcode}
\makeatletter
\renewcommand{\chapterlinesformat}[3]{%
@@ -1242,7 +1314,7 @@ The default definitions are very simple:
}
\makeatother
\end{lstcode}
- For chapter headings without prefix line you use:
+ For chapter headings with prefix line, you use:
\begin{lstcode}
\renewcommand{\chapterlineswithprefixformat}[3]{%
\colorbox{yellow}{%
@@ -1252,9 +1324,9 @@ The default definitions are very simple:
}%
}
\end{lstcode}
- Unfortunately you will find, that these re-definitions result in justified
+ Unfortunately, you discover that these redefinitions result in justified
text for the headings. The reason is the \Macro{parbox} command. To change
- this, you can use \DescRef{maincls.cmd.raggedchapter} (see
+ this, you can use the \DescRef{maincls.cmd.raggedchapter} command (see
\autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.raggedchapter})
inside the argument of \Macro{parbox}. Otherwise \Macro{raggedchapter} would
be used only before \Macro{chapterlineswithprefixformat} and
@@ -1279,32 +1351,32 @@ The default definitions are very simple:
}%
}
\end{lstcode}
- Remember to use \Macro{makeatletter} and \Macro{makeatother} only at the
- document preamble. Do not use it inside your own wrapper-class or
- package. It is only needed because of \Macro{@hangfrom} in the definition of
+ Remember to use \Macro{makeatletter} and \Macro{makeatother} only in the
+ document preamble. Do not use it inside your own wrapper class or package.
+ They are only needed here because of \Macro{@hangfrom} in the definition of
\Macro{chapterlinesformat}.
\end{Example}
-As the example shows, users, who change the definition of one of the commands,
-should take care of several side effects. The alignment of the text is only
-one thing. They also have to prevent page breaks in the headings, e.\,g., if
-they add extra space into the output. The example above does not have page
-break problems. Not only the boxes prevent page breaks. \KOMAScript{} itself
-also changes \Macro{interlinepenalty} as part of \PName{text} to prevent page
-breaks. It also finishes \PName{text} with an internal paragraph break using
-\Macro{@par}.
-
-Command \DescRef{maincls.cmd.raggedchapter} is not part of \PName{text} but
-executed before \Macro{chapterlineswithprefixformat} or
-\Macro{chapterlinesformat}. This makes it much easier to use, e.\,g.,
-\Macro{MakeUppercase} at a re-definition. Please note, typographers use
-individual letter spacing at majuscule text, but \LaTeX{} command
-\Macro{MakeUppercase} does not.
-
-The first argument, \PName{level}, is not used by the default definition and
-also not needed in the example above. It is of interest only, if a user would
-define several commands with \PValue{chapter} style and need to distinguish
-the different levels. The predefined commands \DescRef{maincls.cmd.chapter},
+As the example shows, users who redefine this command must watch out for
+several side effects. In addition to preserving the text alignment, they also
+must prevent page breaks within the headings, for example if they insert extra
+paragraphs or space. The example above does not have this problem. Not only
+does the box prevent a page breaks anyway, but \KOMAScript{} itself also
+changes \Macro{interlinepenalty} as part of \PName{text} so to prevent page
+breaks there. It also finishes \PName{text} with an internal paragraph break
+using \Macro{@@par}.
+
+Incidentally, the \DescRef{maincls.cmd.raggedchapter} command is not part of
+\PName{text}, as otherwise using \Macro{MakeUppercase} inside redefined
+versions of these two commands would be much more difficult. Note, however,
+that typographic rules require individual adjustments of letter spacing in
+capitalised text. However the \LaTeX{} \Macro{MakeUppercase} command does not
+do this.
+
+The default definitions do not use the first argument, \PName{level}, nor is
+it needed in the example above. It is of interest only if you want to define
+several commands with the \PValue{chapter} style and need to distinguish the
+different levels. The predefined commands \DescRef{maincls.cmd.chapter},
\DescRef{maincls.cmd.chapter*}, \DescRef{maincls.cmd.addchap}, and
\DescRef{maincls.cmd.addchap*} all share the same \PName{level}
\PName{chapter}.%
@@ -1318,20 +1390,19 @@ the different levels. The predefined commands \DescRef{maincls.cmd.chapter},
\Parameter{level}\Parameter{indent}\Parameter{number}\Parameter{text}%
\end{Declaration}
These\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} commands are used by headings with style \PValue{section}
-to output the heading number and heading text. If the heading is printed as
-catch phrase at the very beginning of the following paragraph text
-\Macro{sectioncatchphraseformat} is used, otherwise
-\Macro{sectionlinesformat}.
+\Class{scrartcl}} commands are used by headings with the \PValue{section}
+style depending on whether the reading is run-in or on its own line.
+Free-standing headings use \Macro{sectionlinesformat} for their output, while
+run-in headings use \Macro{sectioncatchphraseformat}.
In both cases \PName{indent} is the value of the horizontal indention of the
-heading relative to the text area. If the value is negative the heading should
-even move into the left margin.
+heading relative to the text area. If the value is negative, the heading can
+protrude into the left margin.
-The arguments \PName{number} and \PName{text} are already formatted, i.\,e.,
-they contain font selections. At least the order and layout of both has to be
-done with these commands. If a heading has no number argument \PName{number}
-will be completely empty also without any format or font commands.
+The arguments \PName{number} and \PName{text} are already formatted, including
+the font settings. Ultimately, these commands thus control the arrangement of
+the two parts of the heading. For unnumbered headings, the \PName{number}
+argument is completely empty, so it does not contain any formatting commands.
The default definitions are:
\begin{lstcode}
@@ -1343,14 +1414,14 @@ The default definitions are:
}
\end{lstcode}
-If the user re-defines one of these commands, he has to take care to prevent
-page breaks inside the printing of the heading. \KOMAScript{} itself only
-changes \Macro{interlinepenalty} to impede page breaks.
+If you redefine one of these commands, you are responsible for preventing page
+breaks inside heading. \KOMAScript{} itself only changes
+\Macro{interlinepenalty} to impede page breaks.
\begin{Example}
- Like chapter headings in the previous example, headings of \PName{level}
- \PValue{section} should be printed with a background colour. The lower
- levels should be affected:
+ As in the previous example with chapter headings, the free-standing headings
+ of the \PValue{section} \PName{level} should now be printed with a
+ background colour. Headings of lower levels should not be changed:
\begin{lstcode}
\makeatletter
\renewcommand{\sectionlinesformat}[4]{%
@@ -1369,15 +1440,16 @@ changes \Macro{interlinepenalty} to impede page breaks.
}
\makeatother
\end{lstcode}
- With this code the indention part of indented headings would not be
- coloured, but with negative indention the background of the margin part of
- the headings will also become yellow. You can move the \Macro{hspace*}
- command into the \Macro{colorbox} to change this.
-
- Again remember to use \Macro{makeatletter} and \Macro{makeatother} only at the
- document preamble. Do not use it inside your own wrapper-class or
- package. It is only needed because of \Macro{@hangfrom} in the definition of
- \Macro{sectionlinesformat}.
+ With this code, area of the indention is not coloured if the heading is
+ indented. If, however, the heading is placed in the left margin with
+ negative indention, this area of the margin is also highlighted. You can
+ move the \Macro{hspace*} command into the \Macro{colorbox} to change this
+ behaviour.
+
+ Again, remember to use \Macro{makeatletter} and \Macro{makeatother} only in
+ the document preamble. You should omit them inside your own wrapper class or
+ package. They are only needed because of \Macro{@hangfrom} in the definition
+ of \Macro{sectionlinesformat}.
\end{Example}
The first argument, \PName{level}, is not used by the default definition. The
@@ -1403,52 +1475,56 @@ same style \PValue{section}.%
\Macro{Before@sect}\Parameter{code}
\end{Declaration}
As\ChangedAt[2014/09]{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} already explained in \autoref{sec:maincls.structure} in
-the description of the sectioning commands beginning with
-\DescPageRef{maincls.cmd.chapter}, \KOMAScript{} provides additional
-features for the optional argument of those commands. Therefore, it was
-necessary to replace some \LaTeX{} kernel commands, especially
+\Class{scrartcl}} already explained in \autoref{sec:maincls.structure} in the
+description of the sectioning commands beginning with
+\DescPageRef{maincls.cmd.chapter}, \KOMAScript{} provides additional features
+for the optional argument of those commands. To achieve this, it was necessary
+to replace some \LaTeX{} kernel commands, especially
\Macro{secdef}\IndexCmd{secdef}\important{\Macro{secdef}} and
\Macro{@startsection}\IndexCmd{@startsection}%
\important{\Macro{@startsection}}. The meaning of the parameters of these
commands can be found in the \LaTeX{} kernel manual \cite{latex:source2e}.
-Unfortunately these commands are often redefined by other packages in a way
-that collides with the functionality of \KOMAScript. So \KOMAScript{} not only
-changes the definition of these commands but also defines the additional,
+However, these commands are often completely redefined by other packages in a
+way that clashes with the functionality of \KOMAScript. So \KOMAScript{} not
+only changes the definition of these commands but also defines the additional,
alternative commands \Macro{SecDef} and \Macro{scr@startsection}. Package
-authors are permitted to use these commands like they would use the
-corresponding \LaTeX{} kernel commands and therefore participate in the
-additional features of \KOMAScript. Nevertheless these commands should not be
-redefined, because they could be changed in future and so the redefinition would
-impair \KOMAScript{} again.
-
-\KOMAScript{} internally uses \Macro{SecDef} and \Macro{scr@startsection}
-instead of \Macro{secdef} and \Macro{@startsection}, e.\,g., defining
-section-like commands by \DescRef{\LabelBase.cmd.DeclareSectionCommand}. So
-later redefinition of \Macro{secdef} or \Macro{@startsection} will not
-influence the sectioning commands of \KOMAScript.
-
-As an alternative to the redefinition of such commands, \KOMAScript{} provides
-the execution of additional \PName{code} at several states of the
-\KOMAScript{} replacements. The \PName{code} of each usage of
-\Macro{At@startsection}, \Macro{Before@sect}, or \Macro{Before@ssect} will be
-cumulated independently. Later removing of added \PName{code} is not
-provided.
-
-The \PName{code} of \Macro{At@startsection} is executed immediately after
-the evaluation of \PName{beforeskip} and calculation of the resulting
-\Length{@tempskipa}, before adding the vertical gap itself. So you still may
-change the value of \Length{@tempskipa}.
-
-The \PName{code} of \Macro{Before@sect} and
-\Macro{Before@ssect} is executed just before \Macro{@sect}
-and \Macro{@ssect} inside \Macro{scr@startsection}, respectively. At this state
-the vertical gap of \Length{@tempskipa} has already been added using
-\Macro{addvspace}.
-
-The commands \Macro{At@startsection}, \Macro{Before@sect}, and
-\Macro{Before@ssect} are suggested for package authors.%
+authors can use these commands as they would use the corresponding \LaTeX{}
+kernel commands and therefore gain access to the additional features of
+\KOMAScript. However, these commands should not be redefined, as they may
+changed at any time, and then this redefinition could compromise
+\KOMAScript{}'s functionality.
+
+\KOMAScript{} itself uses \Macro{SecDef} and \Macro{scr@startsection} instead
+of \Macro{secdef} and \Macro{@startsection}, for example to define sectioning
+commands with \DescRef{\LabelBase.cmd.DeclareSectionCommand}. So later
+redefinitions of \Macro{secdef} or \Macro{@startsection} will not influence
+the sectioning commands of \KOMAScript.
+
+As an alternative to redefining such commands, \KOMAScript{} offers the
+possibility to add additional \PName{code} at several points in
+\KOMAScript{}'s own replacements. The \PName{code} of all calls to
+\Macro{At@startsection}\important{\Macro{At@startsection}\\
+ \Macro{Before@sect}\\
+ \Macro{Before@sect}}, \Macro{Before@sect} and \Macro{Before@sect} is
+collected separately for each command. There is no provision for removing
+\PName{code} once it has been inserted.
+
+The \PName{code} of the \Macro{At@startsection}%
+ \important{\Macro{At@startsection}\\
+ \Macro{scr@startsection}} macro is used in the \Macro{scr@startsection}
+command immediately after evaluating \PName{beforeskip} and calculating the
+resulting \Length{@tempskipa} but before adding the vertical skip itself. So
+you can still change the value of \Length{@tempskipa}.
+
+The \PName{code} of \Macro{Before@sect} or \Macro{Before@ssect} is executed
+within \Macro{scr@startsection} just before calling \Macro{@sect} or
+\Macro{@ssect}, respectively. At this point, the vertical skip of
+\Length{@tempskipa} has already been added using \Macro{addvspace}.
+
+These three commands, \Macro{At@startsection}, \Macro{Before@sect}, and
+\Macro{Before@ssect}, are designed as an interface for package authors and
+released for them to use.%
%
\EndIndexGroup
@@ -1459,30 +1535,32 @@ The commands \Macro{At@startsection}, \Macro{Before@sect}, and
\begin{Declaration}
\Macro{appendixmore}
\end{Declaration}%
-There is a peculiarity within the \DescRef{maincls.cmd.appendix} command in
-the {\KOMAScript} classes. If the command \Macro{appendixmore} is defined,
-this command is executed also by the \DescRef{maincls.cmd.appendix}
-command. Internally the {\KOMAScript} classes
+The \KOMAScript{} classes have an unusual feature within the
+\DescRef{maincls.cmd.appendix} command. If the \Macro{appendixmore} command
+is defined, \DescRef{maincls.cmd.appendix} will also execute this
+it. Internally, the \KOMAScript{} classes
\Class{scrbook}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} and
-\Class{scrreprt} take advantage of this behaviour to implement the options
-\DescRef{maincls.option.appendixprefix} (see \autoref{sec:maincls.structure},
-\DescPageRef{maincls.option.appendixprefix}). You\textnote{Attention!} should
-take note of this in case you decide to define or redefine the macro
-\Macro{appendixmore}. In case one of this option has been used, you will
-receive an error message when using
-\verb|\newcommand{\appendixmore}{|\dots\verb|}|. This behaviour is intended to
-prevent you from disabling options without noticing it.
+\Class{scrreprt} take advantage of this behaviour to implement the
+\DescRef{maincls.option.appendixprefix} layout option (see
+\autoref{sec:maincls.structure},
+\DescPageRef{maincls.option.appendixprefix}). You\textnote{Attention!} should
+take note of this in case you decide to define or redefine the
+\Macro{appendixmore} macro. If this option has been used, you will receive an
+error message when using \verb|\newcommand{\appendixmore}{|\dots\verb|}|. This
+behaviour is intended to prevent you from overriding the options without
+realising it.
\begin{Example}
You do not want the chapters in the main part of the classes \Class{scrbook}
- or \Class{scrreprt} to be introduced by a prefix line (see layout options
- \DescRef{maincls.option.chapterprefix} in \autoref{sec:maincls.structure},
- \DescPageRef{maincls.option.chapterprefix}). For consistency you also
- do not want such a line in the appendix either. Instead, you would like to
- see the word ``Chapter'' in the language of your choice written in front of
- the chapter letter and, simultaneously, in the page headings. Instead of
- using layout option \DescRef{maincls.option.appendixprefix}, you would define in the
- document preamble:
+ or \Class{scrreprt} to be introduced by a prefix line (see the
+ \DescRef{maincls.option.chapterprefix} layout option in
+ \autoref{sec:maincls.structure},
+ \DescPageRef{maincls.option.chapterprefix}). For consistency, you also do
+ not want such a line in the appendix either. Instead, you would like to see
+ the word ``Chapter'' in the language of your choice written in front of the
+ chapter letter and, simultaneously, in the page headings. Instead of using
+ the \DescRef{maincls.option.appendixprefix} layout option, you define the
+ following in the document preamble:
%
\begin{lstcode}
\newcommand*{\appendixmore}{%
@@ -1499,8 +1577,8 @@ prevent you from disabling options without noticing it.
This behaviour prevents the definition made above from invisibly changing
the settings intended with the option.
- It is also possible to get a similar behaviour of the appendix for
- the class \Class{scrartcl}. You can write in the preamble of your
+ It is also possible to get a similar behaviour for the appendix of the class
+ \Class{scrartcl}. For example, you can write in the preamble of your
document:
\begin{lstcode}[moretexcs={ifthenelse,equal}]
\newcommand*{\appendixmore}{%
@@ -1510,7 +1588,7 @@ prevent you from disabling options without noticing it.
\appendixname~\thesection\autodot\enskip}}
\end{lstcode}
- Redefined commands are explained in more detail in
+ The redefined commands are explained in more detail in
\autoref{sec:maincls.structure},
\DescPageRef{maincls.cmd.chapterformat} and
\DescPageRef{maincls.cmd.chaptermarkformat}.
@@ -1524,91 +1602,93 @@ prevent you from disabling options without noticing it.
\begin{Declaration}
\Macro{newbibstyle}\OParameter{parent style}\Parameter{name}%^^A
- \Parameter{instructions}%
+ \Parameter{commands}%
\Macro{newblock}%
\Macro{@openbib@code}%
\Macro{bib@beginhook}%
\Macro{bib@endhook}
\end{Declaration}
-The standard classes\textnote{standard classes} already provide command
-\Macro{newblock} for structuring of bibliography entries. The exact purpose of
-this command depends on the class options. Using option
-\Option{openbib}\important{\Option{openbib}} redefine commands
-\Macro{@openbib@code} and \Macro{newblock} at the end of the used standard
-class. These classes execute command \Macro{@openbib@code} at the
-begin\,---\,or more precise: at the specification of the parameters of
-the\,---\,list environment, that will be used for the bibliography. It should
-be assumed, that many packages will execute this command in the same kind, if
-they redefine the bibliography.
-
-The \KOMAScript{} classes do something similar. Nevertheless, they do not
-redefine \Macro{@openbib@code} at the end of the class. Instead of, the
-bibliography style \PValue{openstyle} is defined using
-\Macro{newbibstyle}. The \PName{instructions}, that has been defined as part
-of the implementation, contain the appropriate redefinition of
-\Macro{@openbib@code} and \Macro{newblock}. Now, if this bibliography style
-will be selected using option
+The standard classes\textnote{standard classes} already provide the
+\Macro{newblock} command to structure bibliography entries. The exact purpose
+of this command depends on the class options. Using option
+\Option{openbib}\important{\Option{openbib}} redefines the commands
+\Macro{@openbib@code} and \Macro{newblock} itself at the end of the standard
+class. The standard classes execute the \Macro{@openbib@code} command when
+starting the bibliography list, or more precisely, when defining the
+parameters for the list. You can assume that many packages which redefine the
+bibliography will execute this command.
+
+The \KOMAScript{} classes\textnote{\KOMAScript} do something similar. However,
+they do not redefine \Macro{@openbib@code} at the end of the class. Instead,
+\Macro{newbibstyle} defines the \PValue{openstyle} bibliography style. The
+\PName{commands} given in the implementation contain the appropriate
+redefinition of \Macro{@openbib@code} and \Macro{newblock}. If you select this
+bibliography style using the
\OptionValueRef{maincls}{bibliography}{openstyle}%
\IndexOption{bibliography~=\PValue{openstyle}}%
-\important{\OptionValueRef{maincls}{bibliography}{openstyle}}, then the
-\PName{instructions} will be executed immediately. This will redefine
+\important{\OptionValueRef{maincls}{bibliography}{openstyle}} option, the
+\PName{commands} will be executed immediately. This will redefine
\Macro{@openbib@code} and \Macro{newblock}.
-Beside \Macro{@openbib@code} and \Macro{newblock} also \Macro{bib@beginhook}
-and \Macro{bib@endhook} may be redefined by the \PName{instructions} of the
-style. Command \Macro{bib@beginhook} will be executed immediately after
-heading and preamble of the bibliography, but before the begin of the list
-with the bibliography entries. Command \Macro{bib@endhook} will be executed
-immediately after this list at the end of the bibliography. If
-\DescRef{maincls.cmd.BreakBibliography} (see
+In addition to \Macro{@openbib@code} and \Macro{newblock},
+\Macro{bib@beginhook} and \Macro{bib@endhook} can also be redefined by the
+\PName{commands} of the style. The \Macro{bib@beginhook} command is executed
+immediately after the heading and preamble of the bibliography but before the
+beginning of the list of bibliographic entries. The \Macro{bib@endhook}
+command will be executed immediately after this list, at the end of the
+bibliography. If \DescRef{maincls.cmd.BreakBibliography} (see
\autoref{sec:maincls.bibliography},
-\DescPageRef{maincls.cmd.BreakBibliography}) intercepts the bibliography,
-these commands will also executed at the begin and end of each part of the
-bibliography, this would be immediately before and after
+\DescPageRef{maincls.cmd.BreakBibliography}) is used to interrupt the
+bibliography, these commands will also executed at the beginning and end of
+each part of the bibliography, immediately before and after
\DescRef{maincls.cmd.BreakBibliography}.
-The commands \Macro{newblock}, \Macro{@openbib@code}, \Macro{bib@beginhook},
-and \Macro{bib@endhook} will be reset to an empty definition at the start of
-each new bibliography style. After this the \PName{instructions} of the
-\PName{parent style} of the bibliography style will be executed. After this
-the \PName{instructions} of the bibliography style itself will be
-executed. Because of this these commands has to be defined using
-\Macro{renewcommand}\IndexCmd{renewcommand}\important{\Macro{renewcommand}}
-not \Macro{newcommand} inside of argument \PName{instructions}.
-
-If the user declares additional \PName{instructions} using
-\DescRef{maincls.cmd.AtEndBibliography}%\important[i]{\DescRef{maincls.cmd.AtEndBibliography}\\
-% \DescRef{maincls.cmd.AfterBibliographyPreamble}}% Passt bloeder Weise nicht!
-\IndexCmd{AtEndBibliography} and
-\DescRef{maincls.cmd.AfterBibliographyPreamble}\IndexCmd{AfterBibliographyPreamble}
-to be executed after the preamble or at the end of the bibliography, the
-\PName{instructions} of \DescRef{maincls.cmd.AfterBibliographyPreamble} will
-be executed only once at the begin of the bibliography but after the
-\Macro{bib@beginhook} \PName{instructions}, and the \PName{instructions} of
+The \Macro{newblock}, \Macro{@openbib@code}, \Macro{bib@beginhook}, and
+\Macro{bib@endhook} commands are initially defined to be empty when using a
+new bibliography style. After this, the \PName{commands} of the \PName{parent
+style} that was optionally specified when defining the style will be executed,
+followed by the \PName{commands} for the bibliography style itself. As a
+result, these commands must be defined, if necessary, with
+\Macro{renewcommand}\IndexCmd{renewcommand}\important{\Macro{renewcommand}},
+not \Macro{newcommand}, inside the \PName{instructions} argument.
+
+If you use the
+\DescRef{maincls.cmd.AtEndBibliography}\IndexCmd{AtEndBibliography} and
+\DescRef{maincls.cmd.AfterBibliographyPreamble}%
+\IndexCmd{AfterBibliographyPreamble} commands to declare additional
+\PName{commands} to be executed after the preamble or at the end of the
+bibliography, the \PName{commands} specified with
+\DescRef{maincls.cmd.AfterBibliographyPreamble} will only be executed once, at
+the beginning of the bibliography after the \Macro{bib@beginhook}
+\PName{commands}, and the \PName{commands} of
\DescRef{maincls.cmd.AtEndBibliography} will be executed only once at the end
-of the bibliography but before \Macro{bib@endhook}.
+of the bibliography, before \Macro{bib@endhook}.
-Package\textnote{Example!}
-\Package{multicol}\IndexPackage{multicol}\important{\Package{multicol}} (see
-\cite{package:multicol}) could be used to define a bibliography style for
-printing the bibliography with two columns:
+For\textnote{Example!} example, the
+\Package{multicol}\IndexPackage{multicol}\important{\Package{multicol}}
+package (see \cite{package:multicol}) could be used to define a bibliography
+style for printing the bibliography with two columns:
% Umbruchkorrektur: listings korrigiert
\begin{lstcode}
\newbibstyle{twocolumstyle}{%
\renewcommand*{\bib@beginhook}{\begin{multicols}{2}}%
\renewcommand*{\bib@endhook}{\end{multicols}}}%
\end{lstcode}
-If also an \emph{open}-variation of this style should be defined, one may use
-the provided heredity feature and specify a \PName{parent style}:
+If you also want to define an open variation of this style, you can use
+the possibilities of inheritance here and specify a \PName{parent style}:
% Umbruchkorrektur: listings korrigiert
\begin{lstcode}
\newbibstyle{twocolumopenstyle}[openstyle]{%
\renewcommand*{\bib@beginhook}{\begin{multicols}{2}}%
\renewcommand*{\bib@endhook}{\end{multicols}}}%
\end{lstcode}
-These new defined styles may be selected using option
-\DescRef{maincls.option.bibliography} as usual.%
-%
+You can then select these newly defined styles with the
+\DescRef{maincls.option.bibliography} option as usual.
+
+Like\textnote{Achtung!} \DescRef{maincls.cmd.BreakBibliography}, these
+commands lose all or part of their effect when \Environment{thebibliography}
+is redefined, for example by using
+\Package{biblatex}\IndexPackage{biblatex}\important{\Package{biblatex}}.%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex
index c9c2fb5f163..c362c2d42c4 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrbookreportarticle.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrbookreportarticle.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,88 +46,78 @@
% ============================================================================
\KOMAProvidesFile{scrbookreportarticle.tex}
- [$Date: 2017-05-31 11:06:42 +0200 (Wed, 31 May 2017) $
+ [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
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}
+ Krickette Murabayashi\and Jana Schubert\and Jens H\"uhne\and Karl Hagen}
-% Date of the translated German file: 2017-05-31
+% Date of the translated German file: 2018-02-01
\chapter{The Main Classes: \Class{scrbook}, \Class{scrreprt}, and
- \Class{scrartcl}}
-\labelbase{maincls}
+ \Class{scrartcl}}
+\labelbase{maincls}%
\BeginIndexGroup
\BeginIndex{Class}{scrbook}%
\BeginIndex{Class}{scrreprt}%
\BeginIndex{Class}{scrartcl}%
-%\AddSeeIndex{command}{gen}{\GuidecmdIndexShort}{cmd}% <-- set automatically
-\AddSeeIndex{macro}{gen}{\GuidecmdIndexShort}{cmd}%
\AddSeeIndex{instruction}{gen}{\GuidecmdIndexShort}{cmd}%
-
+\AddSeeIndex{macro}{gen}{\GuidecmdIndexShort}{cmd}%
The main classes of the {\KOMAScript} bundle are designed as counterparts to
the standard {\LaTeX} classes. This means that the {\KOMAScript} bundle
-contains replacements for the three standard classes:
+contains replacements for the three standard classes,
\Class{book}\IndexClass{book}, \Class{report}\IndexClass{report}, and
\Class{article}\IndexClass{article}. There is also a replacement for the
-standard class \Class{letter}\IndexClass{letter}. The document class for
-letters is described in a separate chapter, because it is fundamentally
+standard \Class{letter}\IndexClass{letter} class. The document class for
+letters is described in a separate chapter because it is fundamentally
different from the three main classes (see \autoref{cha:scrlttr2}).
-\iffalse% Umbruchkorrekturtext
- The names of the {\KOMAScript} classes are composed of the prefix
- ``\texttt{scr}'' and the abbreviated name of the corresponding standard
- class. In order to restrict the length of the names to eight letters, the
- vowels, starting with the last one, are left off as necessary. The
- \autoref{tab:\LabelBase.overview} shows an overview of the correspondence
- between the standard classes and the {\KOMAScript} classes.
-\fi
-
The simplest way to use a {\KOMAScript} class instead of a standard one is to
-substitute the class name in the \verb|\documentclass| command according to
-\autoref{tab:\LabelBase.overview}. For example, you may replace
-\Macro{documentclass}\PParameter{book} by
-\Macro{documentclass}\PParameter{scrbook}. Normally, the document should be
-processed without errors by {\LaTeX}, just like before the substitution. The
-look, however, should be different. Additionally, the {\KOMAScript} classes
-provide new possibilities and options that are described in the following
-sections.
+substitute the class name in the \verb|\documentclass| command in accordance
+with \autoref{tab:\LabelBase.overview}. For example, you can replace
+\Macro{documentclass}\PParameter{book} with
+\Macro{documentclass}\PParameter{scrbook}. Normally, {\LaTeX} should process
+the document without errors, just as before the substitution. The layout,
+however, should be different. Additionally, the {\KOMAScript} classes provide
+new possibilities and options that are described in the following sections.
\begin{table}
% \centering
- \KOMAoptions{captions=topbeside}
- \setcapindent{0pt}
+ \KOMAoptions{captions=topbeside}%
+ \setcapindent{0pt}%
% \caption
\begin{captionbeside}
- [Class correspondence]{\label{tab:\LabelBase.overview}Correspondence between
- standard classes and {\KOMAScript} classes}% and \Script{} styles.}
- [l]
- \begin{tabular}[t]{ll}
- \toprule
- standard class & {\KOMAScript} class \\%& \Script-Stil (\LaTeX2.09)\\
- \midrule
- \Class{article} & \Class{scrartcl} \\%& \File{script\textunderscore s} \\
- \Class{report} & \Class{scrreprt} \\%& \File{script} \\
- \Class{book} & \Class{scrbook} \\%& \File{script} \\
- \Class{letter} & \Class{scrlttr2} \\%& \File{script\textunderscore l} \\
- \bottomrule
- \end{tabular}
+ [Class correspondence]{\label{tab:\LabelBase.overview}Correspondence between
+ standard classes and {\KOMAScript} classes}
+ [l]
+ \begin{tabular}[t]{ll}
+ \toprule
+ standard class & \KOMAScript{} class \\%& \Script-Stil (\LaTeX2.09)\\
+ \midrule
+ \Class{article} & \Class{scrartcl} \\%& \File{script\textunderscore s} \\
+ \Class{report} & \Class{scrreprt} \\%& \File{script} \\
+ \Class{book} & \Class{scrbook} \\%& \File{script} \\
+ \Class{letter} & \Class{scrlttr2} \\%& \File{script\textunderscore l} \\
+ \bottomrule
+ \end{tabular}
\end{captionbeside}
\end{table}
-Allow me an observation before proceeding with the descriptions of the
-options. It is often the case that at the beginning of a document one is often
-unsure which options to choose for that specific document. Some options, for
-instance the choice of paper size, may be fixed from the beginning. But
-already the question of the size of the text area and the margins could be
-difficult to answer initially. On the other hand, the main business of an
-author\,---\,planning the document structure, writing the text, preparing
-figures, tables, lists, index, and other data\,---\,should be almost
-independent of those settings. As an author you should concentrate initially
-on this work. When that is done, you can concentrate on the fine points of
-presentation. Besides the choice of options, this means correcting
-hyphenation, optimizing page breaks, and the placement of tables and figures.
+Let me say something before describing the classes. When beginning to write a
+document, you are often unsure which specific options to choose. Some
+settings, for instance the choice of paper size, may be fixed in advance. But
+even the question of the appropriate page layout could be difficult to answer
+initially. On the other hand, these settings should be nearly irrelevant, in
+the beginning, to the main business of an author: planning the document
+structure, writing the text, preparing figures, tables, lists, index, and
+other data. As an author, you should concentrate initially on the content.
+When that is done, you can take on the fine points of presentation. In
+addition to the choice of options, this includes correcting hyphenation,
+optimizing page breaks, and placing tables and figures.
+
+
+% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\LoadCommonFile{options}% \section{Early or Late Selection of Options}
@@ -138,46 +128,49 @@ hyphenation, optimizing page breaks, and the placement of tables and figures.
\LoadCommonFile{typearea}% \section{Page Layout}
\begin{Declaration}
- \Macro{flushbottom}%
+ \Macro{flushbottom}
\Macro{raggedbottom}
\end{Declaration}
\begin{Explain}
- In double-sided documents, it's preferred to have the same visual baseline
- in not only the first lines of the text areas in a double-side spread, but
- also in the last lines. If pages consist of text without paragraphs or
- headlines only, this is the result in general. But a paragraph distance of
- half of a line would be enough to prevent achieving this, if the difference
- in the number of paragraphs on each page of the double-page spread is
- odd-numbered. In this case at least some of the paragraph distances need to
- be shrunk or stretched to fit the rule again. \TeX{} knows shrinkable and
- stretchable distances for this purpose. \LaTeX{} provides an automatism for
- this kind of vertical adjustment\Index{adjustment>vertical}.
+ In two-sided documents especially, it is preferable to have the same visual
+ baseline not only for the first lines of each text area in a two-page spread
+ but also for the last lines. If a page consists only of text without
+ paragraphs or headings, this is generally the result. But a paragraph
+ spacing of half a line would be enough to prevent you from achieving this
+ goal if the number of paragraphs on each page of the two-page spread differs
+ by an odd number. In this case, at least some of the paragraph distances
+ need to be stretched or shrunk to reach the target again. \TeX{} defines
+ stretchable and shrinkable distances for this purpose, and \LaTeX{} lets you
+ perform this kind of \emph{vertical adjustment}\Index{adjustment}
+ automatically.
\end{Explain}
-Using double-sided typesetting with option
-\Option{twoside}\IndexOption{twoside}\important{\Option{twoside}} (see
+Using two-sided printing with the
+\Option{twoside}\IndexOption{twoside}\important{\Option{twoside}} option (see
\autoref{sec:typearea.options}, \DescPageRef{typearea.option.twoside}) or
-two-column typesetting with option
-\Option{twocolumn}\IndexOption{twocolumn}\important{\Option{twocolumn}} (see
-\DescPageRef{typearea.option.twocolumn}) switches on vertical adjustment
-also. But\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} with compatibility selection to a \KOMAScript{} version
-prior to 3.17 (see \autoref{sec:\LabelBase.compatibilityOptions},
+two-column formatting with the
+\Option{twocolumn}\IndexOption{twocolumn}\important{\Option{twocolumn}} option
+(see \DescPageRef{typearea.option.twocolumn}) also activates this vertical
+adjustment. But\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} this does not apply with a compatibility setting for a
+\KOMAScript{} version prior to 3.17 (see
+\autoref{sec:\LabelBase.compatibilityOptions},
\DescPageRef{\LabelBase.option.version}, option
-\DescRef{\LabelBase.option.version}\IndexOption{version}\important{\OptionValueRef{\LabelBase}{version}{3.17}})
-this is not the case, if you use \DescRef{\LabelBase.cmd.KOMAoption} or \DescRef{\LabelBase.cmd.KOMAoptions} to
+\DescRef{\LabelBase.option.version}\IndexOption{version}%
+\important{\OptionValueRef{\LabelBase}{version}{3.17}}) if you use
+\DescRef{\LabelBase.cmd.KOMAoption} or \DescRef{\LabelBase.cmd.KOMAoptions} to
change the setting of these options.
-Alternatively, vertical adjustment may be switched on
-at any time valid from the current page using
-\Macro{flushbottom}. \Macro{raggedbottom} would have the opposite
-effect, switching off vertical adjustment from the current page
-on. This is also the default at one-sided typesetting.
+You can also explicitly request vertical adjustment at any time starting with
+the current page by using \Macro{flushbottom}. \Macro{raggedbottom} has the
+opposite effect, switching off vertical adjustment starting with the current
+page. This corresponds to the default for one-sided printing.
-By the way, \KOMAScript{} uses a slightly modified kind of abdication of
-vertical adjustment. This has been done to move footnotes to the bottom of the
-text area instead of having them close to the last used text line.\iffree{}{
- More information about this may be found at
+By the way, \KOMAScript{} uses a slightly modified method for adjusting the
+vertical skip. This has been done to move footnotes to the bottom of the
+text area instead of having them close to the last text line used.
+\iffree{}{
+ You can find more information about this at
\autoref{sec:maincls-experts.addInfos},
\DescPageRef{maincls-experts.cmd.footnoterule}.}%
%
@@ -186,8 +179,7 @@ text area instead of having them close to the last used text line.\iffree{}{
\EndIndexGroup
-\LoadCommonFile{fontsize}
-
+\LoadCommonFile{fontsize}% \section{Choosing the Document Font Size}
\LoadCommonFile{textmarkup}% \section{Text Markup}
@@ -196,38 +188,42 @@ text area instead of having them close to the last used text line.\iffree{}{
\section{Abstract}
\seclabel{abstract}
\BeginIndexGroup
-\BeginIndex{}{summary}%
\BeginIndex{}{abstract}%
-Particularly\OnlyAt{\Class{scrartcl}\and\Class{scrreprt}} with
-articles, more rarely with reports, there is a summary\Index{summary}
-directly under the title and before the table of contents. When using an in-page
-title, this summary is normally a kind of left- and right-indented block. In
-contrast to this, a kind of chapter or section is printed using title pages.
+Particularly with articles, more rarely with reports, there is an abstract, or
+summary, directly beneath the title and before the table of contents. When
+using an in-page title, this abstract is normally a kind of left- and
+right-indented block. In comparison, the abstract appears as a chapter or
+section when using title pages.
\begin{Declaration}
\OptionVName{abstract}{simple switch}
\end{Declaration}%
-In\ChangedAt{v3.00}{\Class{scrreprt}\and \Class{scrartcl}}%
-\OnlyAt{\Class{scrreprt}\and\Class{scrartcl}} the standard classes the
-\DescRef{\LabelBase.env.abstract} environment sets the text ``\abstractname'' centered
-before the summary text\Index[indexmain]{summary}. This was normal practice in
-the past. In the meantime, newspaper reading has trained readers to recognize
-a displayed text at the beginning of an article or report as the
-abstract. This is even more true when the text comes before the table of
-contents. It is also surprising when precisely this title appears small and
-centered. {\KOMAScript} provides the possibility of including or excluding the
-abstract's title with the options \Option{abstract}. For \PName{simple
- switch}, any value from
-\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} may be used.
-
-Books typically use another type of summary. In that case there is usually a
-dedicated summary chapter at the beginning or end of the book. This chapter is
-often combined with the introduction or a description of wider
-prospects. Therefore, the class \Class{scrbook} has no \DescRef{\LabelBase.env.abstract}
-environment. A\textnote{Hint!} summary chapter is also recommended for reports in a wider
-sense, like a Master's or Ph.D. thesis.%
-%
+In\OnlyAt{\Class{scrreprt}\and\Class{scrartcl}} the standard
+classes\textnote{\KOMAScript{} vs. standard classes}, the
+\DescRef{\LabelBase.env.abstract} environment sets the text ``\abstractname''
+centred before the abstract text. This used to be the normal practice. Since
+then, reading newspapers has trained us to recognize a suitably highlighted
+text at the beginning of an article or report as the abstract. This is even
+more true when the text comes before the table of contents. It is also
+confusing if, of all things, this title appears small and centred.
+{\KOMAScript}\ChangedAt{v3.00}{\Class{scrreprt}\and \Class{scrartcl}} offers
+the option to include or exclude the abstract's title with the
+\Option{abstract} option. For \PName{simple switch}, you can use any value
+from \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. The
+default for \KOMAScript{} is \PValue{false}.
+
+Books typically use a different kind of summary. There, you usually place an
+appropriate chapter at the beginning or the end of the work. This chapter is
+often combined with either the introduction or a description of a larger
+prospectus. Therefore, the \Class{scrbook} class has no
+\DescRef{\LabelBase.env.abstract} environment. A\textnote{Hint!} summary
+chapter is also recommended for reports in a wider sense, such as a Master's
+thesis or Ph.D. dissertation. See the commands
+\DescRef{\LabelBase.cmd.chapter*}\IndexCmd{chapter*},
+\DescRef{\LabelBase.cmd.addchap}\IndexCmd{addchap}, and
+\DescRef{\LabelBase.cmd.addchap*}\IndexCmd{addchap*} documented in
+\autoref{sec:maincls.structure}, from \DescPageRef{\LabelBase.cmd.chapter*}.%
\EndIndexGroup
@@ -235,32 +231,32 @@ sense, like a Master's or Ph.D. thesis.%
\begin{Environment}{abstract}\end{Environment}
\end{Declaration}%
\OnlyAt{\Class{scrartcl}\and \Class{scrreprt}}%
-Some {\LaTeX} classes offer a special environment for this summary, the
-\Environment{abstract} environment. This is output directly, as it is not a
-component of the titles set by \DescRef{\LabelBase.cmd.maketitle}.
-Please\textnote{Attention!} note that \Environment{abstract} is an
-environment, not a command. Whether the summary has a heading or not is
-determined by the option \DescRef{\LabelBase.option.abstract} (see above).
-
-With books (\Class{scrbook}) the summary is frequently a component of the
-introduction or a separate chapter at the end of the document. Therefore no
-\Environment{abstract} environment is provided. When using the class
-\Class{scrreprt} it is surely worth considering whether one should not proceed
-likewise. See commands \DescRef{\LabelBase.cmd.chapter*}\IndexCmd{chapter*} and
-\DescRef{\LabelBase.cmd.addchap}\IndexCmd{addchap} or \DescRef{\LabelBase.cmd.addchap*} at
-\autoref{sec:\LabelBase.structure} from \DescPageRef{\LabelBase.cmd.chapter*}
-onwards.
+Some {\LaTeX} classes provide a special environment for this summary: the
+\Environment{abstract} environment. This is output directly, so it is not part
+of the title created with \DescRef{\LabelBase.cmd.maketitle}.
+Please\textnote{Attention!} note that \Environment{abstract} is an
+environment, not a command. Whether the abstract has a heading or not is
+determined by the \DescRef{\LabelBase.option.abstract} option (see above).
+
+For books, the abstract is usually part of the introduction or a separate
+chapter at the end of the document. Therefore \Class{scrbook} does not provide
+an \Environment{abstract} environment. When using the \Class{scrreprt} class,
+it is definitely worth considering whether to proceed in the same way. See the
+commands \DescRef{\LabelBase.cmd.chapter*}\IndexCmd{chapter*} and
+\DescRef{\LabelBase.cmd.addchap}\IndexCmd{addchap}, or
+\DescRef{\LabelBase.cmd.addchap*} in \autoref{sec:\LabelBase.structure}
+from \DescPageRef{\LabelBase.cmd.chapter*} for more on this.
When using an in-page title\Index{title>in-page} (see option
\DescRef{\LabelBase.option.titlepage}, \autoref{sec:\LabelBase.titlepage},
-\DescPageRef{\LabelBase.option.titlepage}), the abstract is set using the
-environment \Environment{quotation}\IndexEnv{quotation} (see
-\autoref{sec:\LabelBase.lists}, \DescPageRef{\LabelBase.env.quotation})
-internally. Thereby paragraphs will be set with indentation of the first
-line. If that first paragraph of the abstract should not be indented, this
-indent may be disabled using
-\Macro{noindent}\IndexCmd{noindent}\important{\Macro{noindent}} \iffree{just
- after \Macro{begin}\PParameter{abstract}}{at the begin of the environment}.%
+\DescPageRef{\LabelBase.option.titlepage}), the abstract is set internally
+using the \DescRef{\LabelBase.env.quotation}\IndexEnv{quotation} environment
+(see \autoref{sec:\LabelBase.lists}, \DescPageRef{\LabelBase.env.quotation}).
+This way paragraphs will be set with the first line indented. If the first
+paragraph of the abstract should not be indented, you can suppress this indent
+by using \Macro{noindent}\IndexCmd{noindent}%
+\important{\Macro{noindent}} \iffree{just after
+ \Macro{begin}\PParameter{abstract}}{at the beginning of the environment}.%
%
\EndIndexGroup
%
@@ -272,289 +268,339 @@ indent may be disabled using
\BeginIndexGroup
\BeginIndex{}{table of contents}
-The table of contents is normally set after the document title and an
-optional existing abstract. Often one may find additional lists of
-floating environments, e.\,g., the list of tables and the list of
-figures, after the table of contents (see
+The title and optional abstract are normally followed by a table of contents.
+Often you also find additional lists of the floating environments, such as
+tables and figures, after the table of contents (see
\autoref{sec:\LabelBase.floats}).
+\iffalse%
+ Note that in addition to the options documented in this section, the
+ commands \DescRef{maincls-experts.cmd.DeclareSectionCommand},
+ \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},
+ \DescPageRef{maincls-experts.cmd.DeclareSectionCommand}.%
+\else%
+ In addition to the options documented in this section, the
+ \hyperref[cha:tocbasic]{\Package{tocbasic}}%
+ \important{\hyperref[cha:tocbasic]{\Package{tocbasic}}}%
+ \IndexPackage{tocbasic} package style selected and configured with
+ \DescRef{tocbasic.cmd.DeclareTOCStyleEntry}\IndexCmd{DeclareTOCStyleEntry}%
+ \important[O]{\DescRef{tocbasic.cmd.DeclareTOCStyleEntry}} (see
+ \DescPageRef{tocbasic.cmd.DeclareTOCStyleEntry}) also has a significant
+ impact on the appearance of the table of contents. Similarly, the commands
+ \DescRef{maincls-experts.cmd.DeclareSectionCommand}%
+ \important[O]{\DescRef{maincls-experts.cmd.DeclareSectionCommand}}%
+ \IndexCmd{DeclareSectionCommand},
+ \DescRef{maincls-experts.cmd.ProvideSectionCommand}%
+ \IndexCmd{ProvideSectionCommand},
+ \DescRef{maincls-experts.cmd.DeclareNewSectionCommand}%
+ \IndexCmd{DeclareNewSectionCommand} and
+ \DescRef{maincls-experts.cmd.RedeclareSectionCommand}%
+ \IndexCmd{RedeclareSectionCommand} documented in
+ \autoref{sec:maincls-experts.experts},
+ \DescPageRef{maincls-experts.cmd.DeclareSectionCommand} can also affect the
+ table of contents.%
+\fi
+
+
\begin{Declaration}
- \OptionVName{toc}{selection}
+ \OptionVName{toc}{setting}
\end{Declaration}
-\label{desc:\LabelBase.option.toc.listof}%
-\label{desc:\LabelBase.option.toc.nolistof}%
-\label{desc:\LabelBase.option.toc.listofnumbered}\nobreak
-It is becoming increasingly common to find entries in the table of contents
-for the lists of tables and figures, for the bibliography, and, sometimes,
-even for the index. This is surely also related to the recent trend of putting
-lists of figures and tables at the end of the document. Both lists are
-similiar to the table of contents in structure and intention. I'm therefore
-sceptical of this evolution. Since\important{\OptionValue{toc}{listof}} it
-makes no sense to include only one of the lists of tables and figures in the
-table of contents, there exists only one
-\PName{selection}\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} \PValue{listof}\IndexOption{toc~=\PValue{listof}} that
-causes entries for both types of lists to be included. This also includes any
-lists produced with version~1.2e or later of the
-\Package{float}\IndexPackage{float} package (see \cite{package:float}) or the
-\Package{floatrow} (see \cite{package:floatrow}).
-All\important{\OptionValue{toc}{listofnumbered}} these lists are unnumbered,
-since they contain entries that reference other sections of the document. If
-one wants to ignore this general agreement, one may use \PName{selection}
-\PValue{listofnumbered}%
-\IndexOption{toc~=\PValue{listofnumbered}}.
-
-\leavevmode\phantomsection\nobreak
-\label{desc:\LabelBase.option.toc.index}\nobreak
-The\important{\OptionValue{toc}{index}} option \OptionValue{index}{totoc}
-causes an entry for the index to be included in the table of contents. The
-index is unnumbered since it too only includes references to the contents of
-the other sectional units. Despite\ChangedAt{v3.18}{\Class{scrbook}\and
+It is becoming increasingly common to to include lists of tables and figures,
+the bibliography, and sometimes even the index in the table of contents. This
+is surely related to the recent trend of putting lists of figures and tables
+at the end of the document. Both lists are similar to the table of contents in
+structure and intention. I'm therefore sceptical of this evolution.
+Since\important{\OptionValue{toc}{listof}} it makes no sense to include only
+the list of tables or that of figures in the table of contents without the
+other, there is only one \PName{setting}\ChangedAt{v3.00}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}}
+\PValue{listof}\IndexOption{toc~=\textKValue{listof}}, which causes entries
+for both types of lists to be included. This also includes any lists produced
+with version~1.2e or later of the \Package{float} package\IndexPackage{float}
+from Version~1.2e (see \cite{package:float}) or \Package{floatrow} (see
+\cite{package:floatrow}). None\important{\OptionValue{toc}{listofnumbered}}
+of these lists are generally given a chapter number. If you want to ignore
+this principle, use the \PName{setting}
+\PValue{listofnumbered}\IndexOption{toc~=\textKValue{listofnumbered}}.
+
+\leavevmode\LabelOptionValue{toc}{index}\nobreak
+The\important{\OptionValue{toc}{index}}
+\OptionValue{toc}{index}\IndexOption{toc~=\textKValue{index}} option causes an
+entry for the index to be included in the table of contents. The index is
+unnumbered since it too only includes references to the contents of the other
+sectioning levels. Despite\ChangedAt{v3.18}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}}
-\important{\OptionValue{toc}{indexnumbered}}objection of the author,
-\KOMAScript{} does also support to ignore this general agreement using
-\OptionValue{toc}{indexnumbered}\IndexOption{toc~=\PValue{indexnumbered}}.
-
-\leavevmode\phantomsection\nobreak
-\label{desc:\LabelBase.option.toc.bibliography}\nobreak
-The bibliography is a different kind of listing. It does not list the contents
-of the present document but refers instead to external
-documents. For\important{\begin{tabular}{@{}r@{}}
- \multicolumn{1}{@{}l@{}}{\Option{toc=}}\\
- ~\PValue{bibliographynumbered}\\
- \end{tabular}} that
-reason, it could be argued that it qualifies as a chapter (or section) and, as
-such, should be numbered. The option \OptionValue{toc}{bibliographynumbered}%
-\IndexOption{toc~=\PValue{bibliographynumbered}}
-has this effect, including the generation of the corresponding entry in the
-table of contents. I personally think that this reasoning would lead us to
-consider a classical list of sources also to be a separate chapter. On the
-other hand, the bibliography is finally not something that was written by the
-document's author. In\important{\OptionValue{toc}{bibliography}} view of this, the bibliography merits nothing more than
-an unnumbered entry in the table of contents, and that can be achieved with
-\OptionValue{toc}{bibliography}\IndexOption{toc~=\PValue{bibliography}}.
-
-\leavevmode\phantomsection\nobreak
-\label{desc:\LabelBase.option.toc.graduated}\nobreak
+\important{\OptionValue{toc}{indexnumbered}} the author's concerns,
+\KOMAScript{} does support deviating from this principle with
+\OptionValue{toc}{indexnumbered}\IndexOption{toc~=\textKValue{indexnumbered}}.
+
+\leavevmode\LabelOptionValue{toc}{bibliography}\nobreak The bibliography is a
+slightly different kind of listing. It does not list the contents of the
+present document but refers instead to external sources.
+For\important{\OptionValue{toc}{bibliographynumbered}} that reason, it could
+be argued that it qualifies as a chapter (or section) and, as such, should be
+numbered. The \OptionValue{toc}{bibliographynumbered}%
+\IndexOption{toc~=\textKValue{bibliographynumbered}} option has this effect,
+and puts the appropriate entry in the table of contents. However, I think that
+this reasoning would lead us to consider even a classic, annotated source list
+to be a separate chapter. Moreover, the bibliography is ultimately not
+something that you wrote yourself.
+Therefore\important{\OptionValue{toc}{bibliography}} the bibliography merits,
+at best, an unnumbered entry in the table of contents, and you can achieve
+this achieved with
+\OptionValue{toc}{bibliography}\IndexOption{toc~=\textKValue{bibliography}}.
+
+\leavevmode\LabelOptionValue{toc}{graduated}\nobreak
The table of contents is normally\ChangedAt{v2.8q}{%
\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
-\important{\OptionValue{toc}{graduated}} set up so that different sectional
-units have different indentations. The section number is set left-justified in
-a fixed-width field. This default setup is selected with the option
-\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}
-\OptionValue{toc}{graduated}\IndexOption{toc~=\PValue{graduated}}.
-
-\leavevmode\phantomsection\nobreak
-\label{desc:\LabelBase.option.toc.flat}\nobreak
-When there are many sections, the corresponding numbering tends to become very
-wide, so that the reserved field overflows. The German FAQ \cite{DANTE:FAQ}
-suggests that the table of contents should be redefined in such a
-case. {\KOMAScript}\important{\OptionValue{toc}{flat}} offers an alternative
-format that avoids the problem completely. If the option
-\OptionValue{toc}{flat}\IndexOption{toc~=\PValue{flat}} is selected, then no variable indentation is applied
-to the titles of the sectional units. Instead, a table-like organisation is
-used, where all unit numbers and titles, respectively, are set in a
-left-justified column. The space necessary for the unit numbers is thus
-determined automatically.%
-
-The \autoref{tab:\LabelBase.toc} shows an overview of possible values for
-\PName{selection} of \Option{toc}.
+\important{\OptionValue{toc}{graduated}} formatted so that different levels of
+sectioning commands have different indentations. The number for each level is
+set left-justified in a fixed-width field. This default set-up is selected
+with the\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}
+\OptionValue{toc}{graduated}\IndexOption{toc~=\textKValue{graduated}} option.
+
+\leavevmode\LabelOptionValue{toc}{flat}\nobreak
+If the sectioning level which appears in the table of contents is too deep, the
+number for that level can be so wide that the space reserved for the number is
+insufficient. The German FAQ \cite{DANTE:FAQ} suggests redefining the table of
+contents in such a case. \KOMAScript{}\important{\OptionValue{toc}{flat}}
+offers an alternative format that avoids the problem completely. If you use
+the \OptionValue{toc}{flat}\IndexOption{toc~=\textKValue{flat}} option, no
+graduated indentation is applied to the headings of the sectioning levels.
+Instead, a table-like organisation is used, where all sectioning numbers and
+headings are set in a left-justified column. The space necessary for the
+section numbers is thus determined automatically.
+
+You can find an overview of all available values for the \PName{setting} of
+\Option{toc}. in \autoref{tab:\LabelBase.toc}.
\begin{desclist}
- \desccaption[{Possible values of option \Option{toc}}]{%
- Possible values of option \Option{toc} to set form and contents of the
- table of contents\label{tab:\LabelBase.toc}%
+ \desccaption[{Available values of the \Option{toc} option}]{%
+ Available values of the \Option{toc} option to set the format and contents
+ of the table of contents\label{tab:\LabelBase.toc}%
}{%
- Possible values of option \Option{toc} (\emph{continuation})%
+ Available values of the \Option{toc} option (\emph{continued})%
}%
\entry{\PValue{bibliography}, \PValue{bib}}{%
- The bibliography will be represented by an entry at the table of contents,
- but will not be numbered.%
- \IndexOption{toc~=\PValue{bibliography}}}%
+ The bibliography has an unnumbered entry in the table of contents.%
+ \IndexOption{toc~=\textKValue{bibliography}}}%
\entry{\PValue{bibliographynumbered}, \PValue{bibnumbered},
\PValue{numberedbibliography}, \PValue{numberedbib}}{%
- The bibliography will be represented by an entry at the table of contents
- and will be numbered.%
- \IndexOption{toc~=\PValue{bibliographynumbered}}}%
+ The bibliography has a numbered entry in the table of contents.%
+ \IndexOption{toc~=\textKValue{bibliographynumbered}}}%
\entry{\PValue{chapterentrywithdots}, \PValue{chapterentrydotfill}}{%
\ChangedAt[2014/12]{v3.15}{\Class{scrbook}\and \Class{scrreprt}}%
- The chapter entries of classes \Class{scrbook} and \Class{scrreprt} also
- use dots to separate the headings text from the page number.%
- \IndexOption{toc~=\PValue{chapterentrywithdots}}}%
+ The chapter entries for the \Class{scrbook} and \Class{scrreprt} classes
+ also use dots to separate the heading text from the page numbers.%
+ \IndexOption{toc~=\textKValue{chapterentrywithdots}}}%
\entry{\PValue{chapterentrywithoutdots}, \PValue{chapterentryfill}}{%
\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}}%
- The chapter entries of classes \Class{scrbook} and \Class{scrreprt}
- use white space to separate the headings text from the page number.%
- \IndexOption{toc~=\PValue{chapterentrywithoutdots}}}%
+ The chapter entries of the \Class{scrbook} and \Class{scrreprt} classes
+ use white space to separate the heading text from the page numbers. This
+ corresponds to the default setting.%
+ \IndexOption{toc~=\textKValue{chapterentrywithoutdots}}}%
\entry{\PValue{flat}, \PValue{left}}{%
- The table of contents will be set in table form. The numbers of the
- headings will be at the first column, the heading text at the second
- column, and the page number at the third column. The amount of space
- needed for the numbers of the headings will be determined by the detected
- needed amount of space at the previous \LaTeX{} run.%
- \IndexOption{toc~=\PValue{flat}}}%
+ The table of contents is set in table form. The numbers of the headings
+ are in the first column, the heading text in the second column, and the
+ page number in the third column. The amount of space needed for the
+ numbers of the headings is determined by the required amount of space
+ detected during the previous \LaTeX{} run.%
+ \IndexOption{toc~=\textKValue{flat}}}%
\entry{\PValue{graduated}, \PValue{indent}, \PValue{indented}}{%
- The table of contents will be set in hierarchical form. The amount of
- space for the heading numbers is limited.%
- \IndexOption{toc~=\PValue{graduated}}}%
+ The table of contents is set in hierarchical form. The amount of space for
+ the heading numbers is limited. This corresponds to the default setting.%
+ \IndexOption{toc~=\textKValue{graduated}}}%
+ \entry{\PValue{indenttextentries}, \PValue{indentunnumbered},
+ \PValue{numberline}}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ The \PValue{numberline} property (see \autoref{sec:tocbasic.toc},
+ \DescPageRef{tocbasic.cmd.setuptoc}) is set for the table of contents. As
+ a result, unnumbered entries are left aligned with the text of numbered
+ entries of the same level.%
+ \IndexOption{toc~=\textKValue{numberline}}}%
\entry{\PValue{index}, \PValue{idx}}{%
- The index will be represented by an entry at the table of contents, but
- will not be numbered.%
- \IndexOption{toc~=\PValue{index}}}%
+ The index has an unnumbered entry in the table of contents.%
+ \IndexOption{toc~=\textKValue{index}}}%
\entry{\PValue{indexnumbered}}{%
\ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
- The index will be represented by an entry at the table of contents and
- will be numbered.%
- \IndexOption{toc~=\PValue{index}}}%
+ The index has a numbered entry in the table of contents.%
+ \IndexOption{toc~=\textKValue{index}}}%
+ \entry{\PValue{leftaligntextentries}, \PValue{leftalignunnumbered},
+ \PValue{nonumberline}}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ The \PValue{numberline} property (see \autoref{sec:tocbasic.toc},
+ \DescPageRef{tocbasic.cmd.setuptoc}) is deleted for the table of contents.
+ This places unnumbered entries left-aligned with the number of
+ numbered entries of the same level. This corresponds to the default
+ setting.%
+ \IndexOption{toc~=\textKValue{numberline}}}%
\pventry{listof}{%
- The lists of floating environments, e.\,g., the list of figures and the
- list of tables, will be represented by entries at the table of contents,
- but will not be numbered.%
- \IndexOption{toc~=\PValue{listof}}}%
+ The lists of floating environments, e.\,g. figures and tables, have
+ unnumbered entries in the table of contents.%
+ \IndexOption{toc~=\textKValue{listof}}}%
\entry{\PValue{listofnumbered}, \PValue{numberedlistof}}{%
- The lists of floating environments, e.\,g., the list of figures and the
- list of tables, will be represented by entries at the table of contents
- and will be numbered.%
- \IndexOption{toc~=\PValue{listofnumbered}}}%
+ The lists of floating environments, e.\,g. figures and tables, have
+ numbered entries in the table of contents.%
+ \IndexOption{toc~=\textKValue{listofnumbered}}}%
\entry{\PValue{nobibliography}, \PValue{nobib}}{%
- The bibliography will not be represented by an entry at the table of
- contents.%
- \IndexOption{toc~=\PValue{nobibliography}}}%
+ The bibliography does not have an entry in the table of contents. This
+ corresponds to the default setting.%
+ \IndexOption{toc~=\textKValue{nobibliography}}}%
\entry{\PValue{noindex}, \PValue{noidx}}{%
- The index will not be represented by an entry at the table of
- contents.%
- \IndexOption{toc~=\PValue{noindex}}}%
+ The index does not have an entry in the table of contents. This
+ corresponds to the default setting.%
+ \IndexOption{toc~=\textKValue{noindex}}}%
\pventry{nolistof}{%
- The lists of floating environments, e.\,g., the list of figures and the
- list of tables, will not be represented by entries at the table of
- contents.%
- \IndexOption{toc~=\PValue{nolistof}}}%
+ The lists of floating environments, e.\,g. figures and tables, do not
+ have entries in the table of contents. This corresponds to the default
+ setting.%
+ \IndexOption{toc~=\textKValue{nolistof}}}%
\entry{\PValue{sectionentrywithdots}, \PValue{sectionentrydotfill}}{%
\ChangedAt[2014/12]{v3.15}{\Class{scrartcl}}%
- The section entries of class \Class{scrartcl} also
- use dots to separate the headings text from the page number.%
- \IndexOption{toc~=\PValue{sectionentrywithdots}}}%
+ The section entries of the \Class{scrartcl} class also use dots to
+ separate the heading text from the page numbers.%
+ \IndexOption{toc~=\textKValue{sectionentrywithdots}}}%
\entry{\PValue{sectionentrywithoutdots}, \PValue{sectionentryfill}}{%
\ChangedAt{v3.15}{\Class{scrartcl}}%
- The section entries of class \Class{scrartcl}
- use white space to separate the headings text from the page number.%
- \IndexOption{toc~=\PValue{sectionentrywithoutdots}}}%
+ The section entries of the \Class{scrartcl} class use white space to
+ separate the heading text from the page number. This corresponds to the
+ default setting.%
+ \IndexOption{toc~=\textKValue{sectionentrywithoutdots}}}%
\end{desclist}
%
\EndIndexGroup
\begin{Declaration}
- \OptionVName{chapterentrydots}{simple switch}%
+ \OptionVName{chapterentrydots}{simple switch}\\
\OptionVName{sectionentrydots}{simple switch}
\end{Declaration}
These\ChangedAt[2014/12]{v3.15}{\Class{scrbook}\and \Class{scrreprt}} options
-configure a dotted separation line between the text and the page number of the
-chapter entries of classes \Class{scrbook} and
-\Class{scrreprt}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}}, or of the
-section entries of class \Class{scrartcl}\OnlyAt{\Class{scrartcl}} in the
-table of contents. For \PName{simple switch}, any value from
-\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} may be
-used. The default is \PValue{false}. It selects an empty gap instead of
-dots.
+configure a dotted connecting line between the text and page number of the
+chapter entries for the \Class{scrbook} and
+\Class{scrreprt}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} classes, or for
+the section entries of the \Class{scrartcl}\OnlyAt{\Class{scrartcl}} class, in
+the table of contents. For the \PName{simple switch}, you can use any value from
+\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}.
+The default is \PValue{false}. It selects an empty gap instead of dots.
\BeginIndex{FontElement}{chapterentrydots}\LabelFontElement{chapterentrydots}%
\BeginIndex{FontElement}{sectionentrydots}\LabelFontElement{sectionentrydots}%
-If a dotted line is selected, you can change their font using element
+If a dotted line is used, you can change its font using the element
\FontElement{chapterentrydots}%
\important[i]{\FontElement{chapterentrydots}\\
\FontElement{sectionentrydots}} or \FontElement{sectionentrydots}. The font
-also depends on the element of the page number of the entry (see also
-\autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}
-and \autoref{tab:\LabelBase.fontelements},
-\autopageref{tab:\LabelBase.fontelements}). The defaults of the elements are
-shown in \autoref{tab:\LabelBase.tocelements}. Please note\textnote{Attention!}
-that the dots of all entries are equally aligned only if all dots use the same
-font.%
+also depends on the element of the page number of the entry (see also
+\DescRef{\LabelBase.cmd.setkomafont} and
+\DescRef{\LabelBase.cmd.addtokomafont}, \autoref{sec:\LabelBase.textmarkup},
+\DescPageRef{\LabelBase.cmd.setkomafont}, as well as
+\autoref{tab:maincls.fontelements},
+\autopageref{tab:maincls.fontelements}). The defaults of the elements are
+shown in \autoref{tab:maincls.tocelements}, from
+\autopageref{tab:maincls.tocelements}. Note\textnote{Attention!} that the dots
+of all entries will be equally spaced only if all dots use the same font.%
\EndIndexGroup
\begin{Declaration}
\Macro{tableofcontents}
\end{Declaration}%
-The production of the table of contents is done by the \Macro{tableofcontents}
-command. To get a correct table of contents, at least two {\LaTeX} runs are
-necessary after every change. The contents and the form of the table of
-contents may be influenced with the above described option \DescRef{\LabelBase.option.toc}. After
-changing the settings of this option, at least two \LaTeX{} runs are needed
-again.
-
-The entry for the highest sectional unit below \DescRef{\LabelBase.cmd.part},
-i.\,e., \DescRef{\LabelBase.cmd.chapter} with
-\Class{scrbook}\IndexClass{scrbook} and \Class{scrreprt}\IndexClass{scrreprt}
-or \DescRef{\LabelBase.cmd.section} with \Class{scrartcl}\IndexClass
-{scrartcl} is not indented. There are no dots between the text of the
-sectional unit heading and the page number. The typographic reasons for this
-are that the font is usually different, and the desire for appropriate
-emphasis. The table of contents of this manual is a good example of these
-considerations.
+The table of contents is output by the \Macro{tableofcontents} command. To get
+correct values in the table of contents requires at least two {\LaTeX} runs
+after every change. The \DescRef{\LabelBase.option.toc} option described above
+can also affect the extent and format of the table of contents. After changing
+the settings of this option, at least two \LaTeX{} runs are needed again.
+
+Entries for \DescRef{\LabelBase.cmd.chapter}\IndexCmd{chapter} with
+\Class{scrbook}\IndexClass{scrbook} and \Class{scrreprt}\IndexClass{scrreprt},
+or \DescRef{\LabelBase.cmd.section}\IndexCmd{section} with
+\Class{scrartcl}\IndexClass{scrartcl}, and the sectioning level
+\DescRef{\LabelBase.cmd.part}\IndexCmd{part} are not indented. Additionally,
+there are no dots between the text of this heading and the page number. The
+typographical logic for this behaviour is that the font is usually distinct
+and appropriate emphasis is desirable.
+However\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}, you can change this behaviour with the previously
+documented options. The table of contents of this \iffree{guide}{book} is
+created with the default settings and serves as an example.
+
\BeginIndex{FontElement}{partentry}\LabelFontElement{partentry}%
\BeginIndex{FontElement}{chapterentry}\LabelFontElement{chapterentry}%
\BeginIndex{FontElement}{sectionentry}\LabelFontElement{sectionentry}%
-The font style\ChangedAt{v2.97c}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}}\important[i]{\FontElement{partentry}\\
+The\ChangedAt{v2.97c}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}\important{\FontElement{partentry}\\
\FontElement{chapterentry}\\
- \FontElement{sectionentry}} is, however, affected by the settings of the
-element \FontElement{partentry}, and for classes \Class{scrbook} and
-\Class{scrreprt} by \FontElement{chapterentry}, and for class \Class{scrartcl}
-by \FontElement{sectionentry}. %
+ \FontElement{sectionentry}} font style of the top two levels in the table of
+contents is also affected by the settings for the \FontElement{partentry}
+element, as well as by the \FontElement{chapterentry} element for the
+\Class{scrbook} and \Class{scrreprt} classes, and by the
+\FontElement{sectionentry} element for the \Class{scrartcl} class.
\BeginIndex{FontElement}{partentrypagenumber}%
\LabelFontElement{partentrypagenumber}%
+\LabelFontElement{pagination}%
\BeginIndex{FontElement}{chapterentrypagenumber}%
\LabelFontElement{chapterentrypagenumber}%
\BeginIndex{FontElement}{sectionentrypagenumber}%
\LabelFontElement{sectionentrypagenumber}%
-The font style of the page numbers may be set dissenting from these elements
-using \FontElement{partentrypagenumber} and
-\FontElement{chapterentrypagenumber} respectively
-\FontElement{sectionentrypagenumber} (see \autoref{sec:\LabelBase.textmarkup},
-\DescPageRef{\LabelBase.cmd.setkomafont}, and
-\autoref{tab:\LabelBase.fontelements},
-\autopageref{tab:\LabelBase.fontelements}). %
-\BeginIndex{FontElement}{chapterentrydots}%
-\BeginIndex{FontElement}{sectionentrydots}%
-If the optional dots of the entries of \DescRef{\LabelBase.cmd.chapter} or
-\DescRef{\LabelBase.cmd.section} are used, you can change their font using
-element \FontElement{chapterentrydots}%
-\important[i]{\FontElement{chapterentrydots}\\
- \FontElement{sectionentrydots}} or \FontElement{sectionentrydots}. The font
-also depends on the element of the page number of the entry (see also
-\autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}
-and \autoref{tab:\LabelBase.fontelements},
-\autopageref{tab:\LabelBase.fontelements}). The defaults of the elements are
-shown in \autoref{tab:\LabelBase.tocelements}. Please note\textnote{Attention!}
-that the dots of all entries are aligned same only if all dots use the same
-font.%
+You can set the font style of the page numbers separately from these elements
+using \FontElement{partentrypagenumber}%
+\important{\FontElement{partentrypagenumber}} and
+\FontElement{chapterentrypagenumber}%
+\important{\FontElement{chapterentrypagenumber}\\
+ \FontElement{sectionentrypagenumber}}\,---\,for \Class{scrbook} and
+\Class{scrreprt}\,---\,or \FontElement{sectionentrypagenumber}\,---\,for
+\Class{scrartcl}\,---\, (see \DescRef{\LabelBase.cmd.setkomafont} and
+\DescRef{\LabelBase.cmd.addtokomafont} in \autoref{sec:\LabelBase.textmarkup},
+\DescPageRef{\LabelBase.cmd.setkomafont}, or
+\autoref{tab:maincls.fontelements}, \autopageref{tab:maincls.fontelements}).
+If\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} you use dotted lines connecting the heading entries
+(chapter or section depending on the class) to the page numbers using the
+\DescRef{\LabelBase.option.toc}%
+\IndexOption{toc~=\textKValue{chapterentrywithdots}}%
+\IndexOption{toc~=\textKValue{sectionentrywithdots}}
+\DescRef{\LabelBase.option.chapterentrydots}%
+\IndexOption{chapterentrydots~=\PName{simple switch}} or
+\DescRef{\LabelBase.option.sectionentrydots}%
+\IndexOption{sectionentrydots~=\PName{simple switch}} option, you can change
+their font style using the \DescRef{\LabelBase.fontelement.chapterentrydots}%
+\IndexFontElement{chapterentrydots}%
+\important{\DescRef{\LabelBase.fontelement.chapterentrydots}\\
+ \DescRef{\LabelBase.fontelement.sectionentrydots}} and
+\DescRef{\LabelBase.fontelement.sectionentrydots}%
+\IndexFontElement{sectionentrydots} elements. The defaults for these
+elements are found in \autoref{tab:maincls.tocelements}.
\begin{table}
% \centering
% \caption
\KOMAoptions{captions=topbeside}%
\setcapindent{0pt}%
\begin{captionbeside}
- [Font style defaults of the elements of the table of contents]
- {\label{tab:\LabelBase.tocelements}%
- Font style defaults of the elements of the table of contents}%
+ [Default font styles for the elements of the table of contents]
+ {\label{tab:maincls.tocelements}%
+ Default font styles for the elements of the table of contents}
[l]
\setlength{\tabcolsep}{.9\tabcolsep}% Umbruchoptimierung!
\begin{tabular}[t]{ll}
\toprule
Element & Default font style \\
\midrule
- \DescRef{\LabelBase.fontelement.partentry} &
+ \FontElement{partentry} &
\DescRef{\LabelBase.cmd.usekomafont}\PParameter{disposition}\Macro{large} \\
- \DescRef{\LabelBase.fontelement.partentrypagenumber} & \\
- \DescRef{\LabelBase.fontelement.chapterentry} & \DescRef{\LabelBase.cmd.usekomafont}\PParameter{disposition}\\
- \DescRef{\LabelBase.fontelement.chapterentrydots} & \Macro{normalfont} \\
- \DescRef{\LabelBase.fontelement.chapterentrypagenumber} & \\
- \DescRef{\LabelBase.fontelement.sectionentry} & \DescRef{\LabelBase.cmd.usekomafont}\PParameter{disposition}\\
- \DescRef{\LabelBase.fontelement.sectionentrydots} & \Macro{normalfont} \\
- \DescRef{\LabelBase.fontelement.sectionentrypagenumber} & \\
+ \FontElement{partentrypagenumber} & \\
+ \FontElement{chapterentry} & \DescRef{\LabelBase.cmd.usekomafont}\PParameter{disposition}\\
+ \FontElement{chapterentrydots} & \Macro{normalfont} \\
+ \FontElement{chapterentrypagenumber} & \\
+ \FontElement{sectionentry} & \DescRef{\LabelBase.cmd.usekomafont}\PParameter{disposition} \\
+ \FontElement{sectionentrydots} & \Macro{normalfont} \\
+ \FontElement{sectionentrypagenumber} & \\
\bottomrule
\end{tabular}
\end{captionbeside}
@@ -565,53 +611,64 @@ font.%
\begin{Declaration}
\Counter{tocdepth}
+ \Macro{parttocdepth}
+ \Macro{sectiontocdepth}
+ \Macro{subsectiontocdepth}
+ \Macro{subsubsectiontocdepth}
+ \Macro{paragraphtocdepth}
+ \Macro{subparagraphtocdepth}
\end{Declaration}%
-Normally, the units included in the table of contents are all the units from
-\DescRef{\LabelBase.cmd.part} to \DescRef{\LabelBase.cmd.subsection} for the classes \Class{scrbook} and
-\Class{scrreprt} or from \DescRef{\LabelBase.cmd.part} to \DescRef{\LabelBase.cmd.subsubsection} for the class
-\Class{scrartcl}. The inclusion of a sectional unit in the table of contents
-is controlled by the counter \Counter{tocdepth}. This has the value \(-\)1 for
-\DescRef{\LabelBase.cmd.part}, 0 for \DescRef{\LabelBase.cmd.chapter}, and so on. By incrementing
-or decrementing the counter, one can choose the lowest sectional unit level to
-be included in the table of contents. The same happens with the standard
-classes.
-
-Please note\textnote{Attention!} that for \DescRef{\LabelBase.cmd.part} the
-values of \Counter{tocdepth} and
-\DescRef{\LabelBase.counter.secnumdepth}\IndexCounter{secnumdepth} (see
+Normally, the sectioning divisions included in the table of contents are all
+those from \DescRef{\LabelBase.cmd.part} to
+\DescRef{\LabelBase.cmd.subsection} for the \Class{scrbook} and
+\Class{scrreprt} classes, or from \DescRef{\LabelBase.cmd.part} to
+\DescRef{\LabelBase.cmd.subsubsection} for the \Class{scrartcl} class. Whether
+or not to include a sectioning level in the table of contents is controlled by
+the \Counter{tocdepth} counter. This has the value -1 for
+\DescRef{\LabelBase.cmd.part}, 0 for \DescRef{\LabelBase.cmd.chapter}, and so
+on. By incrementing or decrementing the counter, you can choose the lowest
+sectioning level to include in the table of contents. Incidentally, the
+standard classes work the same way.
+Unlike\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}\textnote{\KOMAScript{} vs. standard classes} with the
+standard classes, with \KOMAScript{} you do not need to remember these values.
+\KOMAScript{} defines a \Macro{\PName{level}tocdepth} command for each
+sectioning level with the appropriate value which you can use to set
+\Counter{tocdepth}.
+
+Please note\textnote{Attention!} that in
+\Class{scrartcl}\OnlyAt{\Class{scrartcl}}, the values of \Counter{tocdepth}
+and \DescRef{\LabelBase.counter.secnumdepth}\IndexCounter{secnumdepth} (see
\autoref{sec:\LabelBase.structure},
-\DescPageRef{\LabelBase.counter.secnumdepth}) are not the same in
-\Class{scrartcl}\OnlyAt{\Class{scrartcl}}. Therefore, you should not use
-\DescRef{\LabelBase.cmd.partnumdepth}\IndexCmd{partnumdepth} to set the value
-of \Counter{tocdepth}.%
+\DescPageRef{\LabelBase.counter.secnumdepth}) for
+\DescRef{\LabelBase.cmd.part} are not the same. This behaviour was copied from
+the standard \Class{article} class for compatibility. Thus, for example, you
+should not use \DescRef{\LabelBase.cmd.partnumdepth}\IndexCmd{partnumdepth} to
+set the value of \Counter{tocdepth}.%
\begin{Example}
- Assume that you are preparing an article that uses the sectional
- unit \DescRef{\LabelBase.cmd.subsubsection}. However, you do not want this sectional
- unit to appear in the table of contents. The preamble of your
+ Suppose you are preparing an article that uses the sectioning level
+ \DescRef{\LabelBase.cmd.subsubsection}. However, you do not want this
+ sectioning level to appear in the table of contents. The preamble of your
document might contain the following:
\begin{lstcode}
\documentclass{scrartcl}
- \setcounter{tocdepth}{2}
+ \setcounter{tocdepth}{\subsectiontocdepth}
\end{lstcode}
- You set the counter \Counter{tocdepth} to 2 because you know that
- this is the value for \DescRef{\LabelBase.cmd.subsection}. If you know that
- \Class{scrartcl} normally includes all levels down to
- \DescRef{\LabelBase.cmd.subsubsection} in the table of contents, you can simply
- decrement the counter \Counter{tocdepth} by one:
+ Thus you set the \Counter{tocdepth} counter to the value of the
+ \Macro{subsectiontocdepth} command. That value is normally 2, but this way,
+ you do not have to remember it.
+
+ If instead you simply want to include one less level in the table of
+ contents than you normally would, you can simply subtract one from the
+ default value of \Counter{tocdepth}:
\begin{lstcode}
\documentclass{scrartcl}
\addtocounter{tocdepth}{-1}
\end{lstcode}
- How much you should add to or subtract from the \Counter{tocdepth} counter
- can also be found by looking at the table of contents after the first
- {\LaTeX} run.
-\end{Example}
-A\textnote{Hint!} small hint in order that you do not need to remember which
-sectional unit has which number: in the table of contents count the number of
-units required extra or less and then, as in the above example, use
-\Macro{addtocounter} to add or subtract that number to or from
-\Counter{tocdepth}.%
-%
+ The\textnote{Hint!} value that you need to add to or subtract from
+ \Counter{tocdepth} is listed in the table of contents after at least two
+ \LaTeX{} runs.
+\end{Example}%
\EndIndexGroup
%
\EndIndexGroup
@@ -619,161 +676,200 @@ units required extra or less and then, as in the above example, use
\LoadCommonFile{parmarkup}% \section{Paragraph Markup}
-\LoadCommonFile{oddorevenpage}% \section{Detection of Odd and Even Pages}
+\LoadCommonFile{oddorevenpage}% \section{Detecting Odd or Even Pages}
-\section{Head and Foot Using Predefined Page Styles}
+\section{Headers and Footers Using Predefined Page Styles}
\seclabel{pagestyle}
-\BeginIndexGroup
-\BeginIndex{}{page>style}
+\BeginIndexGroup
+\BeginIndex{}{page>style}%
One of the general characteristics of a document is the page style. In
-{\LaTeX} this means mostly the contents of headers and footers.
+\LaTeX{} this primarily consists of the contents of headers and footers.
+
\begin{Declaration}
- \OptionVName{headsepline}{simple switch}%
+ \OptionVName{headsepline}{simple switch}
\OptionVName{footsepline}{simple switch}
\end{Declaration}%
-In\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}
-order to have or not to have a rule separating the header from the text body,
-use the option \Option{headsepline} with any value shown in
-\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. Activation
-of the option will result in such a separation line. Similarly, activation of
-option \Option{footsepline} switches on a rule above the foot
-line. Deactivation of any of the options will deactivate the corresponding
-rule.
-
-These options have no effect with the page styles \PValue{empty} and
-\PValue{plain}, because there is no header in this case. Such a line always
-has the effect of visually bringing header and text body closer together. That
-does not mean that the header must now be moved farther from the text
-body. Instead, the header should be considered as belonging to the text body
-for the purpose of page layout calculations. {\KOMAScript} takes this into
-account by automatically passing the option
-\DescRef{typearea.option.headinclude} to the \Package{typearea} package
-whenever the \Option{headsepline} option is used. \KOMAScript{} behaves
-similar to \DescRef{typearea.option.footinclude} using
-\Option{footsepline}. Package \Package{scrlayer-scrpage} (see
-\autoref{cha:scrlayer-scrpage}) adds additional features to this.%
+You\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} can use these options to specify whether a horizontal rule
+appears beneath the header or above the footer. You can use any of the values
+for simple switches shown in \autoref{tab:truefalseswitch},
+\autopageref{tab:truefalseswitch}. Setting the \Option{headsepline} option to
+true or invoking it with no value results in a line beneath the header.
+Similarly, activating the \Option{footsepline} option results in a rule above
+the footer. Deactivating either option switches off the respective rule.
+
+The\textnote{Attention!} \Option{headsepline} option naturally has no effect
+with the \DescRef{\LabelBase.pagestyle.empty} and
+\DescRef{\LabelBase.pagestyle.plain} page styles, which are described below,
+because these styles explicitly dispense with a header\Index{page>header}.
+Typographically, such a line has the effect of making the header appear to be
+closer to the text. This does not mean that the header then needs to be moved
+farther away from the body of the text\Index{text>body}. Instead, the header
+should be considered as belonging to the text body for the purpose of
+calculating the type area. \KOMAScript{} takes this into account by passing
+the \Option{headsepline} option to the
+\hyperref[cha:typearea]{\Package{typearea}}%
+\important{\hyperref[cha:typearea]{\Package{typearea}}}\IndexPackage{typearea}
+package, which then automatically executes the package option
+\DescRef{typearea.option.headinclude}%
+\IndexOption{headinclude}\important{\DescRef{typearea.option.headinclude}}
+with the same value. The same applies to the footer separation line. Unlike
+\Option{headsepline}, the \Option{footsepline} option also affects the
+\PValue{plain} page style because \PValue{plain} prints a page number in the
+footer.
+
+The options themselves do not automatically recalculate the type area. To
+recalculate it, use the \DescRef{typearea.option.DIV} option with the values
+\hyperref[desc:typearea.option.DIV.last]{\PValue{last}} or
+\hyperref[desc:typearea.option.DIV.current]{\PValue{current}} (see
+\DescPageRef{typearea.option.DIV.last}) or the
+\DescRef{typearea.cmd.recalctypearea} command (see
+\DescPageRef{typearea.cmd.recalctypearea}) in \autoref{cha:typearea}.
+
+The \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}
+package (see \autoref{cha:scrlayer-scrpage}) offers further possibilities for
+adjusting lines in headers and footers.%
%
\EndIndexGroup
\begin{Declaration}
- \Macro{pagestyle}\PParameter{page style}%
+ \Macro{pagestyle}\Parameter{page style}
\Macro{thispagestyle}\Parameter{local page style}
\end{Declaration}%
-Usually one distinguishes four different page styles:
+There are usually four different page styles:
\begin{description}
-\item[empty\BeginIndex{Pagestyle}{empty}\LabelPageStyle{empty}] is the page
- style with entirely empty headers and footers. In {\KOMAScript} this is
- completely identical to the standard classes.
-\item[headings\BeginIndex{Pagestyle}{headings}\LabelPageStyle{headings}] is
- the page style with running headings in the header. These are headings for
- which titles are automatically inserted into the header.
- \OnlyAt{\Class{scrbook}\and\Class{scrreprt}}With the classes
- \Class{scrbook}\IndexClass{scrbook} and
- \Class{scrreprt}\IndexClass{scrreprt} the titles of chapters and sections
- are repeated in the header for double-sided layout\,---\,with {\KOMAScript}
- on the outer side, with the standard classes on the inner side. The page
- number is set on the outer side of the footer with {\KOMAScript}; with the
- standard classes it is set on the inner side of the header. In one-sided
- layouts only the titles of the chapters are used and are, with
- {\KOMAScript}, centered in the header. The page numbers are set centered in
- the footer with {\KOMAScript}.
+\item[{\PageStyle{empty}%
+ \BeginIndex[indexmain]{Pagestyle}{empty}\LabelPageStyle{empty}}] is the
+ page style with completely empty headers and footers. In {\KOMAScript}
+ this is identical to the standard classes.%
+\item[{\PageStyle{headings}%
+ \BeginIndex[indexmain]{Pagestyle}{headings}\LabelPageStyle{headings}}] is
+ the page style with running heads in the header. In this style, headings are
+ automatically\Index[indexmain]{running heads>automatic} inserted into the
+ header. \OnlyAt{\Class{scrbook}\and\Class{scrreprt}}%
+ With the classes \Class{scrbook}\IndexClass{scrbook} and
+ \Class{scrreprt}\IndexClass{scrreprt}, the headings of chapters and sections
+ are repeated in the header for two-sided printing\,---\,on the outer side
+ with {\KOMAScript}\textnote{\KOMAScript{} vs. standard classes}, on the
+ inner side with the standard classes. {\KOMAScript} puts the page number on
+ the outer side of the footer; the standard classes put it on the inner side
+ of the header. In one-sided printing, {\KOMAScript} uses only the chapter
+ headings, which are centred in the header, and puts the page numbers centred
+ in the footer.
\OnlyAt{\Class{scrartcl}}\Class{scrartcl}\IndexClass{scrartcl} behaves
- similarly, but starting a level deeper in the section hierarchy with
+ similarly but starts one a level deeper in the sectioning hierarchy, with
sections and subsections, because the chapter level does not exist in this
case.
- While the standard classes automatically set running headings always
- in capitals, {\KOMAScript} applies the style of the title. This has
- several typographic reasons. Capitals as a decoration are actually
- far too strong. If one applies them nevertheless, they should be set
- in a one point smaller type size and with tighter spacing. The
- standard classes do not take these points into consideration.
-
- Beyond this {\KOMAScript} classes support rules below the head and above the
- foot using options \DescRef{\LabelBase.option.headsepline} and
- \DescRef{\LabelBase.option.footsepline} which are described above.
-\item[myheadings\BeginIndex{Pagestyle}{myheadings}\LabelPageStyle{myheadings}]
- corresponds mostly to the page style \PValue{headings}, but the running
- headings are not automatically produced\,---\,they have to be defined by the
- user. The commands \Macro {markboth}\IndexCmd{markboth} and
- \DescRef{\LabelBase.cmd.markright}\IndexCmd{markright} can be used for that
- purpose (see below).
-\item[plain\BeginIndex{Pagestyle}{plain}\LabelPageStyle{plain}] is the page
- style with empty header and only a page number in the footer. With the
- standard classes this page number is always centered in the footer. With
- {\KOMAScript} the page number appears on double-sided\Index {double-sided}
- layout on the outer side of the footer. The one-sided page style behaves
- like the standard setup.
+ While the standard classes\textnote{\KOMAScript{} vs. standard classes}
+ automatically convert the running heads to upper-case letters,
+ {\KOMAScript} uses the capitalisation found in the headings. There are
+ several typographical reasons for this. Upper-case letters are actually far
+ too massive as a text decoration. If you use them anyway, they should be set
+ one point smaller and with slightly tighter spacing. The standard classes do
+ not take these points into consideration.
+
+ In addition, the {\KOMAScript} classes support rules below the header and
+ above the footer with the \DescRef{\LabelBase.option.headsepline} and
+ \DescRef{\LabelBase.option.footsepline} options (see
+ \DescPageRef{\LabelBase.option.headsepline}).%
+\item[{\PageStyle{myheadings}%
+ \BeginIndex[indexmain]{Pagestyle}{myheadings}\LabelPageStyle{myheadings}}]
+ mostly corresponds to the \PValue{headings} page style, but the running
+ heads are not generated automatically%
+ \Index[indexmain]{running heads>manual}\,---\,they have to be defined by the
+ user. You can use the \DescRef{\LabelBase.cmd.markboth}\IndexCmd{markboth}
+ and \DescRef{\LabelBase.cmd.markright}\IndexCmd{markright}\important{%
+ \DescRef{\LabelBase.cmd.markboth}\\
+ \DescRef{\LabelBase.cmd.markright}} commands for that purpose (see
+ \DescPageRef{\LabelBase.cmd.markright}).
+\item[{\PageStyle{plain}%
+ \BeginIndex[indexmain]{Pagestyle}{plain}\LabelPageStyle{plain}}] is the
+ page style with no running head\Index{running head} and only a page number%
+ \Index{page>number} in the footer. The\textnote{\KOMAScript{} vs. standard
+ classes} standard classes always centre this page number in the footer.
+ {\KOMAScript} puts the page number on the outer side of the footer in
+ two-sided\Index{two-sided} mode. {\KOMAScript} behaves like the
+ standard classes in one-sided printing.%
\end{description}
-The page style can be set at any time with the help of the \Macro{pagestyle}
-command and takes effect with the next page that is output. If\textnote{Hint!}
-one uses \Macro{pagestyle} just before a command, that results in an implicit
-page break and if the new page style should be used at the resulting new page
-first, a \DescRef{\LabelBase.cmd.cleardoublepage} just before
-\Macro{pagestyle} will be useful. But usually one sets the page style only
-once at the beginning of the document or in the preamble.
+You\important{\Macro{pagestyle}} can set the page style at any time with the
+help of the \Macro{pagestyle} command, and this setting takes effect with the
+next page that is output. If\textnote{Hint!} you use \Macro{pagestyle} just
+before a command that results in an implicit page break and if the new page
+style should be used on the resulting new page, a
+\DescRef{\LabelBase.cmd.cleardoublepage} just before \Macro{pagestyle} will be
+useful. But usually you set the page style only once, at the beginning of the
+document or in the preamble.
To\important{\Macro{thispagestyle}} change the page style of the current page
-only, one uses the \Macro{thispagestyle} command. This also happens
-automatically at some places in the document. For example, the instruction
-\Macro{thispagestyle}\PParameter{\DescRef{\LabelBase.cmd.chapterpagestyle}} is issued
-implicitly on the first page of a chapter.
-
-Please\textnote{Attention!} note that the change between automatic and manual
-running headings is no longer performed by page style changes when using the
-\Package{scrlayer-scrpage} package, but instead via special instructions. The
-page styles \PValue{headings} and \PValue{myheadings} should not be used
-together with this package.%
-%
-
-\BeginIndexGroup
-\BeginIndex[indexother]{}{font>style}%
+only, use the \Macro{thispagestyle} command. This occurs automatically at some
+points in the document. For example, the
+\Macro{thispagestyle}\PParameter{\DescRef{\LabelBase.cmd.chapterpagestyle}}
+command is issued implicitly on the first page of a chapter.
+
+Note\textnote{Attention!} that when you use the
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}
+package, switching between automatic and manual running heads is no longer
+accomplished by changing the page styles but with special instructions. You
+should not use the \PValue{headings} and \PValue{myheadings} page styles with
+this package.
+
+\BeginIndexGroup \BeginIndex[indexother]{}{font>style}%
\BeginIndex{FontElement}{pageheadfoot}\LabelFontElement{pageheadfoot}%
+\LabelFontElement{pagehead}%
\BeginIndex{FontElement}{pagefoot}\LabelFontElement{pagefoot}%
\BeginIndex{FontElement}{pagenumber}\LabelFontElement{pagenumber}%
-In order to change the font style used in the header, footer, or for the page
-number\ChangedAt{v2.8p}{%
- \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
-, please use the interface described in \autoref{sec:\LabelBase.textmarkup},
-\DescPageRef{\LabelBase.cmd.setkomafont}. The same element is used for header
-and footer, which you can designate with
-\FontElement{pageheadfoot}\important{\FontElement{pageheadfoot}}. The element
-for the page number within the header or footer is called
-\FontElement{pagenumber}\important{\FontElement{pagenumber}}. The element
-\FontElement{pagefoot}, that is additionally supported by the \KOMAScript{}
-classes, will be used only if a page style has been defined that has text at
-the foot line, using package
-\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} (see
+To change the font style used for the header, the footer, or the page
+number\ChangedAt{v2.8p}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}, use the \DescRef{\LabelBase.cmd.setkomafont} and
+\DescRef{\LabelBase.cmd.addtokomafont} commands (see
+\autoref{sec:\LabelBase.textmarkup},
+\DescPageRef{\LabelBase.cmd.setkomafont}). The same element,
+\FontElement{pageheadfoot}\IndexFontElement{pageheadfoot}%
+\important{\FontElement{pageheadfoot}}, is used for the header and the footer.
+The element for the page number within the header or footer is called
+\FontElement{pagenumber}\IndexFontElement{pagenumber}%
+\important{\FontElement{pagenumber}}. The
+\FontElement{pagefoot}\IndexFontElement{pagefoot}%
+\important{\FontElement{pagefoot}} element, which is also provided by the
+\KOMAScript{} classes, is used only if you define a page style with the
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage} package in which the footer contains text (see
\autoref{cha:scrlayer-scrpage},
\DescPageRef{scrlayer-scrpage.fontelement.pagefoot}).
-The default settings can be found in
-\autoref{tab:\LabelBase.defaultFontsHeadFoot}.%
+You can find the default settings in
+\autoref{tab:\LabelBase.defaultFontsHeadFoot}.
%
\begin{table}
% \centering%
+% \caption
\KOMAoptions{captions=topbeside}%
\setcapindent{0pt}%
-% \caption
+% \addtokomafont{caption}{\raggedright}%
\begin{captionbeside}
- [{Default values for the elements of a page style}]
- {\label{tab:\LabelBase.defaultFontsHeadFoot}%
- Default values for the elements of a page style}
+ [{Default values for page style elements}]
+ {\label{tab:maincls.defaultFontsHeadFoot}%
+ \hspace{0pt plus 1ex}%
+ Default values for page style elements}
[l]
\begin{tabular}[t]{ll}
\toprule
- Element & Default value \\
+ Element & Default \\
\midrule
- \DescRef{\LabelBase.fontelement.pagefoot}\IndexFontElement{pagefoot} &
+ \FontElement{pagefoot}\IndexFontElement{pagefoot} &
\\
- \DescRef{\LabelBase.fontelement.pageheadfoot}\IndexFontElement{pagefoothead} &
+ \FontElement{pageheadfoot}\IndexFontElement{pageheadfoot} &
\Macro{normalfont}\Macro{normalcolor}\Macro{slshape} \\
- \DescRef{\LabelBase.fontelement.pagenumber}\IndexFontElement{pagenumber} &
+ \FontElement{pagenumber}\IndexFontElement{pagenumber} &
\Macro{normalfont}\Macro{normalcolor}\\
\bottomrule
\end{tabular}
@@ -782,133 +878,143 @@ The default settings can be found in
%
\begin{Example}
\leavevmode\phantomsection\xmpllabel{cmd.pagestyle}%
- Assume that you want to set header and footer in a smaller type size
+ Suppose you want to set header and footer in a smaller type size
and in italics. However, the page number should not be set in
- italics but bold. Apart from the fact that the result will look
- horrible, you can obtain this as follows:
+ italics but in bold. Apart from the fact that the result will look
+ horrible, you can do this as follows:
\begin{lstcode}
\setkomafont{pageheadfoot}{%
- \normalfont\normalcolor\itshape\small
- }
+ \normalfont\normalcolor\itshape\small}
\setkomafont{pagenumber}{\normalfont\bfseries}
\end{lstcode}
- If you want only that, in addition to the default slanted variant, a smaller
- type size is used, it is sufficient to use the following:
+ On the other hand, if you only want a smaller font to be used along with the
+ default slanted text, you can use the following:
\begin{lstcode}
\addtokomafont{pagehead}{\small}
\end{lstcode}
- As you can see, the last example uses the element
- \FontElement{pagehead}\important{\FontElement{pagehead}}. You can achieve
- the same result using \PValue{pageheadfoot} instead (see
+ As you can see, the previous example uses the
+ \FontElement{pagehead}\important{\FontElement{pagehead}} element. You can
+ achieve the same result using \PValue{pageheadfoot} instead (see
\autoref{tab:\LabelBase.fontelements} on
\autopageref{tab:\LabelBase.fontelements}).
\end{Example}
-It is not possible to use these methods to force capitals to be used
-automatically for the running headings. For that, please use the
-\Package{scrlayer-scrpage} package (see \autoref{cha:scrlayer-scrpage},
+It is not possible to use these methods to force upper-case letters to be used
+automatically for the running heads. Although you can redefine
+\DescRef{tocbasic.cmd.MakeMarkcase}\IndexCmd{MakeMarkcase}, in such cases you
+should instead use the
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} package (see
+\autoref{cha:scrlayer-scrpage},
\DescPageRef{scrlayer-scrpage.option.markcase}).
-If you define your own page styles, the commands
+If\textnote{Hint!} you define your own page styles, the commands
\DescRef{\LabelBase.cmd.usekomafont}\PParameter{pageheadfoot},
-\DescRef{\LabelBase.cmd.usekomafont}\PParameter {pagenumber}, and
-\DescRef{\LabelBase.cmd.usekomafont}\PParameter{pagefoot} can be useful. If
-you do not use the {\KOMAScript} package \Package{scrlayer-scrpage} (see
-\autoref{cha:scrlayer-scrpage}) for that, but, for example, the package
-\Package{fancyhdr}\IndexPackage{fancyhdr} (see \cite{package:fancyhdr}), you
-can use these commands in your definitions. Thereby you can remain compatible
-with {\KOMAScript} as much as possible. If you do not use these commands in
-your own definitions, changes like those shown in the previous examples have
-no effect. The package
-\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} takes care to keep
-the maximum possible compatibility with other packages itself.
-%
+\DescRef{\LabelBase.cmd.usekomafont}\PParameter{pagenumber}, and
+\DescRef{\LabelBase.cmd.usekomafont}\PParameter{pagefoot} can be useful. In
+particular, if you do not use the {\KOMAScript} package
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} (see
+\autoref{cha:scrlayer-scrpage}) but use, for example, the
+\Package{fancyhdr}\IndexPackage{fancyhdr}\important{\Package{fancyhdr}}
+package (see \cite{package:fancyhdr}), you can use these commands in your
+definitions. In this way you can maintain compatibility with {\KOMAScript} as
+much as possible. If you do not use these commands in your own definitions,
+changes such as those shown in the previous examples have no effect. The
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage} package tries to maintain maximum
+compatibility as long as, for example,
+\iffree{\Macro{thepage}}{\DescRef{\LabelBase-experts.cmd.thepage}}%
+\IndexCmd{thepage} is not used directly for the page number rather than the
+\iffree{\Macro{pagemark}}{\DescRef{\LabelBase-experts.cmd.pagemark}}%
+\IndexCmd{pagemark} which is provided for it.%
\EndIndexGroup
%
\EndIndexGroup
\begin{Declaration}
- \Macro{markboth}\Parameter{left mark}\Parameter{right mark}%
+ \Macro{markboth}\Parameter{left mark}\Parameter{right mark}
\Macro{markright}\Parameter{right mark}
\end{Declaration}
-\BeginIndex{Pagestyle}{headings}%
-\BeginIndex{Pagestyle}{myheadings}%
-With page style \PageStyle{myheadings}\important{\PageStyle{myheadings}}%
-\IndexPagestyle{myheadings}, there's no automatic setting of the running head.
-Instead of this one would set it with the help of commands \Macro{markboth}
-and \Macro{markright}. Thereby \PName{left mark} normally will be used at the
-head of even pages and \PName{right mark} at the heads of odd pages. With
-one-sided printing, only the \PName{right mark} exists. Using package
-\Package{scrlayer-scrpage}%
-\IndexPackage{scrlayer-scrpage}\important{\Package{scrlayer-scrpage}}, the
-additional command \DescRef{scrlayer-scrpage.cmd.markleft}%
-\IndexCmd{markleft}\important{\DescRef{scrlayer-scrpage.cmd.markleft}} exists.
-
-The commands may be used with other page styles too. Combination with automatic
-running head, e.\,g., with page style \PageStyle{headings}, limits the effect
-of the commands until the next automatic setting of the corresponding marks.%
+The \DescRef{\LabelBase.pagestyle.myheadings}%
+\important{\DescRef{\LabelBase.pagestyle.myheadings}}%
+\IndexPagestyle{myheadings} page style does not set the running head. Instead,
+you set it with the help of the \Macro{markboth} and \Macro{markright}
+commands. This way the \PName{left mark} will normally be used in the header
+of even pages and \PName{right mark} in the header of odd pages. With
+one-sided printing, only the \PName{right mark} exists. With the
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}
+package, the \DescRef{scrlayer-scrpage.cmd.markleft}%
+\IndexCmd{markleft}\important{\DescRef{scrlayer-scrpage.cmd.markleft}} command
+is also available.
+
+You can use these commands with other page styles too. However, when combined
+with automatic running heads, for example with the
+\DescRef{\LabelBase.pagestyle.headings}\IndexPagestyle{headings} page style,
+the effect of the commands lasts only until the next time the respective marks
+are set automatically.%
%
\EndIndexGroup
-
\begin{Declaration}
- \Macro{titlepagestyle}%
- \Macro{partpagestyle}%
- \Macro{chapterpagestyle}%
+ \Macro{titlepagestyle}
+ \Macro{partpagestyle}
+ \Macro{chapterpagestyle}
\Macro{indexpagestyle}
\end{Declaration}%
\Index{title>page style}%
\Index{part>page style}%
\Index{chapter>page style}%
\Index{index>page style}%
-For some pages, a different page style is chosen with the help of the command
-\DescRef{\LabelBase.cmd.thispagestyle}. Which page style this actually is, is
-defined by these four macros, of which \Macro{partpagestyle} and
-\Macro{chapterpagestyle}\OnlyAt{\Class{scrbook}\and\Class{scrreprt}} are found
-only with classes \Class{scrbook} and \Class{scrreprt}, but not in
-\Class{scrartcl}. The default value for all four cases is \PValue{plain}. The
-meaning of these macros can be taken from \autoref{tab:specialpagestyles}.
+On some pages, a different page style is chosen automatically with the help of
+the \DescRef{\LabelBase.cmd.thispagestyle} command. Which page style this
+actually is, is defined by these four macros, of which \Macro{partpagestyle}
+and \Macro{chapterpagestyle}\OnlyAt{\Class{scrbook}\and\Class{scrreprt}} are
+found only with classes \Class{scrbook} and \Class{scrreprt}, and not in
+\Class{scrartcl}. The default value for all four cases is
+\DescRef{\LabelBase.pagestyle.plain}\IndexPagestyle{plain}. You can find the
+meaning of these macros in \autoref{tab:specialpagestyles}.
%
\begin{table}
\centering
- \caption{Macros to set up page style of special pages}
+ \caption{Macros to set up the page style of special pages}
\label{tab:specialpagestyles}
\begin{desctabular}
\mentry{titlepagestyle}{Page style for a title page when using
\emph{in-page} titles.}%
- \mentry{partpagestyle}{Page style for the pages with \DescRef{\LabelBase.cmd.part}
- titles.}%
+ \mentry{partpagestyle}{Page style for pages with
+ \DescRef{\LabelBase.cmd.part} titles.}%
\mentry{chapterpagestyle}{Page style for the first page of a chapter.}%
\mentry{indexpagestyle}{Page style for the first page of the index.}%
\end{desctabular}
\end{table}
%
-The page styles can be redefined with the \Macro{renewcommand} macro.
+You can redefine the page styles with the \Macro{renewcommand} macro.
\begin{Example}
- Assume that you want the pages with a \DescRef{\LabelBase.cmd.part} heading to have
- no number. Then you can use the following command, for example in
- the preamble of your document:
+ Suppose you do not want the pages with a \DescRef{\LabelBase.cmd.part}
+ heading to be numbered. You can use the following command in the preamble of
+ your document:
\begin{lstcode}
\renewcommand*{\partpagestyle}{empty}
\end{lstcode}
As mentioned previously on \DescPageRef{\LabelBase.pagestyle.empty},
- the page style \PValue{empty} is exactly what is required in this
- example. Naturally you can also use a user-defined page style.
-
- Assume you have defined your own page style for initial chapter pages
- with the package \Package{scrlayer-scrpage} (see
- \autoref{cha:scrlayer-scrpage}). You have given to this page style the
- fitting name \PValue{chapter}. To actually use this style, you must
- redefine the macro \Macro{chapterpagestyle} accordingly:
+ the \PValue{empty} page style is exactly what is required in this
+ 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-scrpage]{\Package{scrlayer-scrpage}} package
+ (see \autoref{cha:scrlayer-scrpage}). 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}
\renewcommand*{\chapterpagestyle}{chapter}
\end{lstcode}
-
- Assume that you want the table of contents\Index{table of
- contents}\textnote{table of contents} of a book to have no page
- numbers. However, everything after the table of contents should work again
- with the page style \PValue{headings}, as well as with \PValue{plain} on
- every first page of a chapter. You can use the following commands:
+
+ Suppose you do not want the table of contents\Index{table of contents}%
+ \textnote{table of contents} of a book to have page numbers. Everything
+ after the table of contents, however, should use the \PValue{headings}
+ page style, including the \PValue{plain} page style for the first
+ page of every chapter. You can use the following:
\begin{lstcode}
\clearpage
\pagestyle{empty}
@@ -918,33 +1024,50 @@ The page styles can be redefined with the \Macro{renewcommand} macro.
\pagestyle{headings}
\renewcommand*{\chapterpagestyle}{plain}
\end{lstcode}
- Instead of the above you may do a local redefinition using a group. The
- advantage will be that you do not need to know the current page style before
- the change to switch back at the end.
+ You can also keep the redefinition local by using a group. This method has
+ the advantage that you do not need to make any assumptions about the what
+ the previous page style was in order to restore it after your local change:
\begin{lstcode}
\clearpage
\begingroup
- \pagestyle{empty}
- \renewcommand*{\chapterpagestyle}{empty}
- \tableofcontents
- \clearpage
+ \pagestyle{empty}
+ \renewcommand*{\chapterpagestyle}{empty}
+ \tableofcontents
+ \clearpage
\endgroup
\end{lstcode}
+ Note,\important{Attention!} however, that you never should put a numbered
+ sectioning command into a group. Otherwise you may get unpredictable results
+ with commands like \Macro{label}.
- But\important{Attention!} notice that you never should put a numbered head
- into a group. Otherwise you may get funny results with commands like
- \Macro{label}.
+ On \DescPageRef{tocbasic.cmd.AfterTOCHead} in \autoref{sec:tocbasic.toc},
+ you will discover the \DescRef{tocbasic.cmd.AfterTOCHead} command, which
+ makes a solution even easier:
+\begin{lstcode}
+ \AfterTOCHead[toc]{%
+ \thispagestyle{empty}%
+ \pagestyle{empty}%
+ }
+\end{lstcode}%
+ This takes advantage of the fact that if there are several
+ \DescRef{\LabelBase.cmd.thispagestyle} commands on the same page, the last
+ one always wins.
\end{Example}
\begin{Explain}
- Whoever thinks that it is possible to put running headings on the
- first page of a chapter by using the command
+ You might think that you can put running heads on the first page of a
+ chapter simply by using the
\begin{lstcode}
\renewcommand*{\chapterpagestyle}{headings}
\end{lstcode}
- should read more about the background of \Macro{rightmark} at
- \autoref{sec:maincls-experts.addInfos},
- \DescPageRef{maincls-experts.cmd.rightmark}.
+ command. Before you try this, you should read \iffree{}{more about the
+ background to \DescRef{maincls-experts.cmd.rightmark} in
+ \autoref{sec:maincls-experts.addInfos} on
+ \DescPageRef{maincls-experts.cmd.rightmark}. Also, }the remarks on
+ \DescRef{scrlayer-scrpage-experts.cmd.rightfirstmark} starting on page
+ \DescPageRef{scrlayer-scrpage-experts.cmd.rightfirstmark} in
+ \autoref{cha:scrlayer-scrpage-experts}, \autoref{part:forExperts}
+ \iffree{}{provide important information}.%
\end{Explain}
%
\EndIndexGroup
@@ -953,27 +1076,24 @@ The page styles can be redefined with the \Macro{renewcommand} macro.
\begin{Declaration}
\Macro{pagenumbering}\Parameter{numbering style}
\end{Declaration}
-This command works the same way in {\KOMAScript} as in the standard
-classes. More precisely it is a feature neither of the standard classes nor of
-the \KOMAScript{} classes but of the {\LaTeX} kernel. You can specify with
-this command the \PName{numbering style} of page numbers.
-
-The changes take effect immediately, hence starting with the
-page that contains the command. It is recommended to use
-\DescRef{\LabelBase.cmd.cleardoubleoddpage} to close the last page and start a new odd page
-before. The possible settings can be found in
-\autoref{tab:numberKind}.
-
-Using\textnote{Attention!} the command \Macro{pagenumbering} also resets the
-page counter\Index{page>counter}\Index{page>number}. Thus the page number of
-the next page which {\TeX} outputs will have the number 1 in the style
-\PName{numbering style}.
+This command works the same way in {\KOMAScript} as in the standard classes.
+Strictly speaking, it is a feature of neither the standard classes nor the
+\KOMAScript{} classes but of the {\LaTeX} kernel. This command is used to
+change the \PName{numbering style} of page numbers.
+
+The changes take effect immediately, i.\,e., starting from the page that
+contains the command. If necessary, you should first close the current page
+with \DescRef{\LabelBase.cmd.clearpage} or better
+\DescRef{\LabelBase.cmd.cleardoubleoddpage}%
+\important{\DescRef{\LabelBase.cmd.cleardoubleoddpage}}%
+\IndexCmd{cleardoubleoddpage}. You can find the available settings for
+\PName{numbering style} in \autoref{tab:numberKind}.
%
\begin{table}
-% \centering
+ % \centering
\KOMAoptions{captions=topbeside}%
\setcapindent{0pt}%
-% \caption
+ % \caption
\begin{captionbeside}
{\label{tab:numberKind}%
Available numbering styles of page numbers}
@@ -990,9 +1110,91 @@ the next page which {\TeX} outputs will have the number 1 in the style
\end{tabular}
\end{captionbeside}
\end{table}
-%
+
+Calling\textnote{Attention!} \Macro{pagenumbering} always resets the page
+number\Index{page>number}. The current page becomes number 1 in the selected
+\PName{numbering style}. In order that two-sided documents produce the correct
+results on an even page, so that the left-hand page is not missing, you should
+always add \DescRef{\LabelBase.cmd.cleardoubleoddpage}%
+\important{\DescRef{\LabelBase.cmd.cleardoubleoddpage}}%
+\IndexCmd{cleardoubleoddpage} before \Macro{pagenumbering}. The next section
+provides more information about potentially inserted blank pages.
+
+\begin{Explain}
+ Let me say a word about a common mistake found in various templates
+ circulating on the Internet. If you encounter lines like the
+ following\,---\,without the initial comment naturally\,---\,this is an
+ unmistakable sign that the creator did not read or understand the
+ remark above:
+\begin{lstcode}
+ % Attention! This example contains errors!
+ % Please note the explanation in the text!
+ \tableofcontents
+ \pagenumbering{arabic}
+ \setcounter{page}{1}
+\end{lstcode}
+ Since \DescRef{\LabelBase.cmd.tableofcontents} outputs the table of contents
+ but does not automatically issue a page break at the end, the page numbering
+ is already changed on the last page of the table of contents. Because it
+ lacks a \DescRef{\LabelBase.cmd.cleardoubleoddpage} command before
+ \Macro{pagenumbering}, it receives a pagination of the Arabic number 1.
+ Additionally, the final line which sets the page numbering to 1 is
+ superfluous, since this is already done by \Macro{pagenumbering}.
+
+ Sometimes\,---\,without the initial comment, naturally\,---\, you find:
+\begin{lstcode}
+ % Attention! This example contains errors!
+ % Please note the explanation in the text!
+ \tableofcontents
+ \pagebreak
+ \pagenumbering{arabic}
+ \setcounter{page}{1}
+\end{lstcode}
+ Here the creator tried to solve the problem with the final page of the table
+ of contents with the help of \Macro{pagebreak}\IndexCmd{pagebreak}.
+
+ Unfortunately, this solution is not much better. Here there is a page break
+ after the last page of the table of contents. This may cause entries on the
+ last page of a two-sided document to have excess vertical spacing (see
+ \DescRef{\LabelBase.cmd.flushbottom},
+ \DescPageRef{\LabelBase.cmd.flushbottom}). \Macro{pagebreak} is clearly
+ the wrong command here.
+
+ Furthermore, \Macro{newpage}\IndexCmd{newpage} or
+ \DescRef{\LabelBase.cmd.clearpage} would not be sufficient for a two-sided
+ document. For example, if the last page of the table of contents had the
+ Roman numeral vii, the Arabic numbered right-side page 1 would immediately
+ follow the Roman numeral right-side page. A left-side page between the two
+ would be missing, which could cause serious problems with later printing.
+
+ My advice: Avoid using templates that contain errors with respect to such
+ simple things. Incidentally, the correct way would be:
+\begin{lstcode}
+ \tableofcontents
+ \cleardoubleoddpage
+ \pagenumbering{arabic}
+\end{lstcode}
+ This also applies if \Class{scrartcl}\OnlyAt{\Class{scrartcl}} uses a class
+ that usually does not start a new page after the table of contents. If you
+ switch the page numbering, a new right-hand page must be started. If you do
+ not want such a change, you should keep the numbering style of pages
+ consistent throughout the document without changing it in between.
+\iffalse% Umbruchkorrekturtext
+ For articles or other short documents, this is generally recommended.
+\fi
+
+ It is easier to change the numbering style when using
+ \Class{scrbook}\OnlyAt{\Class{scrbook}}. There you have the support of two
+ commands, \DescRef{\LabelBase.cmd.frontmatter}%
+ \important{\DescRef{\LabelBase.cmd.frontmatter}\\
+ \DescRef{\LabelBase.cmd.mainmatter}}%
+ \IndexCmd{fontmatter} and \DescRef{\LabelBase.cmd.mainmatter}%
+ \IndexCmd{mainmatter}, for the most commonly used switching. For more
+ information, please see
+ \autoref{sec:maincls.separation},
+ \DescPageRef{\LabelBase.cmd.mainmatter}.%
+\end{Explain}%
\EndIndexGroup
-%
\EndIndexGroup
@@ -1000,126 +1202,130 @@ the next page which {\TeX} outputs will have the number 1 in the style
\LoadCommonFile{footnotes}% \section{Footnotes}
-
-\section[Demarcation]{Demarcation\protect\OnlyAt{\Class{scrbook}}}
+\section[Book Structure]{Book Structure\protect\OnlyAt{\Class{scrbook}}}
\seclabel{separation}
-\BeginIndexGroup
-\BeginIndex{}{front matter}%
-\BeginIndex{}{main matter}%
-\BeginIndex{}{back matter}%
-\BeginIndex{}{matter>front}%
-\BeginIndex{}{matter>main}%
-\BeginIndex{}{matter>back}%
-Sometimes books are roughly separated into front matter, main matter, and
-back matter. \KOMAScript{} provides this for \Class{scrbook} also.
+Sometimes books are loosely divided into \emph{front matter}%
+\Index{front matter}, \emph{main matter}\Index{main matter}, and
+\emph{back matter}\Index{back matter}. \KOMAScript{} also provides this
+capability for \Class{scrbook}.
+
\begin{Declaration}
- \Macro{frontmatter}%
- \Macro{mainmatter}%
+ \Macro{frontmatter}
+ \Macro{mainmatter}
\Macro{backmatter}
\end{Declaration}%
-The macro \Macro{frontmatter}\important{\Macro{frontmatter}} introduces the
-front matter in which roman numerals are used for the page numbers. Chapter
-headings in a front matter are not numbered. The section titles which would be
-numbered start at chapter 0, and would be consecutively numbered across
-chapter boundaries. However, this is of no import, as the front matter is used
-only for the title pages, table of contents\Index{table of contents}, lists of
-figures\Index{list of>figures}\Index{figures>list of} and
-tables\Index{tables>list of}, and a foreword\Index{foreword}. The foreword can
-thus be set as a normal chapter. A foreword should never be divided into
-sections but kept as short as possible. Therefore, in the foreword there is no
-need for a deeper structuring than the chapter level.
-
-In case the user sees things differently and wishes to use numbered
+The front matter includes all the material which appears before the main
+text begins, including title pages, preface, and table of contents. It is
+initiated with
+\Macro{frontmatter}\important{\Macro{frontmatter}}. In the front matter,
+Roman numerals are used for the page numbers, and chapter headings in
+the header are not numbered. However, section headings are numbered
+consecutively, starting from chapter 0. This typically does not matter, as the
+front matter is used only for the title pages, table of contents%
+\Index{table of contents}, lists of figures\Index{list of>figures}%
+\Index{figures>list of} and tables\Index{tables>list of}, and a
+preface\Index{preface} or foreword\Index{foreword}. The preface can thus be
+created as a normal chapter. A preface should be as short as possible and
+never divided into sections. The preface thus does not require a deeper level
+of structure than the chapter.
+
+If you see things differently and want to use numbered
sections\Index{section>number} in the chapters of the front matter, as of
-version~2.97e\ChangedAt{v2.97e}{\Class{scrbook}}%
+version~2.97e,\ChangedAt{v2.97e}{\Class{scrbook}}%
\important{\OptionValueRef{\LabelBase}{version}{2.97e}} the section numbering
no longer contains the chapter number. This change only takes effect when the
compatibility option is set to at least version~2.97e (see option
\DescRef{\LabelBase.option.version},
\autoref{sec:\LabelBase.compatibilityOptions},
-\DescPageRef{\LabelBase.option.version}). It is explicity noted that this
-creates a confusion with chapter numbers! The use of \DescRef{\LabelBase.cmd.addsec} and
-\DescRef{\LabelBase.cmd.section*} (see \autoref{sec:\LabelBase.structure},
-\DescPageRef{\LabelBase.cmd.section*} and \DescPageRef{\LabelBase.cmd.addsec})
-are thus, in the author's opinion, far more preferable.
-
-As of version~2.97e\ChangedAt{v2.97e}{\Class{scrbook}} the numbering of float
-environments, such as tables\Index{table>number} and
+\DescPageRef{\LabelBase.option.version}). It is explicitly noted that this
+creates confusion with chapter numbers! The use of
+\DescRef{\LabelBase.cmd.addsec} and \DescRef{\LabelBase.cmd.section*} (see
+\autoref{sec:\LabelBase.structure}, \DescPageRef{\LabelBase.cmd.section*} and
+\DescPageRef{\LabelBase.cmd.addsec}) are thus, in the author's opinion,
+greatly preferable.
+
+As of version~2.97e\ChangedAt{v2.97e}{\Class{scrbook}} the numbering of
+floating environments, such as tables\Index{table>number} and
figures\Index{figure>number}, and equation numbers\Index{equation>number} in
-the front matter also contain no chapter number part. To take effect this too
-requires the corresponding compatibility setting (see option
-\DescRef{\LabelBase.option.version},
+the front matter also contains no chapter-number part. To take effect, this
+too requires the corresponding compatibility setting (see the
+\DescRef{\LabelBase.option.version} option,
\autoref{sec:\LabelBase.compatibilityOptions},
\DescPageRef{\LabelBase.option.version}).
-\Macro{mainmatter}\important{\Macro{mainmatter}} introduces the main matter
-with the main text. If there is no front matter, then this command can be
-omitted. The default page numbering in the main matter uses Arabic numerals
-(re)starting in the main matter at 1.
+The part of the book with the main text is introduced
+with \Macro{mainmatter}\important{\Macro{mainmatter}}. If there is no front
+matter, you can omit this command. The default page numbering in the main
+matter uses Arabic numerals and (re)starts the page count at 1 at the start of
+the main matter.
The back matter is introduced with
-\Macro{backmatter}\important{\Macro{backmatter}}. Opinions differ in what
-should be part of the back matter. So in some cases you will find only the
+\Macro{backmatter}\important{\Macro{backmatter}}. Opinions differ as to what
+belongs in the back matter. So in some cases you will find only the
bibliography\Index{bibliography}, in some cases only the index\Index{index},
-and in other cases both of these as well as the appendices. The chapters in
+and in other cases both of these as well as the appendices. The chapters in
the back matter are similar to the chapters in the front matter, but page
-numbering is not reset. If you do require separate page numbering you may use
-the command \DescRef{\LabelBase.cmd.pagenumbering} from
+numbering is not reset. If you do require separate page numbering, you can use
+the \DescRef{\LabelBase.cmd.pagenumbering}%
+\important{\DescRef{\LabelBase.cmd.pagenumbering}} command in
\autoref{sec:\LabelBase.pagestyle},
-\DescPageRef{\LabelBase.cmd.pagenumbering}.
-%
-\EndIndexGroup
+\DescPageRef{\LabelBase.cmd.pagenumbering}.%
%
\EndIndexGroup
-\section{Structuring of Documents}
-\seclabel{structure}
+\section{Document Structure}
+\seclabel{structure}%
+\BeginIndexGroup
+\BeginIndex{}{document structure}
+
+The structure refers to dividing a document into parts, chapters, sections,
+and additional levels of structure.
-Structuring of documents means to divide them into parts, chapters, sections,
-and several other structural elements.
\begin{Declaration}
- \OptionVName{open}{method}
+ \OptionVName{open}{method}
\end{Declaration}%
-\OnlyAt{\Class{scrbook}\and\Class{scrreprt}}%
-\KOMAScript{} classes \Class{scrbook} and \Class{scrreprt} give you the choice
-of where to start\Index{chapter>start} a new chapter with double-sided
-printing. By default \Class{scrreprt} starts a new chapter at the next
-page. This is like \PName{method} \PValue{any}. However, \Class{scrbook}
-starts new chapters at the next right-hand page. This is like \PName{method}
-\PValue{right} and is usually used in books. But sometimes chapters should
-start at the left-hand page of a double-page spread. This would be
-accomplished with \PName{method}
-\PValue{left}\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}}. An
-overview of the supported methods may be found at
-\autoref{tab:\LabelBase.open}. The table also describes the effect on
-\DescRef{\LabelBase.cmd.cleardoublepage}, \DescRef{\LabelBase.cmd.cleardoublepageusingstyle},
-\DescRef{\LabelBase.cmd.cleardoublestandardpage}, \DescRef{\LabelBase.cmd.cleardoubleplainpage}, and
-\DescRef{\LabelBase.cmd.cleardoubleemptypage} (see \autoref{sec:\LabelBase.emptypage},
+The\OnlyAt{\Class{scrbook}\and\Class{scrreprt}} \KOMAScript{} classes
+\Class{scrbook} and \Class{scrreprt} give you the choice of where to start a
+new chapter with two-sided printing. By default \Class{scrreprt} starts a new
+chapter\Index{chapter>start} on the next page. This is equivalent to
+\PName{method} \PValue{any}. However, \Class{scrbook} starts new chapters at
+the next right-hand page. This is equivalent to \PName{method} \PValue{right}
+and is usually used in books. But sometimes chapters should start on the
+left-hand page of a two-page spread. You can accomplish this with the
+\PName{method} \PValue{left}\ChangedAt{v3.00}{\Class{scrbook}\and
+ \Class{scrreprt}}. You can find a summary of the available values in
+\autoref{tab:\LabelBase.open}. The table also describes the effects of
+\DescRef{\LabelBase.cmd.cleardoublepage},
+\DescRef{\LabelBase.cmd.cleardoublepageusingstyle},
+\DescRef{\LabelBase.cmd.cleardoublestandardpage},
+\DescRef{\LabelBase.cmd.cleardoubleplainpage}, and
+\DescRef{\LabelBase.cmd.cleardoubleemptypage} (see
+\autoref{sec:\LabelBase.emptypage},
\DescPageRef{\LabelBase.cmd.cleardoublepage}).
\begin{table}
- \caption[{Available values for option \Option{open}}]{Available values for
- option \Option{open} to select page breaks with interleaf pages using
- \Class{scrbook} or \Class{scrreprt}}
+ \caption[{Available values for the \Option{open} option}]{Available values
+ for the \Option{open} option to select page breaks with interleaf pages
+ using \Class{scrbook} or \Class{scrreprt}}
\begin{desctabular}
\pventry{any}{%
Parts, chapter, index, and back matter use
- \DescRef{\LabelBase.cmd.clearpage} instead of
- \DescRef{\LabelBase.cmd.cleardoublepage};%
+ \DescRef{\LabelBase.cmd.clearpage}, not
+ \DescRef{\LabelBase.cmd.cleardoublepage};
\DescRef{\LabelBase.cmd.cleardoublepageusingstyle},
\DescRef{\LabelBase.cmd.cleardoublestandardpage},
\DescRef{\LabelBase.cmd.cleardoubleplainpage},
\DescRef{\LabelBase.cmd.cleardoubleemptypage}, and
- \DescRef{\LabelBase.cmd.cleardoublepage} behaves same like using
+ \DescRef{\LabelBase.cmd.cleardoublepage} behave the same as using
\OptionValue{open}{right}.%
- \IndexOption{open~=\PValue{any}}}%
+ \IndexOption{open~=\textKValue{any}}}%
\pventry{left}{%
- Part, chapter, index and back matter use
- \DescRef{\LabelBase.cmd.cleardoublepage};%
+ Part, chapter, index, and back matter use
+ \DescRef{\LabelBase.cmd.cleardoublepage}; the commands
\DescRef{\LabelBase.cmd.cleardoublepageusingstyle},
\DescRef{\LabelBase.cmd.cleardoublestandardpage},
\DescRef{\LabelBase.cmd.cleardoubleplainpage},
@@ -1127,10 +1333,10 @@ overview of the supported methods may be found at
\DescRef{\LabelBase.cmd.cleardoublepage} result in a page break and add
an interleaf page\Index{page>interleaf} if needed to reach the next
left-hand page.%
- \IndexOption{open~=\PValue{left}}}%
+ \IndexOption{open~=\textKValue{left}}}%
\pventry{right}{%
- Part, chapter, index and back matter use
- \DescRef{\LabelBase.cmd.cleardoublepage};%
+ Part, chapter, index, and back matter use
+ \DescRef{\LabelBase.cmd.cleardoublepage}; the commands
\DescRef{\LabelBase.cmd.cleardoublepageusingstyle},
\DescRef{\LabelBase.cmd.cleardoublestandardpage},
\DescRef{\LabelBase.cmd.cleardoubleplainpage},
@@ -1138,95 +1344,99 @@ overview of the supported methods may be found at
\DescRef{\LabelBase.cmd.cleardoublepage} result in a page break and add
an interleaf page\Index{page>interleaf} if needed to reach the next
right-hand page.%
- \IndexOption{open~=\PValue{right}}}%
+ \IndexOption{open~=\textKValue{right}}}%
\end{desctabular}
\label{tab:\LabelBase.open}
\end{table}
Since \LaTeX{} does not differentiate between left-hand and right-hand pages
-in single-sided printing, the option does not have any influence in that case.
+in one-sided printing, the option has no effect in that case.
-In class \Class{scrartcl} the section is the first structural element below
-the part. Because of this, \Class{scrartcl} does not support this option.
+In the \Class{scrartcl} class, the section is the first structural element
+below the part. For this reason, \Class{scrartcl} does not support this
+option.
%
\EndIndexGroup
\begin{Declaration}
- \OptionVName{chapterprefix}{simple switch}%
- \OptionVName{appendixprefix}{simple switch}%
+ \OptionVName{chapterprefix}{simple switch}
+ \OptionVName{appendixprefix}{simple switch}
\Macro{IfChapterUsesPrefixLine}\Parameter{then code}\Parameter{else code}
\end{Declaration}%
With\OnlyAt{\Class{scrbook}\and\Class{scrreprt}} the standard classes
\Class{book} and \Class{report}, a chapter
-title\Index[indexmain]{chapter>title} consists of a line with the word
-``Chapter''\footnote{When using another language the word ``Chapter''
- is naturally translated to the appropriate language.} followed by
-the chapter number. The title itself is set left-justified on the
-following lines. The same effect is obtained in {\KOMAScript} with the
-option \Option{chapterprefix}. Any value from table
-\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} may
-be used as \PName{simple switch}. The default, however, is
-\OptionValue{chapterprefix}{false}, which is opposite of the behaviour
-of the standard classes, which would correspond to
-\OptionValue{chapterprefix}{true}.
-These options also affect the automatic
-running titles in the headers (see \autoref{sec:\LabelBase.pagestyle},
+heading\Index[indexmain]{chapter>heading} consists of a line with the word
+``Chapter''\footnote{When using another language the word ``Chapter'' is of
+course translated to the appropriate language.} followed by the chapter
+number. The heading itself is set left-justified on the following line. The
+same effect is obtained in {\KOMAScript} with the \Option{chapterprefix}
+option. You can use any value from \autoref{tab:truefalseswitch},
+\autopageref{tab:truefalseswitch} as the \PName{simple switch}. The default,
+however, is \OptionValue{chapterprefix}{false}, the opposite
+behaviour\textnote{\KOMAScript{} vs. standard classes} of that of the standard
+classes, which corresponds to \OptionValue{chapterprefix}{true}. These options
+also affect the automatic running heads in the headers (see
+\autoref{sec:\LabelBase.pagestyle},
\DescPageRef{\LabelBase.pagestyle.headings}).
-Sometimes one wishes to have the
-chapter titles in simplified form according to
-\OptionValue{chapterprefix}{false}. But at the same time, one wishes a title
-of an appendix\Index{appendix} to be preceded by a line with ``Appendix''
-followed by the appendix letter. This is achieved by using the
-\Option{appendixprefix} option (see \autoref{tab:truefalseswitch},
-\autopageref{tab:truefalseswitch}). Since this results in an inconsistent
-document layout, I advise against using this option. Final consequence of
-using the option is, that \DescRef{\LabelBase.cmd.appendix} changes setting of option
-\Option{chapterprefix}.
+Sometimes you may want to use the simplified chapter headings produced by
+\OptionValue{chapterprefix}{false} but at the same time to have the heading of
+an appendix\Index{appendix} preceded by a line with ``Appendix'' followed by
+the appendix letter. This is achieved by using the \Option{appendixprefix}
+option (see \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}).
+Since this results in an inconsistent document layout, I advise against using
+this option. Ultimately, this option changes the \Option{chapterprefix} option
+automatically at the beginning of the \DescRef{\LabelBase.cmd.appendix}.
You\ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}} can execute code
depending on the current setting for the chapter preceding line using
\Macro{IfChapterUsesPrefixLine}. If \Option{chapterprefix} is currently
-active, the \PName{then code} will be executed, otherwise the \PName{else
- code}.
+active, the \PName{then code} is executed; otherwise, the \PName{else code} is
+executed.
-\BeginIndex{FontElement}{chapterprefix}\LabelFontElement{chapterprefix}%
-The font style of the chapter number line using
-\OptionValue{chapterprefix}{true} or \OptionValue{appendixprefix}{true} may be
-changed with element
+\BeginIndex{FontElement}{chapterprefix}%
+You can change the font style of the chapter number line that uses
+\OptionValue{chapterprefix}{true} or \OptionValue{appendixprefix}{true}
+by using the
\FontElement{chapterprefix}\ChangedAt{v2.96a}{\Class{scrbook}\and
- \Class{scrreprt}} using commands \DescRef{\LabelBase.cmd.setkomafont} and
-\DescRef{\LabelBase.cmd.addtokomafont} (see
+ \Class{scrreprt}} element with the \DescRef{\LabelBase.cmd.setkomafont} and
+\DescRef{\LabelBase.cmd.addtokomafont} commands (see
\autoref{sec:\LabelBase.textmarkup},
-\DescPageRef{\LabelBase.cmd.setkomafont}). Default is the usage of element
-\DescRef{\LabelBase.fontelement.chapter}\IndexFontElement{chapter} (see
-\DescPageRef{\LabelBase.cmd.chapter}, as well as
+\DescPageRef{\LabelBase.cmd.setkomafont}). The default is to use the
+\DescRef{\LabelBase.fontelement.chapter}\IndexFontElement{chapter} element
+(see \DescPageRef{\LabelBase.cmd.chapter}, as well as
\autoref{tab:\LabelBase.structureElementsFont},
-\autopageref{tab:\LabelBase.structureElementsFont}).%
+\autopageref{tab:\LabelBase.structureElementsFont}).
+
+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}.%
\EndIndexGroup
\begin{Declaration}
- \OptionVName{headings}{selection}
-\end{Declaration}%
-The font size used for the titles\index{title}\index{document structure} is
-relatively big, both with the standard classes and with {\KOMAScript}. Not
-everyone likes this choice; moreover it is especially problematic for small
-paper sizes. Consequently, {\KOMAScript} provides, besides the large title
-font size defined by the
-\OptionValue{headings}{big}\IndexOption{headings~=\PValue{big}}%
+ \OptionVName{headings}{setting}
+\end{Declaration}
+Headings\index{heading}\index{document structure} of sectioning levels
+normally use a relatively large font size in both the standard classes and
+{\KOMAScript}. This choice does not appeal to everyone and is especially
+problematic for small paper sizes. Consequently, {\KOMAScript} provides, in
+addition to the large headings defined by the
+\OptionValue{headings}{big}\IndexOption{headings~=\textKValue{big}}%
\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
-\important[i]{\OptionValue{headings}{big}\\
+\important{\OptionValue{headings}{big}\\
\OptionValue{headings}{normal}\\
- \OptionValue{headings}{small}} option, the two options
-\OptionValue{headings}{normal}\IndexOption{headings~=\PValue{normal}} and
-\OptionValue{headings}{small}\IndexOption{headings~=\PValue{small}}, that
-allow for smaller title font sizes. The font sizes for headings resulting from
-these options for \Class{scrbook} and \Class{scrreprt} are shown in
+ \OptionValue{headings}{small}} option, the options
+\OptionValue{headings}{normal}\IndexOption{headings~=\textKValue{normal}} and
+\OptionValue{headings}{small}\IndexOption{headings~=\textKValue{small}}, which
+allow for smaller headings. The font sizes resulting from these options for
+\Class{scrbook} and \Class{scrreprt} are shown in
\autoref{tab:\LabelBase.structureElementsFont},
-\autopageref{tab:\LabelBase.structureElementsFont}. Respectively, the fonts of
-the elements \DescRef{\LabelBase.fontelement.chapter}%
+\autopageref{tab:\LabelBase.structureElementsFont}. Specifically, all three
+settings reset the elements \DescRef{\LabelBase.fontelement.chapter}%
\IndexFontElement{chapter},
\DescRef{\LabelBase.fontelement.section}\IndexFontElement{section},
\DescRef{\LabelBase.fontelement.subsection}\IndexFontElement{subsection},
@@ -1234,158 +1444,193 @@ the elements \DescRef{\LabelBase.fontelement.chapter}%
\IndexFontElement{subsubsection},
\DescRef{\LabelBase.fontelement.paragraph}\IndexFontElement{paragraph}, and
\DescRef{\LabelBase.fontelement.subparagraph}\IndexFontElement{subparagraph}
-will be reset to these default.
-
-For \Class{scrartcl}, smaller
-font sizes are generally used. \OnlyAt{\Class{scrbook}\and
- \Class{scrreprt}}The spacing before and after chapter titles is also
-influenced by these options.
-
-Chapter\important[i]{\begin{tabular}[t]{@{}l@{}}
- \Option{headings=}\\ \quad\PValue{twolinechapter}\end{tabular}\\
- \begin{tabular}[t]{@{}l@{}}
- \Option{headings=}\\ \quad\PValue{onelinechapter}\end{tabular}\\
- \begin{tabular}[t]{@{}l@{}}
- \Option{headings=}\\ \quad\PValue{twolineappendix}\end{tabular}}
-titles are also influenced by the options
-\OptionValue{headings}{twolinechapter} and
-\OptionValue{headings}{onelinechapter}, that are same as
-\OptionValueRef{\LabelBase}{chapterprefix}{true} and
-\OptionValueRef{\LabelBase}{chapterprefix}{false} (see above). The appendix
-titles are influenced by \OptionValue{headings}{twolineappendix} and
-\OptionValue{headings}{onelineappendix}\important[i]{%
- \begin{tabular}[b]{@{}l@{}}
- \Option{headings=}\\ \quad\PValue{onelineappendix}
- \end{tabular}}, that are the same as the options
-\OptionValueRef{\LabelBase}{appendixprefix}{true} and
-\OptionValueRef{\LabelBase}{appendixprefix}{false} (see also above).
-
-The\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} method of beginning new
-chapters may be switched by \OptionValue{headings}{openany}\important[i]{%
+to the corresponding defaults. \Class{scrartcl}\OnlyAt{\Class{scrbook}\and
+ \Class{scrreprt}} generally uses slightly smaller headings. The spacing
+before and after chapter headings is also reset by these options.
+
+\iffalse%
+ Chapter headings also have the \Option{headings} option with the
+ \PValue{twolinechapter} or \PValue{onelinechapter} settings, which are
+ equivalent to the
+ \OptionValueRef{\LabelBase}{chapterprefix}{true} and
+ \OptionValueRef{\LabelBase}{chapterprefix}{false} options. In the appendix
+ there are additional effects of the \PValue{onelineappendix} and
+ \PValue{twolineappendix} options upon the \Option{headings} option, which
+ corresponds to
+ \OptionValueRef{\LabelBase}{appendixprefix}{false} and
+ \OptionValueRef{\LabelBase}{appendixprefix}{true} (see also
+ above). %
+\else%
+ Chapter headings\OnlyAt{\Class{scrbook}\and\Class{scrreprt}} also
+ have\important{%
+ \OptionValue{headings}{twolinechapter}\\
+ \OptionValue{headings}{onelinechapter}\\
+ \OptionValue{headings}{twolineappendix}\\
+ \OptionValue{headings}{onelineappendix}%
+ } the two options \OptionValue{headings}{twolinechapter} and
+ \OptionValue{headings}{onelinechapter}, which correspond to
+ \OptionValueRef{\LabelBase}{chapterprefix}{true} and
+ \OptionValueRef{\LabelBase}{chapterprefix}{false} explained above. For the
+ appendix,
+ \OptionValueRef{\LabelBase}{appendixprefix}{true} and
+ \OptionValueRef{\LabelBase}{appendixprefix}{false} serve as alternatives for
+ the \OptionValue{headings}{twolineappendix} and
+ \OptionValue{headings}{onelineappendix} options. %
+ \iffalse%
+ For the appendix, \OptionValue{headings}{twolineappendix} and
+ \OptionValue{headings}{onelineappendix} are available, which correspond to
+ the \OptionValueRef{\LabelBase}{appendixprefix}{true} and
+ \OptionValueRef{\LabelBase}{appendixprefix}{false} options (also see above).
+ \fi%
+ Of course, these options do not exist with \Class{scrartcl}%
+ \iffree{}{% Umbruchkorrekturtext
+ , since this class does not have chapters}%
+ .%
+\fi
+
+The\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} \OptionValue{headings}{standardclasses}%
+\important{\OptionValue{headings}{standardclasses}} option adjusts the font
+sizes of the headings to those of the standard classes. In addition, the font
+for the \DescRef{\LabelBase.fontelement.disposition}%
+\IndexFontElement{disposition} element is set to \Macro{bfseries}. It
+therefore no longer uses a sans-serif font for the headings. If you use
+\Class{scrbook}\OnlyAt{\Class{scrbook}\and\Class{scrreprt}} or
+\Class{scrreprt}, \OptionValue{headings}{twolinechapter} is also set and the
+spacing between the chapter headings is adjusted to that of the standard
+classes.
+
+You\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} can set the method to specify
+the page on which new chapters begin with
+\OptionValue{headings}{openany}\important{%
\OptionValue{headings}{openany}\\
\OptionValue{headings}{openright}\\
\OptionValue{headings}{openleft}}, \OptionValue{headings}{openright}, and
-\OptionValue{headings}{openleft} alternatively to option
-\DescRef{\LabelBase.option.open} with the values \PValue{any},
+\OptionValue{headings}{openleft}, or alternatively with the
+\DescRef{\LabelBase.option.open} option, which takes the values \PValue{any},
\PValue{right}, and \PValue{left} (see above).
Another\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} special feature of \KOMAScript{} is the handling of the
-optional argument of the structural commands \DescRef{\LabelBase.cmd.part}, \DescRef{\LabelBase.cmd.chapter},
-etc., down to \DescRef{\LabelBase.cmd.subparagraph}. Function and
-meaning\important[i]{%
- \begin{tabular}[t]{@{}l@{}}
- \Option{headings=}\\\quad\PValue{optiontohead}
- \end{tabular}\\
+optional argument of the sectioning commands \DescRef{\LabelBase.cmd.part},
+\DescRef{\LabelBase.cmd.chapter}, etc. down to
+\DescRef{\LabelBase.cmd.subparagraph}. You can change its function and
+meaning\important{\OptionValue{headings}{optiontohead}\\
\OptionValue{headings}{optiontotoc}\\
- \begin{tabular}[t]{@{}l@{}}
- \Option{headings=}\\\quad\PValue{optiontoheadandtoc}
- \end{tabular}%
-} may be influenced by the options \OptionValue{headings}{optiontohead}%
-\IndexOption{headings~=\PValue{optiontohead}},
-\OptionValue{headings}{optiontotoc}\IndexOption{headings~=\PValue{optiontotoc}},
-and \OptionValue{headings}{optiontoheadandtoc}%
-\IndexOption{headings~=\PValue{optiontoheadandtoc}}.
-
-A summary of all the available selections of option \Option{headings} may be
-found in \autoref{tab:\LabelBase.headings}. Examples are at the following
-description of the structural commands.
-
+ \OptionValue{headings}{optiontoheadandtoc}} with the options
+\OptionValue{headings}{optiontohead}%
+\IndexOption{headings~=\textKValue{optiontohead}},
+\OptionValue{headings}{optiontotoc}%
+\IndexOption{headings~=\textKValue{optiontotoc}} and
+\OptionValue{headings}{optiontoheadandtoc}%
+\IndexOption{headings~=\textKValue{optiontoheadandtoc}}.
+
+See \autoref{tab:\LabelBase.headings} for a summary of all available settings
+for the \Option{headings} option. The explanations of the sectioning commands
+below contain examples using some of these settings.
\begin{desclist}
- \renewcommand*{\abovecaptionskipcorrection}{-\normalbaselineskip}%
- \desccaption[{Available values for option \Option{headings}}]{%
- Available values for option \Option{headings} to select different kinds of
- structural headings%
+ \desccaption[{Available values for the \Option{headings} option}]{%
+ Available values for the \Option{headings} option to format
+ section headings%
\label{tab:\LabelBase.headings}%
}{%
- Available values for option \Option{headings} (\emph{continuation})%
+ Available values for the \Option{headings} option (\emph{continued})%
}%
\pventry{big}{%
- Use very large headings with large distances above and below.
- \IndexOption{headings~=\PValue{big}}}%
+ Use large fonts in the headings for each of the default sectioning levels
+ with wide spacing above and below the titles.
+ \IndexOption{headings~=\textKValue{big}}}%
\pventry{normal}{%
- Use mid-size headings with medium distances above and below.
- \IndexOption{headings~=\PValue{normal}}}%
+ Use medium-sized fonts in the headings with medium spacing above and below
+ the titles. \IndexOption{headings~=\textKValue{normal}}}%
\entry{\PValue{onelineappendix}, \PValue{noappendixprefix},
\PValue{appendixwithoutprefix}, \PValue{appendixwithoutprefixline}%
- \IndexOption{headings~=\PValue{onelineappendix}}}{%
- Chapter headings at the appendix will be set like other headings too.%
+ \IndexOption{headings~=\textKValue{onelineappendix}}}{%
+ Chapter headings in the appendix are set like other headings.%
}%
\entry{\PValue{onelinechapter}, \PValue{nochapterprefix},
\PValue{chapterwithoutprefix}, \PValue{chapterwithoutprefixline}%
- \IndexOption{headings~=\PValue{onelinechapter}}}{%
- Chapter headings will be set like other headings too.%
+ \IndexOption{headings~=\textKValue{onelinechapter}}}{%
+ Chapter titles are set like other headings.%
}%
\pventry{openany}{%
The commands \DescRef{\LabelBase.cmd.cleardoublepageusingstyle},
\DescRef{\LabelBase.cmd.cleardoublestandardpage},
\DescRef{\LabelBase.cmd.cleardoubleplainpage},
\DescRef{\LabelBase.cmd.cleardoubleemptypage}, and
- \DescRef{\LabelBase.cmd.cleardoublepage} behave same like using
- \OptionValue{headings}{openright}.%
- Parts, chapter, index, and back matter use
- \DescRef{\LabelBase.cmd.clearpage} instead of
+ \DescRef{\LabelBase.cmd.cleardoublepage} generate a page break and insert
+ an interleaf page\Index{interleaf page} if needed to reach the next
+ right-hand page in two-sided printing, the same as in
+ \OptionValue{headings}{openright}. Parts, chapter, the index, and back
+ matter use \DescRef{\LabelBase.cmd.clearpage} instead of
\DescRef{\LabelBase.cmd.cleardoublepage}.%
- \IndexOption{headings~=\PValue{openany}}}%
+ \IndexOption{headings~=\textKValue{openany}}}%
\pventry{openleft}{%
The commands \DescRef{\LabelBase.cmd.cleardoublepageusingstyle},
\DescRef{\LabelBase.cmd.cleardoublestandardpage},
\DescRef{\LabelBase.cmd.cleardoubleplainpage},
\DescRef{\LabelBase.cmd.cleardoubleemptypage}, and
- \DescRef{\LabelBase.cmd.cleardoublepage} generate a page break and if
- needed insert an interleaf page to reach the next left-hand page at
- double-page printing.%
- Part, chapter, index and back matter use
+ \DescRef{\LabelBase.cmd.cleardoublepage} generate a page break and insert
+ an interleaf page if needed to reach the next left-hand page in two-sided
+ printing. Part, chapter, index and back matter use
\DescRef{\LabelBase.cmd.cleardoublepage}.%
- \IndexOption{headings~=\PValue{openleft}}}%
+ \IndexOption{headings~=\textKValue{openleft}}}%
\pventry{openright}{%
The commands \DescRef{\LabelBase.cmd.cleardoublepageusingstyle},
\DescRef{\LabelBase.cmd.cleardoublestandardpage},
\DescRef{\LabelBase.cmd.cleardoubleplainpage},
\DescRef{\LabelBase.cmd.cleardoubleemptypage}, and
- \DescRef{\LabelBase.cmd.cleardoublepage} generate a page break and if
- needed insert an interleaf page to reach the next right-hand page at
- double-page printing.%
- Part, chapter, index and back matter use
+ \DescRef{\LabelBase.cmd.cleardoublepage} generate a page break and insert
+ an interleaf page if needed to reach the next right-hand page in two-sided
+ printing. Part, chapter, index and back matter use
\DescRef{\LabelBase.cmd.cleardoublepage}.%
- \IndexOption{headings~=\PValue{openright}}}%
+ \IndexOption{headings~=\textKValue{openright}}}%
\pventry{optiontohead}{%
The\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} advanced functionality of the optional argument of the
- structural commands \DescRef{\LabelBase.cmd.part} down to \DescRef{\LabelBase.cmd.subparagraph} will be
- activated. By default the optional argument will be used for the running
- head only.%
- \IndexOption{headings~=\PValue{optiontohead}}%
+ sectioning commands \DescRef{\LabelBase.cmd.part} down to
+ \DescRef{\LabelBase.cmd.subparagraph} is activated. By default, the
+ optional argument is used only for the running head.%
+ \IndexOption{headings~=\textKValue{optiontohead}}%
}%
\entry{\PValue{optiontoheadandtoc}, \PValue{optiontotocandhead}%
- \IndexOption{headings~=\PValue{optiontoheadandtoc}}}{%
+ \IndexOption{headings~=\textKValue{optiontoheadandtoc}}}{%
The\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} advanced functionality of the optional argument of the
- structural commands \DescRef{\LabelBase.cmd.part} down to \DescRef{\LabelBase.cmd.subparagraph} will be
- activated. By default the optional argument will be used for the running
- head and the table of contents.%
+ sectioning commands \DescRef{\LabelBase.cmd.part} down to
+ \DescRef{\LabelBase.cmd.subparagraph} is activated. By default, the
+ optional argument is used for the running head and the table of contents.%
}%
\pventry{optiontotoc}{%
The\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} advanced functionality of the optional argument of the
- structural commands \DescRef{\LabelBase.cmd.part} down to \DescRef{\LabelBase.cmd.subparagraph} will be
- activated. By default the optional argument will be used for the table of
- contents only.%
- \IndexOption{headings~=\PValue{optiontohead}}%
+ sectioning commands \DescRef{\LabelBase.cmd.part} down to
+ \DescRef{\LabelBase.cmd.subparagraph} is activated. By default, the
+ optional argument is used only for the table of contents.%
+ \IndexOption{headings~=\textKValue{optiontohead}}%
}%
\pventry{small}{%
- Use small headings with small distances above and below.%
- \IndexOption{headings~=\PValue{small}}}%
+ Use small fonts in the headings with small spacing above and below the
+ titles.%
+ \IndexOption{headings~=\textKValue{small}}}%
+ \pventry{standardclasses}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}}%
+ Reset the font settings for each of the standard sectioning levels and use
+ headings with the sizes of the standard classes. For chapter headings,
+ \Class{scrbook} und \Class{scrreprt} set
+ \OptionValue{headings}{twolinechapter}.%
+ }%
\entry{\PValue{twolineappendix}, \PValue{appendixprefix},
\PValue{appendixwithprefix}, \PValue{appendixwithprefixline}%
- \IndexOption{headings~=\PValue{twolineappendix}}}{%
- Chapters at the appendix will be set with a number line with the contents
- of \DescRef{\LabelBase.cmd.chapterformat}\IndexCmd{chapterformat}.%
+ \IndexOption{headings~=\textKValue{twolineappendix}}}{%
+ Chapter titles in the appendix are set with a number line whose format is
+ determined by
+ \DescRef{\LabelBase.cmd.chapterformat}\IndexCmd{chapterformat}.%
}%
\entry{\PValue{twolinechapter}, \PValue{chapterprefix},
\PValue{chapterwithprefix}, \PValue{chapterwithprefixline}%
- \IndexOption{headings~=\PValue{twolinechapter}}}{%
- Chapters will be set with a number line with the contents of
+ \IndexOption{headings~=\textKValue{twolinechapter}}}{%
+ Chapter titles are set with a number line whose format is determined by
\DescRef{\LabelBase.cmd.chapterformat}\IndexCmd{chapterformat}.%
}%
\end{desclist}
@@ -1394,66 +1639,60 @@ description of the structural commands.
\begin{Declaration}
- \OptionVName{numbers}{selection}
+ \OptionVName{numbers}{setting}
\end{Declaration}%
-\begin{Explain}%
- In German, according to {\small DUDEN}, the numbering of sectional
- units should have no period at the end if only arabic numbers are used
- (see \cite[R\,3]{DUDEN}). On the other hand, if roman numerals or
- letters are appear in the numbering, then a period should appear at the
- end of the numbering (see \cite[R\,4]{DUDEN}). {\KOMAScript} has an
- internal mechanism that tries to implement this somewhat complex
- rule. The resulting effect is that, normally, after the sectional
- commands \DescRef{\LabelBase.cmd.part} and \DescRef{\LabelBase.cmd.appendix} a switch is made to
- numbering with an ending period. The information is saved in the
- \File{aux} file and takes effect on the next {\LaTeX} run.
-\end{Explain}
-
-In some cases the mechanism for placing or leaving off the ending period may
-fail, or other languagues may have different
-rules. Therefore\important[i]{\OptionValue{numbers}{endperiod}\\
- \OptionValue{numbers}{noendperiod}} it is possible to activate the use of
-the ending period manually with the option
-\OptionValue{numbers}{endperiod}\IndexOption{numbers~=\PValue{endperiod}} or
-to deactivate it with
-\OptionValue{numbers}{noendperiod}\IndexOption{numbers~=\PValue{noendperiod}}.
-Default is \OptionValue{numbers}{autoendperiod}%
-\IndexOption{numbers~=\PValue{autoendperiod}} with auto detection whether to
-set the period or not.
-
-Please\textnote{Attention!} note that the mechanism only takes effect on the
-next {\LaTeX} run. Therefore, before trying to use these options to forcibly
-control the numbering format, a further run without changing any options
-should be made.
-
-The\textnote{Attention!} available values are summarized in
-\autoref{tab:\LabelBase.numbers}. Unlike most other selections, this
-option may be changed at the document preamble, before
-\Macro{begin}\PParameter{document}, only.
+According to {\small DUDEN}, if only Arabic numerals are used to number
+section headings\Index{headings}, the German practice is to have no point at
+the end (see \cite[R\,3]{DUDEN}). On the other hand, if Roman numerals or
+letters appear in the numbering, then a point should appear at the end of the
+numbering (see \cite[R\,4]{DUDEN}). {\KOMAScript} has a mechanism that tries
+to automate this somewhat complex rule. The result is that normally after
+the sectioning commands \DescRef{\LabelBase.cmd.part} and
+\DescRef{\LabelBase.cmd.appendix} the numbering switches to using a final
+point. This information is saved in the \File{aux} file and takes effect on
+the next {\LaTeX} run.
+
+Sometimes the mechanism for placing or omitting the final point may fail.
+Sometimes other languages have different rules. Therefore you can force the
+use of the final point with the option
+\OptionValue{numbers}{endperiod}\IndexOption{numbers~=\textKValue{endperiod}}%
+\important{\OptionValue{numbers}{endperiod}\\
+\OptionValue{numbers}{noendperiod}} or to prohibit it with
+\OptionValue{numbers}{noendperiod}.
+
+Note\textnote{Attention!} that this mechanism only takes effect on the
+next {\LaTeX} run. Therefore, before you try to use these options to force
+the correct numbering format, you should always perform another \LaTeX{} run
+without modifying the document.
+
+You can find a summary of the available values for the \PName{setting} of
+\PName{numbers} in \autoref{tab:\LabelBase.numbers}. Unlike most other
+settings, this option can only be set in the document preamble, i.\,e. before
+\Macro{begin}\PParameter{document}.
\begin{table}
- \caption[{Available values of option \Option{numbers}}]{Available values of
- option \Option{numbers} for selection of the period at the end of numbers
- of structural headings}
+ \caption[{Available values for the \Option{numbers} option}]{Available values
+ of the \Option{numbers} option to configure the final points of the
+ numbers for section headings}
\label{tab:\LabelBase.numbers}
\begin{desctabular}
\entry{\PValue{autoendperiod}, \PValue{autoenddot}, \PValue{auto}}{%
- \KOMAScript{} decides, whether or not to set the period at the end of
- the numbers. The numbers consists in Arabic digits only, the period will
- be omitted. If there are alphabetic characters or roman numbers the
- period will always be set. References to numbers will be set without
- ending period always.%
- \IndexOption{numbers~=\PValue{autoendperiod}}}%
+ \KOMAScript{} decides whether to set the point at the end of sectioning
+ command numbers. If there are only Arabic numerals, the point will
+ be omitted. If a letter or Roman numeral is found, the
+ point is set. However, references to these numbers are set without
+ a final point.%
+ \IndexOption{numbers~=\textKValue{autoendperiod}}}%
\entry{\PValue{endperiod}, \PValue{withendperiod}, \PValue{periodatend},
\PValue{enddot}, \PValue{withenddot}, \PValue{dotatend}}{%
- All numbers of structural commands and all dependent numbers will be set
- with ending period. Only references will be set without the ending
- period.%
- \IndexOption{numbers~=\PValue{endperiod}}}%
+ All numbers of sectioning commands and their subordinate numbers are set
+ with a final point. Only references will be set without the final
+ point.%
+ \IndexOption{numbers~=\textKValue{endperiod}}}%
\entry{\PValue{noendperiod}, \PValue{noperiodatend},
\PValue{noenddot}, \PValue{nodotatend}}{%
- All the numbers are without ending period.%
- \IndexOption{numbers~=\PValue{noendperiod}}}%
+ All numbers of sectioning commands are set without a final point.%
+ \IndexOption{numbers~=\textKValue{noendperiod}}}%
\end{desctabular}
\end{table}
%
@@ -1466,27 +1705,36 @@ option may be changed at the document preamble, before
\end{Declaration}%
As mentioned in \autoref{sec:\LabelBase.floats},
\DescPageRef{\LabelBase.option.listof}\OnlyAt{\Class{scrbook}\and
- \Class{scrreprt}}, normally, every chapter entry generated with
-\DescRef{\LabelBase.cmd.chapter} introduces vertical spacing into the lists of floats. Since
-version~2.96a\ChangedAt{v2.96a}{\Class{scrbook}\and \Class{scrreprt}} this
-applies also for the command \DescRef{\LabelBase.cmd.addchap}, if no compatibility option to an
-earlier version was chosen (see option \DescRef{\LabelBase.option.version} in
+ \Class{scrreprt}}, every chapter that is created with
+\DescRef{\LabelBase.cmd.chapter} normally inserts a vertical space in the
+lists of floating environments (e.\,g., tables and figures).
+Since version~2.96a,\important{\OptionValueRef{\LabelBase}{version}{2.96a}}%
+\ChangedAt{v2.96a}{\Class{scrbook}\and \Class{scrreprt}} this also applies to
+the \DescRef{\LabelBase.cmd.addchap} command unless you choose a compatibility
+setting for an earlier version (see the \DescRef{\LabelBase.option.version}
+option in \autoref{sec:\LabelBase.compatibilityOptions},
+\DescPageRef{\LabelBase.option.version}).
+
+In addition, you can use the \Option{chapteratlists} option to change the
+vertical spacing by specifying the desired distance as the \PName{value}.
+The default with \OptionValueRef{\LabelBase}{listof}{chaptergapsmall}%
+\IndexOption{listof~=\textKValue{chaptergapsmall}} %
+is 10\Unit{pt} (see the\DescRef{\LabelBase.option.version} option in
\autoref{sec:\LabelBase.compatibilityOptions},
\DescPageRef{\LabelBase.option.version}).
-Furthermore, now the option \Option{chapteratlists} can be used to change the
-spacing, by passing the desired distance as \PName{value}. The default setting
-with \OptionValueRef{\LabelBase}{listof}{chaptergapsmall}%
-\IndexOption{listof~=\PValue{chaptergapsmall}} %
-is 10\,pt. If \OptionValue{chapteratlists}{entry}%
-\IndexOption{chapteratlists~=\PValue{entry}}%
+If you use \OptionValue{chapteratlists}{entry}%
+\IndexOption{chapteratlists~=\textKValue{entry}}%
\important{\OptionValue{chapteratlists}{entry}} or \Option{chapteratlists}
-without value is specified, then instead of a vertical distance, the chapter
-entry itself will be entered into the lists. This will be done even if
-there's no floating environment inside of the chapter.
-
-Please\textnote{Attention!} note that changes to the option will only become
-effective in the lists following two more {\LaTeX} runs.%
+without specifying a value, instead of a vertical space, the chapter entry
+itself will be entered into the lists. Note that such an entry occurs even if
+the chapter does not contain a floating environment. A method where only
+chapters with floating environments are displayed in the respective list can
+be found in the German-language \KOMAScript{} forum at
+\cite{https://komascript.de/comment/5070}.
+
+Please\textnote{Attention!} note that changes to this option only takes
+effect after two additional {\LaTeX} runs.%
%
\EndIndexGroup
@@ -1503,218 +1751,227 @@ effective in the lists following two more {\LaTeX} runs.%
\Index[indexmain]{part}%
\Index[indexmain]{chapter}%
\Index[indexmain]{section}%
-The standard sectioning commands in {\KOMAScript} work in a similar
-fashion to those of the standard classes. Thus, an alternative entry
-for the table of contents and running headings can be specified as an
-optional argument to the sectioning commands.
-
-In addition to this, with\ChangedAt{v3.10}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}}\textnote{\KOMAScript{} vs. standard
- classes} option \important{\DescRef{\LabelBase.option.headings}}
+The standard sectioning commands in {\KOMAScript} work the same way as those
+in the standard classes. Thus, you can specify an alternative text for the
+table of contents and running heads as an optional argument to the sectioning
+commands.
+
+However, with\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}\textnote{\KOMAScript{} vs. standard classes} the
+\important{\DescRef{\LabelBase.option.headings}}
\OptionValueRef{\LabelBase}{headings}{optiontohead}%
-\IndexOption[indexmain]{headings~=\PValue{optiontohead}}, \KOMAScript{}
-does not use
-the optional argument \PName{short version} at the table of
-contents, but for the running head only. Nevertheless, such a running head
-needs an appropriate page style. See \autoref{sec:\LabelBase.pagestyle} and
-\autoref{cha:scrlayer-scrpage} about this. With option
+\IndexOption[indexmain]{headings~=\textKValue{optiontohead}} option,
+\KOMAScript{} only uses the optional argument \PName{short version} in the
+running head, not the table of contents. Of course, this text will only appear
+if you use a page style\Index{page>style} that puts the corresponding
+sectioning level in the running head. See \autoref{sec:\LabelBase.pagestyle}
+and \autoref{cha:scrlayer-scrpage}. With the
\OptionValueRef{\LabelBase}{headings}{optiontotoc}%
-\IndexOption[indexmain]{headings~=\PValue{optiontotoc}}, \KOMAScript{} does not
-use the
-optional argument \PName{short version} for the running head, but
-at the table of contents. Nevertheless, the entry will be shown only if
-counter \DescRef{\LabelBase.counter.tocdepth} (see \autoref{sec:\LabelBase.toc},
-\DescPageRef{\LabelBase.counter.tocdepth}) is great enough. With option
+\IndexOption[indexmain]{headings~=\textKValue{optiontotoc}} option,
+\KOMAScript{} uses the optional argument \PName{short version} exclusively for
+the table of contents and not the running head. However, the entry will be
+shown only if the \DescRef{\LabelBase.counter.tocdepth} counter is great
+enough (see \autoref{sec:\LabelBase.toc},
+\DescPageRef{\LabelBase.counter.tocdepth}). With the
\OptionValueRef{\LabelBase}{headings}{optiontoheadandtoc}%
-\IndexOption[indexmain]{headings~=\PValue{optiontoheadandtoc}}, \KOMAScript{}
-uses the optional argument \PName{short version} in both the table of contents
-and running head. All these three selections will also activate the extended
-interpretation of the optional argument \PName{short version}, which is not
-active by default.
+\IndexOption[indexmain]{headings~=\textKValue{optiontoheadandtoc}} option,
+\KOMAScript{} uses the optional argument \PName{short version} in both the
+table of contents and the running head. These three options all activate the
+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
-determines whether there's an equality sign in \PName{short version}. If so,
-the optional argument will be interpreted as \PName{option list} instead of
-simple \PName{short version}. Thereby the three options
-\OptionVName{head}{running head}\important{\Option{head}},
-\OptionVName{tocentry}{table of contents entry}\important{\Option{tocentry}},
-and \OptionVName{reference}{reference title}\important{\Option{reference}}%
-\ChangedAt{v3.22}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}
-are supported. Commas or equality signs inside of the values of those options
-will be accepted only if they are enclosed by braces.
-
-Please\textnote{Attention!} note that this mechanism is only
-functional as long as \KOMAScript{} controls the described
-commands. From using a package that controls the sectioning commands
-or the internal \LaTeX{} kernel commands for sectioning commands,
-\KOMAScript{} can no longer provide this extended mechanism. This is
-also valid for the always active extension of \KOMAScript{} to not
-create entries to the table of contents % if the heading text
-if the text of the
-entry is empty. If you really want an entry with empty heading text,
-you may use an invisible entry like \lstinline|\mbox{}| instead.
+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
+\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.
+
+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{}|.
\begin{Example}
- Assume you're writing a document with some very extensive chapter
- headings. These headings should be shown in the table of contents too. But
- for the running head you want only single-line short headings. You will do
- this using the optional argument of \Macro{chapter}.
+ Suppose you have a document with very long chapter headings. These headings
+ should appear in the table of contents, but you want to limit the running
+ head to short, single-line headings. You can do this with the optional
+ argument of \Macro{chapter}.
\begin{lstcode}
\chapter[short version of chapter heading]
- {The Structural Sectioning Command
- for Chapters Supports not only the
- Heading Text itself but also a
- Short Version with Selectable
- Usage}
+ {The Sectioning Command for Chapters
+ Supports not only the Heading Text
+ Itself but also a Short Version Whose
+ Use can be Controlled}
\end{lstcode}
- Sometimes later you become aware that the automatic line breaking of this
- heading is somehow inappropriate. Therefore you want to make the breaking
- yourself. Nevertheless, the automatic line breaking should be still used at
- the table of contents. With
+ A little later you realize that the line breaks for this long heading are
+ very inappropriate. You therefore want to choose the breaks
+ yourself. Nevertheless, you still want automatic line breaking in the table
+ of contents. With
\begin{lstcode}
\chapter[head={short version of chapter heading},
- tocentry={The Structural Sectioning
+ tocentry={The Sectioning
Command for Chapters Supports not
- only the Heading Text itself but
- also a Short Version with
- Selectable Usage}]
- {The Structural\\
- Sectioning Command for Chapters\\
+ only the Heading Text Itself but
+ also a Short Version Whose Use
+ can be Controlled}]
+ {The Sectioning\\
+ Command for Chapters\\
Supports not only\\
- the Heading Text itself\\
+ the Heading Text Itself\\
but also\\
- a Short Version\\
- with Selectable Usage}
+ a Short Version Whose\\
+ Use can be Controlled}
\end{lstcode}
- you use independent entries for table of contents, running head, and the
+ you create separate entries for the table of contents, running head, and
chapter heading itself. The arguments of the options \Option{head} and
- \Option{tocentry} have been enclosed into braces, so the contents of the
- options cannot influence the interpretation of the optional argument.
+ \Option{tocentry} have been enclosed in braces so their contents
+ can be arbitrary.
- The recommendation of the braces in the example above will make more sense
- with one more example. Assume you're using option
- \OptionValueRef{\LabelBase}{headings}{optiontotoc} and now have a heading:
+ The need for braces in the example above is best illustrated by another
+ example. Suppose you chose the
+ \OptionValueRef{\LabelBase}{headings}{optiontotoc} option and set the title
+ this way:
\begin{lstcode}
\section[head=\emph{value}]
{Option head=\emph{value}}
\end{lstcode}
- This would result in the entry ``Option head=\emph{value}'' at the table of
- contents but ``\emph{value}'' at the running head. But surely you wanted the
- entry ``head=\emph{value}'' at the table of contents and the complete
- heading text at the running head. You may do this using braces:
+ This results in the entry ``Option head=\emph{value}'' in the table of
+ contents but ``\emph{value}'' in the running head. But surely you wanted the
+ entry ``head=\emph{value}'' in the table of contents and the complete
+ heading text in the running head. You can do this using braces:
\begin{lstcode}
\section[head{=}\emph{value}]
{Option head=\emph{value}}
\end{lstcode}
- A similar case would be a comma. With the same
- \DescRef{\LabelBase.option.headings} option like before:
+ A similar case concerns the comma. Using the same
+ \DescRef{\LabelBase.option.headings} option as before
\begin{lstcode}
\section[head=0, 1, 2, 3, \dots]
{Natural Numbers Including the Zero}
\end{lstcode}
- would result in an error, because the comma would be interpreted as the
- separator between the single options of the option list %
+ results in an error because the comma is interpreted as the
+ separator between the individual options of the option list %
``\lstinline|0, 1, 2, 3, \dots|''. But writing
\begin{lstcode}
\section[head={0, 1, 2, 3, \dots}]
{Natural Numbers Including the Zero}
\end{lstcode}
- will change ``\lstinline|0, 1, 2, 3, \dots|'' into the argument of
- option \Option{head}.
+ makes ``\lstinline|0, 1, 2, 3, \dots|'' the argument of
+ the \Option{head} option.
\end{Example}
-Similar\ChangedAt{v3.22}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} to setup the title of a running head using option
-\Option{head} or to setup the title for the entry to the table of contents
-using option \Option{tocentry} you can set the title of a reference with
-package \Package{nameref}\IndexPackage{nameref},
-\Package{titleref}\IndexPackage{titleref}, or the
-\Package{titleref}\IndexPackage{zref-titleref} module of package
-\Package{zref}\IndexPackage{zref} using option \Option{reference}. Note, the
-support for package \Package{titleref} is somehow rudimentary, and the package
-is not fully compatible with \Package{hyperref}\IndexPackage{hyperref}.
-
-The title of the level part\important{\Macro{part}} (\Macro{part}) is
-distinguished from other sectioning levels by being numbered independently
-from the other parts. This means that the chapter level (in \Class{scrbook} or
-\Class{scrreprt}), or the section level (in \Class{scrartcl}) is numbered
-consecutively over all parts. Furthermore, for classes
-\Class{scrbook}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} and
-\Class{scrreprt}, the title of the part level together with the corresponding
-preamble (see \Macro{setpartpreamble},
+Like\ChangedAt{v3.22}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} setting the title of a running head with the \Option{head}
+option, or setting the title of a table-of-contents entry with the
+\Option{tocentry} option, you can set the title of a reference with the
+\Package{nameref}\IndexPackage{nameref}\important{\Package{nameref}\\
+ \Package{titleref}\\
+ \Package{zref-titleref}} or
+\Package{titleref}\IndexPackage{titleref} packages, or with the
+\Package{titleref}\IndexPackage{zref-titleref} module of the
+\Package{zref}\IndexPackage{zref} package, using the \Option{reference}%
+\important{\Option{reference}} option. Note that the support for the
+\Package{titleref} package is rather rudimentary, since that package's
+performance is poor compared to the other two, and it is not fully compatible
+with \Package{hyperref}\IndexPackage{hyperref}\important{\Package{hyperref}}.
+
+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
+\Class{scrartcl}) is numbered consecutively over all parts. Furthermore, for
+the \Class{scrbook}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} and
+\Class{scrreprt} classes, the title of the part level together with the
+corresponding preamble (see \DescRef{\LabelBase.cmd.setpartpreamble},
\DescPageRef{\LabelBase.cmd.setpartpreamble}) is set on a separate page.
-\Macro{chapter}\important{\Macro{chapter}}\OnlyAt{\Class{scrbook}\and
- \Class{scrreprt}} only exists in book or report classes, that is, in classes
-\Class{book}, \Class{scrbook}, \Class{report} and \Class{scrreport}, but not
-in the article classes \Class{article} and \Class{scrartcl}. In addition to
-this, the command \Macro{chapter} in {\KOMAScript} differs substantially from
-the version in the standard class. In the standard classes the chapter number
-is used together with the prefix ``Chapter'', or the corresponding word in the
-appropriate language, on a separate line above the actual chapter title
-text. This overpowering\important[i]{\DescRef{\LabelBase.option.chapterprefix}\\
- \DescRef{\LabelBase.option.appendixprefix}} style is replaced in {\KOMAScript} by a simple
-chapter number before the chapter heading text, but can be reverted by the
-option \DescRef{\LabelBase.option.chapterprefix} (see
+The \Macro{chapter}\important{\Macro{chapter}}\OnlyAt{\Class{scrbook}\and
+ \Class{scrreprt}} command only exists in the book and report classes, that
+is, in \Class{book}, \Class{scrbook}, \Class{report} and \Class{scrreport},
+but not in the article classes \Class{article} and \Class{scrartcl}.
+Furthermore, the \Macro{chapter}\textnote{\KOMAScript{} vs. standard classes}
+command in {\KOMAScript} differs substantially from the version in the
+standard classes. In the standard classes, the chapter number is used together
+with the prefix ``Chapter'', or the corresponding word in the appropriate
+language, on a separate line above the actual chapter title text.
+\KOMAScript{} replaces this
+overpowering\important{\DescRef{\LabelBase.option.chapterprefix}\\
+ \DescRef{\LabelBase.option.appendixprefix}} style with a simple chapter
+number before the chapter title, but you can restore the original behaviour
+with the \DescRef{\LabelBase.option.chapterprefix} option (see
\DescPageRef{\LabelBase.option.chapterprefix}).
-Please\textnote{Attention!} note that \Macro{part} and \Macro{chapter} in
-classes \Class{scrbook} and \Class{scrreprt}
-\OnlyAt{\Class{scrbook}\and\Class{scrreprt}} change the page style for one
-page. The applied page style in {\KOMAScript} is defined in the macros
-\DescRef{\LabelBase.cmd.partpagestyle} and \DescRef{\LabelBase.cmd.chapterpagestyle} (see
+Please\textnote{Attention!} note that \Macro{part} and \Macro{chapter} in the
+\Class{scrbook} and \Class{scrreprt}
+\OnlyAt{\Class{scrbook}\and\Class{scrreprt}} classes change the page style for
+one page. The page style applied in {\KOMAScript} is defined in the macros
+\DescRef{\LabelBase.cmd.partpagestyle} and
+\DescRef{\LabelBase.cmd.chapterpagestyle} (see
\autoref{sec:\LabelBase.pagestyle},
\DescPageRef{\LabelBase.cmd.titlepagestyle}).
+\BeginIndexGroup
\BeginIndex[indexother]{}{font}%
\BeginIndex[indexother]{}{font>style}%
\BeginIndex[indexother]{}{font>size}%
\BeginIndex{FontElement}{part}\LabelFontElement{part}%
\BeginIndex{FontElement}{partnumber}\LabelFontElement{partnumber}%
\BeginIndex{FontElement}{chapter}\LabelFontElement{chapter}%
+\BeginIndex{FontElement}{chapterprefix}\LabelFontElement{chapterprefix}%
\BeginIndex{FontElement}{section}\LabelFontElement{section}%
\BeginIndex{FontElement}{subsection}\LabelFontElement{subsection}%
\BeginIndex{FontElement}{subsubsection}\LabelFontElement{subsubsection}%
\BeginIndex{FontElement}{paragraph}\LabelFontElement{paragraph}%
\BeginIndex{FontElement}{subparagraph}\LabelFontElement{subparagraph}%
\BeginIndex{FontElement}{disposition}\LabelFontElement{disposition}%
-The font of all headings\ChangedAt{v2.8p}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}} can be changed with the commands
+You\ChangedAt{v2.8p}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} can change the font style for all headings with the
\DescRef{\LabelBase.cmd.setkomafont}\IndexCmd{setkomafont} and
-\DescRef{\LabelBase.cmd.addtokomafont}\IndexCmd{addtokomafont} (see
+\DescRef{\LabelBase.cmd.addtokomafont}\IndexCmd{addtokomafont} commands (see
\autoref{sec:\LabelBase.textmarkup},
-\DescPageRef{\LabelBase.cmd.setkomafont}). In doing this, generally the
-element \FontElement{disposition}\important{\FontElement{disposition}} is
-used, followed by a specific element\important[s]{%
+\DescPageRef{\LabelBase.cmd.setkomafont}). In doing so, the element
+\FontElement{disposition}\important{\FontElement{disposition}} is applied
+first, followed by the specific element\important{%
\FontElement{part}\\
\FontElement{chapter}\\
\FontElement{section}\\
\FontElement{subsection}\\
\FontElement{paragraph}\\
- \FontElement{subparagraph}} for every section level (see
+ \FontElement{subparagraph}} for each sectioning level (see
\autoref{tab:\LabelBase.fontelements},
-\autopageref{tab:\LabelBase.fontelements}). There is a separate element
-\FontElement{partnumber} for the number part of parts. The font for the
-element \FontElement{disposition} is predefined as
+\autopageref{tab:\LabelBase.fontelements}). There is a separate elements,
+\FontElement{partnumber}, for the number of the part heading, and
+\FontElement{chapterprefix}, for the optional prefix line of chapter headings.
+The initial definition for the \FontElement{disposition} element is
\Macro{normalcolor}\linebreak[2]\Macro{sffamily}\linebreak[2]\Macro{bfseries}.
-The default font size for the specific elements depends on the options
+The default font sizes for the specific elements depends on the options
\OptionValueRef{\LabelBase}{headings}{big},
-\OptionValueRef{\LabelBase}{headings}{normal} and
+\OptionValueRef{\LabelBase}{headings}{normal}, and
\OptionValueRef{\LabelBase}{headings}{small} (see
-\DescPageRef{\LabelBase.option.headings}). The defaults are listed in
+\DescPageRef{\LabelBase.option.headings}). They are listed in
\autoref{tab:\LabelBase.structureElementsFont}.
-%
+% Umbruchkorrektur: Tabelle verschoben
\begin{table}
% \centering%
+% \caption
\KOMAoptions{captions=topbeside}%
\setcapindent{0pt}%
-% \caption
\begin{captionbeside}[{Default font sizes for different levels of document
- structuring}]{Default font sizes for different levels of document
- structuring in \Class{scrbook} and \Class{scrreprt}}[l]
+ sectioning}]{%
+ \label{tab:\LabelBase.structureElementsFont}%
+ Default font sizes for different levels of document sectioning in
+ \Class{scrbook} and \Class{scrreprt}}[l]
\begin{tabular}[t]{lll}
\toprule
Class Option & Element & Default\\
@@ -1727,6 +1984,9 @@ The default font size for the specific elements depends on the options
& \Macro{huge} \\
& \DescRef{\LabelBase.fontelement.chapter}\IndexFontElement{chapter}
& \Macro{huge} \\
+ & \DescRef{\LabelBase.fontelement.chapterprefix}%
+ \IndexFontElement{chapterprefix}
+ & \DescRef{\LabelBase.cmd.usekomafont}\PParameter{chapter} \\
& \DescRef{\LabelBase.fontelement.section}\IndexFontElement{section}
& \Macro{Large} \\
& \DescRef{\LabelBase.fontelement.subsection}%
@@ -1744,6 +2004,8 @@ The default font size for the specific elements depends on the options
& \DescRef{\LabelBase.fontelement.part} & \Macro{huge} \\
& \DescRef{\LabelBase.fontelement.partnumber} & \Macro{huge} \\
& \DescRef{\LabelBase.fontelement.chapter} & \Macro{LARGE} \\
+ & \FontElement{chapterprefix}\IndexFontElement{chapterprefix}
+ & \DescRef{\LabelBase.cmd.usekomafont}\PParameter{chapter} \\
& \DescRef{\LabelBase.fontelement.section} & \Macro{Large} \\
& \DescRef{\LabelBase.fontelement.subsection} & \Macro{large} \\
& \DescRef{\LabelBase.fontelement.subsubsection} & \Macro{normalsize} \\
@@ -1753,6 +2015,8 @@ The default font size for the specific elements depends on the options
& \DescRef{\LabelBase.fontelement.part} & \Macro{LARGE} \\
& \DescRef{\LabelBase.fontelement.partnumber} & \Macro{LARGE} \\
& \DescRef{\LabelBase.fontelement.chapter} & \Macro{Large} \\
+ & \FontElement{chapterprefix}\IndexFontElement{chapterprefix}
+ & \DescRef{\LabelBase.cmd.usekomafont}\PParameter{chapter} \\
& \DescRef{\LabelBase.fontelement.section} & \Macro{large} \\
& \DescRef{\LabelBase.fontelement.subsection} & \Macro{normalsize} \\
& \DescRef{\LabelBase.fontelement.subsubsection} & \Macro{normalsize} \\
@@ -1761,250 +2025,331 @@ The default font size for the specific elements depends on the options
\bottomrule
\end{tabular}
\end{captionbeside}
- \label{tab:\LabelBase.structureElementsFont}
\end{table}
-
+%
\begin{Example}
- Suppose you are using the class option
- \OptionValueRef{\LabelBase}{headings}{big} and notice that the very big
- headings of document parts are too bold. You could change this as follows:
+ Suppose you use the \OptionValueRef{\LabelBase}{headings}{big} class option
+ and notice that the very large headings of the document parts are too bold.
+ You could change this as follows:
\begin{lstcode}
\setkomafont{disposition}{\normalcolor\sffamily}
\part{Appendices}
\addtokomafont{disposition}{\bfseries}
\end{lstcode}
Using the command above you only switch off the font attribute
-\textbf{bold} for a heading ``Appendices''. A much more comfortable
+\textbf{bold} for a heading ``Appendices''. A much more convenient
and elegant solution is to change all \Macro{part} headings at once.
This is done either by:
\begin{lstcode}
\addtokomafont{part}{\normalfont\sffamily}
\addtokomafont{partnumber}{\normalfont\sffamily}
\end{lstcode}
- or simply using:
+ or simply:
\begin{lstcode}
\addtokomafont{part}{\mdseries}
\addtokomafont{partnumber}{\mdseries}
\end{lstcode}
-The last version is to be preferred because it gives you the correct result
-even when you make changes to the \DescRef{\LabelBase.fontelement.disposition}
+The second version is preferred because it gives you the correct result
+even if you change the \DescRef{\LabelBase.fontelement.disposition}
element\IndexFontElement{disposition}, for instance:
\begin{lstcode}
\setkomafont{disposition}{\normalcolor\bfseries}
\end{lstcode}
- With this change it is possible to set all section levels at once to no
+ With this change, it is possible to set all section levels at once to no
longer use sans serif fonts.
\end{Example}
-Please be warned of misusing the possibilities of font switching to
-mix fonts, font sizes and font attributes excessively. Picking the
-most suitable font for a given task is a hard task even for
-professionals and has almost nothing to do with the personal tastes of
-non-experts. Please refer to the citation at the end of
-\autoref{sec:typearea.tips}, \autopageref{sec:typearea.tips.cite} and
-to the following explanation.
+I strongly advise against using the ability to switch fonts in order to mix
+fonts, font sizes, and font attributes wildly. Picking the right font for the
+job is a matter for experts and has almost nothing to do with the personal
+tastes of non-experts. See the citation at the end of
+\autoref{sec:typearea.tips}, \autopageref{sec:typearea.tips.cite} and to the
+following explanation.
\begin{Explain}
- It is possible to use different font types for different section
- levels in {\KOMAScript}. Non-experts in typography should for very
- good typographical reasons refrain absolutely from using these
- possibilities.
-
- There is a rule in typography which states that one should mix as
- few fonts as possible. Using sans serif for headings already seems
- to be a breach of this rule. However, one should know that bold,
- large serif letters are much too heavy for headings. Strictly
- speaking, one would then have to at least use a normal instead of a
- bold or semi-bold font. However, in deeper levels of the structuring,
- a normal font may then appear too lightly weighted. On the other
- hand, sans serif fonts in headings have a very pleasant appearance
- and in fact find acceptance almost solely for headings. That is why
- sans serif is the carefully chosen default in {\KOMAScript}.
-
- More variety should, however, be avoided. Font mixing is only for
- professionals. In case you want to use other fonts than the standard {\TeX}
- fonts\,---\,regardless of whether these are CM\Index{CM fonts}, EC\Index{EC
- fonts}, or LM fonts\Index{LM fonts}\,---\,you should consult an expert, or
- for safety's sake redefine the font for the element
+ It is possible to use different font types for different sectioning
+ levels in {\KOMAScript}. Non-experts in typography should absolutely avoid
+ doing so for excellent typographical reasons.
+
+ A rule of typography states that you should mix as few fonts as possible.
+ Using sans serif for headings already seems to violate this rule. However,
+ you should realize that large, bold, serif letters are much too heavy for
+ headings. Strictly speaking, you should then use a normal instead of a bold
+ or semi-bold font. However, in deeper levels of the sectioning, a normal
+ font may then appear too light. On the other hand, sans serif fonts have a
+ very pleasant appearance in headings, and almost solely in headings. There
+ is, therefore, good reason why sans serif is the default in {\KOMAScript}.
+
+ Greater variety should, however, be avoided. Font mixing is something for
+ professionals. For this reason, if you want to use fonts other than the
+ standard {\TeX} fonts\,---\,regardless of whether these are CM\Index{CM
+ fonts}, EC\Index{EC fonts}, or LM fonts\Index{LM fonts}\,---\,you should
+ consult an expert about the compatibility of the sans serif and serif fonts,
+ or redefine the element
\DescRef{\LabelBase.fontelement.disposition}\IndexFontElement{disposition}
- as seen in the example above. The author of this documentation considers the
- commonly encountered combinations Times and Helvetica or Palatino with
- Helvetica as unfavourable.
+ as a precautionary measure. The author considers the commonly encountered
+ combinations of Times and Helvetica or Palatino with Helvetica to be
+ awkward.
\end{Explain}
+\EndIndexGroup
%
\EndIndexGroup
\begin{Declaration}
- \Macro{part*}\Parameter{Heading}%
- \Macro{chapter*}\Parameter{Heading}%
- \Macro{section*}\Parameter{Heading}%
- \Macro{subsection*}\Parameter{Heading}%
- \Macro{subsubsection*}\Parameter{Heading}%
- \Macro{paragraph*}\Parameter{Heading}%
- \Macro{subparagraph*}\Parameter{Heading}
+ \Macro{part*}\Parameter{heading}%
+ \Macro{chapter*}\Parameter{heading}%
+ \Macro{section*}\Parameter{heading}%
+ \Macro{subsection*}\Parameter{heading}%
+ \Macro{subsubsection*}\Parameter{heading}%
+ \Macro{paragraph*}\Parameter{heading}%
+ \Macro{subparagraph*}\Parameter{heading}
\end{Declaration}%
-All disposition commands have starred versions, which are
-unnumbered\Index{numbering}, and produce section headings which do not
-show up in the table of contents\Index{table>of contents}\Index{contents>table
- of} or in the
-running heading\Index{header}. The absence of a running heading often
-has an unwanted side effect. For example, if a chapter which is set
-using \Macro{chapter*} spans several pages, then the running heading
-of the previous chapter suddenly reappears. {\KOMAScript} offers a
-solution for this which is described
-below. \OnlyAt{\Class{scrbook}\and\Class{scrreprt}}\Macro{chapter*}
-only exists in book and report classes, that is, \Class{book},
-\Class{scrbook}, \Class{report} and \Class{scrreport}, but not the
-article classes \Class{article} and \Class{scrartcl}.
-
-Please\textnote{Attention!} note that \DescRef{\LabelBase.cmd.part} and \DescRef{\LabelBase.cmd.chapter} change
-the page style for one page. The applied style is defined in the macros
-\DescRef{\LabelBase.cmd.partpagestyle} and
-\DescRef{\LabelBase.cmd.chapterpagestyle} in {\KOMAScript} (see
-\autoref{sec:\LabelBase.pagestyle}, \DescPageRef{\LabelBase.cmd.titlepagestyle}).
-
-As for the possibilities of font switching\ChangedAt{v2.8p}{%
- \Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}}, %
-the same explanations apply as were given above for the unstarred
-variants. The structuring elements are named the same since they do
-not indicate variants but structuring levels.%
+The starred variants of all sectioning commands produce
+unnumbered\Index{numbering} headings which do not appear in the table of
+contents\Index{table>of contents}\Index{contents>table of} or in the running
+head\Index{running head}. The absence of a running head often has an unwanted
+side effect. If, for example, a chapter set using \Macro{chapter*} spans
+several pages, then the running head of the previous chapter suddenly
+reappears. {\KOMAScript} offers a solution for this problem, described below.
+\Macro{chapter*}\OnlyAt{\Class{scrbook}\and\Class{scrreprt}} only exists in
+book and report classes, that is, \Class{book}, \Class{scrbook},
+\Class{report} and \Class{scrreport}, not in the article classes
+\Class{article} and \Class{scrartcl}.
+
+Please\textnote{Attention!} note that \DescRef{\LabelBase.cmd.part} and
+\DescRef{\LabelBase.cmd.chapter} change the page style for one page. While the
+standard classes use the \PageStyle{plain} page style, {\KOMAScript} applies
+the style defined in the \DescRef{\LabelBase.cmd.partpagestyle} and
+\DescRef{\LabelBase.cmd.chapterpagestyle} macros (see
+\autoref{sec:\LabelBase.pagestyle},
+\DescPageRef{\LabelBase.cmd.titlepagestyle}).
+
+The possibilities for switching fonts\ChangedAt{v2.8p}{%
+ \Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}} %
+described above for the unstarred variants apply without change. The elements
+use the same names since they do not indicate variants but structuring
+levels.%
%
\EndIndexGroup
-\iftrue% Umbruchkorrekturtext
-In the standard classes\textnote{\KOMAScript{} vs. standard classes} there are
-no further structuring commands. In particular, there are no commands which
-can produce unnumbered chapters or sections which show up in the table of
-contents and in the running heading.%
+\iffalse% Umbruchkorrekturtext
+ In the standard classes\textnote{\KOMAScript{} vs. standard classes} there
+ are no further structuring commands. In particular, there are no commands
+ which can produce unnumbered chapters or sections which show up in the table
+ of contents and in the running heading.%
\fi
+
\begin{Declaration}
- \Macro{addpart}\OParameter{Short version}\Parameter{Heading}%
- \Macro{addpart*}\Parameter{Heading}%
- \Macro{addchap}\OParameter{Short version}\Parameter{Heading}%
- \Macro{addchap*}\Parameter{Heading}%
- \Macro{addsec}\OParameter{Short version}\Parameter{Heading}%
- \Macro{addsec*}\Parameter{Heading}\textnote[n]{\KOMAScript{} vs. standard classes}
+ \Macro{addpart}\OParameter{short version}\Parameter{heading}%
+ \Macro{addpart*}\Parameter{heading}%
+ \Macro{addchap}\OParameter{short version}\Parameter{heading}%
+ \Macro{addchap*}\Parameter{heading}%
+ \Macro{addsec}\OParameter{short version}\Parameter{heading}%
+ \Macro{addsec*}\Parameter{heading}
+ \textnote[n]{\KOMAScript{} vs. standard classes}
\end{Declaration}%
-In addition to the commands of the standard classes, {\KOMAScript}
-offers the new commands \Macro{addsec} and \Macro{addchap}. They are
-similar to the standard commands \DescRef{\LabelBase.cmd.chapter} and
-\DescRef{\LabelBase.cmd.section}, except that they are unnumbered. They thus produce
-both a running heading and an entry in the table of contents.
+In addition to the commands of the standard classes, {\KOMAScript} offers the
+new commands \Macro{addpart}, \Macro{addsec} and \Macro{addchap}. They are
+similar to the standard commands \DescRef{\LabelBase.cmd.part}\IndexCmd{part}%
+\important{\DescRef{\LabelBase.cmd.part}, \DescRef{\LabelBase.cmd.chapter},
+ \DescRef{\LabelBase.cmd.section}},
+\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.
The starred variants \Macro{addchap*} and \Macro{addsec*} are similar to the
-standard commands \DescRef{\LabelBase.cmd.chapter*} and \DescRef{\LabelBase.cmd.section*} except for a tiny but
-important difference: The running headings are deleted. This eliminates the
-side effect of obsolete headers mentioned above. Instead, the running headings
-on following pages remain empty. \OnlyAt{\Class{book}\and
- \Class{scrreprt}}\Macro{addchap} and \Macro{addchap*} of course only exist
-in book and report classes, namely \Class{book}, \Class{scrbook},
-\Class{report} and \Class{scrreport}, but not in the article classes
-\Class{article} and \Class{scrartcl}.
-
-Similarly, the command \Macro{addpart} produces an unnumbered document
-part with an entry in the table of contents. Since the running
-headings are already deleted by \DescRef{\LabelBase.cmd.part} and \DescRef{\LabelBase.cmd.part*} the
-problem of obsolete headers does not exist. The starred version
-\Macro{addpart*} is thus identical to \DescRef{\LabelBase.cmd.part*} and is only
-defined for consistency reasons.
+standard commands \DescRef{\LabelBase.cmd.chapter*} and
+\DescRef{\LabelBase.cmd.section*} except for a small but important difference:
+the running heads are deleted. This eliminates the side effect of obsolete
+headers mentioned above. Instead, the running heads on subsequent pages remain
+empty. \OnlyAt{\Class{book}\and \Class{scrreprt}}\Macro{addchap} and
+\Macro{addchap*} only exist, of course, in book and report classes, namely
+\Class{book}, \Class{scrbook}, \Class{report} and \Class{scrreport}, not in
+the article classes \Class{article} and \Class{scrartcl}.
+
+The \Macro{addpart} command produces an unnumbered document part with an
+entry in the table of contents. Since the running heads are already deleted
+by \DescRef{\LabelBase.cmd.part} and \DescRef{\LabelBase.cmd.part*} the
+previously mentioned problem with obsolete headers does not exist. The starred
+version \Macro{addpart*} is thus identical to \DescRef{\LabelBase.cmd.part*}
+and is only defined for reasons of consistency.
Please note\textnote{Attention!} that \Macro{addpart} and \Macro{addchap} and
-their starred versions change the page style for one page. The particular page
+their starred variants change the page style for one page. The particular page
style is defined in the macros \DescRef{\LabelBase.cmd.partpagestyle} and
\DescRef{\LabelBase.cmd.chapterpagestyle} (see
-\autoref{sec:\LabelBase.pagestyle}, \DescPageRef{\LabelBase.cmd.chapterpagestyle}).
+\autoref{sec:\LabelBase.pagestyle},
+\DescPageRef{\LabelBase.cmd.titlepagestyle}).
+\iffree{\iffalse}{\csname iftrue\endcsname}% Umbruchkorrekturbeispiel
+ \begin{Example}
+ You write a book with a long afterword that spans several pages. This
+ should receive neither a running head nor an entry in the table of
+ contents. Therefore, you first use \DescRef{\LabelBase.cmd.chapter*}:
+\begin{lstcode}
+ \documentclass{scrbook}
+ \usepackage{blindtext}
+ \begin{document}
+ \tableofcontents
+ \blinddocument
+ \chapter*{Afterword}
+ \Blindtext[10]
+ \end{document}
+\end{lstcode}
+ However, you discover that the running head of the previous chapter
+ reappears on the second and third pages of the afterword. Naturally, you do
+ not want that. Therefore, you use \Macro{addchap*}:
+\begin{lstcode}
+ \documentclass{scrbook}
+ \usepackage{blindtext}
+ \begin{document}
+ \tableofcontents
+ \blinddocument
+ \addchap*{Afterword}
+ \Blindtext[10]
+ \end{document}
+\end{lstcode}
+ The complete postscript is now without a running head, if that is what you
+ want. But even that does not quite meet your expectations. A running head
+ would be nice. With
+\begin{lstcode}
+ \documentclass{scrbook}
+ \usepackage{blindtext}
+ \begin{document}
+ \tableofcontents
+ \blinddocument
+ \addchap{Afterword}
+ \Blindtext[10]
+ \end{document}
+\end{lstcode}
+ you now get both ``Afterword'' as the running head on the even pages and an
+ entry in the table of contents. But this entry bothers your publisher. He
+ insists that the afterword have no entry in the table of contents. Even if
+ that seems strange to you, you want to satisfy the publisher, so with
+ \OptionValueRef{\LabelBase}{headings}{optiontotocandhead} you first
+ activate the extended function for the optional argument and then
+ explicitly set an empty argument for the table of contents:
+\begin{lstcode}
+ \documentclass[headings=optiontotocandhead]
+ {scrbook}
+ \usepackage{blindtext}
+ \begin{document}
+ \tableofcontents
+ \blinddocument
+ \addchap[tocentry={}]{Afterword}
+ \Blindtext[10]
+ \end{document}
+\end{lstcode}
+ The running head is not changed by \OptionValue{tocentry}{\{\}}. Since
+ \Class{scrbook} automatically omits empty entries in the table of contents,
+ the publisher is now satisfied.
+ \end{Example}%
+\fi
-As for the possibilities of font switching\ChangedAt{v2.8p}{%
- \Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}}, %
-the same explanations apply as given above for the normal structuring
-commands. The elements are named the same since they describe not
-variants but structuring levels.%
+The possibilities for switching fonts\ChangedAt{v2.8p}{%
+ \Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}} %
+described above for the unstarred variant of the sectioning commands apply
+without change. The elements have the same names since they do not designate
+variants but sectioning levels.%
%
\EndIndexGroup
\begin{Declaration}
- \Macro{minisec}\Parameter{Heading}
+ \Macro{minisec}\Parameter{heading}
\end{Declaration}%
-Sometimes a heading\Index{heading} is wanted which is highlighted but
-also closely linked to the following text. Such a heading should not
-be separated by a large vertical skip.
+Sometimes you want a heading\Index{heading} that is highlighted but also
+closely linked to the following text. Such a heading should not be separated
+by a large vertical skip.
-The command \Macro{minisec} is designed for this situation. This
-heading is not associated with any structuring level. Such a
-\emph{mini section} does not produce an entry in the table of contents
-nor does it receive any numbering.
+The \Macro{minisec} command is designed for this situation. This heading is
+not associated with any sectioning level\textnote{no sectioning level}. Such a
+\emph{mini-section} does not produce an entry in the table of contents, nor
+does it receive any numbering.
+\BeginIndexGroup
\BeginIndex{FontElement}{minisec}\LabelFontElement{minisec}%
-The font type of the structuring command \Macro{minisec} can be changed using
-the element
-\DescRef{\LabelBase.fontelement.disposition}\IndexFontElement{disposition}
-(see \autoref{tab:\LabelBase.fontelements},
-\autopageref{tab:\LabelBase.fontelements}) and
-\FontElement{minisec}\ChangedAt{v2.96a}{%
- \Class{scrbook} \and\Class{scrreprt} \and\Class{scrartcl}}. Default setting
-of element \FontElement{minisec} is empty, so the default of the element
-\DescRef{\LabelBase.fontelement.disposition}\IndexFontElement{disposition} is
-active.%
-\EndIndex{FontElement}{minisec}%
+You can change the font of the \Macro{minisec} command using the
+\DescRef{\LabelBase.fontelement.disposition}%
+\important{\DescRef{\LabelBase.fontelement.disposition}\\
+\FontElement{minisec}} and \FontElement{minisec}\ChangedAt{v2.96a}{%
+ \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} element (see
+\autoref{tab:maincls.fontelements}, \autopageref{tab:maincls.fontelements}).
+The default of the \FontElement{minisec} element is empty, so by default only
+the \DescRef{\LabelBase.fontelement.disposition} element is used.%
+\EndIndexGroup
\begin{Example}
You have developed a kit for building a mouse trap and want the
documentation separated into a list of necessary items and an
assembly description. You could write the following:
\begin{lstcode}
- \minisec{Items needed}
-
- \begin{flushleft}
- 1 plank ($100\times 50 \times 12$)\\
- 1 spring-plug of a beer-bottle\\
- 1 spring of a ball-point pen\\
- 1 drawing pin\\
- 2 screws\\
- 1 hammer\\
- 1 knife
- \end{flushleft}
-
- \minisec{Assembly}
- At first one searches the mouse-hole and puts the drawing pin
- directly behind the hole. Thus the mouse cannot escape during the
- following actions.
-
- Then one knocks the spring-plug with the hammer into the mouse-hole.
- If the spring-plug's size is not big enough in order to shut the
- mouse-hole entirely, then one can utilize the plank instead and
- fasten it against the front of the mouse-hole utilizing the two
- screws and the knife. Instead of the knife one can use a
- screw-driver instead.
+ \documentclass{scrartcl}
+
+ \begin{document}
+
+ \title{DIY Projects}
+ \author{Two Left Thumbs}
+ \date{\today}
+ \maketitle
+
+ \section{Mousetrap}
+
+ The first project is suitable for beginners and only requires
+ a few components that should be found in every household.
+
+ \minisec{Material Required}
+
+ \begin{flushleft}
+ 1 board ($100\times 50 \times 12$)\\
+ 1 swing-top cap of a beer-bottle\\
+ 1 ballpoint pen\\
+ 1 push pin\\
+ 2 screws\\
+ 1 hammer\\
+ 1 knife
+ \end{flushleft}
+
+ \minisec{Assembly}
+ First, find the mouse hole and put the push pin directly behind
+ the hole so that the mouse cannot escape during the following
+ actions.
+
+ Next tap the swing-top cap into the mouse hole with the hammer.
+ If the cap is not big enough to block the hole completely and
+ permanently, take the board instead and screw it to the front
+ of the mouse hole using the two screws and the knife. Of
+ course, you can use a screwdriver instead of a knife. The
+ ballpoint pen has fallen victim to animal welfare.
+ \end{document}
\end{lstcode}
- Which gives:
+ The main part, starting with the heading ``Material Required'' will look
+ like this:
\begin{ShowOutput}[\baselineskip]\setlength{\parindent}{1em}
- \minisec{Items needed}
-
- \begin{flushleft}
- 1 plank ($100\times 50 \times 12$)\\
- 1 spring-plug of a beer-bottle\\
- 1 spring of a ball-point pen\\
- 1 drawing pin\\
- 2 screws\\
- 1 hammer\\
- 1 knife
- \end{flushleft}
-
- \minisec{Assembly}
- At first one searches the mouse-hole and puts the drawing pin
- directly behind the hole. Thus the mouse cannot escape during the
- following actions.
-
- Then one knocks the spring-plug with the hammer into the
- mouse-hole. If the spring-plug's size is not big enough in order
- to shut the mouse-hole entirely, then one can utilize the plank
- instead and fasten it against the front of the mouse-hole
- utilizing the two screws and the knife. Instead of the knife one
- can use a screw-driver instead.
+ \minisec{Material Required}
+
+ \begin{flushleft}
+ 1 board ($100\times 50 \times 12$)\\
+ 1 swing-top cap of a beer-bottle\\
+ 1 ballpoint pen\\
+ 1 push pin\\
+ 2 screws\\
+ 1 hammer\\
+ 1 knife
+ \end{flushleft}
+
+ \minisec{Assembly}
+ First, find the mouse hole and put the push pin directly behind the hole
+ so that the mouse cannot escape during the following actions.
+
+ Next tap the swing-top cap into the mouse hole with the hammer. If the cap
+ is not big enough to block the hole completely and permanently, take the
+ board instead and screw it to the front of the mouse hole using the two
+ screws and the knife. Of course, you can use a screwdriver instead of a
+ knife. The ballpoint pen has fallen victim to animal welfare.
\end{ShowOutput}
\end{Example}
%
@@ -2018,14 +2363,14 @@ active.%
\end{Declaration}%
In the standard classes\textnote{\KOMAScript{} vs. standard classes}, headings
are set as justified text. That means that hyphenated words can occur and
-headings with more than one line are stretched up to the text border. This is
-a rather uncommon approach in typography. {\KOMAScript} therefore formats the
+multi-line headings are stretched up to the text width. This approach is
+rather uncommon in typography. {\KOMAScript} therefore sets the
headings left aligned with hanging indentation using \Macro{raggedsection}
-with the definition:
+with the default:
\begin{lstcode}
\newcommand*{\raggedsection}{\raggedright}
\end{lstcode}
-This command can be redefined with \Macro{renewcommand}.
+You can redefine this command with \Macro{renewcommand}.
\begin{Example}
You prefer justified headings, so you write in the preamble of your document:
\begin{lstcode}
@@ -2035,162 +2380,180 @@ This command can be redefined with \Macro{renewcommand}.
\begin{lstcode}
\let\raggedsection\relax
\end{lstcode}
- You will get a formatting of the headings which is very close to that
- of the standard classes. It will become even closer when you combine
- this change with the change of the element
+ You will get heading formatting which is very close to that of the standard
+ classes. It will become even closer when you combine this change with the
+ change to the
\DescRef{\LabelBase.fontelement.disposition}\IndexFontElement{disposition}
- mentioned above.
+ element mentioned above.
\end{Example}
Because\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}} some users want
-for \DescRef{\LabelBase.cmd.chapter} another alignment than for all other
-sections, you can change only \DescRef{\LabelBase.cmd.chapter} redefining
-\Macro{raggedchapter}. The default of this command is usage of
-\Macro{raggedsection}. So every change of \Macro{raggedsection} will also
-change the alignment of chapter headings.
-
-Unlike all others, the headings of parts (\DescRef{\LabelBase.cmd.part}) will
-be horizontally centered instead of set ragged right. This is because command
-\Macro{raggedpart} is defined as
+a different alignment for the \DescRef{\LabelBase.cmd.chapter} level than for
+the other sectioning levels, you can change the
+\DescRef{\LabelBase.cmd.chapter} justification separately by redefining
+\Macro{raggedchapter}. By default, however, this command simply uses
+\Macro{raggedsection}, so changing \Macro{raggedsection} indirectly affects
+\Macro{raggedchapter}.
+
+By default, part headings (\DescRef{\LabelBase.cmd.part}) are set horizontally
+centred rather than ragged right. This formatting is performed by the
+\Macro{raggedpart} statement, which has the default definition
\begin{lstcode}
\let\raggedpart\centering
\end{lstcode}
-You may also redefine this using \Macro{renewcommand} too.
+You can also redefine this command using \Macro{renewcommand}.
\begin{Example}
- You do not want different alignment at headings of
- \DescRef{\LabelBase.cmd.part}. So you put
+ You want the headings for \DescRef{\LabelBase.cmd.part} to be formatted the
+ same as any other sectioning command. To do so, put
\begin{lstcode}
\renewcommand*{\raggedpart}{\raggedsection}
\end{lstcode}
- into the preamble of your document. In\textnote{Hint!} this case,
- and unlike in the example above, \Macro{let} has not been used, because
- \Macro{let} would give \Macro{raggedpart} the current meaning of
- \Macro{raggedsection}. Further changes of \Macro{raggedsection} would then
- stay disregarded at the usage of \Macro{raggedpart}. Doing the redefinition
- using \Macro{renewcommand} gives \Macro{raggedpart} the meaning of
- \Macro{raggedsection} not at definition time, but each time
- \Macro{raggedpart} will be used.
+ in the preamble of your document. In\textnote{Hint!} this case, and unlike
+ in the example above, we did not use \Macro{let} because \Macro{let} would
+ set \Macro{raggedpart} to the underlying value of \Macro{raggedsection}.
+ Subsequent changes to \Macro{raggedsection} would then not change the
+ behaviour of \Macro{raggedpart}. By redefining with \Macro{renewcommand},
+ \Macro{raggedpart} will use the current meaning of \Macro{raggedsection} at
+ the time it is used rather than when it was redefined.
\end{Example}%
%
\EndIndexGroup
\begin{Declaration}
- \Macro{partformat}%
- \Macro{chapterformat}%
- \Macro{sectionformat}%
- \Macro{subsectionformat}%
- \Macro{subsubsectionformat}%
- \Macro{paragraphformat}%
- \Macro{subparagraphformat}%
- \Macro{othersectionlevelsformat}\Parameter{sectioning
- name}\Parameter{}\Parameter{counter output}%
- \Macro{IfUsePrefixLine}\Parameter{then code}\Parameter{else code}%
+ \Macro{partformat}
+ \Macro{chapterformat}
+ \Macro{sectionformat}
+ \Macro{subsectionformat}
+ \Macro{subsubsectionformat}
+ \Macro{paragraphformat}
+ \Macro{subparagraphformat}
+ \Macro{othersectionlevelsformat}\Parameter{sectioning name}\Parameter{}
+ \Parameter{counter output}
+ \Macro{IfUsePrefixLine}\Parameter{then code}\Parameter{else code}
\Macro{autodot}
\end{Declaration}%
-\Index{part>number}%
-\Index{chapter>number}%
-\Index{section>number}%
-{\KOMAScript} has added a further logical level on top of
-\Macro{the\PName{sectioning name}} to the output of the sectioning
-numbers. The counters for the respective heading are not merely output. They
-are formatted using the commands \Macro{partformat}, \Macro{chapterformat}
-down to \Macro{subparagraphformat}\ChangedAt{v3.17}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}}.
-\OnlyAt{\Class{scrbook}\and\Class{scrreprt}}Of course the command
-\Macro{chapterformat} like \Macro{thechapter} does not exist in the class
-\Class{scrartcl} but only in the classes \Class{scrbook} and \Class{scrreprt}.
-
-As described for option \DescRef{\LabelBase.option.numbers}\important{\DescRef{\LabelBase.option.numbers}} at the
-beginning of this section (see \DescPageRef{\LabelBase.option.numbers}),
-periods in section numbers should be handled for the German-speaking region
-according to the rules given in \cite{DUDEN}. The command \Macro{autodot} in
-{\KOMAScript} ensures that these rules are followed. In all levels
-except for \DescRef{\LabelBase.cmd.part}, a dot is followed by a further \Macro{enskip}. This
-corresponds to a horizontal skip of 0.5\Unit{em}.
+{\KOMAScript} adds another logical layer above \Macro{the\PName{sectioning
+ name}} to format the sectioning numbers. The counters for each heading are
+not merely output. They are formatted using the commands \Macro{partformat},
+\Macro{chapterformat}, down to
+\Macro{subparagraphformat}\ChangedAt{v3.17}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}}. Of course the \Macro{chapterformat}
+command, like \Macro{thechapter}, does not exist in the \Class{scrartcl}
+class, but only in the \Class{scrbook} and \Class{scrreprt}
+classes.\OnlyAt{\Class{scrbook}\and\Class{scrreprt}}
+
+As already explained for the \DescRef{\LabelBase.option.numbers}%
+\important{\DescRef{\LabelBase.option.numbers}} option at the beginning of
+this section (see \DescPageRef{\LabelBase.option.numbers}), {\KOMAScript}'s
+handling of points in section numbers implements the rules given in
+\cite{DUDEN}, which are standard in German-language typography, in the
+\Macro{autodot} command. In all levels except for
+\DescRef{\LabelBase.cmd.part}, a point is followed by a further
+\Macro{enskip}. This corresponds to a horizontal skip of 0.5\Unit{em}.
Since \KOMAScript~3.17\ChangedAt{v3.17}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}} the command
+ \Class{scrreprt}\and \Class{scrartcl}}, the command
\Macro{othersectionlevelsformat} is used only in rare circumstances, i.\,e.,
if the corresponding format command to a section command does not exist or is
-\Macro{relax}. This should not happen for all section commands defined by
-\KOMAScript{} itself. Therefore the command is not officially documented any
-longer. Nevertheless, if a compatibility level prior to 3.17 (see option
+\Macro{relax}. This should not happen for any section commands defined by
+\KOMAScript{} itself. Therefore the command is no longer officially
+documented. Nevertheless, if you select a compatibility level prior to
+3.17\important{\OptionValueRef{\LabelBase}{version}{3.17}} (see option
\DescRef{\LabelBase.option.version},
\autoref{sec:\LabelBase.compatibilityOptions},
-\DescPageRef{\LabelBase.option.version}) has been selected, commands
-\Macro{sectionformat} down to \Macro{subparagraphformat} are ignored by
-\KOMAScript{}. In this case \Macro{othersectionlevelsformat} indeed will be
-used.
-
-The formatting commands can be redefined using \Macro{renewcommand} to
-fit them to your personal needs. The following original definitions
-are used by the {\KOMAScript} classes:
+\DescPageRef{\LabelBase.option.version}), commands \Macro{sectionformat} down
+to \Macro{subparagraphformat} are ignored by \KOMAScript{}. Instead, these
+layers will continue to use \Macro{othersectionlevelsformat}.
+
+You can redefine the formatting commands using \Macro{renewcommand} to fit
+them to your personal needs. The following default definitions are used by the
+{\KOMAScript} classes:
\begin{lstcode}
\newcommand*{\partformat}{\partname~\thepart\autodot}
\newcommand*{\chapterformat}{%
\mbox{\chapappifchapterprefix{\nobreakspace}\thechapter
\autodot\IfUsePrefixLine{}{\enskip}}}
\newcommand*{\sectionformat}{\thesection\autodot\enskip}
+ \newcommand*{\subsectionformat}{%
+ \thesubsection\autodot\enskip}
+ \newcommand*{\subsubsectionformat}{%
+ \thesubsubsection\autodot\enskip}
+ \newcommand*{\paragraphformat}{\theparagraph\autodot\enskip}
+ \newcommand*{\subparagraphformat}{%
+ \thesubparagraph\autodot\enskip}
\newcommand*{\othersectionlevelsformat}[3]{%
#3\autodot\enskip}
\end{lstcode}
-The definitions of the lower levels correspond to
-\Macro{sectionformat}.
-Because\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}} of
-\Macro{IfUsePrefixLine} command \Macro{chapterformat} should not be used
-outside of \DescRef{\LabelBase.cmd.chapter}. \Macro{IfUsePrefixLine} is only valid inside
-section commands of \KOMAScript{}. In this case, it executes the \PName{then
- code} if a prefix line for the number is used, but \PName{else code}
-otherwise.
+Because\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}} it uses
+\Macro{IfUsePrefixLine}, \Macro{chapterformat} should not be used outside of
+\DescRef{\LabelBase.cmd.chapter}. \Macro{IfUsePrefixLine} is only valid inside
+\KOMAScript{} sectioning commands. Within those commands, it executes the
+\PName{then code} if a prefix line for the number is used and the \PName{else
+code} otherwise.
-Do\textnote{Attention!} not forget to change \Macro{newcommand} into
-\Macro{renewcommand} if you like to re-define one of the commands.
+Please also remember\textnote{Attention!} to replace \Macro{newcommand} with
+\Macro{renewcommand} if you want to redefine one of the commands above.
\begin{Example}
- Assume that when using \DescRef{\LabelBase.cmd.part} you do not want the word
- ``Part'' written in front of the part number. You could use the
+ Suppose you do not want the word ``Part'' written in front of the part
+ number when you use \DescRef{\LabelBase.cmd.part}. You can put the
following command in the preamble of your document:
\begin{lstcode}
\renewcommand*{\partformat}{\thepart\autodot}
\end{lstcode}
- Strictly speaking, you could do without \Macro{autodot} at this point and
- insert a fixed dot instead. As \DescRef{\LabelBase.cmd.part} is numbered with roman numerals,
- according to \cite{DUDEN} a period has to be applied. However, you thereby
- give up the possibility to use one of the options
- \OptionValueRef{\LabelBase}{numbers}{endperiod} and
- \OptionValueRef{\LabelBase}{numbers}{noendperiod} and optionally depart from
- the rules. More details concerning class options can be found at
+ In fact, you could do without \Macro{autodot} here and insert a fixed point
+ instead. Since \DescRef{\LabelBase.cmd.part} is numbered with Roman numerals,
+ it must be followed by a point according to \cite{DUDEN}. However, by using
+ \Macro{autodot} you retain the ability to use the
+ \DescRef{\LabelBase.option.numbers}%
+ \important{\DescRef{\LabelBase.option.numbers}} option
+ \OptionValueRef{\LabelBase}{numbers}{endperiod} and thus deviate from
+ the rule. You can find more details concerning class options on
\DescPageRef{\LabelBase.option.numbers}.
- An additional possibility could be to place the section numbers in the
- left margin in such a way that the heading text is left aligned with
- the surrounding text. This can be accomplished with:
+ Another possibility is to place the section numbers in the left margin in
+ such a way that the heading text is left aligned with the surrounding text.
+ You can accomplish this with:
\begin{lstcode}
\renewcommand*{\sectionformat}{%
\makebox[0pt][r]{\thesection\autodot\enskip}}
\renewcommand*{\subsectionformat}{%
\makebox[0pt][r]{\thesubsection\autodot\enskip}}
\renewcommand*{\subsubsectionformat}{%
- \makebox[0pt][r]{\thesubsubsection\autodot\enskip}}
+ \makebox[0pt][r]{%
+ \thesubsubsection\autodot\enskip}}
\renewcommand*{\paragraphformat}{%
\makebox[0pt][r]{\theparagraph\autodot\enskip}}
\renewcommand*{\paragraphformat}{%
- \makebox[0pt][r]{\thesubparagraph\autodot\enskip}}
+ \makebox[0pt][r]{%
+ \thesubparagraph\autodot\enskip}}
\end{lstcode}
- See \cite{latex:usrguide} for more information about the optional arguments
- of \Macro{makebox}.
+ The optional arguments of the \Macro{makebox} command require \LaTeX{} to
+ create a zero-width box with right-justified content. As a result, the
+ contents of the box are output to the left of the current position.%
+ \iffree{}{ %Umbruchkorrekturtext
+ This popular trick avoids the need first to measure the width of the
+ number and the spacing, and then to change the current position
+ appropriately with \Macro{hspace}.}
+ You can find more about the optional arguments of \Macro{makebox} in
+ \cite{latex:usrguide}.
\end{Example}
-If you would like to change more than only the printing of the counter of a
-heading, please have a look at
-\DescRef{maincls-experts.cmd.chapterlineswithprefixformat},
-\DescRef{maincls-experts.cmd.chapterlinesformat},
-\DescRef{maincls-experts.cmd.sectionlinesformat}, and
-\DescRef{maincls-experts.cmd.sectioncatchphraseformat} in
-\autoref{sec:maincls-experts.experts} from
-\DescPageRef{maincls-experts.cmd.chapterlineswithprefixformat}.%
+For formatting changes in the headings that go beyond merely formatting the
+unit number, please refer to
+\DescRef{maincls-experts.cmd.partlineswithprefixformat}%
+\IndexCmd{partlineswithprefixformat},
+\DescRef{maincls-experts.cmd.chapterlineswithprefixformat}%
+\IndexCmd{chapterlineswithprefixformat} and
+\DescRef{maincls-experts.cmd.chapterlinesformat}\IndexCmd{chapterlinesformat},
+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
+\DescPageRef{maincls-experts.cmd.partlineswithprefixformat}.%
\EndIndexGroup
@@ -2198,28 +2561,26 @@ heading, please have a look at
\Macro{chapappifchapterprefix}\Parameter{additional text}%
\Macro{chapapp}
\end{Declaration}%
-These\OnlyAt{\Class{scrbook}\and\Class{scrreprt}}%
-\ChangedAt{v2.8o}{\Class{scrbook}\and\Class{scrreprt}} two commands
-are not only used internally by {\KOMAScript} but are also provided to
-the user. Later it will be shown how they can be used, for example, to
-redefine other commands.
-
-Using the layout option
-\OptionValueRef{\LabelBase}{chapterprefix}{true}\important{\DescRef{\LabelBase.option.chapterprefix}}
-(see \DescPageRef{\LabelBase.option.chapterprefix})
-\Macro{chapappifchapterprefix} outputs the word
-``Chapter''\Index{chapter>heading} in the main part of the document in the
-current language, followed by \PName{additional text}. In the
+These\ChangedAt{v2.8o}{\Class{scrbook}\and\Class{scrreprt}} two commands are
+used internally by {\KOMAScript} and also made available to the user. Later,
+you will see how to use them, for example to redefine other commands.%
+\OnlyAt{\Class{scrbook}\and\Class{scrreprt}}
+
+If you use the layout option \OptionValueRef{\LabelBase}{chapterprefix}{true}%
+\important{\DescRef{\LabelBase.option.chapterprefix}} (see
+\DescPageRef{\LabelBase.option.chapterprefix}), \Macro{chapappifchapterprefix}
+outputs the word ``Chapter''\Index{chapter>heading} in the body of the text in
+the current language, followed by \PName{additional text}. In the
appendix\Index{appendix}, the word ``Appendix'' in the current language is
output instead, followed by \PName{additional text}. If the option
\OptionValue{\LabelBase}{chapterprefix}{false} is set, then nothing is output.
-The command \Macro{chapapp} always outputs the word ``Chapter'' or
-``Appendix''. In this case the selection of option
-\DescRef{\LabelBase.option.chapterprefix} has no effect.
+The \Macro{chapapp} command always outputs the word ``Chapter'' or
+``Appendix'', regardless of the setting of the
+\DescRef{\LabelBase.option.chapterprefix} option.
-Since chapters only exist in the classes \Class{scrbook} and
-\Class{scrreprt}, these commands only exist in these classes.%
+Since chapters only exist in the classes \Class{scrbook} and \Class{scrreprt},
+these commands only exist in these classes.%
%
\EndIndexGroup
@@ -2235,104 +2596,101 @@ Since chapters only exist in the classes \Class{scrbook} and
\Macro{subsectionmarkformat}
\end{Declaration}%
\begin{Explain}%
- As mentioned in \autoref{sec:\LabelBase.pagestyle} the page style
- \PValue{headings} works with automatic running heads\Index{running
- head}. For this, the commands \Macro{chaptermark} and \Macro{sectionmark},
- or \Macro{sectionmark} and \Macro{subsectionmark}, respectively, are
- defined. Every structuring command (\DescRef{\LabelBase.cmd.chapter},
- \DescRef{\LabelBase.cmd.section}, etc.) automatically carries out the
- respective \Macro{\dots mark} command. The parameter passed contains the
- text of the section heading\Index{heading}. The respective section number is
- added automatically in the \Macro{\dots mark} command. The formatting is
- done according to the section level with one of the three commands
- \Macro{chaptermarkformat}, \Macro{sectionmarkformat}, or
- \Macro{subsectionmarkformat}.
-
- Please note\textnote{Attention!}, the running heads of
+ As mentioned in \autoref{sec:\LabelBase.pagestyle}, the
+ \DescRef{\LabelBase.pagestyle.headings}\IndexPagestyle{headings}%
+ \important{\DescRef{\LabelBase.pagestyle.headings}} page style works with
+ automatic running heads\Index{running heads>automatic}. For this, the
+ commands \Macro{chaptermark} and \Macro{sectionmark}, or \Macro{sectionmark}
+ and \Macro{subsectionmark}, are defined accordingly. Every sectioning
+ command (\DescRef{\LabelBase.cmd.chapter}, \DescRef{\LabelBase.cmd.section},
+ etc.) automatically executes the corresponding \Macro{\dots mark} command.
+ The parameter passed contains the text of the section heading%
+ \Index{heading}. The corresponding section number is added automatically in
+ the \Macro{\dots mark} command. The formatting is done according to the
+ sectioning level with one of the three commands \Macro{chaptermarkformat},
+ \Macro{sectionmarkformat}, or \Macro{subsectionmarkformat}.
+
+ Note\textnote{Attention!} that the running heads of
\DescRef{\LabelBase.cmd.addchap}\IndexCmd{addchap} and
\DescRef{\LabelBase.cmd.addsec}\IndexCmd{addsec} are also based on
- \Macro{chaptermark} and \Macro{addsecmark} but locally set counter
- \DescRef{\LabelBase.counter.secnumdepth} to a value that makes chapters
- respectively sections not numbered. You should pay attention for this
- especially if you redefine \Macro{chaptermark} or \Macro{sectionmark} (see
- \Macro{ifnumbered} on \DescPageRef{\LabelBase.cmd.ifnumbered}). The star
- variants \DescRef{\LabelBase.cmd.addchap*} and
- \DescRef{\LabelBase.cmd.addsec*} use additional commands \Macro{addchapmark}
- and \Macro{addsecmark} that are defined also basing on \Macro{chaptermark}
- and \Macro{sectionmark} with local changes of
- \DescRef{\LabelBase.counter.secnumdepth}.
-
- \OnlyAt{\Class{scrbook}\and\Class{scrreprt}}Of course there is no command
- \Macro{chaptermark} or \Macro{chaptermarkformat} in
- \Class{scrartcl}. \OnlyAt{\Class{scrartcl}}Accordingly,
- \Macro{subsectionmark} and \Macro{subsectionmarkformat} exist only in
- \Class{scrartcl}. This changes when you use the \Package{scrlayer-scrpage}
- package (see \autoref{cha:scrlayer-scrpage}).\par
+ \Macro{chaptermark} and \Macro{sectionmark}. However, the
+ \DescRef{\LabelBase.counter.secnumdepth} counter is set locally to a value
+ that switches off the numbering of chapters or sections. You should consider
+ this, for example, if you redefine \Macro{chaptermark} or
+ \Macro{sectionmark} (see \Macro{ifnumbered} on
+ \DescPageRef{\LabelBase.cmd.ifnumbered}). The starred variants
+ \DescRef{\LabelBase.cmd.addchap*} and \DescRef{\LabelBase.cmd.addsec*} use
+ additional commands \Macro{addchapmark} and \Macro{addsecmark} that are also
+ defined based on \Macro{chaptermark} and \Macro{sectionmark} with local
+ changes of \DescRef{\LabelBase.counter.secnumdepth}.
+
+ Although\OnlyAt{\Class{scrartcl}} there is no \Macro{chaptermark} or
+ \Macro{chaptermarkformat} command in \Class{scrartcl}, there are two
+ commands, \Macro{subsectionmark} and \Macro{subsectionmarkformat}, which
+ exist only in \Class{scrartcl}. However using the
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ \IndexPackage{scrlayer-scrpage} package changes this (see
+ \autoref{cha:scrlayer-scrpage}).
\end{Explain}
-Similar to \DescRef{\LabelBase.cmd.partformat} down to
-\DescRef{\LabelBase.cmd.subparagraphformat} for formatting the numbers in the
-headings, the commands \Macro{chaptermarkformat} (not in \Class{scrartcl}),
-\Macro{sectionmarkformat}, and \Macro{subsectionmarkformat} (only in
-\Class{scrartcl}) define the formatting of the sectioning numbers in the
-automatic running heads. They can be adapted to your personal needs with
-\Macro{renewcommand}. The original definitions for the {\KOMAScript} classes
-are:
+Just as numbers in the sectioning-command headers are formatted with
+\DescRef{\LabelBase.cmd.partformat} down to
+\DescRef{\LabelBase.cmd.subparagraphformat}, \Macro{chaptermarkformat},
+\Macro{sectionmarkformat}, and \Macro{subsectionmarkformat} define the
+formatting of the sectioning numbers in the automatic running heads. They can
+be adapted to your personal needs with \Macro{renewcommand}. The original
+definitions for the {\KOMAScript} classes are:
\begin{lstcode}
\newcommand*{\chaptermarkformat}{%
\chapappifchapterprefix{\ }\thechapter\autodot\enskip}
- \newcommand*{\sectionmarkformat}{\thesection\autodot\enskip}
+ \newcommand*{\sectionmarkformat}{%
+ \thesection\autodot\enskip}
\newcommand*{\subsectionmarkformat}{%
\thesubsection\autodot\enskip}
\end{lstcode}
\begin{Example}
- Suppose you want to prepend the word ``Chapter'' to the chapter
- number in the running heading. For example you could insert the
- following definition in the preamble of your document:
+ Suppose you want the word ``Chapter'' to precede the chapter number in the
+ running head. You could put the following definition in the preamble of your
+ document:
\begin{lstcode}
\renewcommand*{\chaptermarkformat}{%
\chapapp~\thechapter\autodot\enskip}
\end{lstcode}
\end{Example}
-As you can see, both the commands
-\DescRef{\LabelBase.cmd.chapappifchapterprefix} and
-\DescRef{\LabelBase.cmd.chapapp} explained above are used here.%
-%
+As you can see, both \DescRef{\LabelBase.cmd.chapapp} and
+\DescRef{\LabelBase.cmd.chapappifchapterprefix}, explained above, are used
+here.%
\EndIndexGroup
\begin{Declaration}
- \Counter{secnumdepth}%
- \Macro{partnumdepth}%
- \Macro{chapternumdepth}%
- \Macro{sectionnumdepth}%
- \Macro{subsectionnumdepth}%
- \Macro{subsubsectionnumdepth}%
- \Macro{paragraphnumdepth}%
+ \Counter{secnumdepth}
+ \Macro{partnumdepth}
+ \Macro{chapternumdepth}
+ \Macro{sectionnumdepth}
+ \Macro{subsectionnumdepth}
+ \Macro{subsubsectionnumdepth}
+ \Macro{paragraphnumdepth}
\Macro{subparagraphnumdepth}
\end{Declaration}%
-\BeginIndex{}{numbering}%
-Section levels in the classes \Class{scrbook}\IndexClass{scrbook} and
-\Class{scrreport}\IndexClass{scrreprt} are, by default, numbered from
-\DescRef{\LabelBase.cmd.part}\IndexCmd{part}\IndexCmd{chapter}\IndexCmd{section}
-down to \DescRef{\LabelBase.cmd.subsection}\IndexCmd{subsection}. In class
-\Class{scrartcl}\IndexClass{scrartcl} the default numbering is from
+\BeginIndex{}{Nummerierung}%
+Normally, the \Class{scrbook}\IndexClass{scrbook} and
+\Class{scrreport}\IndexClass{scrreprt} classes number the section headings
+from \DescRef{\LabelBase.cmd.part}\IndexCmd{part}\IndexCmd{chapter}%
+\IndexCmd{section} down to
+\DescRef{\LabelBase.cmd.subsection}\IndexCmd{subsection} and the
+\Class{scrartcl}\IndexClass{scrartcl} class numbers them from
\DescRef{\LabelBase.cmd.part} down to
-\DescRef{\LabelBase.cmd.subsubsection}\IndexCmd{subsubsection}. The actual
-depth to which headings will be numbered is controlled by the \LaTeX{} counter
-\Counter{secnumdepth}. Since version~3.12 \KOMAScript{} provides the commands
-\Macro{partnumdepth} to \Macro{subparagraphnumdepth} which return the number
-that corresponds to the level they bear in their name. This saves users the
-trouble of having to remember abstract numbers and allows them to define the
-depth to which headings should be numbered with relative ease.
-
-\KOMAScript{} provides the commands \Macro{partnumdepth} to
-\Macro{subparagraphnumdepth} so\ChangedAt{v3.12}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}} users do not have to remember
-abstract numbers, to be able to define the section level down to which
-headings should be numbered. These commands stand for the corresponding
-numbers of the section levels.%
+\DescRef{\LabelBase.cmd.subsubsection}\IndexCmd{subsubsection}. The actual
+depth to which headings are numbered is controlled by the \LaTeX{} counter
+\Counter{secnumdepth}.
+
+To\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}
+save users the trouble of having to remember abstract numbers, the commands
+\Macro{partnumdepth} to \Macro{subparagraphnumdepth} return the appropriate
+number for the section level in their name.
+
\begin{Example}
- For a book project you want the section levels from part down to the section
+ For a book project, you want the section levels from part down to section
to be numbered. To achieve this, you have to set counter
\Counter{secnumdepth} to the value represented by \Macro{sectionnumdepth} in
the preamble of your document:
@@ -2340,37 +2698,34 @@ numbers of the section levels.%
\setcounter{secnumdepth}{\sectionnumdepth}
\end{lstcode}
\end{Example}
-Redefining these commands is not allowed. Doing so could lead to unexpected
-results not only with \KOMAScript{} but also with third party packages. Thus,
-it is recommended to never redefine any of them.
-
-Do not confuse the counters \Counter{secnumdepth} and
-\DescRef{\LabelBase.counter.tocdepth}, please refer to the explanation
-concerning the counter \DescRef{\LabelBase.counter.tocdepth} in
-\autoref{sec:\LabelBase.toc},
-\DescPageRef{\LabelBase.counter.tocdepth}. Actually, depending on the class
-you are using, the meaning of the values of the counters \Counter{secnumdepth}
-and \DescRef{\LabelBase.counter.tocdepth} may deviate from one another for the
-same section level.%
+No provision is made for redefining these commands. Doing so could lead to
+unexpected results, not only with \KOMAScript{} but also with third party
+packages. Thus, you should never redefine them.
+
+Do\textnote{Attention!} not confuse the \Counter{secnumdepth} and
+\DescRef{\LabelBase.counter.tocdepth} counters (see
+\autoref{sec:\LabelBase.toc}, \DescPageRef{\LabelBase.counter.tocdepth}).
+Depending on the class you are using, the meaning of the values of the
+\Counter{secnumdepth} and \DescRef{\LabelBase.counter.tocdepth} counters may
+differ for the same section level.%
+%
\EndIndexGroup
-
\begin{Declaration}
\Macro{ifnumbered}\Parameter{section level}%
\Parameter{then code}\Parameter{else code}%
\Macro{ifunnumbered}\Parameter{section level}%
\Parameter{then code}\Parameter{else code}
\end{Declaration}
-After\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} describing above how to define down to which section level
-headings are numbered, the commands \Macro{ifnumbered} and
-\Macro{ifunnumbered} can be used to execute code depending on whether a
-\PName{section level} is numbered or not. If the current setting of
-\DescRef{\LabelBase.counter.secnumdepth} stipulates that a \PName{section
- level} will be numbered, the \PName{then code} after \Macro{ifnumbered} gets
-executed. If it is not numbered, the \PName{else code} gets executed. The
+The\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} commands \Macro{ifnumbered} and \Macro{ifunnumbered}
+determine which section-level headings are numbered, using the technique
+described above, and execute code depending on whether a \PName{section level}
+is numbered or not. If a \PName{section level} is numbered with the current
+settings, \Macro{ifnumbered} executes the \PName{then code}. If the section
+level is unnumbered, the \PName{else code} is executed. The
\Macro{ifunnumbered} command behaves in exactly the opposite manner, executing
-the \PName{then code} if the current level is not numbered and the \PName{else
+the \PName{then code} if the current level is unnumbered and the \PName{else
code} if it is. The \PName{section level} parameter is simply the \LaTeX{}
name of a section like \PValue{part}, \PValue{chapter}, \PValue{section},
\PValue{subsection}, \PValue{subsubsection}, \PValue{paragraph} oder
@@ -2379,36 +2734,36 @@ name of a section like \PValue{part}, \PValue{chapter}, \PValue{section},
\PValue{subparagraph}.
\KOMAScript{} itself uses these tests, for example, in the definition of
-\DescRef{\LabelBase.cmd.chaptermark}\IndexCmd{chaptermark} within page style
-\PageStyle{headings}\IndexPagestyle{headings}. This indirectly guarantees that
-headings inserted by \DescRef{\LabelBase.cmd.addchap} do not set a number
-inside the running head (see also \DescRef{\LabelBase.cmd.addchapmark},
+\DescRef{\LabelBase.cmd.chaptermark}\IndexCmd{chaptermark} in the
+\DescRef{\LabelBase.pagestyle.headings}\IndexPagestyle{headings} page style.
+This indirectly ensures that headings inserted by
+\DescRef{\LabelBase.cmd.addchap} do not set a number inside the running head
+(see also \DescRef{\LabelBase.cmd.addchapmark},
\DescPageRef{\LabelBase.cmd.addchapmark}).%
\EndIndexGroup
\begin{Declaration}
\Macro{setpartpreamble}%
- \OParameter{position}\OParameter{width}\Parameter{preamble}%
+ \OParameter{position}\OParameter{width}\Parameter{preamble}
\Macro{setchapterpreamble}%
\OParameter{position}\OParameter{width}\Parameter{preamble}
\end{Declaration}%
Parts\OnlyAt{\Class{scrbook}\and
\Class{scrreprt}}\Index{part>preamble}\Index{chapter>preamble} and chapters
-in {\KOMAScript} can be started with a \PName{preamble}. This is particularly
-useful when you are using a two column layout with the class option
-\Option{twocolumn}\IndexOption{twocolumn}, since the heading together with the
-\PName{preamble} is always set in a one column layout. The \PName{preamble}
-can comprise more than one paragraph. The command to output the
-\PName{preamble} has to be placed before the respective \DescRef{\LabelBase.cmd.part},
+in {\KOMAScript} can be given a \PName{preamble}. This is particularly useful
+when you are using a two-column format with the class option
+\Option{twocolumn}\IndexOption{twocolumn}, since the heading and the
+\PName{preamble} are always set in a one-column layout. The \PName{preamble}
+can contain more than one paragraph. The command to set the \PName{preamble}
+must come before the respective \DescRef{\LabelBase.cmd.part},
\DescRef{\LabelBase.cmd.addpart}, \DescRef{\LabelBase.cmd.chapter}, or
\DescRef{\LabelBase.cmd.addchap} command.
\begin{Example}
- You are writing a report about the condition of a company. You
- organize the report in such a way that every department gets its own
- partial report. Every one of these parts should be introduced by an
- abstract on the corresponding title page. You could write the
- following:
+ You are writing a report about the condition of a company. You organize the
+ report in such a way that every department gets its own partial report.
+ Each of these parts should be introduced by an abstract on the corresponding
+ title page. You could write the following:
\begin{lstcode}
\setpartpreamble{%
\begin{abstract}
@@ -2423,10 +2778,10 @@ can comprise more than one paragraph. The command to output the
(see \DescPageRef{\LabelBase.option.headings}) and the options for
the \DescRef{\LabelBase.env.abstract} environment\IndexEnv{abstract} (see
\autoref{sec:\LabelBase.abstract},
- \DescPageRef{\LabelBase.option.abstract}), the result would look
- similar to:
+ \DescPageRef{\LabelBase.option.abstract}), the result will look something
+ like this:
\begin{ShowOutput}\centering
- {\LARGE\usekomafont{disposition} Part III.\par\vspace{20pt}}
+ {\LARGE\usekomafont{disposition} Part III.\par\vspace{14pt}}
{\LARGE\usekomafont{disposition} Department for Word Processing\strut\par}
\begin{quote}\small
\vspace{4ex}
@@ -2440,46 +2795,53 @@ can comprise more than one paragraph. The command to output the
\end{quote}
\end{ShowOutput}
\end{Example}
-Please\textnote{Attention!} note that it is \emph{you} who is responsible for
-the spaces between the heading, preamble and the following text. Please note
-also that there is no \DescRef{\LabelBase.env.abstract} environment in the
-class \Class{scrbook} (see \autoref{sec:\LabelBase.abstract},
+Please\textnote{Attention!} note that \emph{you} are responsible for the
+spacing between the heading, preamble, and the following text. Note also that
+there is no \DescRef{\LabelBase.env.abstract} environment in the
+\Class{scrbook} class (see \autoref{sec:\LabelBase.abstract},
\DescPageRef{\LabelBase.env.abstract}).
-The\ChangedAt{v2.8p}{\Class{scrbook}\and\Class{scrreprt}} first
-optional argument \PName{position} determines the position at which
-the preamble is placed with the help of one or two letters. For the
-vertical placement there are two possibilities at present:
+The\ChangedAt{v2.8p}{\Class{scrbook}\and\Class{scrreprt}} first optional
+argument, \PName{position}, determines the position at which the preamble
+is placed with the help of one or two letters. For vertical placement
+there are two possibilities at present:
\begin{labeling}[~--]{\quad\PValue{o}}\itemsep=0pt
\item [\quad\texttt{o}] above the heading
\item [\quad\texttt{u}] below the heading
\end{labeling}
-You can insert one preamble above and another below a heading. For the
-horizontal placement you have the choice between three alignments:
+You can therefore put one preamble above and another below a heading. For
+horizontal placement you have three options:
\begin{labeling}[~--]{\quad\PValue{o}}\itemsep=0pt
\item [\quad\texttt{l}] left-aligned
\item [\quad\texttt{r}] right-aligned
-\item [\quad\texttt{c}] centered
+\item [\quad\texttt{c}] centred
\end{labeling}
-However, this does not output the text of the \PName{preamble} in such
-a manner, but inserts a box whose width is determined by the second
-optional argument \PName{width}. If you leave out this second argument
-the whole text width is used. In that case the option for horizontal
-positioning will have no effect. You can combine exactly one letter
-from the vertical with one letter from the horizontal positioning.
-
-A more often usage of \Macro{setchapterpreamble} would be something like a
-smart slogan or dictum to a heading. The command
-\DescRef{\LabelBase.cmd.dictum}\IndexCmd{dictum}, that may be used for this,
-will be described at the next section. You will also find an example there.
+This setting does not affect the alignment of the text in the
+\PName{preamble}. Instead, it aligns the box that contains the preamble. The
+width of this box is determined by the second optional argument,
+\PName{width}. If you omit this second argument, the box uses the full text
+width. In that case, the option for horizontal positioning has no effect. You
+can combine exactly one letter from the vertical with one letter from the
+horizontal positioning.
+
+A typical use for \Macro{setchapterpreamble} would be something like an
+epigraph, a wise saying, or a dictum. The
+\DescRef{\LabelBase.cmd.dictum}\IndexCmd{dictum} command, which you can use
+for this purpose, is described in the next section. You will also find an
+example there.
Please note\textnote{Attention!} that a \PName{preamble} placed above the
-chapter headings will be set into the already existing vertical space above
-the heading. The heading will not be moved down. It is you who is responsible
-for ensuring that the preamble is small enough and the space is
-sufficient. See also \DescRef{maincls-experts.cmd.chapterheadstartvskip} in
+heading is set within the existing vertical space above the heading. The
+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},
-\DescPageRef{maincls-experts.cmd.chapterheadstartvskip} for this.%
+\autoref{tab:maincls-experts.declarechapterstyle.keys},
+\autopageref{tab:maincls-experts.declarechapterstyle.keys}.
+%
+%
+\EndIndexGroup
%
\EndIndexGroup
@@ -2488,39 +2850,40 @@ sufficient. See also \DescRef{maincls-experts.cmd.chapterheadstartvskip} in
\LoadCommonFile{lists}% \section{Lists}
-
-\section{Math}
+\section{Mathematics}
\seclabel{math}%
\BeginIndexGroup
\BeginIndex{}{equations}%
\BeginIndex{}{formulas}%
\BeginIndex{}{mathematics}%
-There are no math environments implemented in the \KOMAScript{}
-classes. Instead of this, the math features of the \LaTeX{} kernel have been
-supported. With this also, the options \DescRef{\LabelBase.option.leqno} and
-\DescRef{\LabelBase.option.fleqn} are available.
-
-You will not find a description of the math environments of the \LaTeX{} kernel
-here. If you want to use \Environment{displaymath}\IndexEnv{displaymath},
-\Environment{equation}\IndexEnv{equation}, and
-\Environment{eqnarray}\IndexEnv{eqnarray} you should read a short introduction
-into \LaTeX{} like \cite{lshort}. But\textnote{Hint!} if you want more than
-very simple mathematics, usage of package \Package{amsmath} would be
-recommended (see \cite{package:amsmath}).
+\KOMAScript{} classes do not provide their own environments for formulas,
+systems of equations, or similar mathematical elements. Instead, \KOMAScript{}
+relies fully on the maths features of the \LaTeX{} kernel. This also applies to
+the the options \DescRef{\LabelBase.option.leqno} and
+\DescRef{\LabelBase.option.fleqn}.
+
+You will not find a description of the maths environments of the \LaTeX{}
+kernel here. If you want to use
+\Environment{displaymath}\IndexEnv{displaymath},
+\Environment{equation}\IndexEnv{equation}, or
+\Environment{eqnarray}\IndexEnv{eqnarray} you should read an introduction to
+\LaTeX{} like \cite{lshort}. But\textnote{Hint!} if you want more than very
+simple mathematics, you should use the \Package{amsmath} package (see
+\cite{package:amsmath}).
\begin{Declaration}
\Option{leqno}
\end{Declaration}%
-Equations are normally numbered\Index{equation>number} on the right. The
-standard option \Option{leqno} causes the standard option file
-\File{leqno.clo} to be loaded. The equations are then numbered on the
-left. This\textnote{Attention!} option has to be used as an optional argument
-of \DescRef{\LabelBase.cmd.documentclass}. Usage as an argument of
-\DescRef{\LabelBase.cmd.KOMAoptions} or \DescRef{\LabelBase.cmd.KOMAoption} is
-not supported. This would not make sense, because the recommended math package
-\Package{amsmath} supports the option at loading time only too and would not
-react on run-time changes of the option.
+Equations are normally numbered\Index{equation>number} on the right. The
+\Option{leqno} option loads the standard option file \File{leqno.clo}. The
+equations are then numbered on the left. You\textnote{Attention!} must use
+this option as an optional argument of \DescRef{\LabelBase.cmd.documentclass}.
+Using it as an argument of \DescRef{\LabelBase.cmd.KOMAoptions} or
+\DescRef{\LabelBase.cmd.KOMAoption} is not supported. The latter
+would not make sense because the recommended maths package \Package{amsmath}
+can only respond to this option at load time and does not react to run-time
+changes of the option.
%
\EndIndexGroup
@@ -2528,293 +2891,296 @@ react on run-time changes of the option.
\begin{Declaration}
\Option{fleqn}
\end{Declaration}%
-Displayed equations\Index{equation>alignment} are normally centered. The
-standard option \Option{fleqn} causes the standard option file
-\File{fleqn.clo} to be loaded. Displayed equations are then
-left-justified. This option may be used as an optional argument of
-\DescRef{\LabelBase.cmd.documentclass} but not as an argument of
-\DescRef{\LabelBase.cmd.KOMAoptions} or \DescRef{\LabelBase.cmd.KOMAoption}.
-The latter would not make sense, because the recommended math package
-\Package{amsmath} supports the option at loading time only too and would not
-react on run-time changes of the option.
+Displayed equations\Index{equation>alignment} are normally centred. The
+standard option \Option{fleqn} loads the standard option file
+\File{fleqn.clo}. Displayed equations are then left-justified.
+You\textnote{Attention!} must use this option as an optional argument of
+\DescRef{\LabelBase.cmd.documentclass}. Using it as an argument of
+\DescRef{\LabelBase.cmd.KOMAoptions} or \DescRef{\LabelBase.cmd.KOMAoption} is
+not supported. The latter would not make sense because the recommended maths
+package \Package{amsmath} can only respond to this option at load time and
+does not react to run-time changes of the option.
%
\EndIndexGroup
%
\EndIndexGroup
-\section{Floating Environments of Tables and Figures}
+\section{Floating Environments for Tables and Figures}
\seclabel{floats}
\BeginIndexGroup
\BeginIndex{}{floats}%
\BeginIndex{}{tables}%
\BeginIndex{}{figures}%
-With the floating environments, {\LaTeX} offers a very capable and comfortable
-mechanism for automatic placement of figures\Index{figure} and
-tables\Index{table}.
+With the floating environments, {\LaTeX} offers a powerful and convenient
+mechanism to arrange figures\Index{figure} and tables\Index{table}
+automatically.
% Im Deutschen ist hier ein Absatz, den wir nicht uebernehmen!
-But\textnote{Attention!} often these floating environments\Index[indexmain]
-{floating environments} are slightly misunderstood by beginners. They often
-ask for a fixed position of a table or figure within the text. However, since
-these floating environments are being referenced in the text this is not
-necessary in most cases. It is also not sensible because such an object can
-only be set on the page if there is enough space left for it. If this is not
-the case the object would have to be shifted onto the next page, thereby
-possibly leaving a huge blank space on the page before.
-
-Often\textnote{Attention!} one finds in a document for every floating object
-the same optional argument for positioning the object. This also makes no
-sense. In such cases one should rather change the standard parameter
-globally. For more details refer to \cite{DANTE:FAQ}.
+Frequently,\textnote{Attention!} beginners do not properly understand these
+floating environments\Index[indexmain]{floating environments}. They often ask
+to specify the exact position of a table or figure within the text. However,
+this is usually unnecessary, since the text will contain references to these
+floating environments. It is also not sensible because such an object can only
+be set on the page if there is enough space left for it. If this is not the
+case, the object would have to be shifted onto the next page, possibly leaving
+a huge empty space on the previous page.
+
+Often\textnote{Attention!} a document will use the same optional argument to
+position every floating object. This also makes no sense. In such cases, you
+should instead change the default value globally. For more details, see
+\cite{DANTE:FAQ}.
+
+One\textnote{Attention!} final, important note before starting this section:
+most of mechanisms described here, which extend the capabilities of the
+standard classes, no longer work correctly when used with packages that modify
+the appearance of figure and table captions. This should be self-evident, but
+it is often overlooked.
-One\textnote{Attention!} last important note before starting this section:
-most mechanisms described here which extend the capabilities of the standard
-classes no longer work correctly when used together with packages which modify
-the typesetting of captions of figures and tables. This should be self
-evident, but it is often not understood.
\begin{Declaration}
- \OptionVName{captions}{selection}
+ \OptionVName{captions}{setting}
\end{Declaration}
-The standard classes format titles of floating environments, which are placed
-with \DescRef{\LabelBase.cmd.caption}\IndexCmd{caption} (see below), like signatures. They
-differentiate between one-line and multi-line table or figure
-captions. One-line captions are centered while multi-line captions are
-left-justified.
-
-\leavevmode\phantomsection\nobreak
-\label{desc:\LabelBase.option.captions.tableheading}\nobreak
-For tables, however, headings are often used. That's because there may
-be tables that span several pages. Surely the reader wants to know the
-purpose of the table at the first page already. Furthermore tables
-will be read row by row from top down to bottom. So there are at least
-two good reasons to generally use table
-headings. \KOMAScript{}\important{\OptionValue{captions}{tableheading}}
-therefor supports option \OptionValue{captions}{tableheading}%
-\IndexOption{captions~=\PValue{tableheading}}, which changes the
-caption format into headings at tables only.
-
-Please note\textnote{Attention!} that multi-page tabulars may not use any
-floating environment. To have an automatic page break at any kind of tabular you
-also need additional packages like \Package{longtable}\IndexPackage{longtable}
-(see \cite{package:longtable}) or \Package{tabu}\IndexPackage{tabu} (see
-\cite{package:tabu}).
-
-You may switch back\important[i]{\begin{tabular}[t]{@{}l@{}}
- \Option{captions=}\\
- \quad\PValue{tablesignature}
- \end{tabular}} to the default table signatures using
-\OptionValue{captions}{tablesignature}%
-\IndexOption{captions~=\PValue{tablesignature}}.
-Note\textnote{Attention!} that using any of these options does not change the position of
-the caption from above the top of the table to below the bottom of the
-table or vice versa. It only affects whether the text is formatted as
-a caption for use above or below a table. Whether the text is in fact
-placed above or below a table is set through the position of the
-\DescRef{\LabelBase.cmd.caption} command inside the \Environment{table} environment. This may
-change using package \Package{float}\IndexPackage{float} and command
-\Macro{restylefloats} (see \cite{package:float}).
-
-Of course similar features exist\ChangedAt{v3.09}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}} for figures using options
+In the standard classes, the titles of floating environments, which are
+formatted with the \DescRef{\LabelBase.cmd.caption}\IndexCmd{caption} command
+(see below), are set off from the float with vertical spacing appropriate for
+putting the caption beneath the float, like a signature. They also distinguish
+between one-line and multi-line captions. One-line captions are centred while
+multi-line captions are left-justified.
+
+\leavevmode\LabelOptionValue{captions}{tableheading}\nobreak%
+For tables, however, you want the caption%
+\important{\Option{captions}{tableheading}} to appear as a heading instead of
+a signature. That's because tables can span multiple pages. With such tables,
+the reader wants to know the purpose of the table on the first page.
+Furthermore, tables are usually read row by row, from top to bottom. So there
+are normally at least two good reasons to provide all tables with headings.
+\KOMAScript{} therefore offers the \OptionValue{captions}{tableheading}%
+\IndexOption{captions~=\textKValue{tableheading}} option, which changes the
+formatting of table captions for use above the table.
+
+Note\textnote{Attention!} that multi-page tabulars cannot use a floating
+environment. To have an automatic page break in a tabular you need an
+additional package like \Package{longtable}\IndexPackage{longtable} (see
+\cite{package:longtable}) or \Package{supertabular}\IndexPackage{supertabular}
+(see \cite{package:supertabular}).
+
+You\important{\OptionValue{captions}{tablesignature}} can switch back to the
+default caption formatting using \OptionValue{captions}{tablesignature}%
+\IndexOption{captions~=\textKValue{tablesignature}}. Note\textnote{Attention!}
+that these options change only the formatting, not the actual position of the
+caption. Whether the caption is placed above or below a float depends solely
+upon where you use the \DescRef{\LabelBase.cmd.caption} command inside float
+environment. However, this can change when using the \Package{float}%
+\IndexPackage{float} package with the \Macro{restylefloats} command (see
+\cite{package:float}).
+
+Of course\important{\OptionValue{captions}{figureheading}\\
+ \OptionValue{captions}{figuresignature}}, corresponding functions
+exist\ChangedAt{v3.09}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} for figures using the options
\OptionValue{captions}{figureheading}%
-\IndexOption{captions~=\PValue{figureheading}} and
+\IndexOption{captions~=\textKValue{figureheading}} and
\OptionValue{captions}{figuresignature}%
-\IndexOption{captions~=\PValue{figuresignature}}. Nevertheless,
-figures like photos will be viewed as a whole, and a diagram or graph
-will mostly be examined from left bottom to the right. Therefore, in
-general, signatures should be used and it would not be useful to change
-the caption format from signatures to headings.
-
-Nevertheless sometimes all floating environments shall use headings. For this
-\KOMAScript{} supports\ChangedAt{v3.09}{\Class{scrbook}\and
+\IndexOption{captions~=\textKValue{figuresignature}}. However, figures such as
+photos tend to be viewed as a whole, and a diagram or graph will mostly be
+examined starting from the lower left. Therefore, it only rarely makes sense
+to change the caption format for figures alone from signatures to headings.
+
+Sometimes, however, all floating environments should use headings. Therefore
+\KOMAScript{} provides\ChangedAt{v3.09}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}}
-options\important[i]{\OptionValue{captions}{heading}\\
- \OptionValue{captions}{signature}}
-\OptionValue{captions}{heading}\IndexOption{captions~=\PValue{heading}} and
-\OptionValue{captions}{signature}\IndexOption{captions~=\PValue{signature}} to
-switch the format of every floating environment. These options may be used
-also inside a floating environment but before using \DescRef{\LabelBase.cmd.caption}.
-
-Note\textnote{Attention!}\OnlyAt{\Package{float}}\IndexPackage{float} that
-when using the \Package{float} package, the options
-\OptionValue{captions}{tablesignature} and
-\OptionValue{captions}{tableheading} cease to act correctly when
-\Macro{restylefloat} is applied to tables. More details of the \Package{float}
-package and \Macro{restylefloat} can be found in
-\cite{package:float}. Additional support in {\KOMAScript} for the
-\Package{float} package may be found at the explanation of \PValue{komaabove}
-(see \DescPageRef{\LabelBase.floatstyle.komaabove}).
-
-\leavevmode\phantomsection\nobreak
-\label{desc:\LabelBase.option.captions.nooneline}\nobreak
-\label{desc:\LabelBase.option.captions.oneline}\nobreak
-Furthermore, \KOMAScript{} supports to switch off the distinguish of captions
-with only one line or more than one line using option
-\OptionValue{captions}{nooneline}\IndexOption{captions~=\PValue{nooneline}}%
-\important{\OptionValue{captions}{nooneline}}. This may be useful, if one-line
-captions should not be centered. The default of centering one-line captions
-corresponds to \OptionValue{captions}{oneline}.
-
-Another special feature of \KOMAScript{} is to alternatively put the caption
-neither above nor below the floating object but beside
-it. For this you need Environment\important{\DescRef{\LabelBase.env.captionbeside}}
-\DescRef{\LabelBase.env.captionbeside}\IndexEnv{captionbeside}, that will be described
-from \DescPageRef{\LabelBase.env.captionbeside}. Several settings
-for this environment may be done also using \Option{caption}. You may find all
-the available \PName{settings} at \autoref{tab:\LabelBase.captions}.
+options\important{\OptionValue{captions}{heading}\\
+ \OptionValue{captions}{signature}}
+\OptionValue{captions}{heading}\IndexOption{captions~=\textKValue{heading}}
+and \OptionValue{captions}{signature}%
+\IndexOption{captions~=\textKValue{signature}} to switch the format of every
+floating environment. These options can also be used inside a floating
+environment.
+
+Please note\textnote{Achtung!}\OnlyAt{\Package{float}}\IndexPackage{float}
+when using the \Package{float} package that the settings for signatures or
+headings will no longer work once \Macro{restylefloat} is applied to tables or
+figures. For details about the \Package{float} package and
+\Macro{restylefloat}, please refer to \cite{package:float}. This also applies
+to \DescRef{\LabelBase.cmd.caption} within new floating environments defined
+with \Package{float}. You can find additional support which \KOMAScript{}
+provides when using the \Package{float} package in the explanation of
+\PValue{komaabove} (see \DescPageRef{\LabelBase.floatstyle.komaabove}). As an
+alternative to \Package{float}, you can also consult
+\DescRef{\LabelBase.cmd.captionof} (see
+\DescPageRef{\LabelBase.cmd.captionof}) and
+\DescRef{tocbasic.cmd.DeclareNewTOC} (see
+\DescPageRef{tocbasic.cmd.DeclareNewTOC}). Additionally, when using
+\Package{float}, the
+\hyperref[cha:scrhack]{\Package{scrhack}}\IndexPackage{scrhack}%
+\important{\hyperref[cha:scrhack]{\Package{scrhack}}} package is
+expressly recommended (see \autoref{cha:scrhack} from
+\autopageref{cha:scrhack} in \autoref{part:forExperts}).
+
+\leavevmode
+\LabelOptionValue{captions}{nooneline}\nobreak
+\LabelOptionValue{captions}{oneline}\nobreak
+Furthermore\important{\OptionValue{captions}{nooneline}}, \KOMAScript{} offers
+the option to disable the distinction between one-line and multi-line captions
+using the \OptionValue{captions}{nooneline}%
+\IndexOption{captions~=\textKValue{nooneline}}%
+\important{\OptionValue{captions}{nooneline}} option. This can be useful, for
+example, if you do not want one-line captions to be centred. The default,
+where one-line captions are centred, corresponds to
+\OptionValue{captions}{oneline}.
+
+Another special feature of \KOMAScript{} is the ability to put the caption
+beside the floating object rather than above or below it. For this, you need
+the environment\important{\DescRef{\LabelBase.env.captionbeside}}
+\DescRef{\LabelBase.env.captionbeside}\IndexEnv{captionbeside}, which is
+explained starting on \DescPageRef{\LabelBase.env.captionbeside}. The settings
+for this environment can also be changed with the \Option{caption} option. You
+can find the available values for the corresponding \PName{settings} in
+\autoref{tab:\LabelBase.captions}.
%
\begin{desclist}
- \desccaption[{Available values for option \Option{captions}}]{%
- Available values for option \Option{captions} to select formation of
- captions as headings or signatures at floating environments%
+ \desccaption[{Available values for the \Option{captions}} option]{%
+ Available values for the \Option{captions} option for setting formatting of
+ captions as headings or signatures in floating environments%
\label{tab:\LabelBase.captions}%
}{%
- Available values for option \Option{captions} (\emph{continuation})%
+ Available values for the \Option{captions} option (\emph{continued})%
}%
\entry{\PValue{bottombeside}, \PValue{besidebottom}}{%
- Captions and contents of environment
- \DescRef{\LabelBase.env.captionbeside} (see
- \autoref{sec:\LabelBase.floats},
- \DescPageRef{\LabelBase.env.captionbeside}) will be vertically align
- depending on the bottommost base lines.%
- \IndexOption{captions~=\PValue{bottombeside}}}%
+ Captions for the \DescRef{\LabelBase.env.captionbeside} environment (see
+ \autoref{sec:\LabelBase.floats},
+ \DescPageRef{\LabelBase.env.captionbeside}) are vertically aligned with
+ the bottommost baseline of the contents of the floating environment.%
+ \IndexOption{captions~=\textKValue{bottombeside}}}%
\entry{\PValue{centeredbeside}, \PValue{besidecentered},
\PValue{middlebeside}, \PValue{besidemiddle}}{%
- Captions and contents of environment
- \DescRef{\LabelBase.env.captionbeside} (see
+ Captions for the \DescRef{\LabelBase.env.captionbeside} environment (see
\autoref{sec:\LabelBase.floats},
- \DescPageRef{\LabelBase.env.captionbeside}) will be vertically centered%
- \IndexOption{captions~=\PValue{centeredbeside}}}%
+ \DescPageRef{\LabelBase.env.captionbeside}) are vertically aligned with
+ the center of the contents of the floating environment.%
+ \IndexOption{captions~=\textKValue{centeredbeside}}}%
\entry{\PValue{figureheading}, \PValue{figureabove}, \PValue{abovefigure},
\PValue{topatfigure}%
- \IndexOption{captions~=\PValue{figureheading}}}{%
+ \IndexOption{captions~=\textKValue{figureheading}}}{%
\ChangedAt{v3.09}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
- Captions of figures will use heading formation\,---\,maybe in discrepancy
- to \OptionValue{captions}{signature}.%
+ Captions for figures use heading format\,---\,possibly deviating from
+ \OptionValue{captions}{signature}.%
}%
\entry{\PValue{figuresignature}, \PValue{belowfigure},
\PValue{bottomatfiggure}%
- \IndexOption{captions~=\PValue{figuresignature}}}{%
+ \IndexOption{captions~=\textKValue{figuresignature}}}{%
\ChangedAt{v3.09}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
- Captions of figures will use signature formation\,---\,maybe in
- discrepancy to \OptionValue{captions}{headings}.%
+ Captions for figures use signature format\,---\,possibly deviating
+ from \OptionValue{captions}{headings}.%
}%
\entry{\PValue{heading}, \PValue{above}, \PValue{top}%
- \IndexOption{captions~=\PValue{heading}}}{%
+ \IndexOption{captions~=\textKValue{heading}}}{%
\ChangedAt{v3.09}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} Captions of floating environments will use heading
- formation. Nevertheless this does not influence whether they are really
- placed at the top or at the bottom of the object. This options also
+ \Class{scrartcl}} Captions for floating environments use formatting
+ suitable for use in a heading. This setting does not control whether they
+ are placed at the top or the bottom of the object. This option also
implies \OptionValue{captions}{tableheading} and
\OptionValue{captions}{figureheading}.%
}%
\entry{\PValue{innerbeside},
- \PValue{besideinner}\IndexOption{captions~=\PValue{innerbeside}}}{%
- Captions of environment \DescRef{\LabelBase.env.captionbeside} (siehe
+ \PValue{besideinner}\IndexOption{captions~=\textKValue{innerbeside}}}{%
+ Captions for the \DescRef{\LabelBase.env.captionbeside} environment (see
\autoref{sec:\LabelBase.floats},
- \DescPageRef{\LabelBase.env.captionbeside}) will be placed innermost
- beside the contents of the environment at double-side printing. At
- single-side printing \OptionValue{captions}{leftbeside} will be used.%
+ \DescPageRef{\LabelBase.env.captionbeside}) are placed inside of and next
+ to the contents of the environment in two-sided printing. In one-sided
+ printing, \OptionValue{captions}{leftbeside} is used.%
}%
\entry{\PValue{leftbeside},
- \PValue{besideleft}\IndexOption{captions~=\PValue{leftbeside}}}{%
- Captions of environment \DescRef{\LabelBase.env.captionbeside} (siehe
+ \PValue{besideleft}\IndexOption{captions~=\textKValue{leftbeside}}}{%
+ Captions for the \DescRef{\LabelBase.env.captionbeside} environment (see
\autoref{sec:\LabelBase.floats},
- \DescPageRef{\LabelBase.env.captionbeside}) will be placed left beside the
- contents of the environment.%
+ \DescPageRef{\LabelBase.env.captionbeside}) are placed to the left of
+ the contents of the floating environment.%
}%
\pventry{nooneline}{%
- Captions with only one line will not be handled different from captions
- with more than one line.%
- \IndexOption{captions~=\PValue{nooneline}}}%
+ Single-line captions are handled the same as multi-line captions.%
+ \IndexOption{captions~=\textKValue{nooneline}}}%
\pventry{oneline}{%
- Captions with only one line will be centered horizontally.%
- \IndexOption{captions~=\PValue{oneline}}}%
+ Single-line captions are centred horizontally.%
+ \IndexOption{captions~=\textKValue{oneline}}}%
\entry{\PValue{outerbeside}, \PValue{besideouter}%
- \IndexOption{captions~=\PValue{outerbeside}}}{%
- Captions of environment \DescRef{\LabelBase.env.captionbeside} (siehe
+ \IndexOption{captions~=\textKValue{outerbeside}}}{%
+ Captions for the \DescRef{\LabelBase.env.captionbeside} environment (see
\autoref{sec:\LabelBase.floats},
- \DescPageRef{\LabelBase.env.captionbeside}) will be placed outermost
- beside the contents of the environment at double-side printing. At
- single-side printing \OptionValue{captions}{rightbeside} will be used.%
+ \DescPageRef{\LabelBase.env.captionbeside}) are placed outside of and
+ next to the contents of the environment in two-sided printing. In
+ one-sided printing, \OptionValue{captions}{rightbeside} is used.%
}%
\entry{\PValue{rightbeside}, \PValue{besideright}%
- \IndexOption{captions~=\PValue{rightbeside}}}{%
- Captions of environment \DescRef{\LabelBase.env.captionbeside} (siehe
+ \IndexOption{captions~=\textKValue{rightbeside}}}{%
+ Captions for the \DescRef{\LabelBase.env.captionbeside} environment (see
\autoref{sec:\LabelBase.floats},
- \DescPageRef{\LabelBase.env.captionbeside}) will be placed right beside
- the contents of the environment.%
+ \DescPageRef{\LabelBase.env.captionbeside}) are placed to the right of the
+ contents of the floating environment.%
}%
\entry{\PValue{signature}, \PValue{below}, \PValue{bot}, \PValue{bottom}%
- \IndexOption{captions~=\PValue{signature}}}{%
+ \IndexOption{captions~=\textKValue{signature}}}{%
\ChangedAt{v3.09}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
- Captions of floating environments will use signature
- formation. Nevertheless this does not influence whether they are really
- placed at the top or at the bottom of the object. This options also
- implies \OptionValue{captions}{tablesignature} and
- \OptionValue{captions}{figuresignature}.%
+ Captions for floating environments use signature format. This setting
+ does not control whether they are placed at the top or the bottom of the
+ object. This options also implies \OptionValue{captions}{tablesignature}
+ and \OptionValue{captions}{figuresignature}.%
}%
\entry{\PValue{tableheading}, \PValue{tableabove}, \PValue{abovetable},
\PValue{abovetabular}, \PValue{topattable}%
- \IndexOption{captions~=\PValue{tableheading}}}{%
- Captions of tables will use heading formation\,---\,maybe in discrepancy
- to \OptionValue{captions}{signature}.%
+ \IndexOption{captions~=\textKValue{tableheading}}}{%
+ Captions for tables use heading format\,---\,possibly deviating from
+ \OptionValue{captions}{signature}.%
}%
\entry{\PValue{tablesignature}, \PValue{belowtable}, \PValue{belowtabular},
\PValue{bottomattable}%
- \IndexOption{captions~=\PValue{tablesignature}}}{%
- Captions of tables will use signature formation\,---\,maybe in discrepancy
- to \OptionValue{captions}{heading}.%
+ \IndexOption{captions~=\textKValue{tablesignature}}}{%
+ Captions for tables use signature format\,---\,possibly deviating
+ from \OptionValue{captions}{heading}.%
}%
\entry{\PValue{topbeside}, \PValue{besidetop}}{%
- Captions and contents of environment
- \DescRef{\LabelBase.env.captionbeside} (see
+ Captions for the \DescRef{\LabelBase.env.captionbeside} environment (see
\autoref{sec:\LabelBase.floats},
- \DescPageRef{\LabelBase.env.captionbeside}) will be vertically align
- depending on the topmost base lines.%
- \IndexOption{captions~=\PValue{topbeside}}}%
+ \DescPageRef{\LabelBase.env.captionbeside}) are vertically aligned to the
+ baseline at the top of the floating environment.%
+ \IndexOption{captions~=\textKValue{topbeside}}}%
\end{desclist}%
%
\EndIndexGroup
\begin{Declaration}
- \Macro{caption}\OParameter{entry}\Parameter{title}%
- \Macro{captionbelow}\OParameter{entry}\Parameter{title}%
+ \Macro{caption}\OParameter{entry}\Parameter{title}
+ \Macro{captionbelow}\OParameter{entry}\Parameter{title}
\Macro{captionabove}\OParameter{entry}\Parameter{title}
\end{Declaration}%
-In the standard classes caption text \PName{title} of tables and
-figures is inserted with the \Macro{caption} command below the table
-or figure. In general this is correct for figures. Opinions differ as
-to whether captions of tables are to be placed above or, consistent
-with captions of figures\Index{caption>of figure}, below the
-table\Index{caption>of table}. That is the reason why
+In the standard classes, tables and figures are given captions with the
+\Macro{caption} command placed below the table or figure. For figures, this is
+generally correct. For tables, opinions differ as to whether captions should
+be placed above the table or, consistent with captions of
+figures\Index{caption>of figure}, below it\Index{caption>of table}. Therefore
{\KOMAScript}\textnote{\KOMAScript{} vs. standard classes},
unlike the standard classes, offers \Macro{captionbelow} for captions
below and \Macro{captionabove} for captions above tables or
figures.
-Not only for tables but also for figures or all kind of floating environments
-the behaviour of \Macro{caption} may be modified using option
-\DescRef{\LabelBase.option.captions}\IndexOption{captions} described at the beginning of this
-section. For
-compatibility reasons the default behaviour of \Macro{caption} used
-with all kinds of floating environments is similar to
-\Macro{captionbelow}. Nevertheless it
-is recommended\textnote{Hint!} to use table headings and therefor switch
-behaviour of \Macro{caption} inside table environments into
-\Macro{captionabove} using option
-\OptionValueRef{\LabelBase}{captions}{tableheading}. Alternatively you may use
-\Macro{captionabove} instead of \Macro{caption} inside of every
-\Environment{table} environment.
+For tables and figures, or in general for all floating environments, you can
+control the behaviour of \Macro{caption} with the
+\DescRef{\LabelBase.option.captions}\IndexOption{captions} option described at
+the beginning of this section. For compatibility reasons, the default
+behaviour of \Macro{caption} for all floating environments is like
+\Macro{captionbelow}. However, you\textnote{Hint!} should use the
+\OptionValueRef{\LabelBase}{captions}{tableheading} option, which switches the
+behaviour of \Macro{caption} inside table environments to
+\Macro{captionabove}. Alternatively, you can use \Macro{captionabove} instead
+of \Macro{caption} inside every \Environment{table} environment.
%
\begin{Example}
- Instead of using captions below a table you want to place your
+ Instead of using captions below a table, you want to place your
captions above it\Index{table>caption}, because you have tables
which span more then one page. In the standard classes you could
only write:
@@ -2828,7 +3194,7 @@ behaviour of \Macro{caption} inside table environments into
\end{tabular}
\end{table}
\end{lstcode}
- Then you would get the unsatisfying result:
+ Then you would get this unsatisfying result:
\begin{ShowOutput}\centering
{\usekomafont{caption}{\usekomafont{captionlabel}\tablename~30.2:}
This is an example table.}\\
@@ -2860,13 +3226,12 @@ behaviour of \Macro{caption} inside table environments into
\end{tabular}
\end{ShowOutput}
Since you want all your tables typeset with captions above, you could
- of course use the option \OptionValueRef{\LabelBase}{captions}{tableheading} instead (see
- \DescPageRef{\LabelBase.option.captions.tableheading}). Then you can use
- \Macro{caption} as you would in the standard classes. You will get
- the same result as with \Macro{captionabove}.
+ of course use the \OptionValueRef{\LabelBase}{captions}{tableheading} option
+ instead (see \DescPageRef{\LabelBase.option.captions.tableheading}). Then
+ you can use \Macro{caption} as you would in the standard classes. You will
+ get the same result as with \Macro{captionabove}.
\end{Example}
-\BeginIndexGroup
\BeginIndex[indexother]{}{font>style}%
\BeginIndex{FontElement}{caption}\LabelFontElement{caption}%
\BeginIndex{FontElement}{captionlabel}\LabelFontElement{captionlabel}%
@@ -2875,20 +3240,19 @@ The font style\ChangedAt{v2.8p}{%
and the label\,---\,``Figure'' or ``Table'', followed by the number and the
delimiter\,---\,can be changed with the commands
\DescRef{\LabelBase.cmd.setkomafont} and
-\DescRef{\LabelBase.cmd.addtokomafont} (see \autoref{sec:\LabelBase.textmarkup},
+\DescRef{\LabelBase.cmd.addtokomafont} (see
+\autoref{sec:\LabelBase.textmarkup},
\DescPageRef{\LabelBase.cmd.setkomafont}). The respective elements for this
-are \FontElement{caption}\important{\FontElement{caption}} and
-\FontElement{captionlabel}\important{\FontElement{captionlabel}} (see
-\autoref{tab:\LabelBase.fontelements}, \autopageref{tab:\LabelBase.fontelements}).
-First the font style for the element \FontElement{caption} is applied to the
-element \FontElement{captionlabel} too. After this the font style of
-\FontElement{captionlabel} is applied on the respective element. The default
-settings are listed in \autoref{tab:\LabelBase.captionFont}.
+are \FontElement{caption}\important[i]{\FontElement{caption}\\
+ \FontElement{captionlabel}} and \FontElement{captionlabel} (see
+\autoref{tab:\LabelBase.fontelements},
+\autopageref{tab:\LabelBase.fontelements}). The font style for the element
+\FontElement{caption} is applied to the element \FontElement{captionlabel}
+before the font style of \FontElement{captionlabel} itself is applied. The
+default settings are listed in \autoref{tab:\LabelBase.captionFont}.
%
\begin{table}
% \centering%
- \KOMAoptions{captions=topbeside}%
- \setcapindent{0pt}
% \caption
\begin{captionbeside}
{Font defaults for the elements of figure or table captions}
@@ -2919,10 +3283,7 @@ settings are listed in \autoref{tab:\LabelBase.captionFont}.
\end{lstcode}
As you can see, simple extensions of the default definitions are
possible.
-\end{Example}
-%
-\EndIndexGroup
-%
+\end{Example}%
\EndIndexGroup
@@ -2934,38 +3295,39 @@ settings are listed in \autoref{tab:\LabelBase.captionFont}.
\Macro{captionaboveof}\Parameter{float type}\OParameter{entry}%
\Parameter{title}
\end{Declaration}%
-\KOMAScript{} supports a command
-\Macro{captionof}\ChangedAt{v3.05}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} similar to packages
-\Package{caption}\IndexPackage{caption} and
-\Package{capt-of}\IndexPackage{capt-of}. You may use this command to place a
-floating environment caption with corresponding entry into the list of that
-kind of floating environment but even inside a another floating environment or
-outside any floating environment. In difference to \DescRef{\LabelBase.cmd.caption} the kind of
-floating environment has to be set as first parameter.
-
-Furthermore, \KOMAScript{} provides the additional commands
+Like\ChangedAt{v3.05}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} the \Package{caption}\IndexPackage{caption} and
+\Package{capt-of}\IndexPackage{capt-of} packages, \KOMAScript{} offers the
+\Macro{captionof} command, with which you can put a caption for a floating
+environment, together with an entry in the corresponding environment list,
+outside of the floating environment or even in a different floating
+environment. Unlike \DescRef{\LabelBase.cmd.caption}, the type of floating
+environment must be specified as the first parameter.
+
+In addition, \KOMAScript{} also provides the commands
\Macro{captionaboveof}\ChangedAt{v3.09}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}} and \Macro{captionbelowof}. These are
-like \Macro{captionabove} and \Macro{captionbelow} but with the additional
-features and parameter of \Macro{captionof}.
-
-Of course \KOMAScript\ChangedAt{v3.09a}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}} takes care of the \PValue{heading}
-and \PValue{signature} setting of option
-\DescRef{\LabelBase.option.captions}. But this feature may be lost, loading package
-\Package{capt-of} or \Package{caption}. Please note the manual of package
-\Package{caption} for this!
-%
+like \DescRef{\LabelBase.cmd.captionabove} and
+\DescRef{\LabelBase.cmd.captionbelow} but with the additional features and
+parameter of \Macro{captionof}.
+
+Of course\ChangedAt{v3.09a}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} \Macro{captionof} takes into account the \PValue{heading}
+and \PValue{signature} settings of the \DescRef{\LabelBase.option.captions}
+option. But this feature may be lost if you load the
+\Package{capt-of}\IndexPackage{capt-of} or
+\Package{caption}\IndexPackage{caption} packages. When using
+\Package{caption}, you must follow the instructions for that package (see
+\cite{package:caption})!
\begin{Example}
- Assumed you want to create a floating object with a table and a figure side
- by side. As you know, there are now mixed floating environment. Therefor you
- use a \Environment{figure} environment primarily:
+ Suppose you want to create a floating object with a table and a figure next
+ to each other. Since there are no mixed floating environments, you primarily
+ use a \Environment{figure} environment:
\begin{lstcode}
\begin{figure}
\begin{minipage}{.5\linewidth}
\centering
- \rule{4cm}{3cm}
+ \rule{4cm}{5cm}
\caption{A rectangle}\label{fig:rechteck}
\end{minipage}%
\begin{minipage}{.5\linewidth}
@@ -2977,28 +3339,28 @@ and \PValue{signature} setting of option
\label{tab:rechteck}
\begin{tabular}{ll}
Width: & 4\,cm\\
- Height: & 3\,cm
+ Height: & 5\,cm
\end{tabular}
\end{minipage}
\end{figure}
\end{lstcode}
- Two \Environment{minipage} environments have been used to have figure and
- table side by side. The\textnote{Attention!} percent char after the end of
- the first \Environment{minipage} is important. Without an additional
- inter-word distance would be made between the \Environment{minipage}
+ Two \Environment{minipage} environments were used to place the figure
+ and the table side by side. The\textnote{Attention!} percent sign after the
+ end of the first \Environment{minipage} is important. Without it, an
+ additional space would appear between the \Environment{minipage}
environments.
- The figure signature has been done using \DescRef{\LabelBase.cmd.caption}. The table heading
- has been done using \Macro{captionaboveof} with first argument
- \PValue{table}. Because of this \KOMAScript{} knows, that despite the
- \Environment{figure} environment a table caption should be made.
-
- The optional argument of \Macro{captionaboveof} does make the entry into the
- list of tables. Without the optional argument, the last mandatory argument
- would have been used for the list of tables too. Although this caption text
- is sufficient for the environment itself, it would be very useful at the
- list of tables. Therefor a somehow more detailed description has been used
- for the list of tables using the optional argument. The
+ The figure caption was created with \DescRef{\LabelBase.cmd.caption}. The
+ table caption was created with \Macro{captionaboveof} with \PValue{table}
+ as the first argument. Because of this, \KOMAScript{} knows that this is a
+ table caption even though it is inside the \Environment{figure} environment.
+
+ The optional argument of \Macro{captionaboveof} creates an entry in the
+ list of tables. Without the optional argument, the caption specified in the
+ final mandatory argument would have been used for the list of tables too.
+ Although this caption text is sufficient for the environment itself, it
+ would not be very meaningful in the list of tables. Therefore, a different
+ title is used for the list of tables using the optional argument.
\autoref{fig:\LabelBase.captionaboveof} shows the result of the example code.%
\begin{figure}
% \centering
@@ -3006,16 +3368,16 @@ and \PValue{signature} setting of option
\KOMAoptions{captions=bottombeside}%
\setcapindent{0pt}%
\begin{captionbeside}
- [{Example: Usage of \Macro{captionaboveof} inside another floating
+ [{Example: Using \Macro{captionaboveof} inside another floating
environment}]
- {Example: Usage of \Macro{captionaboveof} inside another floating
+ {Example: Using \Macro{captionaboveof} inside another floating
environment\label{fig:\LabelBase.captionaboveof}}
[l]
\begin{minipage}[b]{.66\linewidth}%
\raisebox{\depth}{\fbox{\KOMAoptions{captions=oneline}%
\begin{minipage}{.5\dimexpr\linewidth-2\fboxsep-2\fboxrule\relax}
\centering
- \rule{4cm}{3cm}
+ \rule{4cm}{5cm}
\caption[Example: A rectangle]{A rectangle}\label{fig:\LabelBase.rechteck}
\end{minipage}%
\begin{minipage}{.5\dimexpr\linewidth-2\fboxsep-2\fboxrule\relax}
@@ -3024,115 +3386,120 @@ and \PValue{signature} setting of option
figure~\ref{fig:\LabelBase.rechteck}]{Rectangle size}
\label{tab:\LabelBase.rechteck}
\begin{tabular}{ll}
- Width: & 4\,cm\\
- Height: & 3\,cm
+ Width: & 4\,cm\\
+ Height: & 5\,cm
\end{tabular}
\end{minipage}}}%
\end{minipage}%
\end{captionbeside}%
\end{figure}%
\end{Example}%
-A non-floating table with a caption may be produced in the same kind like the
-table inside a figure environment in the example above. In such a case also a
-\Environment{minipage} environment should be used, to avoid page breaks
-between table caption an tabular. An additional \Environment{flushleft}
-environment around the \Environment{minipage} environment may be used, to have
-a pleasing distance above and below is and to avoid the paragraph indentation
-of the \Environment{minipage} environment.%
-%
+You can produce a non-floating table with a caption in the same way as the
+table inside a figure environment in the example above. In such a case, a
+\Environment{minipage} environment should also be used to avoid page breaks
+between the caption and the table. In addition, you should embed the
+\Environment{minipage} environment in a \Environment{flushleft} environment
+both to achieve a pleasing separation between the surrounding text and to
+avoid the paragraph indentation of the \Environment{minipage} environment.%
\EndIndexGroup
\begin{Declaration}
- \begin{Environment}{captionbeside}%
- \OParameter{entry}\Parameter{title}%
- \OParameter{placement}\OParameter{width}%
- \OParameter{offset}
+ \begin{Environment}{captionbeside}
+ \OParameter{short title}
+ \Parameter{caption text}
+ \OParameter{placement}
+ \OParameter{width}
+ \OParameter{offset}
\end{Environment}
\labelsuffix[*]%
- \begin{Environment}{captionbeside}%
- \OParameter{entry}\Parameter{title}%
- \OParameter{placement}\OParameter{width}%
- \OParameter{offset}\PValue{*}%
+ \begin{Environment}{captionbeside}
+ \OParameter{short title}
+ \Parameter{caption text}
+ \OParameter{placement}
+ \OParameter{width}
+ \OParameter{offset}\PValue{*}%
\end{Environment}
\end{Declaration}
-Apart\ChangedAt{v2.8q}{%
- \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} from
-captions above and below the figure, one often finds captions, in
-particular with small figures, which are placed beside the figure. In
-general in this case both the baseline of the figure and of the
-caption are aligned at the bottom. With some fiddling and the use of
-two \Macro{parbox} commands this could also be achieved in the
-standard classes. However, {\KOMAScript} offers a special environment
-for this which can be used within the floating environment. The first
-optional parameter \PName{entry} and the obligatory parameter
-\PName{title} mean the same as the corresponding parameters of
-\DescRef{\LabelBase.cmd.caption}, \DescRef{\LabelBase.cmd.captionabove} or \DescRef{\LabelBase.cmd.captionbelow}. The
-caption text \PName{title} is placed beside the content of the
-environment in this case.
-
-Whether the caption text \PName{title} is placed on the left or the
-right can be determined by the parameter \PName{placement}. Exactly
+In addition\ChangedAt{v2.8q}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} to captions above and below the figure, you will often
+find captions, in particular for small figures, which are placed beside the
+figure. The bottom edge of the caption is normally aligned with the bottom of
+the figure. Of course, you can achieve the same thing in the standard classes
+with some fiddling and the use of two \Macro{parbox} commands. However,
+\KOMAScript{} offers a special environment for this which you can use within
+the floating environments. The first optional parameter,
+\PName{short title}\important{\PName{short title}\\\PName{caption text}}, and
+the required parameter \PName{caption text} have the same meaning as the
+corresponding parameters of \DescRef{\LabelBase.cmd.caption},
+\DescRef{\LabelBase.cmd.captionabove} or
+\DescRef{\LabelBase.cmd.captionbelow}. The \PName{caption text} is
+placed beside the content of the environment in this case.
+
+The \PName{placement}\important{\PName{placement}} parameter can determine
+whether the \PName{caption text} is placed on the left or the right. Exactly
one of the following letters is allowed:
-\begin{labeling}[~--]{\quad\PValue{o}}\setlength{\itemsep}{0pt}%
-\item[\PValue{l}] left
-\item[\PValue{r}] right
-\item[\PValue{i}] inner margin in two-sided layout
-\item[\PValue{o}] outer margin in two-sided layout
+\begin{labeling}[~--]{\quad\PValue{o}}\setlength{\itemsep}{-1\parsep plus 1ex}%
+ \item[\PValue{l}] left
+ \item[\PValue{r}] right
+ \item[\PValue{i}] inner margin in two-sided printing
+ \item[\PValue{o}] outer margin in two-sided printing
\end{labeling}
-Default setting is to the right of the content of the environment. This
-default\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} my be changed using option
-\DescRef{\LabelBase.option.captions}\IndexOption{captions}\important{\DescRef{\LabelBase.option.captions}} (see
+The default placement is to the right of the content of the environment. You
+can change this default\ChangedAt{v3.00}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}} using the
+\DescRef{\LabelBase.option.captions}\IndexOption{captions}%
+\important{\DescRef{\LabelBase.option.captions}} option (see
\DescPageRef{\LabelBase.option.captions}) with values like
-\PValue{innerbeside}\IndexOption[indexmain]{captions~=\PValue{innerbeside}},
-\PValue{leftbeside}\IndexOption[indexmain]{captions~=\PValue{leftbeside}},
-\PValue{outerbeside}\IndexOption[indexmain]{captions~=\PValue{outerbeside}},
+\PValue{innerbeside}\IndexOption[indexmain]{captions~=\textKValue{innerbeside}},
+\PValue{leftbeside}\IndexOption[indexmain]{captions~=\textKValue{leftbeside}},
+\PValue{outerbeside}\IndexOption[indexmain]{captions~=\textKValue{outerbeside}},
and
-\PValue{rightbeside}\IndexOption[indexmain]{captions~=\PValue{rightbeside}}.
+\PValue{rightbeside}\IndexOption[indexmain]{captions~=\textKValue{rightbeside}}.
If either \PValue{o} or \PValue{i} are used you may need to run {\LaTeX} twice
to obtain the correct placement.
-Per default the content of the environment and the caption text
-\PName{title} fill the entire available text width. However, using the
-optional parameter \PName{width}, it is possible to adjust the width
-used. This width could even be larger than the current text width.
-
-When supplying a \PName{width} the used width is usually centered with
-respect to the text width. Using the optional parameter
-\PName{offset}, you can shift the environment relative to the left
-margin. A positive value corresponds to a shift to the right, whereas
-a negative value corresponds to a shift to the left. An \PName{offset}
-of 0\Unit{pt} gives you a left-aligned output.
-
-Adding a star to the optional parameter \PName{offset} makes the the
-value mean a shift relative to the right margin on left hand pages in
-two-sided layout. A positive value corresponds to a shift towards the
-outer margin, whereas a negative value corresponds to a shift towards
-the inner margin. An \PName{offset} of 0\Unit{pt} means alignment with
-the inner margin. As mentioned before, in some cases it takes two
-{\LaTeX} runs for this to work correctly.
+Normally\important{\PName{width}}, the content of the environment and the
+\PName{caption text} fill the entire available text width. However, you can
+specify a different width using the optional parameter \PName{width}. This can
+be greater than the current text width.
+
+When specifying a \PName{width}\important{\PName{width}\\\PName{offset}}, the
+width used is usually centred with respect to the body text. Using the
+optional parameter \PName{offset}, you can shift the environment relative to
+the left margin. A positive value corresponds to a shift to the right, whereas
+a negative value corresponds to a shift to the left. An \PName{offset} of
+0\Unit{pt} gives you a left-aligned output.
+
+If\important{\PValue{*}} you add a star to the optional \PName{offset}
+parameter, the value represents a shift relative to the right margin on
+left-hand pages in a two-sided layout. A positive value corresponds to a shift
+towards the outer margin, whereas a negative value corresponds to a shift
+towards the inner margin. An \PName{offset} of 0\Unit{pt} means alignment with
+the inner margin. This variant may require two {\LaTeX} runs to achieve the
+correct offset.
The default vertical alignment is bottom. This means that the bottommost base
-lines of the contents of the environment and of the caption are aligned. This
-setting\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} may be changed using option
-\DescRef{\LabelBase.option.captions}\IndexOption{captions} (see
-\DescPageRef{\LabelBase.option.captions}) with value
-\PValue{topbeside}\IndexOption[indexmain]{captions~=\PValue{topbeside}},
+lines of the contents of the environment and of the caption are aligned.
+You\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} can change this setting using the
+\DescRef{\LabelBase.option.captions}\IndexOption{captions}%
+\important{\DescRef{\LabelBase.option.captions}} option (see
+\DescPageRef{\LabelBase.option.captions}) with the value
+\PValue{topbeside}\IndexOption[indexmain]{captions~=\textKValue{topbeside}},
\PValue{centeredbeside}%
-\IndexOption[indexmain]{captions~=\PValue{centeredbeside}}, or
-\PValue{bottombeside}\IndexOption[indexmain]{captions~=\PValue{bottombeside}}. With
-setting \PValue{topbeside} the topmost base lines of the environment contents
-and caption will be aligned. With \PValue{centeredbeside} they will be
-centered vertically. In this context it should be known, that the base line of
-a pictures is mostly at the bottom of the picture. This may be changed,
-e.\,g., using \Macro{raisebox}\IndexCmd{raisebox}.
+\IndexOption[indexmain]{captions~=\textKValue{centeredbeside}}, or
+\PValue{bottombeside}%
+\IndexOption[indexmain]{captions~=\textKValue{bottombeside}}.
+With the setting \PValue{topbeside}, the topmost base lines of the environment
+contents and caption will be aligned. With \PValue{centeredbeside}, they will
+be centred vertically. In this context, note that the base line of a figure is
+usually the bottom of the figure. You can change this using, for example,
+\Macro{raisebox}\IndexCmd{raisebox}.
\begin{Example}
- An example for the usage of the \Environment{captionbeside} environment
- can be found in \autoref{fig:\LabelBase.captionbeside}.
- This figure was typeset with:
+ You can find an example using the \Environment{captionbeside} environment in
+ \autoref{fig:\LabelBase.captionbeside}. This figure was typeset with:
\begin{lstcode}
\begin{figure}
\begin{captionbeside}[Example: Figure beside description]%
@@ -3161,30 +3528,35 @@ e.\,g., using \Macro{raisebox}\IndexCmd{raisebox}.
\end{captionbeside}
\label{fig:\LabelBase.captionbeside}
\end{figure}
- The total width is thus the currently available width
+ The total width is thus the currently available width of
\PValue{\Macro{linewidth}}. However, this width is shifted
- $\Length{marginparwidth}
- + \Length{marginparsep}$ to the outside. The caption text or description is
- placed on the inner side beside the figure. The figure itself is
- shifted 2\Unit{em} into the outer margin.
+ $\Length{marginparwidth} + \Length{marginparsep}$ to the outside. The
+ caption text or description is placed on the inner side beside the figure.
+ The figure itself is shifted 2\Unit{em} into the outer margin.
- With \Macro{dimexp} a \eTeX{} command has been used. This should not be a
- problem at all, because \KOMAScript{} itself needs \eTeX{} and every almost
+\iffalse% Umbruchkorrekturtext
+ The \Macro{dimexp} macro is an \eTeX{} command. This should not be a
+ problem at all because \KOMAScript{} itself requires \eTeX{} and every almost
up-to-date \LaTeX{} distribution uses \eTeX already.
+\fi
\hyperref[fig:\LabelBase.captionbesidecentered]%
{Figure~\ref*{fig:\LabelBase.captionbesidecentered}}
- shows a centered caption with:
+ shows a centred caption with:
\begin{lstcode}
\KOMAoption{captions}{centeredbeside}
\end{lstcode}
- Even if you are not a typographer you may see, that this is not a
- recommended suggestion.
+\iffalse % Umbruchalternativen
+ Even a typographical novice will immediately realize that you should
+ usually avoid this alignment.
+\else
+ This is certainly not a recommended solution.
+\fi
\begin{figure}
\begin{captionbeside}[Example: Description centered beside figure]%
{A figure description which is neither above nor
- below, but centered beside the figure}[i][\linewidth][2em]*
+ below, but centred beside the figure}[i][\linewidth][2em]*
\fbox{%
\parbox[b][5\baselineskip][c]{.25\textwidth}{%
\hspace*{\fill}\KOMAScript\hspace*{\fill}\par}}
@@ -3192,9 +3564,11 @@ e.\,g., using \Macro{raisebox}\IndexCmd{raisebox}.
\label{fig:\LabelBase.captionbesidecentered}
\end{figure}
- In opposite to the centered example, the top aligned from
- \autoref{fig:\LabelBase.captionbesidetop} may be used. To show how to change
- the baseline using \Macro{raisebox}, the complete example code follows:
+ In contrast, you can use the top-aligned format seen in
+ \autoref{fig:\LabelBase.captionbesidetop}. To illustrate how to shift the
+ baseline using \Macro{raisebox}, here is a complete example. You can apply
+ this not only to a substitute figure, as previously shown, but also, for
+ example, to \Macro{includegraphics} (see \cite{package:graphics}).
\begin{lstcode}
\documentclass[captions=topbeside]{scrbook}
\usepackage[english]{babel}
@@ -3233,55 +3607,61 @@ e.\,g., using \Macro{raisebox}\IndexCmd{raisebox}.
\end{captionbeside}
\label{fig:\LabelBase.captionbesidetop}
\end{figure}
- You may use such a movement not only at graphics replacements like show, but
- also using \Macro{includegraphics} (see \cite{package:graphics}).
\end{Example}
%
\EndIndexGroup
\begin{Declaration}
- \begin{Environment}{captionofbeside}%
- \Parameter{float type}%
- \OParameter{entry}\Parameter{title}%
- \OParameter{placement}\OParameter{width}%
- \OParameter{offset}
+ \begin{Environment}{captionofbeside}
+ \Parameter{float type}
+ \OParameter{short title}
+ \Parameter{caption text}
+ \OParameter{placement}
+ \OParameter{width}
+ \OParameter{offset}
+ \begin{Body}\BodyDots\end{Body}
\end{Environment}
\labelsuffix[*]%
- \begin{Environment}{captionofbeside}%
- \Parameter{float type}%
- \OParameter{entry}\Parameter{title}%
- \OParameter{placement}\OParameter{width}%
- \OParameter{offset}\PValue{*}%
+ \begin{Environment}{captionofbeside}
+ \Parameter{float type}
+ \OParameter{short title}
+ \Parameter{caption text}
+ \OParameter{placement}
+ \OParameter{width}
+ \OParameter{offset}\PValue{*}%
+ \begin{Body}\BodyDots\end{Body}
\end{Environment}
\end{Declaration}
-This\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} environment corresponds to
-\DescRef{\LabelBase.env.captionbeside} in the same manner like
-\Macro{captionof} corresponds to \DescRef{\LabelBase.cmd.caption}. The float
-type is not defined by a floating environment but by the first mandatory
-argument.%
+As\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} is the case for \DescRef{\LabelBase.cmd.caption}, there is
+a variant for \DescRef{\LabelBase.cmd.captionof} where the \PName{float type}
+is not defined by using it within a floating environment of this type, so you
+can specify a suitable environment for \DescRef{\LabelBase.env.captionbeside}
+with \Environment{captionofbeside}. In contrast to
+\DescRef{\LabelBase.env.captionbeside}, the \PName{float type} must be
+specified as an additional, first argument.%
%
\EndIndexGroup
-
\begin{Declaration}
\FloatStyle{komaabove}%
\FloatStyle{komabelow}
\end{Declaration}%
If you use\OnlyAt{\Package{float}} the \Package{float}\IndexPackage{float}
-package the appearance of the float environments is solely defined by the
-\emph{float} style. This includes whether captions above or below are used. In
-the \Package{float} package there is no predefined style which gives you the
-same output and offers the same setting options (see below) as {\KOMAScript}.
-Therefore {\KOMAScript} defines the two additional styles \PValue{komaabove}
-and \PValue{komabelow}. When using the \Package{float} package these styles
-can be activated just like the styles \PValue{plain}\IndexFloatstyle{plain},
-\PValue{boxed}\IndexFloatstyle{boxed} or \PValue{ruled}\IndexFloatstyle{ruled}
-defined in \Package{float}. For details refer to \cite{package:float}. The
-style \PValue{komaabove} inserts \DescRef{\LabelBase.cmd.caption}, \DescRef{\LabelBase.cmd.captionabove} and
-\DescRef{\LabelBase.cmd.captionbelow} above, whereas \PValue{komabelow} inserts them below the
-float content.
+package, the appearance of the float environments is solely defined by the
+\emph{float} style. This includes whether captions appear above or below. In
+the \Package{float} package, there is no predefined style which gives you the
+same output and offers the same setting options (see below) as \KOMAScript{}.
+Therefore \KOMAScript{} defines the two additional styles, \PValue{komaabove}
+and \PValue{komabelow}. When using the \Package{float} package, you can
+activate these styles just like the styles
+\PValue{plain}\IndexFloatstyle{plain}, \PValue{boxed}\IndexFloatstyle{boxed},
+or \PValue{ruled}\IndexFloatstyle{ruled} defined in \Package{float}. For
+details refer to \cite{package:float}. The style \PValue{komaabove} inserts
+\DescRef{\LabelBase.cmd.caption}, \DescRef{\LabelBase.cmd.captionabove}, and
+\DescRef{\LabelBase.cmd.captionbelow} above, whereas \PValue{komabelow}
+inserts them below the float content.
%
\EndIndexGroup
@@ -3289,21 +3669,20 @@ float content.
\begin{Declaration}
\Macro{captionformat}
\end{Declaration}%
-In {\KOMAScript} there are different ways to change the formatting of
-the caption text. The definition of different font styles was already
-explained above. This or the caption delimiter between the label and
-the label text itself is specified in the macro \Macro{captionformat}.
-In contrast to all other \Macro{\dots}format commands, in this case it
-does not contain the counter but only the items which follow it. The
-original definition is:
+In {\KOMAScript} there are various ways to change the formatting of
+the caption text. The definition of different font styles has already
+been explained above. The delimiter or delimiters between the label and
+actual caption text is specified by the macro \Macro{captionformat}.
+In contrast to all other \Macro{\dots}format commands, this is not the counter
+but only the items which follow it. The original definition is:
\begin{lstcode}
\newcommand*{\captionformat}{:\ }
\end{lstcode}
-This too can be changed with \Macro{renewcommand}.
+You can change this too with \Macro{renewcommand}.
\begin{Example}
- For some inexplicable reasons you want a dash with spaces before and
- after instead of a colon followed by a space as label delimiter. You
- define:
+ For some inexplicable reason, you want a dash surrounded by spaces
+ instead of a colon followed by a space as a label delimiter. You
+ therefore define:
\begin{lstcode}
\renewcommand*{\captionformat}{~--~}
\end{lstcode}
@@ -3317,33 +3696,30 @@ This definition should be put in the preamble of your document.
\Macro{figureformat}%
\Macro{tableformat}
\end{Declaration}%
-It was already mentioned that \DescRef{\LabelBase.cmd.captionformat} does not
-contain formatting for the label itself. This situation should under no
-circumstances be changed using redefinitions of the commands for the output of
-counters, \Macro{thefigure} or \Macro{thetable}. Such a redefinition would
-have unwanted side effects on the output of \Macro{ref} or the table of
-contents, list of figures and list of tables. To deal with the situation,
-{\KOMAScript} offers two \Macro{\dots format} commands instead. These are
-predefined as follows:
-% Umbruchkorrektur: listings
+It has already been mentioned that \DescRef{\LabelBase.cmd.captionformat} does
+not contain formatting for the label itself. You should not alter this by
+redefining the commands for the output of the \Macro{thefigure} or
+\Macro{thetable} counters. Such a redefinition would have unwanted side
+effects on the output of \Macro{ref}, the table of contents, the list of
+figures, and the list of tables. Instead, {\KOMAScript} offers two
+\Macro{\dots format} commands. These have the following defaults:
\begin{lstcode}
\newcommand*{\figureformat}{\figurename~\thefigure\autodot}
\newcommand*{\tableformat}{\tablename~\thetable\autodot}
\end{lstcode}
-They also can be adapted to your personal preferences with
-\Macro{renewcommand}.
+They can also be customised to your requirements with \Macro{renewcommand}.
\begin{Example}
- From time to time captions without any label and of course without
- delimiter are desired. In {\KOMAScript} it takes only the following
- definitions to achieve this:
+ From time to time, it is required to have captions without labels or
+ delimiters. With {\KOMAScript} the following definitions suffice to
+ achieve this:
\begin{lstcode}
\renewcommand*{\figureformat}{}
\renewcommand*{\tableformat}{}
\renewcommand*{\captionformat}{}
\end{lstcode}
It should be noted, however, that although no numbering is output, the
- internal counters are nevertheless incremented. This becomes important
- especially if this redefinition is applied only to selected
+ internal counters are nevertheless incremented. This becomes especially
+ important if this redefinition is applied only to selected
\Environment{figure} or \Environment{table} environments.
\end{Example}
%
@@ -3355,52 +3731,50 @@ They also can be adapted to your personal preferences with
\Macro{setcapindent*}\Parameter{xindent}%
\Macro{setcaphanging}
\end{Declaration}%
-As mentioned previously, in the standard classes the captions are set
-in a non-hanging style, that is, in multi-line captions the second and
-subsequent lines start directly beneath the label. The standard
-classes provide no direct mechanism to change this behaviour. In
-{\KOMAScript}, on the contrary, beginning at the second line all lines
-are indented by the width of the label so that the caption text is
-aligned.
-
-This behaviour, which corresponds to the usage of \Macro{setcaphanging}, can
-easily be changed by using the command \Macro{setcapindent} or
-\Macro{setcapindent*}. Here the parameter \PName{indent} determines the
-indentation of the second and subsequent lines. If you want a line break after
-the label and before the caption text, then you can define the indentation
-\PName{xindent} of the caption text with the starred version of the command
-instead: \Macro{setcapindent*}.
-Using a negative value of \PName{indent} instead, a line break is also
-inserted before the caption text and only the first line of the
-caption text but not subsequent lines are indented by
-the absolute value of \PName{indent}.
-
-Whether one-line captions are set as captions with more than one line or are
+As mentioned previously, in the standard classes the captions are set in a
+non-hanging style. In other words, in multi-line captions the second and
+subsequent lines start directly beneath the label. The standard classes
+provide no direct mechanism to change this behaviour. In {\KOMAScript}, on the
+contrary, beginning at the second line all lines are indented by the width of
+the label so that the caption text is aligned.
+
+You can change this behaviour, which corresponds to using
+\Macro{setcaphanging}, at any time with the \Macro{setcapindent} or
+\Macro{setcapindent*} command. Here the parameter \PName{indent} determines
+the indentation of the second and subsequent lines. If you want a line break
+after the label and before the caption text, then you can define the
+indentation \PName{xindent} of the caption text with the starred version of
+the command instead: \Macro{setcapindent*}.
+
+A negative value of \PName{indent}, on the other hand, results in a line break
+before the caption text, and only the first line of the caption text, not
+subsequent lines, is indented by the absolute value of \PName{indent}.
+
+Whether one-line captions are set the same way as multi-line captions or are
treated separately is specified with the option
\DescRef{\LabelBase.option.captions}. For details please refer to the
-explanations of these option at
+explanations of these option on
\DescPageRef{\LabelBase.option.captions.oneline}.
\begin{Example}
- For the examples please refer to
- figures~\ref{fig:\LabelBase.caption.first} to
- \ref{fig:\LabelBase.caption.last}. As you can see the usage of a fully
- hanging indentation is not advantageous when combined with narrow
- column width. To illustrate, the source code for the second figure
- is given here with a modified caption text:
+ The illustrations~\ref{fig:\LabelBase.caption.first} to
+ \ref{fig:\LabelBase.caption.last} show the effects of different settings. As
+ you can see, using a fully hanging indentation with a narrow column width is
+ awkward. To illustrate, the source code for the second figure is given here
+ with a modified caption text:
\begin{lstcode}
\begin{figure}
\setcapindent{1em}
\fbox{\parbox{.95\linewidth}{\centering{\KOMAScript}}}
- \caption{Example with slightly indented caption
- starting at the second line}
+ \caption{Example with partially indented caption
+ starting from the second line}
\end{figure}
\end{lstcode}
-As can be seen the formatting can also be changed locally within the
-\Environment{figure} environment\IndexEnv{figure}. The change then
-affects only the current figure. Following figures once again use the
-default settings or global settings set, for example, in the preamble
-of the document. This also of course applies to tables.
+ As you can see, the formatting can also be changed locally within the
+ \Environment{figure} environment\IndexEnv{figure}. The change then affects
+ only the current figure. Subsequent figures once again use the default
+ settings or global settings that you set, for example, in the preamble. This
+ also, of course, applies to tables.
\begin{figure}
\typeout{^^J--- Ignore underfull and overfull \string\hbox:}
\addtokomafont{caption}{\small}
@@ -3409,18 +3783,18 @@ of the document. This also of course applies to tables.
\begin{minipage}{.9\linewidth}
\begin{minipage}[t]{.48\linewidth}\sloppy
\fbox{\parbox{.95\linewidth}{\centering{\KOMAScript}}}
- \caption[Example: Default figure caption]%
- {\sloppy Equivalent to the standard setting, similar to the
- usage of \Macro{setcaphanging}}
+ \caption[Example: Default caption]%
+ {\sloppy With the default setting, like using
+ \Macro{setcaphanging}}
\label{fig:\LabelBase.caption.first}
\end{minipage}
\hspace{.02\linewidth}
\begin{minipage}[t]{.48\linewidth}\sloppy
\setcapindent{1em}
\fbox{\parbox{.95\linewidth}{\centering{\KOMAScript}}}
- \caption[Example: Figure caption with slightly hanging indention]%
- {With slightly hanging indentation starting at the second line
- using \Macro{setcapindent}\PParameter{1em}}
+ \caption[Example: Caption with partially hanging indention]%
+ {With partially hanging indentation starting from the second line
+ by using \Macro{setcapindent}\PParameter{1em}}
\end{minipage}
\end{minipage}
@@ -3429,9 +3803,8 @@ of the document. This also of course applies to tables.
\begin{minipage}[t]{.48\linewidth}\sloppy
\setcapindent*{1em}
\fbox{\parbox{.95\linewidth}{\centering{\KOMAScript}}}
- \caption[Example: Figure caption with hanging indention and line
- break]%
- {With hanging indentation starting at the second line and line
+ \caption[Example: Caption with hanging indention and line break]%
+ {With hanging indentation starting from the second line and line
break before the description using
\Macro{setcapindent*}\PParameter{1em}}
\end{minipage}
@@ -3439,9 +3812,8 @@ of the document. This also of course applies to tables.
\begin{minipage}[t]{.48\linewidth}\sloppy
\setcapindent{-1em}
\fbox{\parbox{.95\linewidth}{\centering{\KOMAScript}}}
- \caption[Example: Figure caption with hanging indention at the second
- line]%
- {With indentation in the second line only and line break
+ \caption[Example: Caption with indention in the second line]%
+ {With indentation only in the second line and a line break
before the description using
\Macro{setcapindent}\PParameter{-1em}}
\label{fig:\LabelBase.caption.last}
@@ -3458,263 +3830,410 @@ of the document. This also of course applies to tables.
\begin{Declaration}
\Macro{setcapwidth}\OParameter{justification}\Parameter{width}%
\Macro{setcapdynwidth}\OParameter{justification}\Parameter{width}%
- \Macro{setcapmargin}\OParameter{margin left}\Parameter{margin}%
- \Macro{setcapmargin*}\OParameter{margin inside}\Parameter{margin}
+ \Macro{setcapmargin}\OParameter{left margin}\Parameter{margin}%
+ \Macro{setcapmargin*}\OParameter{inside margin}\Parameter{margin}
\end{Declaration}
Using\ChangedAt{v2.8q}{%
\Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}} these three
-commands you can specify the width and justification of the caption
-text. In general the whole text width or column width is available
-for the caption.
+commands, you can specify the width and justification of the caption
+text. Normally, the entire text or column width is available for the caption.
-With\important{\Macro{setcapwidth}} the command \Macro{setcapwidth} you can
-decrease this \PName{width}. The obligatory argument determines the maximum
-\PName{width} of the caption. As an optional argument you can supply exactly
+With\important{\Macro{setcapwidth}} the \Macro{setcapwidth} command, you can
+decrease this \PName{width}. The mandatory argument determines the maximum
+\PName{width} of the caption. As an optional argument, you can supply exactly
one letter which specifies the horizontal justification. The possible
-justifications are given in the following list.
-\begin{labeling}[~--]{\quad\PValue{o}}\rightskip=1em
-\item[\PValue{l}] left-aligned
-\item[\PValue{c}] centered
+justifications are given in the following list:
+\begin{labeling}[~--]{\quad\PValue{o}}%
+ \itemsep=.5\topsep plus .5\topsep minus .5\topsep
+ \rightskip=1em
+\item[\PValue{l}] left-justified
+\item[\PValue{c}] centred
\item[\PValue{r}] right-aligned
-\item[\PValue{i}] alignment at the inner margin in double-sided output
-\item[\PValue{o}] alignment at the outer margin in double-sided output
+\item[\PValue{i}] aligned to the inner margin in two-sided printing
+\item[\PValue{o}] aligned to the outer margin in two-sided printing
\end{labeling}
-The justification inside and outside corresponds to left-aligned and
-right-aligned, respectively, in single-sided
-output. Within\textnote{Attention!}
-\Package{longtable}\IndexPackage{longtable}%
-\important{\Package{longtable}} tables the justification inside or outside
-does not work correctly. In particular, the captions on subsequent pages of
-such tables are aligned according to the format of the caption on the first
-page of the table. This is a conceptual problem in the implementation of
-\Package{longtable}.
-
-Please\ChangedAt{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}}\textnote{Attention!} note, \Macro{setcapwidth} sets the
-width immediately to the value of parameter \PName{width} like
-\Macro{setlength} would do. If you instead want the value of \PName{width}
-when the caption is set, you can use \Macro{setcapdynwidth}. There can be
-differences in the result, if you, e.\,g., use lengths like \Length{linewidth}
-or other commands as argument \PName{width}.
-
-With\important{\Macro{setcapmargin}} the command \Macro{setcapmargin} you can
-specify a \PName{margin} which is to be left free next to the description in
-addition to the normal text margin. If you want margins with different widths
-at the left and right side you can specify these using the optional argument
-\PName{margin left}. The starred version \Macro{setcapmargin*} defines instead
-of a \PName{margin left} a \PName{margin inside} in a double-sided layout. In
-case of \Package{longtable}\IndexPackage{longtable}%
-\important{\Package{longtable}} tables you have to deal with the same problem
-with justification inside or outside as mentioned with the macro
-\Macro{setcapwidth}. Furthermore, the usage of \Macro{setcapmargin} or
-\Macro{setcapmargin*} switches on the option
-\OptionValueRef{\LabelBase}{captions}{nooneline} (see
-\DescPageRef{\LabelBase.option.captions.nooneline}) for the captions which are
+Inside and outside justification corresponds to left-aligned and right-aligned
+justification, respectively, in one-sided printing.
+Within\textnote{Attention!} \Package{longtable}\IndexPackage{longtable}%
+\important{\Package{longtable}} tables, inside and outside justification does
+not work correctly. In particular, the captions on subsequent pages of such
+tables are aligned according to the format of the caption on the first page of
+the table. This is a conceptual problem in the implementation of the
+\Package{longtable} package.
+
+Note\ChangedAt{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}\textnote{Attention!} that \Macro{setcapwidth} immediately
+sets the width to the value of the \PName{width} parameter at the time of the
+assignment, as \Macro{setlength} does. If\important{\Macro{setcapdynwidth}}
+you instead want to use the current value of \PName{width} when the caption is
+set, you should use \Macro{setcapdynwidth}. There can be significant
+differences in the result if, for example, you use lengths like
+\Length{linewidth} or other commands as \PName{width} arguments.
+
+With\important{\Macro{setcapmargin}} the \Macro{setcapmargin} command, instead
+of specifying the width of the caption text, you can specify a \PName{margin}
+to be set next to the caption text in addition to the normal text margin. If
+you want margins with different widths on the left and right sides, you can
+use the optional argument to specify a \PName{left margin} that differs from
+\PName{margin}. Instead of a \PName{left margin}, the starred version
+\Macro{setcapmargin*} defines an \PName{inside margin} in a two-sided layout.
+The same problem arises here with with inside and outside justification inside
+\Package{longtable}\IndexPackage{longtable}\important{\Package{longtable}}
+tables that occurs with \Macro{setcapwidth}. Furthermore, using
+\Macro{setcapmargin} or \Macro{setcapmargin*} activates the
+\OptionValueRef{\LabelBase}{captions}{nooneline} option (see
+\DescPageRef{\LabelBase.option.captions.nooneline}) for captions which are
typeset with this margin setting.
-You\textnote{Hint!} can also submit negative values for \PName{margin} and
-\PName{margin left} or \PName{margin inside}. This has the effect of the
-caption expanding into the margin.
-
-Experts\textnote{Hint!} and advanced users may find a tricky usage of
-\Macro{setcapwidth} in
+You\textnote{Hint!} can also specify negative values for \PName{margin} and
+\PName{left margin} or \PName{inside margin}. This has the effect of making
+the caption protrude into the margin.%
+\iffalse\par% Anhang wurde entfernt.
+Experts\textnote{Hint!} and advanced users can find a a somewhat tricky
+application of \Macro{setcapwidth} in
\iffree{\cite{book:komascript}}{\autoref{cha:floattricks},
\autopageref{cha:floattricks}}.%
+\fi%
%
\EndIndexGroup
+\begin{Declaration}
+ \Macro{setcaptionalignment}\OParameter{float type}\Parameter{alignment}
+\end{Declaration}
+Normally\ChangedAt{v3.25}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}, multi-line\textnote{alignment of multi-line captions}
+captions are fully justified. This corresponds to
+\Macro{setcaptionalignment}\PParameter{j}. Sometimes, however, you want a
+different alignment, for example ragged right. An appropriate change is
+possible at any time with \Macro{setcaptionalignment}. You can specify exactly
+one of the letters listed in \autoref{tab:maincls.captionalignment} for the
+\PName{alignment}. If you specify an unknown \PName{alignment}, you will
+receive an error message.
+%
+\begin{table}
+% \centering
+ \KOMAoptions{captions=topbeside}%
+ \setcapindent{0pt}%
+ \begin{captionbeside}
+ [{Alignments for multi-line captions of floating environments}]
+ {\label{tab:maincls.captionalignment}%
+ Alignments for multi-line captions of floating environments}
+ [l]
+ \begin{tabular}[t]{ll}
+ \toprule
+ c & centred \\
+ j & fully justified \\
+ l & left justified \\
+ r & right justified \\
+ C & centred with \Package{ragged2e} \\
+ J & fully justified with \Package{ragged2e} \\
+ L & left justified with \Package{ragged2e} \\
+ R & right justified with \Package{ragged2e} \\
+ \bottomrule
+ \end{tabular}
+ \end{captionbeside}
+\end{table}
+
+The four possibilities with the
+\Package{ragged2e}\important{\Package{ragged2e}}\IndexPackage{ragged2e}
+package are only available if that package was loaded before you use
+\Macro{setcaptionalignment}. Otherwise, they are converted to the
+corresponding options without \Package{ragged2e}. For safety reasons, a
+warning is issued in this case.
+
+When using this command without\textnote{without optional parameter} the
+optional parameter, the result depends on whether the call occurs inside our
+outside of a floating environment. Within a floating environment, the
+alignment is then set for this floating environment. Outside, on the other
+hand, the optional parameter is assumed to be empty.
+
+Using this command with an empty\textnote{empty optional parameter} optional
+parameter, or outside a floating environment and also without any optional
+parameter, sets the general alignment. This is used whenever the current
+floating environment type does not define an alignment.
+
+If you only want to set the alignment of a particular type of floating
+environment\textnote{with \PName{float type}} without changing the
+\PName{alignment} for other types of floating environments, then the type of
+floating environment, e.\,g., \PValue{figure} or \PValue{table}, is given as
+the optional parameter \PName{float type}.
+%
+\begin{Example}
+ You want captions to be centred under the images even if they are
+ multi-line. To text this for a single image, use\textnote{in the
+ floating environment}:
+\begin{lstcode}
+ \begin{figure}
+ \centering
+ \setcaptionalignment{c}
+ \includegraphics{example-image}
+ \caption{\blindtext}
+ \end{figure}
+\end{lstcode}
+ Since you are satisfied with the result, you move the\textnote{in the
+ preamble}
+\begin{lstcode}
+ \setcaptionalignment{c}
+\end{lstcode}
+ command to the document preamble. Thereafter, however, you decide you do not
+ like this change for table captions at all. Therefore, you use\textnote{only
+ for figures}
+\begin{lstcode}
+ \setcaptionalignment[figure]{c}
+\end{lstcode}
+ to limit the centring to figures.
+
+ A little later, you realize that the centring is not so suitable. Instead,
+ you now prefer to have ragged right alignment. So you change the alignment
+ again:
+\begin{lstcode}
+ \setcaptionalignment[figure]{l}
+\end{lstcode}
+ However, you do not like the fact that the lines are very different in
+ length. This is caused by the lack of hyphenation, causing long words to
+ wrap completely onto the next line, leaving large gaps. You want to allow
+ hyphenation as needed. This is easy to achieve with the help of the
+ \Package{ragged2e}\important{\Package{ragged2e}}\IndexPackage{ragged2e}
+ package. However, it is not enough to use
+\begin{lstcode}
+ \usepackage{ragged2e}
+\end{lstcode}
+ to load the package. Using the \Option{newcommands} option when loading the
+ package does not help. Instead, the \PName{alignment} must also be changed:
+\begin{lstcode}
+ \usepackage{ragged2e}
+ \setcaptionalignment[figure]{L}
+\end{lstcode}
+ Note\textnote{Attention!} the upper-case letter for the \PName{alignment}.
+\end{Example}
+\EndIndexGroup
+
\begin{Declaration}
\Option{origlongtable}
\end{Declaration}%
\BeginIndex{Package}{longtable}%
-If the table captions produced by the \Package{longtable} package (see
-\cite{package:longtable}) should not be redefined by the {\KOMAScript}
+If you do not want the table captions produced by the \Package{longtable}
+package (see \cite{package:longtable}) to be redefined by the {\KOMAScript}
classes, activate the \Option{origlongtable} option. This\textnote{Attention!}
-option has to be used at the optional argument of
-\DescRef{\LabelBase.cmd.documentclass}. It may not be used as a setting of
+option must be used in the optional argument of
+\DescRef{\LabelBase.cmd.documentclass}. It cannot be used as a setting of
\DescRef{\LabelBase.cmd.KOMAoptions} or \DescRef{\LabelBase.cmd.KOMAoptions}.
%
\EndIndexGroup
+%
+\EndIndexGroup
\begin{Declaration}
\OptionVName{listof}{setting}
\end{Declaration}
-\BeginIndex{}{tables>list of}\BeginIndex{}{list of>tables}%
-\BeginIndex{}{figures>list of}\BeginIndex{}{list of>figures}%
Normally\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} lists of floating environments\,---\,like list of tables
-or list of figures will neither get an entry at the table of contents nor have
-a number at the heading. More information about that may be found in
-\autoref{sec:\LabelBase.toc}. Alternative to the view from the table of
-contents to the lists of floating environments, you may reconsider a view from
-the lists of floating environments into the table of contents. Because of
-this, there are not only the options
-\OptionValueRef{\LabelBase}{toc}{nolistof}%
-\IndexOption{toc~=\PValue{nolistof}},
-\OptionValueRef{\LabelBase}{toc}{listof}\IndexOption{toc~=\PValue{listof}},
+ \Class{scrartcl}} lists of floating environments\,---\,like
+tables\Index{tables>list of} or figures\Index{figures>list of}\,---\,are
+neither numbered nor included in the table of contents. You can find more
+information about this behaviour in \autoref{sec:\LabelBase.toc}. As an
+alternative to the settings \OptionValueRef{\LabelBase}{toc}{nolistof}%
+\IndexOption{toc~=\textKValue{nolistof}},
+\OptionValueRef{\LabelBase}{toc}{listof}\IndexOption{toc~=\textKValue{listof}},
and \OptionValueRef{\LabelBase}{toc}{listofnumbered}%
-\IndexOption{toc~=\PValue{listofnumbered}} described in
-\autoref{sec:\LabelBase.toc}, \DescPageRef{\LabelBase.option.toc.listof}, but
-also \OptionValue{listof}{notoc}, \OptionValue{listof}{totoc}, and
-\OptionValue{listof}{numbered} with the same meaning.
-
-By default the headings of the lists of floating environments use the topmost
-level below \DescRef{\LabelBase.cmd.part}. This is the chapter level at
-\Class{scrbook} and \Class{scrreprt} and the section level at
-\Class{scrartcl}. With\ChangedAt{v3.06}{\Class{scrbook}\and
+\IndexOption{toc~=\textKValue{listofnumbered}} mentioned there, you can also
+look at this behaviour from perspective of the lists themselves. Therefore
+you can achieve the same results with the settings
+\OptionValue{listof}{notoc}, \OptionValue{listof}{totoc}, and
+\OptionValue{listof}{numbered}.
+
+By default, the headings in the lists of floating environments use the topmost
+level below \DescRef{\LabelBase.cmd.part}. This is the chapter level in
+\Class{scrbook} and \Class{scrreprt} and the section level in
+\Class{scrartcl}. By contrast,\ChangedAt{v3.06}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}}
-\OptionValue{listof}{leveldown}\important{\OptionValue{listof}{leveldown}} a
-one step lower level will be used instead.
+\OptionValue{listof}{leveldown}\important{\OptionValue{listof}{leveldown}}
+uses the next lower level to be used instead.
+\important{\OptionValue{listof}{standardlevel}}%
+\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
+\OptionValue{listof}{standardlevel} switches back to the default sectioning
+level, if necessary.
\begin{Example}
- At a book you want to move the list of figures and the list of tables as
- sub-lists into a common list named ``Figures and Tables''. With
+ In a book, you want to put the list of figures and the list of tables as
+ sub-lists into a common list named ``Figures and Tables''. Simply use:
\begin{lstcode}
\KOMAoption{listof}{leveldown}
\end{lstcode}
- you first declare to use the section instead of the chapter level for both
- lists and then you use:
+ to use the section instead of the chapter level for both lists, and put the
+ following at the appropriate place in your document:
\begin{lstcode}
\addchap*{Figures and Tables}
\listoffigures
\listoftables
\end{lstcode}
- for the new list, that contains the list of figures and the list of
- tables. More information about the command \DescRef{\LabelBase.cmd.addchap*}
- may be found in \autoref{sec:\LabelBase.structure} at
+ You can find more information about the \DescRef{\LabelBase.cmd.addchap*}
+ command in \autoref{sec:\LabelBase.structure} on
\DescPageRef{\LabelBase.cmd.addchap*}.
\end{Example}
Normally\ChangedAt{v2.8q}{%
\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} the lists of
-floating environments use a constant with to place the caption number of the
-entries. Additionally all entries will be indented a little bit. This
-corresponds to setting
-\OptionValue{listof}{graduated}\IndexOption{listof~=\PValue{graduated}}.
-
-If the numbers of the figures or tables, become very wide\,---\,i.\,e., if you
-have a lot of tables or figures\,---\, their may be not enough width
-predefined. There's\important{\OptionValue{listof}{flat}} a setting
-\OptionValue{listof}{flat}\IndexOption{listof~=\PValue{flat}} for the lists of
-floating environment similar to
-\OptionValueRef{\LabelBase}{toc}{flat}\IndexOption{toc~=\PValue{flat}} for the
-table of contents. Thereby the needed with for printing the number will be
-determined at each \LaTeX{} run. See option
-\OptionValueRef{\LabelBase}{toc}{flat}, \autoref{sec:\LabelBase.toc},
-\DescPageRef{\LabelBase.option.toc.flat} for information about how it
-works. Please\textnote{Attention!} note again, that you need more than one
-\LaTeX{} runs until the lists of floating environments will become their final
-result.
-
-Setting \OptionValue{listof}{entryprefix}\ChangedAt{v3.06}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}} will automatically activate
-\OptionValue{listof}{flat}
-too. Normally\important{\OptionValue{listof}{entryprefix}} it would not make
-sense to add the prefix ``figure'' to each entry of the list of figures and
-the prefix ``table'' to each entry of the list of tables, because nothing else
-than figures would be and should be expected at the list of figures and
-nothing else than tables would be and should be expected at the list of
-tables. So this prefixes would not give any additional information and for this
-would not be useful. Nevertheless, such prefixes may be added using option
-\OptionValue{listof}{entryprefix}. With this all entries of the same list will
-get the same prefix. The prefix will depend on the file extension of the
-helper file, that will be used for the corresponding list. For the list of
-figures the file extension would be ``\File{lof}'' and therefor
-\Macro{listoflofentryname} would be used. For the list of tables, the file
-extension would be ``\File{lot}'' and \Macro{listoflotentryname} would be
-used.
-
-Within classes \Class{scrbook} and \Class{scrreprt}\OnlyAt{\Class{scrbook}\and
- \Class{scrreprt}} \KOMAScript{} adds a vertical gap to the lists of floating
-environments whenever a new chapter starts. This behaviour, that is same at
-the standard classes, structures the lists by chapters. At \KOMAScript{} it
-corresponds to setting \ChangedAt{v3.00}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}}
+floating environments use a fixed-width space for the caption number of the
+entries. At the same time, all entries are somewhat indented. This behaviour
+corresponds to the
+\OptionValue{listof}{graduated}\IndexOption{listof~=\textKValue{graduated}}
+setting.
+
+If the numbers become very wide, for example because you have many tables or
+figures, the space provided may at some point no longer be sufficient.
+\KOMAScript{} offers the setting \OptionValue{listof}{flat}%
+\important{\OptionValue{listof}{flat}}\IndexOption{listof~=\textKValue{flat}}
+for lists of floating environments, comparable to
+\OptionValueRef{\LabelBase}{toc}{flat}\IndexOption{toc~=\textKValue{flat}} for
+the table of contents. The width required to print the number is
+determined automatically and the space is adjusted accordingly. See the
+\OptionValueRef{\LabelBase}{toc}{flat} option, \autoref{sec:\LabelBase.toc},
+\DescPageRef{\LabelBase.option.toc.flat} for more information about side
+effects and how it works. Note\textnote{Attention!} again that you need more
+than one \LaTeX{} run before the lists of floating environments reach
+their final state.
+
+The \OptionValue{listof}{entryprefix}\ChangedAt{v3.06}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}} setting automatically activates
+\OptionValue{listof}{flat} too.
+Normally\important{\OptionValue{listof}{entryprefix}}, it does not make sense
+to add a prefix such as ``figure'' or ``table'' to each entry in the lists of
+floating environments because, of course, only figures are included in the
+list of figures and only tables are included in the list of tables. Such a
+prefix provides no additional information and is thus omitted by default.
+However, you can add such prefixes using the
+\OptionValue{listof}{entryprefix} option. With this, all entries in the same
+list will get the same prefix. The prefix depends on the file extension of the
+auxiliary file that is used for the corresponding list. For the list of
+figures, the file extension is ``\File{lof}'' and therefore
+\Macro{listoflofentryname} is used. For the list of tables, the file extension
+is ``\File{lot}'' and \Macro{listoflotentryname} is used.
+
+For the \Class{scrbook} and \Class{scrreprt}\OnlyAt{\Class{scrbook}\and
+ \Class{scrreprt}} classes, \KOMAScript{} adds a vertical space to the lists
+of floating environments whenever a new chapter starts. This behaviour, which
+also exists in the standard classes, groups the lists by chapters. In
+\KOMAScript{}, it corresponds to setting \ChangedAt{v3.00}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}}%
\OptionValue{listof}{chaptergapsmall}%
-\IndexOption{listof~=\PValue{chaptergapsmall}}. In this case a gap of width
-10\Unit{pt} will be used. With\important{\OptionValue{listof}{chaptergapline}}
-option \OptionValue{listof}{chaptergapline}%
-\IndexOption{listof~=\PValue{chaptergapline}} a gap of the height of one
-standard text line will be
-used. The\important{\OptionValue{listof}{nochaptergap}} gap may be switched of
-with \OptionValue{listof}{nochaptergap}%
-\IndexOption{listof~=\PValue{nochaptergap}}. Option\important{\OptionValue{listof}{chapterentry}}
+\LabelOptionValue{listof}{chaptergapsmall}%
+\important{\OptionValue{listof}{chaptergapsmall}}%
+\IndexOption{listof~=\textKValue{chaptergapsmall}}. In this case, is uses a
+fixed vertical space of 10\Unit{pt}.
+With\important{\OptionValue{listof}{chaptergapline}} the
+\OptionValue{listof}{chaptergapline}%
+\IndexOption{listof~=\textKValue{chaptergapline}} option, you instead get a
+vertical space the height of one standard text line. With
+\OptionValue{listof}{nochaptergap}%
+\IndexOption{listof~=\textKValue{nochaptergap}}%
+\important{\OptionValue{listof}{nochaptergap}}, you can completely remove the
+vertical space. The\important{\OptionValue{listof}{chapterentry}}
\OptionValue{listof}{chapterentry}%
-\IndexOption{listof~=\PValue{chapterentry}} is somehow special. Instead of a
-gap it adds the table of contents entry for the chapter additionally to the
-lists of floating environments. Please\textnote{Attention!} note, that this
-would also happen, if the chapter does not have any floating
-environment. Additional influence of chapters to the lists of floating
-environments is available with option
-\DescRef{\LabelBase.option.chapteratlists}. See
-\autoref{sec:\LabelBase.structure},
-\DescPageRef{\LabelBase.option.chapteratlists} for more information about
-that.
-
-An overview about all settings to option \Option{listof} may be found at
+\IndexOption{listof~=\textKValue{chapterentry}} option is a special feature.
+Instead of a vertical space, the table of contents entry for the chapter is
+inserted into the lists of floating environments. Note\textnote{Attention!}
+that this happens even if the chapter does not contain a floating environment.
+You can find a method where only chapters containing floating environments
+appear in the respective lists at \cite{https://komascript.de/comment/5070}.
+You can achieve a more direct control over what appears in the lists of
+floating environments with the \DescRef{\LabelBase.option.chapteratlists}
+option, which is explained in \autoref{sec:\LabelBase.structure}, on
+\DescPageRef{\LabelBase.option.chapteratlists}.
+
+You can find an overview of all settings for the \Option{listof} option in
\autoref{tab:\LabelBase.listof}.
\begin{desclist}
- \desccaption[{Available values for option \Option{listof}}]{%
- Available values for option \Option{listof} to modify contents and
- formation of the lists of floating environments\label{tab:\LabelBase.listof}%
+ \desccaption[{Available values for the \Option{listof} option}]{%
+ Available values for the \Option{listof} option for modifying the format
+ and contents of the lists of floating
+ environments\label{tab:\LabelBase.listof}%
}{%
- Available values for option \Option{listof} (\emph{continuation})%
+ Available values for the \Option{listof} option (\emph{continued})%
}%
\entry{\PValue{chapterentry}, \PValue{withchapterentry}}{%
- Marks chapter starts at the lists of floating environments by a copy of
- their entries to the table of contents.%
- \IndexOption{listof~=\PValue{chapterentry}}}%
+ Indicates the beginning of chapters in the lists of floating environments
+ with copies of their table-of-contents entries.%
+ \IndexOption{listof~=\textKValue{chapterentry}}}%
\entry{\PValue{chaptergapline}, \PValue{onelinechaptergap}}{%
- Marks chapter starts at the lists of floating environments by a vertical
- gap of the height of one standard text line.%
- \IndexOption{listof~=\PValue{chaptergapline}}}%
+ Indicates the beginning of chapters in the lists of floating environments
+ with a vertical space the height of one standard text line.%
+ \IndexOption{listof~=\textKValue{chaptergapline}}}%
\entry{\PValue{chaptergapsmall}, \PValue{smallchaptergap}}{%
- Marks chapter starts at the lists of floating environments by a small
- vertical gap.%
- \IndexOption{listof~=\PValue{chaptergapsmall}}}%
+ Indicates the beginning of chapters in the lists of floating environments
+ with a small vertical space.%
+ \IndexOption{listof~=\textKValue{chaptergapsmall}}}%
\entry{\PValue{entryprefix}}{%
\ChangedAt{v3.06}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
- Adds a prefix depending on the file extension of the list to each entry of
- the lists of floating environments. The prefix additionally depends on the
- language, e.\,g., in English ``Figure'' would be used for the entries to
- the list of figures and ``Table'' for the entries to the list of
- tables. Both prefixes will be followed by a white space.%
- \IndexOption{listof~=\PValue{entryprefix}}}%
+ Adds a prefix before the number of each floating-environment list entry.
+ The prefix is usually language-dependent, e.\,g., in English ``Figure'' is
+ used for the list of figures and ``Table'' for the list of tables, each
+ followed by a white space.%
+ \IndexOption{listof~=\textKValue{entryprefix}}}%
\entry{\PValue{flat}, \PValue{left}}{%
- The lists of floating environments will be printed like a kind of
- table. The caption numbers will be the first column, the caption texts the
- second column, and the page numbers the last column. The width of the first
- column depends on the previous \LaTeX{} run.%
- \IndexOption{listof~=\PValue{flat}}}%
+ Prints the lists of floating environments in tabular form. The caption
+ numbers are the first column, the caption texts the second column, and the
+ page numbers the third column. The space reserved for the caption numbers
+ depends on the previous \LaTeX{} run.%
+ \IndexOption{listof~=\textKValue{flat}}}%
\entry{\PValue{graduated}, \PValue{indent}, \PValue{indented}}{%
- The lists of floating environments will be printed in hierarchical
- form. The width for the caption numbers will be limited.%
- \IndexOption{listof~=\PValue{graduated}}}%
+ Prints the lists of floating environments in a hierarchical form. The
+ space reserved for the caption numbers is limited.%
+ \IndexOption{listof~=\textKValue{graduated}}}%
\entry{\PValue{leveldown}}{%
- The lists of floating environments will use a heading of one step lower
- sectioning level than default.%
- \IndexOption{listof~=\PValue{leveldown}}}%
+ Uses headings that are one level lower in the sectioning hierarchy than
+ the default for lists of floating environments.%
+ \IndexOption{listof~=\textKValue{leveldown}}}%
+ \entry{\PValue{indenttextentries}, \PValue{indentunnumbered},
+ \PValue{numberline}}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ The \PValue{numberline} property (see \autoref{sec:tocbasic.toc},
+ \DescPageRef{tocbasic.cmd.setuptoc}) is set for the lists of floating
+ environments such as figures and tables. As a result, unnumbered entries
+ are left-aligned with the text of numbered entries of the same level.
+ However, the \KOMAScript{} classes themselves do not put unnumbered
+ entries in these lists. This option therefore affects only entries that
+ are generated not by the \KOMAScript{} classes themselves but with the
+ help of \DescRef{tocbasic.cmd.addxcontentsline} (see
+ \autoref{sec:tocbasic.toc}, \DescPageRef{tocbasic.cmd.addxcontentsline}).%
+ \IndexOption{toc~=\textKValue{numberline}}}%
+ \entry{\PValue{leftaligntextentries}, \PValue{leftalignunnumbered},
+ \PValue{nonumberline}}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ The \PValue{nonumberline} property (see \autoref{sec:tocbasic.toc},
+ \DescPageRef{tocbasic.cmd.setuptoc}) is set for the lists of floating
+ environments. This will place unnumbered entries left-aligned with the
+ number of numbered entries. However, the \KOMAScript{} classes themselves
+ do not put unnumbered entries in these lists. This option therefore
+ affects only entries that are generated not by the \KOMAScript{} classes
+ themselves but with the help of \DescRef{tocbasic.cmd.addxcontentsline}
+ (see \autoref{sec:tocbasic.toc},
+ \DescPageRef{tocbasic.cmd.addxcontentsline}).%
+ \IndexOption{toc~=\textKValue{nonumberline}}}%
\entry{\PValue{nochaptergap}, \PValue{ignorechapter}}{%
- Chapter starts are not marked at the lists of floating environments.%
- \IndexOption{listof~=\PValue{nochaptergap}}}%
- \entry{\PValue{notoc}, \PValue{plainheading}}{%
- The lists of floating environments, e.\,g., list of figures and list of
- tables do not generate an entry at the table of contents.%
- \IndexOption{listof~=\PValue{notoc}}}%
+ The beginnings of chapters are not marked in the lists of floating
+ environments.%
+ \IndexOption{listof~=\textKValue{nochaptergap}}}%
+ \entry{\PValue{notoc}, \PValue{nottotoc}, \PValue{plainheading}}{%
+ The lists of floating environments do not generate entries in the table of
+ contents.%
+ \IndexOption{listof~=\textKValue{nottotoc}}}%
\entry{\PValue{numbered}, \PValue{totocnumbered}, \PValue{tocnumbered},
- \PValue{numberedtotoc}}{%
- The lists of floating environments, e.\,g., list of figures and list of
- tables, would get a numbered heading and therefor generate an entry at the
- table of contents.%
- \IndexOption{listof~=\PValue{numbered}}}%
+ \PValue{numberedtoc}, \PValue{numberedtotoc}}{%
+ The lists of floating environments receive numbered entries in the table
+ of contents.%
+ \IndexOption{listof~=\textKValue{numbered}}}%
+ \entry{\PValue{standardlevel}}{%
+ The lists use the normal sectioning level.%
+ \IndexOption{listof~=\textKValue{standardlevel}}}%
\entry{\PValue{totoc}, \PValue{toc}, \PValue{notnumbered}}{%
- The lists of floating environments, e.\,g., list of figures and list of
- tables, would generate an entry at the table of contents, but their
- headings are not numbered.%
- \IndexOption{listof~=\PValue{totoc}}}%
+ The lists of floating environment generate entries in the table of
+ contents, but their headings are unnumbered.%
+ \IndexOption{listof~=\textKValue{totoc}}}%
\end{desclist}
%
\EndIndexGroup
@@ -3724,69 +4243,67 @@ An overview about all settings to option \Option{listof} may be found at
\Macro{listoftables}%
\Macro{listoffigures}
\end{Declaration}
-\BeginIndex{}{tables>list of}\BeginIndex{}{list of>tables}%
-\BeginIndex{}{figures>list of}\BeginIndex{}{list of>figures}%
-These commands generate a list of tables or figures. Changes in the document
-that modify these lists will require two {\LaTeX} runs in order to take
-effect. The layout of the lists can be influenced by the option
-\DescRef{\LabelBase.option.listof}\important{\DescRef{\LabelBase.option.listof}}
-with values \PValue{graduated} or \PValue{flat} (see
-\DescPageRef{\LabelBase.option.listof}). Moreover, the values \PValue{listof}
-and \PValue{listofnumbered} of option
-\DescRef{\LabelBase.option.toc}\important{\DescRef{\LabelBase.option.toc}}
-(see \autoref{sec:\LabelBase.toc}) as well as the values \PValue{totoc} and
-\PValue{numbered} of the previous described option
-\DescRef{\LabelBase.option.listof} have influence to the lists of floating
-environments.
-
-Mostly\textnote{Hint!} the lists of floating environment may be found after
-the table of contents. But some publishers like to have these lists at the
-appendix. Nevertheless the author of this guide prefers to find them
+These commands generate a list of tables or figures. Changes affecting these
+lists will require two \LaTeX{} runs to take effect. The layout of the lists
+can be influenced by the \DescRef{\LabelBase.option.listof}%
+\important{\DescRef{\LabelBase.option.listof}} option with the values
+\PValue{graduated} or \PValue{flat} (see
+\DescPageRef{\LabelBase.option.listof}). In addition, the \PValue{listof} and
+\PValue{listofnumbered} values of the \DescRef{\LabelBase.option.toc}%
+\important{\DescRef{\LabelBase.option.toc}} option (see
+\autoref{sec:\LabelBase.toc}), as well as the \PValue{totoc} and
+\PValue{numbered} values of the \DescRef{\LabelBase.option.listof} option
+described above indirectly affect these lists.
+
+As\textnote{Hint!} a rule, you will find the lists of the floating
+environments immediately after the table of contents. In some documents, they
+go into the appendix. However, the author of this guide prefers them
immediately after the table of contents.%
-\EndIndexGroup
%
\EndIndexGroup
-\LoadCommonFile{marginpar}% \section{Margin Notes}
+\LoadCommonFile{marginpar}% \section{Marginal Notes}
\section{Appendix}
\seclabel{appendix}
\BeginIndexGroup
-\BeginIndex{}{appendix}
-
-The appendix of a document contains mainly the enclosures to the
-document. These are typically bibliography, index, glossary. But only for this
-parts nobody would and should start an appendix, because the formation of
-these already distinguishes them from the main document. But if there are
-additional elements at the appendix, i.\,e., cited third party documents,
-endnotes, figures or tabulars, the standard elements like the bibliography
+\BeginIndex{}{Appendix}
+
+The appendix of a document mostly consists of supplements to the document.
+Typical parts of an appendix include a bibliography, an index, and a glossary.
+However you should not start an appendix for these parts alone because their
+format already distinguishes them from the main document. But if there are
+additional elements in the appendix, such as quoted third-party documents,
+endnotes, figures, or tabulars, the standard elements such as the bibliography
should also be part of the appendix.
+
\begin{Declaration}
\Macro{appendix}
\end{Declaration}%
-The appendix in the standard as well as the {\KOMAScript} classes is
-introduced with \Macro{appendix}. This command switches, among other things,
-the chapter numbering to upper case letters, also ensuring that the rules
-according to \cite{DUDEN} are followed (for German-speaking regions). These
-rules are explained in more detail in the description of the option
-\DescRef{\LabelBase.option.numbers} in \autoref{sec:\LabelBase.structure},
-\DescPageRef{\LabelBase.option.numbers}.
-
-Die output of the chapter headings\OnlyAt{\Class{scrbook}\and
- \Class{scrreprt}} in the appendix are influenced by the options
-\DescRef{\LabelBase.option.chapterprefix} and
-\DescRef{\LabelBase.option.appendixprefix}. See
+The appendix is started in the standard as well as the {\KOMAScript} classes
+with \Macro{appendix}. Among other things, this command changes the chapter
+numbering to upper-case letters while ensuring that the rules according to
+\cite{DUDEN} for numbering the sectioning levels are followed (for
+German-speaking regions). These rules are explained in more detail in the
+description of the \DescRef{\LabelBase.option.numbers} option in
+\autoref{sec:\LabelBase.structure}, \DescPageRef{\LabelBase.option.numbers}.
+
+The format of the chapter headings\OnlyAt{\Class{scrbook}\and
+ \Class{scrreprt}} in the appendix is influenced by the
+\DescRef{\LabelBase.option.chapterprefix}%
+\important{\DescRef{\LabelBase.option.chapterprefix}\\
+ \DescRef{\LabelBase.option.appendixprefix}} and
+\DescRef{\LabelBase.option.appendixprefix} options. See
\autoref{sec:\LabelBase.structure},
\DescPageRef{\LabelBase.option.appendixprefix} for more information.
Please\textnote{Attention!} note that \Macro{appendix} is a command,
-\emph{not} an environment! This command does not expect any
-argument. Chapters and sections in the appendix uses
-\DescRef{\LabelBase.cmd.chapter} and \DescRef{\LabelBase.cmd.section} just as
-does the main text.%
+\emph{not} an environment! This command does not expect an argument. Chapters
+and sections in the appendix use \DescRef{\LabelBase.cmd.chapter} and
+\DescRef{\LabelBase.cmd.section}, just as in the main text.%
%
\EndIndexGroup
%
@@ -3798,125 +4315,127 @@ does the main text.%
\BeginIndexGroup
\BeginIndex{}{bibliography}
-The bibliography opens up external resources. Mainly bibliographies will be
-made by program \BibTeX{} or biber using an external file in database like
-structure. Thereby \BibTeX{} style influences not only the formation of the
-bibliography entries but also their sorting. Using an additional bibliography
-style like \Package{natbib}\IndexPackage{natbib},
+The bibliography makes external sources accessible. As a rule, the
+bibliography is created from an external file with a database-like structure
+using the \BibTeX{} program. You can use the \BibTeX{} style to change both
+the format of the entries and their sorting. If you use an additional
+bibliography package like \Package{natbib}\IndexPackage{natbib},
\Package{babelbib}\IndexPackage{babelbib}, or
-\Package{biblatex}\IndexPackage{bublatex} limits the influence of
-\KOMAScript{} to the bibliography hardly. In such cases it is important so see
-the manual of the bibliography package! General information about bibliography
-may be found in \cite{lshort}.
+\Package{biblatex}\IndexPackage{biblatex}, \KOMAScript{}'s influence over the
+bibliography disappears. In such cases, you must follow the manual of the
+relevant bibliography package. You can find general information about
+bibliographies in \cite{lshort}.
\begin{Declaration}
- \OptionVName{bibliography}{selection}
+ \OptionVName{bibliography}{setting}
\end{Declaration}
-For a start, \PName{selection}\ChangedAt{v3.00}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}} may be any already defined
-bibliography formation style. There are two predefined formation styles at
-\KOMAScript{}. You should not misconceive them with the styles used by
-\BibTeX\Index{BibTeX=\BibTeX} which you may select using
-\Macro{bibstyle}. While \BibTeX{} influences not only the sorting but also the
+For a start,\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} you can select any predefined bibliography style in
+\PName{setting}. There are two such bibliography styles predefined in
+\KOMAScript{}. You should not confuse them with the styles used by
+\BibTeX\Index{BibTeX=\BibTeX}, which you select with
+\Macro{bibstyle}. While \BibTeX{} determines both the sorting and the
contents of the bibliography, \KOMAScript{} influences only some basic
-features of the bibliography or a tiny amount of formation features of the
-entries to the bibliography.
+features of the bibliography and few properties of the entry format.
-Option\important{\OptionValue{bibliography}{oldstyle}}
+The\important{\OptionValue{bibliography}{oldstyle}}
\OptionValue{bibliography}{oldstyle}%
-\IndexOption{bibliography~=\PValue{oldstyle}} selects a compact formation of
-the bibliography entries. In this case command
-\DescRef{maincls-experts.cmd.newblock}\IndexCmd{newblock} inside of the entries will only result in
-a small horizontal distance. The name is a result of the fact, that this is
-the mostly used classic kind of bibliography. In opposite to
-this\important[i]{\begin{tabular}[t]{@{}l@{}}
- \Option{bibliography=}\\
- \quad\PValue{openstyle}\end{tabular}}%
+\IndexOption{bibliography~=\textKValue{oldstyle}} option selects a compact
+format for bibliography entries. In this case, using the
+\DescRef{maincls-experts.cmd.newblock}\IndexCmd{newblock} command results in
+only a small glue between the entries. The name comes from the fact that this
+is the most common classic form of a bibliography.
+In\important{\OptionValue{bibliography}{openstyle}} contrast, the
\OptionValue{bibliography}{openstyle}%
-\IndexOption{bibliography~=\PValue{openstyle}}. selects a more modern and open
-kind of bibliography. The name is a result of the fact, that command
-\DescRef{maincls-experts.cmd.newblock} inserts a paragraph break. The entries will be more
-structured by this. They are less compact and seem more relaxed or
-open. Information about definition of new formation styles may be found in
-description of command \DescRef{maincls-experts.cmd.newbibstyle} in
-\autoref{sec:maincls-experts.experts} at
+\IndexOption{bibliography~=\textKValue{openstyle}} setting selects a more
+modern and open kind of bibliography. The name comes from the fact that the
+\DescRef{maincls-experts.cmd.newblock} command inserts a paragraph break. 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},
\DescPageRef{maincls-experts.cmd.newbibstyle}.
-Beside the formation style one more feature may be selected using
-\PName{selection}. The bibliography is a kind of contents list. But instead of
-listing contents of the document itself, it references to external
-contents. Because of this, someone may say, that
-the\important[i]{\begin{tabular}[t]{@{}l@{}}
- \Option{bibliography=}\\
- \quad\PValue{totocnumbered}
- \end{tabular}} bibliography is a chapter
-or section on its own and should have a chapter or section number. You may
-select this with option \OptionValue{bibliography}{totocnumbered}%
-\IndexOption{bibliography~=\PValue{totocnumbered}} which will therefor also
-generate an entry to the table of contents.In my opinion the bibliography is
-nothing you've written on your own and so does not merits a numbered entry to
-the table of contents. A entry without number may be set with option
-\OptionValue{bibliography}{totoc}%
-\IndexOption{bibliography~=\PValue{totoc}}. Nevertheless, the default would be
-neither a number nor an entry to the table of contents and corresponds to
+In addition to the formatting style, you can select one more feature using
+\PName{setting}. The bibliography is a kind of list of contents. But instead
+of listing the contents of the document itself, it references external works.
+With this reasoning, you could argue that the bibliography is a separate
+chapter or section and therefore deserves a chapter or section number. The
+\OptionValue{bibliography}{numbered}%
+\important{\OptionValue{bibliography}{numbered}}%
+\IndexOption{bibliography~=\textKValue{numbered}} setting does exactly that,
+including creating an entry in the table of contents. In my opinion, a
+traditional, annotated source list should by this reasoning be a separate
+chapter too. Moreover, the bibliography is ultimately nothing you've written
+yourself and so merits at most an unnumbered entry in the table of contents,
+which is achieved with the \OptionValue{bibliography}{totoc}%
+\IndexOption{bibliography~=\textKValue{totoc}} option. The default setting,
+where the bibliography is produced as an unnumbered chapter and does not
+receive an entry in the table of contents corresponds to
\OptionValue{bibliography}{nottotoc}%
-\IndexOption{bibliography~=\PValue{nottotoc}}. For more information see option
-\DescRef{\LabelBase.option.toc} in \autoref{sec:\LabelBase.toc}, especially values
-\PValue{bibliographynumbered}, \PValue{bibliography}, and
-\PValue{nobibliography} to this option at
+\IndexOption{bibliography~=\textKValue{nottotoc}}. For more information, see
+the \DescRef{\LabelBase.option.toc} option in \autoref{sec:\LabelBase.toc},
+especially the \PValue{bibliographynumbered}, \PValue{bibliography},
+and\PValue{nobibliography} values for this option on
\DescPageRef{\LabelBase.option.toc.bibliography}.
Sometimes\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} it is not usefull to have one bibliography for the whole
-document but a bibliography at every chapter of a document made using
-\Class{scrbook} or \Class{scrreprt}. In that case
-you'd\important{\OptionValue{bibliography=leveldown}} need the bibliography
-itself not to be a chapter but one level below, a section. You may achieve
-this using Option \OptionValue{bibliography}{leveldown}%
-\IndexOption{bibliography~=\PValue{leveldown}}. You may use this also if you'd
-combine several lists and the bibliography together below one heading. So this
-option is also available with \Class{scrartcl}.
-
-A summary of all available values for option \Option{bibliography} may be
-found in \autoref{tab:\LabelBase.bibliography}. Nevertheless you should note,
-that additional values may be generated using
+ \Class{scrartcl}} a document made using \Class{scrbook} or \Class{scrreprt}
+will have a bibliography for every chapter rather than one bibliography for
+the whole document. In that case, it makes sense for the bibliography
+itself\important{\OptionValue{bibliography=leveldown}} to be not a chapter but
+a section. You can achieve this using the
+\OptionValue{bibliography}{leveldown}%
+\IndexOption{bibliography~=\textKValue{leveldown}} option. You can also use
+this if you want the bibliography to appear with other lists under a common
+heading, therefore this option is also available with \Class{scrartcl}.
+
+You can find a summary of available values for the \Option{bibliography}
+option in \autoref{tab:\LabelBase.bibliography}. Note, however, that you can
+define new values with
\DescRef{maincls-experts.cmd.newbibstyle}\IndexCmd{newbibstyle}.
\begin{table}
- \caption[{Available values of option \Option{bibliography}}]{%
- Predefined values of option \Option{bibliography} to select the formation
- of the bibliography}
+ \caption[{Available values for the \Option{bibliography} option}]{%
+ Predefined values for the \Option{bibliography} option for setting the
+ bibliography format}
\label{tab:\LabelBase.bibliography}
\begin{desctabular}
\pventry{leveldown}{%
\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
- The bibliography will use a heading of one step lower section level than
- default.%
- \IndexOption{bibliography~=\PValue{leveldown}}}%
- \pventry{nottotoc}{%
- The bibliography will neither have an entry at the table of contents nor
- a number,%
- \IndexOption{bibliography~=\PValue{nottotoc}}}%
+ The bibliography uses a sectioning command one level lower than
+ the default.%
+ \IndexOption{bibliography~=\textKValue{leveldown}}}%
+ \entry{\PValue{notoc}, \PValue{nottotoc}, \PValue{plainheading}}{%
+ The bibliography receives neither an entry in the table of contents nor
+ a number.%
+ \IndexOption{bibliography~=\textKValue{nottotoc}}}%
+ \entry{\PValue{numbered}, \PValue{tocnumbered}, \PValue{totocnumbered},
+ \PValue{numberedtoc}, \PValue{numberedtotoc}}{%
+ The bibliography receives an entry in the table of contents and a
+ number.%
+ \IndexOption{bibliography~=\textKValue{numbered}}}%
\pventry{oldstyle}{%
- The bibliography will use the classic, compact formation, where
- \DescRef{maincls-experts.cmd.newblock}\IndexCmd{newblock} generates an
- expandable horizontal distance only.%
- \IndexOption{bibliography~=\PValue{oldstyle}}}%
+ The bibliography uses the classic, compact formation, where
+ \DescRef{maincls-experts.cmd.newblock}\IndexCmd{newblock} generates only
+ a horizontal glue.%
+ \IndexOption{bibliography~=\textKValue{oldstyle}}}%
\pventry{openstyle}{%
- The bibliography will use the structured, open formation, where
+ The bibliography uses the structured, open format where
\DescRef{maincls-experts.cmd.newblock}\IndexCmd{newblock} generates a
paragraph break.%
- \IndexOption{bibliography~=\PValue{openstyle}}}%
- \pventry{totoc}{%
- The bibliography will have an entry at the table of contents but no
+ \IndexOption{bibliography~=\textKValue{openstyle}}}%
+ \pventry{standardlevel}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ The bibliography uses the standard sectioning command level.%
+ \IndexOption{bibliography~=\textKValue{standardlevel}}}%
+ \entry{\PValue{toc}, \PValue{totoc}, \PValue{notnumbered}}{%
+ The bibliography receives an entry in the table of contents but no
number.%
- \IndexOption{bibliography~=\PValue{totoc}}}%
- \pventry{totocnumbered}{%
- The bibliography will have an entry at the table of contents and a
- number at the heading.%
- \IndexOption{bibliography~=\PValue{totocnumbered}}}%
+ \IndexOption{bibliography~=\textKValue{totoc}}}%
\end{desctabular}
\end{table}
%
@@ -3926,29 +4445,28 @@ that additional values may be generated using
\begin{Declaration}
\Macro{setbibpreamble}\Parameter{preamble}
\end{Declaration}%
-The command \Macro{setbibpreamble} can be used to set a preamble for the
-bibliography\Index{bibliography}. This can be achieved by placing the preamble
-before the command for issuing the bibliography. However, it need not be
-directly in front of it. For example, it could be placed at the beginning of
-the document. Similar\textnote{Attention!} to the options
+You can use the \Macro{setbibpreamble} command to set a preamble for the
+bibliography\Index{bibliography}. This preamble must be placed before the
+command for issuing the bibliography. However, it need not be directly
+in front of it. For example, it could be placed at the beginning of
+the document. Like\textnote{Attention!} the
\OptionValueRef{\LabelBase}{bibliography}{totoc} and
-\OptionValueRef{\LabelBase}{bibliography}{totocnumbered}, this command can
-only be successful if you have not loaded a package which prevents this by
-redefining the \Environment{thebibliography} environment. Even though the
-\Package{natbib} package\IndexPackage{natbib} makes unauthorized use of
-internal macros of {\KOMAScript} it could be achieved that
-\Macro{setbibpreamble} works with the current version of \Package{natbib} (see
-\cite{package:natbib}).
+\OptionValueRef{\LabelBase}{bibliography}{totocnumbered} options, this command
+only works if you have not loaded a package which prevents this from happening
+by redefining the \Environment{thebibliography} environment. Although the
+\Package{natbib} package\IndexPackage{natbib} uses undocumented, internal
+{\KOMAScript} macros, \Macro{setbibpreamble} could still work with the current
+version of \Package{natbib} (see \cite{package:natbib}).
\begin{Example}
- You want to point out that the sorting of the references in the
- bibliography is not according to their occurrence in the text, but
- in alphabetical order. You use the following command:
+ You want to point out that the bibliographical references are sorted
+ alphabetically by the names of the authors. You therefore use the following
+ command:
\begin{lstcode}
\setbibpreamble{References are in alphabetical order.
References with more than one author are sorted
according to the first author.\par\bigskip}
\end{lstcode}
- The \Macro{bigskip}\IndexCmd{bigskip} command makes sure that the
+ The \Macro{bigskip}\IndexCmd{bigskip} command ensures that the
preamble and the first reference are separated by a large vertical
space.%
\end{Example}%
@@ -3962,13 +4480,14 @@ internal macros of {\KOMAScript} it could be achieved that
This\textnote{Attention!}\ChangedAt{v3.00}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}} command exists only if the
environment \Environment{thebibliography} has not been redefined by another
-package. It provides a break at the bibliography. The \PName{interruption
- code} will be expanded inside a group. Such a break may be, e.\,g., a
-heading using \DescRef{\LabelBase.cmd.minisec}. Unfortunately it is not
-possible to add this command to the \BibTeX{} database using, e.\,g., a
-special kind of \BibTeX{} entry. Because of this, users may use is currently
-only if they make the bibliography on their own. Because of this usage is very
-limited.%
+package. With this instruction, you can insert a break into the
+bibliography. The \PName{interruption code} will be expanded inside a
+group. Such a break may be, for example, a heading using
+\DescRef{\LabelBase.cmd.minisec}. Unfortunately there is currently no way to
+have this command automatically generated, for example by using a special
+entry in the \BibTeX{} database. Therefore, it can currently only be used by
+users who edit the bibliography directly. For this reason, its usefulness is
+very limited.%
%
\EndIndexGroup
@@ -3978,23 +4497,22 @@ limited.%
\Macro{AtEndBibliography}\Parameter{code}
\end{Declaration}
In\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}
-some cases it may be useful to add some \PName{code} after the bibliography
-preamble or just before the end of the bibliography. This may be achieved
-using one of this instructions.
+some cases, it may be useful to add some \PName{code} after the bibliography
+preamble or just before the end of the bibliography. This is possible with the
+help of these two instructions.
\begin{Example}
- You want to set the bibliography not justified but ragged right. This may be
- achieved using:
+ You want to set the bibliography not justified but ragged right. You can
+ achieve this with:
\begin{lstcode}
\AfterBibliographyPreamble{\raggedright}
\end{lstcode}
- You may place this instruction anywhere before the
- bibliography. Nevertheless it is recommended to do so at the preamble of the
- document or inside your own package.
+ You can put this instruction anywhere before the bibliography. However, it is
+ recommended to do so in the preamble of the document or a separate package.
\end{Example}
The\textnote{Attention!} functionality of this instruction depends on
-cooperation with packages modifying the bibliography, if such a package should
-be used (see \autoref{sec:maincls-experts.coexistence},
-\DescPageRef{maincls-experts.cmd.AfterBibliographyPreamble}).%
+cooperation with packages modifying the bibliography, if you use such a
+package\iffree{}{(see \autoref{sec:maincls-experts.coexistence},
+\DescPageRef{maincls-experts.cmd.AfterBibliographyPreamble})}.%
%
\EndIndexGroup
%
@@ -4004,54 +4522,83 @@ be used (see \autoref{sec:maincls-experts.coexistence},
\section{Index}
\seclabel{index}
\BeginIndexGroup
-\BeginIndex{}{index}
-For general information about making an index see \cite{lshort},
-\cite{makeindex}, and \cite{xindy}. Using a package, that redefines commands
-or environments for the index, may limit the influence of \KOMAScript{} to the
-index hardly. This would be valid, e.\,g., for usage of package
-\Package{index}\IndexPackage{index} but not for usage of package
-\Package{splitidx}\IndexPackage{splitidx} (see \cite{package:splitindex}).
+For general information about making a keyword index, see \cite{lshort},
+\cite{makeindex}, and \cite{xindy}. Using a package that redefines
+commands or environments for the index \KOMAScript{}'s ability to influence
+the index may disappear. This applies, for example, when using the
+\Package{index}\IndexPackage{index} package, but not when using the
+\Package{splitidx}\IndexPackage{splitidx} package (see
+\cite{package:splitindex}).
\begin{Declaration}
- \OptionVName{index}{selection}%
+ \OptionVName{index}{setting}%
\end{Declaration}
\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
-The index is chapter (\Class{scrbook} or \Class{scrreprt}) or section
-(\Class{scrartcl}) without heading number or entry at the table of contents by
-default or option
-\OptionValue{index}{default}\IndexOption{index~=\PValue{default}}.
-The\important{\OptionValue{index}{totoc}} index does not need an entry at the
-table of contents, because it should always be the last element of a
-document. Nevertheless, such an entry may be achieved using option
-\OptionValue{index}{totoc}\IndexOption{index~=\PValue{totoc}}.
+By default or with \OptionValue{index}{default}%
+\IndexOption{index~=\textKValue{default}}, the index is an unnumbered chapter
+(\Class{scrbook} or \Class{scrreprt}) or section (\Class{scrartcl}) without an
+entry in the table of contents. Since\important{\OptionValue{index}{totoc}}
+the index usually comes last in a book or similar document, it does not
+actually need an entry in the table of contents. Nevertheless, if you want to
+do this, for example because you are working with a multi-index keyword
+dictionary such as the one that appears in this \iffree{guide}{book}, you can
+create this with the
+\OptionValue{index}{totoc}\IndexOption{index~=\textKValue{totoc}} option.
You\ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} can even number the index using option
-\OptionValue{index}{numbered}\IndexOption{index~=\PValue{numbered}}. See also
-option \DescRef{\LabelBase.option.toc} with value \PValue{index} or
-\PValue{indexnumbered} in \autoref{sec:\LabelBase.toc} from
-\DescPageRef{\LabelBase.option.toc.index} onward.
-
-A summary of all available values for option \Option{index} may be found in
-\autoref{tab:\LabelBase.index}.
+ \Class{scrartcl}} can even number the index using the
+\OptionValue{index}{numbered}\IndexOption{index~=\textKValue{numbered}}
+setting. See also the \DescRef{\LabelBase.option.toc} option with the
+\PValue{index} or \PValue{indexnumbered} values in
+\autoref{sec:\LabelBase.toc} starting at
+\DescPageRef{\LabelBase.option.toc.index}.
+
+For example, if you create multiple indexes with
+\Package{splitidx}\IndexPackage{splitidx} (see \cite{package:splitindex}),
+it may be useful to group them under a common heading. To make this possible,
+\OptionValue{index}{leveldown}%
+\ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}\important{\OptionValue{index}{leveldown}} places the index
+one sectioning level deeper than usual. In \Class{scrbook} and
+\Class{scrreprt}, it is no longer a chapter but a section; with
+\Class{scrartcl}, a subsection. The \OptionValue{index}{standardlevel}%
+\ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}\important{\OptionValue{index}{standardlevel}} option is
+the counterpart to this and cancels any instance of
+\OptionValue{index}{leveldown} used previously.
+
+You can find a summary of the available values for the \PName{setting} of
+\Option{index} in \autoref{tab:maincls.index}.
\begin{table}
- \caption{Available values of option \Option{index}}%
- \label{tab:\LabelBase.index}
+ \caption{Available values for the \Option{index} option}
+ \label{tab:maincls.index}
\begin{desctabular}
- \entry{\PValue{default}, \PValue{nottotoc}, \PValue{plainheading}}{%
- The index will not have an entry at the table of contents.%
- \IndexOption{index~=\PValue{default}}}%
- \entry{\PValue{numbered}, \PValue{totocnumbered}}{%
+ \pventry{leveldown}{%
+ \ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ The index is moved down by one sectioning level.%
+ \IndexOption{index~=\textKValue{leveldown}}%
+ }%
+ \entry{\PValue{notoc}, \PValue{nottotoc}, \PValue{plainheading}}{%
+ The index does not receive an entry in the table of contents.%
+ \IndexOption{index~=\textKValue{nottotoc}}}%
+ \entry{\PValue{numbered}, \PValue{tocnumbered}, \PValue{totocnumbered},
+ \PValue{numberedtoc}, \PValue{numberedtotoc}}{%
+ \ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ The index receives an entry in the table of contents and is numbered.%
+ \IndexOption{index~=\textKValue{numbered}}}%
+ \pventry{standardlevel}{%
\ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
- The index will have an entry at the table of contents and also will have
- a heading number.%
- \IndexOption{index~=\PValue{numbered}}}%
- \entry{\PValue{totoc}, \PValue{toc}, \PValue{notnumbered}}{%
- The index will have an entry at the table of contents, but will not have
- a heading number.%
- \IndexOption{index~=\PValue{totoc}}}%
+ The index is at the usual sectioning level.%
+ \IndexOption{index~=\textKValue{standardlevel}}%
+ }%
+ \entry{\PValue{toc}, \PValue{totoc}, \PValue{notnumbered}}{%
+ The index receives an entry in the table of contents without being
+ numbered.%
+ \IndexOption{index~=\textKValue{totoc}}}%
\end{desctabular}
\end{table}
%
@@ -4061,9 +4608,9 @@ A summary of all available values for option \Option{index} may be found in
\begin{Declaration}
\Macro{setindexpreamble}\Parameter{preamble}
\end{Declaration}%
-Similarly to the bibliography you can use a preamble to the
+As with the bibliography, you can also provide a preamble to the
index. This is often the case if you have more than one index or if
-you use different kinds of referencing by highlighting the page
+you mark different kinds of references by highlighting the page
numbers in different ways.
\begin{Example}
You have a document in which terms are both defined and used. The
@@ -4071,31 +4618,38 @@ numbers in different ways.
your reader aware of this fact. Thus you insert a preamble for the
index:
\begin{lstcode}
- \setindexpreamble{In \textbf{bold} printed page numbers are
- references to the definition of terms. Other page numbers
- indicate the use of a term.\par\bigskip}
+ \setindexpreamble{All page numbers printed in \textbf{bold}
+ refer to definitions of terms. Page numbers printed
+ normally refer to pages where the term is used.\par\bigskip}
\end{lstcode}
\end{Example}
-Please note that the page style of the first page of the index is changed. The
-applied page style is defined in the macro
+Note\textnote{Attention!} that the page style is changed for the first page
+of the index. The page style that is applied is defined in the macro
\DescRef{\LabelBase.cmd.indexpagestyle} (see
\autoref{sec:\LabelBase.pagestyle},
\DescPageRef{\LabelBase.cmd.indexpagestyle}).
-The production, sorting and output of the index is done by the
-standard {\LaTeX} packages and additional programs. Similar to the
-standard classes {\KOMAScript} only provides the basic macros and
-environments.%
+The usual \LaTeX{} packages and additional programs are responsible for
+creating, sorting, and outputting the index.%
+\iftrue % Umbruchoptimierung
+ \iffree{}{ %
+ For example, the \Package{imakeidx}\IndexPackage{imakeidx} package
+ (see \cite{package:imakeidx}), which among other things automates the
+ invocation of the \File{makeindex} or \File{xindy} program, is highly
+ recommended. This eliminates a common source of error, particularly for
+ \LaTeX{} beginners.%
+ }
+ {\KOMAScript}, like the standard classes, provides only the basic macros
+ and environments for them.%
+\fi
%
\EndIndexGroup
%
\EndIndexGroup
%
-%
\EndIndexGroup
-
\endinput
%%% Local Variables:
@@ -4105,5 +4659,3 @@ environments.%
%%% ispell-local-dictionary: "english"
%%% TeX-master: "../guide"
%%% End:
-
-% LocalWords: endnotes interleaf
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex
index 2cd16e0229d..7acd9f2bf79 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrdatetime.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrdatetime.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,52 +46,53 @@
% ============================================================================
\KOMAProvidesFile{scrdatetime.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (chapter: scrdate, scrtime)]
-\translator{Markus Kohm\and Gernot Hassenpflug}
+\translator{Markus Kohm\and Gernot Hassenpflug\and Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-02-05
-\chapter{The Day of the Week Using \Package{scrdate}}
+\chapter{The Day of the Week with \Package{scrdate}}
\labelbase{scrdate}
\BeginIndexGroup
\BeginIndex{Package}{scrdate}
-With version~3.05a the functionality of this package enhanced a lot. Beside of
-the current day of the week\Index{day>of the week} this package provides the
-day of the week of every date of the Gregorian calendar now.
+Originally, the \Package{scrdate} package could only give the day of the week
+for the current date. Nowadays, it offers this and more for any date in the
+Gregorian calendar.
\begin{Declaration}
\Macro{CenturyPart}\Parameter{year}\\%
\Macro{DecadePart}\Parameter{year}%
\end{Declaration}%
-The\ChangedAt{v3.05a}{\Package{scrdate}} command \Macro{CenturyPart} offers
-the value of the century digits\,---\,hundreds and thousands\,---\,of a
-\PName{year}. The command \Macro{DecadePart} in difference offers the other
-digits which are the units and tens. The number of digits of \PName{year} does
-not care. The value may be assigned to a counter or may be used for
-calculations, i.\,e., using \Macro{numexpr}\IndexCmd{numexpr}. For
-output\textnote{Attention!} of an Arabic number of the value prefix it with
-\Macro{the}\IndexCmd{the}.
+The\ChangedAt{v3.05a}{\Package{scrdate}} \Macro{CenturyPart} command returns
+the value of the century digits\,---\,thousands and hundreds\,---\,of a
+\PName{year}. The \Macro{DecadePart} command, on the other hand, gives the
+value of the remaining digits, i.\,e. the tens and the units. The
+\PName{year} can have any number of digits. You can assign the value directly
+to a counter or use it for calculations with
+\Macro{numexpr}\IndexCmd{numexpr}. To output\textnote{Attention!} it as an
+Arabic number, you should prefix it with \Macro{the}\IndexCmd{the}.
\begin{Example}
- You want to calculate and output the century of the current year.
+ You want to calculate and print the century of the current year.
\begin{lstcode}
- The year \the\year\ is the year \the\DecadePart{\year}
+ The year \the\year\ is year \the\DecadePart{\year}
of the \engord{\numexpr\CenturyPart{\year}+1\relax} century.
\end{lstcode}
The result would be:
\begin{quote}
- The year \the\year\ is the year \the\DecadePart{\year}
+ The year \the\year\ is year \the\DecadePart{\year}
of the \engordnumber{\numexpr\CenturyPart{\year}+1\relax} century.
\end{quote}
- Package \Package{engord}\IndexPackage{engord} has been used for this
- example. See \cite{package:engord} for more information.
+ This example uses the \Package{engord}\IndexPackage{engord} package.
+ See \cite{package:engord} for more information.
\end{Example}
-Please\textnote{Attention!} note, that within used method of counting the
-year~2000 is the year~0\,---\,and therefore the first year\,---\,of the
-21st~century.%
+Note\textnote{Attention!} that the counting method used here treats the year
+2000 as year~0\,---\,and therefore the first year\,---\,of the 21st~century.
+If necessary, however, you can make a correction with \Macro{numexpr}, as
+shown for the ordinal number in the example.%
\EndIndexGroup
@@ -99,17 +100,17 @@ year~2000 is the year~0\,---\,and therefore the first year\,---\,of the
\Macro{DayNumber}\Parameter{year}\Parameter{month}\Parameter{day}\\%
\Macro{ISODayNumber}\Parameter{ISO-date}%
\end{Declaration}%
-These\ChangedAt{v3.05a}{\Package{scrdate}} two commands offers the value of
-the number of the day of the week\Index{day>of the week} of any date. The
-differ only in the kind of date declaration. Command \Macro{DayNumber} needs
-\PName{year}, \PName{month}, and \PName{day} as separate parameters. Command
-\Macro{ISODayNumber} expects an \PName{ISO-date} as a single argument. The
-expected format of the \PName{ISO-date} is:
+These\ChangedAt{v3.05a}{\Package{scrdate}} two commands return the value of
+the day-of-the-week\Index{day>of the week} number for any date. They differ
+only in the method of specifying the date. While the \Macro{DayNumber} command
+requires the \PName{year}, \PName{month}, and \PName{day} as separate
+parameters, the \Macro{ISODayNumber} command expects an \PName{ISO-date} as a
+single argument, \PName{ISO-date}, using the ISO notation
\PName{year}\texttt{-}\PName{month}\texttt{-}\PName{day}. It does not matter
-whether \PName{month} or \PName{day} have one or two digits. The result of
-both commands may be assigned to a counter or used for calculations, i.\,e.,
-using \Macro{numexpr}\IndexCmd{numexpr}. For output\textnote{Attention!} of an
-Arabic number of the value prefix it with \Macro{the}\IndexCmd{the}.
+if the \PName{month} or \PName{day} have one or two digits. You can use the
+result of both commands to assign directly to a counter or for calculations
+using \Macro{numexpr}\IndexCmd{numexpr}. To print\textnote{Attention!} it as
+an Arabic number, you should prefix it with \Macro{the}\IndexCmd{the}.
\begin{Example}
You want to know the number of the day of the week of the 1st~May~2027.
@@ -124,28 +125,29 @@ Arabic number of the value prefix it with \Macro{the}\IndexCmd{the}.
\end{quote}
\end{Example}
-A special feature is to walk a number of days into future or past from a given
-date.
+It is particularly worth noting that you can even step a specified number of
+days into the future or or the past from a given date.
\begin{Example}
- You want to know the number of the day of the week, that will be in 12~days
- and that will be 24~days before the 24th~December~2027.
+ You want to know the number of the day of the week 12~days from now
+ and 24~days before the 24th~December~2027.
\begin{lstcode}
- In 12~days the number of the day of the week
- will be \the\DayNumber{\year}{\month}{\day+12} and
+ In 12~days, the number of the day of the week
+ will be \the\DayNumber{\year}{\month}{\day+12}, and
24~days before the 24th~December~2027 it will be
\the\ISODayNumber{2027-12-24-24}.
\end{lstcode}
- The result may be, e.\,g.:
+ The result could be, for example:
\begin{quote}
- In 12~days the number of the day of the week
- will be \the\DayNumber{\year}{\month}{\day+12} and
+ In 12~days, the number of the day of the week
+ will be \the\DayNumber{\year}{\month}{\day+12}, and
24~days before the 24th~December~2027 it will be
\the\ISODayNumber{2027-12-24-24}.
\end{quote}
\end{Example}
-The days of the week are numbered: Sunday\,=\,0, Monday\,=\,1, Tuesday\,=\,2,
-Wednesday\,=\,3, Thursday\,=\,4, Friday\,=\,5, and Saturday\,=\,6.%
+The days of the week are numbered as follows: Sunday\,=\,0, Monday\,=\,1,
+Tuesday\,=\,2, Wednesday\,=\,3, Thursday\,=\,4, Friday\,=\,5, and
+Saturday\,=\,6.%
%
\EndIndexGroup
@@ -155,48 +157,48 @@ Wednesday\,=\,3, Thursday\,=\,4, Friday\,=\,5, and Saturday\,=\,6.%
\Macro{DayName}\Parameter{year}\Parameter{month}\Parameter{day}\\%
\Macro{ISODayName}\Parameter{ISO-date}%
\end{Declaration}%
-Usually\ChangedAt{v3.05a}{\Package{scrdate}} you do not want to know the number
-of the day of the week, but the name of the day of the week. Because of this,
-the command \Macro{DayNameByNumber} offers the name of the day of the week
-corresponding with a number. The number may be the result of \Macro{DayNumber}
-or \Macro{ISODayNumber}. The two commands \Macro{DayName} and
-\Macro{ISODayName} directly offer the name of the day of the week of a given
-date.
+Usually\ChangedAt{v3.05a}{\Package{scrdate}} you are less interested in the
+number of the day of the week than in its name. Therefore, the
+\Macro{DayNameByNumber} command returns the name of the day of the week
+corresponding to a day-of-the-week number. This number can be the result, for
+example, of \Macro{DayNumber} or \Macro{ISODayNumber}. The two commands
+\Macro{DayName} and \Macro{ISODayName} directly return the name of the day of
+the week of a given date.
\begin{Example}
You want to know the name of the day of the week of the 24th~December~2027.
\begin{lstcode}
- Please pay you bill until \ISODayName{2027-12-24},
- 24th~December~2027.
+ Please pay by \ISODayName{2027-12-24},
+ 24th~December~2027 the amount of \dots.
\end{lstcode}
The result will be:
\begin{quote}
- Please pay you bill until \ISODayName{2027-12-24},
- 24th~December~2027.
+ Please pay by \ISODayName{2027-12-24},
+ 24th~December~2027 the amount of \dots.
\end{quote}
\end{Example}
-Again a special feature is to make some calculations inside the argument of
-\Macro{DayName}.
+Once again, it is particularly worth noting that you can perform calculations,
+to a certain extent:
\begin{Example}
- You want to know the names of the days of the week, that will be in 12~days
- and that will be 24~days before the 24th~December~2027.
+ You want to know the names of the day of the week 12~days from now
+ and 24~days before the 24th~December~2027.
\begin{lstcode}
- In 12~days the name of the day of the week
- will be \DayName{\year}{\month}{\day+12} and
+ In 12~days, the name of the day of the week
+ will be \DayName{\year}{\month}{\day+12}, and
24~days before the 24th~December~2027 it will be
- \ISODayName{2027-12-24-24}. Nevertheless two weeks
- and three days after a Wednesday a
- \DayNameByNumber{3+2*7+3} will follow.
+ \ISODayName{2027-12-24-24}, while two weeks
+ and three days after a Wednesday will be a
+ \DayNameByNumber{3+2*7+3}.
\end{lstcode}
- The result may be, e.\,g.:
+ The result could be, for example:
\begin{quote}
- In 12~days the name of the day of the week
- will be \DayName{\year}{\month}{\day+12} and
+ In 12~days, the name of the day of the week
+ will be \DayName{\year}{\month}{\day+12}, and
24~days before the 24th~December~2027 it will be
- \ISODayName{2027-12-24-24}. Nevertheless two weeks
- and three days after a Wednesday a
- \DayNameByNumber{3+2*7+3} will follow.
+ \ISODayName{2027-12-24-24}, while two weeks
+ and three days after a Wednesday will be a
+ \DayNameByNumber{3+2*7+3}.
\end{quote}
\end{Example}%
%
@@ -209,54 +211,52 @@ Again a special feature is to make some calculations inside the argument of
\Macro{todaysname}%
\Macro{todaysnumber}%
\end{Declaration}%
-In the prior examples the current date have been given cumbersomely and
-explicitly using the \TeX{} registers \Macro{year}\IndexCmd{year},
-\Macro{month}\IndexCmd{month}, and \Macro{day}\IndexCmd{day}. The commands
+In the previous examples, the current date was always specified cumbersomely
+using the \TeX{} registers \Macro{year}\IndexCmd{year},
+\Macro{month}\IndexCmd{month}, and \Macro{day}\IndexCmd{day}. The
\Macro{ISOToday}\ChangedAt{v3.05a}{\Package{scrdate}} and \Macro{IsoToday}
-offers the current date in ISO-notation directly. These commands differ in the
-number of digits for numbers less than 10 only. \Macro{ISOToday} prefixes
-numbers less than 10 for the month and day with a 0. In opposite to this
-\Macro{IsoToday} will show numbers less than 10 for the month and day with one
-digit only. Command \Macro{todaysname} directly offers the name of the current
-day of the week. Command \Macro{todaysnumber} offers the number of that name
-instead. More information about usability of this value may be found at
-previous description of \DescRef{scrdate.cmd.DayNumber} and \DescRef{scrdate.cmd.ISODayNumber}.
+commands directly return the current date in ISO-notation. These commands
+differ only in the fact that \Macro{ISOToday} always outputs a two-digit month
+and day, while \Macro{IsoToday} outputs single-digit numbers for values less
+than 10. The \Macro{todaysname} command directly returns the name of the
+current day of the week, while \Macro{todaysnumber} returns the number of the
+current day of the week. You can find more information about using this value
+in the explanations of \DescRef{scrdate.cmd.DayNumber} and
+\DescRef{scrdate.cmd.ISODayNumber}.
\begin{Example}
- I want to show you the name of the weekday in which this document has been
- type-set:
- \begin{lstlisting}
- I have done the {\LaTeX} run of this document
- on a \todaysname.
- \end{lstlisting}
- This will result in, e.\,g.:
+ I want to show you on what day of the week this document was typeset:
+\begin{lstlisting}
+ This document was created on a \todaysname.
+\end{lstlisting}
+ This will result, for example, in:
\begin{quote}
- I have done the {\LaTeX} run of this document
- on a \todaysname.
+ This document was created on a \todaysname.
\end{quote}
\end{Example}
-Note that the package is not able to decline words. The known terms
-are the nominative singular that may be used, e.\,g., in the date of a
-letter. Given this limitation, the example above can work correctly
-only for some languages.
+For languages that have a case system for nouns, note that the package cannot
+decline words. The terms are given in the form appropriate for displaying a
+date in a letter, which is the nominative singular for the currently supported
+languages. Given this limitation, the example above will not work correctly if
+translated directly into some other languages.
\begin{Explain}
- The\textnote{Hint!} names of the weekdays are saved in capitalized form,
- i.\,e., the first letter is a capital letter, all the others are lowercase
- letters. But for some languages you may need the names completely in
- lowercase. You may achieve this using the standard {\LaTeX} command
- \Macro{MakeLowercase}\IndexCmd{MakeLowercase}%
- \important{\Macro{MakeLowercase}}, e.\,g.:
+ The\textnote{Hint!} names of the weekdays in \Package{scrdate} all have
+ initial capital letters. If you need the names completely in lower case, for
+ example because that is the convention in the relevant language, simply wrap
+ the command with the \LaTeX{} \Macro{MakeLowercase}\IndexCmd{MakeLowercase}%
+ \important{\Macro{MakeLowercase}} command:
% Umbruchkorrektur: listings
\begin{lstcode}
\MakeLowercase{\todaysname}
\end{lstcode}
- This converts the whole argument into lower case letters. Of course, this
- may be done also using previous described commands
+ This converts the whole argument into lower-case letters. Of course, you can
+ also do this for
\DescRef{scrdate.cmd.DayNameByNumber}\IndexCmd{DayNameByNumber},
- \DescRef{scrdate.cmd.DayName}\IndexCmd{DayName} and
- \DescRef{scrdate.cmd.ISODayName}\IndexCmd{ISODayName}.%
+ \DescRef{scrdate.cmd.DayName}\IndexCmd{DayName}, and
+ \DescRef{scrdate.cmd.ISODayName}\IndexCmd{ISODayName} commands described
+ above.%
\end{Explain}%
\EndIndexGroup
@@ -264,23 +264,24 @@ only for some languages.
\begin{Declaration}
\Macro{nameday}\Parameter{name}
\end{Declaration}%
-Analogous to how the output of \Macro{today} can be modified using
-\DescRef{maincls.cmd.date}\IndexCmd{date}, so the output of \DescRef{scrdate.cmd.todaysname}
-can be changed to \PName{name} by using \Macro{nameday}.
+Just as you can directly modify the output of \Macro{today} with
+\DescRef{maincls.cmd.date}\IndexCmd{date}, so you can change the output of
+\DescRef{scrdate.cmd.todaysname} to \PName{name} with \Macro{nameday}.
\begin{Example}
You change the current date to a fixed value using
- \DescRef{maincls.cmd.date}. You are not interested in the actual name of
- the day, but want only to show that it is a workday. So you set:
+ \DescRef{maincls.cmd.date}. You are not interested in the actual name of the
+ day, but want only to show that it is a workday. So you write:
\begin{lstlisting}
\nameday{workday}
\end{lstlisting}
- After this the previous example will result in:
+ After this, the previous example will result in:
\begin{quote}\nameday{workday}
- I have done the {\LaTeX} run of this document on a \todaysname.
+ This document was created on a \todaysname.
\end{quote}
\end{Example}
-There's no such command for changing the result of
-\DescRef{scrdate.cmd.ISOToday}\IndexCmd{ISOToday} or \DescRef{scrdate.cmd.IsoToday}\IndexCmd{IsoToday}.
+There's no corresponding command to change the result of
+\DescRef{scrdate.cmd.ISOToday}\IndexCmd{ISOToday} or
+\DescRef{scrdate.cmd.IsoToday}\IndexCmd{IsoToday}.%
\EndIndexGroup
@@ -291,7 +292,7 @@ There's no such command for changing the result of
\Parameter{Friday}\Parameter{Saturday}
\Parameter{Sunday}%
\end{Declaration}
-Currently the package \Package{scrdate} knows the following languages:
+Currently the \Package{scrdate} package recognizes the following languages:
\begin{itemize}\setlength{\itemsep}{.5\itemsep}
\item Croatian (\PValue{croatian}),
\item Czech (\PValue{czech}\ChangedAt{v3.13}{\Package{scrdate}}),
@@ -310,61 +311,57 @@ Currently the package \Package{scrdate} knows the following languages:
\item Italian (\PValue{italian}),
\item Norwegian (\PValue{norsk}),
\item Polish (\PValue{polish}\ChangedAt{v3.13}{\Package{scrdate}}),
+\item Slovak (\PValue{slovak}),
\item Spanish (\PValue{spanish}),
\item Swedish (\PValue{swedish}).
\end{itemize}
-If you want to configure it for other languages, you may use this command. The
-first argument is the name of the language and the other arguments are the
-names of the corresponding days.
+You can also configure it for additional languages. To do so, the first
+argument of \Macro{newdaylanguage} is the name of the language, and the other
+arguments are the names of the corresponding days of the week.
-In the current implementation it does not matter whether you load
-\Package{scrdate} before or after
-\Package{german}\IndexPackage{german},
-\Package{ngerman}\IndexPackage{ngerman},
-\Package{babel}\IndexPackage{babel} or similar packages. In both cases the
-correct language will be used.
+In the current implementation, it does not matter whether you load
+\Package{scrdate} before or after \Package{ngerman}\IndexPackage{ngerman},
+\Package{babel}\IndexPackage{babel}, or similar packages. In each case the
+correct language will be used provided it is supported.
\begin{Explain}
- To explain a little bit more exactly: while you are using a language
- selection which works in a compatible way to
- \Package{babel}\IndexPackage{babel} or
- \Package{ngerman}\IndexPackage{ngerman}, the correct language will be used
- by \Package{scrdate}. If you are using another language selection you will
- get (US-)English names.
+ To be more precise, as long as you select a language in a way that is
+ compatible with \Package{babel}\IndexPackage{babel}, \Package{scrdate} will
+ use the correct language. If this is not the case, you will get (US) English
+ names.
\end{Explain}
-By the way: If you found a suitable definition for a language, that has not
-been defined before, please mail it to the \KOMAScript{} author. There is a
-good chance, that he will add support for the language to \Package{scrdate}.%
+Of course, if you create definitions for a language that was previously
+unsupported, please mail them to the author of \KOMAScript{}. There is a good
+chance that future versions of \KOMAScript{} will add support for that
+language.%
\EndIndexGroup
%
\EndIndexGroup
-\chapter{Getting the Time with Package \Package{scrtime}}
+\chapter{The Current Time with \Package{scrtime}}
\labelbase{scrtime}
\BeginIndexGroup
\BeginIndex{Package}{scrtime}
-This package provides an answer to the question of the current time. Since
-version~3.05 this package uses the option interface already known from
-the \KOMAScript{} classes and several other \KOMAScript{} packages. See for
-example \autoref{sec:typearea.options} for more information.
+This package lets you find the current time. Starting with version~3.05, the
+package also supports the option interface already familiar from the
+\KOMAScript{} classes and various other \KOMAScript{} packages. See, for
+example, \autoref{sec:typearea.options} for more information.
\begin{Declaration}%
\Macro{thistime}\OParameter{delimiter}%
\Macro{thistime*}\OParameter{delimiter}
\end{Declaration}%
-\Macro{thistime} results in the current time\Index{time}. The
-delimiter between the values of hour, minutes and seconds can be given
-in the optional argument. The default symbol of the delimiter is
-``\PValue{:}''.
-
-\Macro{thistime*} works in almost the same way as \Macro{thistime}.
-The only difference is that unlike with \Macro{thistime}, with
-\Macro{thistime*} the value of the minute field is not preceded by a
-zero when its value is less than 10. Thus, with \Macro{thistime} the
-minute field has always two places.
+\Macro{thistime} returns the current time\Index{time} in hours and minutes.
+The delimiter between the values of hour, minutes and seconds can be given in
+the optional argument. The default is the character ``\PValue{:}''.
+
+\Macro{thistime*} works in almost the same way as \Macro{thistime}. The only
+difference is that, unlike \Macro{thistime}, \Macro{thistime*} does not add a
+leading zero to the minute field when its value is less than 10. Thus, with
+\Macro{thistime} the minute field has always two places.
\begin{Example}
The line
\begin{lstlisting}
@@ -399,37 +396,40 @@ minute field has always two places.
\Macro{settime}\Parameter{time}
\end{Declaration}%
\Macro{settime} sets the output of \DescRef{scrtime.cmd.thistime} and
-\DescRef{scrtime.cmd.thistime*} to the value \PName{time}. Now the optional
-parameter of \DescRef{scrtime.cmd.thistime} or \DescRef{scrtime.cmd.thistime*} is ignored, since
-the result of \DescRef{scrtime.cmd.thistime} or \DescRef{scrtime.cmd.thistime*} was completely
-determined using \Macro{settime}.%
+\DescRef{scrtime.cmd.thistime*} to a fixed value. In this case, the optional
+parameter of \DescRef{scrtime.cmd.thistime} or \DescRef{scrtime.cmd.thistime*}
+is ignored, since the complete string returned by
+\DescRef{scrtime.cmd.thistime} or \DescRef{scrtime.cmd.thistime*} has been
+explicitly defined. \Macro{settime}.%
\EndIndexGroup
\begin{Declaration}
- \OptionVName{12h}{simple-switch}%
+ \OptionVName{12h}{simple switch}%
\end{Declaration}%
\BeginIndex{Option}{24h}%
-With option \Option{12h}\ChangedAt{v3.05a}{\Package{scrtime}} one can select
-whether the result of \DescRef{scrtime.cmd.thistime} and \DescRef{scrtime.cmd.thistime*} is in 12- or in
-24-hour format. The option understands the values for simple-switch listed in
-\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. The option
-without a value is same like \OptionValue{12h}{true} and therefore
-12-hour-format will be used. The default is \Option{24h}.
-
-You may use this option either as a global option in the optional argument of
+With the \Option{12h}\ChangedAt{v3.05a}{\Package{scrtime}} option, you can
+select whether to print the time given by \DescRef{scrtime.cmd.thistime} and
+\DescRef{scrtime.cmd.thistime*} in 12- or 24-hour format. The option accepts
+the values for simple switches listed in \autoref{tab:truefalseswitch},
+\autopageref{tab:truefalseswitch}. Using the option without a value is
+equivalent to \OptionValue{12h}{true}, and therefore activates the
+12-hour-format. The default, however, is \Option{24h}.
+
+You can set this option globally in the optional argument of
\DescRef{typearea.cmd.documentclass}, as a package option in the optional
-argument of \DescRef{typearea.cmd.usepackage} or after loading the package
-using \DescRef{typearea.cmd.KOMAoptions} or \DescRef{typearea.cmd.KOMAoption}
-(see, e.\,g., \autoref{sec:typearea.options},
-\DescPageRef{typearea.cmd.KOMAoptions}). The option has no effect on the
-results of \DescRef{scrtime.cmd.thistime} and \DescRef{scrtime.cmd.thistime*}
-if \DescRef{scrtime.cmd.settime} is used.
-
-Only\textnote{Attention!} for compatibility with former releases of
-\Package{scrtime} also option \Option{24h} will switch to 24-hour format if
-used in the optional argument of \Macro{documentclass} or
-\Macro{usepackage}. Nevertheless, you should not use this option any longer.%
+argument of \DescRef{typearea.cmd.usepackage}, or even after loading the
+package using \DescRef{typearea.cmd.KOMAoptions} or
+\DescRef{typearea.cmd.KOMAoption} (see, e.\,g. \autoref{sec:typearea.options},
+\DescPageRef{typearea.cmd.KOMAoptions}). However the option no longer has any
+effect on the if you call \DescRef{scrtime.cmd.settime}. After invoking this
+command, the time is output only with the value and in the format specified
+there.
+
+For\textnote{Attention!} the sake of compatibility with earlier versions of
+\Package{scrtime}, the option \Option{24h} will switch to 24-hour format if
+used in the optional argument of \Macro{documentclass} or \Macro{usepackage}.
+However, you should not use this option any longer.%
\EndIndexGroup
%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrextend.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrextend.tex
index 95d01f243d1..f168ad4ddd8 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrextend.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrextend.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrextend.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrextend.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,57 +46,69 @@
% ======================================================================
\KOMAProvidesFile{scrextend.tex}
- [$Date: 2017-05-11 15:48:59 +0200 (Thu, 11 May 2017) $
+ [$Date: 2018-03-27 11:46:14 +0200 (Tue, 27 Mar 2018) $
KOMA-Script package scrextend]
-\translator{Markus Kohm}
+\translator{Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-01-24
-\chapter[{\KOMAScript{} Features for other Classes with Package
- \Package{scrextend}}]{Making Basic Feature of the \KOMAScript{} Classes
- Available with Package \Package{scrextend} while Using Other Classes}
+\chapter[{\KOMAScript{} Features for Other Classes with \Package{scrextend}}]
+ {Using Basic Features of the \KOMAScript{} Classes in Other Classes with the
+ \Package{scrextend} Package}
\labelbase{scrextend}
\BeginIndexGroup%
\BeginIndex{Package}{scrextend}%
-There are several features, that are shared by all \KOMAScript{} classes. This
-means not only the classes \Class{scrbook}, \Class{scrreprt}, and
-\Class{scrartcl}, that has been made as a drop-in replacement for the standard
-classes \Class{book}, \Class{report}, and \Class{article}, but also for
-several features of the \KOMAScript{} class \Class{scrlttr2}, the successor of
-\Class{scrlettr}, that may be used for letters. These basic features, that may
-be found in the above-named classes, are also provided by package
-\Package{scrextend} since \KOMAScript{} release~3.00. This package should not
-be used together with a \KOMAScript{} class, but may be used together with
-many other classes. Package \Package{scrextend} would recognize, if it would
-be used with a \KOMAScript{} class, and would terminate with a warning message
-in that case.
-
-There is no warranty for compatibility of \Package{scrextend} with every
-class. The package has been designed primary to extend the standard classes
-and derived classes. Anyway, before using \Package{scrextend} you should
-make sure that the used class does not already provide the feature you need.
-
-Beside the features from this chapter, there are additional common features,
-that are mainly provides for authors of classes and packages. These may be
-found in \autoref{cha:scrbase} from \autopageref{cha:scrbase}. The package
-\Package{scrbase}\important{\Package{scrbase}}, that has been described at
-that chapter, was designed to be used mainly by authors of classes and
-packages. Package \Package{scrextend} and all \KOMAScript{} classes also use
-that package.
-
-\KOMAScript{} classes and package \Package{scrextend} also load package
-\Package{scrlfile}\important{\Package{scrlfile}} described in
-\autoref{cha:scrlfile} from \autopageref{cha:scrlfile}. Because of this the
-features of that package are also available when using \Package{scrextend}.
+There are some features that are common to all \KOMAScript{} classes. This
+applies not only to the \Class{scrbook}, \Class{scrreprt}, and
+\Class{scrartcl} classes, which are intended to replace the standard classes
+\Class{book}, \Class{report}, and \Class{article}, but also to a large extend
+the \KOMAScript{} class \Class{scrlttr2}, the successor to \Class{scrlettr},
+which is intended for letters. These basic features, which can be found in the
+classes mentioned above, are also provided by package \Package{scrextend} from
+\KOMAScript{} version~3.00 onward. This\textnote{Attention!} package should
+not be used with \KOMAScript{} classes. It is intended for use with other
+classes only. If you attempt to load the package with a \KOMAScript{} class,
+\Package{scrextend} will detect this and reject loading it with a warning
+message.
+
+The fact that \hyperref[cha:scrlttr2]{\Package{scrletter}}%
+\IndexPackage{scrletter} can be used not only with \KOMAScript{} classes but
+also with the standard classes is partly due to \Package{scrextend}. If
+\hyperref[cha:scrlttr2]{\Package{scrletter}} detects that it is not being used
+with a \KOMAScript class, it automatically loads \Package{scrextend}. Doing
+so makes all required \KOMAScript{} classes available.
+
+Of course, there is no guarantee that \Package{scrextend} will work with all
+classes. The package has been designed primarily to extend the standard
+classes and those derived from them. In any case, before you use
+\Package{scrextend}, you should first make sure that the class you are using
+does not already provide the feature you need.
+
+In addition to the features described in this chapter, there are a few more
+that are primarily intended for authors of classes and packages. These can be
+found in \autoref{cha:scrbase}, starting on \autopageref{cha:scrbase}. The
+\hyperref[cha:scrbase]{\Package{scrbase}}%
+\important{\hyperref[cha:scrbase]{\Package{scrbase}}}\IndexPackage{scrbase}
+package documented there is used by all \KOMAScript{} classes and the
+\Package{scrextend} package.
+
+All \KOMAScript{} classes and the \Package{scrextend} package also load the
+\hyperref[cha:scrlfile]{\Package{scrlfile}}%
+\important{\hyperref[cha:scrlfile]{\Package{scrlfile}}}\IndexPackage{scrlfile}
+package described in \autoref{cha:scrlfile} starting on
+\autopageref{cha:scrlfile}. Therefore the features of this package are also
+available when using \Package{scrextend}.
\iftrue % Umbruchkorrekturtext
-In difference to the above, only the \KOMAScript{} classes \Class{scrbook},
-\Class{scrreprt}, and \Class{scrartcl} load package \Package{tocbasic} (see
-\autoref{cha:tocbasic} from \autopageref{cha:tocbasic}), that has been
-designed to be used by authors of classes and packages too. Because of this
-\Package{scrextend} does not provide the features of this package. Nevertheless
-you may use \Package{tocbasic} together with \Package{scrextend}.%
+In contrast, only the \KOMAScript{} classes \Class{scrbook}, \Class{scrreprt},
+and \Class{scrartcl} load the \hyperref[cha:tocbasic]{\Package{tocbasic}}
+package (see \autoref{cha:tocbasic} starting on \autopageref{cha:tocbasic}),
+which is designed for authors of classes and packages. For this reason, the
+features defined there are found only in those classes and not in
+\Package{scrextend}. Of course you can still use
+\hyperref[cha:tocbasic]{\Package{tocbasic}} together with
+\Package{scrextend}.%
\fi
\LoadCommonFile{options}% \section{Early or late Selection of Options}
@@ -107,33 +119,32 @@ you may use \Package{tocbasic} together with \Package{scrextend}.%
\section{Optional, Extended Features}
\seclabel{optionalFeatures}
-Package \Package{scrextend} provides some optional, extended features. Such
-features are not available by default, but may be activated
-additionally. These features are optional, i.\,e., because the conflict with
-features of the standard classes of often used packages.
+The \Package{scrextend} package provides some optional, extended features.
+These features are not available by default but can be activated. These
+features are optional because, for example, they may conflict with features of
+the standard classes of other commonly used packages.
\begin{Declaration}
\OptionVName{extendedfeature}{feature}
\end{Declaration}
-With this option an extended \PName{feature} of \Package{scrextend} may be
-activated. Option \Option{extendedfeature} is available only while loading the
-package \Package{scrextend}. User have to set the option in the optional
-argument of \DescRef{\LabelBase.cmd.usepackage}\OParameter{optional
- argument}\PParameter{scrextend}. %
+With this option, you can activate an extended \PName{feature} of
+\Package{scrextend}. This option is available only while loading
+\Package{scrextend}. You must therefore specify this option in the optional
+argument of \DescRef{\LabelBase.cmd.usepackage}\PParameter{scrextend}. %
\iffree{%
- An overview of all available optional features is shown in
+ An overview of all available features is shown in
\autoref{tab:scrextend.optionalFeatures}.
\begin{table}
- \caption[{optional available extended features of
- \Package{scrextend}}]{overview of the optional available extended
+ \caption[{available extended features of
+ \Package{scrextend}}]{overview of the optional extended
features of \Package{scrextend}}
\label{tab:scrextend.optionalFeatures}
\begin{desctabular}
\entry{\PName{title}}{%
- extends the title pages to the features of the \KOMAScript{} classes;
- this means not only the commands for the title page but also option
- \DescRef{\LabelBase.option.titlepage} (see
+ title pages have the additional features of the \KOMAScript{} classes;
+ this applies not only to the commands for the title page but also to
+ the \DescRef{\LabelBase.option.titlepage} option (see
\autoref{sec:scrextend.titlepage}, from
\autopageref{sec:scrextend.titlepage})%
}%
@@ -142,13 +153,11 @@ argument of \DescRef{\LabelBase.cmd.usepackage}\OParameter{optional
}{%
\par%
Currently the only available extended \PName{feature} is
- \PValue{title}\IndexOption[indexmain]{extendedfeature~=\PValue{title}}%
- \important[i]{\begin{tabular}[t]{@{}r@{}}
- \KOption{extendedfeature}\hspace*{1em}\\\PValue{title}\end{tabular}}.
- This \PName{feature} provides the title pages of the \KOMAScript{}
- classes. See \autoref{sec:scrextend.titlepage} from
- \autopageref{sec:scrextend.titlepage} for description of these kind of title
- pages.%
+ \PValue{title}\IndexOption[indexmain]{extendedfeature~=\textKValue{title}}%
+ \important{\OptionValue{extendedfeature}{title}}.
+ This \PName{feature} gives title pages the features of the \KOMAScript{}
+ classes, as described in \autoref{sec:scrextend.titlepage} starting on
+ \autopageref{sec:scrextend.titlepage}.%
}%
%
\EndIndexGroup
@@ -164,29 +173,30 @@ argument of \DescRef{\LabelBase.cmd.usepackage}\OParameter{optional
\LoadCommonFile{oddorevenpage}% \section{Detection of Odd and Even Pages}
-\section{Head and Foot Using Predefined Page Styles}
+\section{Choosing a Predefined Page Style}
\seclabel{pagestyle}
One of the basic features of a document is the page
-style\Index[indexmain]{page>style}. Page style in \LaTeX{} means mainly header
-and footer of the page. Package \Package{scrextend} does not define any page
-style, but it uses and expects the definition some page styles.
+style\Index[indexmain]{page>style}. In \LaTeX{}, the page style primarily
+determines the content of headers and footers. The \Package{scrextend} package
+does not define any page styles itself. Instead it uses the page styles of the
+\LaTeX{} kernel.
\begin{Declaration}
\Macro{titlepagestyle}
\end{Declaration}%
\Index{title>page style}%
-Some pages have a different page style automatically selected using
-\DescRef{maincls.cmd.thispagestyle}. With \Package{scrextend} this will be
-used currently for the page with the in-page title if and only if option
+On some pages \DescRef{maincls.cmd.thispagestyle}\IndexCmd{thispagestyle}
+automatically selects a different page style. Currently, \Package{scrextend}
+only does this for title pages, and only if
\OptionValueRef{\LabelBase}{extendedfeature}{title} has been used (see
\autoref{sec:scrextend.optionalFeatures},
\DescPageRef{scrextend.option.extendedfeature}). In this case the page style
-stored at \DescRef{maincls.cmd.thispagestyle} will be used. Default for
+specified in \DescRef{maincls.cmd.thispagestyle} will be used. The default for
\DescRef{maincls.cmd.thispagestyle} is
-\PageStyle{plain}\IndexPagestyle{plain}. This page style is predefined by the
-\LaTeX{} kernel. So it should be available always.%
+\PageStyle{plain}\IndexPagestyle{plain}. This page style is defined by the
+\LaTeX{} kernel, so it should always be available.%
\EndIndexGroup
\LoadCommonFile{interleafpage}% \section{Interleaf Pages}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrhack.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrhack.tex
index c45340f6dd8..a7dfac605c5 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrhack.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrhack.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrhack.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrhack.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,197 +46,211 @@
% ============================================================================
\KOMAProvidesFile{scrhack.tex}
- [$Date: 2017-03-31 12:00:24 +0200 (Fri, 31 Mar 2017) $
+ [$Date: 2018-03-27 11:46:14 +0200 (Tue, 27 Mar 2018) $
KOMA-Script guide (chapter: scrhack)]
-\translator{Markus Kohm}
+\translator{Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2017-01-02
-\chapter{Hacks for Third-Party Packages by Package \Package{scrhack}}
+% Date of the translated German file: 2018-02-05
+\chapter{Improving Third-Party Packages with \Package{scrhack}}
\labelbase{scrhack}
\BeginIndexGroup
\BeginIndex{Package}{scrhack}
-Some packages from other authors could have problems with \KOMAScript{}. In my
-opinion some packages could be improved. With some packages this makes only
-sense, if \KOMAScript{} was used. With some other packages the package author
-has another opinion. Sometimes proposals was never answered. Package
-\Package{scrhack} contains all those improvement proposals for other
-packages. This means, \Package{scrhack} redefines macros of packages from
-other authors! The redefinitions are only activated, if those packages were
-loaded. Users can prevent \Package{scrhack} from redefining macros of
-individual packages.
-
-\section{State of Development Note}
+Some packages from other authors do not work well with \KOMAScript{}. It is
+often very tedious for the author of \KOMAScript{} to convince the authors of
+these packages to make specific improvements. This also applies to packages
+whose development has been discontinued. That's why the \Package{scrhack} was
+created. This package alters the commands and definitions of other to work
+better with \KOMAScript{}. Some changes are also useful when using other
+classes.
+
+\section{Development Status}
\label{scr:scrhack.draft}
-Though this package is part of \KOMAScript{} for long time and though it has
-been used by lot of users, there's one problem with it. While redefinition of
-macros of foreign packages, it depend on the exact definition an usage of
-those macros. This means additionally, that it depends on dedicated releases
-of those packages. If a unknown release of such a package will be used,
-\Package{scrhack} eventually could not do the needed patch. Contrary, in
-extreme cases the patch can cause errors and fault.
+Although this package has been part of \KOMAScript{} for long time and is used
+by many users, there's one problem with it. Redefining macros from third-party
+packages depends on knowing the exact definition and use of those macros. This
+also means that it depends on specific versions of those packages. If you use
+a unknown version of such a package, \Package{scrhack} may not be able to
+execute the required patch. In extreme cases, patching an unknown version can
+lead to an error.
-So \Package{scrhack} has to be continuously modified to fit new releases of
-foreign packages and will never be finished. Because of this \Package{scrhack}
-will stay in beta state forever. Though the usage will generally be a
-benefit, the correct function could not be guaranteed forever.
+Because \Package{scrhack} must be continuously modified to accommodate new
+releases of third-party packages, it can never be considered complete.
+Therefore \Package{scrhack} will remain permanently in a beta version.
+Although its use will generally be a benefit, its correct functioning cannot
+be permanently guaranteed.
\LoadCommonFile{options}% \section{Early or late Selection of Options}
-\section{Usage of \Package{tocbasic}}
+\section{Using \Package{tocbasic}}
\seclabel{improvement}
-In the early days of \KOMAScript{} users asked for handling lists of floats,
-that will be generated using package
-\Package{float}\IndexPackage{float}\important{\Package{float}}, like list of
-figures and list of tables, that are generated by \KOMAScript{} itself. At
-that time the \KOMAScript{} author contacted the author of \Package{float}, to
-submit a proposal of an interface with support for such an extention. A
-somehow modified version of that interface has been implemented with commands
+In the early days of \KOMAScript{}, users wanted to handle lists of floating
+environments created with the
+\Package{float}\IndexPackage{float}\important{\Package{float}} package in the
+same way as the list of figures and list of tables created by \KOMAScript{}
+itself. At that time the author of \KOMAScript{} contacted the author of
+\Package{float} to propose an interface to support such an extension. A
+somewhat modified form of that interface was implemented with the
\Macro{float@listhead}\IndexCmd[indexmain]{float@listhead} and
-\Macro{float@addtolists}\IndexCmd[indexmain]{float@addtolists}.
-
-Sometimes later it has appeared, that those two commands were not flexible
-enough to support all of the comprehensive features supported by
-\KOMAScript. Unfortunately the author of \Package{float} has finalized the
-development already, so nobody should expect furthor changes of this package.
-
-Other package authors have also inherited these commands. Thereby it appeared,
-that the implementation in some packages, even in package \Package{float},
-will need a certain package loading order, though all these packages are not
-related to each other. Wrong loading order could result in an error or break the
-functionality of the commands.
-
-To clear all these disadvantages and problems, \KOMAScript{} officially does not
-support this old interface any more. Instead, \KOMAScript{} warns if the old
-interface is used. At the same time package
-\Package{tocbasic}\IndexPackage{tocbasic}\important{\Package{tocbasic}} (see
-\autoref{cha:tocbasic}) has been designed and implemented as a central
-interface for management of table of contents, lists of floats and similar
-lists. Usage of this package provides much more advantages and features than
-the two old commands that have been mentioned above.
-
-Though the effort using that package is very small, the authors of most of the
-packages, that are using the old interface, have not done so
-currently. Because of this \Package{scrhack} contains appropriate
-modifications of packages
+\Macro{float@addtolists}\IndexCmd[indexmain]{float@addtolists} commands.
+
+Later it became apparent that these two commands were not flexible enough to
+fully support all of \KOMAScript's capabilities. Unfortunately, the author of
+\Package{float} had already ceased development by that point, so further
+changes to this package cannot be expected.
+
+Other package authors have also adopted these two commands, and it became
+apparent that the implementation in some packages, including \Package{float},
+means that all these packages can only be loaded in a specific order, even
+though they are otherwise unrelated to each other.
+
+To overcome all these disadvantages and problems, \KOMAScript{} no longer
+officially supports this old interface. Instead, \KOMAScript{} warns if the
+old interface is used. At the same time, the
+\Package{tocbasic}\IndexPackage{tocbasic}\important{\Package{tocbasic}}
+package (see \autoref{cha:tocbasic}) has been designed and implemented as a
+central interface for managing of table of contents and similar content lists.
+This package provides many more advantages and features than the two old
+commands.
+
+Although the effort to use this package is very small, so far the authors of
+most of the packages that use the old interface have not made any adjustments.
+Therefore \Package{scrhack} contains appropriate modifications of the
\Package{float}\IndexPackage{float}\important{\Package{float},
- \Package{floatrow}, \Package{listings}},
+\Package{floatrow}, \Package{listings}},
\Package{floatrow}\IndexPackage{floatrow}, and
-\Package{listings}\IndexPackage{listings}. Loading \Package{scrhack} is enough
-to make these packages recognize not only setting of \KOMAScript{} option
+\Package{listings}\IndexPackage{listings} packages. Merely loading
+\Package{scrhack} is sufficient to make these packages recognize not only the
+setting of the \KOMAScript{} option
\DescRef{maincls.option.listof}\IndexOption{listof~=\PName{setting}}, but also
-language switching of package \Package{babel}\IndexPackage{babel}. More
-information about the features provided by the changeover to package
-\Package{tocbasic} can be found in \autoref{sec:tocbasic.toc}.
-
-If the modification for any of the packages is not wanted or causes problems,
-then it can be deactivated selectively with option
-\OptionValue{float}{false}\IndexOption[indexmain]{float~=\PValue{false}},
-\OptionValue{floatrow}{false}\IndexOption[indexmain]{floatrow~=\PValue{false}},
+to react to the language switching features of the
+\Package{babel}\IndexPackage{babel} package. You can find more information
+about the features available by switching packages to \Package{tocbasic} in
+\autoref{sec:tocbasic.toc}.
+
+If you do not want this modification for any of the packages, or if it causes
+problems, you can deactivate it selectively with the
+\OptionValue{float}{false}\IndexOption[indexmain]{float~=\textKValue{false}},
+\OptionValue{floatrow}{false}\IndexOption[indexmain]{floatrow~=\textKValue{false}},
or
-\OptionValue{listings}{false}\IndexOption[indexmain]{listings~=\PValue{false}}.
-Please note\textnote{Attention!} that changing these options after loading the
-corresponding package would not do it!
+\OptionValue{listings}{false}\IndexOption[indexmain]{listings~=\textKValue{false}}
+option. Note\textnote{Attention!} that changing these options after loading
+the associated package has no effect!
-\section{Incorrect Expectations to \Macro{@ptsize}}
+\section{Incorrect Assumptions about \Macro{@ptsize}}
\seclabel{ptsize}
-Some packages always expect that the class-internal macro
-\Macro{@ptsize}\IndexCmd{@ptsize} is not only defined but also expands to an
-integer. For compatibility, \KOMAScript{} defines \Macro{@ptsize} even if the
-basic font size is neither 10\Unit{pt} nor 11\Unit{pt} nor
-12\Unit{pt}. \KOMAScript{} also provides non-integer font sizes. So
-\Macro{@ptsize} can expand to a non-integer number, too.
-
-Package\ChangedAt{v3.17}{\Package{scrhack}}
-\Package{setspace}\IndexPackage[indexmain]{setspace} is one of the packages
-that fail with non-integer number expansion of \Macro{@ptsize}. Additionally
-the line stretching of that package always depends on the basic font size even
-if setting is made in the context of another font size. Package
-\Package{scrhack} solves both problems by redefining \Macro{onehalfspacing}
-and \Macro{doublespacing} using always the current font size while setting the
-stretch.
-
-If the modification for the package is not wanted or causes problems,
-then it can be deactivated selectively with option
-\OptionValue{setspace}{false}\IndexOption[indexmain]{setspace~=\PValue{false}}.
-Please note\textnote{Attention!} that changing these option after loading
-\Package{setspace} would not do it! If you use \Package{setspace} with
-either option \Option{onehalfspacing} or \Option{doublespacing} you have to
-load \Package{scrhack} before it.
-
-
-\section{Special Case \Package{hyperref}}
+Some packages assume that the class-internal macro
+\Macro{@ptsize}\IndexCmd{@ptsize} both is defined and expands to an integer.
+For compatibility, \KOMAScript{} defines \Macro{@ptsize} even if the basic
+font size is something other than 10\Unit{pt}, 11\Unit{pt}, or 12\Unit{pt}.
+\KOMAScript{} also allows non-integer font sizes. So \Macro{@ptsize} can, of
+course, also expand to a non-integer number.
+
+One\ChangedAt{v3.17}{\Package{scrhack}} of the packages that cannot cope with
+a non-integer \Macro{@ptsize} is
+\Package{setspace}\IndexPackage[indexmain]{setspace}. Additionally, the values
+set by this package are always dependent on the basic font size, even if the
+setting is made in the context of another font size. The \Package{scrhack}
+package solves both problems by redefining \Macro{onehalfspacing} and
+\Macro{doublespacing} to set the spacing relative to the actual font size.
+
+If you do not want this modification for the package, or if it causes
+problems, you can deactivate it selectively with the
+\OptionValue{setspace}{false}\IndexOption[indexmain]{setspace~=\textKValue{false}}
+option. Note\textnote{Attention!} that changing this option after loading
+\Package{setspace} has no effect! Likewise, if you use \Package{setspace} with
+either the \Option{onehalfspacing} or \Option{doublespacing} option, you must
+load \Package{scrhack} first.
+
+
+\section{Older Versions of \Package{hyperref}}
\seclabel{hyperref}
-Before version~6.79h package \Package{hyperref} set the link anchors after
-instead of before the heading of star version commands like
-\DescRef{maincls.cmd.part*}, \DescRef{maincls.cmd.chapter*}, and so on. In
-the meantime this problem have been solved at the \KOMAScript{} author's
-suggestion. But because the \KOMAScript{} author was not patient enough to
-wait more than a year for the change of \Package{hyperref}, a corresponding
-patch has been added to \Package{scrhack}. This can be deactivated by
-\OptionValue{hyperref}{false}. Nevertheless, it is recommended to use the
-current \Package{hyperref} release. In this case \Package{scrhack} does
-automatically deactivate the not longer needed patch.%
+Versions of \Package{hyperref} before 6.79h set the link
+anchors after the heading of the starred versions of commands like
+\DescRef{maincls.cmd.part*}, \DescRef{maincls.cmd.chapter*}, etc. instead of
+before them. Since then, this problem has been resolved at the suggestion of
+\KOMAScript{}'s author. But because the change took more than a year, a patch
+was added to \Package{scrhack}. Although this can also be deactivated with
+\OptionValue{hyperref}{false}, you should instead use the current
+\Package{hyperref} release. In this case \Package{scrhack} automatically
+deactivates this unnecessary patch.%
\section{Inconsistent Handling of \Length{textwidth} and \Length{textheight}}
\seclabel{lscape}
-Package\ChangedAt{v3.18}{\Package{scrhack}}
-\Package{lscape}\IndexPackage[indexmain]{lscape} defines an environment
-\Environment{landscape}\IndexEnv{landscape} to set the page contents but not
-head and foot landscape. Inside this environment it changes
-\Length{textheight}\IndexLength{textheight} to the value of
-\Length{textwidth}, but it does not change \Length{textwidth} to the former
-value of \Length{textheight}. This is inconsistent. As far as I know,
-\Length{textwidth} is unchanged because setting it to \Length{textheight}
-could blame other packages or user commands. But changing \Length{textheight}
-could also blame other packages or user commands and indeed it breaks, e.\,g.,
-\Package{showframe}\IndexPackage{showframe} and
-\Package{scrlayer}\IndexPackage{scrlayer}. So best would be, not to change
-\Length{textheight}, too. \Package{scrhack} uses package \Package{xpatch} (see
-\cite{package:xpatch}) to modify the environment start macro \Macro{landscape}
-appropriately.
-
-If the modification for the package is not wanted or causes problems,
-then it can be deactivated selectively with option
-\OptionValue{lscape}{false}\IndexOption[indexmain]{lscape~=\PValue{false}}.
-Please note\textnote{Attention!} that changing this option after loading
-\Package{lscape} has an effect only, if it is not \PValue{false} while
-loading \Package{lscape} respectively \Package{scrhack}, if
-\Package{scrhack} is loaded after \Package{lscape}.
-
-Please note\textnote{Attention!},
-\Package{pdflscape}\IndexPackage[indexmain]{pdflscape} also uses
-\Package{lscape} and therefore is influenced by \Package{scrhack}, too.%
+The\ChangedAt{v3.18}{\Package{scrhack}}
+\Package{lscape}\IndexPackage[indexmain]{lscape} package defines a
+\Environment{landscape}\IndexEnv{landscape} environment to set the page
+contents, but not the header or footer in landscape mode. Inside this
+environment, \Length{textheight}\IndexLength{textheight} is set to the value
+of \Length{textwidth}, but \Length{textwidth} is not set to the former value
+of \Length{textheight}. This is inconsistent. As far as I know,
+\Length{textwidth} is left unchanged because setting it to \Length{textheight}
+could interfere with other packages or user commands. But changing
+\Length{textheight} also has this potential, and indeed it breaks, for
+example, \Package{showframe}\IndexPackage{showframe} and
+\Package{scrlayer}\IndexPackage{scrlayer}. Thus it would be best if
+\Length{textheight} too remained unchanged. \Package{scrhack} uses the
+\Package{xpatch} package (see \cite{package:xpatch}) to modify the
+\Macro{landscape} environment's start macro appropriately.
+
+If you do not want this modification, or if it causes problems, you can
+deactivate it with the
+\OptionValue{lscape}{false}\IndexOption[indexmain]{lscape~=\textKValue{false}}
+option. Note\textnote{Attention!} that changing \Option{lscape} subsequently
+with \DescRef{\LabelBase.cmd.KOMAoption}\IndexCmd{KOMAoption} or
+\DescRef{\LabelBase.cmd.KOMAoptions}\IndexCmd{KOMAoptions} has an effect only
+if it was not \PValue{false} while loading \Package{lscape}.
+
+Incidentally, the \Package{pdflscape}\IndexPackage[indexmain]{pdflscape}
+package also uses \Package{lscape}, so \Package{scrhack} affects the
+functioning of this package too.%
\section{Special Case \Package{nomencl}}
\label{sec:nomencl}
-The\ChangedAt{v3.23}{\Package{scrhack}} hack for package
-\Package{nomencl}\IndexPackage[indexmain]{nomencl} is a somehow special
-case. First of all it extends \Package{nomencl}'s option \Option{intoc} to
-respect \KOMAScript's option
-\OptionValueRef{maincls}{toc}{indentunnumbered}. As a sidestep it also
-reserves the file extensions \File{nlo} and \File{nls} for package
-\Package{tocbasic} (see \DescRef{tocbasic.cmd.addtotoclist},
-\autoref{sec:tocbasic.basics},
-\DescPageRef{tocbasic.cmd.addtotoclist}). Furthermore, you can use several
-features for the file extension \File{nls} using
-\DescRef{tocbasic.cmd.setuptoc}. For example, you can use
-\DescRef{tocbasic.cmd.setuptoc}\PParameter{nls}\PParameter{numbered} to not
-only add an entry to the table of contents but also number the headings of the
-nomenclature. As an side effect the nomenclature also gets a running head if
-automatic running heads are activated, e.\,g., using page style
-\DescRef{maincls.pagestyle.headings}. All these extension are done by a small
-patch of environment \Environment{thenomenclature}.
-%
+The\ChangedAt{v3.23}{\Package{scrhack}} hack for the
+\Package{nomencl}\IndexPackage[indexmain]{nomencl} represents a somewhat
+special case. First, it ensures that the optional table of contents entry for
+the nomenclature observes the \OptionValueRef{maincls}{toc}{indentunnumbered}
+option. Somewhat incidentally, it also reserves the file extensions \File{nlo}
+and \File{nls} for the owner \PValue{nomencl} (see
+\DescRef{tocbasic.cmd.addtotoclist}, \autoref{sec:tocbasic.basics},
+\DescPageRef{tocbasic.cmd.addtotoclist}).
+
+It also changes the \Environment{thenomenclature}\IndexEnv{thenomenclature}
+environment to use
+\DescRef{tocbasic.cmd.tocbasic@listhead}\IndexCmd{tocbasic@listhead} for the
+heading (see \autoref{sec:tocbasic.internals},
+\DescPageRef{tocbasic.cmd.tocbasic@listhead}). In this way, the hack lets you
+set various attribute for the \File{nls} extension using
+\DescRef{tocbasic.cmd.setuptoc}\IndexCmd{setuptoc}%
+\important{\DescRef{tocbasic.cmd.setuptoc}}. For example, not only can you
+enter the nomenclature in the table of contents with
+\DescRef{tocbasic.cmd.setuptoc}\PParameter{nls}\PParameter{numbered}, but you
+can also number it immediately. You can find more about
+\DescRef{tocbasic.cmd.setuptoc} and its available settings in
+\autoref{sec:tocbasic.toc}, starting on \DescPageRef{tocbasic.cmd.setuptoc}.
+As a small but important side effect, this patch also gives the nomenclature
+also matching running head, if automatic running heads are activated, for
+example by using the \DescRef{maincls.pagestyle.headings} page style.
+
+This rather simple patch is an example of how packages that do not define
+floating environments can still benefit from \Package{tocbasic}. However, you
+do not want this change, or if it causes problems, you can deactivate it with
+the \OptionValue{nomencl}{false}%
+\IndexOption[indexmain]{nomencl~=\textKValue{false}} option.
+The\textnote{Achtung!} setting of the option when \Package{nomencl} is loaded
+is crucial! Later changes to the option with
+\DescRef{\LabelBase.cmd.KOMAoption} or \DescRef{\LabelBase.cmd.KOMAoptions}
+have no influence and will lead to a corresponding warning.%
\EndIndexGroup
\endinput
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrjura.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrjura.tex
index 98320e6a3ab..1d19af010aa 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrjura.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrjura.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrjura.tex
-% Copyright (c) Markus Kohm, 2011-2017
+% Copyright (c) Markus Kohm, 2011-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrjura.tex
-% Copyright (c) Markus Kohm, 2011-2017
+% Copyright (c) Markus Kohm, 2011-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,32 +46,32 @@
% ======================================================================
\KOMAProvidesFile{scrjura.tex}%
- [$Date: 2017-05-08 11:47:04 +0200 (Mon, 08 May 2017) $
+ [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (chapter: scrjura)]
-\translator{Alexander Willand\and Markus Kohm}
+\translator{Alexander Willand\and Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2017-05-08
+% Date of the translated German file: 2018-02-06
-\chapter{Support for the Law Office by \Package{scrjura}}
+\chapter{Support for the Law Office with \Package{scrjura}}
\labelbase{scrjura}
\BeginIndexGroup
\BeginIndex{Package}{scrjura}
-In case you'd like to write a contract\Index{contract}, the bylaws of a
-company or of the club, an act of law or a whole commentary, the package
-\Package{scrjura} will provide typographical support. Despite the fact that
-\Package{scrjura} is intended as a broad help for juridical documents, the
-contract is the central element of the package. Particular attention is being
-paid to the clause with numbered title and numbered paragraphs\,---\,if
-a clause consists of more than one paragraph\,---, even numbered sentences,
-entries in the table of contents and cross references according to German
-standards.
+If you want to write a contract\Index{contract}, the articles of association
+for a company or an association, a law, or a legal commentary, the package
+\Package{scrjura} will provide typographical support. Although
+\Package{scrjura} is intended to provide general help for legal documents, the
+contract is the central element of the package. Particular attention is paid
+to clauses, titles, and numbered provisions\,---\,if there are several of
+them in a clause\,---, numbered sentences, entries in the table of
+contents, and cross references according to German standards.
-The package has been developed in cooperation with Dr Alexander Willand,
-lawyer in Karlsruhe.
+The package has been developed in cooperation with Dr Alexander Willand of
+Karlsruhe. Many of its features go back to constructive inquiries from Prof
+Heiner Richter of the Hochschule Stralsund University of Applied Sciences.
-Note\textnote{Attention!} that the package cooperates with
+Note\textnote{Attention!} that the package works with
\Package{hyperref}\IndexPackage{hyperref}. Nevertheless, \Package{hyperref}
has to be loaded after \Package{scrjura} as usual.
@@ -82,29 +82,30 @@ has to be loaded after \Package{scrjura} as usual.
\section{Table of Contents}
\label{sec:scrjura.toc}
-The package \Package{scrjura} provides entries into the table of contents.
+The headings of clauses can also be added automatically to the table of
+contents, if desired.
\begin{Declaration}
\OptionVName{juratotoc}{simple switch}%
\OptionVName{juratotoc}{level number}
\end{Declaration}
-A clause\Index{clause} is being shown in the table of contents only, if its
-\PName{level number} is smaller or equal to the counter
+Clauses\Index{clause} are shown in the table of contents only if their
+\PName{level number} is less than or equal to the
\DescRef{maincls.counter.tocdepth}%
-\important{\DescRef{maincls.counter.tocdepth}}\IndexCounter{tocdepth} (see
-\autoref{sec:maincls.toc}, \DescPageRef{maincls.counter.tocdepth}). Default
-for the \PName{level number} is 10000, which as well will be used, if the
-option is switched off by the \PName{simple
- switch}\important{\OptionValue{juratotoc}{false}} (see
+\important{\DescRef{maincls.counter.tocdepth}}\IndexCounter{tocdepth} counter
+(see \autoref{sec:maincls.toc}, \DescPageRef{maincls.counter.tocdepth}). By
+default, the \PName{level number} is 10000, which is also used if the option
+is switched off with the \PName{simple
+switch}\important{\OptionValue{juratotoc}{false}} (see
\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}). Because the
-counter \DescRef{maincls.counter.tocdepth} usually has a one digit value,
-clause entries are not shown in the table of contents.
-
-If you switch on the option using the \PName{simple
- switch}\important{\OptionValue{juratotoc}{true}}, as a default \PName{level
- number} 2 is used, so that clauses are shown in the table of contents on the
-same level as subsections. If the counter \DescRef{maincls.counter.tocdepth}
-has default values as well, clauses are shown with all \KOMAScript{} classes.%
+\DescRef{maincls.counter.tocdepth} counter usually has a one-digit value,
+clause entries are therefore not normally displayed in the table of contents.
+
+If you switch on the option using the \PName{simple switch}%
+\important{\OptionValue{juratotoc}{true}}, the \PName{level number} 2 is used
+so that clauses are shown in the table of contents on the same level as
+subsections. For the default setting of \DescRef{maincls.counter.tocdepth},
+clauses are then shown in all \KOMAScript{} classes.%
\EndIndexGroup
@@ -112,9 +113,10 @@ has default values as well, clauses are shown with all \KOMAScript{} classes.%
\OptionVName{juratocindent}{indent}%
\OptionVName{juratocnumberwidth}{number width}
\end{Declaration}
-These two options can be used to determine the indentation in the table of
-contents as well as the reserved space for the numbers there. Defaults are the
-values for the subsection entries in \Class{scrartcl}.%
+These two options can be used to determine the indentation for the clause
+entries in the table of contents as well as the space reserved for the numbers
+there. The defaults are the same as for subsection entries in
+\Class{scrartcl}.%
\EndIndexGroup
@@ -123,24 +125,24 @@ values for the subsection entries in \Class{scrartcl}.%
\BeginIndexGroup
\BeginIndex{}{contract}
-The main mechanism of \Package{scrjura} only work inside of the contract
-environment.
+The essential mechanisms of \Package{scrjura} are available only inside the
+contract environment.
\begin{Declaration}
\begin{Environment}{contract}\end{Environment}
\end{Declaration}
-Till this date, this is the one and only environment for legal practitioner
-provided by \Package{scrjura}. Using it will activate the automatic numbering
-of paragraphs and the commands \DescRef{\LabelBase.cmd.Clause} and
-\DescRef{\LabelBase.cmd.SubClause} will become a form, which will be
-documented below.
-
-The\textnote{Attention!} environment \DescRef{\LabelBase.env.contract} must
-not be nested in itself. Within the document the environment may be used
-several times. In this case the clauses within the environment are treated as
-if they were within the same environment. Ending the environment means just a
-break and with beginning a new environment in the same document the former
-environment is continued. A break inside a clause is not possible.%
+Currently, this is the one and only environment for \Package{scrjura}. Using
+it activates automatic numbering of paragraphs and the
+\DescRef{\LabelBase.cmd.Clause} and \DescRef{\LabelBase.cmd.SubClause}
+commands, which will be documented below, are given concrete form.
+
+The\textnote{Attention!} \DescRef{\LabelBase.env.contract} environment must
+not be nested within itself. Within a document, however, you can use the
+environment several times. The clauses within these environments are treated
+as if they were within a single environment. As a result, ending the
+environment really only temporarily interrupts it, and the old environment is
+continued by the beginning of a new environment. However, you cannot end the
+environment within a clause.%
\EndIndexGroup
@@ -151,15 +153,14 @@ The whole document becomes a contract if you use this option while loading the
package with \DescRef{\LabelBase.cmd.usepackage}%
\important{\DescRef{\LabelBase.cmd.usepackage}} or as a global option with
\DescRef{\LabelBase.cmd.documentclass}%
-\important{\DescRef{\LabelBase.cmd.documentclass}}. The document behaves as
-if you started the contract environment right after the beginning of the
-document.
-
-Neither\textnote{Attention!} you can use this option with
-\DescRef{\LabelBase.cmd.KOMAoption} nor with
-\DescRef{\LabelBase.cmd.KOMAoptions}, so that it is not possible to switch the
-option off in this way. Please use the \DescRef{\LabelBase.env.contract}
-environment directly.%
+\important{\DescRef{\LabelBase.cmd.documentclass}}. The document then behaves
+exactly as if it contained one \DescRef{\LabelBase.env.contract} environment.
+
+Note\textnote{Attention!} that you cannot set the \Option{contract} option
+with \DescRef{\LabelBase.cmd.KOMAoption} or
+\DescRef{\LabelBase.cmd.KOMAoptions}. Thus you cannot switch the option off
+again. Instead, you should use a \DescRef{\LabelBase.env.contract} environment
+directly.%
\EndIndexGroup
@@ -167,42 +168,48 @@ environment directly.%
\label{sec:scrjura.clause}
\index{section|seealso{clause}}
-With \Package{scrjura} clauses\footnote{%
- In English, the word ``section'' also is used in an act of law or in an
- agreement. To distinguish \DescRef{maincls.cmd.section} of most document
- classes from the section in \Package{scrjura}, we decided to call the
- section in the latter simply ``clause''.} in a legal sense only exist inside
-of contracts, meaning inside of the environment
-\DescRef{\LabelBase.env.contract}.
+Clauses\footnote{%
+ In English, a ``clause'' in a legal document is a section, paragraph, or
+ phrase that relates to a particular point. Although it is common in English
+ to also use the terms ``article'' or ``section'' for what we here call a
+ ``clause'', we use the latter term throughout to avoid confusion with the
+ \Class{article} class and the \DescRef{maincls.cmd.section} and
+ \DescRef{maincls.cmd.paragraph} sectioning divisions of most document
+ classes.} in a legal sense are defined in \Package{scrjura} only within
+contracts, that is inside the \DescRef{\LabelBase.env.contract} environment or
+other environments declared with
+\DescRef{\LabelBase.cmd.DeclareNewJuraEnvironment} (see
+\autoref{sec:\LabelBase.newenv},
+\DescPageRef{\LabelBase.cmd.DeclareNewJuraEnvironment}).
\begin{Declaration}
\Macro{Clause}\OParameter{options}%
\Macro{SubClause}\OParameter{options}
\end{Declaration}
-These are the most important commands inside of a contract. Without using
-further \PName{options} the command \Macro{Clause} creates the heading of a
-clause, which consists only of the sign »\S«, followed by its number. In
-contrast to this the command \Macro{SubClause} creates the heading of a clause
-with the last number used by \Macro{Clause} and adds a lowercase
-letter. \Macro{SubClause} mainly is intended for cases where an act or a
-contract is amended and not only clauses are changed or deleted, but between
-existing clauses new ones are inserted without changing the numbering.
-
-Both commands except as \PName{options} a list separated by commas of
-properties. An overview over possible properties is provided by
-\autoref{tab:scrjura.Clause.options}. For the most important of them we will
-go into the details.
+These are the most important commands inside of a contract. Without using any
+additional \PName{options}, \Macro{Clause} creates the heading of a clause,
+which consists of the sign »\S«, followed by its number. In contrast,
+\Macro{SubClause} creates the heading of a clause with the last number used by
+\Macro{Clause} and adds a lower-case letter. \Macro{SubClause} is mainly
+intended for cases where an act or a contract is amended and not only are
+clauses changed or deleted but new clauses are inserted between existing ones
+without completely changing the numbering.
+
+Both commands accept a a comma-separated list of \PName{options}. An overview
+of the available properties is shown in \autoref{tab:scrjura.Clause.options}.
+The most important of them will be discussed in more detail.
\begin{table}
- \caption{Possible properties for the optional argument of \Macro{Clause} and
+ \caption{Available properties for the optional argument of \Macro{Clause} and
\Macro{SubClause}}
\label{tab:scrjura.Clause.options}
\begin{desctabular}
\entry{\Option{dummy}}{%
- The heading will not be printed but counted in the automatic numbering.%
+ The heading will not be printed but is counted in the automatic
+ numbering.%
}%
\entry{\OptionVName{head}{running head}}{%
- If running heads are available, \PName{running head} is used instead of
+ If running heads are active, this \PName{running head} is used instead of
the clause \PName{title}.%
}%
\entry{\Option{nohead}}{%
@@ -221,150 +228,149 @@ go into the details.
Changes the vertical \PName{skip} after the clause heading.%
}%
\entry{\OptionVName{title}{title}}{%
- Additional to the clause number a clause \PName{title} will be printed.
- This is also used as default for the \PName{running head} and the
- \PName{entry} in the table of contents.%
+ The clause \PName{title} will be printed in addition to the clause
+ number. This is also used as the default for the \PName{running head}
+ and the \PName{entry} in the table of contents.%
}%
\entry{\OptionVName{tocentry}{entry}}{%
- Independent from the clause \PName{title}, an \PName{entry} into the
+ Regardless of the clause \PName{title}, an \PName{entry} into the
table of contents will be made, if such entries are activated.%
}%
\end{desctabular}
\end{table}
-A skip of two lines is inserted before the heading and afterwards a skip of
-one line as a default. Via the options
+By default, a skip of two lines is inserted before the heading and a skip of
+one line afterwards. You can change the size of these skips with the
\Option{preskip}\important[i]{\Option{preskip}, \Option{postskip}} and
-\Option{postskip} these skips can be changed. The new values are not only
-valid for the current clause but beginning with the actual clause until the
-end of the current contract environment. It is possible as well to set these
-keys in advance by writing
+\Option{postskip} options. The new values apply not only to the current
+clause but from the current clause until the end of the current contract
+environment. You can also make the appropriate settings in advance with
\begin{flushleft}\quad\small
\textbf{\Macro{setkeys}}\PParameter{contract}%
\PParameter{preskip=\PName{skip},\\
\normalsize\quad\small
\hspace{11.5em}postskip=\PName{skip}}
\end{flushleft}
-independently from a clause and outside of a contract environment as well.
-Also it is possible to set the keys inside of the preamble after loading
-\Package{scrjura}. But it is not possible to set these options while loading
-the package or by using \DescRef{\LabelBase.cmd.KOMAoptions} or
+regardless of the specific clause and outside of a contract environment. You
+can also set these options inside the preamble after loading
+\Package{scrjura}, but you cannot set them while loading the package or by
+using \DescRef{\LabelBase.cmd.KOMAoptions} or
\DescRef{\LabelBase.cmd.KOMAoption}.
\BeginIndex{FontElement}{contract.Clause}\LabelFontElement{contract.Clause}%
\BeginIndex{FontElement}{Clause}\LabelFontElement{Clause}%
-The headings use as a default the fonts
-\Macro{sffamily}\Macro{bfseries}\Macro{large}. The fonts can be changed using
-the element
-\FontElement{contract.Clause}\important{\FontElement{contract.Clause}} with
-the help of \DescRef{\LabelBase.cmd.setkomafont}%
+By default, clause headings use the font style
+\Macro{sffamily}\Macro{bfseries}\Macro{large}. You can change this font style
+at any time using the
+\FontElement{contract.Clause}\important{\FontElement{contract.Clause}} element
+with \DescRef{\LabelBase.cmd.setkomafont}%
\important[i]{\DescRef{\LabelBase.cmd.setkomafont},
- \DescRef{\LabelBase.cmd.addtokomafont}} and
+\DescRef{\LabelBase.cmd.addtokomafont}} and
\DescRef{\LabelBase.cmd.addtokomafont} (see \autoref{sec:maincls.textmarkup},
\DescPageRef{\LabelBase.cmd.setkomafont}). Inside the
-\DescRef{\LabelBase.env.contract} environment instead of
-\FontElement{contract.Clause} simply
-\FontElement{Clause}\important{\FontElement{Clause}} may be used.%
+\DescRef{\LabelBase.env.contract} environment, you can also use
+\FontElement{Clause}\important{\FontElement{Clause}} instead of
+\FontElement{contract.Clause}.%
\EndIndex{FontElement}{Clause}%
\EndIndex{FontElement}{contract.Clause}
-With the options \Option{title}\important[i]{\Option{title}, \Option{head},
- \Option{tocentry}}, \Option{head}, and \Option{tocentry} a clause may get in
-addition to the number a title. It\textnote{Attention!} is recommended to put
-the value of these options inside brackets. Failing this, e.g., commas may
-lead to confusion between different options. Empty values for \Option{head}
-and \Option{tocentry} cause an empty entry. If one would like to avoid an
-entry, the options \Option{nohead}\important[i]{\Option{nohead},
- \Option{notocentry}} and \Option{notocentry} have to be used.
-
-Instead of the running numbers the option
-\Option{number}\important{\Option{number}} manually sets the number of a
-clause. This will have no impact on the numbers of the subsequent clauses.
-Empty numbers are not possible. Fragile commands inside \PName{number} have to
-be protected with \Macro{protect}. It\textnote{Attention!} is recommended only
-to use numbers and letters as assignment to \Option{number}.
-
-With the option \Option{dummy}\important{\Option{dummy}} the output of the
-whole heading of a clause can be suppressed. The automatic numbering will
-count this clause nonetheless. Thus you can skip a clause in the automatic
-numbering with\textnote{Example}
+With the \Option{title}\important[i]{\Option{title}, \Option{head},
+ \Option{tocentry}}, \Option{head}, and \Option{tocentry} options, you can
+title a clause in addition to the number. You\textnote{Attention!} should put
+the value of each options inside curly brackets. Otherwise, for example,
+commas which are meant to be part of the value will be confused with the
+delimiters between different options. Empty values for \Option{head} and
+\Option{tocentry} cause empty entries. If you want to avoid an entry, use the
+\Option{nohead}\important[i]{\Option{nohead}, \Option{notocentry}} and
+\Option{notocentry} options.
+
+Instead of consecutive numbers, you can also set a clause number manually with
+the \Option{number}\important{\Option{number}} option. However, this does not
+affect the numbers of the subsequent clauses. Empty numbers are not possible.
+Fragile commands inside \PName{number} have to be protected with
+\Macro{protect}. You\textnote{Attention!} should use only numbers and letters
+as a \Option{number}.
+
+With the \Option{dummy}\important{\Option{dummy}} option, you can suppress the
+output of the whole heading of a clause. The automatic numbering, however,
+will still count this clause. In this way, you can skip an automatically
+numbered clause with\textnote{Example}
\begin{lstcode}
\Clause{dummy}
\end{lstcode}
-in case the clause has been deleted in a later version of a contract.
+in case the clause corresponding clause has been deleted in a later version of
+a contract.
-Note\textnote{Attention!}, only the values \PValue{true} and \PValue{false}
-may be used in combination with \Option{dummy}. All other values will be
-ignored, but may throw up an error.%
+Note\textnote{Attention!} that the \Option{dummy} option only accepts the
+values \PValue{true} and \PValue{false}. All other values are usually ignored,
+but can lead to an error message in the worst case scenario.%
\EndIndexGroup
\begin{Declaration}
\Macro{Clauseformat}\Parameter{number}
\end{Declaration}
-As already mentioned the clauses and subclauses usually are being numbered.
-The format of the number is done with the help of the command
-\Macro{Clauseformat}, which expects as one and only argument the number. The
-default is defined as
+As already mentioned, clauses and subclauses are normally numbered. The number
+is formatted with the help of the \Macro{Clauseformat} command, which expects
+the number as the only argument. The default is the following:
\begin{lstcode}
\newcommand*{\Clauseformat}[1]{\S~#1}
\end{lstcode}
-and, as you see, it is only the \Macro{S}\IndexCmd{S} followed by a
-non-breaking space and the number. In case of redefinition take care to keep
-it expandable.%
+This produces the section mark, \Macro{S}\IndexCmd{S} (\S), followed by a
+non-breaking space and the number. If you redefine this command, be sure it
+remains expandable.%
\EndIndexGroup
\begin{Declaration}
\OptionVName{juratitlepagebreak}{simple switch}
\end{Declaration}%
-Usually a page break inside a heading is prohibited. Some jurists may need
-page breaks inside of clause headings. Such a break may be allowed using
-\Option{juratitlepagebreak}\important{\Option{juratitlepagebreak}}. The
-possible values for \PName{simple switch} are printed in
+Usually, page breaks are prohibited within heading of all kinds. However, some
+lawyers require page breaks within clause headings. You can allow such a break
+by using \Option{juratitlepagebreak}\important{\Option{juratitlepagebreak}}.
+You can find the available values for \PName{simple switch} in
\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}.%
\EndIndexGroup
\begin{Declaration}
\OptionVName{clausemark}{value}
\end{Declaration}%
-Clauses are a kind of inferior structure with an independent numbering
-they will not have running headlines as a default. Running headlines
-are possible and may be created with alternative properties. The
-possible \PName{values} and their meaning are listed in
-\autoref{tab:scrjura.clausemark}.%
+Since clauses are a subordinate structure with independent numbering, they do
+not produce running heads by default. You can, however, create running heads
+with various settings. You can find the available \PName{values} and their
+meanings in \autoref{tab:scrjura.clausemark}.%
%
\begin{table}
- \caption{Possible values for option \Option{clausemark} for activation of
+ \caption{Available values for the \Option{clausemark} option to activate
running heads}%
\label{tab:scrjura.clausemark}%
\begin{desctabular}
\entry{\PValue{both}}{%
Clauses generate left and right marks for running heads, if the document
provides automatic running heads.%
- \IndexOption{clausemark~=\PValue{both}}%
+ \IndexOption{clausemark~=\textKValue{both}}%
}%
\entry{\PValue{false}, \PValue{off}, \PValue{no}}{%
Clauses do not generate marks for running heads and therefore do not
change running heads.%
- \IndexOption{clausemark~=\PValue{false}}%
+ \IndexOption{clausemark~=\textKValue{false}}%
}%
\entry{\PValue{forceboth}}{%
Clauses use \DescRef{maincls.cmd.markboth} to generate left and right
marks for running heads even if the document does not provide automatic
running heads for the current page style.%
- \IndexOption{clausemark~=\PValue{forceboth}}%
+ \IndexOption{clausemark~=\textKValue{forceboth}}%
}%
\entry{\PValue{forceright}}{%
Clauses use \DescRef{maincls.cmd.markright} to generate right marks for
running heads even if the document does not provide automatic running
heads for the current page style.%
- \IndexOption{clausemark~=\PValue{forceright}}%
+ \IndexOption{clausemark~=\textKValue{forceright}}%
}%
\entry{\PValue{right}}{%
Clauses generate right marks for running heads, if the document provides
automatic running heads.%
- \IndexOption{clausemark~=\PValue{right}}%
+ \IndexOption{clausemark~=\textKValue{right}}%
}%
\end{desctabular}
\end{table}
@@ -374,17 +380,16 @@ possible \PName{values} and their meaning are listed in
\subsection{Paragraphs}
\label{sec:scrjura.par}
-
\BeginIndexGroup
-\BeginIndex{}{paragraph>number}%
-Within clauses the paragraphs are being numbered automatically. With this, the
-paragraphs are a strongly structuring element, similar to
-\DescRef{maincls.cmd.paragraph} or \DescRef{maincls.cmd.subparagraph} known,
-e.\,g., from article classes. Contracts usually use a vertical skip between
-paragraphs. The package \Package{scrjura} does not provide its own mechanism
-for this. Instead, it uses the option \DescRef{maincls.option.parskip}%
-\IndexOption{parskip}\important{\DescRef{maincls.option.parskip}} of the
-\KOMAScript{} classes (see \autoref{sec:maincls.parmarkup},
+\BeginIndex{}{paragraph>numbering}%
+Within clauses, \Package{scrjura} usually numbers paragraphs automatically.
+With this, the paragraphs provide a powerful structuring element, similar to
+\DescRef{maincls.cmd.paragraph} or \DescRef{maincls.cmd.subparagraph} in
+normal documents. For this reason, contracts usually use a vertical skip
+between paragraphs. The \Package{scrjura} package does not provide its own
+mechanism for this. Instead, it uses the \DescRef{maincls.option.parskip}%
+\IndexOption{parskip}\important{\DescRef{maincls.option.parskip}} option of
+the \KOMAScript{} classes (see \autoref{sec:maincls.parmarkup},
\DescPageRef{maincls.option.parskip}).
@@ -392,27 +397,33 @@ for this. Instead, it uses the option \DescRef{maincls.option.parskip}%
\OptionVName{parnumber}{value}
\end{Declaration}
The default numbering of paragraphs is \OptionValue{parnumber}{auto} and
-\OptionValue{parnumber}{true}. Once in a while it might be necessary to switch
-off the automatic numbering. This is done with \OptionValue{parnumber}{false}%
+\OptionValue{parnumber}{true}. Sometimes you may need to disable the automatic
+numbering. You can do this with \OptionValue{parnumber}{false}%
\important{\OptionValue{parnumber}{false}}%
-\IndexOption{parnumber~=\PValue{false}}. In this case the numbering of
-sentences will be reseted.
+\IndexOption{parnumber~=\textKValue{false}}. In this case, only the sentence
+numbering is reset.
-To realise this way of numbering paragraphs it has been necessary to gear into
-the paragraph building mechanism of \LaTeX. In rare cases there is a negative
-impact, which can be avoided by switching to \OptionValue{parnumber}{manual}%
+To implement this option, it has been necessary to hook into the
+paragraph-building mechanism of \LaTeX. In some rare cases, this can have a
+negative effect. If so, you can undo the change with
+\OptionValue{parnumber}{manual}%
\important{\OptionValue{parnumber}{manual}}%
-\IndexOption{parnumber~=\PValue{manual}}. On the other hand \LaTeX itself
-sometimes undoes the change. In those cases one has to activate it again with
-\OptionValue{parnumber}{auto}%
+\IndexOption{parnumber~=\textKValue{manual}}. On the other hand, \LaTeX{}
+itself sometimes undoes the change. In those cases you can activate it again
+with \OptionValue{parnumber}{auto}%
\important{\OptionValue{parnumber}{auto}}%
-\IndexOption{parnumber~=\PValue{auto}}.
-
-In a clause which consist of only one paragraph, the paragraph usually
-has no number. This does only work if there are not two clauses with an
-identical number in a document. Note that the number of paragraphs in a clause
-is not available before the end of the clause. Therefore you need a least two
-\LaTeX{} runs to get the correct, automatic paragraph numbering.%
+\IndexOption{parnumber~=\textKValue{auto}}.
+
+Clauses that consist of a single paragraph do not automatically receive a
+paragraph number. For this to work, there must not be two clauses with an
+identical number in a document. However should you ever need such numbering,
+you should switch to another contract environment (see
+\DescRef{\LabelBase.cmd.DeclareNewJuraEnvironment},
+\autoref{sec:\LabelBase.newenv},
+\DescPageRef{\LabelBase.cmd.DeclareNewJuraEnvironment}).
+Note\textnote{Attention!} that the number of paragraphs in a clause is not
+available before the end of the clause. Therefore you need a least two
+\LaTeX{} runs before the automatic paragraph numbering is correct.%
\EndIndexGroup
@@ -422,20 +433,43 @@ is not available before the end of the clause. Therefore you need a least two
\Macro{parformat}%
\Macro{parformatseparation}
\end{Declaration}%
-For numbering the paragraphs inside a clause we use the counter
-\Counter{par}. The output of \Macro{thepar} will display an arabic number,
-because the default is \Macro{arabic}\PParameter{par}. \Macro{parformat}
-provides the format, which is \Macro{thepar} in rounded brackets. For
-numbering a paragraph manually, use \Macro{parformat} as well. It makes sense
-to call \Macro{parformat} with a following \Macro{nobreakspace} or a tilde.
-
-The\ChangedAt{v0.7}{\Package{scrjura}} output of \Macro{parformat} is followed
-by one or more delimiter(s). These are provided by
-\Macro{parformatseparation}, which currently consists of
-\Macro{nonbreakspace}, the non-breakable inter word distance.
-
-Package\textnote{Attention!} \Package{scrjura} assumes internally, that
-\Macro{thepar} is an arabic number. Don't redefine!%
+For numbering the paragraphs inside a clause we use the \Counter{par} counter.
+The output of \Macro{thepar} will display an Arabic number, because the
+default is \Macro{arabic}\PParameter{par}. \Macro{parformat} provides the
+format, which is \Macro{thepar} in rounded brackets. When numbering a
+paragraph manually, you should also use \Macro{parformat}. It makes sense to
+call \Macro{parformat} with a subsequent \Macro{parformatseparation}, or at
+least a \Macro{nobreakspace} or tilde.
+
+With\ChangedAt{v0.7}{\Package{scrjura}} automatic numbering, \Macro{parformat}
+is followed by \Macro{parformatseparation}, which currently consists of
+\Macro{nonbreakspace}, the non-breakable space.
+
+\BeginIndex{FontElement}{parnumber}\LabelFontElement{parnumber}%
+The paragraph number is usually printed using the currently active font.
+However, you can change this default for the \FontElement{parnumber} element
+at any time with \DescRef{\LabelBase.cmd.setkomafont}%
+\important[i]{\DescRef{\LabelBase.cmd.setkomafont},
+\DescRef{\LabelBase.cmd.addtokomafont}} and
+\DescRef{\LabelBase.cmd.addtokomafont} (see
+\autoref{sec:\LabelBase.textmarkup},
+\DescPageRef{\LabelBase.cmd.setkomafont}).%
+\EndIndex{FontElement}{parnumber}%
+
+Note\textnote{Attention!} that \Package{scrjura} assumes internally that
+\Macro{thepar} is an Arabic number. Therefore you should definitely not
+redefine it!%
+\EndIndexGroup
+
+
+\begin{Declaration}
+ \Macro{withoutparnumber}
+\end{Declaration}
+If the paragraph number is not printed, \Package{scrjura} executes the
+\Macro{withoutparnumber} command at the beginning of the new paragraph. The
+initial definition of this command is empty. This means it is a kind of dummy
+command that does nothing. It has been implemented because of a user request.
+Most users can ignore this command.%
\EndIndexGroup
@@ -443,23 +477,23 @@ Package\textnote{Attention!} \Package{scrjura} assumes internally, that
\Macro{ellipsispar}\OParameter{number}%
\Macro{parellipsis}
\end{Declaration}
-Sometimes\ChangedAt{v0.7}{\Package{scrjura}}\,---\,particularly in
-comparisons\,---\,it is desirable to omit paragraphs, but to mark the
-omission. Those omitted paragraphs\Index{paragraph>omission} shall be included
-in the counter of the paragraphs. The package \Package{scrjura} provides the
-command \Macro{ellipsispar} to do this.
-
-By default \Macro{ellipsispar} omits precisely one paragraph. Using the
-optional argument multiple paragraphs may be omitted. In any case the output
-shows just one not numbered paragraph, which only consists of the ellipsis
+Sometimes\ChangedAt{v0.7}{\Package{scrjura}}\,---\,particularly in comparative
+commentaries\,---\,it is desirable to omit paragraphs but to mark the
+omission. Those omitted paragraphs\Index{paragraph>omission} should be taken
+into account by the paragraph counter. The package \Package{scrjura} provides
+the command \Macro{ellipsispar} to do this.
+
+By default, \Macro{ellipsispar} omits precisely one paragraph. Using the
+optional argument, you can omit multiple paragraphs. In any case, the output
+shows just one unnumbered paragraph, which consists only of the ellipsis
defined by \Macro{parellipsis}. The automatic numbering of paragraphs takes
the \PName{number} of omitted paragraphs into account.
\begin{Example}
- Supposed you are writing a »comment« of the German\footnote{We have decided
- to translate it into English. But please remember, it is only an example
- not of existing law but of a technical realisation with
- \Package{scrjura}.} penal code, but only paragraph 3 of §~2. Nevertheless
- you'd like to hint at the omission. This can be done this way:
+ Suppose you are writing a comment on the German\footnote{Please remember,
+ this translation does not refer to an existing law but is only an example
+ of how you might realise such a commentary with \Package{scrjura}.} penal
+ code, but only on paragraph 3 of \S~2. Nevertheless, you'd like to indicate
+ the omission indirectly. You can do this with:
\begin{lstcode}
\documentclass[parskip=half]{scrartcl}
\usepackage{scrjura}
@@ -468,9 +502,9 @@ the \PName{number} of omitted paragraphs into account.
\Clause{title={Temporal application},number=2}
\ellipsispar[2]
- If, subsequent to the commission of a criminal
- offence, the law provides for a lighter penalty,
- that penalty shall be applicable.
+ If the law that applies at the time the criminal act is
+ committed is changed before the verdict, then the most
+ lenient law shall be applicable.
\ellipsispar[3]
\end{contract}
@@ -480,8 +514,8 @@ the \PName{number} of omitted paragraphs into account.
\end{Example}
The ellipsis is by default \Macro{textellipsis}\IndexCmd{textellipsis}, if
-such a command is defined. If not, \Macro{dots} will be
-used. \Macro{parellipsis} may be redefined with \Macro{renewcommand}.%
+such a command is defined. If not, \Macro{dots} is used. You can redefine
+\Macro{parellipsis} at any time with \Macro{renewcommand}.%
\EndIndexGroup
%
\EndIndexGroup
@@ -490,38 +524,38 @@ used. \Macro{parellipsis} may be redefined with \Macro{renewcommand}.%
\subsection{Sentences}
\label{sec:scrjura.sentence}
-\BeginIndexGroup
+\BeginIndexGroup%
\BeginIndex{}{sentence>number}%
-In a contract the paragraphs consist of one or more sentences. In German acts
-of law it is common to number the sentences as well. Regarding
-\Package{scrjura}, an automatic numbering is cumbersome and error-prone and
-has not been implemented yet.
+Paragraphs in contracts consist of one or more sentences, some of which may
+also be numbered. However, as automatic numbering is cumbersome and
+error-prone, it has not yet been implemented in
+\Package{scrjura}. Semi-automatic numbering, however, is supported.
\begin{Declaration}
\Counter{sentence}%
\Macro{thesentence}%
\Macro{Sentence}
\end{Declaration}
-Manual numbering of sentences is done with the command \Macro{Sentence}. It
-adds one to the counter \Counter{sentence}. As a default, \Macro{thesentence}
-is printed as an arabic number.
+Manual numbering of sentences is done with the \Macro{Sentence} command. It
+adds one to the \Counter{sentence} counter. By default, \Macro{thesentence}
+is printed as an Arabic number.
Using\textnote{Hint!} \Package{babel}\IndexPackage{babel} offers an easy way
-to define a short hand for \Macro{Sentence}:%
+to define a shorthand for \Macro{Sentence}:%
\phantomsection\label{sec:scrjura.shorthandexample}%
\begin{lstcode}[moretexcs={useshorthands,defineshorthand}]
\useshorthands{'}
\defineshorthand{'S}{\Sentence\ignorespaces}
\end{lstcode}
-With this definition any space after \lstinline|'S| will be ignored. It is
-even possible to use the dot as abbrevation for dot and new number of the
-following sentence:
+With this definition, any space after \lstinline|'S| will be ignored. You can
+even use the dot as an abbreviation for a dot and a new sentence number:
\begin{lstcode}[moretexcs={useshorthands,defineshorthand}]
\defineshorthand{'.}{. \Sentence\ignorespaces}
\end{lstcode}
-These abbrevations have been tried and tested. For details regarding
-\Macro{useshorthands} and \Macro{defineshorthands} please consult the manual
-of the package \Package{babel} (see \cite{package:babel}).%
+For details regarding \Macro{useshorthands} and \Macro{defineshorthands},
+please consult the manual of the \Package{babel} package (see
+\cite{package:babel}). You can find an example of their application in
+\autoref{sec:scrjura.example}, \autopageref{sec:scrjura.example}.%
\EndIndexGroup
%
\EndIndexGroup
@@ -529,12 +563,13 @@ of the package \Package{babel} (see \cite{package:babel}).%
\EndIndexGroup
-\section{Cross References}
+\section{Cross-References}
\label{sec:scrjura.ref}
-The conventional mechanism to set cross references using
+The conventional mechanism to set cross-references using
\Macro{label}\IndexCmd{label}\important{\Macro{label}}, \Macro{ref}, and
-\Macro{pageref} does not suffice. \Package{scrjura} provides more commands.
+\Macro{pageref} does not suffice for clauses, paragraphs, and sentences.
+Therefore \Package{scrjura} provides additional commands.
\begin{Declaration}
\Macro{ref}\Parameter{label}%
@@ -544,8 +579,8 @@ The conventional mechanism to set cross references using
\end{Declaration}
The commands \Macro{refL}, \Macro{refS}, and \Macro{refN} give a full
reference to clause, paragraph and sentence. \Macro{refL} is a long text,
-\Macro{refS} a short text and \Macro{refN} an abbreviated, numeric
-form. \Macro{ref} defaults to \Macro{refL}.%
+\Macro{refS} a short text, and \Macro{refN} an abbreviated, numeric form.
+\Macro{ref} defaults to \Macro{refL}.%
\EndIndexGroup
@@ -553,9 +588,9 @@ form. \Macro{ref} defaults to \Macro{refL}.%
\Macro{refClause}\Parameter{label}%
\Macro{refClauseN}\Parameter{label}
\end{Declaration}
-For a cross reference to to a clause without displaying paragraph and
-sentences as well. \Macro{refClause} puts a section symbol (\S) in front of
-the reference, while \Macro{refClauseN} does not.%
+These commands reference a clause without displaying the paragraph or
+sentences. \Macro{refClause} puts a section mark (\S) in front of the
+reference, while \Macro{refClauseN} does not.%
\EndIndexGroup
@@ -565,14 +600,15 @@ the reference, while \Macro{refClauseN} does not.%
\Macro{refParS}\Parameter{label}%
\Macro{refParN}\OParameter{number format}\Parameter{label}
\end{Declaration}
-You can make a cross reference to a paragraph using \Macro{refParL},
-\Macro{refParS} and \Macro{refParN}. The differences between the forms
-correspond to the differences between \DescRef{\LabelBase.cmd.refL},
-\DescRef{\LabelBase.cmd.refN} and \DescRef{\LabelBase.cmd.refS}. A special
-feature is the optional argument of \Macro{refParN}. Usually the numeric
-reference to a paragraph uses a roman number. The optional argument allows to
-set a different \PName{number format}, it may make sense to use arabic
-numbers. \Macro{refPar} defaults to \Macro{refParL}.%
+You can reference just a paragraph with \Macro{refParL}, \Macro{refParS} and
+\Macro{refParN}. The differences between the forms correspond to the
+differences between \DescRef{\LabelBase.cmd.refL},
+\DescRef{\LabelBase.cmd.refN} and \DescRef{\LabelBase.cmd.refS}. A feature
+worth noting is the optional argument of \Macro{refParN}. Usually the numeric
+reference to a paragraph uses a Roman number. You can, however, specify a
+different \PName{number format} in the optional argument. This option
+primarily makes sense to use Arabic numbers. By default, \Macro{refPar} is
+\Macro{refParL}.%
\EndIndexGroup
@@ -582,9 +618,9 @@ numbers. \Macro{refPar} defaults to \Macro{refParL}.%
\Macro{refSentenceS}\Parameter{label}%
\Macro{refSentenceN}\Parameter{label}
\end{Declaration}
-You can make a cross reference to a sentence with \Macro{refSentenceL},
-\Macro{refSentenceS}, or \Macro{refSentenceN}. Again we have a long text form,
-a short text form and a numerical form. \Macro{refSentence} defaults to
+You can reference a sentence with \Macro{refSentenceL}, \Macro{refSentenceS},
+or \Macro{refSentenceN}. Again, there is a long text form, a short text form,
+and a numerical form. By default, \Macro{refSentence} is
\Macro{refSentenceL}.%
\EndIndexGroup
@@ -593,87 +629,88 @@ a short text form and a numerical form. \Macro{refSentence} defaults to
\OptionVName{ref}{value}
\end{Declaration}
The results of \DescRef{\LabelBase.cmd.ref}, \DescRef{\LabelBase.cmd.refPar},
-and \DescRef{\LabelBase.cmd.refSentence} depend on the \PName{value} of option
-\Option{ref}. Defaults are \DescRef{\LabelBase.cmd.refL},
-\DescRef{\LabelBase.cmd.refParL} and
-\DescRef{\LabelBase.cmd.refSentenceL}. For possible values and their meaning
-see \autoref{tab:scrjura.ref}.%
+and \DescRef{\LabelBase.cmd.refSentence} depend on the \PName{value} of the
+\Option{ref} option. The defaults are \DescRef{\LabelBase.cmd.refL},
+\DescRef{\LabelBase.cmd.refParL} and \DescRef{\LabelBase.cmd.refSentenceL}.
+You can find the available values and their meaning in
+\autoref{tab:scrjura.ref}.%
%
\begin{table}
%\begin{desclist}
% \desccaption
\caption[{%
- Possible values for option \Option{ref} to configure the cross reference
+ Available values for the\Option{ref} option to configure the cross-reference
format%
}]{%
- Possible values for option \Option{ref} to configure the cross reference
- format of \DescRef{\LabelBase.cmd.ref}, \DescRef{\LabelBase.cmd.refPar},
- and \DescRef{\LabelBase.cmd.refSentence}%
+ Available values for the \Option{ref} option to configure the
+ cross-reference format of \DescRef{\LabelBase.cmd.ref},
+ \DescRef{\LabelBase.cmd.refPar}, and \DescRef{\LabelBase.cmd.refSentence}%
\label{tab:scrjura.ref}%
}%
\begin{desctabular}
\entry{\PValue{long}}{%
- Combination of \PValue{parlong} and \PValue{sentencelong}.%
- \IndexOption{ref~=\PValue{long}}%
+ A combination of \PValue{parlong} and \PValue{sentencelong}.%
+ \IndexOption{ref~=\textKValue{long}}%
}%
\entry{\PValue{numeric}}{%
- Combination of \PValue{parnumeric} and \PValue{sentencenumeric}.%
- \IndexOption{ref~=\PValue{numeric}}%
+ A combination of \PValue{parnumeric} and \PValue{sentencenumeric}.%
+ \IndexOption{ref~=\textKValue{numeric}}%
}%
\entry{\PValue{clauseonly}, \PValue{onlyclause}, \PValue{ClauseOnly},
\PValue{OnlyClause}}{%
- Combination of \PValue{paroff} and \PValue{sentenceoff}; note that
+ A combination of \PValue{paroff} and \PValue{sentenceoff}. Note that
\DescRef{\LabelBase.cmd.refPar} and \DescRef{\LabelBase.cmd.refSentence}
- have empty results!%
- \IndexOption{ref~=\PValue{long}}%
+ produce empty results!%
+ \IndexOption{ref~=\textKValue{long}}%
}%
\entry{\PValue{parlong}, \PValue{longpar}, \PValue{ParL}}{%
Paragraphs are referenced in long textual form.%
- \IndexOption{ref~=\PValue{parlong}}%
+ \IndexOption{ref~=\textKValue{parlong}}%
}%
\entry{\PValue{parnumeric}, \PValue{numericpar}, \PValue{ParN}}{%
Paragraphs are referenced in simple numerical form.%
- \IndexOption{ref~=\PValue{parnumeric}}%
+ \IndexOption{ref~=\textKValue{parnumeric}}%
}%
\entry{\PValue{paroff}, \PValue{nopar}}{%
- Paragraphs have not reference. Note that \DescRef{\LabelBase.cmd.refPar}
- has an empty result!%
- \IndexOption{ref~=\PValue{paroff}}%
+ Paragraphs have no reference. Note that \DescRef{\LabelBase.cmd.refPar}
+ produces an empty result!%
+ \IndexOption{ref~=\textKValue{paroff}}%
}%
\entry{\PValue{parshort}, \PValue{shortpar}, \PValue{ParS}}{%
Paragraphs are referenced in short textual form.%
- \IndexOption{ref~=\PValue{parshort}}%
+ \IndexOption{ref~=\textKValue{parshort}}%
}%
\entry{\PValue{sentencelong}, \PValue{longsentence}, \PValue{SentenceL}}{%
Sentences are referenced in long textual form.%
- \IndexOption{ref~=\PValue{parlong}}%
+ \IndexOption{ref~=\textKValue{parlong}}%
}%
\entry{\PValue{sentencenumeric}, \PValue{numericsentence},
\PValue{SentenceN}}{%
Sentences are referenced in simple numeric form.%
- \IndexOption{ref~=\PValue{sentencenumeric}}%
+ \IndexOption{ref~=\textKValue{sentencenumeric}}%
}%
\entry{\PValue{sentenceoff}, \PValue{nosentence}}{%
Sentences have no reference. Note that
- \DescRef{\LabelBase.cmd.refSentence} has an empty result!%
- \IndexOption{ref~=\PValue{sentenceoff}}%
+ \DescRef{\LabelBase.cmd.refSentence} produces an empty result!%
+ \IndexOption{ref~=\textKValue{sentenceoff}}%
}%
\entry{\PValue{sentenceshort}, \PValue{shortsentence},
\PValue{SentenceS}}{%
Sentences are referenced in short textual form.%
- \IndexOption{ref~=\PValue{sentenceshort}}%
+ \IndexOption{ref~=\textKValue{sentenceshort}}%
}%
\entry{\PValue{short}}{%
- Combination if \PValue{parshort} and \PValue{sentenceshort}.%
- \IndexOption{ref~=\PValue{value}}%
+ A combination of \PValue{parshort} and \PValue{sentenceshort}.%
+ \IndexOption{ref~=\textKValue{value}}%
}%
\end{desctabular}
\end{table}
\begin{Example}
- Supposed you would like to reference to paragraphs in the form ``paragraph 1
- in clause 1''. As scrjura lacks of a predefined command for this, you have
- to build your own definitions out of what's given:%
+ Suppose you always want to reference paragraphs in the form ``paragraph 1
+ in clause 1''. As there is no predefined command for this, you have
+ to create your own definition from the available options. You can achieve
+ this easily with:%
\begin{lstcode}
\newcommand*{\refParM}[1]{%
paragraph~\refParN[arabic]{#1}
@@ -684,14 +721,14 @@ see \autoref{tab:scrjura.ref}.%
\DescRef{\LabelBase.cmd.refParL}.%
\end{Example}%
-\hyperref[tab:scrjura.refexamples]{Table~\ref*{tab:scrjura.refexamples}}
-provides examples of the output of the fundamental commands, not configured.%
+You can find examples of results of the basic commands in
+\autoref{tab:scrjura.refexamples}.%
%
\begin{table}
\KOMAoptions{captions=topbeside}%
\setcapindent{0pt}%
- \begin{captionbeside}{Example outputs of the \Option{ref}-independent cross
- reference commands}[l]
+ \begin{captionbeside}{Example outputs of the \Option{ref}-independent
+ cross-reference commands}[l]
\begin{tabular}[t]{ll}
\toprule
Command & Example output \\
@@ -720,65 +757,111 @@ provides examples of the output of the fundamental commands, not configured.%
\section{Additional Environments}
\label{sec:scrjura.newenv}
-There are users of \Package{scrjura} who use it to draft neither contracts nor
-commentaries on certain acts of law, but a compilation of,
-e.\,g., different laws, which does not necessarly use the section prefix (\S)
-before the title of each clause. Maybe somebody would like to write
-something like ``Art. XY'' and needed an indpendent counter for each
-contract environment.
+Some users do not use \Package{scrjura} to draft contracts or commentaries on
+individual laws but to examine different types of laws, which may not
+necessarily use the section prefix (\S) before the title of each clause but
+perhaps something like ``Art.'' or ``IAS'', and so forth. An independent
+counter is also required for each of these different clause types.
\begin{Declaration}
\Macro{DeclareNewJuraEnvironment}\Parameter{name}\OParameter{options}%
\Parameter{start commands}\Parameter{end commands}
\end{Declaration}
-This\ChangedAt{v0.9}{\Package{scrjura}} command allows to define new and
-independent environments of the type contract. The argument \PName{name} is
-the name of the new environment, of course. \PName{start commands} are
-commands which will be executed at the beginning of the environment, as if
-they were added directly after \Macro{begin}\Parameter{name}. Correspondingly
-\PName{end commands} will be executed at the end of the environment, as if
-added directly before \Macro{end}\Parameter{name}. Without any \PName{options}
-the new environment behaves similiar to the \DescRef{\LabelBase.env.contract}
-environment, but with its own counters. It is possible to set \PName{options}
-in a comma separated list. Currently the following \PName{options} are
-supported:
-\begin{description}
-\item[\OptionVName{Clause}{instruction}:] Defines on which \PName{instruction}
- inside the environment the command \DescRef{\LabelBase.cmd.Clause} is being
- mapped. The \PName{instruction} expects exactly one argument. To use it
- correctly, a deeper knowledge and understanding of the internal functions of
- \Package{scrjura} is needed. Furthermore the requirements for
- \PName{instruction} may change in future versions. It is recommended not to
- use this option.%
-\item[\OptionVName{SubClause}{instruction}:] See explanation for
- \Option{Clause} above.
-\item[\OptionVName{Sentence}{instruction}:] Defines on which
- \PName{instruction} inside the environment the command
- \DescRef{\LabelBase.cmd.Sentence} is being mapped. The \PName{instruction}
- must not have an argument. Typically it should add one to the counter
- \Counter{sentence}\IndexCounter{sentence} (using
- \Macro{refstepcounter}\IndexCmd{refstepcounter}) and display it
- somehow. Please avoid undesirable spaces.
-\item[\OptionVName{ClauseNumberFormat}{instruction}:] Formats the numbers of
- clauses. Expects exactly one argument, the number of the clause. If the
- \PName{instruction} implements a series of instructions and the number is
- the last argument of a that series, you may directly use the series of
- instructions as \PName{instruction}.
-\end{description}
+You\ChangedAt{v0.9}{\Package{scrjura}} can use this command to define new and
+independent environments for contracts or other legal texts. The argument
+\PName{name} is the name of the new environment, of course. The \PName{start
+commands} are commands which will be executed at the beginning of the
+environment, as if they were added directly after
+\Macro{begin}\Parameter{name}. Correspondingly \PName{end commands} will be
+executed at the end of the environment, as if added directly before
+\Macro{end}\Parameter{name}. Without any \PName{options} the new environment
+behaves like the \DescRef{\LabelBase.env.contract} environment, but with its
+own counters. It is possible to set \PName{options} in a comma-separated list.
+See \autoref{tab:\LabelBase.DeclareNewJuraEnvironment} for the currently
+supported \PName{options}.
+
+\begin{desclist}
+ \desccaption{Options provided by \Macro{DeclareNewJuraEnvironment} for new
+ contract environments\label{tab:\LabelBase.DeclareNewJuraEnvironment}}%
+ {Options of \Macro{DeclareNewJuraEnvironment} (\emph{continued})}%
+ \entry{\OptionVName{Clause}{command}}{%
+ Defines the \PName{command} to which the \DescRef{\LabelBase.cmd.Clause}
+ command is mapped within the environment. This \PName{command}, like the
+ one documented for \DescRef{\LabelBase.env.contract}, expects exactly one
+ argument. To use it correctly requires advanced knowledge of the
+ \Package{scrjura}'s internal functioning. Furthermore, the requirements
+ for the \PName{command} may change in future versions. Therefore it is
+ recommended not to use this option!%
+ }%
+ \entry{\OptionVName{ClauseFont}{commands}}{%
+ \leavevmode\BeginIndex{FontElement}{\PName{Name}.Clause}%
+ \LabelFontElement{\PName{Name}.Clause}%
+ If this option is used, a new
+ \FontElement{\PName{Name}.Clause}\IndexFontElement{\PName{Name}.Clause}
+ element is defined using
+ \DescRef{maincls-experts.cmd.newkomafont}\IndexCmd{newkomafont}, with the
+ \PName{commands} used as its default setting. If the element was
+ previously defined as an alias (see
+ \DescRef{maincls-experts.cmd.aliaskomafont} in
+ \autoref{sec:maincls-experts.experts},
+ \DescPageRef{maincls-experts.cmd.aliaskomafont}), it will become an
+ independent element instead. If it has already been defined as an
+ independent element, \DescRef{\LabelBase.cmd.setkomafont} is used to set
+ the \PName{commands} a new font settings. Please note the limitations for
+ font settings in \autoref{sec:\LabelBase.textmarkup},
+ \DescPageRef{\LabelBase.cmd.setkomafont}.
+ \EndIndex{FontElement}{\PName{Name}.Clause}%
+ }%
+ \entry{\OptionVName{SubClause}{command}}{%
+ Defines the \PName{command} to which the
+ \DescRef{\LabelBase.cmd.SubClause} command is mapped within the
+ environment. This \PName{command}, like the one documented for
+ \DescRef{\LabelBase.env.contract}, expects exactly one argument. To use it
+ correctly requires advanced knowledge of the \Package{scrjura}'s internal
+ functioning. Furthermore, the requirements for the \PName{command} may
+ change in future versions. Therefore it is recommended not to use this
+ option!%
+ }%
+ \entry{\OptionVName{Sentence}{command}}{%
+ Defines the \PName{command} to which the
+ \DescRef{\LabelBase.cmd.Sentence} is mapped within the environment. This
+ \PName{command} must not have an argument. Typically it should add one to
+ the \Counter{sentence}\IndexCounter{sentence} (using
+ \Macro{refstepcounter}\IndexCmd{refstepcounter}) counter and display it
+ appropriately. It is particularly important to avoid adding unwanted
+ spaces.%
+ }%
+ \entry{\OptionVName{ClauseNumberFormat}{command}}{%
+ Formats the numbers of clauses within the environment. The \PName{command}
+ should expect exactly one argument: the number of the clause. If the
+ \PName{command} implements a series of commands and the number is the last
+ argument of a that series, you can directly use the series of commands as
+ \PName{command}.%
+ }
+\end{desclist}
\begin{Example}
- To define the environment we mentioned in the preface of this section,
- for articles, it is sufficient to write:
+ To define the environment for articles we mentioned in the preface of this
+ section, it is sufficient to write:
\begin{lstcode}
- \DeclareNewJuraEnvironment{Artikel}[ClauseNumberFormat=Art.]{}{}
+ \DeclareNewJuraEnvironment{Article}[ClauseNumberFormat=Art.]{}{}
\end{lstcode}
- In case paragraphs have to be separated by space between the
- paragraphs, \Package{scrjura} together with a \KOMAScript{} document class
- allows to write:
+ If we are using a \KOMAScript{} class and want to separate the paragraphs in
+ this environment with space instead of using paragraph indentation, we can
+ use:
\begin{lstcode}
- \DeclareNewJuraEnvironment{Artikel}[ClauseNumberFormat=Art.~]
+ \DeclareNewJuraEnvironment{Article}[ClauseNumberFormat=Art.~]
{\KOMAoptions{parskip}}{}
\end{lstcode}
- In cross references will ``Art.'' be used instead of ``\S'', of course.%
+ In cross-references, ``Art.'' will of course be used instead of ``\S''.%
+
+ The new environment is used like \DescRef{\LabelBase.env.contract}:
+\begin{lstcode}
+ \begin{Article}
+ \Clause
+ Human dignity is inviolable. To respect and protect people is a
+ duty of all state authority.
+ \end{Article}
+\end{lstcode}
\end{Example}%
\EndIndexGroup
@@ -786,19 +869,19 @@ supported:
\section{Support for Different Languages}
\label{sec:scrjura.babel}
-The package \Package{scrjura} has been developed in cooperation with an German
-lawyer. Therefore primarily it has provided the languages \PValue{german},
+The \Package{scrjura} package has been developed in cooperation with a German
+lawyer. Therefore it initially supported only the languages \PValue{german},
\PValue{ngerman}, \PValue{austrian}, and \PValue{naustrian}. Nevertheless, it
has been designed to support common language packages like
-\Package{babel}\important{\Package{babel}}\IndexPackage{babel}. Users can make
-language adjustments simply using \DescRef{scrbase.cmd.providecaptionname}
-(see \autoref{sec:scrbase.languageSupport},
-\DescPageRef{scrbase.cmd.providecaptionname}). But if you have definite
-information about the correct juristic terms and conventions of a language, it
-is recommended to contact the \KOMAScript{} author. This has been happened for
-English and therefore in the meantime \Package{scrjura} also provides terms
-for languages \PValue{english}, \PValue{american}, \PValue{british},
-\PValue{canadian}, \PValue{USenglish}, and \PValue{UKenglish}.
+\Package{babel}\important{\Package{babel}}\IndexPackage{babel}. Users can
+easily make changes by using \DescRef{scrbase.cmd.providecaptionname} (see
+\autoref{sec:scrbase.languageSupport},
+\DescPageRef{scrbase.cmd.providecaptionname}). If you have definitive
+information about the correct legal terms and conventions of a language,
+please contact the \KOMAScript{} author. Support for English has been added in
+this way, and so \Package{scrjura} now also provides terms for the languages
+\PValue{english}, \PValue{american}, \PValue{british}, \PValue{canadian},
+\PValue{USenglish}, and \PValue{UKenglish}.
\begin{Declaration}
\Macro{parname}%
@@ -807,13 +890,12 @@ for languages \PValue{english}, \PValue{american}, \PValue{british},
\Macro{sentenceshortname}
\end{Declaration}
These are the language-dependent terms used by \Package{scrjura}. The meaning
-of the terms and the English defaults are shown in
-\autoref{tab:scrjura.captionnames}. The package itself uses
+of the terms and their English defaults are shown in
+\autoref{tab:scrjura.captionnames}. The package itself defines them by using
\DescRef{scrbase.cmd.providecaptionname} inside
-\Macro{begin}\PParameter{document} to define them. So pre-definitions for the
-same language but before loading \Package{scrjura} will not be changed. If
-you use \Package{scrjura} with a language setting currently not supported, the
-package throws an error.%
+\Macro{begin}\PParameter{document} only if other requirements have not already
+been met. If you use \Package{scrjura} with an unsupported language, the
+package will throw an error.%
%
\begin{table}
\KOMAoptions{captions=topbeside}%
@@ -845,164 +927,163 @@ package throws an error.%
\section{A Detailed Example}
\label{sec:scrjura.example}
-Remember the letter from \autoref{cha:scrlttr2}. A club member has written to
-the board because of the general meeting that is regulated by the club
-statutes. Such club statutes are a kind of contract and you can realise them
-using \Package{scrjura}.\footnote{Please note, the example is still in German
- and has to be translated. Currently we have had not enough manpower to do
- the translation. Nevertheless, the contents of the example does not matter
- but the technical realisation.}
+You may remember the letter from \autoref{cha:scrlttr2}, in which a club
+member wanted to remind the board about an overdue meeting that was prescribed
+by the club's by-laws. Such club by-laws are a kind of contract, and you can
+create them using \Package{scrjura}.
\lstinputcode[{xleftmargin=2em,%
linerange=1-2}]{scrjuraexample.tex}%
We use class \Class{scrartcl}. Because paragraph distance instead of paragraph
-indentation is usual in club statutes we load the class with option
+indentation is usual in club by-laws, we load the class with option
\OptionValueRef{maincls}{parskip}{half} (see \autoref{sec:maincls.parmarkup},
\DescPageRef{maincls.option.parskip}).
\lstinputcode[{xleftmargin=2em,%
linerange=4-4}]{scrjuraexample.tex}%
-The club rules are in German. Therefore package \Package{babel} with option
-\Option{ngerman} is used, too.
+The club rules are in British English. Therefore we load the \Package{babel}
+package with the \Option{british} option too.
\lstinputcode[{xleftmargin=2em,%
linerange={6-7,9-9}}]{scrjuraexample.tex}%
-Default settings for the fonts are made. Additionally package
-\Package{textcomp} is loaded, because it does not only provide a usable Euro
-sign but also an improved section sign (\S).
+We make some default font settings and load the \Package{textcomp} package
+because it provides an improved section mark (\S) and\,---\,something that may
+be useful in other circumstances\,---\,a usable Euro symbol for some fonts.
-\lstinputcode[{moretexcs=SelectInputMappings,xleftmargin=2em,%
- linerange=11-15}]{scrjuraexample.tex}%
-We want to input special characters and umlauts without commands. To do so, we
-let \LaTeX{} detect the input encoding. Alternatively we could use package
-\Package{inputenc}.
+%\lstinputcode[{moretexcs=SelectInputMappings,xleftmargin=2em,%
+% linerange=11-15}]{scrjuraexample.tex}%
+Although it is not relevant for English, if we were writing an another
+language, we would want to input non-ASCII characters directly. To do so, we
+could let \LaTeX{} detect the input encoding with the \Package{selinput} or
+set it with the \Package{inputenc} packages.
\lstinputcode[{xleftmargin=2em,%
- linerange=17-17}]{scrjuraexample.tex}%
-Later in the document we want lists numbered not with arabic numbers but with
-lower letters. We can do this easily with package \Package{enumerate}.
+ linerange=11-11}]{scrjuraexample.tex}%
+Later in the document, we want lists numbered not with Arabic numbers but with
+lower-case letters. We can do this easily with the \Package{enumerate} package.
\lstinputcode[{moretexcs={useshorthands,defineshorthand},%
xleftmargin=2em,%
- linerange=19-27}]{scrjuraexample.tex}%
-Now, it is time for \Package{scrjura}. With option
-\OptionValueRef{\LabelBase}{clausemark}{forceboth} we enforce left an right
-clause marks for the running head. On the other hand we do not want
-\DescRef{maincls.cmd.section} to change the marks for the running
-head. Therefore we use page style \PageStyle{myheadings}. This page style
+ linerange=13-21}]{scrjuraexample.tex}%
+Now it is time for \Package{scrjura}. The
+\OptionValueRef{\LabelBase}{clausemark}{forceboth} option forces clauses to
+create left and right marks for the running head. On the other hand, we do not
+want \DescRef{maincls.cmd.section} to change the marks for the running head.
+Therefore we use the \PageStyle{myheadings} page style. This page style
generally does not provide automatic running heads.
-Later we also want a table of contents with the clauses. This can be achieved
-with option \DescRef{\LabelBase.option.juratotoc}. Doing so we will see, that
-the clause number width is to large for default of the entry into the table of
-contents. With \OptionValueRef{\LabelBase}{juratocnumberwidth}{2.5em} we
-declare a larger reserved width.
+Later, we also want a table of contents with the clauses. This can be achieved
+with the \DescRef{\LabelBase.option.juratotoc} option. Doing so we will see
+that the default width for these numbers is insufficient for the clause
+numbers in the table of contents. With
+\OptionValueRef{\LabelBase}{juratocnumberwidth}{2.5em}, we reserve more space.
-The definition of short hands has already been shown in
-\autoref{sec:scrjura.shorthandexample}. We also use this to make the input
-easier and more readable.
+The definition of shorthands has already been explained in
+\autoref{sec:scrjura.shorthandexample}. In this example we do the same thing
+to simplify the input.
\lstinputcode[{xleftmargin=2em,%
- linerange=29-29}]{scrjuraexample.tex}%
-It is time to begin the document.
+ linerange=23-23}]{scrjuraexample.tex}%
+It is time to begin the actual document.
\lstinputcode[{xleftmargin=2em,%
- linerange=31-35}]{scrjuraexample.tex}%
-Like other documents the statutes have a title. We make it with the usual
-\KOMAScript{} commands from \autoref{sec:maincls.titlepage} (see down from
+ linerange=25-29}]{scrjuraexample.tex}%
+Like other documents, the by-laws have a title. We created it with the usual
+\KOMAScript{} commands (see \autoref{sec:maincls.titlepage}, starting on
\autopageref{sec:maincls.titlepage}).
\lstinputcode[{xleftmargin=2em,%
- linerange=37-37}]{scrjuraexample.tex}%
-As already stated, we want to have a table of contents.
+ linerange=31-31}]{scrjuraexample.tex}%
+As already mentioned, we want to create a table of contents.
\lstinputcode[{xleftmargin=2em,%
- linerange=39-43}]{scrjuraexample.tex}%
-Preambles are not unusual in club statutes. Here we use
-\DescRef{maincls.cmd.addsec} to realise it, because we want to have an entry
-into the table of contents.
+ linerange=33-37}]{scrjuraexample.tex}%
+Preambles are not unusual in club by-laws. Here we use
+\DescRef{maincls.cmd.addsec} to create one because we want it to have an entry
+in the table of contents.
\lstinputcode[{xleftmargin=2em,%
- linerange=45-45}]{scrjuraexample.tex}%
-Here we use a tiny trick. The articles of the club statutes should be numbered
-with uppercase letters instead of arabic numbers. This is the same like the
-numbering of appendix sections of an article with \Class{scrartcl}.
+ linerange=39-39}]{scrjuraexample.tex}%
+Here we use a small trick. The articles of the club by-laws should be numbered
+with upper-case letters instead of Arabic numbers, just as
+the appendix sections of an article using \Class{scrartcl} are.
\lstinputcode[{xleftmargin=2em,%
- linerange=47-49}]{scrjuraexample.tex}%
+ linerange=41-43}]{scrjuraexample.tex}%
We begin the contract with the first article.
\lstinputcode[{xleftmargin=2em,%
- linerange=50-59}]{scrjuraexample.tex}%
+ linerange=44-54}]{scrjuraexample.tex}%
The first clause has a number and a title. We will do the same with all
following clauses.
-The first paragraph of the clause is very usual. Because it is not the only
-paragraph, the output is done with a number before the text. Note that the
-numbering of the first paragraph needs at least two \LaTeX{} runs like you
-will for the table of contents.
+The first paragraph of the clause contains nothing unusual. Because it is not
+the only paragraph, every paragraph will be automatically preceded by a
+paragraph number. Note that the numbering the first paragraph requires at
+least two \LaTeX{} runs. Since this is the case for the table of contents as
+well, this does not create any additional problems.
-In the second paragraph we have two sentences. Here we can see the short hands
-\texttt{'S} and \texttt{'.} in action. The first one does only generate the
-sentence number. The second one does not only print the full stop but also the
+In the second paragraph we have two sentences. Here we can see the shorthands
+\texttt{'S} and \texttt{'.} in action. The first one only generates the
+sentence number. The second one generates not only the full stop but also the
sentence number. With this, both sentences are numbered.
\lstinputcode[{xleftmargin=2em,%
- linerange=60-75}]{scrjuraexample.tex}%
-The second clause: also with several paragraphs with one or more
-sentences. The second paragraph additionally has a numbered list. At the last
-paragraph we used a label, because we want to reference it later.
+ linerange=55-70}]{scrjuraexample.tex}%
+The second clause: again this contains several paragraphs, some of which
+include several sentences. The second paragraph also has a numbered list. In
+the last paragraph, we set a label, because we want to reference it later.
\lstinputcode[{xleftmargin=2em,%
- linerange=77-84}]{scrjuraexample.tex}%
-The third clause has something special: a cross reference. Here we use the
-long form with clause, paragraph and sentence. If we would decide, that
-sentences should not be referenced, we could use option
-\OptionValueRef{\LabelBase}{ref}{nosentence} globally.
+ linerange=72-78}]{scrjuraexample.tex}%
+The third clause contains something special: a cross-reference. Here we use
+the long form with clause, paragraph, and sentence. If we decided later that
+sentences should not be included in the reference, we could use the
+\OptionValueRef{\LabelBase}{ref}{nosentence} option to set this globally.
\lstinputcode[{xleftmargin=2em,%
- linerange=86-87}]{scrjuraexample.tex}%
-Here we have a special kind of clauses. In prior versions of the club statutes
-this was a real clause. But then it has been removed. Nevertheless, the
+ linerange=80-81}]{scrjuraexample.tex}%
+Here we have a special kind of clause. In earlier versions of the club by-laws,
+this was a real clause, but it was later removed. However, the
numbering of the following clauses should not be changed by removing this
one. Therefore the \DescRef{\LabelBase.cmd.Clause} statement has not been
removed but supplemented by option \Option{dummy}. With this, we also can set
-a label despite the clause will not be printed.
+a label even though the clause will not be printed.
\lstinputcode[{xleftmargin=2em,%
- linerange=88-92}]{scrjuraexample.tex}%
-Another article starts. To avoid problems with the paragraph numbering we
+ linerange=82-86}]{scrjuraexample.tex}%
+Another article begins. To avoid problems with the paragraph numbering, we
interrupt the \DescRef{\LabelBase.env.contract} environment.
\lstinputcode[{xleftmargin=2em,%
- linerange=93-93}]{scrjuraexample.tex}%
-The first clause of the next article also has been removed.
+ linerange=87-87}]{scrjuraexample.tex}%
+The first clause of the next article also has been deleted.
\lstinputcode[{xleftmargin=2em,%
- linerange=95-104}]{scrjuraexample.tex}%
-We have a real clause again. We cross reference one of the removed
-clauses and also use a label.
+ linerange=89-98}]{scrjuraexample.tex}%
+Here we have a real clause again. We cross-reference one of the deleted
+clauses and also set a label.
\lstinputcode[{xleftmargin=2em,%
- linerange=107-112}]{scrjuraexample.tex}%
+ linerange=100-104}]{scrjuraexample.tex}%
Once more, this is a special kind of clause. This time we have not removed a
-clause but added one without renumbering of the following clauses. To do so,
+clause but added one without renumbering the following clauses. To do so,
we use \DescRef{\LabelBase.cmd.SubClause}. Therefore the clause number is the
same like the previous one but with an appended ``a''.
\lstinputcode[{xleftmargin=2em,%
- linerange=114-134}]{scrjuraexample.tex}%
+ linerange=106-126}]{scrjuraexample.tex}%
The other clauses of this article are very usual. You already know all the
features used for them.
\lstinputcode[{xleftmargin=2em,%
- linerange=136-150}]{scrjuraexample.tex}%
-More articles with known features are following.
+ linerange=128-141}]{scrjuraexample.tex}%
+There follows another article no special features.
\lstinputcode[{xleftmargin=2em,%
- linerange=152-152}]{scrjuraexample.tex}%
-Then the \LaTeX{} document ends. You can see three pages from the front of the
-document in \autoref{fig:scrjura.example}.%
+ linerange=143-143}]{scrjuraexample.tex}%
+Then the \LaTeX{} document ends. You can see first three pages in
+\autoref{fig:scrjura.example}.%
%
\begin{figure}
\setcapindent{0pt}%
@@ -1014,10 +1095,10 @@ document in \autoref{fig:scrjura.example}.%
height=.49\textheight,keepaspectratio]{scrjuraexample}}\par
\smallskip}
\begin{captionbeside}[{%
- Example: Three pages from the front of the example club statutes of
+ Example: First three pages of the example club by-laws of
\protect\autoref{sec:scrjura.example}%
}]{%
- Three pages from the front of the example club statutes of
+ First three pages of the example club by-laws of
\protect\autoref{sec:scrjura.example}%
}%
[l]
@@ -1031,10 +1112,10 @@ document in \autoref{fig:scrjura.example}.%
\frame{\includegraphics[page=2,width=.482\textwidth]{scrjuraexample}}\par
\smallskip}
\begin{captionbeside}[{%
- Example: Three pages from the front of the example club statutes of
+ Example: First three pages of the example club by-laws of
\protect\autoref{sec:scrjura.example}%
}]{%
- Three pages from the front of the example club statutes of
+ First three pages of the example club by-laws of
\protect\autoref{sec:scrjura.example}%
}%
[l]
@@ -1048,15 +1129,14 @@ document in \autoref{fig:scrjura.example}.%
\section{State of Development}
\label{sec:scrjura.draft}
-Since \KOMAScript~3.24 package \Package{scrjura} shares the version number of
-the classes and other important packages of \KOMAScript. Nevertheless, you
-should note: Neither the cooperation with other packages nor the cooperation
-of the \DescRef{\LabelBase.env.contract} environment with all kind of \LaTeX{}
-environments or document classes has been tested. The main reason for this is
-that the package is very special and the package author does not have any
-requirement to use it. So all changes, all features, all improvement can only
-base on detailed user feedback and only about two and a half users are willing
-to send such feedback.%
+Since \KOMAScript~3.24, the \Package{scrjura} package has shared the version
+number of the classes and other important packages of \KOMAScript.
+Nevertheless, you should note that so far, the interaction of the
+\DescRef{\LabelBase.env.contract} environment with the many different settings
+possible with other \LaTeX{} environments, packages, or classes has not been
+tested. The main reason for this is that \Package{scrjura} is very specialised
+and far beyond the author's ordinary practice. So the author mostly relies on
+detailed user feedback.%
\EndIndexGroup
\endinput
@@ -1068,6 +1148,4 @@ to send such feedback.%
%%% ispell-local-dictionary: "en_GB"
%%% TeX-PDF-mode: t
%%% TeX-master: "guide.tex"
-%%% End:
-
-% LocalWords: reseted
+%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrjuraexample.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrjuraexample.tex
index b9d700eaef5..013d1b60bcf 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrjuraexample.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrjuraexample.tex
@@ -1,19 +1,13 @@
\documentclass[fontsize=12pt,pagesize,parskip=half]
{scrartcl}
-\usepackage[ngerman]{babel}
+\usepackage[british]{babel}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{charter,helvet}
\usepackage{textcomp}
-\usepackage{selinput}
-\SelectInputMappings{
- adieresis={ä},
- germandbls={ß},
-}
-
\usepackage{enumerate}
\usepackage[clausemark=forceboth,
@@ -28,124 +22,121 @@
\begin{document}
-\subject{Satzung}
-\title{VfVmai}
-\subtitle{Verein für Vereinsmaierei mit ai n.e.V.}
+\subject{By-Laws}
+\title{CfCH}
+\subtitle{Club for Club Hoppers}
\date{11.\,11.\,2011}
\maketitle
\tableofcontents
-\addsec{Präambel}
+\addsec{Preamble}
-Die Vereinslandschaft in Deutschland ist vielfältig.
-Doch leider mussten wir feststellen, dass es dabei oft
-am ernsthaften Umgang mit der Ernsthaftigkeit krankt.
+The club landscape in England is diverse. But we have
+unfortunately been forced to conclude that it often
+suffers seriously when dealing with seriousness.
\appendix
-\section{Allgemeines}
+\section{Overview}
\begin{contract}
-\Clause{title={Name, Rechtsform, Sitz des Vereins}}
+\Clause{title={Name, Legal Form, Headquarters}}
-Der Verein führt den Namen »Verein für Vereinsmaierei mit
-ai n.e.V.« und ist in keinem Vereinsregister eingetragen.
+The name of this club shall be the ``Club for Club
+Hoppers'' and is not registered in any club register.
-'S Der Verein ist ein nichtwirtschaftlicher, unnützer
-Verein'. Er hat keinen Sitz und muss daher stehen.
+'S The club is a non-economic, useless club'. It has no
+headquarters because its members heads are in their
+hindquarters.
-Geschäftsjahr ist vom 31.~März bis zum 1.~April.
+The fiscal year is from March 31st through April 1st.
-\Clause{title={Zweck des Vereins}}
+\Clause{title={Purpose of the Club}}
-'S Der Verein ist zwar sinnlos, aber nicht zwecklos'.
-Vielmehr soll er den ernsthaften Umgang mit der
-Ernsthaftigkeit auf eine gesunde Basis stellen.
+'S The club is pointless but not useless'. Rather,
+it should put the serious handling of seriousness on a
+sound footing.
-Zu diesem Zweck kann der Verein
+For this purpose, the club members can
\begin{enumerate}[\qquad a)]
-\item in der Nase bohren,
-\item Nüsse knacken,
-\item am Daumen lutschen.
+\item pick their noses,
+\item crack nuts,
+\item such their thumbs.
\end{enumerate}
-Der Verein ist selbstsüchtig und steht dazu.
+The club is selfish and stands by it.
-Der Verein verfügt über keinerlei Mittel.\label{a:mittel}
+The club has no financial means.\label{a:mittel}
-\Clause{title={Vereinsämter}}
+\Clause{title={Club Officers}}
-Die Vereinsämter sind Ehrenämter.
+The club officers hold honorary positions.
-'S Würde der Verein über Mittel verfügen
-(siehe \ref{a:mittel}), so könnte er einen
-hauptamtlichen Geschäftsführer bestellen'. Ohne
-die notwendigen Mittel ist dies nicht möglich.
+'S If the club had resources (see \ref{a:mittel}), it
+could afford a full-time manager'. Without the necessary
+funds, this is not possible.
-\Clause{title={Vereinsmaier},dummy}
+\Clause{title={Club Hopper},dummy}
\label{p.maier}
\end{contract}
-\section{Mitgliedschaft}
+\section{Membership}
\begin{contract}
-\Clause{title={Mitgliedsarten},dummy}
+\Clause{title={Types of Members},dummy}
-\Clause{title={Erwerb der Mitgliedschaft}}
+\Clause{title={Becoming a Member}}
-Die Mitgliedschaft kann jeder zu einem angemessenen
-Preis von einem der in \refClause{p.maier}
-genannten Vereinsmaier erwerben.\label{a.preis}
+Everyone can purchase a membership from one of the
+associations listed in \refClause{p.maier}.\label{a.preis}
-'S Zum Erwerb der Mitgliedschaft ist ein formloser
-Antrag erforderlich'. Dieser Antrag ist in grüner
-Tinte auf rosa Papier einzureichen.
+'S To become a member, an informal application is
+required'. This application should be submitted in green
+ink on pink paper.
-Die Mitgliedschaft kann nicht abgelehnt werden.
+Membership applications cannot be rejected.
-\SubClause{title={Ergänzung zu vorstehendem
- Paragraphen}}
+\SubClause{title={Amendment to the Previous Clause}}
-'S Mit Abschaffung von \refClause{p.maier} verliert
-\ref{a.preis} seine Umsetzbarkeit'. Mitgliedschaften
-können ersatzweise vererbt werden.
+'S With the repeal of \refClause{p.maier},
+\ref{a.preis} has become impractical'. In its place,
+memberships can be inherited.
-\Clause{title={Ende der Mitgliedschaft}}
+\Clause{title={Termination of Membership}}
-'S Die Mitgliedschaft endet mit dem Leben'. Bei nicht
-lebenden Mitgliedern endet die Mitgliedschaft nicht.
+'S Membership ends with one's life'. For non-living
+members, membership does not end.
-\Clause{title={Mitgliederversammlung}}
+\Clause{title={General Meeting}}
-Zweimal jährlich findet eine Mitgliederversammlung statt.
+A general meeting shall take place twice per year.
-Der Abstand zwischen zwei Mitgliederversammlungen
-beträgt höchstens 6~Monate, 1~Woche und 2~Tage.
+The interval between two general meetings shall be
+no more than 6~months, 1~week, and 2~days.
-Frühestens 6~Monate nach der letzten Mitgliederversammlung
-hat die Einladung zur nächsten Mitgliederversammlung zu
-erfolgen.
+The invitation to the next general meeting shall be sent
+no earlier than 6~months from the previous general
+meeting.
-\SubClause{title={Ergänzung zur Mitgliederversammlung}}
+\SubClause{title={Amendment to the General Meeting}}
-Die Mitgliederversammlung darf frühstens 2~Wochen nach
-letztem Eingang der Einladung abgehalten werden.
+The general meeting may be held at the earliest 2~weeks after
+the invitation is received.
\end{contract}
-\section{Gültigkeit}
+\section{Validity}
\begin{contract}
-\Clause{title={In Kraft treten}}
+\Clause{title={Effective Date}}
-Diese Satzung tritt am 11.\,11.\,2011 um 11:11~Uhr
-in Kraft.
+These articles will enter into force on 11.\,11.\,2011 at
+11:11~am.
-'S Sollten irgendwelche Bestimmungen dieser Satzung im
-Widerspruch zu einander stehen, tritt die Satzung am
-11.\,11.\,2011 um 11:11~Uhr und 11~Sekunden wieder
-außer Kraft'. Der Verein ist in diesem Fall als
-aufgelöst zu betrachten.
+'S If any provision of these by-laws is in conflict with
+any other, the by-laws will be repealed on
+11.\,11.\,2011 at 11:11~am and 11~seconds'. The club is
+considered to be dissolved in this case.
\end{contract}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-notecolumn-example.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-notecolumn-example.tex
index 512e36dab09..164c646e1f0 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-notecolumn-example.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-notecolumn-example.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlayer-notecolumn-example.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer-notecolumn-example.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -47,13 +47,6 @@
%
% ============================================================================
\documentclass{scrartcl}
-\usepackage[ngerman]{babel}
-\usepackage{selinput}
-\SelectInputMappings{
- adieresis={ä},
- germandbls={ß},
-}
-\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{xcolor}
@@ -81,51 +74,48 @@
\begin{document}
-\title{Kommentar zum GüdaVaS}
+\title{Commentary on the SCRACH}
\author{Professor R. O. Tenase}
-\date{11.\,11.\,2011}
+\date{11/11/2011}
\maketitle
\tableofcontents
-\section{Vormerkung}
-Das GüdaVaS ist ohne jeden Zweifel das wichtigste Gesetz, das in
-Spaßmaniern in den letzten eintausend Jahren verabschiedet wurde.
-Die erste Lesung fand bereits am 11.\,11\,1111 im obersten
-spaßmanischen Kongress statt, wurde aber vom damalige Spaßvesier
-abgelehnt. Erst nach Umwandlung der spaßmanischen, aberwitzigen Monarchie
-in eine repräsentative, witzige Monarchie durch W. Itzbold, den
-urkomischen, am 9.\,9.\,1999 war der Weg für dieses Gesetz endlich frei.
+\section{Preamble}
+The SCRACH is without doubt the most important law on the manners of humour
+that has been passed in the last thousand years. The first reading took place
+on 11/11/1111 in the Supreme Manic Fun Congress, but the law was rejected by
+the Vizier of Fun. Only after the ludicrous, Manic Fun monarchy was
+transformed into a representative, witty monarchy by W. Itzbold, on 9/9/1999
+was the way finally clear for this law.
-\section{Analyse}
+\section{Analysis}
\begin{addmargin}[0pt]{.333\textwidth}
\makenote[paragraphs]{%
\protect\begin{contract}
- \protect\Clause{title={Kein Witz ohne Publikum}}
- Ein Witz kann nur dort witzig sein, wo er auf ein Publikum trifft.
+ \protect\Clause{title={No Joke without an Audience}}
+ A joke can only be funny if is has an audience.
\protect\end{contract}
}
- Dies ist eine der zentralsten Aussagen des Gesetzes. Sie ist derart
- elementar, dass es durchaus angebracht ist, sich vor der Weisheit der
- Verfasser zu verbeugen.
+ This is one of the most central statements of the law. It is so fundamental
+ that it is quite appropriate to bow to the wisdom of the authors.
\syncwithnotecolumn[paragraphs]\bigskip
\makenote[paragraphs]{%
\protect\begin{contract}
- \protect\Clause{title={Komik der Kultur}}
- \setcounter{par}{0}Die Komik eines Witzes kann durch das kulturelle
- Umfeld, in dem er erzählt wird, bestimmt sein.
+ \protect\Clause{title={Humor of a Culture}}
+ \setcounter{par}{0}The humour of a joke can be determined by the
+ cultural environment in which it is told.
- Die Komik eines Witzes kann durch das kulturelle Umfeld, in dem er
- spielt, bestimmt sein.
+ The humour of a joke can be determined by the cultural environment in
+ which it acts.
\protect\end{contract}
}
- Die kulturelle Komponente eines Witzes ist tatsächlich nicht zu
- vernachlässigen. Über die politische Korrektheit der Nutzung des kulturellen
- Umfeldes kann zwar trefflich gestritten werden, nichtsdestotrotz ist die
- Treffsicherheit einer solchen Komik im entsprechenden Umfeld frappierend. Auf
- der anderen Seite kann ein vermeintlicher Witz im falschen kulturellen
- Umfeld auch zu einer echten Gefahr für den Witzeerzähler werden.
+ The cultural component of a joke is, in fact, not negligible. Although the
+ political correctness of using the cultural environment can easily be
+ disputed, nonetheless the accuracy of such comedy in the appropriate
+ environment is striking. On the other hand, a supposed joke in the wrong
+ cultural environment can also be a real danger for the joke teller.
\end{addmargin}
\end{document}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-notecolumn.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-notecolumn.tex
index a181dd5780d..47cc29a8aa8 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-notecolumn.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-notecolumn.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlayer-notecolumn.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer-notecolumn.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,233 +46,190 @@
% ============================================================================
\KOMAProvidesFile{scrlayer-notecolumn.tex}
- [$Date: 2014-03-07 09:40:24 +0100 (Fri, 07 Mar 2014) $
+ [$Date: 2018-02-05 01:50:56 -0800 (Mon, 05 Feb 2018) $
KOMA-Script guide (chapter:scrlayer-notecolumn)]
-\translator{Markus Kohm\and Arndt Schubert}
+\translator{Markus Kohm\and Arndt Schubert\and Karl Hagen}
-% Date of the translated German file: 2017-02-08
+% Date of the translated German file: 2018-02-05
\chapter{Note Columns with \Package{scrlayer-notecolumn}}
\labelbase{scrlayer-notecolumn}
+
\BeginIndexGroup
-\BeginIndex{}{note>columns}%
\BeginIndex{Package}{scrlayer-notecolumn}%
-Up to version~3.11b \KOMAScript{} supported note columns only by marginal
-notes that get their contents from \DescRef{maincls.cmd.marginpar} and \DescRef{maincls.cmd.marginline}
-(see \autoref{sec:maincls.marginNotes},
-\DescPageRef{maincls.cmd.marginline}). This kind of note columns has
-several disadvantages:
+Through version~3.11b, \KOMAScript{} supported note columns only in the form
+of marginal notes that get their contents from \DescRef{maincls.cmd.marginpar}
+and \DescRef{maincls.cmd.marginline} (see \autoref{sec:maincls.marginNotes},
+\DescPageRef{maincls.cmd.marginline}). This kind of note column has several
+disadvantages:
\begin{itemize}
-\item Marginal notes can be output only completely on one page. Page
- breaks\textnote{page break} inside marginal notes are not
- possible. Sometimes this results in margin notes located close to the lower
- page margin.
+\item Marginal notes must be set completely on a single page. Page
+ breaks\textnote{page break} inside marginal notes are not possible. This
+ sometimes causes the marginal notes to protrude into the lower margin.
\item Marginal notes near page breaks sometimes float to the next page and
- then in
- case of two-sided layout with alternating marginal notes can be output at
- the wrong margin.\textnote{put it into the correct margin}. This problem can
- be solved by additional packages like
- \Package{mparhack}\IndexPackage{mparhack} or usage of \Macro{marginnote}
- provided by package \Package{marginnote}\IndexPackage{marginnote}.
+ then, in the case of two-sided printing, cause alternate marginal columns to
+ appear in the wrong margin.\textnote{assignment to the correct margin}. This
+ problem can be solved with the additional package
+ \Package{mparhack}\IndexPackage{mparhack} or by using \Macro{marginnote}
+ from the \Package{marginnote}\IndexPackage{marginnote} package (see
+ \cite{package:marginnote}).
\item Marginal notes inside floating environments\textnote{floating
environments} or footnotes\textnote{footnotes} are not possible. This
- problem can be solved using \Macro{marginnote} of package
- \Package{marginnote}\IndexPackage{marginnote}, too.
-\item There is only one marginal note column\textnote{several note columns} or
- at most two, if you work with \Macro{reversemarginpar} and
- \Macro{normalmarginpar}. You should know, that \Macro{reversemarginpar} is
- of less usability on two-sided documents.
+ problem can also be solved with \Macro{marginnote} of the
+ \Package{marginnote}\IndexPackage{marginnote} package.
+\item There is only one marginal note column\textnote{several note columns},
+ or at most two if you use \Macro{reversemarginpar} and
+ \Macro{normalmarginpar}. Note that \Macro{reversemarginpar} is of less
+ utility with two-sided documents.
\end{itemize}
-Usage of \Package{marginnote}\IndexPackage{marginnote} results in one more
-problem. Because the package does not have any collision detection, marginal
-notes that are set near to each other can partially or totally
-overlap. Moreover, usage of \Macro{marginnote} sometimes and depending on the
-used settings can result in changes of the baseline distance of the normal
-text.
-
-Package \Package{scrlayer-notecolumn} should solve all these problems. To do
-so, it uses the basic functionality of
-\Package{scrlayer}\IndexPackage{scrlayer}. Nevertheless, there is a
-disadvantage of using this package:\textnote{Attention!} Notes can be output
-only on pages that use a \Package{scrlayer} based page style. This
-disadvantage may be easily resolved and maybe changed into an advantage using
-\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage}.
+Using \Package{marginnote}\IndexPackage{marginnote} leads to one more problem.
+Because the package does not have any collision detection, marginal notes that
+are set near to each other can partially or totally overlap. Moreover,
+depending on the settings used, \Macro{marginnote} sometimes changes the
+baseline distance of the normal text.
+
+The \Package{scrlayer-notecolumn} package should solve all these problems. To
+do so, it relies on the basic functionality of
+\hyperref[cha:scrlayer]{\Package{scrlayer}}\IndexPackage{scrlayer}%
+\important{\hyperref[cha:scrlayer]{\Package{scrlayer}}}. However, using this
+package has a drawback:\textnote{Attention!} you can only output notes on
+pages that use a page style based on
+\hyperref[cha:scrlayer]{\Package{scrlayer}}. This disadvantage, however, can
+easily be resolved, or even turned into an advantage, with the help of
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}%
+\IndexPackage{scrlayer-scrpage}.
\section{Note about the State of Development}
\seclabel{draft}
-Originally the package has been made as a so called \emph{proof of
+This package was originally developed as a so-called \emph{proof of
concept}\textnote{proof of concept} to demonstrate the potential of
-\Package{scrlayer}. Despite the fact that it currently is in a very early
-state of development, the stability of most parts is less a question of
-\Package{scrlayer-notecolumn} but of \Package{scrlayer}. Nevertheless it is
-assumed that there are still bugs in \Package{scrlayer-notecolumn}. You are
-welcome to report such bugs whenever you find one. Some of the disabilities
-are caused by minimisation of complexity. As an example note columns can break
-to several pages, but there is not a new line break of the paragraphs. \TeX{}
-itself does not provide this.
-
-Because the package is more experimental\textnote{experimental}, the user
-manual belongs to the second part of \iffree{the \KOMAScript{} manual}{this
- book}, recommended for experienced users. If you are a beginner or
-a user on the way to become an expert\textnote{for experts}, some explanations
-could be ambiguous or incomprehensible. \iffree{Please understand that I try
- to minimise the effort in time and work for the manual of an experimental
- package.}
+\hyperref[cha:scrlayer]{\Package{scrlayer}}%
+\important{\hyperref[cha:scrlayer]{\Package{scrlayer}}}. Although it is still
+in its early stages of development, most of its stability is less a question
+of \Package{scrlayer-notecolumn} than of
+\hyperref[cha:scrlayer]{\Package{scrlayer}}. Nevertheless, you can assume that
+there are still bugs in \Package{scrlayer-notecolumn}. Please report such bugs
+whenever you find them. Some of the package's shortcomings are caused by the
+attempt to minimise complexity. For example, although note columns can break
+across several pages, there is no new paragraph break. \TeX{} itself does not
+provide this.
+
+Because the package is rather experimental\textnote{experimental}, its
+instructions are found here in the second part of \iffree{the \KOMAScript{}
+manual}{this book}. Accordingly, it is primarily directed towards experienced
+users. If you are a beginner or a user on the way to become an
+expert\textnote{for experts}, some of the following explanations may be
+unclear or even incomprehensible.
+\iffree{Please understand that I want to keep the effort spent on the manual
+ to something halfway bearable when it comes to experimental packages.}{%
+ However, this should be enough to solve simple tasks with
+ \Package{scrlayer-notecolumn}. At the same time, developers will hopefully
+ find useful stimulus for their own ideas.}
+
+\iffalse% Umbruchoptimierung
+Note also\textnote{Attention!} that the author of \KOMAScript{} does not
+guarantee the further development of this package and offers only limited
+support for it. This is the nature of a package written solely for the
+purposes of demonstration.%
+\fi
\LoadCommonFile{options}% \section{Early or late Selection of Options}
\LoadCommonFile{textmarkup}% \section{Text Markup}
-\section{Declaration of new Note Columns}
+\section{Declaring New Note Columns}
\seclabel{declaration}
-Loading the package already declares a note column named \PValue{marginpar}
-automatically. The name already adumbrates that this note column is placed in
-the area of the normal marginal note column used by \DescRef{maincls.cmd.marginpar} and
-\DescRef{maincls.cmd.marginline}. It even recognises the setting of \Macro{reversemarginpar}
-and \Macro{normalmarginpar} page by page instead of note by note. So these
-switches are irrelevant when the user defines a note but relevant when the
-package outputs the note during \LaTeX's page building. If you want to use
-notes at the left and at the right margin within one page, you should declare
-at least one more note column.
-
-The default settings for every newly declared note column is the same like
-that of the predefined \PValue{marginpar}. But you can easily change them
-during declaration.
-
-You should note\textnote{Attention!} that note columns can be output only on
-pages that use a page style made with package
-\Package{scrlayer}\IndexPackage{scrlayer}. Package
-\Package{scrlayer-notecolumn} automatically loads \Package{scrlayer}, which by
-default provides only page style \PageStyle{empty}\IndexPagestyle{empty}. If
-you need additional page styles, the use of
-\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} is recommended.
+Loading the package automatically declares a note column named
+\PValue{marginpar}. As the name implies, this note column is placed in the
+area of the normal marginal column used by \DescRef{maincls.cmd.marginpar} and
+\DescRef{maincls.cmd.marginline}. The \Macro{reversemarginpar} and
+\Macro{normalmarginpar} settings are also taken into account, but only for all
+the notes on a page instead of note by note. The relevant setting is the one
+that applies at the end of the page, namely during the output of the note
+column. If you want to have notes in both the left and right margin of the
+same page, you should define a second note column.
+
+The default settings for all newly declared note columns are the same as the
+defaults for \PValue{marginpar}. %
+\iftrue% Umbruchoptimierung
+But you can easily change them during their initialisation.%
+\fi
+
+Note\textnote{Attention!} that note columns can be output only on pages that
+use a page style based on the
+\hyperref[cha:scrlayer]{\Package{scrlayer}}\IndexPackage{scrlayer}%
+\important{\hyperref[cha:scrlayer]{\Package{scrlayer}}} package. The
+\Package{scrlayer-notecolumn} package automatically loads
+\hyperref[cha:scrlayer]{\Package{scrlayer}}, which by default provides only
+\PageStyle{empty}\IndexPagestyle{empty} page style. If you need additional
+page styles, \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} is
+recommended.
\begin{Declaration}
\Macro{DeclareNoteColumn}%
- \OParameter{option list}\Parameter{note column name}%
+ \OParameter{option~list}\Parameter{note~column~name}%
\Macro{DeclareNewNoteColumn}%
- \OParameter{option list}\Parameter{note column name}%
+ \OParameter{option~list}\Parameter{note~column~name}%
\Macro{ProvideNoteColumn}%
- \OParameter{option list}\Parameter{note column name}%
+ \OParameter{option~list}\Parameter{note~column~name}%
\Macro{RedeclareNoteColumn}%
- \OParameter{option list}\Parameter{note column name}%
+ \OParameter{option~list}\Parameter{note~column~name}%
\end{Declaration}
-These commands can be used to declare note columns. \Macro{DeclareNoteColumn}
-declares the note column independent of whether or not they already
-exist. \Macro{DeclareNewNoteColumn} throws an error message if \PName{note
- column name} has already been used for another note
-column. \Macro{ProvideNoteColumn} simply does nothing in the same
-case. \Macro{RedeclareNoteColumn} can be used only to declare an already
-existing note column again.
-
-By the way: Already existing notes of a already existing note column are not
-lost if you re-declare it using \Macro{DeclareNoteColumn} or
-\Macro{RedeclareNoteColumn}.
+You can use these commands to create note columns. \Macro{DeclareNoteColumn}
+creates the note column regardless of whether it already exists.
+\Macro{DeclareNewNoteColumn} throws an error if the \PName{note column name}
+has already been used for another note column. \Macro{ProvideNoteColumn}
+simply does nothing in that case. You can use \Macro{RedeclareNoteColumn} only
+to reconfigure an existing note column.
+
+By the way, when reconfiguring existing note columns with
+\Macro{DeclareNoteColumn} or \Macro{RedeclareNoteColumn}, the notes that have
+already been generated for this column are retained.
-\BeginIndexGroup
\BeginIndex{FontElement}{notecolumn.\PName{note column name}}%
\BeginIndex{FontElement}{notecolumn.marginpar}%
-\LabelFontElement{notecolumn.marginpar}%
-Declaring a new note column does also define a new element of which you can
-change the font attributes using \DescRef{\LabelBase.cmd.setkomafont} and
-\DescRef{\LabelBase.cmd.addtokomafont} if such a element does not already
-exist. The name of the new element is \PValue{notecolumn.}\PName{note column
- name}. Because of this the predefined note column \PValue{marginnote} has a
-element \FontElement{notecolumn.marginpar}. The initial setting of the
-element's font can be done using option \Option{font} as part of the
-\PName{option list}.%
-\EndIndexGroup
-
-
-The \PName{option list} is a comma separated list of keys with or without
-values, also known as options. The available options are shown in
-\autoref{tab:scrlayer-notecolumn.note.column.options}. Option\textnote{default:
- option \Option{marginpar}} \Option{marginpar} is set by default. But you can
-overwrite this default with your individual settings.
-
-\begin{table}
- \caption[Options for the declaration of note columns]%
- {%
- Options for the declaration of note columns%
- }%
- \label{tab:scrlayer-notecolumn.note.column.options}%
- \begin{desctabular}
- \entry{\OptionVName{font}{font declaration}}{%
- The initial font attributes to be used for the note column. Everything,
- that is allowed to be set by \DescRef{\LabelBase.cmd.setkomafont} or
- \DescRef{\LabelBase.cmd.addtokomafont} can be used as \PName{font
- declaration} (see \autoref{sec:maincls.textmarkup},
- \DescPageRef{maincls.cmd.setkomafont}). Note that
- \Macro{normalfont}\Macro{normalsize} will be used before. So you don't
- need one of them at your own initialisation.\par%
- Default: \emph{empty}%
- }%
- \entry{\Option{marginpar}}{%
- Sets up \Option{position} and \Option{width} to use the marginal note
- column of \DescRef{maincls.cmd.marginpar}. Note that this option does
- not expect or allow any value.\par%
- Default: \emph{yes}%
- }%
- \entry{\Option{normalmarginpar}}{%
- Sets up \Option{position} and \Option{width} to use the normal marginal
- note column and ignore \Macro{reversemarginpar} and
- \Macro{normalmarginpar}. Note that this option does not expect or allow
- any value.\par%
- Default: \emph{no}%
- }%
- \entry{\OptionVName{position}{offset}}{%
- Sets up the horizontal offset of the note column from the left edge of
- the paper. The \PName{horizontal offset} can be either a \LaTeX{}
- length, a \TeX{} dimension, a \TeX{} skip, a length value, or a
- dimensional expression using \texttt{+}, \texttt{-}, \texttt{*},
- \texttt{/} and parenthesis (see \cite[section~3.5]{manual:eTeX} for more
- information about dimensional expressions). The value will be calculated
- at usage time not at definition time.\par%
- Default: \emph{by option \Option{marginpar}}%
- }%
- \entry{\Option{reversemarginpar}}{%
- Sets up \Option{position} and \Option{width} to use the reverse marginal
- note column and ignore \Macro{reversemarginpar} and
- \Macro{normalmarginpar}. Note that this option does not expect or allow
- any value.\par%
- Default: \emph{no}%
- }%
- \entry{\OptionVName{width}{length}}{%
- Sets up the horizontal size of the note column. You can use the same
- values for \PName{size} like for \PName{offset} of option
- \Option{position}.\par%
- Default: \emph{by option \Option{marginpar}}%
- }%
- \end{desctabular}
-\end{table}
-
-Because note columns are implemented using \Package{scrlayer}, each note
-column also defines a layer\Index{layer}. The name\textnote{layer's name} of
-the layer is the same as the name of the element,
+Declaring a new note column always defines a new element for changing its font
+attributes with \DescRef{\LabelBase.cmd.setkomafont} and
+\DescRef{\LabelBase.cmd.addtokomafont}, if such an element does not yet exist.
+The name of the element is \PValue{notecolumn.}\PName{note column name}. For
+this reason, the default note column \PValue{marginnote} has the
+element\textnote{element name} \FontElement{notecolumn.marginpar}. You can
+directly specify the initial setting of the element's font when declaring a
+note column by using the \Option{font} option within the \PName{option list}.%
+\EndIndex{FontElement}{notecolumn.marginpar}%
+\EndIndex{FontElement}{notecolumn.\PName{note column name}}%
+
+The \PName{option list} is a comma-separated list of keys with or without
+values, also known as options. The available options are listed in
+\autoref{tab:scrlayer-notecolumn.note.column.options},
+\autopageref{tab:scrlayer-notecolumn.note.column.options}.
+The\textnote{default: option \Option{marginpar}} \Option{marginpar} option is
+set by default, but you can overwrite this default with your individual
+settings.
+
+Because note columns are implemented using \Package{scrlayer}, a
+layer\Index{layer} is created for each note column. The layer
+name\textnote{layer name} is the same as the name of the element,
\PValue{notecolumn.}\PName{note column name}. For more information about
-layers see \autoref{sec:scrlayer.layers}, from
+layers see \autoref{sec:scrlayer.layers}, starting on
\autopageref{sec:scrlayer.layers}.
%
\begin{Example}
- Assuming, you are a German professor of weird rights and like to write a
- paper about the new ``Gesetz über die ausgelassene Verbreitung allgemeiner
- Späße e'', GüdaVaS. The main focus of the work should consist of comments to
- each section. So you use a two-columned layout. The comments would be the
- main text in the main column. The sections should be placed in a smaller
- note column on the right side of the main column using a smaller
- font\iffree{ and a different colour}{}.
+ Suppose you are a professor of comedy law and want to write a treatise on
+ the new ``Statute Concerning the Riotous Airing of Common Humour'', SCRACH
+ for short. The better part of the work will consist of commentary on
+ individual paragraphs of the statute. You decide on a two-column layout,
+ with the comments in the main column and the paragraphs placed in a smaller
+ note column on the right of the main column using a font that is
+ smaller\iffree{ and in a different colour}{}.
\begin{lstcode}
\documentclass{scrartcl}
- \usepackage[ngerman]{babel}
- \usepackage{selinput}
- \SelectInputMappings{
- adieresis={ä},
- germandbls={ß},
- }
- \usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{xcolor}
@@ -300,168 +257,232 @@ layers see \autoref{sec:scrlayer.layers}, from
\color{blue}
]{paragraphs}
\end{lstcode}
- The paper should be a single-sided article. The German language (new
- spelling) is selected with package \Package{babel}\IndexPackage{babel}. The
- input encoding is selected and detected with package
- \Package{selinput}\IndexPackage{selinput} automatically. The font is Latin
- Modern in 8-bit coding.\iffree{ The colour selection uses package
- \Package{xcolor}\IndexPackage{xcolor}.}{}
-
- For usage of package \Package{scrjura}\IndexPackage{scrjura} to typeset laws
- and contracts see \iffree{the German manual of that
- package}{\autoref{cha:scrjura}}.
-
- Next package \Package{scrlayer-notecolumn}\textnote{note columns with
- \Package{scrlayer-notecolumn}} is loaded. The required width of the note
- column is calculated within
- \DescRef{typearea-experts.cmd.AfterCalculatingTypearea} after package
- \Package{typearea}'s each new calculation of the typing area. It should be
- one third of the typing area minus the distance between the main text and
- the note column. %
-
- With all this information we define the new note column. For
- the positions we simply use a dimension expression. Doing so, we have to
- note that \Length{oddsidemargin} is not the total left margin but for
- historical reasons the left margin minus 1\Unit{inch}. So we have to add
- this value.
-
- That is all of the declaration. But we have to note that currently the note
- column would be output inside the typing area. This means that the note
- column would overwrite the text.
+ The treatise should be a one-sided article. The font is Latin Modern, and
+ the colour selection uses the \Package{xcolor}\IndexPackage{xcolor} package.
+
+ For formatting legal texts\textnote{legal texts with
+ \hyperref[cha:scrjura]{\Package{scrjura}}} with the
+ \hyperref[cha:scrjura]{\Package{scrjura}}\IndexPackage{scrjura} package, see
+ \autoref{cha:scrjura}.
+
+ Since this document uses a page style\textnote{page style with
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} with a
+ page number, the
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ \IndexPackage{scrlayer-scrpage} package is loaded. Thus, note columns can be
+ output on all pages.
+
+ Next, the \Package{scrlayer-notecolumn}\textnote{note columns with
+ \Package{scrlayer-notecolumn}} package is loaded. The required width of the
+ note column is calculated with
+ \DescRef{typearea-experts.cmd.AfterCalculatingTypearea}%
+ \IndexPackage{typearea}\IndexCmd{AfterCalculatingTypearea} after any
+ recalculation\textnote{type area with
+ \hyperref[cha:typearea]{\Package{typearea}}}%
+ \IndexPackage{typearea} of the type area. It should be one third of the type
+ area minus the distance between the main text and the note column. %
+
+ With this information, we define the new note column. For the positions, we
+ use a simple dimension expression. Note that \Length{oddsidemargin} is not
+ the total left margin but for historical reasons the left margin minus
+ 1\Unit{inch}. So we have to add this value.
+
+ This concludes the definition. Note that the note column would currently be
+ placed inside the type area. This means that the note column would overwrite
+ the text.
\begin{lstcode}
\begin{document}
- \title{Kommentar zum GüdaVaS}
+ \title{Commentary on the SCRACH}
\author{Professor R. O. Tenase}
- \date{11.\,11.~2011}
+ \date{11/11/2011}
\maketitle
\tableofcontents
- \section{Vormerkung}
- Das GüdaVaS ist ohne jeden Zweifel das wichtigste
- Gesetz, das in Spaßmanien in den letzten eintausend
- Jahren verabschiedet wurde. Die erste Lesung fand
- bereits am 11.\,11.~1111 im obersten spaßmanischen
- Kongress statt, wurde aber vom damaligen Spaßvesier
- abgelehnt. Erst nach Umwandlung der spaßmanischen,
- aberwitzigen Monarchie in eine repräsentative,
- witzige Monarchie durch W. Itzbold,
- den Urkomischen, am 9.\,9.~1999 war der Weg für
- dieses Gesetz endlich frei.
+ \section{Preamble}
+ The SCRACH is without doubt the most important law
+ on the manners of humour that has been passed in
+ the last thousand years. The first reading took
+ place on 11/11/1111 in the Supreme Manic Fun
+ Congress, but the law was rejected by the Vizier
+ of Fun. Only after the ludicrous, Manic Fun
+ monarchy was transformed into a representative,
+ witty monarchy by W. Itzbold, on 9/9/1999 was
+ the way finally clear for this law.
\end{lstcode}
- Because the text area has not been reduced\textnote{Attention!}, the
- preamble is output with the whole width of the typing area. To test this,
- you can temporarily add:
+ Because\textnote{Attention!} the text area was not reduced, the preamble is
+ output extending over the whole width of the type area. To test this, you
+ can temporarily add:
\begin{lstcode}
\end{document}
\end{lstcode}
\end{Example}
%
-Until now, the example does not give any answer to the question, how the text
-of the comments will be printed with a smaller width. You will find this in
-the continuation of the example below.%
+In the example, the question of how the text for the commentary can be set in
+a narrower column remains unresolved. You will discover how to do this by
+continuing the example below.%
+%
+%\begin{table}% Umbruchoptimierung: Tabelle hinter das Beispiel verschoben
+\begin{desclist}
+ \desccaption{%
+% \caption[Available settings for declaring note columns]{%
+ Available settings for declaring note columns%
+% }%
+ \label{tab:scrlayer-notecolumn.note.column.options}%
+ }{%
+ Available settings for declaring note columns
+ (\emph{continued})%
+ }%
+% \begin{desctabular}
+ \entry{\OptionVName{font}{font attribute}}{%
+ The font attributes of the note column set with
+ \DescRef{\LabelBase.cmd.setkomafont}. For possible values, refer to
+ \autoref{sec:maincls.textmarkup},
+ \DescPageRef{maincls.cmd.setkomafont}.\par%
+ Default: \emph{empty}%
+ }%
+ \entry{\Option{marginpar}}{%
+ Sets \Option{position} and \Option{width} to correspond to the marginal
+ note column of \DescRef{maincls.cmd.marginpar}. Switching between
+ \Macro{reversemarginpar}\IndexCmd{reversemarginpar} and
+ \Macro{normalmarginpar}\IndexCmd{normalmarginpar} is only considered at
+ the end of the page when the note column is output. Note that this
+ option does not expect or allow any value.\par%
+ Default: \emph{yes}%
+ }%
+ \entry{\Option{normalmarginpar}}{%
+ Sets \Option{position} and \Option{width} to use the normal marginal
+ note column and ignore \Macro{reversemarginpar} and
+ \Macro{normalmarginpar}. Note that this option does not expect or allow
+ a value.\par%
+ Default: \emph{no}%
+ }%
+ \entry{\OptionVName{position}{offset}}{%
+ Sets the horizontal offset of the note column from the left edge of the
+ paper. The \PName{offset} can be a complex expression as long as it is
+ fully expandable and expands to a length or a dimensional expression at
+ the time the note column is output. See \cite[section~3.5]{manual:eTeX}
+ for more information about dimensional expressions.\par%
+ Default: \emph{through the \Option{marginpar} option}%
+ }%
+ \entry{\Option{reversemarginpar}}{%
+ Sets \Option{position} and \Option{width} to use the reverse marginal
+ note column of \DescRef{maincls.cmd.marginpar} with the
+ \Macro{reversemarginpar} setting. Note that this option does not expect
+ or allow a value.\par%
+ Default: \emph{no}%
+ }%
+ \entry{\OptionVName{width}{length}}{%
+ Sets the width of the note column. The \PName{length} can be a complex
+ expression as long as it is fully expandable and expands to a length or
+ a dimensional expression at the time the note column is output. See
+ \cite[section~3.5]{manual:eTeX} for more information about dimensional
+ expressions.\par%
+ Default: \emph{through the \Option{marginpar} option}%
+ }%
+% \end{desctabular}
+%\end{table}
+\end{desclist}
\EndIndexGroup
\section{Making a Note}
\seclabel{makenote}
-After having declared a note column, we can make notes for this column. But
-these notes will not be output immediately. Instead of this, they are written
-into a helper file with extension ``\File{.slnc}''. If you want to know the
-exactly workout: First they are written to the \File{aux}-file and while
-reading the \File{aux}-file inside of \Macro{end}\PParameter{document} they
-will be copied to the \File{slnc}-file. Thereby setting of
-\Macro{nofiles}\IndexCmd{nofiles} will be respected. At the next \LaTeX{} run,
-the helper file will be read step by step depending on the progress of the
-document and at the end of the page the note will be output.
-
-But you should note\textnote{Attention!} that note columns are output only in
-pages with a page style of package
-\Package{scrlayer}\IndexPackage{scrlayer}. This package will be loaded by
-\Package{scrlayer-notecolumn} automatically and by default provides only one
-page style, \PageStyle{empty}\IndexPagestyle{empty}. Usage of additional
-package \Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} is
-recommended, if you need more page styles.
+After you declare a note column, you can create notes for this column. But
+these notes are not be output immediately. Initially, they are written to an
+auxiliary file with extension ``\File{.slnc}''. Specifically, they are first
+written to the \File{aux}-file and, when the \File{aux}-file is read inside
+\Macro{end}\PParameter{document}, they are copied to the \File{slnc}-file. If
+necessary, the \Macro{nofiles}\IndexCmd{nofiles} setting is also taken into
+account. At the next \LaTeX{} run, this auxiliary file will be read piece by
+piece, according to the progress of the document, and at the end of the page
+the notes for that page will be output.
+
+Note\textnote{Attention!}, however, that note columns are output only on pages
+whose page style is based on the \Package{scrlayer}\IndexPackage{scrlayer}
+package. This package is loaded automatically by \Package{scrlayer-notecolumn}
+and by default provides only the \PageStyle{empty}\IndexPagestyle{empty} page
+style. If you need additional page styles, the
+\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} package is
+recommended.
\begin{Declaration}
- \Macro{makenote}\OParameter{note column name}\Parameter{note}\\
- \Macro{makenote*}\OParameter{note column name}\Parameter{note}\\
+ \Macro{makenote}\OParameter{note-column name}\Parameter{note}\\
+ \Macro{makenote*}\OParameter{note-column name}\Parameter{note}\\
\end{Declaration}
-This command may be used to make a new \PName{note}. The current vertical
-position is used as the vertical position of the start of the
-\PName{note}. The horizontal position depends only on the defined position of
-the note column. To work correct, the package needs
+You can use this command to make a new \PName{note}. The current vertical
+position is used as the vertical position for the start of the \PName{note}.
+The horizontal position for the note results from the defined position of the
+note column. To work correctly, the package relies on
\Macro{pdfsavepos}\IndexCmd{pdfsavepos},
\Macro{pdflastypos}\IndexCmd{pdflastypos}, and
-\Macro{pdfpageheight}\IndexLength{pdfpageheight}. Without these primitives
-\Package{scrlayer-notecolumn} cannot be used. The primitives should act
-exactly as they would using PDF\TeX.
+\Macro{pdfpageheight}\IndexLength{pdfpageheight} or their equivalent in newer
+Lua\TeX{} versions. Without these commands, \Package{scrlayer-notecolumn} will
+not work. The primitives should act exactly as they would using pdf\TeX.
-However, if the package recognises a collision\textnote{collision avoidance}
-with the output of a former \PName{note}, then the new \PName{note} will be
-delayed until the end of the former \PName{note}. If the \PName{note} does not
-fit into the page\textnote{page break}\Index{page>break}, it will be moved at
-whole or only at part to the next page.
+However, if the package detects a collision\textnote{collision avoidance} with
+a previous \PName{note} in the same note column, the new \PName{note} is moved
+below that earlier \PName{note}. If the \PName{note} does not fit on the
+page\textnote{page break}\Index{page>break}, it will be moved completely or
+partially to the next page.
The optional argument \PName{note column name} determines which note column
-should be used for the \PName{note}. The predefined note column
-\PValue{marginpar} is used, if the optional argument is omitted.%
+should be used for the \PName{note}. If the optional argument is omitted, the
+default note column \PValue{marginpar} is used.%
\begin{Example}
- Let's add a commented section into the example of the previous section. The
- section itself is put into the note column:
+ Let's add a commented paragraph to the example of the previous section. The
+ paragraph itself should be placed in the newly defined note column:
\begin{lstcode}
- \section{Analyse}
+ \section{Analysis}
\begin{addmargin}[0pt]{.333\textwidth}
\makenote[paragraphs]{%
\protect\begin{contract}
\protect\Clause{%
- title={Kein Witz ohne Publikum}%
+ title={No Joke without an Audience}%
}
- Ein Witz kann nur dort witzig sein, wo er
- auf ein Publikum trifft.
+ A joke can only be funny if is has an
+ audience.
\protect\end{contract}%
}
- Dies ist eine der zentralsten Aussagen des
- Gesetzes. Sie ist derart elementar, dass es
- durchaus angebracht ist, sich vor der Weisheit
- der Verfasser zu verbeugen.
+ This is one of the most central statements of
+ the law. It is so fundamental that it is quite
+ appropriate to bow to the wisdom of the authors.
\end{lstcode}
- Environment
- \DescRef{maincls.env.addmargin}\IndexEnv{addmargin}\textnote{column
- width by \DescRef{maincls.env.addmargin}}, which is described in
- \autoref{sec:maincls.lists}, \DescPageRef{maincls.env.addmargin}, is
- used to reduce the width of the main text by the width of the section
- column.
-
- Here you can see one of the few problems of using
- \Macro{makenote}. Because the mandatory argument will be written into a
- helper file, commands\textnote{fragile commands} inside this argument
- unfortunately can \emph{break}. To avoid this, it is recommended to use
- \Macro{protect} in front of all commands that should not expand while
- writing the helper file. Otherwise using a command inside this argument
- could result in an error message.
-
- In principle you could finish this example already with:
+ The \DescRef{maincls.env.addmargin}\IndexEnv{addmargin}%
+ \textnote{column width with \DescRef{maincls.env.addmargin}} environment,
+ which is described in \autoref{sec:maincls.lists},
+ \DescPageRef{maincls.env.addmargin}, is used to reduce the width of the main
+ text by the width of the column for the paragraphs.
+
+ Here you can see one of the few problems of using \Macro{makenote}. Because
+ the mandatory argument is written to an auxiliary file,
+ commands\textnote{fragile commands} inside this argument can, unfortunately,
+ \emph{break}. To avoid this, you should use \Macro{protect} in front of all
+ commands that should not expand when written to the auxiliary file.
+ Otherwise, using a command inside this argument could result in error
+ messages.
+
+ In principle you could now finish this example with
\begin{lstcode}
\end{addmargin}
\end{document}
\end{lstcode}
- to see a first result.
+ to see a preliminary result.
\end{Example}
-If you'll test this example, you will see that the \PName{paragraphs} column
-is longer than the comment. If you would\textnote{Attention!} add one more
-paragraph with one more section and comment, you may have the problem, that
-the new command will be put immediately after the comment above and not after
-the section. So the new section would move away from the corresponding
-comment. Next we will get a solution of this problem.
-
-The\ChangedAt{v0.1.2583}{\Package{scrlayer-notecolumn}} problem with breaking
-commands, that has been mentioned in the example above, does not occur with
-the star variant \Macro{makenote*}. Is uses \Macro{detokenize} to avoid
-expansion of commands. But this means also that you should not use commands,
-which change their definition inside the document, in the \PName{note}.%
+If you test this example, you will see that the column for the legal text is
+longer than that of the commentary. If\textnote{Attention!} you add another
+section with another paragraph, you may encounter the problem that the
+commentary will not continue below the legal text but immediately after the
+previous comment. Next you will find a solution to this problem.
+
+The\ChangedAt{v0.1.2583}{\Package{scrlayer-notecolumn}} problem with fragile
+commands mentioned in the example above does not occur with the starred
+variant\important{\Macro{makenote*}}. It uses \Macro{detokenize} to prevent
+the expansion of commands. But this also means that you should not use
+commands in the \PName{note} that change their definition within the
+document.%
\EndIndexGroup
@@ -469,105 +490,102 @@ which change their definition inside the document, in the \PName{note}.%
\Macro{syncwithnotecolumn}\OParameter{note column name}
\end{Declaration}
This command adds a
-synchronisation\textnote{synchronisation}\Index{synchronisation} point into
-the note column and into the main text of the document. Whenever a
-synchronisation point is found while output of a note column or the main text,
-a mark will be generated that consists of the current page and the current
-vertical position.
-
-Together with the generation of synchronisation points it is recognised
-whether a mark has been set into the note column or the main text while the
-previous \LaTeX{} run. If so, the values will be compared. If the mark of the
-note column is lower at the current page or on a later page, the main text
-will be moved down to the position of the mark.
-
-It is recommended to use synchronisation points\textnote{Note!} not inside
-paragraphs of the main text but only between paragraphs. If you use
+synchronisation\textnote{synchronisation}\Index{synchronisation} point in a
+note column and in the main text of the document. Whenever a synchronisation
+point is reached during the output of a note column or the main text, a mark
+will be generated that consists of the current page and the current vertical
+position.
+
+In parallel with the generation of synchronisation points,
+\Package{scrlayer-notecolumn} determines whether a mark has been set in the
+note column or the main text during the previous \LaTeX{} run. If so, it
+compares their values. If the mark of the note column is lower on the current
+page or on a later page, the main text will be moved down to the position of
+the mark.
+
+As a rule,\textnote{Hint!} you should not place synchronisation points within
+paragraphs of the main text but only between them. If you nonetheless use
\Macro{syncwithnotecolumn} inside a paragraph, the synchronisation point will
be delayed until the current line has been output. This behaviour is similar
-to the usage of, e.\,g., \Macro{vspace}\IndexCmd{vspace}.
-
-Because recognition of synchronisation points can be done first at the next
-\LaTeX{} run,\textnote{several \LaTeX{} runs}, the mechanism needs at least
-three \LaTeX{} runs. Because of the new synchronisation later synchronisation
-points may be moved. This would result in the need of additional \LaTeX{}
-runs. You should have a look at the message: ``\LaTeX{} Warning: Label(s) may
-have changed. Rerun to get cross-references right.''to find out whether or not
-additional \LaTeX{} runs are needed.
-
-If you do not use the optional argument, the predefined note column
-\PValue{marginpar} will be used. Please note, an empty optional argument is
-not the same as omitting the optional argument!
-
-You must not use\textnote{Attention!} \Macro{syncwithnotecolumn} inside a note
-itself, this means inside the mandatory Argument of
+to that of, e.\,g., \Macro{vspace}\IndexCmd{vspace} in this respect.
+
+Because synchronisation points are not recognized until the next \LaTeX{}
+run\textnote{several \LaTeX{} runs}, this mechanism requires at least three
+\LaTeX{} runs. Any new synchronisation may also result in shifts of later
+synchronisation points, which in turn will require additional \LaTeX{} runs.
+Such shifts are usually indicated by the message: ``\LaTeX{} Warning: Label(s)
+may have changed. Rerun to get cross-references right.'' But reports about
+undefined labels may also indicate the need for another \LaTeX{} run.
+
+If you omit the optional argument, the default note column \PValue{marginpar}
+will be used. Note\textnote{Attention!} that an empty optional argument is not
+the same as omitting the optional argument!
+
+You cannot use\textnote{Attention!} \Macro{syncwithnotecolumn} inside a note
+itself, that is, inside the mandatory argument of
\Macro{makenote}\IndexCmd{makenote}! Currently the package cannot recognise
-such a mistake and would result in synchronisation point movement at each
-\LaTeX{} run. So the process will never terminate. So synchronise two or more
-note columns, you have to synchronise each of them with the main text. The
-recommended command for this will be described next.%
+such a mistake, and it causes new shifts of the synchronisation point with
+each \LaTeX{} run, so the process will never terminate. To synchronise two or
+more note columns, you have to synchronise each of them with the main text.
+The recommended command for this is described below.%
%
\begin{Example}
- Let's extend the example above, now by adding a synchronisation point
- and one more section with one more comment:
+ Let's extend the example above by first adding a synchronisation point
+ and then another paragraph with a comment:
\begin{lstcode}
\syncwithnotecolumn[paragraphs]\bigskip
\makenote[paragraphs]{%
\protect\begin{contract}
- \protect\Clause{title={Komik der Kultur}}
+ \protect\Clause{title={Humor of a Culture}}
\setcounter{par}{0}%
- Die Komik eines Witzes kann durch das
- kulturelle Umfeld, in dem er erzählt wird,
- bestimmt sein.
+ The humour of a joke can be determined by the
+ cultural environment in which it is told.
- Die Komik eines Witzes kann durch das
- kulturelle Umfeld, in dem er spielt,
- bestimmt sein.
+ The humour of a joke can be determined by the
+ cultural environment in which it acts.
\protect\end{contract}
}
- Die kulturelle Komponente eines Witzes ist
- tatsächlich nicht zu vernachlässigen. Über die
- politische Korrektheit der Nutzung des
- kulturellen Umfeldes kann zwar trefflich
- gestritten werden, nichtsdestotrotz ist die
- Treffsicherheit einer solchen Komik im
- entsprechenden Umfeld frappierend. Auf der
- anderen Seite kann ein vermeintlicher Witz im
- falschen kulturellen Umfeld auch zu einer
- echten Gefahr für den Witzeerzähler werden.
+ The cultural component of a joke is, in fact, not
+ negligible. Although the political correctness of
+ using the cultural environment can easily be
+ disputed, nonetheless the accuracy of such comedy
+ in the appropriate environment is striking. On
+ the other hand, a supposed joke in the wrong
+ cultural environment can also be a real danger
+ for the joke teller.
\end{lstcode}
- Beside the synchronisation point a vertical distance is added by
- \Macro{bigskip} to better separate the section and the corresponding
- comments.
-
- Again\textnote{Attention}, one more potential problem is shown. Because the
- note columns uses boxes, that are build and split, counters\textnote{counter
- in note column} inside note columns can sometimes jitter. In the example
- the first paragraph would be numbered 2 instead of 1. This can easily be
- fixed by a courageous reset of the counter.
-
- Now, the example is almost finished. You just have to finish the
- environments:
+ In addition to the synchronisation point, a vertical skip has been added
+ with \Macro{bigskip} to better distinguish each paragraph and the
+ corresponding comments.
+
+ Further\textnote{Attention}, this example illustrates another potential
+ problem. Because the note columns uses boxes that are assembled and
+ disassembled, counters\textnote{counter in note column} inside note columns
+ can sometimes jitter. In the example, therefore, the first paragraph would
+ be numbered 2 instead of 1. This, however, can easily be fixed by a direct
+ reset of the corresponding counter.
+
+ The example is almost complete. You just have to close the environments:
\begin{lstcode}
\end{addmargin}
\end{document}
\end{lstcode}
- In fact, all other section of the law should also be commented. But let us
- focus on the main purpose.
+ In reality, of course, all the remaining section of the law should also be
+ commented. But let us focus on the main purpose.
\end{Example}
-But stop! What, if the section in the \PName{paragraphs}
-note column wouldn't fit to the last page? Would it be output on the next
-pages? We will answer this question in the next paragraph.%
+But stop! What if, in this example, the \PName{paragraphs} would no longer fit
+on the page? Would it be printed on the next page? We will answer this
+question in the next section.%
\EndIndexGroup
\begin{Declaration}
\Macro{syncwithnotecolumns}\OParameter{list of note column names}
\end{Declaration}
-This command will synchronise the main text with all note columns of the
-comma-separated \PName{list of note column names}. To do so, the main text
-will be synchronised with the note column, that have the mark closest to the
-end of the document. As a side effect the note columns will be synchronised
+This command synchronises the main text with all note columns of the
+comma-separated \PName{list of note column names}. The main text
+will be synchronised with the note column whose mark is closest to the
+end of the document. As a side effect, the note columns will be synchronised
with each other.
If the optional argument is omitted or empty (or begins with \Macro{relax}),
@@ -575,93 +593,97 @@ synchronisation will be done with all currently declared note columns.%
\EndIndexGroup
-\section{Force Output of Note Columns}
+\section{Forced Output of Note Columns}
\seclabel{clearnotes}
-Sometimes it is necessary to have not only the normal note column output but
-to be able to output all notes that haven't been output already. An example
-for this effort could be that large notes result in moving lots of notes to
-new pages. A good occasion to force the output\textnote{force output} could be
-the end of a chapter or the end of the document.
+In addition to the normal output of note columns described in the previous
+section, you may sometimes need to output all collected notes that have
+not yet been output. This is especially useful when large notes cause more and
+more notes to be moved down to new pages. A good time to force the
+output\textnote{force output} is, for example, the end of a chapter or the end
+of the document.
\begin{Declaration}
\Macro{clearnotecolumn}\OParameter{note column name}
\end{Declaration}
-This command can be used to force the output of all notes\textnote{delayed
- notes} of a selected note column that haven't been output until the end of
-the current page, but has been made in this page or previous pages. To force
-the output empty pages will be generated. During the output of the delayed
-notes of the selected note column, notes of other note columns are also output,
-but only as long as there are still delayed notes of the selected note column.
-
-During the output of the delayed notes, notes may be output by mistake that
-have been placed to one of the inserted empty pages in the previous \LaTeX{}
-run. This will be solved automatically by one of the next \LaTeX{}
-runs. You can realise such movement of notes by the message: ``\LaTeX{}
-Warning: Label(s) may have changed. Rerun to get cross-references right.''
-
-The note column related to the output, is given by the optional
-argument, \PName{note column name}. If this argument is omitted, the notes of
-the predefined note column \PValue{marginpar} will be output.
-
-Attentive readers\textnote{forced output cs. synchronisation} will have noticed
-that the forced output is something similar to the synchronisation. But if the
-forced output really results in an output you will be at the start of a new
-page and not just at the end of the output afterwards. Nevertheless, a
-forced output terminates with less \LaTeX{} runs.%
+This command prints all notes\textnote{pending notes} of a particular note
+column that have not yet been output by the end of the current page but which
+were created on that or a previous page. Blank pages are generated as needed
+to output these pending notes. During the output of the pending notes of this
+note column, notes of other note columns may also be output, but only as
+necessary to output the pending notes of the specified note column.
+
+During the output of the pending notes, notes created in the previous \LaTeX{}
+run on the pages that are now replaced by the inserted blank pages may be
+output by mistake. This will be corrected automatically in one of the
+subsequent \LaTeX{} runs. Such shifts are usually indicated by the message:
+``\LaTeX{} Warning: Label(s) may have changed. Rerun to get cross-references
+right.''
+
+The note column whose pending notes are to be output is indicated by the
+optional argument \PName{note column name}. If this argument is omitted, the
+notes of the default note column \PValue{marginpar} will be output.
+
+The attentive reader\textnote{forced output vs. synchronisation} will have
+noticed that the forced output of a note column is not unlike synchronisation.
+But if the forced output actually results in an output, it will be at the
+start of a new page and not just below the previous output. Nonetheless, a
+forced output usually results in fewer \LaTeX{} runs.%
\EndIndexGroup
\begin{Declaration}
\Macro{clearnotecolumns}\OParameter{list of note column names}
\end{Declaration}
-This command is similar to \DescRef{\LabelBase.cmd.clearnotecolumn} with the
-difference that the optional argument is not only the name of one note column
-but a comma-separated \PName{list of note column names}. It forces the output
-of the notes of all these note columns.
+This command is similar to \DescRef{\LabelBase.cmd.clearnotecolumn}, but the
+the optional argument here can be not only the name of one note column but a
+comma-separated \PName{list of note column names}. The pending notes of all
+these note columns are then ouput.
-If you omit the optional argument, all delayed notes of all note columns will
-be output.%
+If you omit the optional argument or leave it empty, all pending notes of all
+note columns will be output.%
\EndIndexGroup
\begin{Declaration}
\OptionVName{autoclearnotecolumns}{simple switch}
\end{Declaration}
-Usually you would like to force the output of notes whenever a document
+As a rule, pending notes will always be output if a document
implicitly\,---\,e.\,g. because of a \DescRef{maincls.cmd.chapter}
-command\,---\,or explicitly executes \DescRef{maincls.cmd.clearpage}. Note
-that this is also the case at the end of the document inside
-\Macro{end}\PParameter{document}. Option \Option{autoclearnotecolumns} manages
-whether or not \DescRef{maincls.cmd.clearpage} should also executes
-\DescRef{\LabelBase.cmd.clearnotecolumns} without any optional argument.
-
-According to the author's preference the option is active by
-default. But you can change this with proper values for simple switches (see
-\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}) at any time.
-
-You should note, that deactivation of the option can result in lost notes at
-the end of the document. So you should insert
-\DescRef{\LabelBase.cmd.clearnotecolumns} before
-\Macro{end}\PParameter{document} if you deactivate the option.
-
-This should answer the question from the end of the last section. By default
-the section would be output even if it would need the output of one more
-page. But because this would be done after the end of the
-\DescRef{maincls.env.addmargin} environment, the forced output could overlap
-with main text after that environment. So it would be useful to either add one
-more synchronisation point or to force the output explicitly immediately at
-the end of the \DescRef{maincls.env.addmargin} environment.
+command\,---\,or explicitly executes \DescRef{maincls.cmd.clearpage}. This is
+also the case at the end of the document within
+\Macro{end}\PParameter{document}. The \Option{autoclearnotecolumns} option can
+be used to control whether \DescRef{\LabelBase.cmd.clearnotecolumns} should be
+executed automatically without arguments when running
+\DescRef{maincls.cmd.clearpage}.
+
+Since this is generally the desired behaviour, the option is active by
+default. But you can change this with the appropriate value for a simple
+switch (see \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch})
+at any time.
+
+Note\textnote{Attention!} that disabling the automatic output of pending notes
+can result in lost notes at the end of the document. So in this case you
+should insert \DescRef{\LabelBase.cmd.clearnotecolumns} before
+\Macro{end}\PParameter{document} fore safety's sake.
+
+The question from the end of the last section should now be answered. If the
+paragraph is to be completely output, it had to be wrapped to the next page.
+This is, of course, the default setting. However, since this would happen
+after the end of the \DescRef{maincls.env.addmargin} environment, the forced
+output could still overlap with subsequent text. So in the example it would
+make sense to add another synchronisation point after the
+\DescRef{maincls.env.addmargin} environment.
The result of the example is shown in
\autoref{fig:scrlayer-notecolumn.example}.\iffree{}{ Only the colour has been
- changed from blue into grey.}
+changed from blue to grey.}
\begin{figure}
\KOMAoptions{captions=bottombeside}%
\setcapindent{0pt}%
- \begin{captionbeside}[{An example page to the example of
- \autoref{cha:scrlayer-notecolumn}}]{An example page to the example of
+ \begin{captionbeside}[{A sample page for the example in
+ \autoref{cha:scrlayer-notecolumn}}]{A sample page for the example in
this chapter\label{fig:scrlayer-notecolumn.example}}[l]
\frame{\includegraphics[width=.5\textwidth,keepaspectratio]%
{scrlayer-notecolumn-example}}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage-experts.tex
index fb3282f1d70..c9cdc98c8aa 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage-experts.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage-experts.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlayer-scrpage-experts.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer-scrpage-experts.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -44,48 +44,51 @@
% ============================================================================
\KOMAProvidesFile{scrlayer-scrpage-experts.tex}%
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (chapter: scrlayer-scrpage-experts)]
-\translator{Markus Kohm}
+\translator{Markus Kohm\and Karl Hagen}
-% Date version of the translated file: 2015-03-31
+% Date version of the translated file: 2018-01-31
\chapter[{Additional Features of \Package{scrlayer-scrpage}}]
{Additional Features\ChangedAt{v3.12}{\Package{scrlayer-scrpage}} with
- package \Package{scrlayer-scrpage}}
+ the \Package{scrlayer-scrpage} package}
\labelbase{scrlayer-scrpage-experts}
%
\BeginIndexGroup
\BeginIndex{Package}{scrlayer-scrpage}%
-Package \Package{scrlayer-scrpage} provides features that have not been
-described in \autoref{cha:scrlayer-scrpage} of this \iffree{user
- guide}{book}'s \autoref{part:forAuthors}. In general, the average user will
-not need those extensions and some of them are only provided for
-compatibility with \Package{scrpage2}.
+The \Package{scrlayer-scrpage} package offers many features beyond what has
+been described in \autoref{cha:scrlayer-scrpage} of \autoref{part:forAuthors}
+of this \iffree{guide}{book}. However, the average user will not normally need
+these extensions, and some of them are only provided for compatibility with
+\Package{scrpage2}. The documentation here in \autoref{part:forExperts} serves
+to deepen and broaded your knowledge, and its mastery goes beyond basic
+skills.
-\LoadCommonFile{pagestylemanipulation}% \section{Manipulation of Defined Page Styles}
+\LoadCommonFile{pagestylemanipulation}% \section{Manipulating Defined Page Styles}
-\section{Definition of new Pairs of Page Styles}
+\section{Defining New Pairs of Page Styles}
\seclabel{pagestyle.pairs}
-In \autoref{sec:scrlayer-scrpage.predefined.pagestyles} the page styles
-\PageStyle{scrheadings} and \PageStyle{plain.scrheadings} have been
-described. These can be seen as a pair of page styles, with
-\PageStyle{scrheadings} being the main page style with a running head and
-\PageStyle{plain.scrheadings} being the corresponding \PageStyle{plain} page
-style without running head but generally with pagination. Additionally to the
-configuration of these page styles, \Package{scrlayer-scrpage} provides also
-the feature of defining new such pairs of page styles. Thereby the name of the
-main page style, e.\,g., \PageStyle{scrheadings}, can be seen as the name of the
-pair of page styles.
-
-Most users will not need more than the predefined pair
-\PageStyle{scrheadings}. So the commands of this section may be understood as
-an addition for special cases. And as each such case is very special,
-this section also lacks of handsome examples. Nevertheless, if the support
-will show me a real nice example in the future, I perhaps could use it in
-the future. However, I'm almost sure that all such cases could also be
-solved using the predefined pair only.
+The two page styles \PageStyle{scrheadings} and \PageStyle{plain.scrheadings}
+were described in \autoref{sec:scrlayer-scrpage.predefined.pagestyles}. You
+can view them as a kind of pair, with \PageStyle{scrheadings} intended as the
+main page style for a running head and \PageStyle{plain.scrheadings} the
+corresponding \PageStyle{plain} page style without a running head but
+generally with pagination. In addition to configuring this predefined pair,
+\Package{scrlayer-scrpage} also lets you define additional pairs of page
+styles. The name of the main page style, for example \PageStyle{scrheadings},
+also serves as the name of the page-style pair.
+
+\iffree{
+ The vast majority of users will not need more than the one predefined
+ page-style pair, \PageStyle{scrheadings}. So the commands documented in this
+ section are therefore extensions for special cases. Since I have not come
+ across any suitable applications while writing this manual, there are no
+ detailed examples. Should I ever run across a particularly nice application
+ while providing support, I will happily include it in future versions. At
+ the same time, however, I'm virtually certain that all such cases could also
+ be solved using the predefined pair only.}{}
\begin{Declaration}
\Macro{defpairofpagestyles}%
@@ -97,54 +100,58 @@ solved using the predefined pair only.
\Macro{providepairofpagestyles}%
\OParameter{parent pair}\Parameter{name}\Parameter{definition}
\end{Declaration}
-With these commands you may define pairs of page styles similar to
-\PageStyle{scrheadings} and \PageStyle{plain.scrheadings}. Thereby
-\PName{name} is the name of the main page style that is similar to
-\PageStyle{scrheadings}. The name of the corresponding \PageStyle{plain} page
-style will be prefixed by \PValue{plain.} automatically. So \PName{name} is
-not only the name of the pair of page styles, but also the name of the main
-page style of that pair, while \PValue{plain.}\PName{name} is the name of the
-\PageStyle{plain} page style of this pair.
-
-If the optional argument \PName{parent pair} is given, the settings of the
-pair of page styles with that name are the initial settings of the new pair of
-page styles. So the new pair inherits the configuration of the \PName{parent
- pair}.
-
-Reading \autoref{sec:scrlayer-scrpage.predefined.pagestyles} might have
-created the impression that the described commands are related to
-\PageStyle{scrheadings} and \PageStyle{plain.scrheadings} only. However, if
-there exist more pairs of page styles, these commands are related to the pair
-that has been activated last. In fact, this is the case for \DescRef{scrlayer-scrpage.cmd.lehead},
-\DescRef{scrlayer-scrpage.cmd.cehead}, \DescRef{scrlayer-scrpage.cmd.rehead}, \DescRef{scrlayer-scrpage.cmd.lohead}, \DescRef{scrlayer-scrpage.cmd.cohead},
-\DescRef{scrlayer-scrpage.cmd.rohead}, \DescRef{scrlayer-scrpage.cmd.lefoot}, \DescRef{scrlayer-scrpage.cmd.cefoot}, \DescRef{scrlayer-scrpage.cmd.refoot},
-\DescRef{scrlayer-scrpage.cmd.lofoot}, \DescRef{scrlayer-scrpage.cmd.cofoot}, \DescRef{scrlayer-scrpage.cmd.rofoot}, \DescRef{scrlayer-scrpage.cmd.ihead}, \DescRef{scrlayer-scrpage.cmd.chead},
-\DescRef{scrlayer-scrpage.cmd.ohead}, \DescRef{scrlayer-scrpage.cmd.ifoot}, \DescRef{scrlayer-scrpage.cmd.cfoot}, and \DescRef{scrlayer-scrpage.cmd.ofoot} of
-\autoref{sec:scrlayer-scrpage.predefined.pagestyles}.
-
-All those commands and the below described commands
-\DescRef{\LabelBase.cmd.clearmainofpairofpagestyles}, \DescRef{\LabelBase.cmd.clearplainofpairofpagestyles}, and
-\DescRef{\LabelBase.cmd.clearpairofpagestyles} are also designed to be used inside the argument
-\PName{definition}. In that case, they are a kind of default configuration of
-the pair of page styles that is executed each time the pair will be
-activated. A pair of page styles is activated, if one of the page styles of
-the pair will be activated, which is mostly done by using
+You can use these commands to define pairs of page styles similar to
+\PageStyle{scrheadings} and \PageStyle{plain.scrheadings}, where \PName{name}
+is the name of the main page style corresponding to \PageStyle{scrheadings}.
+The name of the equivalent \PageStyle{plain} page style will be prefixed by
+\PValue{plain.} automatically. So \PName{name} is not only the name of the
+pair of page styles, but also the name of the main page style of that pair,
+while \PValue{plain.}\PName{name} is the name of the \PageStyle{plain} page
+style of this pair.
+
+If you provide the optional \PName{parent pair} argument, this is the name of
+a page-style pair whose settings are used to initialise the new page-style
+pair. So the new pair inherits the configuration of the \PName{parent pair}.
+
+Although \autoref{sec:scrlayer-scrpage.predefined.pagestyles} might have
+created the impression that the commands described there apply only to
+\PageStyle{scrheadings} and \PageStyle{plain.scrheadings} only, this is true
+only so long as those two page styles are the only defined page-style pair. As
+soon as there are multiple page-style pairs,
+\DescRef{scrlayer-scrpage.cmd.lehead}, \DescRef{scrlayer-scrpage.cmd.cehead},
+\DescRef{scrlayer-scrpage.cmd.rehead}, \DescRef{scrlayer-scrpage.cmd.lohead},
+\DescRef{scrlayer-scrpage.cmd.cohead}, \DescRef{scrlayer-scrpage.cmd.rohead},
+\DescRef{scrlayer-scrpage.cmd.lefoot}, \DescRef{scrlayer-scrpage.cmd.cefoot},
+\DescRef{scrlayer-scrpage.cmd.refoot}, \DescRef{scrlayer-scrpage.cmd.lofoot},
+\DescRef{scrlayer-scrpage.cmd.cofoot}, \DescRef{scrlayer-scrpage.cmd.rofoot},
+\DescRef{scrlayer-scrpage.cmd.ihead}, \DescRef{scrlayer-scrpage.cmd.chead},
+\DescRef{scrlayer-scrpage.cmd.ohead}, \DescRef{scrlayer-scrpage.cmd.ifoot},
+\DescRef{scrlayer-scrpage.cmd.cfoot}, and \DescRef{scrlayer-scrpage.cmd.ofoot}
+all refer to page-style pair that was most recently activated.
+
+In addition to those eighteen commands mentioned above, the three commands
+described below, \DescRef{\LabelBase.cmd.clearmainofpairofpagestyles},
+\DescRef{\LabelBase.cmd.clearplainofpairofpagestyles}, and
+\DescRef{\LabelBase.cmd.clearpairofpagestyles}, are designed to be used inside
+the \PName{definition} argument. In this case, they represent a kind of
+default configuration of the page-style pair that is executed each time the
+pair is activated. You activate a page-style pair by activating either one two
+page styles in the pair. Typically, you do so with
\DescRef{maincls.cmd.pagestyle}\IndexCmd{pagestyle}.
-Please note that the commands of
-\autoref{sec:scrlayer-scrpage.pagestyle.content} are for general
-purpose. Therefore, they are related to every page style that has been defined
-using \Package{scrlayer-scrpage}.
-
-Whereas \Macro{defpairofpagestyles} will define a pair no matter if the
-corresponding page styles are already defined, \Macro{newpairofpagestyles} and
-\Macro{providepairofpagestyles} will define the pair only, if the page styles
-are currently undefined. If at least one of the page styles is already
-defined, the new definition of \Macro{providepairofpagestyles} will be
-ignored, but usage of \Macro{newpairofpagestyles} would result in an error
-message. To redefine already existing pairs of page styles you may use
-\Macro{renewpairofpagestyles}. With this an error would be thrown, if at least
-one of the page styles of the pair does not already exist.%
+Note that the commands of \autoref{sec:scrlayer-scrpage.pagestyle.content} on
+\autopageref{sec:scrlayer-scrpage.pagestyle.content} are general in nature and
+apply to all page styles defined with \Package{scrlayer-scrpage}.
+
+Although \Macro{defpairofpagestyles} defines a page-style pair regardless of
+whether the corresponding page styles already exist,
+\Macro{newpairofpagestyles} and \Macro{providepairofpagestyles} do so only if
+the page styles are currently undefined. If at least one of the page styles is
+already defined, the new definition of \Macro{providepairofpagestyles} will be
+ignored, whereas using \Macro{newpairofpagestyles} results in an error
+message. To redefine existing page-style pairs, you can use
+\Macro{renewpairofpagestyles}. With this an is thrown if either one of the two
+page styles of the pair does not already exist.%
\EndIndexGroup
@@ -153,333 +160,52 @@ one of the page styles of the pair does not already exist.%
\Macro{clearplainofpairofpagestyles}%
\Macro{clearpairofpagestyles}
\end{Declaration}
-Command \Macro{clearmainofpairofpagestyles} will configure the main page style
-of the lastly activated pair of page styles to be empty. In contrast to this
-\Macro{clearplainofpairofpagestyles} will configure the \PageStyle{plain} page
-style of the lastly activated pair of page styles to be empty. Last but not
-least \Macro{clearpairofpagestyle} will configure both page styles of the
-lastly activated pair of page styles to be empty.
-
-But please note\textnote{Attention!} that none of these commands will remove
-the definitions of argument \PName{definition} that has been used when
-defining the pair of page styles (see above). So if you activate the pair of
-page styles again, those definitions will be used again!
-
-These commands may be used inside of \PName{definition} themselves. But you
-may use them outside the definition of a pair of page styles too. In this case
-they are related to the lastly activated pair of page styles.
-
-\BeginIndex{Cmd}{clearscrheadings}%
-\BeginIndex{Cmd}{clearscrplain}%
-\BeginIndex{Cmd}{clearscrheadfoot}%
-The commands \Macro{clearscrheadings}, \Macro{clearscrplain}, and
-\Macro{clearscrheadfoot} are aliases for these commands provided only for
-compatibility with \Package{scrpage2}. Nevertheless, they are deprecated and
-should not be used.%
-%
+The \Macro{clearmainofpairofpagestyles} command sets the main page style of
+the most recently activated page-style pair to be empty. In contrast, the
+\Macro{clearplainofpairofpagestyles} command sets the \PageStyle{plain} page
+style of the active page-style pair to be empty. Finally,
+\Macro{clearpairofpagestyle} sets both page styles of the activate pair to be
+empty.
+
+But note\textnote{Attention!} that none of these commands removes the
+definitions of the \PName{definition} argument that was specified when
+defining the page-style pair (see above). So if you activate the pair of page
+styles again, those definitions will be used again!
+
+You can use these commands inside the \PName{definition} of the page-style
+pair explained above. But you can also use them outside this definition. In
+this case, they refer to the most recently activated page-style pair.%
\EndIndexGroup
-\section{Definition of Simple Page Styles with Three Parts in Head and Foot }
-\seclabel{pagestyle.triple}
-
-Beside predefined page styles and the definition of new pairs of page styles,
-package \Package{scrlayer-scrpage} also provides the definition of page styles
-with three parts in head and foot. But this user interface exists for
-compatibility with \Package{scrpage2} only. However, it has been extended
-beyond the functionality of \Package{scrpage2} to provide a more consistent
-set of commands. Nevertheless, for new documents it is recommended to instead
-use the advanced features described in the previous section.
-
-\begin{Declaration}
- \Macro{deftriplepagestyle}\Parameter{name of the page style}%
- \OParameter{thickness of the outer line}%
- \OParameter{thickness of the inner line}%
- \Parameter{inner head element}%
- \Parameter{centre head element}%
- \Parameter{outer head element}%
- \Parameter{inner foot element}%
- \Parameter{centre foot element}%
- \Parameter{outer foot element}%
- \Macro{newtriplepagestyle}\Parameter{name of the page style}%
- \OParameter{thickness of the outer linen}%
- \OParameter{thickness of the inner linen}%
- \Parameter{inner head element}%
- \Parameter{centre head element}%
- \Parameter{outer head element}%
- \Parameter{inner foot element}%
- \Parameter{centre foot element}%
- \Parameter{outer foot element}%
- \Macro{renewtriplepagestyle}\Parameter{name of the page style}%
- \OParameter{thickness of the outer line}%
- \OParameter{thickness of the inner line}%
- \Parameter{inner head element}%
- \Parameter{centre head element}%
- \Parameter{outer head element}%
- \Parameter{inner foot element}%
- \Parameter{centre foot element}%
- \Parameter{outer foot element}%
- \Macro{providetriplepagestyle}\Parameter{name of the page style}%
- \OParameter{thickness of the outer line}%
- \OParameter{thickness of the inner line}%
- \Parameter{inner head element}%
- \Parameter{centre head element}%
- \Parameter{outer head element}%
- \Parameter{inner foot element}%
- \Parameter{centre foot element}%
- \Parameter{outer foot element}
-\end{Declaration}
-With these commands you can define a single page style, whose head and foot
-are parted into three elements: an inner element, a centre element, and an
-outer element. The contents of the elements are stated via three mandatory
-arguments for the head and three mandatory arguments for the foot.
-
-Each of the two inner elements will be printed right aligned on left pages and
-left aligned on right pages. The centre elements will be printed centred in
-the head respectively foot of left and right pages. Each of the two outer
-elements will be printed left aligned on left pages and right aligned on right
-pages.
-
-Please note once again:\textnote{Attention!} There are only right pages in
-single side layout!
-
-The two optional arguments can be used to activate horizontal lines in the
-head and foot of the page style. To do so, you put the wanted thickness of the
-line as an optional argument. The first optional argument is the
-\PName{thickness of the outer line} in both, the page head and footer. In the
-page head it will be printed above the head contents. In the page footer it
-will be printed below the foot contents. The second optional argument is the
-\PName{thickness of the inner line}. This will be printed below the page head
-and additionally above the page footer. If you have only one optional
-argument, this is the \PName{thickness of the inner line}. In this case no
-outer line will be printed. And if you omit both optional arguments, both
-lines will be omitted.
-
-Please note\textnote{Attention!}, an empty optional argument is not the same
-like omitting the optional argument! Empty optional arguments are not allowed
-in this case. But you may use simple dimension expressions as explained for
-\KOMAScript{} option \DescRef{scrlayer-scrpage.option.headwidth} (see
-\autoref{sec:scrlayer-scrpage.pagestyle.content},
-\DescPageRef{scrlayer-scrpage.option.headwidth}) for the optional
-arguments.
-
-\hyperref[fig:scrlayer-scrpage.triplepagestyle]%
-{Figure~\ref*{fig:scrlayer-scrpage.triplepagestyle}} shows a sketch for the
-interpretation of the arguments on a schematic double page. Thereby
-``\texttt{outer}'', ``\texttt{inner}'', and ``\texttt{centre}'' are example
-contents. The corresponding arrows illustrate the expansion of those
-contents. The \iffree{coloured }{}texts inside the pages are only the names of
-the arguments of these commands. The related arrows \iffree{in the same colour
-}{} point to the corresponding elements of the page.
-
-\begin{figure}
- \centering
- \begin{picture}(\textwidth,80mm)
- \put(0,50mm){%
- %\
- \begin{picture}(\textwidth,30mm)(0,-10mm)
- \thinlines
- \small
- % linke Seite
- \put(0,20mm){\line(1,0){.49\textwidth}}%
- \put(0,0){\line(0,1){20mm}}%
- \multiput(0,0)(0,-1mm){10}{\line(0,-1){.5mm}}%
- \put(.49\textwidth,5mm){\line(0,1){15mm}}%
- \put(.05\textwidth,15mm){\thicklines\line(1,0){.415\textwidth}}%
- \put(.05\textwidth,10mm){\makebox(0em,5mm)[l]{\slshape outer\strut$\longrightarrow$}}%
- \put(.465\textwidth,10mm){\makebox(0em,5mm)[r]{\slshape $\longleftarrow$inner\strut}}%
- \put(.2575\textwidth,10mm){\makebox(0em,5mm)[c]{\slshape $\longleftarrow$centre\strut$\longrightarrow$}}%
- \put(.05\textwidth,10mm){\thicklines\line(1,0){.415\textwidth}}%
- % rechte Seite
- \put(0.51\textwidth,20mm){\line(1,0){.49\textwidth}}%
- \put(0.51\textwidth,5mm){\line(0,1){15mm}}%
- \multiput(\textwidth,0)(0,-1mm){10}{\line(0,-1){.5mm}}%
- \put(\textwidth,0mm){\line(0,1){20mm}}%
- \put(.535\textwidth,15mm){\thicklines\line(1,0){.415\textwidth}}%
- \put(.535\textwidth,10mm){\makebox(0em,5mm)[l]{\slshape inner\strut$\longrightarrow$}}%
- \put(.95\textwidth,10mm){\makebox(0em,5mm)[r]{\slshape $\longleftarrow$outer\strut}}%
- \put(.7425\textwidth,10mm){\makebox(0em,5mm)[c]{\slshape $\longleftarrow$centre\strut$\longrightarrow$}}%
- \put(.535\textwidth,10mm){\thicklines\line(1,0){.415\textwidth}}%
- % commands for both pages
- \iffree{\color{red}}{}%
- \put(.5\textwidth,0){\makebox(0,\baselineskip)[c]{\PName{inner head element}}}%
- \put(.5\textwidth,-5mm){\makebox(0,\baselineskip)[c]{\PName{centre
- head element}}}%
- \put(.5\textwidth,-10mm){\makebox(0,\baselineskip)[c]{\PName{outer
- head element}}}%
- \put(\dimexpr.5\textwidth-2em,.5\baselineskip){%
- \put(-1.5em,.5\baselineskip){\vector(0,1){7mm}}%
- \put(-3.5em,-1\baselineskip){\line(-1,0){\dimexpr .25\textwidth-6.5em\relax}}%
- \put(-\dimexpr
- .25\textwidth-3em\relax,-1\baselineskip){\vector(0,1){\dimexpr
- 7mm+1.5\baselineskip\relax}}
- \put(-3.25em,-2.25\baselineskip){\line(-1,0){\dimexpr .45\textwidth-8em\relax}}%
- \put(-\dimexpr
- .45\textwidth-4.75em\relax,-2.25\baselineskip){\vector(0,1){\dimexpr
- 7mm+2.75\baselineskip\relax}}
- }%
- \put(\dimexpr.5\textwidth+2em,.5\baselineskip){%
- \put(1.5em,.5\baselineskip){\vector(0,1){7mm}}%
- \put(3.5em,-1\baselineskip){\line(1,0){\dimexpr .25\textwidth-6.5em\relax}}
- \put(\dimexpr
- .25\textwidth-3em\relax,-1\baselineskip){\vector(0,1){\dimexpr
- 7mm+1.5\baselineskip\relax}}
- \put(3.25em,-2.25\baselineskip){\line(1,0){\dimexpr .45\textwidth-8em\relax}}
- \put(\dimexpr
- .45\textwidth-4.75em\relax,-2.25\baselineskip){\vector(0,1){\dimexpr
- 7mm+2.75\baselineskip\relax}}
- }%
- \end{picture}
- %
- }%
- \put(0,0){%
- \begin{picture}(\textwidth,30mm)
- \thinlines
- \small
- % linke Seite
- \put(0,0){\line(1,0){.49\textwidth}}%
- \put(0,0){\line(0,1){20mm}}%
- \multiput(0,20mm)(0,1mm){10}{\line(0,1){.5mm}}%
- \put(.49\textwidth,0){\line(0,1){15mm}}%
- \put(.05\textwidth,15mm){\thicklines\line(1,0){.415\textwidth}}%
- \put(.05\textwidth,10mm){\makebox(0em,5mm)[l]{\slshape outer\strut$\longrightarrow$}}%
- \put(.465\textwidth,10mm){\makebox(0em,5mm)[r]{\slshape $\longleftarrow$inner\strut}}%
- \put(.2575\textwidth,10mm){\makebox(0em,5mm)[c]{\slshape $\longleftarrow$centre\strut$\longrightarrow$}}%
- \put(.05\textwidth,10mm){\thicklines\line(1,0){.415\textwidth}}%
- % rechte Seite
- \put(.51\textwidth,0){\line(1,0){.49\textwidth}}%
- \put(.51\textwidth,0){\line(0,1){15mm}}%
- \put(\textwidth,0){\line(0,1){20mm}}%
- \multiput(\textwidth,20mm)(0,1mm){10}{\line(0,1){.5mm}}%
- \put(.535\textwidth,15mm){\thicklines\line(1,0){.415\textwidth}}%
- \put(.535\textwidth,10mm){\makebox(0em,5mm)[l]{\slshape inner\strut$\longrightarrow$}}%
- \put(.95\textwidth,10mm){\makebox(0em,5mm)[r]{\slshape $\longleftarrow$outer\strut}}%
- \put(.7425\textwidth,10mm){\makebox(0em,5mm)[c]{\slshape $\longleftarrow$centre\strut$\longrightarrow$}}%
- \put(.535\textwidth,10mm){\thicklines\line(1,0){.415\textwidth}}%
- % commands for both pages
- \iffree{\color{red}}{}%
- \put(.5\textwidth,20mm){\makebox(0,\baselineskip)[c]{\PName{inner foot
- element}}}%
- \put(.5\textwidth,25mm){\makebox(0,\baselineskip)[c]{\PName{centre
- foot element}}}%
- \put(.5\textwidth,30mm){\makebox(0,\baselineskip)[c]{\PName{outer foot
- element}}}%
- \put(\dimexpr.5\textwidth-2em,.5\baselineskip){%
- \put(-1.5em,\dimexpr 20mm-.5\baselineskip\relax){\vector(0,-1){6mm}}%
- \put(-3.5em,25mm){\line(-1,0){\dimexpr .25\textwidth-6.5em\relax}}%
- \put(-\dimexpr .25\textwidth-3em\relax,25mm){\vector(0,-1){\dimexpr
- .5\baselineskip + 11mm\relax}}%
- \put(-3em,30mm){\line(-1,0){\dimexpr .45\textwidth-7.5em\relax}}%
- \put(-\dimexpr .45\textwidth-4.5em\relax,30mm){\vector(0,-1){\dimexpr
- .5\baselineskip + 16mm\relax}}%
- }%
- \put(\dimexpr.5\textwidth+2em,.5\baselineskip){%
- \put(1.5em,\dimexpr 20mm-.5\baselineskip\relax){\vector(0,-1){6mm}}%
- \put(3.5em,25mm){\line(1,0){\dimexpr .25\textwidth-6.5em\relax}}%
- \put(\dimexpr .25\textwidth-3em\relax,25mm){\vector(0,-1){\dimexpr
- .5\baselineskip + 11mm\relax}}%
- \put(3em,30mm){\line(1,0){\dimexpr .45\textwidth-7.5em\relax}}%
- \put(\dimexpr .45\textwidth-4.5em\relax,30mm){\vector(0,-1){\dimexpr
- .5\baselineskip + 16mm\relax}}%
- }%
- \end{picture}
- }%
- \thinlines\small\iffree{\color{blue}}{}%
- \put(0.055\textwidth,45mm){\vector(0,1){25mm}}%
- \put(0.945\textwidth,45mm){\vector(0,1){25mm}}%
- \put(0.055\textwidth,45mm){\vector(0,-1){30mm}}%
- \put(0.945\textwidth,45mm){\vector(0,-1){30mm}}%
- \put(0.055\textwidth,45mm){\line(1,0){\dimexpr
- .445\textwidth-7.5em\relax}}%
- \put(0.945\textwidth,45mm){\line(-1,0){\dimexpr
- .445\textwidth-7.5em\relax}}%
- \put(0.5\textwidth,45mm){\makebox(0,0)[c]{\PName{thickness of the inner lines}}}%
- \iffree{\color{green}}{}%
- \put(0.025\textwidth,40mm){\line(0,1){35mm}}%
- \put(0.025\textwidth,75mm){\vector(1,0){3.75mm}}%
- \put(0.975\textwidth,40mm){\line(0,1){35mm}}%
- \put(0.975\textwidth,40mm){\line(0,1){35mm}}%
- \put(0.975\textwidth,75mm){\vector(-1,0){3.75mm}}%
- \put(0.025\textwidth,40mm){\line(0,-1){30mm}}%
- \put(0.025\textwidth,10mm){\vector(1,0){3.75mm}}%
- \put(0.975\textwidth,40mm){\line(0,-1){30mm}}%
- \put(0.975\textwidth,40mm){\line(0,-1){30mm}}%
- \put(0.975\textwidth,10mm){\vector(-1,0){3.75mm}}%
- \put(0.025\textwidth,40mm){\line(1,0){\dimexpr
- .475\textwidth-7.5em\relax}}%
- \put(0.975\textwidth,40mm){\line(-1,0){\dimexpr
- .475\textwidth-7.5em\relax}}%
- \put(0.5\textwidth,40mm){\makebox(0,0)[c]{\PName{thickness of the outer lines}}}%
- \end{picture}
- \caption[{Elements of a three parts page style}]{Schematic double page with
- the elements of a tripartite page style of commands
- \Macro{deftriplepagestyle}, \Macro{newtriplepagestyle},
- \Macro{providetriplepagestyle}, and \Macro{renewtriplepagestyle}}
- \label{fig:scrlayer-scrpage.triplepagestyle}
-\end{figure}
-
-Using the described commands it is not possible to draw only a single line,
-e.\,g., only below the page head but not above the page footer. If you need
-to do so, please consult the previous or following section.
-
-The length of a single element\textnote{Attention!} is not limited by the
-existence of a neighbour element. So in unfortunate circumstances it can
-happen that one elements overwrites a neighbour element or even both of
-them. The user himself is responsible to avoid such inappropriate usage. With
-automatic running heads this could, e.\,g., be done using the optional
-argument of the section commands. See the manual of the document class for
-more information about those commands.
-
-Command \Macro{deftriplepagestyle} defines a page style independent from
-whether or not a page style with the same \PName{name of the page style}
-already exists. In difference to this \Macro{newtriplepagestyle} and
-\Macro{providetriplepagestyle} define the page style only, if the \PName{name
- of the page style} is not the name of an already defined page
-style. Otherwise \Macro{providepagestyle} simply does nothing, but
-\Macro{newtriplepagestyle} throws an error. Command
-\Macro{renewtriplepagestyle} is something like the opposite of
-\Macro{newtriplepagestyle}. It throws an error, if there has not been
-a page style with the \PName{name of the page style} before, and defines the
-page style only, if there has been already a page style with the given name.
-
-\BeginIndex{Cmd}{deftripstyle}%
-The command \Macro{deftriplestyle} of \Package{scrpage2} corresponds to
-\Macro{deftriplepagestyle}. Because of unification reasons it has been renamed
-and should not be used with it's old name any longer. Using the old name would
-result in a warning message. Nevertheless, the result would be the expected
-one.%
-\EndIndexGroup
-
-
-\section{Definition of Complex Page Styles}
+\section{Defining Complex Page Styles}
\seclabel{pagestyle.experts}
-Beside predefined page styles, the definition of new pairs of page styles and
-the deprecated definition of page styles with tripartite head and foot, the
-package \Package{scrlayer-scrpage} additionally provides basic features to
-define new page styles. All already described page style definitions of
-\Package{scrlayer-scrpage} use internally these basic features. Because of the
-complexity of this user interface it is recommended for advanced users only.
-As all most all imaginable use cases of page styles can handled using the
-features described previous section, less advanced users may skip this
-section.
+In addition to the predefined page styles, \Package{scrlayer-scrpage} also
+provides a more basic interface for defining new page styles. The page-style
+definitions discussed so far use this interface internally, as do the obsolete
+commands in \autoref{sec:\LabelBase.pagestyle.triple}.
+\Package{scrlayer-scrpage}. Because of its complexity, however, only advanced
+users should try to use it directly. Less experienced users can already
+achieve almost everything possible with this low-level interface by using the
+possibilities described previously.
\begin{Declaration}
\Macro{defpagestyle}%
- \Parameter{name}\Parameter{head specification}\Parameter{foot specification}%
+ \Parameter{name}\Parameter{header specification}\Parameter{footer specification}%
\Macro{newpagestyle}%
- \Parameter{name}\Parameter{head specification}\Parameter{foot specification}%
+ \Parameter{name}\Parameter{header specification}\Parameter{footer specification}%
\Macro{providepagestyle}%
- \Parameter{name}\Parameter{head specification}\Parameter{foot specification}%
+ \Parameter{name}\Parameter{header specification}\Parameter{footer specification}%
\Macro{renewpagestyle}%
- \Parameter{name}\Parameter{head specification}\Parameter{foot specification}%
+ \Parameter{name}\Parameter{header specification}\Parameter{footer specification}%
\end{Declaration}
-These commands can be used to define a single page style with maximum
-flexibility. Thereby \PName{name} is the name of the page style that should
-be defined.
+You can use these commands to define a single page style with maximum
+flexibility, where \PName{name} is the name of the page style that you want to
+define.
-The arguments \PName{head specification} and \PName{foot specification} have
-identical structure:
+The parameters \PName{header specification} and \PName{footer specification}
+have identical structure:
\begin{quote}\raggedright
\texttt{%
(\PName{length of the line above},\PName{thickness of the line above})\%\\
@@ -489,89 +215,89 @@ identical structure:
(\PName{length of the line below},\PName{thickness of the line below})%
}
\end{quote}
-The arguments in the round brackets are options. This means, you may omit them
+The arguments in the round brackets are optional. That is, you can omit them
together with the brackets. In that case, the length and thickness of the
-corresponding horizontal line would be given by the \KOMAScript{} options
+corresponding horizontal rules are based on the \KOMAScript{} options
\DescRef{scrlayer-scrpage.option.headtopline},
\DescRef{scrlayer-scrpage.option.headsepline},
-\DescRef{scrlayer-scrpage.option.footsepline} or
+\DescRef{scrlayer-scrpage.option.footsepline}, and
\DescRef{scrlayer-scrpage.option.footbotline} (see
\autoref{sec:scrlayer-scrpage.pagestyle.content},
\DescPageRef{scrlayer-scrpage.option.headtopline}).
-All three arguments in the curly brackets are mandatory. They hold arbitrary
-content specifications depending on the page and the layout settings. But for
-page styles with running heads usage of
+All three arguments in curly brackets are mandatory and are used depending on
+the page and the layout settings. Their content can be anything you want. For
+page styles with running heads, however, you should use
\DescRef{scrlayer-scrpage.cmd.headmark},
\DescRef{scrlayer-scrpage.cmd.leftmark}, or
-\DescRef{scrlayer-scrpage.cmd.rightmark} is recommended inside the
-specification. Section numbers or section headings must not be used in the
-specifications. Due to the asynchronous page building of \LaTeX, using them
-could result in wrong numbers or texts in the page header or footer.
-
-Command \Macro{defpagestyle} defines the page style no matter if a page style
-with the same \PName{name} already exists. Command \Macro{newpagestyle} would
-throw an error, if such a page style already exists. In contrast to this,
-\Macro{providepagestyle} simple does nothing in such a case. In contrast to
-\Macro{newpagestyle} command \Macro{renewpagestyle} throws an error, if a page
-style with the \PName{name} does not already exist, and therefore may be used
-to redefine an existing page style.
-
-All these commands are based on the command
-\DescRef{scrlayer.cmd.DeclarePageStyleByLayers}\IndexCmd{DeclarePageStyleByLayers} of package
-\Package{scrlayer}. \hyperref[tab:scrlayer-scrpage-experts.layersperstyle]{Table~\ref*{tab:scrlayer-scrpage-experts.layersperstyle}}
-shows the layers that are defined for a page style \PName{name}. More
-information about layers and layer page styles can be found starting on
-\autopageref{cha:scrlayer} in \autoref{cha:scrlayer} of
-\autoref{part:forExperts}.%
+\DescRef{scrlayer-scrpage.cmd.rightmark} inside the specification. Under no
+circumstances should you directly put the number or text of a sectioning
+command here. Because of the \LaTeX{}'s asynchronous page construction, the
+wrong numbers or text can appear in the header or footer if you do so.
+
+The \Macro{defpagestyle} command defines the page style regardless of whether
+it already exists or not. In contrast, \Macro{newpagestyle} throws an error if
+a page style of the same \PName{name} already exists. On the other hand,
+\Macro{providepagestyle} simply ignores the definition if the \PName{name} has
+already been used for a page style. Conversely, \Macro{renewpagestyle} can
+only redefine an existing page style. For a new \PName{name}, it throws an
+error.
+
+All four commands are based on the
+\DescRef{scrlayer.cmd.DeclarePageStyleByLayers}%
+\IndexCmd{DeclarePageStyleByLayers} command of the
+\hyperref[cha:scrlayer]{\Package{scrlayer}}\IndexPackage{scrlayer} package.
+You can find the layers that are defined for a page style \PName{name} in
+\autoref{tab:scrlayer-scrpage-experts.layersperstyle}, and more information
+about layers and layer-page in \autoref{cha:scrlayer}, starting on
+\autopageref{cha:scrlayer}.%
\begin{table}
% \KOMAoptions{captions=topbeside}
% \setcapindent{0pt}
% \begin{captionbeside}
\caption
- [{The layers \Package{scrlayer-scrpage} defines to a page style}]
- {The layers \Package{scrlayer-scrpage} defines to a page style
- \PName{name}%
- \label{tab:scrlayer-scrpage-experts.layersperstyle}}
+ [{The layers \Package{scrlayer-scrpage} defines for a page style}]
+ {The layers \Package{scrlayer-scrpage} defines for a \PName{name} page
+ style\label{tab:scrlayer-scrpage-experts.layersperstyle}}
% [l]
\begin{tabular}{ll}
\toprule
Name of the layer & Meaning of the layer \\
\midrule
- \PName{Name}\PValue{.head.above.line}
- & horizontal line above the page head\\
- \PName{Name}\PValue{.head.odd}
- & page head of odd pages in two-side layout\\
- \PName{Name}\PValue{.head.even}
- & page head of even pages in two-side layout\\
- \PName{Name}\PValue{.head.oneside}
- & page head in single-side layout\\
- \PName{Name}\PValue{.head.below.line}
- & horizontal line below the page head\\
- \PName{Name}\PValue{.foot.above.line}
- & horizontal line above the page foot\\
- \PName{Name}\PValue{.foot.odd}
- & page foot of odd pages in two-side layout\\
- \PName{Name}\PValue{.foot.even}
- & page foot of even pages in two-side layout\\
- \PName{Name}\PValue{.foot.oneside}
- & page foot in single-side layout\\
- \PName{Name}\PValue{.foot.below.line}
- & horizontal line below the page foot\\
+ \PName{name}\PValue{.head.above.line}
+ & horizontal line above the header\\
+ \PName{name}\PValue{.head.odd}
+ & header of odd pages in two-sided printing\\
+ \PName{name}\PValue{.head.even}
+ & header of even pages in two-sided printing\\
+ \PName{name}\PValue{.head.oneside}
+ & header in one-sided printing\\
+ \PName{name}\PValue{.head.below.line}
+ & horizontal line below the header\\
+ \PName{name}\PValue{.foot.above.line}
+ & horizontal line above the footer\\
+ \PName{name}\PValue{.foot.odd}
+ & footer of odd pages in two-sided printing\\
+ \PName{name}\PValue{.foot.even}
+ & footer of even pages in two-sided printing\\
+ \PName{name}\PValue{.foot.oneside}
+ & footer in one-sided printing\\
+ \PName{name}\PValue{.foot.below.line}
+ & horizontal line below the footer\\
\bottomrule
\end{tabular}
% \end{captionbeside}
\end{table}
\begin{Example}
- Assume you want to colour the whole background of page style
- \PageStyle{scrheadings}' head. Because you read the introduction to
- this chapter, you know, that \PageStyle{scrheadings} last but not least is a
- layer page style with, e.\,g., layers \PValue{scrheadings.head.even},
- \PValue{scrheadings.head.odd}, and \PValue{scrheadings.head.oneside}. So you
- define three more layers for the backgrounds and add them at the very
- beginning of the page style:
+ Suppose you want to set a background colour for the header of the
+ \PageStyle{scrheadings} page style. From the introduction to this chapter
+ and \autoref{tab:scrlayer-scrpage-experts.layersperstyle}, you know that
+ \PageStyle{scrheadings} is a layer page style that includes the layers
+ \PValue{scrheadings.head.even}, \PValue{scrheadings.head.odd}, and
+ \PValue{scrheadings.head.oneside}. You now define three more layers for
+ their backgrounds and add them at the beginning of the page style:
\begin{lstcode}
\documentclass{scrartcl}
\usepackage[automark]{scrlayer-scrpage}
@@ -602,13 +328,13 @@ information about layers and layer page styles can be found starting on
\blinddocument
\end{document}
\end{lstcode}
- As you can see, the example uses three layers, so the position and size of
- that background layers may simply be copied from the corresponding head
- layer using option \Option{clone}. This is much easier than using only one
- background layer and dynamically calculate the position time by time.
+ As you can see, the example uses three layers so that the position and size
+ of the background layers could simply be copied from the corresponding
+ header layer using the \Option{clone} option. This is easier than using only
+ one background layer and dynamically calculating its position each time.
- In this example the coloured background is printed using a \Macro{rule}
- command. The size arguments of this \Macro{rule} are given by
+ The coloured background itself was created using a \Macro{rule} command. The
+ size arguments of this \Macro{rule} are given by
\DescRef{scrlayer.cmd.layerwidth} and \DescRef{scrlayer.cmd.layerheight}
which contain the current width and height of the layer itself. The optional
argument of \Macro{rule} is used to move the rule down by the height of a
@@ -617,27 +343,44 @@ information about layers and layer page styles can be found starting on
%
Instead of using new layers to colour the background in the example above,
\Macro{colorbox} and \DescRef{scrlayer-scrpage.cmd.chead} could have been
-used. It is recommended to build such a solution as an exercise. Another
-approach could be to add the background layers one by one and just before the
-contents layers. You may do this as an exercise too.%
+used. You can work out a solution using this method as an exercise. Likewise,
+you could have added the background layers individually just before the
+corresponding content layer. You can implement this as an exercise too.%
\EndIndexGroup
+\section{Defining Simple Page Styles with a Tripartite Header and Footer}
+\seclabel{pagestyle.triple}
+
+\LoadNonFree{scrlayer-scrpage-experts}{1}
+
+\section{Legacy Features of \Package{scrpage2}}
+\seclabel{obsolete}
+
+\begin{Explain}
+ The \Package{scrlayer-scrpage} package contains some legacy features that
+ derive from \Package{scrpage2} and exist only to be as compatible as possible
+ with that package. Users only need to understand these features if they want
+ to edit an old document based on \Package{scrpage2}. You\textnote{Attention!}
+ should not use the items documented here in new documents!
+\end{Explain}
\begin{Declaration}
\KOption{hmode}\PValue{simple switch}
\end{Declaration}
-Package \Package{scrpage2} outputs page heads and page foots in horizontal
-mode always. In opposite to this \Package{scrlayer-scrpage} does not switch
-into horizontal mode itself, but the output of horizontal material will do
-so. Nevertheless, you can activate option \Option{hmode} gain compatibility to
-\Package{scrpage2} in this
-aspect. But this would have side effects, i.\,e., white
-spaces at the start of the output or the vertical alignment of the output.
-
-The options allows for the standard values for simple switches that are given
-at \autoref{tab:truefalseswitch} on \autopageref{tab:truefalseswitch}. The
-option is deactivated by default.%
+The \Package{scrpage2} package always outputs headers and footers in
+horizontal mode. In contrast, \Package{scrlayer-scrpage} in the default
+setting only switches into horizontal mode when horizontal material is output.
+However, if you activate the \Option{hmode} option, \Package{scrlayer-scrpage}
+will behave like \Package{scrpage2} and switch to horizontal mode before any
+output. This can affect both the processing of white space at the beginning of
+the output and vertical alignment.
+
+The options recognizes the standard values for simple switches listed in
+\autoref{tab:truefalseswitch} on \autopageref{tab:truefalseswitch}. The option
+is deactivated by default.%
\EndIndexGroup
+
+\LoadNonFree{scrlayer-scrpage-experts}{0}
%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage.tex
index b7254e0df94..d3c50bfef00 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlayer-scrpage.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer-scrpage.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -44,192 +44,215 @@
% ============================================================================
\KOMAProvidesFile{scrlayer-scrpage.tex}%
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (chapter: scrlayer-scrpage)]
-\translator{Markus Kohm\and Jana Schubert\and Jens H\"uhne}
+\translator{Markus Kohm\and Jana Schubert\and Jens H\"uhne\and Karl Hagen}
-% Date version of the translated file: 2015-03-31
+% Date version of the translated file: 2018-02-13
-\chapter[{Adapting Page Headers and Footers with \Package{scrlayer-scrpage}}]
- {Adapting\ChangedAt{v3.12}{\Package{scrlayer-scrpage}} Page Headers and
+\chapter[{Headers and Footers with \Package{scrlayer-scrpage}}]
+ {Headers\ChangedAt{v3.12}{\Package{scrlayer-scrpage}} and
Footers with \Package{scrlayer-scrpage}}
\labelbase{scrlayer-scrpage}
%
\BeginIndexGroup
\BeginIndex{Package}{scrlayer-scrpage}%
-
-Until version 3.11b of \KOMAScript, package \Package{scrpage2} has been the
-recommended way to customise page headers and footers beyond the options
-provided by the page styles \PageStyle{headings}, \PageStyle{myheadings},
-\PageStyle{plain}, and \PageStyle{empty} of the standard \KOMAScript{}
-classes. Until 2001 there was also package \Package{scrpage} as a supported
-solution for the same purpose. It was then made obsolete and in 2013, more
-than ten years later, it was finally removed from the regular
-\KOMAScript~distribution.
-
-In 2013 package \Package{scrlayer}\IndexPackage{scrlayer} became a basic
-module of \KOMAScript. That package provides a layer scheme and a new page
-style scheme based upon the layer scheme. Nevertheless, the flexibility it
-provides and the resulting complexity may be too demanding for the average
-user to handle. More about \Package{scrlayer} may be found in
-\autoref{cha:scrlayer} of \autoref{part:forExperts}. Potential problems with
-the controllability of \Package{scrlayer} apart, there are lots of users who
-are already familiar with the user interface of package \Package{scrpage2}.
-
-As a consequence the additional package \Package{scrlayer-scrpage} provides a
-user interface, which is largely compatible with \Package{scrpage2} and based
-on \Package{scrlayer}. Thus, if you are already familiar with \Package{scrpage2}
-and refrain from using dirty tricks, like calling internal commands of
-\Package{scrpage2} directly, it should be easy for you to use
-\Package{scrlayer-scrpage} as a drop-in replacement. Most examples covering
-\Package{scrpage2} in \LaTeX{} books or online resources should also work
-with \Package{scrlayer-scrpage} either directly or with only minor
-code changes provided that they stick to the standard interfaces.
-
-Apart from the aforementioned \KOMAScript{} packages, you could in principle
-also use \Package{fancyhdr}\IndexPackage{fancyhdr} (see
-\cite{package:fancyhdr}) in conjunction with a \KOMAScript{} class. However,
-\Package{fancyhdr}\ has no support for several \KOMAScript{} features, e.\,g.,
-the element scheme (see \DescRef{\LabelBase.cmd.setkomafont},
+\begin{Explain}
+ Until version 3.11b of \KOMAScript, the \Package{scrpage2}%
+ \IndexPackage[indexmain]{scrpage2}\important{\Package{scrpage2}} package was
+ the recommended way to customise headers and footers beyond the options
+ provided by the \PageStyle{headings}, \PageStyle{myheadings},
+ \PageStyle{plain}, and \PageStyle{empty} page styles of the \KOMAScript{}
+ classes.
+ \iffalse%
+ The still older \Package{scrpage}\IndexPackage{scrpage} package was marked
+ obsolete in 2001 and removed from the regular \KOMAScript{} distribution in
+ 2013.\par
+ \fi%
+ Since 2013, the \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ \important{\hyperref[cha:scrlayer]{\Package{scrlayer}}}%
+ \IndexPackage{scrlayer} package has been included as a basic module of
+ \KOMAScript. This package provides a layer model and a new page-style model
+ based upon it. However, the package's interface is almost too flexible and
+ consequently not easy for the average user to comprehend. For more
+ information about this interface, see \autoref{cha:scrlayer} in
+ \autoref{part:forExperts}. However, a few of the options that are actually
+ part of \Package{scrlayer}, and which are therefore taken up again in that
+ chapter, are also documented here because they are required to use
+ \Package{scrlayer-scrpage}.
+
+ Many users are already familiar with the commands from \Package{scrpage2}.
+ For this reason, \Package{scrlayer-scrpage} provides a method for
+ manipulating headers and footers which is based on \Package{scrlayer}, is
+ largely compatible with \Package{scrpage2}, and at the same time greatly
+ expands the user interface. If you are already familiar with
+ \Package{scrpage2} and refrain from direct calls to its internal commands,
+ you can usually use \Package{scrlayer-scrpage} as a drop-in replacement.
+ This also applies to most examples using \Package{scrpage2} found in
+ \LaTeX{} books or on the Internet.%
+ \iffalse%
+ \iffree{}{\par With the release of this book, \Package{scrlayer-scrpage}
+ for \KOMAScript{} is recommended as the tool of choice when it comes to
+ changing the predefined page styles. Using the obsolete package
+ \Package{scrpage2}\IndexPackage[indexmain]{scrpage2}%
+ \important{\Package{scrpage2}} is now deprecated. Therefore, the
+ commands for this outdated package are no longer part of this book. If
+ you encounter older documents that still use \Package{scrpage2},
+ consider switching to \Package{scrlayer-scrpage}. Notwithstanding, this
+ chapter does contain some hints for using \Package{scrpage2}.}%
+ \fi
+\end{Explain}
+
+In addition to \Package{scrlayer-scrpage}\iffree{ or \Package{scrpage2}}{},
+you could also use \Package{fancyhdr}\IndexPackage{fancyhdr} (see
+\cite{package:fancyhdr}) to configure the headers and footers of pages.
+However, this package has no support for several \KOMAScript{} features,
+for example the element scheme (see \DescRef{\LabelBase.cmd.setkomafont},
\DescRef{\LabelBase.cmd.addtokomafont}, and
-\DescRef{\LabelBase.cmd.usekomafont} in \autoref{sec:maincls.textmarkup}, from
+\DescRef{\LabelBase.cmd.usekomafont} in \autoref{sec:maincls.textmarkup},
\DescPageRef{maincls.cmd.setkomafont}) or the configurable numbering format
-for dynamic headers (see option \DescRef{maincls.option.numbers} and, e.\,g.,
-\DescRef{\LabelBase.cmd.chaptermarkformat} in \autoref{sec:maincls.structure},
-\DescPageRef{maincls.option.numbers} and
+for dynamic headers (see the \DescRef{maincls.option.numbers} option and,
+for example, \DescRef{\LabelBase.cmd.chaptermarkformat} in
+\autoref{sec:maincls.structure}, \DescPageRef{maincls.option.numbers} and
\DescPageRef{maincls.cmd.chaptermarkformat}). Hence, if you are using a
-\KOMAScript{} class, the usage of package \Package{scrlayer-scrpage} is
-recommended. Of course you can use \Package{scrlayer-scrpage} with other
-classes, namely the \LaTeX{} standard classes, too.
-
-Besides the features described in this chapter, \Package{scrlayer-scrpage}
-provides several more that are likely only of minor interest to the average
-user and for this reason are described from
-\autopageref{cha:scrlayer-scrpage-experts} onwards in
-\autoref{cha:scrlayer-scrpage-experts} of \autoref{part:forExperts}.
-Nevertheless, should the options described in \autoref{part:forAuthors} be
-insufficient for your purposes you are encouraged to examine
-\autoref{cha:scrlayer-scrpage-experts}.
+\KOMAScript{} class, you should use the new \Package{scrlayer-scrpage}
+package. \iffree{If you have problems, you can still use
+\Package{scrpage2}.}{\ignorespaces} Of course, you can also use
+\Package{scrlayer-scrpage} with other classes, such as the standard \LaTeX{}
+ones.
+
+Apart from the features described in this chapter, \Package{scrlayer-scrpage}
+provides several more functions that are likely only of interest to a very
+small number of users and therefore are described in
+\autoref{cha:scrlayer-scrpage-experts} of \autoref{part:forExperts}, starting
+at \autopageref{cha:scrlayer-scrpage-experts}. Nevertheless, if the options
+described in \autoref{part:forAuthors} are insufficient for your purposes, you
+should examine \autoref{cha:scrlayer-scrpage-experts}.
\LoadCommonFile{options} % \section{Early or late Selection of Options}
-\LoadCommonFile{headfootheight} % \section{Head and Foot Width}
+\LoadCommonFile{headfootheight} % \section{Header and Footer Height}
\LoadCommonFile{textmarkup} % \section{Text Markup}
-\section{Usage of Predefined Page Styles}
+\section{Using Predefined Page Styles}
\seclabel{predefined.pagestyles}
-The easiest way to your desired design for page header and footer with
+The easiest way to create custom headers and footers with
\Package{scrlayer-scrpage} is to use one of the predefined page styles.
+%
+\iffalse % Umbruchoptimierung
+ This section introduces the page styles defined by the
+ \Package{scrlayer-scrpage} package as it loads. It also explains the
+ commands that you can use to create basic settings for these page
+ styles. You can find further options, commands, and background information
+ in the following sections and in
+ \autoref{sec:scrlayer-scrpage-experts.pagestyle.pairs} in
+ \autoref{part:forExperts}.%
+\fi
\begin{Declaration}
\PageStyle{scrheadings}%
\PageStyle{plain.scrheadings}
\end{Declaration}
-Package \Package{scrlayer-scrpage} provides two page styles, which may be
-reconfigured to meet your individual reqirements. Let's first of all discuss
-page style \PageStyle{scrheadings} which has been designed as a style using
-running heads. Its defaults are similar to the page style
-\PageStyle{headings}\IndexPagestyle{headings} of the \LaTeX standard classes
-or the \KOMAScript{} classes. What exactly gets printed in the header or
-footer can be configured via the commands and otions described hereafter.
-
-The second page style to be mentioned here is \PageStyle{plain.scrheadings},
-which has been designed to be a style with no running head. Its defaults are
-very similar to page style \PageStyle{plain}\IndexPagestyle{plain} of \LaTeX's
-standard classes or the \KOMAScript{} classes. The following will describe the
-commands and options you may use to adjust the contents of the header and
-footer .
-
-You could of course configure \PageStyle{scrheadings} to be a page style
+The \Package{scrlayer-scrpage} package provides two page styles that you can
+reconfigure to your liking. The first page style is
+\PageStyle{scrheadings}\important{\PageStyle{scrheadings}}, which is intended
+as a page style with running heads. Its defaults are similar to the page style
+\PageStyle{headings}\IndexPagestyle{headings} of the standard \LaTeX{} or
+\KOMAScript{} classes. You can configure exactly what appears in the header or
+footer with the commands and options described below.
+
+The second page style is \PageStyle{plain.scrheadings}%
+\important{\PageStyle{plain.scrheadings}}, which is intended to be a style
+with no running head. Its defaults resemble those of the
+\PageStyle{plain}\IndexPagestyle{plain} page style of the standard or
+\KOMAScript{} classes. You can configure exactly what appears in the header or
+footer with the commands and options described below.
+
+You could, of course, configure \PageStyle{scrheadings} to be a page style
without a running head and \PageStyle{plain.scrheadings} to be a page style
-using running heads. It is, however, far more expedient to adhere to the
-conventions mentioned above, if for the only reason that both page styles
-mutually influence one another. Once you have opted to apply one of these
-page styles, \PageStyle{scrheadings} will become accessible as
-\PageStyle{headings} and the page style \PageStyle{plain.scrheadings} will
-become accessible as \PageStyle{plain}. Thus, if you use a class or package
-that automatically switches between \PageStyle{headings} and
-\PageStyle{plain}, you only need to select \PageStyle{scrheadings} or
-\PageStyle{plain.scrheadings} once and the switching class or package will
-then switch between \PageStyle{scrheadings} and \PageStyle{plain.scrheadings}
-without even being aware of these page styles. Patches or other adaptions of
-classes (or packages) will not be necessary. This pair of page styles may thus
-serve as a drop-in replacement for \PageStyle{headings} and \PageStyle{plain}.
-Should additional similar pairs be required I'd like to point you to
-\autoref{sec:scrlayer-scrpage-experts.pagestyle.pairs} in
-\autoref{part:forExperts} for further reference.
-
-For users of the older \Package{scrpage2}, I'd like to mention that, for
-compatibility with \Package{scrpage2}, page style
-\PageStyle{plain.scrheadings} may also be used under its alias name of
-\PageStyle{scrplain}\IndexPagestyle[indexmain]{scrplain}.%
-\iffree{}{ If you use \Package{scrpage2}\IndexPackage{scrpage2}, however,
- \PageStyle{plain.scrheadings} will not be available. Its function is
- completely taken over by pagestyle \PageStyle{scrplain}.}
-%
+with a running head. It is, however, advisable to adhere to the conventions
+mentioned above. The two page styles mutually influence one another. Once you
+apply one of these page styles, \PageStyle{scrheadings} will become accessible
+as \PageStyle{headings}\important{\PageStyle{headings}}%
+\IndexPagestyle{headings} and the page style \PageStyle{plain.scrheadings}
+will become accessible as \PageStyle{plain}\important{\PageStyle{plain}}%
+\IndexPagestyle{plain}. Thus, if you use a class or package that automatically
+switches between \PageStyle{headings} and \PageStyle{plain}, you only need to
+select \PageStyle{scrheadings} or \PageStyle{plain.scrheadings} once. Direct
+patches to the corresponding classes or packages are not necessary. This pair
+of page styles can thus serve as a drop-in replacement for
+\PageStyle{headings} and \PageStyle{plain}. If you need more such pairs,
+please refer to \autoref{sec:scrlayer-scrpage-experts.pagestyle.pairs} in
+\autoref{part:forExperts}.%
\EndIndexGroup
\begin{Declaration}
- \Macro{lehead}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{cehead}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{rehead}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{lohead}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{cohead}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{rohead}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}
+ \Macro{lehead}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{cehead}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{rehead}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{lohead}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{cohead}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{rohead}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}
\end{Declaration}
-The contents of the header of page style \PageStyle{plain.scrheadings} and
-\PageStyle{scrheadings} can be defined using these commands. Thereby the
-optional argument defines the content of an element of page style
-\PageStyle{plain.scrheadings}, while the mandatory argument sets the content
-of the corresponding element of page style \PageStyle{scrheadings}.
-
-Contents of left\,---\,so called even\,---\,pages can be set with
-\Macro{lehead}, \Macro{cehead}, and \Macro{rohead}. Remark: The ``\texttt{e}''
-at the second position of the commands' names means ``\emph{even}''.
-
-Contents of right\,---\,so called odd\,---\,pages can be set with
-\Macro{lohead}, \Macro{cohead}, and \Macro{rohead}. Remark: The ``\texttt{o}''
-at the second position of the commands' names means ``\emph{odd}''.
-
-Please note\textnote{Attention!} that there are only odd pages within single
-side layouts independent of whether or not they have an odd page number.
-
-Each header consists of a left aligned element that will be defined by
-\Macro{lehead} respectively \Macro{lohead}. Remark: The ``\texttt{l}'' at the
-first position of the commands' names means ``\emph{left aligned}''.
-
-Similarly each header has a centred element that will be defined by
-\Macro{cehead} respectively \Macro{cohead}. Remark: The ``\texttt{c}'' at the
-first position of the command' names means ``\emph{centred}''.
-
-Similarly each header has a right aligned element that will be defined by
-\Macro{rehead} respectively \Macro{rohead}. Remark: The ``\texttt{r}'' at the
-first position of the commands' names means ``\emph{right aligned}''.
+You can set the contents of the header for the
+\DescRef{\LabelBase.pagestyle.plain.scrheadings} and
+\DescRef{\LabelBase.pagestyle.scrheadings} page styles with these commands.
+The optional argument sets the content of an element of the
+\DescRef{\LabelBase.pagestyle.plain.scrheadings} page style, while the
+mandatory argument sets the content of the corresponding element of the
+\DescRef{\LabelBase.pagestyle.scrheadings} page style.
+
+The contents of even\,---\,or left-hand\,---\,pages\textnote{left-hand pages}
+can be set with \Macro{lehead}, \Macro{cehead}, and \Macro{rehead}. The
+``\texttt{e}'' appearing as the second letter of the commands' names stands
+for ``\emph{even}''.
+
+The contents of odd\,---\,or right-hand\,---\,pages\textnote{right-hand pages}
+can be set with \Macro{lohead}, \Macro{cohead}, and \Macro{rohead}. The
+``\texttt{o}'' appearing as the second letter of the commands' names stands
+for ``\emph{odd}''.
+
+Note\textnote{Attention!} that in one-sided printing, only right-hand pages
+exist, and \LaTeX{} designates these as odd pages regardless of their page
+number.
+
+Each header consists of a left-aligned\textnote{left aligned} element that can
+be set with \Macro{lehead} or \Macro{lohead}. The ``\texttt{l}'' appearing as
+the first letter of the commands' names stands for ``\emph{left aligned}''.
+
+Similarly, each header has a centred\textnote{centred} element that can be set
+with \Macro{cehead} or \Macro{cohead}. The ``\texttt{c}'' appearing as the
+first letter of the command' names stands for ``\emph{centred}''.
+
+Likewise, each header has a right-aligned\textnote{right aligned} element that
+can be set with \Macro{rehead} or \Macro{rohead}. The ``\texttt{r}'' appearing
+as the first letter of the commands' names stands for ``\emph{right
+aligned}''.
+\BeginIndexGroup
\BeginIndex{FontElement}{pagehead}\LabelFontElement{pagehead}%
\BeginIndex{FontElement}{pageheadfoot}\LabelFontElement{pageheadfoot}%
-However, these elements do not have their own font attributes that may be
-changed using commands \DescRef{\LabelBase.cmd.setkomafont} and
+These elements do not have individual font attributes that you can
+change using the commands \DescRef{\LabelBase.cmd.setkomafont} and
\DescRef{\LabelBase.cmd.addtokomafont} (see \autoref{sec:maincls.textmarkup},
-\DescPageRef{maincls.cmd.setkomafont}), but are grouped in an element named
-\FontElement{pagehead}. And before the font of that element additionally the
-font of element \FontElement{pageheadfoot} will be used. See
-\autoref{tab:scrlayer-scrpage.fontelements} for the font default of these
+\DescPageRef{maincls.cmd.setkomafont}). Instead, they use an element named
+\FontElement{pagehead}. Before this element is applied, the
+\FontElement{pageheadfoot} element will also be applied. See
+\autoref{tab:scrlayer-scrpage.fontelements} for the defaults of these
elements.%
-\EndIndex{FontElement}{pageheadfoot}%
-\EndIndex{FontElement}{pagehead}%
+\EndIndexGroup
-The semantics of the described commands within two-sided layouts are also
-sketched in \autoref{fig:scrlayer-scrpage.head}.%
+The meaning of each command for headers in two-sided printing is illustrated
+in \autoref{fig:scrlayer-scrpage.head}.%
%
\begin{figure}[tp]
\centering
@@ -242,7 +265,7 @@ sketched in \autoref{fig:scrlayer-scrpage.head}.%
\multiput(0,0)(0,-1mm){10}{\line(0,-1){.5mm}}%
\put(.49\textwidth,5mm){\line(0,1){15mm}}%
\put(.05\textwidth,10mm){%
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(-.5em,0){\line(1,0){4em}}%
\multiput(3.5em,0)(.25em,0){5}{\line(1,0){.125em}}%
\put(-.5em,0){\line(0,1){\baselineskip}}%
@@ -251,7 +274,7 @@ sketched in \autoref{fig:scrlayer-scrpage.head}.%
\makebox(4em,5mm)[l]{\Macro{lehead}}%
}%
\put(.465\textwidth,10mm){%
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(-4em,0){\line(1,0){4em}}%
\multiput(-4em,0)(-.25em,0){5}{\line(1,0){.125em}}%
\put(0,0){\line(0,1){\baselineskip}}%
@@ -260,7 +283,7 @@ sketched in \autoref{fig:scrlayer-scrpage.head}.%
\put(-4.5em,0){\makebox(4em,5mm)[r]{\Macro{rehead}}}%
}%
\put(.2525\textwidth,10mm){%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(-2em,0){\line(1,0){4em}}%
\multiput(2em,0)(.25em,0){5}{\line(1,0){.125em}}%
\multiput(-2em,0)(-.25em,0){5}{\line(1,0){.125em}}%
@@ -275,7 +298,7 @@ sketched in \autoref{fig:scrlayer-scrpage.head}.%
\put(\textwidth,0){\line(0,1){20mm}}%
\multiput(\textwidth,0)(0,-1mm){10}{\line(0,-1){.5mm}}%
\put(.5325\textwidth,10mm){%
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(0,0){\line(1,0){4em}}%
\multiput(4em,0)(.25em,0){5}{\line(1,0){.125em}}%
\put(0,0){\line(0,1){\baselineskip}}%
@@ -284,7 +307,7 @@ sketched in \autoref{fig:scrlayer-scrpage.head}.%
\put(.5em,0){\makebox(4em,5mm)[l]{\Macro{lohead}}}%
}%
\put(.965\textwidth,10mm){%
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(-4em,0){\line(1,0){4em}}%
\multiput(-4em,0)(-.25em,0){5}{\line(1,0){.125em}}%
\put(0,0){\line(0,1){\baselineskip}}%
@@ -293,7 +316,7 @@ sketched in \autoref{fig:scrlayer-scrpage.head}.%
\put(-4.5em,0){\makebox(4em,5mm)[r]{\Macro{rohead}}}%
}%
\put(.75\textwidth,10mm){%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(-2em,0){\line(1,0){4em}}%
\multiput(2em,0)(.25em,0){5}{\line(1,0){.125em}}%
\multiput(-2em,0)(-.25em,0){5}{\line(1,0){.125em}}%
@@ -303,53 +326,53 @@ sketched in \autoref{fig:scrlayer-scrpage.head}.%
\put(-2em,0){\makebox(4em,5mm)[c]{\Macro{cohead}}}%
}%
% commands for both pages
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(.5\textwidth,0){\makebox(0,\baselineskip)[c]{\Macro{ihead}}}%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(.5\textwidth,-5mm){\makebox(0,\baselineskip)[c]{\Macro{chead}}}
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(.5\textwidth,-10mm){\makebox(0,\baselineskip)[c]{\Macro{ohead}}}
\put(\dimexpr.5\textwidth-2em,.5\baselineskip){%
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(0,0){\line(-1,0){1.5em}}%
\put(-1.5em,0){\vector(0,1){5mm}}%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(0,-1.25\baselineskip){\line(-1,0){\dimexpr .25\textwidth-2em\relax}}%
\put(-\dimexpr
.25\textwidth-2em\relax,-1.25\baselineskip){\vector(0,1){\dimexpr
5mm+1.25\baselineskip\relax}}
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(0,-2.5\baselineskip){\line(-1,0){\dimexpr .45\textwidth-4em\relax}}%
\put(-\dimexpr
.45\textwidth-4em\relax,-2.5\baselineskip){\vector(0,1){\dimexpr
5mm+2.5\baselineskip\relax}}
}%
\put(\dimexpr.5\textwidth+2em,.5\baselineskip){%
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(0,0){\line(1,0){1.5em}}%
\put(1.5em,0){\vector(0,1){5mm}}%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(0,-1.25\baselineskip){\line(1,0){\dimexpr .25\textwidth-2em\relax}}
\put(\dimexpr
.25\textwidth-2em\relax,-1.25\baselineskip){\vector(0,1){\dimexpr
5mm+1.25\baselineskip\relax}}
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(0,-2.5\baselineskip){\line(1,0){\dimexpr .45\textwidth-4em\relax}}
\put(\dimexpr
.45\textwidth-4em\relax,-2.5\baselineskip){\vector(0,1){\dimexpr
5mm+2.5\baselineskip\relax}}
}%
\end{picture}
- \caption[Commands to define the page head]%
- {The meaning of the commands to define the contents of the page head
- of the page styles sketched on a schematic double page}
+ \caption[Commands for setting the page header]%
+ {The meaning of the commands for setting the contents of page headers
+ shown on a two-page schematic}
\label{fig:scrlayer-scrpage.head}
\end{figure}
%
\begin{Example}
- Assume you're writing a short article and you want the title of that
- article to be shown left aligned and the author's name to be
- shown right aligned at the page head. You may for example use:
+ Suppose you're writing a short article and you want the author's name to
+ appear on the left side of the page and the article's title to appear
+ right. You can write, for example:
\begin{lstcode}
\documentclass{scrartcl}
\usepackage{scrlayer-scrpage}
@@ -362,29 +385,30 @@ sketched in \autoref{fig:scrlayer-scrpage.head}.%
\maketitle
\end{document}
\end{lstcode}
- But what happens: On the first page there's only a page number at the page
- foot, but the header is empty!
+ But what happens? On the first page there's only a page number in the
+ footer, while the header remains empty!
- The explanation is very easy. Document class \Class{scrartcl} switches to
- page style \PageStyle{plain} for the page with the title head. After command
+ The explanation is simple: The \Class{scrartcl} class, like the default
+ \Class{article} class, switches to the \PageStyle{plain} page style for the
+ page which contains the title. After the command
\DescRef{maincls.cmd.pagestyle}\PParameter{scrheadings} in the preamble of
- the short document this will actually result in page style
- \PageStyle{plain.scrheadings}. Using a \KOMAScript{} class the default of
- this page style is an empty page header and a page number in the footer. In
- the example code the optional arguments of \Macro{lohead} and \Macro{rohead}
- are omitted. So page style \PageStyle{plain.scrheadings} remains unchanged
- as default and the result for the first page is indeed correct.
-
- Please add some text below \DescRef{maincls.cmd.maketitle} until a second
- page will be printed. Alternatively you may just add
- \Macro{usepackage}\PParameter{lipsum}\IndexPackage{lipsum} into the document
+ our example, this actually refers to the
+ \DescRef{\LabelBase.pagestyle.plain.scrheadings} page style. The default for
+ this page style when using a \KOMAScript{} class is an empty page header and
+ a page number in the footer. In the example, the optional arguments of
+ \Macro{lohead} and \Macro{rohead} are omitted, so the
+ \DescRef{\LabelBase.pagestyle.plain.scrheadings} page style remains
+ unchanged and the result for the first page is actually correct.
+
+ Now add enough text to the example after \DescRef{maincls.cmd.maketitle}
+ so that a second page is printed. You can simply add
+ \Macro{usepackage}\PParameter{lipsum}\IndexPackage{lipsum} to the document
preamble and \Macro{lipsum}\IndexCmd{lipsum} below
- \DescRef{maincls.cmd.maketitle}. You will see that the head of the second
- page will show the author and the document title as we wanted.
+ \DescRef{maincls.cmd.maketitle}. You will see that the header of the second
+ page now contains the author and the document title as we wanted.
- To see the difference you should also add an optional argument to
- \Macro{lohead} and \Macro{rohead} containing some content. To do so, change
- the example above:
+ For comparison, you should also add the optional argument to
+ \Macro{lohead} and \Macro{rohead}. Change the example as follows:
\begin{lstcode}
\documentclass{scrartcl}
\usepackage{scrlayer-scrpage}
@@ -399,48 +423,56 @@ sketched in \autoref{fig:scrlayer-scrpage.head}.%
\maketitle
\end{document}
\end{lstcode}
- Now, you also get a page header above the title head of the first
- page. That is because you have reconfigured page style
- \PageStyle{plain.scrheadings} with the two optional arguments. Most of you
- will also recognise that it would be better to leave this page style
- unchanged, because the running head above the document title is certainly
+ Now you have a header on the first page just above the title itself.
+ That is because you have reconfigured page style
+ \DescRef{\LabelBase.pagestyle.plain.scrheadings} with the two optional
+ arguments. As you probably appreciate, it would be better to leave this page
+ style unchanged, as a running head above the document title is rather
annoying.
+
+ By the way, as an alternative to configuring
+ \DescRef{\LabelBase.pagestyle.plain.scrheadings} you could, if you were
+ using a \KOMAScript{} class, have changed the page style for pages that
+ contain title headers. See \DescRef{maincls.cmd.titlepagestyle}%
+ \important{\DescRef{maincls.cmd.titlepagestyle}}%
+ \IndexCmd{titlepagestyle} in \autoref{sec:maincls.pagestyle},
+ \DescPageRef{maincls.cmd.titlepagestyle}.
\end{Example}
-Allow me an important note:\textnote{Attention!} You should never put a
-section heading or section number directly into the page head using a new
-declaration by one of these commands. This could result in a wrong number or
-heading text in the running head, because of the asynchronous page generation
-and output of \TeX. Instead you should use the mark mechanism and ideally you
-should use it together with the automatism described in the following
-section.%
+Note\textnote{Attention!} that you should never put a section
+heading or section number directly into the header using one of these
+commands. Because of the asynchronous way that \TeX{} lays out and outputs
+pages, doing so can easily result in the wrong number or heading text in the
+running head. Instead you should use the mark mechanism, ideally in
+conjunction with the procedures explained in the next section.%
\EndIndexGroup
\begin{Declaration}
- \Macro{lehead*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{cehead*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{rehead*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{lohead*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{cohead*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{rohead*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}
+ \Macro{lehead*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{cehead*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{rehead*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{lohead*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{cohead*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{rohead*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}
\end{Declaration}
-The previously described commands have also a version with
-star\ChangedAt{v3.14}{\Package{scrlayer-scrpage}} that differs only if you
-omit the optional argument \PName{plain.scrheadings's content}. In this case
-the version without star does not change the content of
-\PageStyle{plain.scrheadings}. The version with star on the other hand uses
-the obligatory argument \PName{scrheading's content} also as default for
-\PageStyle{plain.scrheadings}. So, if both arguments should be the same, you
-can simply use the star version with the obligatory argument only.%
+The starred versions\ChangedAt{v3.14}{\Package{scrlayer-scrpage}} of the
+previously described commands differ from the ordinary versions only if you
+omit the optional argument \PName{plain.scrheadings content}. In this case,
+the version without the star does not change the contents of
+\DescRef{\LabelBase.pagestyle.plain.scrheadings}. The starred version, on the
+other hand, uses the mandatory argument \PName{scrheading content}
+for \DescRef{\LabelBase.pagestyle.plain.scrheadings} as well. So if both
+arguments should be the same, you can simply use the starred version with only
+the mandatory argument.%
\begin{Example}
- You can shorten the previous example using the star version of
+ You can shorten the previous example using the starred versions of
\DescRef{\LabelBase.cmd.lohead} and \DescRef{\LabelBase.cmd.rohead}:
\begin{lstcode}
\documentclass{scrartcl}
@@ -453,73 +485,76 @@ can simply use the star version with the obligatory argument only.%
\author{John Doe}
\maketitle
\end{document}
-\end{lstcode}
-\end{Example}
-
-The obsolete package \Package{scrpage2}\important{\Package{scrpage2}} does not
-provide this feature.%
-%
+\end{lstcode}%
+\end{Example}%
\EndIndexGroup
\begin{Declaration}
- \Macro{lefoot}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{cefoot}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{refoot}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{lofoot}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{cofoot}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{rofoot}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}
+ \Macro{lefoot}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{cefoot}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{refoot}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{lofoot}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{cofoot}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{rofoot}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}
\end{Declaration}
-The contents of the footer of page style \PageStyle{plain.scrheadings} and
-\PageStyle{scrheadings} can be defined using these commands. Thereby the
-optional argument defines the content of an element of page style
-\PageStyle{plain.scrheadings}, while the mandatory argument sets the content
-of the corresponding element of page style \PageStyle{scrheadings}.
-
-Contents of left\,---\,so called even\,---\,pages can be set with
-\Macro{lefoot}, \Macro{cefoot}, and \Macro{rohead}. Remark: The ``\texttt{e}''
-at the second position of the commands' names means ``\emph{even}''.
-
-Contents of odd pages can be set with \Macro{lofoot}, \Macro{cofoot}, and
-\Macro{rofoot}. Remark: The ``\texttt{o}'' at the second position of the
-commands' names means ``\emph{odd}''.
-
-Please note\textnote{Attention!} that there are only odd pages within single
-side layouts independent of whether or not they have an odd page number.
-
-Each footer consists of a left aligned element that will be defined by
-\Macro{lefoot} respectively \Macro{lofoot}. Remark: The ``\texttt{l}'' at the
-first position of the commands' names means ``\emph{left aligned}''.
-
-Similarly each footer has a centred element that will be defined by
-\Macro{cefoot} respectively \Macro{cofoot}. Remark: The ``\texttt{c}'' at the
-first position of the command' names means ``\emph{centred}''.
-
-Similarly each footer has a right aligned element that will be defined by
-\Macro{refoot} respectively \Macro{rofoot}. Remark: The ``\texttt{r}'' at the
-first position of the commands' names means ``\emph{right aligned}''.
+You can define the contents of the footer for
+\DescRef{\LabelBase.pagestyle.scrheadings} and
+\DescRef{\LabelBase.pagestyle.plain.scrheadings} with these commands. The
+optional argument defines the content of an element of
+\DescRef{\LabelBase.pagestyle.plain.scrheadings}, while the mandatory argument
+sets the content of the corresponding element of
+\DescRef{\LabelBase.pagestyle.scrheadings}.
+
+The contents of even\,---\,or left-hand\,---\,pages\textnote{left-hand page}
+are set with \Macro{lefoot}, \Macro{cefoot}, and \Macro{refoot}. The
+``\texttt{e}'' appearing as the second letter of the commands' names stands
+for ``\emph{even}''.
+
+The contents of odd\,---\,or right-hand\,---\,pages\textnote{right-hand page}
+are set with \Macro{lofoot}, \Macro{cofoot}, and \Macro{rofoot}. The
+``\texttt{o}'' appearing as the second letter of the commands' names stands
+for ``\emph{odd}''.
+
+Note\textnote{Attention!} that in one-sided printing, only right-hand pages
+exist, and \LaTeX{} designates these as odd pages regardless of their page
+number.
+
+Each footer consists of a left-aligned\textnote{left aligned} element that can
+be set with \Macro{lefoot} or \Macro{lofoot}. The ``\texttt{l}'' appearing as
+the first letter of the commands' names stands for ``\emph{left aligned}''.
+
+Similarly, each footer has a centred\textnote{centred} element that can be set
+with \Macro{cefoot} or \Macro{cofoot}. The ``\texttt{c}'' in the first letter
+of the command' names stands for ``\emph{centred}''.
+
+Likewise, each footer has a right-aligned\textnote{right aligned} element that
+can be set with \Macro{refoot} or \Macro{rofoot}. The ``\texttt{r}'' in the
+first letter of the commands' names stands for ``\emph{right aligned}''.
+\BeginIndexGroup
\BeginIndex{FontElement}{pagefoot}\LabelFontElement{pagefoot}%
\BeginIndex{FontElement}{pageheadfoot}\LabelFontElement[foot]{pageheadfoot}%
-However, these elements do not have their own font attributes that may be
-changed using commands \DescRef{\LabelBase.cmd.setkomafont} and
-\DescRef{\LabelBase.cmd.addtokomafont} (see \autoref{sec:maincls.textmarkup},
-\DescPageRef{maincls.cmd.setkomafont}), but are grouped in an element named
-\FontElement{pagefoot}. And before the font of that element additionally the
-font of element \FontElement{pageheadfoot} will be used. See
-\autoref{tab:scrlayer-scrpage.fontelements} for the defaults of the fonts of
-these elements.%
-\EndIndex{FontElement}{pageheadfoot}%
-\EndIndex{FontElement}{pagefoot}%
-
-The semantics of the described commands within two-sided layouts are also
-sketched in \autoref{fig:scrlayer-scrpage.foot}.%
+However, these elements do not have individual font attributes that can be
+changed with the \DescRef{\LabelBase.cmd.setkomafont} and
+\DescRef{\LabelBase.cmd.addtokomafont} commands (see
+\autoref{sec:maincls.textmarkup}, \DescPageRef{maincls.cmd.setkomafont}).
+Instead, they use an element named
+\FontElement{pagefoot}\important{\FontElement{pagefoot}}. Before this element
+is applied, the font element
+\FontElement{pageheadfoot}\important{\FontElement{pageheadfoot}} is also
+applied. See \autoref{tab:scrlayer-scrpage.fontelements} for the defaults of
+the fonts of these elements.%
+\EndIndexGroup
+
+The meaning of each command for footers in two-sided printing is illustrated
+in \autoref{fig:scrlayer-scrpage.foot}.%
%
\begin{figure}[bp]
\centering
@@ -532,7 +567,7 @@ sketched in \autoref{fig:scrlayer-scrpage.foot}.%
\multiput(0,20mm)(0,1mm){10}{\line(0,1){.5mm}}%
\put(.49\textwidth,0){\line(0,1){15mm}}%
\put(.05\textwidth,5mm){%
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(-.5em,0){\line(1,0){4em}}%
\multiput(3.5em,0)(.25em,0){5}{\line(1,0){.125em}}%
\put(-.5em,0){\line(0,1){\baselineskip}}%
@@ -541,7 +576,7 @@ sketched in \autoref{fig:scrlayer-scrpage.foot}.%
\makebox(4em,5mm)[l]{\Macro{lefoot}}%
}%
\put(.465\textwidth,5mm){%
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(-4em,0){\line(1,0){4em}}%
\multiput(-4em,0)(-.25em,0){5}{\line(1,0){.125em}}%
\put(0,0){\line(0,1){\baselineskip}}%
@@ -550,7 +585,7 @@ sketched in \autoref{fig:scrlayer-scrpage.foot}.%
\put(-4.5em,0){\makebox(4em,5mm)[r]{\Macro{refoot}}}%
}%
\put(.2525\textwidth,5mm){%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(-2em,0){\line(1,0){4em}}%
\multiput(2em,0)(.25em,0){5}{\line(1,0){.125em}}%
\multiput(-2em,0)(-.25em,0){5}{\line(1,0){.125em}}%
@@ -565,7 +600,7 @@ sketched in \autoref{fig:scrlayer-scrpage.foot}.%
\put(\textwidth,0){\line(0,1){20mm}}%
\multiput(\textwidth,20mm)(0,1mm){10}{\line(0,1){.5mm}}%
\put(.5325\textwidth,5mm){%
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(0,0){\line(1,0){4em}}%
\multiput(4em,0)(.25em,0){5}{\line(1,0){.125em}}%
\put(0,0){\line(0,1){\baselineskip}}%
@@ -574,7 +609,7 @@ sketched in \autoref{fig:scrlayer-scrpage.foot}.%
\put(.5em,0){\makebox(4em,5mm)[l]{\Macro{lofoot}}}%
}%
\put(.965\textwidth,5mm){%
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(-4em,0){\line(1,0){4em}}%
\multiput(-4em,0)(-.25em,0){5}{\line(1,0){.125em}}%
\put(0,0){\line(0,1){\baselineskip}}%
@@ -583,7 +618,7 @@ sketched in \autoref{fig:scrlayer-scrpage.foot}.%
\put(-4.5em,0){\makebox(4em,5mm)[r]{\Macro{rofoot}}}%
}%
\put(.75\textwidth,5mm){%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(-2em,0){\line(1,0){4em}}%
\multiput(2em,0)(.25em,0){5}{\line(1,0){.125em}}%
\multiput(-2em,0)(-.25em,0){5}{\line(1,0){.125em}}%
@@ -593,45 +628,45 @@ sketched in \autoref{fig:scrlayer-scrpage.foot}.%
\put(-2em,0){\makebox(4em,5mm)[c]{\Macro{cofoot}}}%
}%
% both pages
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(.5\textwidth,15mm){\makebox(0,\baselineskip)[c]{\Macro{ifoot}}}%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(.5\textwidth,20mm){\makebox(0,\baselineskip)[c]{\Macro{cfoot}}}
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(.5\textwidth,25mm){\makebox(0,\baselineskip)[c]{\Macro{ofoot}}}
\put(\dimexpr.5\textwidth-2em,.5\baselineskip){%
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(0,15mm){\line(-1,0){1.5em}}%
\put(-1.5em,15mm){\vector(0,-1){5mm}}%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(0,20mm){\line(-1,0){\dimexpr .25\textwidth-2em\relax}}%
\put(-\dimexpr .25\textwidth-2em\relax,20mm){\vector(0,-1){10mm}}%
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(0,25mm){\line(-1,0){\dimexpr .45\textwidth-4em\relax}}%
\put(-\dimexpr .45\textwidth-4em\relax,25mm){\vector(0,-1){15mm}}%
}%
\put(\dimexpr.5\textwidth+2em,.5\baselineskip){%
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(0,15mm){\line(1,0){1.5em}}%
\put(1.5em,15mm){\vector(0,-1){5mm}}%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(0,20mm){\line(1,0){\dimexpr .25\textwidth-2em\relax}}%
\put(\dimexpr .25\textwidth-2em\relax,20mm){\vector(0,-1){10mm}}%
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(0,25mm){\line(1,0){\dimexpr .45\textwidth-4em\relax}}%
\put(\dimexpr .45\textwidth-4em\relax,25mm){\vector(0,-1){15mm}}%
}%
\end{picture}
- \caption[Commands to define the page footer]%
- {The meaning of the commands to define the contents of the page
- footer of the page styles sketched on a schematic double page}%
+ \caption[Commands for setting the page footer]%
+ {The meaning of the commands for setting the contents of page
+ footers shown on a two-page schematic}%
\label{fig:scrlayer-scrpage.foot}
\end{figure}
%
\begin{Example}
- Let's return to the example of the short article. Assuming you want to print
- the publisher at the left side of the page footer, you would change the
- example above into:
+ Let's return to the example of the short article. Let's say you want to
+ specify the publisher in the left side of the footer. You would change the
+ example above to:
\begin{lstcode}
\documentclass{scrartcl}
\usepackage{scrlayer-scrpage}
@@ -647,49 +682,51 @@ sketched in \autoref{fig:scrlayer-scrpage.foot}.%
\lipsum
\end{document}
\end{lstcode}
- Once again the publisher is not printed on the first page with the title
- head. For the reason see the explanation about \Macro{lohead} in the example
- above. And again the solution to print the publisher on the first page would
- be similar:
+ Once again the publisher is not printed on the first page with the title.
+ The reason is the same as in the example with
+ \DescRef{\LabelBase.cmd.lohead} above. And the solution for getting the
+ publisher on the first page is similar:
\begin{lstcode}
\lofoot[Smart Alec Publishing]
{Smart Alec Publishing}
\end{lstcode}
- But now you also want to replace the slanted font used in page head and
- footer by a upright smaller font. This may be done using:
+ Now you decide\textnote{font change}\important{\FontElement{pageheadfoot}}%
+ \IndexFontElement{pageheadfoot} that the header and footer should use an
+ upright but smaller font in place of the default slanted font:
\begin{lstcode}
\setkomafont{pageheadfoot}{\small}
\end{lstcode}
- Furthermore, the head but not the footer should be bold:
+ In addition, the header, but not the footer, should be bold:
\begin{lstcode}
\setkomafont{pagehead}{\bfseries}
\end{lstcode}
- For the last command it is important to have it just after
- \Package{scrpage-scrlayer} has been loaded, because the \KOMAScript{} class
- already defines \DescRef{\LabelBase.fontelement.pagehead} and
- \DescRef{\LabelBase.fontelement.pageheadfoot} but with the same
- meaning. Only loading \Package{scrpage-scrlayer} changes the meaning of
- \DescRef{\LabelBase.fontelement.pagehead} and makes it an element
- independent of \DescRef{\LabelBase.fontelement.pageheadfoot}.
-
- Now, please add one more \Macro{lipsum} and add option \Option{twoside} to
- the loading of \Class{scrartcl}. First of all, you will see the page number
- moving from the middle of the page footer to the outer margin, due to the
- changed defaults of \PageStyle{scrheadings} and
- \PageStyle{plain.scrheadings} using double-sided layout and a \KOMAScript{}
- class.
-
- Simultaneously the author, document title and publisher will vanish from
- page~2. It only appears on page~3. This is a consequence of using only
- commands for odd pages. You can recognise this by the ``\texttt{o}'' on the
- second position of the commands' names.
-
- Now, we could simply copy those commands and replace the ``\texttt{o}'' by
+ It is important\textnote{Attention!} that this command does not occur until
+ after \Package{scrpage-scrlayer} has been loaded because the \KOMAScript{}
+ class defines \DescRef{\LabelBase.fontelement.pagehead} as an alias for
+ \DescRef{\LabelBase.fontelement.pageheadfoot}. Only by loading
+ \Package{scrpage-scrlayer} will \DescRef{\LabelBase.fontelement.pagehead}
+ become an element independent of
+ \DescRef{\LabelBase.fontelement.pageheadfoot}.
+
+ Now add one more \Macro{lipsum} and the
+ \Option{twoside}\IndexOption{twoside}\important{\Option{twoside}} option
+ when loading \Class{scrartcl}. First of all, you will see the page number
+ moves from the centre to the outer margin of the page footer, due to the
+ changed defaults of \DescRef{\LabelBase.pagestyle.scrheadings} and
+ \DescRef{\LabelBase.pagestyle.plain.scrheadings} for two-sided printing with
+ a \KOMAScript{} class.
+
+ Simultaneously, the author, document title, and publisher will vanish from
+ page~2. They only appear on page~3. That's because we've only used
+ commands for odd pages. You can recognise this by the ``\texttt{o}'' in the
+ second position of the command names.
+
+ Now, we could simply copy those commands and replace the ``\texttt{o}'' with
an ``\texttt{e}'' to define the contents of \emph{even} pages. But with
- double sided layout it makes more sense to use mirror-inverted elements. So
- the left element of an odd page should become the right element of the even
- page and visa versa. To achieve this, we also replace the first letter
- ``\texttt{l}'' by ``\texttt{r}'':
+ two-sided printing, it makes more sense to use mirror-inverted elements,
+ i.\,e. the left element of an even page should become the right element of
+ the odd page and visa versa. To achieve this, we also replace the first
+ letter ``\texttt{l}'' with ``\texttt{r}'':
\begin{lstcode}
\documentclass[twoside]{scrartcl}
\usepackage{scrlayer-scrpage}
@@ -712,45 +749,45 @@ sketched in \autoref{fig:scrlayer-scrpage.foot}.%
\end{lstcode}
\end{Example}
%
-After reading the example it may appear to you that it is somehow
-uncomfortable to duplicate commands to have the same contents on mirror
-positions of the page header or footer of a double page. Therefore you will
-learn to know an easier solution for this standard case next.
-
-Before allow me an important note:\textnote{Attention!} You should never put a
-section heading or section number directly into the page's footer using a new
-declaration by one of these commands. This could result in a wrong number or
-heading text in the running footer, because of the asynchronous page
-generation and output of \TeX. Instead you should use the mark mechanism
-ideally together with the automatism described in the following section.%
+Since it is a bit cumbersome to define left and right pages separately in
+cases such as the previous example, a simpler solution for this common case is
+introduced below.
+
+Allow me once again an important note:\textnote{Attention!} you should
+never put a section heading or section number directly into the footer using
+one of these commands. Because of the asynchronous way that \TeX{} lays out and
+outputs pages, doing so can easily result in the wrong number or heading text
+in the running head. Instead you should use the mark mechanism, ideally in
+conjunction with the procedures explained in the next section.%
\EndIndexGroup
\begin{Declaration}
- \Macro{lefoot*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{cefoot*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{refoot*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{lofoot*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{cofoot*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{rofoot*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}
+ \Macro{lefoot*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{cefoot*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{refoot*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{lofoot*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{cofoot*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{rofoot*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}
\end{Declaration}
-The previously described commands have also a version with
-star\ChangedAt{v3.14}{\Package{scrlayer-scrpage}} that differs only if you
-omit the optional argument \PName{plain.scrheadings's content}. In this case
-the version without star does not change the content of
-\PageStyle{plain.scrheadings}. The version with star on the other hand uses
-the obligatory argument \PName{scrheading's content} also as default for
-\PageStyle{plain.scrheadings}. So, if both arguments should be the same, you
-can simply use the star version with the obligatory argument only.
+The starred versions\ChangedAt{v3.14}{\Package{scrlayer-scrpage}} of the
+previously described commands differ only if you omit the optional argument
+\OParameter{plain.scrheadings content}. In this case, the version without the
+star does not change the contents of
+\DescRef{\LabelBase.pagestyle.plain.scrheadings}. The starred version, on the
+other hand, uses the mandatory argument \PName{scrheading content} for
+\DescRef{\LabelBase.pagestyle.plain.scrheadings} as well. So if both arguments
+should be the same, you can simply use the starred version with just the
+mandatory argument.%
\begin{Example}
- You can shorten the previous example using the star version of
+ You can shorten the previous example using the star versions of
\DescRef{\LabelBase.cmd.lofoot} and \DescRef{\LabelBase.cmd.refoot}:
\begin{lstcode}
\documentclass[twoside]{scrartcl}
@@ -771,50 +808,46 @@ can simply use the star version with the obligatory argument only.
\end{document}
\end{lstcode}
\end{Example}
-
-The obsolete package \Package{scrpage2}\important{\Package{scrpage2}} does not
-provide this feature.%
%
\EndIndexGroup
\begin{Declaration}
- \Macro{ohead}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{chead}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{ihead}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{ofoot}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{cfoot}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{ifoot}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}
+ \Macro{ohead}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{chead}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{ihead}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{ofoot}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{cfoot}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{ifoot}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}
\end{Declaration}
-To define the contents of page headers and footers of odd and the even pages
-of a double-sided layout using the commands described before, you would have to
-define the contents of the even page different from the contents of the odd
-page. But in general the pages should be symmetric. An element, that should be
-printed left aligned on an even page, should be right aligned on an odd page
-and vise versa. Elements, that are centred on odd pages, should be centred on
-even pages too.
+To configure the headers and footers for two-sided printing with the
+previously described commands, you would have to configure the left and right
+sides separately from one another. In most cases, however, the left and right
+sides are more or less symmetrical. An item that appears on the left of an
+even page should appear on the right of an odd page and vice versa. Centred
+elements are usually centred on both sides.
To simplify the definition of such symmetric page styles,
-\Package{scrlayer-scrpage} provides a kind of abbreviation. Command
-\Macro{ohead} is same like usage of both \DescRef{\LabelBase.cmd.lehead} and
-\DescRef{\LabelBase.cmd.rohead}. Command \Macro{chead} is same like
-\DescRef{\LabelBase.cmd.cehead} and \DescRef{\LabelBase.cmd.cohead}. And
-command \Macro{ihead} is same like \DescRef{\LabelBase.cmd.rehead} and
-\DescRef{\LabelBase.cmd.lohead}. The corresponding commands for the page
-footer are defined accordingly. A sketch of these commands can be found also
-in \autoref{fig:scrlayer-scrpage.head} on
-\autopageref{fig:scrlayer-scrpage.head} and
-\autoref{fig:scrlayer-scrpage.foot} on \autopageref{fig:scrlayer-scrpage.foot}
-together with the relationships of all the page header and footer commands.
+\Package{scrlayer-scrpage} has shortcuts. The \Macro{ohead} command
+corresponds to a call to both \DescRef{\LabelBase.cmd.lehead} and
+\DescRef{\LabelBase.cmd.rohead}. The \Macro{chead} command corresponds to a
+call to both \DescRef{\LabelBase.cmd.cehead} and
+\DescRef{\LabelBase.cmd.cohead}. And the \Macro{ihead} command corresponds to
+a call to both \DescRef{\LabelBase.cmd.rehead} and
+\DescRef{\LabelBase.cmd.lohead}. The same applies to the equivalent commands
+for the page footer. An outline of these relationships can also be found in
+\autoref{fig:scrlayer-scrpage.head} on \autopageref{fig:scrlayer-scrpage.head}
+and \autoref{fig:scrlayer-scrpage.foot} on
+\autopageref{fig:scrlayer-scrpage.foot}.
%
\begin{Example}
- You can simplify the example before using the new commands:
+ You can simplify the previous example using the new commands:
\begin{lstcode}
\documentclass[twoside]{scrartcl}
\usepackage{scrlayer-scrpage}
@@ -831,46 +864,48 @@ together with the relationships of all the page header and footer commands.
\lipsum\lipsum
\end{document}
\end{lstcode}
- As you can see, you can spare half of the commands but get the same result.
-\end{Example}
-%
-In single-sided layouts all pages are odd pages. So in LaTeX's single-sided
-mode these commands are synonymous for the odd page commands. Therefore in
-most cases you will only need these six commands instead of the twelve
-described before.
-
-Once again, allow me an important note:\textnote{Attention!} You should never
-put a section heading or section number directly into the page head or
-page foot using a new declaration by one of these commands. This could result in
-a wrong number or heading text in the running header or footer, because of the
-asynchronous page generation and output of \TeX. Instead you should use the
-mark mechanism ideally together with the automatism described in the following
-section.%
+\iffalse%
+ As you can see, you can use half the number of commands but get the same
+ result. %
+\fi%
+\end{Example}%
+Because one-sided printing treats all pages as odd pages, these commands are
+synonymous with the corresponding right-side commands when in one-sided mode.
+Therefore in most cases you will only need these six commands instead of the
+twelve described before.
+
+Allow me once again an important note:\textnote{Attention!} you should never
+put a section heading or section number directly into the footer using one of
+these commands. Because of the asynchronous way that \TeX{} lays out and
+outputs pages, doing so can easily result in the wrong number or heading text
+in the running head. Instead you should use the mark mechanism, ideally in
+conjunction with the procedures explained in the next section.%
\EndIndexGroup
\begin{Declaration}
- \Macro{ohead*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{chead*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{ihead*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{ofoot*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{cfoot*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}%
- \Macro{ifoot*}\OParameter{plain.scrheadings's content}%
- \Parameter{scrheadings's content}
+ \Macro{ohead*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{chead*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{ihead*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{ofoot*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{cfoot*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}%
+ \Macro{ifoot*}\OParameter{plain.scrheadings content}%
+ \Parameter{scrheadings content}
\end{Declaration}
-The previously described commands have also a version with
-star\ChangedAt{v3.14}{\Package{scrlayer-scrpage}} that differs only if you
-omit the optional argument \PName{plain.scrheadings's content}. In this case
-the version without star does not change the content of
-\PageStyle{plain.scrheadings}. The version with star on the other hand uses
-the obligatory argument \PName{scrheading's content} also as default for
-\PageStyle{plain.scrheadings}. So, if both arguments should be the same, you
-can simply use the star version with the obligatory argument only.%
+The previously described commands also have starred
+versions\ChangedAt{v3.14}{\Package{scrlayer-scrpage}} that differ only if you
+omit the optional argument \OParameter{plain.scrheadings content}. In this
+case, the version without a star does not change the content of
+\DescRef{\LabelBase.pagestyle.plain.scrheadings}. The version with the star,
+on the other hand, also uses the mandatory argument \PName{scrheadings
+content} for \DescRef{\LabelBase.pagestyle.plain.scrheadings}. So if both
+arguments should be the same, you can simply use the starred version with only
+the mandatory argument.%
\begin{Example}
You can shorten the previous example using the star version of
@@ -889,157 +924,168 @@ can simply use the star version with the obligatory argument only.%
\maketitle
\lipsum\lipsum
\end{document}
-\end{lstcode}
-\end{Example}
-
-The obsolete package \Package{scrpage2}\important{\Package{scrpage2}} does not
-provide this feature.%
-%
+\end{lstcode}%
+\end{Example}%
\EndIndexGroup
\begin{Declaration}
\OptionVName{pagestyleset}{setting}
\end{Declaration}
+\BeginIndex{Option}{pagestyleset~=KOMA-Script}%
\BeginIndex{Option}{pagestyleset~=standard}%
-In the examples above you can already find some information about the defaults
-of \PageStyle{scrheadings}\IndexPagestyle{scrheadings} and
-\PageStyle{plain.scrheadings}\IndexPagestyle{plain.scrheadings}. Indeed
-\Package{scrlayer-scrpage} provides two different defaults yet. You may select
-one of those defaults manually using option \Option{pagestyleset}.
-
-If \PName{setting} is \PValue{KOMA-Script} the defaults will be used that
-would also be activated automatically if a \KOMAScript{} class has been
-detected. In this case and within double-sided layout \PageStyle{scrheadings}
-uses running heads outer aligned in the page head. The page number will be
-printed outer aligned in the page footer. Within single-sided layout the
-running head will be printed in the middle of the page head and the page
-number in the middle of the page footer. Upper and lower case will be used for
-the automatic running head as given by the words you have typed. This would be
-same like using Option
-\OptionValueRef{\LabelBase}{markcase}{used}\IndexOption{markcase~=used}.
-Page style \PageStyle{plain.scrheadings} has not got running heads, but the
-page numbers will be printed in the same manner.
-
-If \PName{setting} is \PValue{standard} the defaults will be used that are
-similar to page style \PageStyle{headings} and \PageStyle{plain} of the
-standard classes. This \PName{setting} will also be activated automatically if
-the option has not been used and \KOMAScript{} class cannot be
-detected. Within double-sided layout thereby \PageStyle{scrheadings} uses
-running heads aligned inner in the page head and the page numbers will be
-printed\,---\,also in the page head\,---\,aligned outer. Within single-sided
-layout \PageStyle{scrheadings} is the same. But because of single side layout
-knows only odd pages, the running head will be aligned left always and the
-page number will be aligned right. In spite of typographic objection, the
-automatic running head will be converted into upper cases like they would
-using
-\OptionValueRef{\LabelBase}{markcase}{upper}\IndexOption{markcase~=upper}.
-Within single side layout page style \PageStyle{plain.scrheadings} differs a
-lot from \PageStyle{scrheading}, because the page number will be printed in
-the middle of the page footer. Using double side layout page style
-\PageStyle{plain.scrheadings} differs from standard classes'
-\PageStyle{plain}. The standard classes would print the page number in the
-middle of the page footer. But this would not harmonise with the
-\PageStyle{scrheadings}, so \PageStyle{plain.scrheadings} does not print a
-page number. But like \PageStyle{plain} it does not print a running head.
-
-Please note\textnote{Attention!} that together with this option page style
-\PageStyle{scrheadings} will be activated. This will be also the case, if you
-use the option inside the document.
-
-\BeginIndex{Option}{komastyle}%
-\BeginIndex{Option}{standardstyle}%
-Options \Option{komastyle} and \Option{standardstyle}, provided by
-\Package{scrpage}, are defined only for compatibility reasons in
-\Package{scrlayer-scrpage}. But they are implemented using option
-\Option{pagestyleset}. They are deprecated and you should not use them.%
+The examples above refer several times to the default settings of the page
+styles \DescRef{\LabelBase.pagestyle.scrheadings}\IndexPagestyle{scrheadings}
+and \DescRef{\LabelBase.pagestyle.plain.scrheadings}%
+\IndexPagestyle{plain.scrheadings}. In fact, \Package{scrlayer-scrpage}
+currently provides two different defaults for these page styles. You can
+select them manually with the \Option{pagestyleset} option.
+
+The
+\PValue{KOMA-Script}\important{\OptionValue{pagestyleset}{KOMA-Script}}
+\PName{setting} selects the defaults, which are also set automatically if the
+option is not specified and a \KOMAScript{} class is detected. In two-sided
+printing, \DescRef{\LabelBase.pagestyle.scrheadings} uses outer-aligned
+running heads in the header and outer-aligned page numbers in the footer.
+In one-sided printing, the running head will be printed in the
+middle of the header and the page number in the middle of the footer. Upper-
+and lower-case letters are used in the automatic running heads as they
+actually appear in the sectioning headings. This corresponds to the
+\OptionValueRef{\LabelBase}{markcase}{used}\IndexOption{markcase~=used}%
+\important{\OptionValueRef{\LabelBase}{markcase}{used}} option. The
+\DescRef{\LabelBase.pagestyle.plain.scrheadings} page style has no running
+heads, but the page numbers are printed in the same manner.
+
+However, if the \hyperref[cha:scrlttr2]{\Class{scrlttr2}}%
+\important{\hyperref[cha:scrlttr2]{\Class{scrlttr2}}}%
+\IndexClass{scrlttr2} class is detected, the default settings are based on the
+page styles of that class. See \autoref{sec:scrlttr2.pagestyle},
+\autopageref{sec:scrlttr2.pagestyle}.
+
+The
+\PValue{standard}\important{\OptionValue{pagestyleset}{standard}}
+\PName{setting} selects defaults that match the page styles of the standard
+classes. This is also activated automatically if the option has not been
+specified and no \KOMAScript{} class is detected. In this case, for two-sided
+printing \DescRef{\LabelBase.pagestyle.scrheadings} uses running heads
+inner-aligned in the header, and the page numbers will be printed\,---\,also
+in the header\,---\,outer-aligned. One-sided printing uses the same settings,
+but since only right-hand pages exist in this mode, the running head will
+always be left-aligned and the page number right-aligned. The automatic
+running heads\,---\,despite considerable typographic objections\,---\,are
+converted to capital letters, as they would be with
+\OptionValueRef{\LabelBase}{markcase}{upper}\IndexOption{markcase~=upper}%
+\important{\OptionValueRef{\LabelBase}{markcase}{upper}}. In one-sided
+printing, the \DescRef{\LabelBase.pagestyle.plain.scrheadings} page style
+differs considerably from \DescRef{\LabelBase.pagestyle.scrheadings} because
+the page number is printed in the middle of the footer.
+Unlike\textnote{\KOMAScript{} vs. standard classes} the \PageStyle{plain} page
+style in the standard classes,
+\DescRef{\LabelBase.pagestyle.plain.scrheadings} omits the page number in
+two-sided printing. The standard classes print the page number in the middle
+of the footer, which does not match the rest of the page styles in two-sided
+printing.
+\iffalse % Umbruchkorrekturtext
+ If you want the page number back
+\begin{lstcode}
+ \cfoot[\pagemark]{}
+\end{lstcode}
+ will restore it. %
+\fi%
+The running head is omitted in \DescRef{\LabelBase.pagestyle.plain.scrheadings}.
+
+Note\textnote{Attention!} that using this option activates the
+\DescRef{\LabelBase.pagestyle.scrheadings}\IndexPagestyle{scrheadings}%
+\important{\DescRef{\LabelBase.pagestyle.scrheadings}} page style.
+\iffalse% Umbruchkorrektur
+ This also applies if you use the option within the document.%
+\fi
%
\EndIndexGroup
-\LoadCommonFile{pagestylemanipulation} % \section{Manipulation of Defined Page Styles}
+\LoadCommonFile{pagestylemanipulation} % \section{Manipulating Defined Page Styles}
\begin{Declaration}
\OptionVName{headwidth}{width\textup{:}offset\textup{:}offset}%
\OptionVName{footwidth}{width\textup{:}offset\textup{:}offset}
\end{Declaration}
-By default the page head\Index{head>width} and foot\Index{foot>width} are as
-wide as the type area. This can be changed using these \KOMAScript{}
-options. The value \PName{width} is the wanted width of the head respective
-foot. The \PName{offset} defines how much the head or foot should be moved
-towards the outer\,---\,in single side layout to the right\,---\,margin. All
-three\ChangedAt{v3.14}{\Package{scrlayer-scrpage}} values are optional and can
-be omitted. If you omit a value, you can also omit the corresponding colon
-left beside. If there is only one \PName{offset} it is used for both, odd and
-even pages. Otherwise, the first \PName{offset} is used for odd and the second
-\PName{offset} for even pages in two-side mode. If you only use one value
-without colon, this will be the \PName{width}.
-
-For the \PName{width} as well as the \PName{offset} you can use any valid
-length value, \LaTeX{} length, \TeX{} dimension or \TeX{} skip. In addition
-you may use an \eTeX{} dimension expression with basic arithmetic operations
-\texttt{+}, \texttt{-}, \texttt{*}, \texttt{/}, and parenthesis. See
-\cite[section~3.5]{manual:eTeX} for more information on such expressions. See
-\autoref{sec:scrlayer-scrpage.options} for more information on using,
-e.\,g., a \LaTeX{} length as an option value. The \PName{width} can
-alternatively be one of the symbolic values shown in
-\autoref{tab:scrlayer-scrpage.symbolic.values}.
-
-By default the head and the foot are as wide as the text area. The default
-\PName{offset} depends on the used \PName{width}. In single side layout
-generally the half of the difference of \PName{width} and the width of the
-text area will be used. This results in horizontal centring the page head
-above or the page footer below the text area. In difference to this, in double
-side layout generally a third of the difference of \PName{offset} and the
-width of the text area will be used. But if \PName{width} is the width of the
-whole text area plus the marginal note column, default \PName{offset} will be
-zero. If you think, this is complicated, you should simply use an explicit
-\PName{offset}.
+By default the header\Index{header>width} and footer\Index{footer>width} are
+as wide as the type area. However, you can change this using these
+\KOMAScript{} options. The value \PName{width} is the desired width of the
+header or footer. The \PName{offset} defines how far the header or footer
+should be moved towards the outer\,---\,in one-sided printing to the
+right\,---\,margin. All three\ChangedAt{v3.14}{\Package{scrlayer-scrpage}}
+values are optional and can be omitted. If you omit a value, you can also omit
+the associated colon to the left of it. If only one \PName{offset} is
+specified, it is used for both odd and even pages. Otherwise, the first
+\PName{offset} is used for odd and the second \PName{offset} for even pages in
+two-sided mode. If you only use one value without a colon, this will be the
+\PName{width}.
+
+For both the \PName{width} and the \PName{offset} you can use any valid length
+value, \LaTeX{} length, \TeX{} dimension, or \TeX{} skip. In addition, you can
+use an \eTeX{} dimension expression with the basic arithmetic operations
+\texttt{+}, \texttt{-}, \texttt{*}, \texttt{/}, and parentheses. See
+\cite[section~3.5]{manual:eTeX} for more information on such expressions. See
+\autoref{sec:scrlayer-scrpage.options} for more information on using a
+\LaTeX{} length as an option value. The \PName{width} can also be one of the
+symbolic values shown in \autoref{tab:scrlayer-scrpage.symbolic.values}.
+
+By default the header and the footer are the width of the text area. The
+default \PName{offset} depends on the selected \PName{width}. One-sided
+printing typically uses half the difference between \PName{width} and the
+width of the text area. This centres the header horizontally above the text
+area. Two-sided printing, on the other hand, uses only a third of the
+difference between \PName{width} and the width of the text area. However, if
+\PName{width} is the width of the whole text area and the marginal note
+column, the default \PName{offset} will be zero. If this is too complicated
+for you, you should simply specify the desired \PName{offset} yourself.
%
\begin{table}
\centering
- \caption[Symbolic values for options \Option{headwidth} and
- \Option{footwidth}]{Possible symbolic values for the \PName{width} value of
- options \Option{headwidth} and \Option{footwidth}}
+ \caption[Symbolic values for the \Option{headwidth} and \Option{footwidth}
+ options]{Available symbolic values for the \PName{width} value of options
+ \Option{headwidth} and \Option{footwidth}}
\label{tab:scrlayer-scrpage.symbolic.values}
\begin{desctabular}
- \ventry{foot}{%
- the current width of the page foot%
+ \entry{\PValue{foot}}{%
+ the current width of the footer%
}%
- \ventry{footbotline}{%
- the current length of the horizontal line below the page foot%
+ \entry{\PValue{footbotline}}{%
+ the current length of the horizontal line below the footer%
}%
- \ventry{footsepline}{%
- the current length of the horizontal line above the page foot%
- } \ventry{head}{%
- the current width of the page head%
+ \entry{\PValue{footsepline}}{%
+ the current length of the horizontal line above the footer%
+ } \entry{\PValue{head}}{%
+ the current width of the header%
}%
- \ventry{headsepline}{%
- the current length of the horizontal line below the page head%
+ \entry{\PValue{headsepline}}{%
+ the current length of the horizontal line below the header%
}%
- \ventry{headtopline}{%
- the current length of the horizontal line above the page head%
+ \entry{\PValue{headtopline}}{%
+ the current length of the horizontal line above the header%
}%
- \ventry{marginpar}{%
- the current width of the marginal note column including the distance
+ \entry{\PValue{marginpar}}{%
+ the width of the marginal note column including the distance
between the text area and the marginal note column%
}%
- \ventry{page}{%
- the current width of the page considering a binding correction of
- package \Package{typearea} (see option \DescRef{typearea.option.BCOR} in
- \autoref{sec:typearea.typearea},
- \DescPageRef{typearea.option.BCOR})%
+ \entry{\PValue{page}}{%
+ the width of the page taking into account any binding correction defined
+ with the help of the \Package{typearea} package (see the
+ \DescRef{typearea.option.BCOR} option in
+ \autoref{sec:typearea.typearea}, \DescPageRef{typearea.option.BCOR})%
}%
- \ventry{paper}{%
- the current width of the paper without considering a binding correction%
+ \entry{\PValue{paper}}{%
+ the width of the paper without considering any binding correction%
}%
- \ventry{text}{%
- the current width of the text area%
+ \entry{\PValue{text}}{%
+ the width of the text area%
}%
- \ventry{textwithmarginpar}{%
- the current width of the text area plus the marginal note column
- including the distance between them (note: in this case and only in this
- case the default of \PName{offset} would be zero)%
+ \entry{\PValue{textwithmarginpar}}{%
+ the width of the text area including the marginal note column and
+ the distance between the two (Note: only in this case is
+ the default for \PName{offset} zero)%
}%
\end{desctabular}
\end{table}
@@ -1053,66 +1099,51 @@ zero. If you think, this is complicated, you should simply use an explicit
\OptionVName{footsepline}{thickness\textup{:}length}%
\OptionVName{footbotline}{thickness\textup{:}length}
\end{Declaration}
-The \KOMAScript{} classes provide only a separation line below the page head
-and above the page head, and you may only switch each of these lines on or
-off. But package \Package{scrlayer-scrpage} provides four such horizontal
-lines: one above the head, one below the head, one above the foot, and one
-below the foot. And you can not only switch them on an off, but also configure
-the \PName{length} and \PName{thickness} of each of these lines.
+\BeginIndex{Option}{headtopline~=\PName{thickness\textup{:}length}}%
+\BeginIndex{Option}{headsepline~=\PName{thickness\textup{:}length}}%
+\BeginIndex{Option}{footsepline~=\PName{thickness\textup{:}length}}%
+\BeginIndex{Option}{footbotline~=\PName{thickness\textup{:}length}}%
+The \KOMAScript{} classes provide only one separation line below the header
+and another above the footer, and you can only switch these lines on or off.
+But the \Package{scrlayer-scrpage} package also lets you place lines above the
+header and below the footer. And for all four lines, you can not only switch
+them on an off but also configure their \PName{length} and \PName{thickness}.
Both values are optional. If you omit the \PName{thickness}, a default value
-of 0.4\Unit{pt} will be used, a so called \emph{hairline}. If you omit the
-\PName{length}, the width of the head respective the foot will be used. If you
+of 0.4\Unit{pt} is used, producing a so-called \emph{hairline}. If you omit
+the \PName{length}, the width of the header or footer will be used. If you
omit both, you can also omit the colon. If you use only one value without
-colon, this will be the \PName{thickness}.
-
-For sure, the \PName{length} can be not only shorter than the current width of
-the page head respectively the page foot, but also longer. See additionally
-options \DescRef{\LabelBase.option.ilines}\IndexOption{ilines},
-\DescRef{\LabelBase.option.clines}\IndexOption{clines}, and
+colon, this is the \PName{thickness}.
+
+Of course, the \PName{length} can be not just shorter than the current width
+of the header or footer but also longer. See also the options
+\DescRef{\LabelBase.option.ilines}\IndexOption{ilines}%
+\important{\DescRef{\LabelBase.option.ilines},
+\DescRef{\LabelBase.option.clines}, \DescRef{\LabelBase.option.olines}},
+\DescRef{\LabelBase.option.clines}\IndexOption{clines} and
\DescRef{\LabelBase.option.olines}\IndexOption{olines} later in this section.
+\BeginIndexGroup
\BeginIndex{FontElement}{headtopline}\LabelFontElement{headtopline}%
\BeginIndex{FontElement}{headsepline}\LabelFontElement{headsepline}%
\BeginIndex{FontElement}{footsepline}\LabelFontElement{footsepline}%
\BeginIndex{FontElement}{footbotline}\LabelFontElement{footbotline}%
-Beside the length and thickness also the colour of the lines can be
-changed. First of all the colour depends on the colour of the head or
-foot. But independent from those or additional to them the settings of the
-corresponding elements \FontElement{headtopline}, \FontElement{headsepline},
-\FontElement{footsepline}, and \FontElement{footbotline} will be used. You may
-change these using command \DescRef{\LabelBase.cmd.setkomafont} or
-\DescRef{\LabelBase.cmd.addtokomafont} (see \autoref{sec:maincls.textmarkup}
-from \DescPageRef{maincls.cmd.setkomafont}). By default those settings
-are empty, which means no change of the current font or colour. Change of font
-in opposite to colour would not make sense and is not recommended for these
-elements.%
-\EndIndex{FontElement}{footbotline}%
-\EndIndex{FontElement}{footsepline}%
-\EndIndex{FontElement}{headsepline}%
-\EndIndex{FontElement}{headtopline}%
-
-\BeginIndex{Cmd}{setheadtopline}%
-\BeginIndex{Cmd}{setheadsepline}%
-\BeginIndex{Cmd}{setfootsepline}%
-\BeginIndex{Cmd}{setfootbotline}%
-Package \Package{scrpage2} has additionally to the options that do not take
-any values, also four commands
-\Macro{setheadtopline}\IndexCmd[indexmain]{setheadtopline},
-\Macro{setheadsepline}\IndexCmd[indexmain]{setheadsepline},
-\Macro{setfootsepline}\IndexCmd[indexmain]{setfootsepline}, and
-\Macro{setfootbotline}\IndexCmd[indexmain]{setfootbotline}. These have a first
-optional argument for the \PName{length}, a second mandatory argument for the
-\PName{thickness}, and a third optional argument for the setting of font or
-colour. Package \Package{scrlayer-scrpage} does also provide those
-commands. Nevertheless, these commands are deprecated and should not be used
-any longer. To get it clear: These commands have never been made to
-switch the lines on or off. They have been made to configure already switched
-on lines. Users often ignored this!%
-\EndIndex{Cmd}{setfootbotline}%
-\EndIndex{Cmd}{setfootsepline}%
-\EndIndex{Cmd}{setheadsepline}%
-\EndIndex{Cmd}{setheadtopline}%
+In addition to the length and thickness, you can also change the colour of the
+lines. Initially the colour depends on the colour of the header or footer. In
+addition to this, however, the settings of the corresponding elements
+\important[i]{\FontElement{headtopline}\\
+ \FontElement{headsepline}\\
+ \FontElement{footsepline}\\
+ \FontElement{footbotline}} \FontElement{headtopline},
+\FontElement{headsepline}, \FontElement{footsepline} and
+\FontElement{footbotline} are applied. You can
+change these using the \DescRef{\LabelBase.cmd.setkomafont} or
+\DescRef{\LabelBase.cmd.addtokomafont} commands (see
+\autoref{sec:maincls.textmarkup}, \DescPageRef{maincls.cmd.setkomafont}).
+By default these elements are empty, so they do not change the current font or
+colour. Font changes at this point, unlike colour changes, make little sense
+anyway and are therefore not recommended for these elements.%
+\EndIndexGroup
%
\EndIndexGroup
@@ -1123,10 +1154,10 @@ on lines. Users often ignored this!%
\OptionVName{plainfootsepline}{simple switch}%
\OptionVName{plainfootbotline}{simple switch}
\end{Declaration}
-These options can be used to inherit the settings of the lines also for the
-\PageStyle{plain} page style. Possible values for \PName{simple switch} can be
-found in \autoref{tab:truefalseswitch} on
-\autopageref{tab:truefalseswitch}. If a option is activated, the
+You can use these options to apply the settings for the lines to the
+\PageStyle{plain} page style. You can find the available values for
+\PName{simple switch} in \autoref{tab:truefalseswitch} on
+\autopageref{tab:truefalseswitch}. If one of these options is activated, the
\PageStyle{plain} page style will use the line settings given by the options
and commands described above. If the option is deactivated, the
\PageStyle{plain} will not show the corresponding line.%
@@ -1138,14 +1169,14 @@ and commands described above. If the option is deactivated, the
\Option{clines}%
\Option{olines}
\end{Declaration}
-You have already been told that the horizontal lines above or below the page
-head or foot can be shorter or longer than the page head or page foot
-itself. Only the answer to the question about the alignment of those lines is
-still missing. By default all lines are left aligned at single side layout and
-aligned to the inner margin of the head or foot at double side layout. This
-is same like using option \Option{ilines}. Alternatively, you can use option
-\Option{clines} to centre the lines in the head or foot, or option
-\Option{olines} to align them right respectively to the outer margin.%
+As previously explained, dividing lines for the header or footer can be longer
+or shorter than the width of the header or footer respectively. But the
+question remains how these lines are aligned. By default, all lines are
+aligned to the left margin in one-sided printing and to the inner margin in
+two-sided printing. This corresponds to using the \Option{ilines} option.
+Alternatively, you can use the \Option{clines} option to centre the lines with
+respect to the width of the header or footer, or the \Option{olines} option to
+align them to the outer (or right) margin.%
\EndIndexGroup
%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer.tex
index 77492066753..65c8cf865d6 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlayer.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,111 +46,110 @@
% ============================================================================
\KOMAProvidesFile{scrlayer.tex}
- [$Date: 2017-08-08 11:47:52 +0200 (Tue, 08 Aug 2017) $
+ [$Date: 2018-02-28 13:23:23 +0100 (Wed, 28 Feb 2018) $
KOMA-Script guide (chapter:scrlayer)]
-\translator{Markus Kohm}
+\translator{Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2017-08-08
+% Date of the translated German file: 2018-02-01
-\chapter[{Defining Layers and Page Styles Using \Package{scrlayer}}]%
-{Defining Layers and Page Styles Using \Package{scrlayer}%
-}
+\chapter[{Defining Layers and Page Styles with \Package{scrlayer}}]
+ {Defining\ChangedAt{v3.12}{\Package{scrlayer}} Layers and Page Styles with
+ \Package{scrlayer}}
\labelbase{scrlayer}
+
\BeginIndexGroup
\BeginIndex{Package}{scrlayer}%
\BeginIndex{}{layer}%
-Most users of graphics software already know layer models for pages or working
-sheets. \LaTeX{} itself does not know layers, but there are already packages
-like \Package{eso-pic} or \Package{textpos}, that provide a kind of
-background or foreground layer. \Package{scrlayer} is another package,
-that provides such background and foreground layers, but in difference
-to the other packages mentioned above these layers are part of the
-page style definition. With this you may simply switch between usage
-of layers by switching the page style.
-
-To do so, the package also supports a low level interface to define page
-styles using a layer stack, to put layers onto a page style's layer stack, to
-put layers at the lowest position of a page style's layer stack, to put layers
-before or after a layer of a page style's layer stack, to remove a layer from
-a page style's layer stack and to remove doublets of layers of a page style's
-layer stack. In short words: The page style interface of \Package{scrlayer}
-provides commands to define layer-stack-based page styles and to manage those
-layer stacks.
-
-Nevertheless, using the layers directly is recommended for advanced users only.
-End user interfaces for beginners or average users are provided by additional
-packages, that load \Package{scrlayer} on their own. See
+Most users of graphics software are already familiar with the layer model for
+a page. Such a model is rather alien to \LaTeX{} itself, but some packages,
+like \Package{eso-pic} or \Package{textpos}, provide a kind of
+background or foreground layer. \Package{scrlayer} is another package that
+provides such background and foreground layers, but unlike the packages
+mentioned above, these layers are part of the page style. As a result, you can
+switch between different layers simply by switching the page style.
+
+To do so, the package also supports a low-level interface for defining page
+styles that are based on a stack or list of layers, for adding layers to such
+a layer stack, either at the top or the bottom, or before or after a specific
+layer, and for removing individual layers and duplicates from a stack. In a
+nutshell, the page style interface of \Package{scrlayer} provides commands to
+define page styles based on a stack of layers and to manage those stacks.
+
+Nevertheless, using the layers directly is recommended for advanced users
+only. Interfaces for beginners and average users are provided by additional
+packages that in turn load \Package{scrlayer}. See
\autoref{cha:scrlayer-scrpage} in \autoref{part:forAuthors} of this
\iffree{manual}{book}.
-\section{State of Development Note}
-\seclabel{draft}
-
-Development of this package has not been finished yet. Parts of the package
-are even still experimental. Because of this, especially internal
-functionality may be changed in future. Most likely the package will be
-extended. And because of the early state of development, you should not expect
-a complete and finished user manual. Nevertheless, this manual, which is
-recommended for advanced users and developers, describes the current state of
-development and the released parts of \Package{scrlayer}. Everything, not
-documented here, should not be used for anything else but testing.
\LoadCommonFile{options} % \section{Early or Late Selection of Options}
-\section{Some Generic Information}
-\seclabel{generic}
+\section{Generic Information}
+\seclabel{generic.information}
-The package needs some generic information about the class. Class authors may
-help \Package{scrlayer} by setting this information. Otherwise the package tries
-to detect the information itself. This works, e.g., for the standard classes
-and the \KOMAScript{} classes. But it may or may not fail with other classes.
+The package needs some generic information about the class being used. Class
+authors can help \Package{scrlayer} by providing the appropriate information.
+Otherwise the package will try to determine this information for itself. This
+works, for example, for the standard and the \KOMAScript{} classes. It may
+work with other classes, or it may fail in whole or in part.
-This section describes some of the information, that class authors may
-provide. Generally users need not to care about this.
+This section describes some of the information that class authors can provide.
+Normally, users should not have to worry about it.
\begin{Declaration}
\Macro{if@chapter}\ \PName{then code}\ \textMacro{else}\ %
\PName{else code}\ \textMacro{fi}%
\end{Declaration}
-If \Macro{if@chapter} is \Macro{iftrue}, \Package{scrlayer} will additionally
-consider the chapter level, e.g., processing option
-\DescRef{\LabelBase.option.automark}. If it is defined, but differs from
-\Macro{iftrue}, only part, section, subsection, sub\dots subsection,
-paragraph, subparagraph, sub\dots subparagraph will be considered. If the
-macro is not defined, \Package{scrlayer} searches for
-\DescRef{maincls.cmd.chapter}. If \DescRef{maincls.cmd.chapter} is defined and
-not \Macro{relax}, \Package{scrlayer} will define \Macro{if@chapter} to
-\Macro{iftrue}, otherwise \Macro{if@chapter} will become \Macro{iffalse}.%
+If \Macro{if@chapter} is defined and corresponds to
+\Macro{iftrue}\IndexCmd{iftrue}, \Package{scrlayer} takes the chapter level
+into account when, for example, processing the
+\DescRef{\LabelBase.option.automark} option. If it is defined but is not
+\Macro{iftrue}, \Package{scrlayer} handles only the
+\DescRef{maincls.cmd.part}, \DescRef{maincls.cmd.section},
+\DescRef{maincls.cmd.subsection}, \Macro{sub\dots subsection},
+\DescRef{maincls.cmd.paragraph}, \DescRef{maincls.cmd.subparagraph},
+\Macro{sub\dots subparagraph} sectioning units. If the macro is undefined,
+\Package{scrlayer} searches for \DescRef{maincls.cmd.chapter}. If
+\DescRef{maincls.cmd.chapter} is defined and does not correspond to
+\Macro{relax}, \Package{scrlayer} defines \Macro{if@chapter} to
+\Macro{iftrue}. Otherwise \Macro{if@chapter} becomes
+\Macro{iffalse}\IndexCmd{iffalse}.%
\EndIndexGroup
\begin{Declaration}
- \Macro{if@mainmatter}\ \PName{then code}\ \textMacro{else}\ %
- \PName{else code}\ \textMacro{fi}%
+ \Macro{if@mainmatter}\ \PName{then code}\ %
+ \textMacro{else}\ \PName{else code}\ \textMacro{fi}%
\end{Declaration}
-Classes like \Class{book} define \DescRef{maincls.cmd.frontmatter},
-\DescRef{maincls.cmd.mainmatter}, and \DescRef{maincls.cmd.backmatter}. They
-also use \Macro{if@mainmatter} to distinguish whether or not the current
-matter is the main matter. Classes like \Class{report} and \Class{article} do
-not have \DescRef{maincls.cmd.frontmatter}, \DescRef{maincls.cmd.mainmatter},
-or \DescRef{maincls.cmd.backmatter} and therefore also do not have
-\Macro{if@mainmatter}.
-
-For \Package{scrlayer} it's easier not to test always for the existence of the
-matter commands, but to use \Macro{if@mainmatter} even with classes like
-\Class{report} and \Class{article}, simply set to \Macro{iftrue}. So if
-\Macro{if@mainmatter} is not defined, it will be defined to \Macro{iftrue}.
-
-Some classes have \DescRef{maincls.cmd.frontmatter},
+Classes like \Class{book} or \Class{scrbook} provide
+\DescRef{maincls.cmd.frontmatter}\IndexCmd{frontmatter},
+\DescRef{maincls.cmd.mainmatter}\IndexCmd{mainmatter}, and
+\DescRef{maincls.cmd.backmatter}\IndexCmd{backmatter} to switch between the
+front, main, and end parts of a book. Typically, these classes also use
+\Macro{if@mainmatter} internally to decide whether the current text is part of
+the main body of the document or not. Classes like \Class{report} and
+\Class{article} have no \DescRef{maincls.cmd.frontmatter},
+\DescRef{maincls.cmd.mainmatter}, or \DescRef{maincls.cmd.backmatter} and
+therefore also lack \Macro{if@mainmatter}.
+
+It is easier for \Package{scrlayer} to avoid constantly testing for the
+existence of these commands to decide whether to work in the main matter or
+not, and instead to use \Macro{if@mainmatter}\IndexCmd{iftrue} with classes
+like \Class{report} and \Class{article}. So if \Macro{if@mainmatter} is not
+defined, \Package{scrlayer} defines it as a synonym for \Macro{iftrue}.
+
+Some classes, however, define \DescRef{maincls.cmd.frontmatter},
\DescRef{maincls.cmd.mainmatter}, or \DescRef{maincls.cmd.backmatter} but not
-\Macro{if@mainmatter}. In this case \Package{scrlayer} also defines
+\Macro{if@mainmatter}. In this case, \Package{scrlayer} also defines
\Macro{if@mainmatter} to be \Macro{iftrue} and it extends definition of
\DescRef{maincls.cmd.frontmatter}, \DescRef{maincls.cmd.mainmatter}, and
-\DescRef{maincls.cmd.backmatter} to set \Macro{if@mainmatter} properly. Other
-matter commands are not known, not tested, and not extended. So if there are
-other matter commands \Package{scrlayer} needs help of the class author to set
-\Macro{if@mainmatter} correctly.%
+\DescRef{maincls.cmd.backmatter} to set \Macro{if@mainmatter} properly.
+However, if there are other, comparable commands for switching between
+different document parts. \Package{scrlayer} will not recognize them, does not
+test for them, and therefore cannot extend them appropriately. In this case,
+\Package{scrlayer} needs help of the class author to set \Macro{if@mainmatter}
+correctly.%
\EndIndexGroup
@@ -158,103 +157,115 @@ other matter commands \Package{scrlayer} needs help of the class author to set
\Macro{DeclareSectionNumberDepth}\Parameter{level name}%
\Parameter{level depth}
\end{Declaration}
-Generally each section level is related to an integer number indicating its
-depth in the document structure. \LaTeX{} needs this to manage hierarchic
-section levels. But normally only the document class, that defines the section
-commands, itself knows that \PName{level depth} of a section level and uses
-these numerical values inside the corresponding commands, when needed.
-
-But \Package{scrlayer} also needs information about the section hierarchy.
-With command \Macro{DeclareSectionNumberDepth} you can map
-the name of a heading level to a \PName{level depth}. With standard class
-book, e.g., the \PName{level name} could be \PValue{part}, \PValue{chapter},
-\PValue{section}, \PValue{subsection}, \PValue{subsubsection},
-\PValue{paragraph}, or \PValue{subparagraph} and the corresponding
-\PName{level depth}s would be -1, 0, 1, 2, 3, 4, and 5.
-
-Package \Package{scrlayer} tries to determine the \PName{level depth}s on its
-own while loading and again while \Macro{begin}\PParameter{document}. But, if
-it fails, i.\,e., if completely different section commands are used, it would
-be useful, to be able to define the relationship explicitly. For such cases
-\Macro{DeclareSectionNumberDepth} gives the class author the opportunity to
-define the relationship explicitly.%
+Generally each section level is assigned an integer number indicating its
+depth in the document structure. \LaTeX{} needs this to manage the hierarchy
+of the section levels. But normally these values are known only to the
+particular class that defines the section commands. This class then uses the
+appropriate numbers inside the corresponding commands.
+
+The \Package{scrlayer} package also needs information about the section
+hierarchy. With the help of \Macro{DeclareSectionNumberDepth}, you can map the
+name of a heading level to a corresponding \PName{level depth}. For example,
+for the standard \Class{book} class, the \PName{level name}s would be
+\PValue{part}, \PValue{chapter}, \PValue{section}, \PValue{subsection},
+\PValue{subsubsection}, \PValue{paragraph}, and \PValue{subparagraph}, and the
+corresponding \PName{level depth}s would be -1, 0, 1, 2, 3, 4, and 5.
+
+The \Package{scrlayer} package tries to determine the \PName{level depth}s on
+its own while loading and again during \Macro{begin}\PParameter{document}. But
+if this fails, for example because you use completely different sectioning
+commands, you can define the relationship explicitly with
+\Macro{DeclareSectionNumberDepth}.%
\EndIndexGroup
-\section{Declaration of Layers}
+\section{Declaring Layers}
\seclabel{layers}
-A layer is a kind of virtual sheet of transparent paper (in opposite to a
-physical sheet of paper). One layer is stacked onto another layer and opaque
-material on one layer may hide material on the layers below. The stack of all
-layers together makes the physical page. Package \Package{scrlayer}
-provides two such layer stacks for each page: a background layer stack and a
-foreground layer stack. The background layer stack is behind the normal page
-contents, the foreground layer stack is above the normal page contents. So the
-normal contents is a kind of a separating layer between the background layer
-stack and the foreground layer stack.
-
-A layer has several attributes, which are the answers to some basic questions:
-\begin{description}
-\item[Is the layer part of the background or the
- foreground?\textnote{background or foreground}]%
- During page building background layers will be printed first, followed by
- the main contents and the foreground layers. Therefore, in the output the
- background layers show up behind the main contents and the foreground layers
- in front of the main contents. By default, a layer is both, a background
- layer \emph{and} a foreground layer and therefore will be printed
- twice. Normally, it makes sense to restrict the layer in this aspect.
-\item[What is the position of the layer?\textnote{horizontal and vertical
- position}]%
- There are some attributes to define the horizontal and the vertical position
- of a layer.
-\item[What is the size of the layer?\textnote{horizontal and vertical size}]%
- As for the position there are several attributes to define the width and
- height of a layer. So a layer can also be smaller or larger than the paper
- and it can be placed everywhere on the paper.
-\item[How is a layer aligned on the paper?\textnote{alignment}]%
- This question is answered by the alignment attribute. The horizontal position
- can be relative from the left edge of the paper either to the left edge of
- the layer or to the centre of the layer or to the right edge of the
- layer. Also the vertical position can be relative from the to edge of the
- paper either to the top edge of the layer or to the centre of the layer or
- to the bottom edge of the layer.
-\item[Is the layer intended for text or picture output?\textnote{text or
- picture}]%
- This question is also related to the position. For picture output users
- often expect the origin at the bottom left corner of the layer. But this
- would not be suitable for text output. So the origin of a text layer is the
- height of a standard text line below the top left corner of the
- layer. Picture layers on the other hand span a
- \Environment{picture}\IndexEnv{picture} environment and provide addition
- positioning commands.
-\item[Should the layer be printed on left or right pages?\textnote{left or
- right page}]%
- By default a layer will be printed on both, left and right pages. Note, that
- \LaTeX{} names left pages as even pages and right pages as odd pages and
- that there are no left or even pages in single-sided mode.
-\item[Should the layer be printed in single-side mode or two-side
- mode?\textnote{single-side or two-side}]%
- By default a layer will be printed in both, single-side mode and two-side
- mode. Nevertheless, an even page layer will never be printed in single-side
- mode and therefore is not really a two-side mode layer.
-\item[Should the layer be printed on float pages or non-float
- pages?\textnote{float page or non-float page}]%
- \LaTeX{} produces float pages for float environments like tables or figures,
- if they are allowed to be printed on a page without normal page contents
- (see option \PValue{p} for \Environment{figure} or \Environment{table}). So
- from some point of view a float page is a page, that may itself
- flow. Non-float pages are not pages without floats, but pages, that are not
- float pages. They may contain floats inside the text, on the top of the
- page, or on the bottom of the page. Very large floats may seem to be page
- floats, while in reality they are top floats.
-\item[What are the contents of the layer?\textnote{contents}]%
- The corresponding attribute are the commands that produce the output.
-\end{description}
-So we have eight questions that immediately result in attributes yet. Below in
-this manual we will describe additional attributes. However, they are just
-defined for convenience and can be expressed by a combination of these primary
-attributes.
+A layer is an abstract model of a page. Unlike a real, physical sheet of
+paper, this page is completely transparent. Typically, multiple layers are
+stacked atop one another and opaque material on one layer hides material on
+the layers below. The stack of layers is then merged to form the physical
+page. The \Package{scrlayer} package provides two such stacks for each page: a
+background stack and a foreground stack. The background stack is printed
+beneath the normal page content, while the foreground stack is printed above
+it. The normal page content is therefore a kind of a dividing layer between
+the two layer stacks.
+
+A layer has several attributes that can be understood as answers to some basic
+questions:
+\iffree{\begin{description}}{%
+ \begingroup
+ \RedeclareSectionCommand[beforeskip=.5\baselineskip plus .25\baselineskip
+ minus .1\baselineskip]{paragraph}%
+ \renewcommand*\item[4][]{\paragraph*{#3{#4}#1}}%
+ }%
+\item[Does the layer belong to the foreground or the background?]%
+ \leavevmode\textnote{foreground or background}\hskip 0pt
+ Background layers are output before the normal content of the page.
+ Therefore they appear behind or beneath the normal content of the page.
+ Foreground layers are then output after the normal content. Therefore they
+ appear on top of the normal content of the page. By default, a layer is both
+ a background layer \emph{and} a foreground layer and therefore is printed
+ twice. Usually it makes sense to limit the layer explicitly to either the
+ foreground or the background.
+\item[What is the position of the layer?]%
+ \leavevmode\textnote{horizontal and vertical position}\hskip 0pt
+ To answer this question, there are attributes to define the layer's
+ horizontal and vertical position.
+\item[How big is the layer?\textnote{horizontal and vertical size}]%
+ As with the position, there are also attributes to define the width and
+ height of a layer. Thus a layer can be smaller or larger than the paper
+ and it can be placed at different positions on the paper.
+\item[How are the horizontal and vertical positions measured?]%
+ \leavevmode\textnote{alignment}\hskip 0pt
+ This question is answered by the alignment attribute. The horizontal
+ position can be measured from the left edge of the paper to the left edge of
+ the layer, to the centre of the layer, to the right edge of the layer.
+ Similarly, the vertical position can be measured from the top edge of the
+ paper to the top edge of the layer, the centre of the layer, or the bottom
+ edge of the layer.
+\item[Is the layer intended for text or picture output?]%
+ \leavevmode\textnote{text or picture}\hskip 0pt
+ This question is closely related to the position. For example, users often
+ expect the origin for a picture to be at the lower left corner of the layer.
+ But this would not be suitable for text output. Therefore the origin of a
+ text layer is the height of a standard text line below the top left corner
+ of the layer. Picture layers, on the other hand, create a
+ \Environment{picture}\IndexEnv{picture} environment in which additional
+ positioning commands are available.
+\item[Should the layer be printed on left or right pages?]%
+ \leavevmode\textnote{left or right page}\hskip 0pt
+ By default a layer will be printed on all pages. Note that \LaTeX{} treats
+ even pages as left-side pages and odd pages as right-side pages, but in
+ one-sided printing, only right-hand pages exist regardless of the page
+ number.
+\item[Should the layer be printed in one-sided or two-sided mode?]%
+ \leavevmode\textnote{one-sided or two-sided}\hskip 0pt
+ By default a layer will be printed in both one-sided and two-sided
+ printing. Nonetheless, a layer that is restricted to even pages will never
+ be printed in one-sided printing and therefore is not a one-sided layer.
+\item[Should the layer be printed on float pages or normal pages?]%
+ \leavevmode\textnote{float page or normal page}\hskip 0pt
+ \LaTeX{} produces float pages for objects from environments like tables or
+ figures if they are allowed to appear on a page without normal page contents
+ (see option \PValue{p} for \Environment{figure} or \Environment{table}). In
+ effect, the entire page is allowed to float within the document. Normal
+ pages in this sense are all pages that are not float pages. Normal pages can
+ also contain floats at the top, in the middle, or at the bottom of the page.
+ Very large floats can give the impression of being page floats, while in
+ reality they are floating environments placed at the top of a normal page.
+\item[What are the contents of the layer?]%
+ \leavevmode\textnote{contents}\hskip 0pt
+ The corresponding attribute simply contains what should be printed whenever
+ the layer is output.
+\iffree{\end{description}}{%
+ \endgroup\par\bigskip\noindent\ignorespaces
+}%
+These eight questions immediately give rise to a number of attributes. Later
+\iffree{in this guide}, we will describe additional attributes. However, they
+are only defined for convenience and can be expressed by a combination of
+these primary attributes.
\begin{Declaration}
@@ -264,100 +275,96 @@ attributes.
\Macro{RedeclareLayer}\OParameter{option list}\Parameter{layer name}%
\Macro{ModifyLayer}\OParameter{option list}\Parameter{layer name}
\end{Declaration}
-These commands can be used to define a layer. The \PName{layer name} has to be
-fully expandable and should expand to letters only. Some additional characters
-are tolerated, but are not recommended.
+These commands can be used to define layers. The \PName{layer name} must be
+fully expandable and should expand to ASCII letters only. Some additional
+characters are accepted, but their use is only recommended for advanced users.
-Command \Macro{DeclareLayer} does not care whether or not a layer with the
+The \Macro{DeclareLayer} command does not care whether or not a layer with the
given \PName{layer name} already exists. It will under all circumstances
-define the layer with the attribute defined by the \PName{option list}. An
-\PName{option} can be either a key or a key followed by an equal sign followed
-by a value. Several options may be concatenated to a \PName{option list} and
-have to be separated by comma. If you'd like to have a comma or a white space
-inside the value of an option, you should put the value inside curly
+define the layer with the attributes specified in the \PName{option list}. An
+\PName{option} can be either a key or a key followed by an equal sign and
+a value. Multiple options are separated by commas. To use a comma or a white
+space within the value of an option, you must put the value inside curly
brackets. See \autoref{tab:scrlayer.layerkeys} for more information on keys,
values, and the corresponding attributes.
-In contrast to \Macro{DeclareLayer} using \Macro{DeclareNewLayer} results in
-an error, if a layer with the same \PName{layer name} already exists. So you
-may prevent yourself using the same \PName{layer name} more than once by
-mistake. This would be useful, e.\,g., if a class or package also defines
-layers internally.
-
-If you use \Macro{ProvideLayer} instead of \Macro{DeclareLayer}, the
-declaration will be ignored in case a layer with the same layer name already
-exists. It could be paraphrased by: \emph{declare the layer only if it has not
- been declared already.}
-
-If an existing layer should be redefined, \Macro{RedeclareLayer} or
-\Macro{ModifyLayer} can be used. \Macro{RedeclareLayer} would simply define
-the layer as if it would be defined newly. In difference to this,
-\Macro{ModifyLayer} would change only those attributes, that are represented
-by an option of the \PName{option list}. All other attributes will stay
-unchanged and will not be reset to the initial default value. Using either
-\Macro{RedeclareLayer} or \Macro{ModifyLayer} will result in an error, in case
-there has not been a layer with \PName{layer name} defined before.
+Unlike \Macro{DeclareLayer}, \Macro{DeclareNewLayer} reports an error if a
+layer with the same \PName{layer name} already exists. This prevents the user
+from accidentally using the same \PName{layer name} more than once. This
+is especially useful when classes or packages also define layers internally.
+
+In contrast, \Macro{ProvideLayer} only defines a layer if there is no layer
+with the same name already. If the name is in use for another layer, the new
+definition is ignored. Therefore this command has the meaning, \emph{define
+ the layer only if it does not already exist.}
+
+If you want to redefine an existing layer, you can use \Macro{RedeclareLayer}
+or \Macro{ModifyLayer}. With \Macro{RedeclareLayer}, the layer is first reset
+to the default settings and then completely redefined via the specified
+options list. In contrast, \Macro{ModifyLayer} does not reset the layer.
+Only those attributes which are explicitly set in the \PName{option list} will
+be changed. Applying either command to a previously undefined \PName{layer
+ name} results in an error.
\begin{desclist}
\desccaption{%
- Options for the definition of page layers with description of the
+ Options for defining page layers and the meaning of the
corresponding layer attribute\label{tab:scrlayer.layerkeys}%
}{%
- Options for the definition of layers (\emph{Continuation})%
+ Options for defining layers (\emph{continued})%
}%
\entry{%
\ChangedAt{v3.16}{\Package{scrlayer}}%
\OptionVName{addcontents}{Code}}{%
- Value \PName{code} will be added (or appended) at the very end of the
- current value of attribute \Option{contents}. So the new content will be
- generated behind the end of the already existing content. For more
- information about the handling of \PName{code} see option
- \Option{contents}.%
+ The specified \PName{code} will be appended to the current value of the
+ \Option{contents} attribute, so the new content will appear at the end of
+ the existing content. For more information about the handling of
+ \PName{code} see the \Option{contents} option.%
}%
\entry{%
\ChangedAt{v3.16}{\Package{scrlayer}}%
\OptionVName{addheight}{additional height}}{%
- The current value of attribute \Option{height} will be increased by the
- value of this option. You can use the same kind of values as for
+ The current value of the \Option{height} attribute will be increased by
+ the value of this option. You can use the same kind of values as for
\Option{height}.%
}%
\entry{%
\ChangedAt{v3.16}{\Package{scrlayer}}%
\OptionVName{addhoffset}{additional horizontal offset}}{%
- The current value of attribute \Option{hoffset} will be increased by the
- value of this option. You can use the same kind of values as for
+ The current value of the \Option{hoffset} attribute will be increased by
+ the value of this option. You can use the same kind of values as for
\Option{hoffset}.%
}%
\entry{%
\ChangedAt{v3.16}{\Package{scrlayer}}%
\OptionVName{addvoffset}{additional vertical offset}}{%
- The current value of attribute \Option{voffset} will be increased by the
- value of this option. You can use the same kind of values as for
+ The current value of the \Option{voffset} attribute will be increased by
+ the value of this option. You can use the same kind of values as for
\Option{voffset}.%
}%
\entry{%
\ChangedAt{v3.16}{\Package{scrlayer}}%
\OptionVName{addwidth}{additional width}}{%
- The current value of attribute \Option{width} will be increased by the
- value of this option. You can use the same kind of values as for
+ The current value of the \Option{width} attribute will be increased by
+ the value of this option. You can use the same kind of values as for
\Option{width}.%
}%
\nentry{\KOption{align}{\PName{alignment characters}}}{%
The \PName{alignment characters} define the desired alignment of the
- layer. Each \PName{alignment character} influences either, how argument
- \PName{length} of option \Option{hoffset} or \Option{voffset} will be
- used. Several \PName{alignment characters} may be used together (without
- comma or space) and will be interpreted in the order of occurrence. No
- macros should be used here! Valid \PName{alignment character}s are:
+ layer. Each \PName{alignment character} determines how the \PName{length}
+ of either the \Option{hoffset} or the \Option{voffset} option is
+ interpreted. Multiple \PName{alignment character}s can be used together
+ (without spaces or commas) and are evaluated in the order they occur.
+ Macros are not permitted in the value of the option. Valid
+ \PName{alignment character}s are:
\begin{description}
- \item[\PValue{b} --] align the layer at its bottom edge; the
- value of
- \Option{voffset} is interpreted as the distance from the top edge of the
- paper to the bottom edge of the layer.
+ \item[\PValue{b} --] align the layer at its bottom edge; the value of
+ \Option{voffset} is the distance from the top edge of the paper to the
+ bottom of the layer.
\item[\PValue{c} --] align the layer at its centre; the values of
\Option{voffset} and \Option{hoffset} are interpreted as the distance
from the top left corner of the paper to the centre of the layer.
- \item[\PValue{l} --] align the layer at its left edge: the value of
+ \item[\PValue{l} --] align the layer at its left edge; the value of
\Option{hoffset} is interpreted as the distance from the left edge of
the paper to the left edge of the layer.
\item[\PValue{r} --] align the layer at its right edge; the value of
@@ -371,228 +378,227 @@ there has not been a layer with \PName{layer name} defined before.
\entry{\KOption{area}{%
\Parameter{hoffset}\Parameter{voffset}%
\Parameter{width}\Parameter{height}}}{%
- The composed option results in \OptionValue{hoffset}{\PName{hoffset}},
- \OptionValue{voffset}{\PName{voffset}},
- \OptionValue{width}{\PName{width}}, \OptionValue{height}{\PName{height}}.%
+ This composite option sets the primary attributes
+ \OptionValue{hoffset}{horizontal offset}, \OptionValue{voffset}{vertical
+ offset}, \OptionValue{width}{width}, \OptionValue{height}{height}.%
}%
\entry{\ChangedAt{v3.18}{\Package{scrlayer}}%
\Option{backandforeground}}{%
- This option removes any foreground or background restriction of the layer.
- Generally usage of this option makes no sense, but it is provided for
- completeness of the user interface. The option does not expect any value.%
+ This option removes the restriction of a layer to the foreground or the
+ background. In general, this option makes little sense, but it is provided
+ for the sake of a complete user interface. This option does not expect or
+ allow a value.%
}%
\entry{\Option{background}}{%
- Print the layer only in the background, but not in the foreground. This
- makes a background-only layer in opposite to the default of layers which
- are both, background and foreground layers and therefore would be printed
- twice. The option does not expect any value. By the default the attribute
- is not set.%
+ This option displays the layer in the background only. The default is to
+ display layers in both the background and the foreground. This option does
+ not expect or allow a value.%
}%
\entry{\Option{bottommargin}}{%
- The composed option sets \Option{hoffset}, \Option{voffset},
- \Option{width}, \Option{height}, and \Option{align} to horizontally span
- the paper from the left edge to the right and vertically span the area
- below the footer down to the bottom edge of the paper.%
+ This composite option sets the primary attributes \Option{hoffset},
+ \Option{voffset}, \Option{width}, \Option{height}, and \Option{align} so
+ that the layer spans the paper horizontally from the left edge to the
+ right and vertically from immediately beneath the footer to the bottom
+ edge of the paper.%
}%
\entry{\KOption{clone}{\PName{layer name}}}{%
- The composed option sets all primary attributes of the layer to the same
+ This composite option sets all primary attributes of the layer to the same
values as the primary attributes of the layer with the given \PName{layer
- name}. Note, that \PName{layer name} has to be fully expandable and
- should expand to letters only. Some additional characters are tolerated,
- but are not recommended!%
+ name}. See the notes on the \PName{layer name} at the beginning of the
+ explanation for \Macro{DeclareLayer}. The layer to be cloned must also
+ already exist.%
}%
\entry{\KOption{contents}{\PName{code}}}{%
- The \PName{code} will be expanded whenever the layer is printed. So the
- \PName{code} is what you will see. Code validity is not checked. So errors
- in \PName{code} may result in several failures on each page, that prints
- the layer.%
+ The specified \PName{code} will be expanded whenever the layer is printed.
+ This \PName{code} defines what you see for the layer. No tests are made to
+ see if the code is valid. Errors in the \PName{code} can therefore lead to
+ multiple error messages on each page that prints the layer.%
}%
\entry{\Option{evenpage}}{%
- Print the layer on even pages only, but not on odd pages. The option does
- not expect any value. By the default the option is not set and therefore
- layers would be printed on odd pages and on even pages. Note, that this
- attribute subsumes \Option{twoside}.%
+ This option causes the layer to appear on even pages only, unlike the
+ default, where a layer will appear on both even and odd pages. Since even
+ pages only appear in two-sided printing, this option implies
+ \Option{twoside}. This option does not expect or allow a value.%
}%
\entry{\ChangedAt{v3.18}{\Package{scrlayer}}%
\Option{everypage}}{%
- This is a combination of \Option{oddorevenpage} and
- \Option{floatornonfloatpage}. The option does not expect any value.%
+ This option is a combination of \Option{oddorevenpage} and
+ \Option{floatornonfloatpage}. This option does not expect or allow a
+ value.%
}%
\entry{\Option{everyside}}{%
- This option removes any restriction of the layer to single side or double
- side printing. This is also the default of layers. The option does not
- expect any value.%
+ This option removes any restriction of the layer to one-sided or two-sided
+ printing. This is the default setting. This option does not expect or
+ allow a value.%
}%
\entry{\ChangedAt{v3.18}{\Package{scrlayer}}%
\Option{floatornonfloatpage}}{%
This option removes any restriction of the layer to float or non-float
- pages. So the layer will be printed independent of whether a page is a
- float page or not. This is also the default of layers. The option does
- not expect any value.%
+ pages and restores the default setting. This option does not expect or
+ allow a value.%
}%
\entry{\Option{floatpage}}{%
- Print the layer on float pages only, but not on other pages. The option
- does not expect any value. By the default the attribute is not set and
- therefore layers would be printed on float pages and on non-float pages.%
+ This option restricts the layer to appearing on float pages only. The
+ default setting is for layers to appear on both float and non-float pages.
+ This option does not expect or allow a value.%
}%
\entry{\Option{foot}}{%
- The composed option sets \Option{hoffset}, \Option{voffset},
- \Option{width}, \Option{height}, and \Option{align} to horizontally span
- the text area and vertically span the page footer defined by the new
- \LaTeX{} length \Length{footheight}.%
+ This composite option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} so that the layer
+ spans the page footer over the width of the text area. This option does
+ not expect or allow a value.%
}%
\entry{\Option{footskip}}{%
- The composed option sets \Option{hoffset}, \Option{voffset},
- \Option{width}, \Option{height}, and \Option{align} to horizontally span
- the text area and vertically span the distance between the text area and
- the page footer (note, that this is not the same like \Length{footskip}).%
+ This composite option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} so that the layer
+ spans the vertical distance between the text area and the page footer over
+ the width of the text area. Note, however, that although the height of
+ this area depends on \Length{footskip}, it is not the same. This option
+ does not expect or allow a value.%
}%
\entry{\Option{foreground}}{%
- Print the layer only in the foreground, but not in the background. This
- makes a foreground-only layer in opposite to the default of layers which
- are both, background and foreground layers and therefore would be printed
- twice. The option does not expect any value. By the default the attribute
- is not set.%
+ This option displays the layer in the foreground only. The default is to
+ display layers in both the background and the foreground. The option does
+ not expect or allow a value.%
}%
\entry{\Option{head}}{%
- The composed option sets \Option{hoffset}, \Option{voffset},
- \Option{width}, \Option{height}, and \Option{align} to horizontally span
- the text area and vertically span the page head defined by usual \LaTeX{}
- length \Length{headheight}.%
+ This composite option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} so that the layer
+ spans the vertical area of the page header for the width of the text area.
+ The height corresponds to the length \Length{headheight}. This option does
+ not expect or allow a value.%
}%
\entry{\Option{headsep}}{%
- The composed option sets \Option{hoffset}, \Option{voffset},
- \Option{width}, \Option{height}, and \Option{align} to horizontally span
- the text area and vertically span the distance between the page head and
- the text area.%
+ This composite option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} so that the layer
+ spans the vertical distance between the page header and the text area for
+ the width of the text area. The height corresponds to the length
+ \Length{headsep}. This option does not expect or allow a value.%
}%
\entry{\KOption{height}{\PName{length}}}{%
- Sets the height of the layer. Note, that \PName{length} can either be a
- \LaTeX{} length, declared using \Macro{newlength}, or a \TeX{} length,
- declared using \Macro{newdimen} or \Macro{newskip}, a length value like
- 10\,pt, or a dimensional expression using +, -, /, *, (, and ). For more
- information about valid dimensional expressions see
- \cite[section~3.5]{manual:eTeX}.%
+ Sets the height of the layer. Note that the \PName{length} can be a
+ \LaTeX{} length declared with \Macro{newlength}, a \TeX{} length declared
+ with \Macro{newdimen} or \Macro{newskip}, a length value like 10\,pt, or a
+ dimensional expression using +, -, /, *, (, and ). For more information
+ about valid dimensional expressions see \cite[section~3.5]{manual:eTeX}.%
}%
\entry{\KOption{hoffset}{\PName{length}}}{%
- Sets the offset of the layer (depending on \Option{align} either left edge
- of the layer, middle of the layer or right edge of the layer) from the
- left edge of the paper. See \Option{height} for more information about
- valid content of \PName{length}.%
+ Sets the distance of the layer from the left edge of the paper. How the
+ distance is measured depends on the \Option{align} option. See the
+ \Option{height} option for more information about valid expressions for
+ \PName{length}.%
}%
\entry{\Option{innermargin}}{%
- The composed option sets \Option{hoffset}, \Option{voffset},
- \Option{width}, \Option{height}, and \Option{align} to horizontally span
- the distance between the right edge of text area and the right edge of the
- paper on even pages or the distance between the left edge of the paper and
- the left edge of the text area on odd pages and vertically span the whole
- paper from the top edge to the bottom edge.%
+ This composite option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} so that the layer
+ spans the inner margin, from the edge of the page to the edge of the text
+ area and from the top to the bottom of the page. In one-sided printing,
+ the inner margin corresponds to the left margin. This option does not
+ expect or allow a value.%
}%
\entry{\Option{leftmargin}}{%
- The composed option sets \Option{hoffset}, \Option{voffset},
- \Option{width}, \Option{height}, and \Option{align} to horizontally span
- the distance between the left edge of the paper and the left edge of the
- text area and vertically span the whole paper from the top edge to the
- bottom edge.%
+ This composite option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} so that the layer
+ spans the left margin, from the left edge of the paper to the left edge of
+ the text area and from the top of the paper to the bottom. This option
+ does not expect or allow a value.%
}%
\entry{\ChangedAt{v3.19}{\Package{scrlayer}}%
\OptionVName{mode}{mode}}{%
- The primary option defines the \PName{mode} for the layer output. Default
- is \OptionValue{mode}{text}. The Baseline of the first text line will be
- placed the height of one standard text line below the top edge of the
- layer. Therefore the text output will be top aligned in the layer. In
- \PValue{picture} \PName{mode} the layer spans a \Environment{picture}
- environment with the origin in the bottom left corner of the layer. The
- also available \PValue{raw} \PName{mode} current is the same like
- \PValue{text} \PName{mode}.
-
- Changing\textnote{Attention!} the \PName{mode} of a layer generally can
- move the contents. Additionally, i.\,e., \PValue{picture} \PName{mode}
+ This primary option defines the \PName{mode} in which the layer's content
+ is output. The default is \OptionValue{mode}{text}. The baseline of the
+ first text line is placed the height of one standard text line below the
+ top edge of the layer, so the text is usually neatly aligned with the top
+ of the layer. In \PValue{picture} \PName{mode}, on the other hand, the
+ layer spans a \Environment{picture} environment with the origin at the
+ bottom left corner of the layer. The \PValue{raw} \PName{mode} is also
+ also defined. By default it corresponds to \PValue{text} \PName{mode}.
+ Changing\textnote{Attention!} the \PName{mode} of a layer usually results
+ the contents shifting. Furthermore, the \PValue{picture} \PName{mode}
provides additional commands that result in errors with another
- \PName{mode}. Therefore, generally it makes no sense to change the
- \PName{mode} of a layer after it's initial declaration!%
+ \PName{mode}. Therefore it usually makes no sense to change the
+ \PName{mode} of a layer after its initial declaration!%
}%
\entry{\Option{nonfloatpage}}{%
- Restricts the layer to pages, that are not float pages. The option does
- not expect any value. By the default the attribute is not set and
- therefore layers would be printed on float pages and on non-float pages.%
+ This option restricts the layer to pages that are not float pages. The
+ default is for the layer to appear on both float and non-float pages. This
+ option does not expect or allow a value.%
}%
\entry{\ChangedAt{v3.18}{\Package{scrlayer}}%
\Option{oddorevenpage}}{%
- Removes any restriction of the layer to odd or even pages. So it will be
- printed independently of whether a page is odd or even. This is also the
- default of layers. The option does not expect any value.%
+ This option removes any restriction of the layer to odd or even pages,
+ restoring the default behaviour that the layer should appear on both odd
+ and even pages. The option does not expect or allow a value.%
}%
\entry{\Option{oddpage}}{%
- Print the layer on odd pages only, but not on even pages. The option does
- not expect any value. By the default the option is not set and therefore
- layers would be printed on odd pages and on even pages.%
+ This option restricts the layer to odd pages only. The default is for
+ layers to appear on both odd pages and on even pages. Note that in
+ one-sided printing, all pages are odd, regardless of the page number. This
+ option does not expect or allow a value.%
}%
\entry{\Option{oneside}}{%
- Print the layer in single-side mode only, but not in two-side mode. The
- option does not expect any value. By the default the attribute is not set
- and therefore layers would be printed in single-side and two-side mode.%
+ This option restricts the layer to one-sided printing only. The default is
+ for layers to appear in both one-sided and two-sided printing. This option
+ does not expect or allow a value.%
}%
\entry{\Option{outermargin}}{%
- The composed option sets \Option{hoffset}, \Option{voffset},
- \Option{width}, \Option{height}, and \Option{align} to horizontally span
- the distance between the left edge of the paper and the left edge of the
- text area on even pages or the distance between the right edge of the text
- area and the right edge of the paper on odd pages and vertically span the
- whole paper from the top edge to the bottom edge.%
+ The composite option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} so that the layer
+ spans the outer margin of the page, from the top to the bottom of the
+ paper. The outer margin corresponds to the right margin in one-sided
+ printing. This option does not expect or allow a value.%
}%
\entry{\Option{page}}{%
- The composed option sets \Option{hoffset}, \Option{voffset},
- \Option{width}, \Option{height}, and \Option{align} to horizontally and
- vertically span the whole paper from the left edge to the right edge and
- the top edge to the bottom edge.%
+ This composite option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} so that the layer
+ spans the the whole paper. This option does not expect or allow a value.%
}%
\entry{\ChangedAt{v3.16}{\Package{scrlayer}}%
\OptionVName{pretocontents}{code}}{%
- Value \PName{code} will be added at the very beginning of the current
- value of attribute \Option{contents}. So the new content will be generated
- in front of the already existing content. For more information about the
- handling of \PName{code} see option \Option{contents}.%
+ The value of \PName{code} is prefixed the current value of the
+ \Option{contents} attribute, so the new content will appear before the
+ existing content. For more information about the handling of \PName{code},
+ see the \Option{contents} option.%
}%
\entry{\Option{rightmargin}}{%
- The composed option sets \Option{hoffset}, \Option{voffset},
- \Option{width}, \Option{height}, and \Option{align} to horizontally span
- the distance between the right edge of text area and the right edge of the
- paper and vertically span the whole paper from the top edge to the bottom
- edge.%
+ This composite option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} so that the layer
+ spans the right margin, from the right edge of the text area to the right
+ edge of the paper and from the top to the bottom edge of the paper. This
+ option does not expect or allow a value.%
}%
\entry{\Option{textarea}}{%
- The composed option sets \Option{hoffset}, \Option{voffset},
- \Option{width}, \Option{height}, and \Option{align} to horizontally and
- vertically span the whole text area from the left edge to the right edge
- and the top edge to the bottom edge.%
+ This composite option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} so that the layer
+ spans the entire text area. This option does not expect or allow a value.%
}%
\entry{\Option{topmargin}}{%
- The composed option sets \Option{hoffset}, \Option{voffset},
- \Option{width}, \Option{height}, and \Option{align} to horizontally span
- the whole page from the left edge to the right edge and vertically span
- the distance between the top edge of the paper and the page head.%
+ This composite option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} so that the layer
+ spans the vertical distance between the top edge of the paper to the
+ header for the entire width of the paper. This option does not expect or
+ allow a value.%
}%
\entry{\Option{twoside}}{%
- Print the layer in two-side mode only, but not in single-side mode. The
- option does not expect any value. By the default the attribute is not set
- and therefore layers would be printed in single-side and two-side mode.%
+ This option restricts the layer to two-sided printing. The default is for
+ layers to appear in both one-sided and two-sided printing. This option
+ does not expect or allow a value.%
}%
\entry{\ChangedAt{v3.18}{\Package{scrlayer}}%
\Option{unrestricted}}{%
- This option removes all output restrictions of the layer. It is a
- combination of \Option{backandforeground}, \Option{everyside}, and
- \Option{floatornonfloatpage}. The option does not expect any value.%
+ This option removes all output restrictions. It is a combination of
+ \Option{backandforeground}, \Option{everyside}, and
+ \Option{floatornonfloatpage}. This option does not expect or allow a
+ value.%
}%
\entry{\KOption{voffset}{\PName{length}}}{%
- Sets the offset of the layer (depending on \Option{align} either top edge
- of the layer, middle of the layer or bottom edge of the layer) from the
- top edge of the paper. See \Option{height} for more information about
- valid content of \PName{length}.%
+ Sets the distance of the layer from the top of the paper. How the distance
+ is measured depends on the \Option{align} option. See the \Option{height}
+ option for more information about valid expressions for \PName{length}.%
}%
\entry{\KOption{width}{\PName{length}}}{%
- Sets the width of the layer. See \Option{height} for more information
- about valid content of \PName{length}.%
+ Sets the width of the layer. See the \Option{height} option for more
+ information about valid expressions for \PName{length}.%
}%
\end{desclist}
%
@@ -607,46 +613,48 @@ there has not been a layer with \PName{layer name} defined before.
\Macro{layerwidth}%
\Macro{layerheight}%
\end{Declaration}
-These commands are valid during output of the layer's contents only. So they
-can only be used inside the \PName{code} of option \Option{contents} of the
-previously described commands. In this case they give the effective alignment,
-position and dimension of the layer, that will be used for the
-output. However, the effective dimension of the layer's contents may differ,
-i.\,e., if the contents are oversized or do not fill the layer
-completely.
+These commands are only valid in the \PName{code} specified with
+\Option{contents}, \Option{addcontents}, or \Option{pretocontents}. In this
+case, they contain the layer's actual alignment, position, and dimensions that
+will be used for the output. However, this is not necessarily the actual
+dimensions of the layer's contents, e.\,g., if the contents are oversized or
+do not fill the layer completely.
The primary layer attribute \PValue{align} is mapped to
\Macro{layerhalign}\ChangedAt{v3.19}{\Package{scrlayer}} and
\Macro{layervalign}. The horizontal values \PValue{l} and \PValue{r} are
-copied to \Macro{layerhalign}. The vertical values \PValue{r} and \PValue{b}
-are copied to \Macro{layervalign}. The also horizontal and vertical value
-\PValue{c} is copied to both commands. If \PValue{align} has contradictory
-values, only the last one is copied. Therefore the resulting
-\Macro{layerhalign} is either \PValue{l}, \PValue{c}, or \PValue{r} and the
-resulting \Macro{layervalign} is either \PValue{r}, \PValue{c}, or \PValue{b}.
-
-Redefinition of the commands to change the stored values is strictly forbidden
-and would result in unpredictable issues.%
+copied to \Macro{layerhalign}. The vertical values \PValue{t} and \PValue{b}
+are copied to \Macro{layervalign}. The value \PValue{c}, which is both
+horizontal and vertical, is copied to both commands. If there are several
+conflicting values for \PValue{align}, only the last one is copied. Thus the
+resulting \Macro{layerhalign} is either \PValue{l}, \PValue{c}, or \PValue{r},
+and the resulting \Macro{layervalign} is either \PValue{r}, \PValue{c}, or
+\PValue{b}.
+
+Redefining\textnote{Attention!} these instructions to change the values stored
+in them is not permitted, as it would lead to unpredictable results.%
\EndIndexGroup
\begin{Declaration}
\Macro{LenToUnit}\Parameter{length}
\end{Declaration}
-This\ChangedAt{v3.19}{\Package{scrlayer}} command has been copied from
-\Package{eso-pic}\IndexPackage{eso-pic} 2.0f. It converts lengths into
-multiples of \Length{unitlength}. It can be used everywhere \LaTeX{}
-expects \Environment{picture} coordinates or \Length{unitlength}-depending
-values. For more information see \cite{package:eso-pic} and the following
-descriptions of \Macro{putUR}, \Macro{putLL}, and \Macro{putLR}. If the
-command is already defined, e.\,g., by loading \Package{eso-pic} before
+This\ChangedAt{v3.19}{\Package{scrlayer}} command originally came from
+\Package{eso-pic}\IndexPackage{eso-pic}~2.0f. It converts lengths into
+multiples of \Length{unit length} and can therefore be used everywhere \LaTeX{}
+expects \Environment{picture} coordinates or \Length{unit length}-dependent
+values. For more information, see \cite{package:eso-pic} and the descriptions
+of \Macro{putUR}, \Macro{putLL}, and \Macro{putLR} below. If the command is
+already defined, e.\,g., by loading \Package{eso-pic} before
\Package{scrlayer}, the package does not define it again.%
-
+\iffalse% Umbruchkorrekturtext
+\par
It should be noted at this point that using package
\Package{picture}\IndexPackage{picture}\textnote{\Package{picture}} (see
\cite{package:picture}) supersedes \Macro{LenToUnit} more or less. The package
-extends environment \Environment{picture} and the picture commands to accept
-\LaTeX{} lengths directly.%
+extends environment \Environment{picture} and the picture commands so that you
+can use \LaTeX{} lengths directly for coordinates.%
+\fi
\EndIndexGroup
@@ -658,180 +666,198 @@ extends environment \Environment{picture} and the picture commands to accept
\Macro{putC}\Parameter{content}
\end{Declaration}
You\ChangedAt{v3.19}{\Package{scrlayer}} can use these commands inside the
-value of primary layer option \PValue{contents}, if the layer is declared with
-\OptionValue{mode}{picture}. In that case, \Macro{putUL} places the
+value of \PValue{contents} layer option if the layer is declared with
+\OptionValue{mode}{picture}. In this case, \Macro{putUL} places the
\PName{content} relative to the upper left corner of the layer and therefore
-is the same like
+is the same as
\lstinline[breaklines=false]|\put(0,\LenToUnit{\layerheight})|. \Macro{putUR}
places the \PName{content} relative to the upper right corner of the layer and
-therefore is the same like
-\lstinline[breaklines=false]|\put(\LenToUnit{\layerwidth},\LenToUnit{\layerheight})|.
+therefore is the same as
+\lstinline[breaklines=false]
+|\put(\LenToUnit{\layerwidth},\LenToUnit{\layerheight})|.
\Macro{putLL} places the \PName{content} relative to the lower left corner of
-the layer and therefore is the same like
+the layer and therefore is the same as
\lstinline[breaklines=false]|\put(0,0)|. \Macro{putLR} places the
\PName{content} relative to the lower right corner and therefore is the same
-like \lstinline[breaklines=false]|\put(\LenToUnit{\layerwidth},0)|. Last but
-not least \Macro{putC} places the \PName{content} relative to the centre of
+as \lstinline[breaklines=false]|\put(\LenToUnit{\layerwidth},0)|. Last but
+not least, \Macro{putC} places the \PName{content} relative to the centre of
the layer.%
\begin{Example}
- You want to investigate, how accurate
+ You want to determine exactly how accurately
\OptionValueRef{typearea}{DIV}{classic} sets the height of the text area to
- the width of the page size. So you declare a layer that not only border the
- text area, but also places a circle with paper width as diameter dimension
- into the centre of the text area:
+ the width of the page size. You declare a layer that both borders the text
+ area and places a circle with a diameter of the paper width in the centre of
+ the text area:
\begin{lstcode}
-\documentclass[DIV=classic]{scrartcl}
-\usepackage{pict2e}
-\usepackage{scrlayer}
-\DeclareNewLayer[%
- textarea,background,mode=picture,
- contents={%
- \putLL{\line(1,0){\LenToUnit{\layerwidth}}}%
- \putLR{\line(0,1){\LenToUnit{\layerheight}}}%
- \putUR{\line(-1,0){\LenToUnit{\layerwidth}}}%
- \putUL{\line(0,-1){\LenToUnit{\layerheight}}}%
- \putC{\circle{\LenToUnit{\paperwidth}}}%
- }
-]{showtextarea}
-\DeclareNewPageStyleByLayers{test}{showtextarea}
-\pagestyle{test}
-\begin{document}
-\null
-\end{document}
+ \documentclass[DIV=classic]{scrartcl}
+ \usepackage{pict2e}
+ \usepackage{scrlayer}
+ \DeclareNewLayer[%
+ textarea,background,mode=picture,
+ contents={%
+ \putLL{\line(1,0){\LenToUnit{\layerwidth}}}%
+ \putLR{\line(0,1){\LenToUnit{\layerheight}}}%
+ \putUR{\line(-1,0){\LenToUnit{\layerwidth}}}%
+ \putUL{\line(0,-1){\LenToUnit{\layerheight}}}%
+ \putC{\circle{\LenToUnit{\paperwidth}}}%
+ }
+ ]{showtextarea}
+ \DeclareNewPageStyleByLayers{test}{showtextarea}
+ \pagestyle{test}
+ \begin{document}
+ \null
+ \end{document}
\end{lstcode}
- You will see that \Package{typearea}'s mapping to an integer \PName{DIV}
+ You will notice that \Package{typearea}'s mapping to an integer \PName{DIV}
value is very accurate in this example.
\end{Example}
-For more information about the sketched Middle Age method of generating a text
-area see \autoref{sec:typearea.circleConstruction},
+Incidentally, you will find more information about late medieval book-page
+canon sketched in the example in \autoref{sec:typearea.circleConstruction},
\autopageref{sec:typearea.circleConstruction}.
-For more information about command
-\Macro{DeclareNewPageStyleByLayers}\IndexCmd{DeclareNewPageStyleByLayers} see
-the description later in \autoref{sec:scrlayer.pagestyles},
-\DescPageRef{scrlayer.cmd.DeclareNewPageStyleByLayers}. In short: It
-defines a new page style using the newly declared layer.%
+The \Macro{DeclareNewPageStyleByLayers}\IndexCmd{DeclareNewPageStyleByLayers}
+command just used in the example defines a new page style using the newly
+declared layer. It will be explained in \autoref{sec:scrlayer.pagestyles},
+\DescPageRef{scrlayer.cmd.DeclareNewPageStyleByLayers}.%
\EndIndexGroup
\begin{Declaration}
- \Macro{GetLayerContents}\Parameter{layer name}
+ \Macro{GetLayerContents}\Parameter{layer~name}
\end{Declaration}
-This\ChangedAt{v3.16}{\Package{scrlayer}} command results in the whole content
-of a layer. You have to note\textnote{Attention!} that using this
+This\ChangedAt{v3.16}{\Package{scrlayer}} command returns the whole contents
+of a layer. It is important to note\textnote{Attention!} that using this
command inside the \PName{code} of the layer attributes \Option{contents},
\Option{addcontents}, or \Option{pretocontents} can result in
-an infinite recursion, if the content of the current layer is referenced. You
-yourself should avoid such situations!%
+infinite recursion when referencing the contents of the current layer. You
+are responsible for avoiding such situations!%
\EndIndexGroup
\begin{Declaration}
- \Macro{IfLayerExists}%
- \Parameter{string}\Parameter{then-code}\Parameter{else-code}
+ \Macro{IfLayerExists}\Parameter{layer~name}
+ \Parameter{then-code}\Parameter{else-code}
\end{Declaration}
-This command may be used to execute code depending on whether or not a layer
-has been defined already. If the layer exists \PName{then-code} will be
-executed, otherwise \PName{else-code}. Note, the command cannot really
-test whether a layer exists. It uses a heuristic, that will never be false
-negative, but may be false positive. Nevertheless, if it is false positive
-something went wrong, either an incompatible package has been used or the user
-made something he should not do.%
+This command can be used to execute code depending on whether or not a layer
+with the specified \PName{layer name} exists. If the layer exists, the
+\PName{then-code} will be executed; otherwise, the \PName{else-code} will be
+executed. Note that the command cannot really test whether a layer exists.
+Instead it uses a heuristic which will never yield a false negative but which,
+in extreme cases, could yield a false positive.
+\iffalse% Umbruchvarianten
+Nevertheless, if the test yields a false positive, something has gone wrong.
+For example, this could indicate an incompatible package or that the user is
+doing something he or she should not.%
+\else
+False positives indicate a problem, such as the use of an incompatible package
+or a bad choice of internal macro names by the user.
+\fi
\EndIndexGroup
\begin{Declaration}
- \Macro{DestroyLayer}\Parameter{layer name}
+ \Macro{DestroyLayer}\Parameter{layer~name}
\end{Declaration}
-This command sets all macros corresponding with the layer with given
-\PName{layer name} to \Macro{relax}, if a layer with that name exists. As a
-result the layer cannot be used any longer. It does not matter, if the layer
-is still part of the layer list of a page style, because such destroyed layers
-will be ignored. Nevertheless, destroyed layers may be defined again using
-\DescRef{\LabelBase.cmd.DeclareNewLayer} or
-\DescRef{\LabelBase.cmd.ProvideLayer}, but cannot be changed using
+If a layer with the given \PName{layer name} exists, all macros belonging to
+it will be set to \Macro{relax}. In page styles already defined with
+\Package{scrlayer}, such destroyed layers are ignored. Destroyed layers can be
+redefined using \DescRef{\LabelBase.cmd.DeclareNewLayer} or
+\DescRef{\LabelBase.cmd.ProvideLayer}, but they can no longer be changed using
\DescRef{\LabelBase.cmd.RedeclareLayer} or
-\DescRef{\LabelBase.cmd.ModifyLayer} any longer.
+\DescRef{\LabelBase.cmd.ModifyLayer}.
The command is intended to be used inside
-\DescRef{\LabelBase.cmd.scrlayerOnAutoRemoveInterface} to remove layers, which have been
-defined using removable macros of an interface, whenever the interface would
-be removed.%
+\DescRef{\LabelBase.cmd.scrlayerOnAutoRemoveInterface} (see
+\autoref{sec:scrlayer.enduserinterfaces},
+\DescPageRef{scrlayer.cmd.scrlayerOnAutoRemoveInterface})
+to remove layers defined using removable macros of an interface along with
+that interface.%
\EndIndexGroup
\begin{Declaration}
\Macro{layercontentsmeasure}%
\end{Declaration}
-The command \Macro{layercontentsmeasure} prints a ruler at each layer edge, of
-which the top and left one is labelled with centimeters, the right and bottom
-one with inches. This command is used internally, if option
-\DescRef{\LabelBase.option.draft}\IndexOption{draft} is enabled. The rulers
-will be drawn behind the content of each layer. It can also be used as
-exclusive content of a layer.%
+The \Macro{layercontentsmeasure} command prints a ruler at each layer edge, of
+which the top and left one is labelled in centimetres and the right and bottom
+one in inches. This command is used internally if the
+\DescRef{\LabelBase.option.draft}\IndexOption{draft} option is enabled. The
+rulers are drawn behind the content of each layer. This command can also be
+used as exclusive content of a layer.%
\EndIndexGroup
-\section{Declaration and Management of Page Styles}
+\section{Declaring and Managing Page Styles}
\seclabel{pagestyles}
-Until now we know layers, but we do not know how to use them. The
-perhaps astonishing answer is: with page styles. In \LaTeX{}, page
-styles usually define heads and foots of odd and even pages.
-
-The head and foot of odd pages will be printed on pages with odd
-page number in two-side mode or on all pages in single-side mode. This is
-something like the layer attributes \Option{oddpage} and \Option{evenpage}.
-
-The page head will be printed before the main contents of a page. The page
-footer will be printed after the main contents of a page. So this is something
-like the layer attributes \Option{background} and \Option{foreground}.
-
-So it suggests itself to declare page styles as a list of layers. But instead of
-having only four attributes \Option{oddpage}, \Option{evenpage},
-\Option{background}, and \Option{foreground} all the attributes of layers
-shown in \autoref{sec:scrlayer.layers} may be used.
-
-The outcome of all such considerations is that layer page styles are one type
-of page styles \Package{scrlayer} provides. A layer page style consists of
-layers and several \emph{hooks}. For description of layers see
-\autoref{sec:scrlayer.layers}. The \emph{hooks} are points in the expansion
-or execution of page styles you may add additional code to. Advanced users
-know this already from commands like \Macro{AtBeginDocument} (see
-\cite{latex:usrguide}) or \Macro{BeforeClosingMainAux} (see
+\BeginIndexGroup
+\BeginIndex{}{page>style}%
+We now understand how to define and manage layers, but so far we do not know
+how they are used. The possibly surprising answer is, with page styles. In
+\LaTeX{}, page styles usually define headers and footers of the page.
+
+The header and footer of odd or right-hand pages\textnote{even or odd page}
+are printed on pages with odd page numbers in two-sided printing or on all
+pages in one-sided printing. This is directly comparable to the layer
+options\important[i]{\Option{evenpage}\\\Option{oddpage}} \Option{oddpage} and
+\Option{evenpage}.
+
+The page header\textnote{header or footer} is output before the main page
+contents. The page footer is output after the main page contents. This
+corresponds directly to the layer
+options\important[i]{\Option{background}\\\Option{foreground}}
+\Option{background} and \Option{foreground}.
+
+Therefore it makes sense to define page styles as lists of layers. But instead
+of just the four options mentioned above, you can use all the properties
+explained in \autoref{sec:scrlayer.layers}, \autoref{tab:scrlayer.layerkeys},
+on \autopageref{tab:scrlayer.layerkeys}.
+
+As a result of these considerations, layer page
+styles\textnote{layer page style}\Index{page style>layer}%
+\Index{layer>page style}\Index{page>style} are one type of page style that
+\Package{scrlayer} provides. A layer page style consists of layers as well as
+several hooks. The layers have already been described in
+\autoref{sec:scrlayer.layers}. The hooks\Index[indexmain]{hooks}%
+\textnote{hooks} are points in the expansion or execution of page styles to
+which you can add code. Experienced users already know this concept from
+commands like \Macro{AtBeginDocument} (see \cite{latex:usrguide}) or
+\DescRef{scrlfile.cmd.BeforeClosingMainAux} (see
\DescPageRef{scrlfile.cmd.BeforeClosingMainAux}).
-Alias page styles are another type of page styles provided by
-\Package{scrlayer}. An alias page style wraps another page style. In other
-words, the name of an alias page style is an alias name of another page style,
-the aliased or original page style. Because of this, the manipulation of an
-alias page style results in the manipulation of the original page style. If
-the original page style is an alias page style too, the manipulation will
-result in the manipulation of the aliased page style of that original page
-style and so on until a real page style will be manipulated. Aliasing is not
-restricted to \Package{scrlayer} page styles, but possible for all page
-styles.
+Page-style aliases are another type of page style which \Package{scrlayer}
+provides. A page-style alias is actually a different page style. In other
+words, the name of a page-style alias is an alternative name for another
+page-style alias or for a page style. As a result, manipulating a page-style
+alias results in manipulating the original page style. If the original page
+style is itself an alias, its manipulation again results in the manipulation
+of the alias's original page style, and so on until a real page style is
+finally changed. The term \emph{real page style}\textnote{real page style} is
+used to distinguish it from a page-style alias. All page styles that are not
+page-style aliases are real page styles. Aliases can be defined for all page
+styles, not just those defined with \Package{scrlayer}.
\begin{Declaration}
\Macro{currentpagestyle}
\end{Declaration}
-Package scrlayer patches \DescRef{maincls.cmd.pagestyle} to set
-\Macro{currentpagestyle} to the currently active page style. Note,
-\DescRef{maincls.cmd.thispagestyle} does not change
-\Macro{currentpagestyle}. But if you use \DescRef{maincls.cmd.thispagestyle}
-the result of \Macro{currentpagestyle} may be changed while executing the
-\LaTeX{} output routine. However, this change will only occur, if
-\Macro{currentpagestyle} has been actively protected from expansion up to
-execution of the output routine.
-
-Note, the layer page styles described later in this section, will not need the
-patch of \DescRef{maincls.cmd.pagestyle} to set \Macro{currentpagestyle}. The
-patch has been made for usage with other page styles. Additionally,
-\Macro{currentpagestyle} is empty before the first
-\DescRef{maincls.cmd.pagestyle} after loading \Package{scrlayer}. So if you
-define an end user page style interface, it may be useful to use an implicit
-\DescRef{maincls.cmd.pagestyle} to set the current page style to a default
-page style.%
+The \Package{scrlayer} package patches the \DescRef{maincls.cmd.pagestyle}
+command so that it sets \Macro{currentpagestyle} to the currently active page
+style. Note that \DescRef{maincls.cmd.thispagestyle} does not change
+\Macro{currentpagestyle}. If you use \DescRef{maincls.cmd.thispagestyle},
+however, \Macro{currentpagestyle} can change within the \LaTeX{} output
+routine. However, this change will only occur if \Macro{currentpagestyle} has
+been actively protected from expansion until the execution of the output
+routine.
+
+Note that the layer page styles described later in this section do not rely on
+this \DescRef{maincls.cmd.pagestyle} extension because they redefine
+\Macro{currentpagestyle} themselves. This patch was made so that other,
+non-\Package{scrlayer} page styles can use \Macro{currentpagestyle}.
+Additionally, \Macro{currentpagestyle} is empty after loading
+\Package{scrlayer} and before using \DescRef{maincls.cmd.pagestyle} for the
+first time. Therefore, when defining an end-user interface, you may find it
+useful to set the current page style to a default with an implicit
+\DescRef{maincls.cmd.pagestyle} statement.%
\EndIndexGroup
@@ -839,201 +865,248 @@ page style.%
\Macro{BeforeSelectAnyPageStyle}\Parameter{code}%
\Macro{AfterSelectAnyPageStyle}\Parameter{code}%
\end{Declaration}
-The command \Macro{BeforeSelectAnyPageStyle} adds \PName{code} to the hook
-that will be executed inside of \DescRef{maincls.cmd.pagestyle} just before
-the page style will be selected. You may use \texttt{\#1} as a placeholder for
-the argument of \DescRef{maincls.cmd.pagestyle}.
-
-The command \Macro{AfterSelectAnyPageStyle} is similar, but the \PName{code}
-will be executed just after the page style has been selected and after
-\DescRef{\LabelBase.cmd.currentpagestyle} has been set to the name of the real
-page style.
-
-Note\textnote{Attention!}, \PName{code} of both commands will be executed only
-if a page style will be selected using \DescRef{maincls.cmd.pagestyle}, but
-not, e.\,g., if a page style will be selected using
-\DescRef{maincls.cmd.thispagestyle}. Note also, you cannot remove \PName{code}
-from the hook after adding it. But the \PName{code} will be added locally, so
-you may use a group to limit the scope of \PName{code}.%
+The \Macro{BeforeSelectAnyPageStyle} command adds \PName{code} to the hook%
+\textnote{hook} that will be executed inside \DescRef{maincls.cmd.pagestyle},
+just before the page style is selected. Within the \PName{code}, you can use
+\texttt{\#1} as a place-holder for the argument of
+\DescRef{maincls.cmd.pagestyle}.
+
+The \Macro{AfterSelectAnyPageStyle} command works similarly, but the
+\PName{code} will be executed just after the page style has been selected and
+after \DescRef{\LabelBase.cmd.currentpagestyle} has been set to the name of
+the real page style.
+
+Note\textnote{Attention!} that the \PName{code} of both commands is executed
+only if a page style is selected with \DescRef{maincls.cmd.pagestyle} and not
+if it is chosen in a different way, e.\,g., using
+\DescRef{maincls.cmd.thispagestyle}. Note also that you cannot remove
+\PName{code} from the hook after adding it. But the \PName{code} will be added
+locally, so you can use a group to limit the scope of the \PName{code}.%
\EndIndexGroup
\begin{Declaration}
- \Macro{DeclarePageStyleAlias}%
- \Parameter{alias page style name}\Parameter{original page style name}%
- \Macro{DeclareNewPageStyleAlias}%
- \Parameter{alias page style name}\Parameter{original page style name}%
- \Macro{ProvidePageStyleAlias}%
- \Parameter{alias page style name}\Parameter{original page style name}%
- \Macro{RedeclarePageStyleAlias}%
- \Parameter{alias page style name}\Parameter{original page style name}
+ \Macro{DeclarePageStyleAlias}\Parameter{page~style~alias~name}
+ \Parameter{original~page~style~name}
+ \Macro{DeclareNewPageStyleAlias}\Parameter{page~style~alias~name}
+ \Parameter{original~page~style~name}
+ \Macro{ProvidePageStyleAlias}\Parameter{page~style~alias~name}
+ \Parameter{original~page~style~name}
+ \Macro{RedeclarePageStyleAlias}\Parameter{page~style~alias~name}
+ \Parameter{original page style name}
\end{Declaration}
-These commands may be used to define a page style with name \PName{alias page
- style name} that is simply an alias for an already existing page style with
+\BeginIndex{}{page style>alias}%
+\BeginIndex{}{alias>page style}%
+These commands can be used to define a page style with name \PName{page style
+ alias name} that is simply an alias for an existing page style with the
name \PName{original page style name}. If there is already a page style
-\PName{alias page style name}, then using \Macro{DeclarePageStyleAlias} or
+\PName{page style alias name}, using \Macro{DeclarePageStyleAlias} or
\Macro{RedeclarePageStyleAlias} will destroy the alias before recreating it.
-\Macro{DeclareNewPageStyleAlias} will throw an error message, if a page style
-\PName{alias page style name} has already been defined before. It does not
-matter if the already defined page style is a layer page style, an alias page
-style or another page style.
-
-\Macro{ProvidePageStyleAlias} will define the alias only if a page style
-\PName{alias page style name} has not been defined before. If a page style
-\PName{alias page style name} already exists nothing will be done.
-
-\Macro{RedeclarePageStyleAlias} expects an already existing page style
-\PName{alias page style name}. It will destroy that page style and afterwards
-define the alias. If the page style \PName{alias page style name} does not
-exist, then you will get an error.%
+\Macro{DeclareNewPageStyleAlias} will throw an error message if a page style
+\PName{page style alias name} has already been defined. It does not matter if
+the previously defined page style is a layer-page style, a page style alias,
+or another page style.
+
+\Macro{ProvidePageStyleAlias} will define the alias only if the
+\PName{page style alias name} page style has not been defined before. If the
+\PName{page style alias name} page style already exists, nothing will be done.
+
+\Macro{RedeclarePageStyleAlias} expects an existing
+\PName{page style alias name} page style. It will destroy that page style and
+afterwards define the alias. If the \PName{page style alias name} page style
+does not exist, you will get an error.%
+\iffree{\csname @tempswafalse\endcsname}{\csname @tempswatrue\endcsname}%
+\csname if@tempswa\endcsname% Umbruchkorrekturtext
+ \begin{Example}
+ Suppose you write a class and use the \PageStyle{chapter} page style for the
+ first page of each chapter. By default, this page style should match the
+ \PageStyle{plain} page style. Therefore, you can use the \Package{scrlayer}
+ package and use
+\begin{lstcode}
+ \DeclareNewPageStyleAlias{chapter}{plain}
+\end{lstcode}
+ to define the \PageStyle{chapter} page style as an alias for the
+ \PageStyle{plain} page style. If, on the other hand, you later decide that
+ the \PageStyle{chapter} plage style should correspond to the
+ \PageStyle{empty} page style, you can achieve this with:
+\begin{lstcode}
+ \RedeclarePageStyleAlias{chapter}{empty}
+\end{lstcode}%
+ \end{Example}%
+\fi
\EndIndexGroup
\begin{Declaration}
- \Macro{DestroyPageStyleAlias}\Parameter{page style name}%
+ \Macro{DestroyPageStyleAlias}\Parameter{page~style~name}%
\end{Declaration}
-This command makes the page style with given \PName{page style name}
-\LaTeX-undefined, if it is an alias for another page style. Afterwards, the
-page style may be defined newly with, e.g., \Macro{DeclareNewAliasPageStyle}
-or \Macro{ProvideAliasPageStyle}.
-
-The command is intended to be used inside of
-\DescRef{\LabelBase.cmd.scrlayerOnAutoRemoveInterface} to remove page styles that have been
-declared by an interface and use removable macros of that interface.%
+\BeginIndex{}{page style>alias}%
+\BeginIndex{}{alias>page style}%
+This command renders the page style named \PName{page style name} undefined
+for \LaTeX{} if it is an alias for another page style. Afterwards, the page
+style can be newly defined with
+\DescRef{\LabelBase.cmd.DeclareNewPageStyleAlias} or
+\DescRef{\LabelBase.cmd.ProvidePageStyleAlias}.
+
+This command is intended to be used inside the argument code of
+\DescRef{\LabelBase.cmd.scrlayerOnAutoRemoveInterface} to remove page styles
+that have been declared as part of an end-user interface when removing this
+interface automatically.%
\EndIndexGroup
\begin{Declaration}
- \Macro{GetRealPageStyle}\Parameter{page style name}%
+ \Macro{GetRealPageStyle}\Parameter{page~style~name}%
\end{Declaration}
-The command will result in the (recursive) real page name of the page style,
-if the page style with given name \PName{page style name} is an alias of
-another page style. In all other cases, even if there's no alias and no page
-style named \PName{page style name}, the result would be simply \PName{page
- style name}. The command is fully expandable and may be used, e.g., in the
-second argument of \Macro{edef}.%
+\BeginIndex{}{page style>alias}%
+\BeginIndex{}{alias>page style}%
+This command will result in the (recursive) real page name of the page style
+if \PName{page style name} is an alias of another page style. In all other
+cases, even if there's no alias and no page style named \PName{page style
+ name}, the result is simply \PName{page style name}. The command is fully
+expandable and may be used, e.g., in the second argument of \Macro{edef}.%
\EndIndexGroup
\begin{Declaration}
- \Macro{DeclarePageStyleByLayers}%
- \OParameter{option list}\Parameter{page style name}\Parameter{layer list}%
- \Macro{DeclareNewPageStyleByLayers}%
- \OParameter{option list}\Parameter{page style name}\Parameter{layer list}%
- \Macro{ProvidePageStyleByLayers}%
- \OParameter{option list}\Parameter{page style name}\Parameter{layer list}%
- \Macro{RedeclarePageStyleByLayers}%^
- \OParameter{option list}\Parameter{page style name}\Parameter{layer list}%
+ \Macro{DeclarePageStyleByLayers}\OParameter{option list}
+ \Parameter{page style name}
+ \Parameter{layer list}
+ \Macro{DeclareNewPageStyleByLayers}\OParameter{option list}
+ \Parameter{page style name}
+ \Parameter{layer list}
+ \Macro{ProvidePageStyleByLayers}\OParameter{option list}
+ \Parameter{page style name}
+ \Parameter{layer list}
+ \Macro{RedeclarePageStyleByLayers}\OParameter{option list}
+ \Parameter{page style name}
+ \Parameter{layer list}
\end{Declaration}
-These commands declare a page style with \PName{page style name}. The page
+\BeginIndex{}{page style>layers}%
+\BeginIndex{}{layers>page style}%
+These commands declare a page style named \PName{page style name}. The page
style will consist of the layers given in \PName{layer list}, a comma
-separated list of layer names. Note, the \PName{page style name} and the
-layer names at the \PName{layer list} must be fully expandable and should
-expand to letters. Several other characters are tolerated, but,
-nevertheless, not recommended.
-
-The \PName{option list} is a comma separated list of
-\OptionValue{\PName{key}}{\PName{value}} options. These options may be used to
-set additional features. Currently they are used to set the code that should
-be expanded or executed at several \emph{hooks}. See the introduction to this
-section for more general information about \emph{hooks}. See
+separated list of layer names. Note\textnote{Attention!} that the \PName{page
+ style name} and the layer names in the \PName{layer list} must be fully
+expandable and should expand to letters. Several other characters are also
+accepted, but their use is recommended only for experienced users.
+
+The \PName{option list} is a comma-separated list of options in the form
+\texttt{\PName{key}=\PName{value}}. These options may be used to set
+additional features. Currently they are used to set the code that should be
+expanded or executed at several hooks\Index{hooks}. See the introduction to
+this section for more general information about hooks. See
\autoref{tab:scrlayer.pagestyle.hooks} for detailed information on specific
hooks.
\begin{desclist}
\desccaption{%
- The \emph{hook} options for page styles (in order of
+ Hook options for page styles (in order of
execution)\label{tab:scrlayer.pagestyle.hooks}%
}{%
- The \emph{hook} options for page styles (\emph{Continuation})%
+ Hook options for page styles (\emph{continued})%
}%
\entry{\OptionVName{onselect}{code}}{%
- Execute \PName{code} whenever the page style is selected using, e.g.,
- \DescRef{maincls.cmd.pagestyle}. Note\textnote{Attention!},
- \DescRef{maincls.cmd.thispagestyle} does not select the page style
- immediately, but asynchronously inside \LaTeX's output routine.%
+ The \PName{code} of this hook\Index{hook} is executed whenever the page
+ style is selected, for example with \DescRef{maincls.cmd.pagestyle}. Note
+ that \DescRef{maincls.cmd.thispagestyle} itself does not directly select a
+ page style. In this case, the page style is only activated within \LaTeX's
+ output routine.%
}%
\entry{\OptionVName{oninit}{code}}{%
- Execute \PName{code} whenever the output of page style's layers is
- initialised. Note\textnote{Attention!}, this is done twice for every page:
- once for background layers and once for foreground layers.%
+ The \PName{code} of this hook\Index{hook} is executed whenever the output
+ of the page style's layers is initialised. Note that this happens twice
+ for each page: once for background layers and once for foreground layers.%
}%
\entry{\OptionVName{ononeside}{code}}{%
- Execute \PName{code} whenever the output of page style's layers in
- single-side mode is initialised. Note\textnote{Attention!}, this is done
- twice for every page: once for background layers and once for foreground
- layers.%
+ The \PName{code} of this hook\Index{hook} is executed whenever the output
+ of the page style's layers in one-sided printing is initialised. Note that
+ this happens twice for each page: once for background layers and once for
+ foreground layers.%
}%
\entry{\OptionVName{ontwoside}{code}}{%
- Execute \PName{code} whenever the output of page style's layers in
- two-side mode is initialised. Note\textnote{Attention!}, this is done
- twice for every page: once for background layers and once for foreground
- layers.%
+ The \PName{code} of this hook\Index{hook} is executed whenever the output
+ of the page style's layers in two-sided printing is initialised. Note that
+ this happens twice for each page: once for background layers and once for
+ foreground layers.%
}%
\entry{\OptionVName{onoddpage}{code}}{%
- Execute \PName{code} whenever the output of page style's layers on an odd
- page is initialised. Note\textnote{Attention!}, this is done twice for
- every page: once for background layers and once for foreground
- layers. Note\textnote{Attention!} also that in single-side mode all pages
- are odd pages, not only pages with odd page numbers.%
+ The \PName{code} of this hook\Index{hook} is executed whenever the output
+ of the page style's layers on an odd page is initialised. Note that this
+ happens twice for each page: once for background layers and once for
+ foreground layers. Note also that in one-sided printing all pages are odd
+ pages, not just those with odd page numbers.%
}%
\entry{\OptionVName{onevenpage}{code}}{%
- Execute \PName{code} whenever the output of page style's layers on an even
- page is initialised. Note\textnote{Attention!}, this is done twice for
- every page: once for background layers and once for foreground
- layers. Note\textnote{Attention!} also that there are not even pages in
- single-side mode, but all pages are odd pages, not only pages with odd
- page numbers.%
+ The \PName{code} of this hook\Index{hook} is executed whenever the output
+ of the page style's layers on an even page is initialised. Note that this
+ happens twice for each page: once for background layers and once for
+ foreground layers. Note also that in one-sided printing there are no even
+ pages. Instead, all pages are treated as odd pages, not just those with
+ odd page numbers.%
}%
\entry{\OptionVName{onfloatpage}{code}}{%
- Execute \PName{code} whenever the output of page style's layers on a float
- page are initialised. Note\textnote{Attention!}, this is be done twice for
- every page: once for background layers and once for foreground
- layers. Note\textnote{Attention!} also that float pages are only those
- pages with p-placed floating objects.%
+ The \PName{code} of this hook\Index{hook} is executed whenever the output
+ of the page style's layers on a float page is initialised. Note that this
+ happens twice for each page: once for background layers and once for
+ foreground layers. Note also that float pages are only those pages with
+ one or more p-placed floating environments.%
}%
\entry{\OptionVName{onnonfloatpage}{code}}{%
- Execute \PName{code} whenever the output of page style's layers on a
- non-float page is initialised. Note\textnote{Attention!}, this is done
- twice for every page: once for background layers and once for foreground
- layers. Note\textnote{Attention!} also that non-float pages are all pages
- that are not float-pages. Those pages may have t-placed, h-placed,
- b-placed, or no floating objects.%
+ The \PName{code} of this hook\Index{hook} is executed whenever the output
+ of the page style's layers on a non-float page is initialised. Note that
+ this happens twice for each page: once for background layers and once for
+ foreground layers. Note also that float pages are only the pages on which
+ one or more p-placed floating environments are output. Other pages may
+ well have t-, h-, or b-placed floating environments.%
}%
\entry{\OptionVName{onbackground}{code}}{%
- Execute \PName{code} whenever the output of page style's layers in the
- background of a page is initialised. Note\textnote{Attention!}, this is
- done once for every page.%
+ The \PName{code} of this hook\Index{hook} is executed whenever the output
+ of the page style's background layers is initialised. Note that this
+ happens once each page.%
}%
\entry{\OptionVName{onforeground}{code}}{%
- Execute \PName{code} whenever the output page style's layers in the
- foreground of a page is initialised. Note\textnote{Attention!}, this is
- done once for every page.%
+ The \PName{code} of this hook\Index{hook} is executed whenever the output
+ of the page style's foreground layers is initialised. Note that this
+ happens once each page.%
}%
\end{desclist}
-The difference of \Macro{DeclarePageStyleByLayers} and
-\Macro{DeclareNewPageStyleByLayers} is that
-\Macro{DeclareNewPageStyleByLayers} will result in an error, if a page style
-with name \PName{page style name} already exists. Note, declaring a page
-style, which is an alias of another page style (see
-\Macro{DeclareAliasPageStyle} prior in this section), will not re-declare the
-page style itself, but it's real page style (see
-\DescRef{\LabelBase.cmd.GetRealPageStyle} prior in this section).
-
-The difference of \Macro{DeclarePageStyleByLayers} and
-\Macro{ProvidePageStyleByLayers} is that \Macro{ProvidePageStyleByLayers}
-will simply do nothing, if there's already a page style with name \PName{page
- style name}. In difference to \Macro{DeclareNewPageStyleByLayers} it will not
-raise an error.
-
-The difference of \Macro{DeclarePageStyleByLayers} and
-\Macro{RedeclarePageStyleByLayers} is, that \Macro{RedeclarePageStyleByLayers}
-may be used only if the real page style of \PName{page style name} already
-exists. Otherwise an error occurs.
-
-Please have also a look at the notes to following pseudo page style
+\iffalse% Umbruchvarianten
+ While the \Macro{DeclarePageStyleByLayers} command always defines the page
+ style, \Macro{DeclareNewPageStyleByLayers} generates an error message if a
+ page style with the same name already exists. Note\textnote{Attention!} that
+ the declaration of a page style that is already an alias for another page
+ style (see, for example, \Macro{DeclareAliasPageStyle} earlier in this
+ section) will redefine not the specified page style alias but the real page
+ style (see \DescRef{\LabelBase.cmd.GetRealPageStyle} earlier in this
+ section).%
+\else%
+ The \Macro{DeclarePageStyleByLayers} command defines the page style
+ regardless of whether a page style of \PName{page style name} already
+ exists. If necessary, the existing page style is completely
+ redefined. However, if a page style alias \PName{page style name} already
+ exists, the associated real page style, not the page style alias itself, is
+ redefined (see \DescRef{\LabelBase.cmd.GetRealPageStyle} earlier in this
+ section).
+
+ The \Macro{DeclareNewPageStyleByLayers} command differs if a page style of
+ the same name already exists. Regardless of whether it is a real or an alias
+ page style, an error will be reported in this case.
+\fi
+
+In contrast, \Macro{ProvidePageStyleByLayers} preserves the page style
+unchanged if a page style with name \PName{page style name} already exists. If
+no such page style exists, it is defined as in
+\Macro{DeclarePageStyleByLayers}.
+
+The \Macro{RedeclarePageStyleByLayers} in turn expects that a page style of
+of the name \PName{page style name} already exists and then redefines its real
+page style. However, if no page style of the specified name exists, an error
+message results.
+
+Also note the remarks below about the pseudo-page style
\PageStyle{@everystyle@}.%
\EndIndexGroup
@@ -1042,25 +1115,35 @@ Please have also a look at the notes to following pseudo page style
\PageStyle{@everystyle@}%
\PageStyle{empty}
\end{Declaration}
-There are two default layer page styles that are somehow special. The first
-one is \PageStyle{@everystyle@}. This page style should not be used like any
-other page style, but the layers of this page style will be used by all the
-other layer page styles. So adding a layer to this page style is similar to
-adding this layer to all other layer page styles even the empty one. There's
-one difference: Layer referencing commands of the page style interface like
-\DescRef{\LabelBase.cmd.ForEachLayerOfPageStyle},
-\DescRef{\LabelBase.cmd.AddLayersToPageStyleBeforeLayer}, or
-\DescRef{\LabelBase.cmd.AddLayersToPageStyleAfterLayer} process only the
-layers of the page style that has been referenced but not the layers
-implicated by \PageStyle{@everystyle@}.
-
-The other somehow special page style is \PageStyle{empty}. Normally page style
-\PageStyle{empty} is defined by the \LaTeX{} kernel, to be a page style
-without page head or page foot. Package \Package{scrlayer} re-defines it to be
-a layer page style without any layer. Nevertheless, you may use it like every
-other layer page style too. The main advantage above the \LaTeX{} kernel's
-empty page style is that it also executes the layers of special layer page
-style \PageStyle{@everysel@}.%
+\BeginIndex{}{page style>layers}%
+\BeginIndex{}{layers>page style}%
+The \Package{scrlayer} package defines two specific page styles worth noting.
+The first of these is \PageStyle{@everystyle@}%
+\important{\PageStyle{@everystyle@}}. This page style should never be used
+like a normal page style, for example with \DescRef{maincls.cmd.pagestyle} or
+\DescRef{maincls.cmd.thispagestyle}, or as the target of a page-style alias.
+Instead, the layers and hooks\Index{hooks} of this page style are used by all
+other layer page styles. The hooks of \PageStyle{@everystyle@} are placed in
+front of their respective hooks, and the layers in front of the respective
+layers, of the active page style.
+
+Thus adding a layer to the pseudo-page style \PageStyle{@everystyle@} or code
+to a hook of this page style is like adding a layer or hook code to all layer
+page styles, even the empty one. There's one crucial difference: commands that
+reference the layers of a page style which include
+\DescRef{\LabelBase.cmd.ForEachLayerOfPageStyle}, e.\,g., the commands
+\DescRef{\LabelBase.cmd.AddLayersToPageStyleBeforeLayer} or
+\DescRef{\LabelBase.cmd.AddLayersToPageStyleAfterLayer}, disregard the layers
+of the page style \PageStyle{@everystyle@} when applied to a different layer
+page style.
+
+The second, slightly different page style is \PageStyle{empty}. Normally the
+\LaTeX{} kernel defines the \PageStyle{empty} page style to have an empty
+header and footer. The \Package{scrlayer} package redefines this page style as
+a layerless page style. Nonetheless, you can use it like any other layer page
+style. The main advantage of the layer page style over the original page
+style from the \LaTeX{} kernel is that it also executes the hooks and layers
+of the psuedo-layer page style \PageStyle{@everystyle@}.%
\EndIndexGroup
@@ -1076,13 +1159,23 @@ style \PageStyle{@everysel@}.%
\OptionVName{onpsbackground}{code}%
\OptionVName{onpsforeground}{code}
\end{Declaration}
-There's also a \KOMAScript{} option for each of those \texttt{hooks}. The
-names of the \KOMAScript{} options are similar to the names of the page style
-options, but with ``\texttt{ps}'' inserted behind ``\texttt{on}''. The value
-of the \KOMAScript{} options are the initial defaults of the corresponding
-\texttt{hooks}. These defaults will be extended at every declaration of page
-style hook options via \PName{option list}. You may remove the default, using
-\DescRef{\LabelBase.cmd.ModifyLayerPageStyleOptions} described later in this section.%
+\BeginIndex{}{page style>layers}%
+\BeginIndex{}{layers>page style}%
+There is also a \KOMAScript{} option for each of the hooks\Index{hooks} in
+\autoref{tab:scrlayer.pagestyle.hooks}%
+\iftrue
+. The names of the \KOMAScript{} options are similar to those for declaring
+page style layers, except that a ``\texttt{ps}'' is inserted after
+``\texttt{on}'' at the beginning of the name
+\else
+, into the names of which a ``\texttt{ps}'' is inserted
+\fi
+. The values of these \KOMAScript{} options are used as the initial values for
+the corresponding hooks. These initial values are then extended by all the
+values assigned to the corresponding hooks in the \PName{option list} of the
+declaration commands. You can remove the default with
+\DescRef{\LabelBase.cmd.ModifyLayerPageStyleOptions}, which is explained later
+in this section.%
\EndIndexGroup
@@ -1090,13 +1183,14 @@ style hook options via \PName{option list}. You may remove the default, using
\OptionVName{singlespacing}{simple switch}
\end{Declaration}
If\ChangedAt{v3.24}{\Package{scrlayer}\and \Package{scrlayer-scrpage}} a
-document is printed with increased line-spread, e.g., using package
-\Package{setspace}\IndexPackage{setspace}, often the page head and foot should
-be printed single-spaced. This is surely true if the page head and foot
-consist of only a single line. In those cases you can use \KOMAScript{} option
-\Option{singlespacing}. Nevertheless, the default is
-\OptionValue{singlespacing}{false}! The option influences always all page
-styles. If you want single-spacing for only some page styles, use
+document is printed with increased line spacing, e.\,g., using the
+\Package{setspace}\IndexPackage{setspace}\important{\Package{setspace}}
+package, it is often undesirable for the header and footer to be printed with
+this increased spacing. This is particularly true if the header and footer
+consist of only a single line. In this case you can use \KOMAScript{} option
+\Option{singlespacing}. However, the default\textnote{default} is
+\OptionValue{singlespacing}{false}! The option generally applies to all layer
+page styles. If you want single-spacing for only some page styles, use
\OptionValue{oninit}{\Macro{linespread}\PParameter{1}\Macro{selectfont}} for
those page styles.%
\EndIndexGroup
@@ -1107,38 +1201,41 @@ those page styles.%
\Macro{ForEachLayerOfPageStyle}\Parameter{page style name}\Parameter{code}%
\Macro{ForEachLayerOfPageStyle*}\Parameter{page style name}\Parameter{code}
\end{Declaration}
-As long as \KOMAScript{} option \Option{deactivatepagestylelayers} has not
-been activated command \Macro{ForEachLayerOfPageStyle} can be used to process
-\PName{code} for every member layer of \PName{page style name}'s layers
-list. Inside of \PName{code} the place holder \PValue{\#1} may be used to
-reference the name of the current layer.
+\BeginIndex{}{page style>layers}%
+\BeginIndex{}{layers>page style}%
+As long as the \KOMAScript{} option \Option{deactivatepagestylelayers} is not
+enabled, the \Macro{ForEachLayerOfPageStyle} command can execute arbitrary
+\PName{code} for each layer of the page style named \PName{page style name}.
+Inside of \PName{code}, the place holder \PValue{\#1} serves as a
+reference to the name of the current layer.
\begin{Example}
- If you want to print the names of all layers of page style
- \PValue{scrheadings}, you may us:
+ If you want to print the names of all layers of the \PValue{scrheadings}
+ page style as a comma-separated list, you can use:
\begin{lstcode}
\let\commaatlist\empty
\ForEachLayerOfPageStyle{scrheadings}{%
\commaatlist#1\gdef\commaatlist{, }}
\end{lstcode}
\end{Example}
-Usage of \Macro{gdef} instead of \Macro{def} is necessary in the example
-above, because \Macro{ForEachLayerOfPageStyle} executes the \PName{code}
-inside of a group to minimise side effects. Here \Macro{gdef} redefines
-\Macro{commaatlist} globally, so it would be still valid at the execution of
-\PName{code} for the next layer.
+In\textnote{Attention!} the example above, we had to use \Macro{gdef} instead
+of \Macro{def} because \Macro{ForEachLayerOfPageStyle} executes the
+\PName{code} inside a group to minimise side effects. However, \Macro{gdef}
+redefines \Macro{commaatlist} globally so the change will persist when the
+\PName{code} for the next layer is executed.
Alternatively,\ChangedAt{v3.18}{\Package{scrlayer}} you can use \Macro{def}
-but the star variant \Macro{ForEachLayerOfPageStyle*}. This type does not use
-an additional group for executing \PName{code}. On the other hand the user has
-to take care on side effects of \PName{code}, i.\,e., deactivation of all
-layers using \OptionValue{deactivatepagestylelayers}{true} in \PName{code}
-would persist after \Macro{ForEachLayerOfPageStyle*}.
-
-Several other commands of \Package{scrlayer} also
-use \Macro{ForEachLayerOfPageStyle} internally. So these also do not process
-any layer if \KOMAScript{} option \Option{deactivatepagestylelayers} would be
-activated. So you may use this options, e.g., to hide all layers of all layer
-page styles.%
+with the starred variant \Macro{ForEachLayerOfPageStyle*}. This form dispenses
+with the extra group when executing \PName{code}. However, the user then has
+to take make sure that the \PName{code} has no unwanted side effects. In
+particular, deactivating all layers using
+\OptionValue{deactivatepagestylelayers}{true} within \PName{code} would
+persist beyond the call to \Macro{ForEachLayerOfPageStyle*}.
+
+Various \Package{scrlayer} commands also use \Macro{ForEachLayerOfPageStyle}
+internally. Their behaviour can therefore also be changed using the
+\KOMAScript{} option \Option{deactivatepagestylelayers}. With this option,
+you can temporarily disable and thus hide all layers of all layer page
+styles.%
\EndIndexGroup
@@ -1152,32 +1249,39 @@ page styles.%
\Macro{RemoveLayersFromPageStyle}%
\Parameter{page style name}\Parameter{layer list}%
\end{Declaration}
-You can use these commands to add layers to a layer page style or to remove
-layers from a layer page style. The page style will be referenced by
-\PName{page style name}. The layers are given by a comma separated
-\PName{layer list}.
-
-The commands \Macro{AddLayersToPageStyle} and \Macro{AddLayersAtEndOfPageStyle}
-add all layers of the comma separated list of layers \PName{layer list} at
-the end of the layer list of layer page style \PName{page style
- name}. Logically the added layers would be above or in front of the old
-layers of the page style. Nevertheless, new background layers would be behind
-the text layer and therefore behind all foreground layers.
-
-Command \Macro{AddLayersAtBeginOfPageStyle} adds the new layers at the begin
-of the layer list of the page style. Note, the layers
-will be added in the order of the \PName{layer list}. The first layer at
-\PName{layer list} will be added first, the second layer will be added second
-and so on. So with \Macro{AddLayersAtBeginOfPageStyle} the last layer at
-\PName{layer list} will become the new first layer of the layer list of layer
-page style \PName{page style name}.
-
-Command \Macro{RemoveLayersFromPageStyle} may be used to remove layers from
-the layer list of layer page style \PName{page style name} instead of adding
-them. Note, layers, which are part of \PName{layer list}, but not part of
-the page style's layer list, will be ignored. But adding or removing layers
-from a page style, which is not a layer page style or an alias of a layer page
-style, would be a mistake and result in an error message.%
+\BeginIndex{}{page style>layers}%
+\BeginIndex{}{layers>page style}%
+You can use these commands to add layers to a layer page style or to remove
+layers from a layer page style. The page style is referenced by its
+\PName{page style name}. The layers are given by a comma-separated
+\PName{layer list}.
+
+Both the \Macro{AddLayersToPageStyle} and the
+\Macro{AddLayersAtEndOfPageStyle}\textnote{add at the end} commands insert the
+new layers at the bottom of the page style's layer list. Logically, the newly
+added layers lie above or in front of the old layers. Background layers, of
+course, still are logically behind the text layer and thus behind all
+foreground layers.
+
+In contrast, the \Macro{AddLayersAtBeginOfPageStyle}\textnote{add at the
+ beginning} command inserts the new layers at the top of the page style's
+layer list. The layers are separately inserted to the top of the list in the
+same order they appear in the \PName{layer list} parameter. This means that
+the last layer in the \PName{layer list} parameter will become the first, and
+thus the lowest, layer of the page style.
+
+\iffalse% Umbruchkorrekturtext (beim Aktiveren muss unten \textnote{remove}
+% entfernt werden!)
+The \Macro{RemoveLayersFromPageStyle} command is exactly the opposite. It
+removes\textnote{remove} the specified page-style levels.%
+\fi
+
+The \Macro{RemoveLayersFromPageStyle}\textnote{remove} command removes layers
+from the layer list of the page style named \PName{page style name}.
+Attempting to remove layers which are not part of the page style's layer list
+will be ignored. But attempting to add layers to or remove layers from a page
+style that is neither a layer page style nor a page-style alias is an error
+and will be reported as such.%
\EndIndexGroup
@@ -1189,29 +1293,46 @@ style, would be a mistake and result in an error message.%
\Parameter{page style name}\Parameter{layer list}%
\Parameter{reference layer name}
\end{Declaration}
-These commands are similar to the commands described before, but they do not
-add the layers at the begin or end of the layer list of a layer page style,
-but just before or after a reference layer at the layer list of a layer page
-style. Note, in this case the order of the \PName{layer list} will be
-same in the layer list of \PName{page style name} after adding. If the
-reference layer named \PName{reference layer name} is not part of the layer
-list of the layer page style, nothing happens.%
+\BeginIndex{}{page style>layers}%
+\BeginIndex{}{layers>page style}%
+\iffalse% Umbruchvarianten
+These two commands are similar to the previous ones, but they take an
+additional parameter, \Parameter{reference layer name}. The layer list of
+the page style named in \Parameter{page style name} is searched for this
+reference layer. %
+\else%
+These commands are similar to the previous ones. The existing layers of the
+page style, however, are searched for the \PName{reference layer name}. %
+\fi%
+The layers in the \Parameter{layer list} parameter are then inserted
+before\textnote{add before/after layer} or after this reference layer%
+\iffalse% Umbruchkorrekturtext
+in the layers of the page style%
+\fi%
+. The order of the layers in the \PName{layer list} is retained.
+
+If the reference layer named \PName{reference layer name} is not part of the
+given page style, nothing is inserted. On the other hand, if the page style is
+neither a layer page style nor a page-style alias, an error will be reported.%
\EndIndexGroup
\begin{Declaration}
\Macro{UnifyLayersAtPageStyle}\Parameter{page style name}
\end{Declaration}
-With the commands described before in this section you may not only add
-different layers to a page style, but even add the same layer several times to
-a page style. In most cases it does not make sense to have one layer several
-times at the layer list of a layer page style. So you may use
-\Macro{UnifyLayersAtPageStyle} to remove all dupes of layers from the layer
-list of a layer page style.
-
-Note\textnote{Attention!}, the order of layers may change! So if
-you want a special order, you should remove all layers and add the layers in
-the order you want instead of using \Macro{UnifyLayersAtPageStyle}.%
+\BeginIndex{}{page style>layers}%
+\BeginIndex{}{layers>page style}%
+The commands for defining page styles or adding layers to a page style do not
+care how many times a layer appears in a page style, so it is quite
+permissible for a layer to appear multiple times. In most cases, however, it
+does not make sense to use the same layer several times in one page style.
+Therefore, you can use \Macro{UnifyLayersAtPageStyle} to remove all layer
+duplicates from the layer page style of the specified \Parameter{page style
+ name}.
+
+Note\textnote{Attention!} that this function can change the order of layers.
+So if you need a specific order, you should remove all layers and add the
+layers in the order you want instead of using \Macro{UnifyLayersAtPageStyle}.%
\EndIndexGroup
@@ -1221,19 +1342,25 @@ the order you want instead of using \Macro{UnifyLayersAtPageStyle}.%
\Macro{AddToLayerPageStyleOptions}%
\Parameter{page style name}\Parameter{option list}
\end{Declaration}
-Command \Macro{ModifyLayerPageStyleOptions} may be used to modify the page
-style options of a layer page style. Only options at the comma separated
-\PName{option list} will be set to the new values given in \PName{option list}
-if the new value is not empty. Options, which are not at \PName{option list},
-will stay unchanged. If you want to set an option to \emph{do nothing} you may
-use value \Macro{relax}. Note, setting an option to a new value using
-\Macro{ModifyLayerPageStyleOptions} will remove the previous value including
-the global default value.
-
-\Macro{AddToLayerPageStyleOptions} differs from
-\Macro{ModifyLayerPageStyleOptions} in that point. It will not overwrite the
-previous values, but adds\,---\,or more precisely: concatenates\,---\, the new
-values to the previous values of the options at \PName{option list}.%
+\BeginIndex{}{page style>layers}%
+\BeginIndex{}{layers>page style}%
+These two commands can be used to modify the options, and thus the
+hooks\Index{hooks}, of a layer page style. With
+\Macro{ModifyLayerPageStyleOptions}\textnote{change page-style options}, only
+the options in the comma-separated \PName{option list} will be set to the new
+values given there. The previous values are lost. All options from
+\autoref{tab:scrlayer.pagestyle.hooks},
+\autopageref{tab:scrlayer.pagestyle.hooks} are allowed. Options or hooks that
+are not specified in the \PName{option list} will remain unchanged. If you
+want to set an option to do nothing you can set it to the value \Macro{relax}.
+Setting an option to a new value using \Macro{ModifyLayerPageStyleOptions}
+will remove the previous value, including the global default value. This
+statement is the only way to remove the global defaults of the \KOMAScript{}
+options from a page style.
+
+\Macro{AddToLayerPageStyleOptions}\textnote{extend page-style options}, on the
+other hand, does not overwrite the previous values. Instead it adds\,---\,or,
+more precisely, concatenates\,---\, the new values to old ones.%
\EndIndexGroup
@@ -1243,20 +1370,21 @@ values to the previous values of the options at \PName{option list}.%
\Macro{IfRealLayerPageStyleExists}%^
\Parameter{page style name}\Parameter{then code}\Parameter{else code}%
\end{Declaration}
-Command \Macro{IfLayerPageStyleExists} tests, whether or not the real page
-style of \PName{page style name} is a layer page style. If the test is true,
-\PName{then code} will be executed. If \PName{page style name} is neither a
-layer page style, nor an alias of a layer page style, nor an alias of an alias
-of \dots\ a layer page style, \PName{else code} will be executed. Internally
-this command is often used to throw an error message if you use one of the
-layer page style commands with an \PName{page style name} that does not
-correspond with a layer page style.
-
-Command \Macro{IfRealLayerPageStyleExists} is similar, but \PName{then code}
-will only be executed, if \PName{page style name} itself is the name of a
-layer page style. So \PName{else code} will even be executed, if \PName{page
- style name} is an alias name of a layer page style or the alias name of an
-alias name of \dots\ a layer page style.%
+\BeginIndex{}{page style>layers}%
+\BeginIndex{}{layers>page style}%
+With these commands, you can execute code depending on whether a page style is
+a layer page style or not. The \Macro{IfLayerPageStyleExists} command executes
+the \PName{then code} if \PName{page style name} is the name of a layer page
+style or a page-style alias that results in a layer page style. Otherwise, the
+command executes the \PName{else code}. Internally, this command is often used
+to throw an error message if you use one of the layer page style commands with
+an \PName{page style name} that does not correspond to a layer page style.
+
+The \Macro{IfRealLayerPageStyleExists} command goes one step further and
+executes the \PName{then code} only if the page style specified by \PName{page
+ style name} is itself a layer page style. So if \PName{page style name} is a
+page-style alias, this command executes the \PName{else code} even if the
+alias resolves to a real layer page style.%
\EndIndexGroup
@@ -1271,85 +1399,106 @@ alias name of \dots\ a layer page style.%
\Parameter{page style name}\Parameter{layer list}%
\Parameter{then code}\Parameter{else code}%
\end{Declaration}
-Command \Macro{IfLayerAtPageStyle} may be used to test, whether or not a layer
-named \PName{layer name} is a member of the layer list of a given page
-style. If the test is true, the \PName{then code} will be executed. If the
-layer is not a member of the layer list of \PName{page style name}, the
-\PName{else code} will be executed.
-
-Commands \Macro{IfSomeLayerAtPageStyle} and \Macro{IfLayersAtPageStyle} do not
-only test one layer but several layers at a given, comma separated
-\PName{layer list}. \Macro{IfSomeLayerAtPageStyle} will execute the
-\PName{then code} if \emph{at least one} of the layers at \PName{layer list}
-is a member of the layer list of \PName{page style name}. In difference
-\Macro{IfLayersAtPageStyle} executes the \PName{then code} only if \emph{all}
-of the layers at \PName{layer list} are members of the layer list of
-\PName{page style name}.%
+\BeginIndex{}{page style>layers}%
+\BeginIndex{}{layers>page style}%
+These commands can be used to test whether one or more layers are part of a
+page style. The \Macro{IfLayerAtPageStyle} command expects exactly one
+\PName{layer name}\textnote{exactly one layer} as the second argument. If this
+layer is part of the page style specified in \PName{page style name}, the
+\PName{then code} will be executed. Otherwise, the \PName{else code} will be
+executed.
+
+The \Macro{IfSomeLayerAtPageStyle} and \Macro{IfLayersAtPageStyle} commands
+allow a comma-separated \PName{layer list}. \Macro{IfSomeLayerAtPageStyle}
+will execute the \PName{then code} if \emph{at least one} of the layers in the
+\PName{layer list} parameter is part of the layer list of \PName{page style
+ name}. In contrast, \Macro{IfLayersAtPageStyle} executes the \PName{then
+ code} only if \emph{all} the layers in the \PName{layer list} parameter are
+part of the page style. If the condition is not met, the \PName{else code}
+will be executed.
+
+With suitable nesting of these commands, you can construct complex conditions.
+If you use only one \PName{layer name} in the \PName{layer list}, all three
+statements are synonymous.%
\EndIndexGroup
\begin{Declaration}
\Macro{DestroyRealLayerPageStyle}\Parameter{page style name}
\end{Declaration}
-Command \Macro{DestroyRealLayerPageStyle} makes the page style named
-\PName{page style name} undefined, if and only if it is a layer page
-style. Nothing will be happen if it is an alias name of a layer page style, if
-it is another page style, or if it is not a page style.
-
-If \PName{page style name} is the name of the current page style the current
-page style will become a kind of empty page style. If the special page
-style\,---\,this may be set using \DescRef{maincls.cmd.thispagestyle}\,---\,is
-\PName{page style name}, this will be simply reset. So the previous
-\DescRef{maincls.cmd.thispagestyle} will become invalid.
-
-Note, the layers of the page style will not be destroyed
-automatically. If you want to destroy the layers too, you may use
-% Umbruchkorrektur
+\BeginIndex{}{page style>layers}%
+\BeginIndex{}{layers>page style}%
+\iftrue
+This statement makes a layer page style undefined. If a page-style alias or
+ordinary page style is specified, the command is ignored.
+\else
+With this command you can remove a the definition of a layer page style.
+However, this only occurs if a layer page style named \PName{page style name}
+exists. If, instead, it is a page-style alias, a different (non-layer) page
+style, or not a page style at all, nothing happens; the command is ignored.%
+\fi
+
+If \PName{page style name} is the name of the current page style, the current
+page style will becomes a kind of empty page style. If the page style set with
+\DescRef{maincls.cmd.thispagestyle} is \PName{page style name}, it will simply
+be reset. The previous \DescRef{maincls.cmd.thispagestyle} command loses its
+current effect.
+
+Note\textnote{Attention!} that the layers of the page style are not destroyed
+automatically. If you want to destroy the layers too, you can do this with:
\begin{lstcode}
\ForEachLayerOfPageStyle{...}{\DestroyLayer{#1}}
\end{lstcode}
-\emph{before} destroying the layer page style.
+before destroying the layer page style itself.
-The command is intended to be used inside the auto-remove code of an interface
-See \autoref{sec:scrlayer.enduserinterfaces} below for more information about
-auto-remove code.%
+The command is intended to be used within the \PName{code} argument of
+\DescRef{\LabelBase.cmd.scrlayerOnAutoRemoveInterface} to remove page styles
+that are defined as part of an end-user interface. See
+\autoref{sec:scrlayer.enduserinterfaces} below for more information about
+auto-removal code.%
+\EndIndexGroup
\EndIndexGroup
\LoadCommonFile{headfootheight}% \section{Height of Page Head and Foot}
\LoadCommonFile{pagestylemanipulation}% \section{Manipulation of Defined Page Styles}
-\section{End User Interfaces}
+\section{Defining and Managing Interfaces for End Users}
\seclabel{enduserinterfaces}
-Package \Package{scrlayer} provides an interface to define and manage
-(concurrent) end user interfaces. Maybe future releases of \KOMAScript{} will
-provide parts of this by package \Package{scrbase} and remove those commands
-from \Package{scrlayer}. But currently this part if \Package{scrlayer} is very
-experimental, so package \Package{scrlayer} provides its own interface
-definition commands. Currently you should not depend on correct working of
-auto-removing a concurrent end user interface. Instead you should avoid using
-concurrent end user interfaces.
-
-This section only describes the interface commands for defining end user
-interfaces. This is not interesting for end users, but only for authors of end
-user interfaces. End users will find information about the end user interfaces
-in the sections about the particular end user interface, e.g.,
-\autoref{cha:scrlayer-scrpage}, \autoref{cha:scrlayer-scrpage-experts}, and
-\autoref{cha:scrlayer-notecolumn}.
+The \Package{scrlayer} package provides an experimental interface to define
+and manage (concurrent) interfaces for end users. \iffree{In the long run,
+ this interface may disappear from \Package{scrlayer} and be taken over by
+ \Package{scrbase} instead.}{} Currently, this interface is highly
+experimental%
+\iffree{ and therefore \Package{scrlayer} provides these interface commands
+ only for the use of subpackages of \Package{scrlayer}}{}%
+. Given the current state of development, you should not depend on automatic
+removal of a concurrent interface to work. Instead, you should avoid using
+concurrent end-user interfaces.
+
+This section only describes the interface commands for defining an end-user
+interface. For end users themselves, it is of little interest. Rather, this
+section is intended for authors of packages and classes that build on
+\Package{scrlayer}. End users will find information about specific end-user
+interfaces in \autoref{cha:scrlayer-scrpage},
+\autoref{cha:scrlayer-scrpage-experts}, and \autoref{cha:scrlayer-notecolumn}.
\begin{Declaration}
\Macro{scrlayerInitInterface}\OParameter{interface name}
\end{Declaration}
-Command \Macro{scrlayerInitInterface}
-registers a new interface. The \PName{interface name} must be unique. If you
-try to initialise an already initialised interface an error will occur. This
-command is obligatory and mandatory for interfaces. It should be the first
-interface command and therefore has been described first. If the optional
-argument is omitted, \PValue{\Macro{@currname}.\Macro{@currext}} will be
-used instead. For classes and packages this will be the file name of the class
-or package while loading the class or package. But you may use any sequence of
-characters with category letter or other.%
+The \Macro{scrlayerInitInterface} command registers a new interface named
+\PName{interface name}. The \PName{interface name} must be unique. If an
+interface with the same name has already been registered, an error will occur.
+
+This command should always appear as the first command when defining an
+end-user interface and therefore is described here first. If the optional
+argument\,---\,including the square brackets\,---\,is omitted,
+\PValue{\Macro{@currname}.\Macro{@currext}} will be used instead. For classes
+and packages, this is the file name of the class or package. But of course you
+can use any other sequence of characters with a category of \emph{letter} or
+\emph{other}. This is useful, for example, when a class or package defines
+multiple end-user interfaces%
\EndIndexGroup
@@ -1361,39 +1510,47 @@ characters with category letter or other.%
\Macro{scrlayerAddCsToInterface}%
\OParameter{interface name}\Parameter{command sequence}\Parameter{code}
\end{Declaration}
-One of the special features of end user interfaces is that they should
-register all interface dependent commands (also known as \emph{macros}). You
-may do this using \Macro{scrlayerAddToInterface}%
-. If your interface generates macros not only at load time but also at run
-time or if the interface name should not be the class's or package's name, you
-have to use the optional argument to add the command to a dedicated
-interface. An error will occur, if the interface has not been initialised
-before.
+One of the special features of \Package{scrlayer}'s end user interfaces is
+that they should register all interface-dependent commands (also known as
+\emph{macros}). You can do this using \Macro{scrlayerAddToInterface}. The
+optional argument \PName{interface name} must be an interface name previously
+registered with \DescRef{\LabelBase.cmd.scrlayerInitInterface}. An error will
+occur if the interface has not been initialised.
+
+If\textnote{Attention!} your interface defines macros not just when the class
+or package is being loaded but also at runtime, you must provide the interface
+name in the optional argument even if it corresponds to the file name of the
+class or package, since the values of \Macro{@currname} and \Macro{@currext}
+are only valid while the class or package is being loaded.
The first mandatory argument is the \PName{command}\footnote{The
- \PName{command} consists of the backslash followed by a \PName{command
- sequence} consisting of characters with category code letter or one other
- character, or \PName{command} consists of one active character (without
- backslash).} that should be added to the interface. If the command can be
-added to the interface, it will be added to the interface, will be set to
-\Macro{relax} and \PName{code} will be executed. You can use, e.g.,
-\Macro{newcommand}\PName{command} inside of \PName{code} to define
-\PName{command}.
-
-But when can a command be defined? If a command is undefined or \Macro{relax}
-it can be defined. If a command has already been defined and registered for
-another interface \emph{and} if \KOMAScript{} option
-\Option{autoremoveinterfaces} has been switched on, the other interface will be
-removed automatically and the new command will be set to \Macro{relax} and
-will be registered for the given interface. If a command
-has already been defined but is not part of another interface \emph{and} if
-\KOMAScript{} option \Option{forceoverwrite} has been switched on, the command
-will be set to \Macro{relax} and will be registered for the given interface.
-
-Command \Macro{scrlayerAddCsToInterface} is similar to
-\Macro{scrlayerAddToInterface} but does not expect a command as first,
-mandatory argument, but a command sequence\footnote{A command sequence may
- consist of any characters with category code letter or other.}.%
+ \PName{command} consists of a backslash followed by a \PName{command
+ sequence} that consists of characters of the category code \emph{letter},
+ or of exactly one character of the category \emph{other}, or of a character
+ of the category \emph{active} (without the backslash).} to be added to the
+interface. If the command can be defined, this will be done. In addition, it
+will set to \Macro{relax} and \PName{code} will be executed. Within
+\PName{code}, you can then define \PName{command}, e.\,g., using
+\Macro{newcommand}.
+
+But when can a command be defined? If a command is undefined or \Macro{relax},
+it can always be defined. If a command has already been defined \emph{and}
+registered for another interface \emph{and} if the \KOMAScript{} option
+\Option{autoremoveinterfaces} has been activated, the other interface will be
+removed automatically, and the \PName{command} will be set to \Macro{relax}
+and registered for the new interface specified. If a \PName{command} is
+already defined but is \emph{not} part of another interface, \emph{and} if the
+\KOMAScript{} option \Option{forceoverwrite} has been activated, the
+\PName{command} is also set to \Macro{relax} and registered for the specified
+interface. In all other cases, however, the command is not definable, in
+particular if it is already defined and the \KOMAScript{} options
+\Option{autoremoveinterfaces} and \Option{forceoverwrite} are deactivated.
+
+The \Macro{scrlayerAddCsToInterface} command is similar to
+\Macro{scrlayerAddToInterface} but it expects the first argument to be not a
+\PName{command} but a command sequence\footnote{A command sequence must be
+ fully expandable and its expansion must result in characters of the category
+ code \emph{letter}, \emph{other}, or \emph{space}.}.%
\EndIndexGroup
@@ -1401,13 +1558,17 @@ mandatory argument, but a command sequence\footnote{A command sequence may
\Macro{scrlayerOnAutoRemoveInterface}%
\OParameter{interface name}\Parameter{code}
\end{Declaration}
-Command \Macro{scrlayerOnAutoRemoveInterface} registers \PName{code} to be
-executed, if the interface will be automatically removed (see
-\DescRef{\LabelBase.option.autoremoveinterfaces} prior in this section). This
-may be used, e.g., to automatically destroy layers or page styles (see
+The \Macro{scrlayerOnAutoRemoveInterface} command registers \PName{code} to be
+executed in the event that the end-user interface with the specified
+\PName{interface name} is automatically removed (see
+\DescRef{\LabelBase.option.autoremoveinterfaces} earlier in this section).
+This can be used, for example, to automatically destroy layers or page styles
+that rely on commands from the end-user interface (see
\DescRef{\LabelBase.cmd.DestroyLayer},
\DescRef{\LabelBase.cmd.DestroyPageStyleAlias}, and
-\DescRef{\LabelBase.cmd.DestroyRealLayerPageStyle}).%
+\DescRef{\LabelBase.cmd.DestroyRealLayerPageStyle}). Regarding the default for
+the optional argument, please refer to the explanation for
+\DescRef{\LabelBase.cmd.scrlayerInitInterface}.%
\EndIndexGroup
%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlfile.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlfile.tex
index 8279b16672d..a01a4a0035a 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlfile.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlfile.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlfile.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlfile.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,109 +46,105 @@
% ============================================================================
\KOMAProvidesFile{scrlfile.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (chapter: scrlfile)]
-\translator{Gernot Hassenpflug\and Markus Kohm}
+\translator{Gernot Hassenpflug\and Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-02-15
-\chapter{Control Package Dependencies with \Package{scrlfile}}
+\chapter{Controlling Package Dependencies with \Package{scrlfile}}
\labelbase{scrlfile}
\BeginIndexGroup
\BeginIndex{Package}{scrlfile}
-The introduction of {\LaTeXe} in 1994 brought many changes in the
-handling of {\LaTeX} extensions. Today the package author has many
-macros available to determine if another package or class is
-employed and whether specific options are used. The author can load
-other packages or can specify options in the the case that the
-package is loaded later. This has led to the expectation that the
-order in which package are loaded would not be important. Sadly
-this hope has not been fulfilled.
+The introduction of \LaTeXe{} in 1994 brought many changes in the handling of
+\LaTeX{} extensions. The package author today has a whole series of macros
+available to determine if another package or class has been loaded and whether
+specific options are being used. The package author can even load other
+packages or specify certain options in case the package is loaded later. This
+has led to the expectation that the order in which package are loaded would
+not be important. Sadly, this hope has not been fulfilled.
\section{About Package Dependencies}
\seclabel{dependency}
+%\begin{Explain}
+More and more often, different packages either newly define or redefine the
+same macro. In such a case, the order in which a package is loaded becomes
+very important. Sometimes, users find it very difficult to understand the
+resulting behaviour. Sometimes it is necessary to react in a specific way when
+another package is loaded.
+
+As a simple example, consider loading the \Package{longtable} package with a
+\KOMAScript{} document class. The \Package{longtable} package defines its own
+table captions. These are perfectly suited to the standard classes, but they
+do not match the default settings for \KOMAScript{} captions, nor do they
+react to the relevant configuration options. To solve this problem, the
+\Package{longtable} package commands which are responsible for the table
+captions need to be redefined. However, by the time the \Package{longtable}
+package is loaded, the \KOMAScript{} class has already been processed.
+
+Previously, the only way to solve this problem was to delay the redefinition
+until the beginning of the document using \Macro{AtBeginDocument}. However, if
+users want to change the relevant commands themselves, they should do so in
+the preamble of the document. But this is impossible because \KOMAScript{}
+will overwrite the users' definitions at \Macro{begin}\PParameter{document}.
+They would also need to perform the redefinition with \Macro{AtBeginDocument}.
+
+But \KOMAScript{} does not actually need to wait for
+\Macro{begin}\PParameter{document} to redefine the macros. It would be
+sufficient to postpone the redefinition until after the \Package{longtable}
+package has been loaded. Unfortunately, the \LaTeX{} kernel does not define
+necessary commands. The \Package{scrlfile} package provides a remedy for this
+problem.
+
+It is also conceivable that you would like to save the definition of a macro
+in a temporary macro before a package is loaded and restore it after the
+package has been loaded. The \Package{scrlfile} package allows this, too.
+
+The use of \Package{scrlfile} is not limited to package dependencies.
+Dependencies can also be considered for any other file. For example, you can
+ensure that loading the not unimportant file \File{french.ldf} automatically
+leads to a warning.
-More and more frequently, different packages either newly define or
-redefine the same macro again. In such a case the order in which a
-package is loaded becomes very important. For the user it sometimes
-becomes very difficult to understand the behaviour, and in some
-cases the user wants only to react to the loading of a package. This
-too is not really a simple matter.
-
-Let us take the simple example of loading the package \Package{longtable} with
-a {\KOMAScript} document class. The \Package{longtable} package defines table
-captions very well suited to the standard classes, but the captions are
-totally unsuitable for documents using {\KOMAScript} and also do not react to
-the options of the provided configuration commands. In order to solve this
-problem, the \Package{longtable} package commands which are responsible for
-the table captions need to be redefined. However, by the time the
-\Package{longtable} package is loaded, the {\KOMAScript} class has already
-been processed.
-
-Until the present, the only way for {\KOMAScript} to solve this problem was to
-delay the redefinition until the beginning of the document with help of the
-macro \Macro{AtBeginDocument}. If the user wants to change the definitions
-too, it is recommended to do this in the preamble of the document. However,
-this is impossible since later at \Macro{begin}\PParameter{document}
-{\KOMAScript} will again overwrite the user definition with its own.
-Therefore, the user too has to delay his definition with
-\Macro{AtBeginDocument}.
-
-Actually, {\KOMAScript} should not need to delay the redefinition until
-\Macro{begin}\PParameter{document}. It would be enough to delay exactly until
-the package \Package{longtable} has been loaded. Unfortunately, the {\LaTeX}
-kernel does not define appropriate commands. The package \Package{scrlfile}
-provides redress here.
-
-Likewise, it might be conceivable that before a package is loaded one would
-like to save the definition of a macro in a help-macro, in order to restore
-its meaning after the package has been loaded. The package \Package{scrlfile}
-allows this, too.
-
-The employment of \Package{scrlfile} is not limited to package dependencies
-only. Even dependencies on any other file can be considered. For example,
-the user can be warned if the not uncritical file \File{french.ldf} has been
-loaded.
-
Although the package is particularly of interest for package authors, there
-are of course applications for normal {\LaTeX} users, too. Therefore, this
-chapter gives and explains examples for both groups of users.
+are also applications for normal \LaTeX{} users. Therefore, this chapter
+gives examples for both groups.
+%\end{Explain}
-\section{Actions Prior to and After Loading}
+\section{Actions Before and After Loading}
\seclabel{macros}
-\Package{scrlfile} can execute actions both before and after the
-loading of files. In the commands used to do this, distinctions are
-made made between general files, classes, and packages.
+The \Package{scrlfile} package can execute actions both before and after
+loading files. The commands used to do so distinguish between ordinary files,
+classes, and packages.
\begin{Declaration}
- \Macro{BeforeFile}\Parameter{file}\Parameter{instructions}%
- \Macro{AfterFile}\Parameter{file}\Parameter{instructions}
+ \Macro{BeforeFile}\Parameter{file}\Parameter{commands}%
+ \Macro{AfterFile}\Parameter{file}\Parameter{commands}
\end{Declaration}%
-The macro \Macro{BeforeFile} ensures that \PName{instructions} are
-only executed before the next time \PName{file} is loaded.
-\Macro{AfterFile} works in a similar fashion, and the
-\PName{instructions} will be executed only after the \PName{file} has
-been loaded. If \PName{file} is never loaded then the
-\PName{instructions} will never be executed.
-
-In order to implement those features \Package{scrlfile} redefines the well
-known {\LaTeX} command \Macro{InputIfFileExists}. If this macro does not have
-the expected definition then \Package{scrlfile} issues a warning. This is for
-the case that in future {\LaTeX} versions the macro can have a different
-definition, or that another package has already redefined it.
-
-The command \Macro{InputIfFileExists} is used by {\LaTeX} every time a file is
-to be loaded. This is independent of whether the actual load command is
+\Macro{BeforeFile} ensures that the \PName{commands} are executed before the
+next time \PName{file} is loaded. \Macro{AfterFile} works in a similar
+fashion, and the \PName{commands} will be executed after the \PName{file} has
+been loaded. Of course, if \PName{file} is never loaded, the \PName{commands}
+will never be executed. For \PName{file}, you should specify any extensions as
+part of the file name, as you would with \Macro{input}.
+
+To implement those features, \Package{scrlfile} redefines the well-known
+\LaTeX{} command \Macro{InputIfFileExists}. If this command does not have the
+expected definition, \Package{scrlfile} issues a warning. This occurs in case
+the command is changed in future \LaTeX{} versions or has already been
+redefined by another package.
+
+\LaTeX{} uses the \Macro{InputIfFileExists} command every time it loads a
+file. This occurs regardless of whether the file is loaded with
\Macro{include}, \Macro{LoadClass}, \Macro{documentclass}, \Macro{usepackage},
-\Macro{RequirePackage}, or similar. Exceptionally, the command
+\Macro{RequirePackage}, or similar commands. Only
\begin{lstcode}
\input foo
\end{lstcode}
-loads the file \texttt{foo} without utilizing
-\Macro{InputIfFileExists}. Therefore, one should always use
+loads the file \texttt{foo} without using
+\Macro{InputIfFileExists}. You should therefore always use
\begin{lstcode}
\input{foo}
\end{lstcode}
@@ -158,70 +154,76 @@ instead. Notice the parentheses surrounding the file name!%
\begin{Declaration}
- \Macro{BeforeClass}\Parameter{class}\Parameter{instructions}%
- \Macro{BeforePackage}\Parameter{package}\Parameter{instructions}
+ \Macro{BeforeClass}\Parameter{class}\Parameter{commands}%
+ \Macro{BeforePackage}\Parameter{package}\Parameter{commands}
\end{Declaration}%
-These two commands work in the same way as \DescRef{\LabelBase.cmd.BeforeFile}. The only
-difference is that the document class \PName{class} and the {\LaTeX} package
-\PName{package} are specified with their names and not with their file names.
-That means that the file extensions \File{.cls} and \File{.sty} can be
-omitted.%
+These two commands work the same way as \DescRef{\LabelBase.cmd.BeforeFile}.
+The only difference is that the \PName{class} or \PName{package} is specified
+with its class or package name and not with its file name. That means you
+should omit the file extensions \File{.cls} or \File{.sty}.%
%
\EndIndexGroup
\begin{Declaration}
- \Macro{AfterClass}\Parameter{class}\Parameter{instructions}%
- \Macro{AfterClass*}\Parameter{class}\Parameter{instructions}%
- \Macro{AfterClass+}\Parameter{class}\Parameter{instructions}%
- \Macro{AfterClass!}\Parameter{class}\Parameter{instructions}%
- \Macro{AfterAtEndOfClass}\Parameter{class}\Parameter{instructions}%
- \Macro{AfterPackage}\Parameter{package}\Parameter{instructions}%
- \Macro{AfterPackage*}\Parameter{package}\Parameter{instructions}%
- \Macro{AfterPackage+}\Parameter{package}\Parameter{instructions}%
- \Macro{AfterPackage!}\Parameter{package}\Parameter{instructions}%
- \Macro{AfterAtEndOfPackage}\Parameter{package}\Parameter{instructions}
+ \Macro{AfterClass}\Parameter{class}\Parameter{commands}%
+ \Macro{AfterClass*}\Parameter{class}\Parameter{commands}%
+ \Macro{AfterClass+}\Parameter{class}\Parameter{commands}%
+ \Macro{AfterClass!}\Parameter{class}\Parameter{commands}%
+ \Macro{AfterAtEndOfClass}\Parameter{class}\Parameter{commands}%
+ \Macro{AfterPackage}\Parameter{package}\Parameter{commands}%
+ \Macro{AfterPackage*}\Parameter{package}\Parameter{commands}%
+ \Macro{AfterPackage+}\Parameter{package}\Parameter{commands}%
+ \Macro{AfterPackage!}\Parameter{package}\Parameter{commands}%
+ \Macro{AfterAtEndOfPackage}\Parameter{package}\Parameter{commands}
\end{Declaration}%
-The commands \Macro{AfterClass} and \Macro{AfterPackage} work in the
-same way as \DescRef{\LabelBase.cmd.AfterFile}. The only difference is that the
-document class \PName{class} and the {\LaTeX} package \PName{package}
-are specified with their names and not with their file names. That
-means that the file extensions \File{.cls} and \File{.sty} can be
-omitted.
+The \Macro{AfterClass} and \Macro{AfterPackage} commands work much like
+\DescRef{\LabelBase.cmd.AfterFile}. The only difference is that the
+\PName{class} or \PName{package} is specified with its class or package name
+and not with its file name. That means you should omit the file extensions
+\File{.cls} or \File{.sty}.
The\important[i]{\Macro{AfterClass*}\\\Macro{AfterPackage*}} starred versions
-are a little bit different. They execute the \PName{instructions} not only at
-next time that the class or package is loaded, but also immediately if the
-class or package has been loaded already.
+function somewhat differently. If the class or package has already been
+loaded, they execute the \PName{commands} immediately rather than waiting
+until the next time the class or package is loaded.
The\important[i]{\Macro{AfterClass+}\\\Macro{AfterPackage+}}
-plussed\ChangedAt{v3.09}{\Package{scrlfile}} version executes the
-\PName{instructions} after loading of the class or package has been
-finished. The difference to the starred version is only valid, if loading of
-the class or package already started but has not been finished
-yet. Nevertheless, \PName{instructions} will be executed before the
-instructions of \Macro{AtEndOfClass} or \Macro{AtEndOfPackage} when loading of
-the class or package has not been finished already.
+plus\ChangedAt{v3.09}{\Package{scrlfile}} version executes the
+\PName{commands} after the class or package has been completely loaded. This
+behaviour differs from that of the starred version only if you use the command
+when the class or package has begun loading but has not yet finished. If the
+class or package has not finished loading, the \PName{commands} will always be
+executed before the commands in \Macro{AtEndOfClass} or
+\Macro{AtEndOfPackage}.
If\important[i]{\Macro{AfterClass!}\\\Macro{AfterPackage!}} a class uses
\Macro{AtEndOfClass} or a package uses \Macro{AtEndOfPackage} to execute
-instructions after the class of package file has been loaded completely, and
-if you want to execute \PName{instructions} after the instructions of these
-commands, you may use the exclamation mark version,
-\Macro{AfterClass!}\ChangedAt{v3.09}{\Package{scrlfile}} respectively
+commands after the class of package file has been loaded completely, and
+if you want to execute \PName{commands} after these deferred
+commands have been executed, you can use the exclamation-mark versions
+\Macro{AfterClass!}\ChangedAt{v3.09}{\Package{scrlfile}} or
\Macro{AfterPackage!}.
If\important[i]{\Macro{AfterAtEndOfClass}\\\Macro{AfterAtEndOfPackage}} you
-want to do this only in the case the class or package will be loaded later,
-and if you want to execute \PName{instructions} outside the context of the
-class or package, that will be loaded, you may use
+want to execute the \PName{commands} only when the class or package is loaded
+later and outside the context of that class or package, you can use
\Macro{AfterAtEndOfClass}\ChangedAt{v3.09}{\Package{scrlfile}} for classes and
\Macro{AfterAtEndOfPackage} for packages.
\begin{Example}
- In the following, an example for class and package authors shall be
- given. It shows how {\KOMAScript} itself employs the new commands.
- The class \Class{scrbook} contains:
+ The following example for class and package authors shows how \KOMAScript{}
+ itself makes use of the new commands. The class \Class{scrbook} contains the
+ following:
+% CORRECTED MESSAGE:
+% You are using an old version of the hyperref
+% package!\MessageBreak%
+% This version has a buggy hack in many
+% drivers,\MessageBreak%
+% causing \string\addchap\space to behave
+% strangely.\MessageBreak%
+% Please update hyperref to at least version
+% 6.71b}%
\begin{lstcode}
\AfterPackage{hyperref}{%
\@ifpackagelater{hyperref}{2001/02/19}{}{%
@@ -236,48 +238,40 @@ class or package, that will be loaded, you may use
6.71b}}}
\end{lstcode}
Old versions of the \Package{hyperref} package redefine a macro of the
- \Class{scrbook} class in such a way that does not work with newer
- {\KOMAScript} versions. New versions of \Package{hyperref} desist
- from making these changes if a new {\KOMAScript} version is detected.
- For the case that \Package{hyperref} is loaded at a later stage,
- therefore, the code in \Class{scrbook} verifies that a acceptable
- \Package{hyperref} version is used. If not, the command issues a
- warning.
-
- At other places in three {\KOMAScript} classes the following can be
- found:
+ \Class{scrbook} class in a way that is incompatible with newer \KOMAScript{}
+ versions. Newer versions of \Package{hyperref} refrain from making this
+ change if a newer version of \KOMAScript{} is detected. In case
+ \Package{hyperref} is loaded at a later stage, \Class{scrbook} ensures that
+ a check for an acceptable version of \Package{hyperref} is performed
+ immediately after the package is loaded. If this is not the case, a warning
+ is issued.
+
+ Elsewhere in three of the \KOMAScript{} classes, you can find the following:
\begin{lstcode}
\AfterPackage{caption2}{%
\renewcommand*{\setcapindent}{%
\end{lstcode}
- After the package \Package{caption2} has been loaded, and only if it
- has been loaded, {\KOMAScript} redefines its own command
- \DescRef{maincls.cmd.setcapindent}. The exact code of the redefinition is
- not important. It should only be noted that \Package{caption2} takes
- control of the \DescRef{maincls.cmd.caption} macro and that therefore the
- normal definition of the \DescRef{maincls.cmd.setcapindent} macro would
- become ineffective. The redefinition improves the collaboration with
- \Package{caption2}.
-
- There are however also useful examples for normal {\LaTeX} user. Suppose a
- document that should be available as a PS file, using {\LaTeX} and dvips, as
- well as a PDF file, using pdf{\LaTeX}. In addition, the document should
- contain hyperlinks. In the list of tables there are entries longer than one
- line. This is not a problem for the pdf{\LaTeX} method, since here
- hyperlinks can be broken across multiple lines. However, if a
- \Package{hyperref} driver for dvips or hyper{\TeX} is used then this is not
- possible. In this case one desires that for the \Package{hyperref} setup
- \Option{linktocpage} is used. The decision which \Package{hyperref} driver
- to use happens automatically via \File{hyperref.cfg}. The file has, for
- example, the following content:
-\begin{lstcode}
- \ProvidesFile{hyperref.cfg}
- \@ifundefined{pdfoutput}{\ExecuteOptions{dvips}}
- {\ExecuteOptions{pdftex}}
- \endinput
-\end{lstcode}
-
- All the rest can now be left to \DescRef{\LabelBase.cmd.AfterFile}.
+ After loading \Package{caption2}, and only if it has been loaded,
+ \KOMAScript{} redefines its own \DescRef{maincls.cmd.setcapindent} command.
+ The exact code of the redefinition is irrelevant. The important thing to
+ note is that \Package{caption2} takes control of the
+ \DescRef{maincls.cmd.caption} macro and that therefore the normal definition
+ of the \DescRef{maincls.cmd.setcapindent} command would have no effect. The
+ redefinition thus improves interoperability with \Package{caption2}.
+
+ There are also, however, instances where these commands are useful to normal
+ \LaTeX{} users. For example, suppose you create a document from which you
+ want to generate both a PostScript file, using \LaTeX{} and dvips, and a PDF
+ file, using \mbox{pdf{\LaTeX}}. The document should also contain hyperlinks.
+ In the table of contents, you have entries that span several lines. This is
+ not a problem for the \mbox{pdf{\LaTeX}} method, since here hyperlinks can
+ be broken across multiple lines. However, this is not possible with the
+ \Package{hyperref} driver for dvips or \mbox{hyper{\TeX}}. In this case, you
+ would like \Package{hyperref} to use the \Option{linktocpage} option. The
+ decision as to which driver is loaded is made automatically by
+ \File{hyperref}.
+
+ Everything else can now be left to \DescRef{\LabelBase.cmd.AfterFile}:
\begin{lstcode}
\documentclass{article}
\usepackage{scrlfile}
@@ -288,37 +282,45 @@ class or package, that will be loaded, you may use
\listoffigures
\clearpage
\begin{figure}
- \caption{This is an example for a fairly long figure caption, but
- which does not employ the optional caption argument that would
- allow one to write a short caption in the list of figures.}
+ \caption{This is an example of a fairly long figure caption, but
+ one that does not use the optional caption argument that would
+ allow you to write a short caption in the list of figures.}
\end{figure}
\end{document}
\end{lstcode}
- If now the \Package{hyperref} drivers \Option{hypertex} or
- \Option{dvips} are used, then the useful \Package{hyperref} option
- \Option{linktocpage} will be set. In the pdf{\LaTeX} case, the option
- will not be set, since in that case another \Package{hyperref} driver,
- \File{hpdftex.def}, will be used. That means neither \File{hdvips.def}
+ If either of the \Package{hyperref} drivers \Option{hypertex} or
+ \Option{dvips} is used, the useful \Package{hyperref} option
+ \Option{linktocpage} will be set. However, if you create a PDF file
+ with \mbox{pdf{\LaTeX}}, the option
+ will not be set because then the \Package{hyperref} driver
+ \File{hpdftex.def} will be used. This means that neither \File{hdvips.def}
nor \File{hypertex.def} will be loaded.
\end{Example}
-
-Furthermore\textnote{Hint!}, the loading of package \Package{scrlfile} and
-the \DescRef{\LabelBase.cmd.AfterFile} statement can be written in a private
-\File{hyperref.cfg}. If you do so, then instead of \Macro{usepackage} the
-macro \Macro{RequirePackage} ought be used (see \cite{latex:clsguide}). The
-new lines have to be inserted directly after the \Macro{ProvidesFile} line,
-thus immediately prior to the execution of the options \Option{dvips} or
-\Option{pdftex}.%
-%
+\iffalse% Umbruchkorrekturtext (der besser nicht mehr verwendet wird!)
+ Furthermore\textnote{Hint!}, you can also load \Package{scrlfile} and the
+ \DescRef{\LabelBase.cmd.AfterFile} command into a private
+ \File{hyperref.cfg}. In this case, however, you should use
+ \Macro{RequirePackage} instead of \Macro{usepackage} to load the package
+ (see \cite{latex:clsguide}). In the example above, the new lines have to be
+ inserted directly after the \Macro{ProvidesFile} line, that is, immediately
+ before the \Option{dvips} or \Option{pdftex} options are executed.%
+\fi
+Incidentally\textnote{Hint!}, you can also load \Package{scrlfile} before
+\DescRef{maincls.cmd.documentclass}\IndexCmd{documentclass}. In this case,
+however, you should use \Macro{RequirePackage}\IndexCmd{RequirePackage}
+instead of \DescRef{maincls.cmd.usepackage} (see \cite{latex:clsguide}).%
\EndIndexGroup
\begin{Declaration}
- \Macro{BeforeClosingMainAux}\Parameter{instructions}%
- \Macro{AfterReadingMainAux}\Parameter{instructions}%
+ \Macro{BeforeClosingMainAux}\Parameter{commands}%
+ \Macro{AfterReadingMainAux}\Parameter{commands}%
\end{Declaration}%
-Package authors often want to write something into the \File{aux}-file after
-the last document page have been shipped out. To do so, often
+These commands differ in one detail from the commands explained previously.
+Those commands enable actions before or after loading files. That is not the
+case here. Package authors often want to write something to the \File{aux}
+file after the last document page has been shipped out. To do so, ignoring the
+resulting problems they create, they often use code such as the following:
\begin{lstcode}
\AtEndDocument{%
\if@filesw
@@ -328,15 +330,14 @@ the last document page have been shipped out. To do so, often
\fi
}
\end{lstcode}
-is used. Nevertheless this is not a real solution of the problem. If the last
-page of the document already have been shipped out before
-\Macro{end}\PParameter{document}, the code above will not result in any
-writing into the \File{aux}-file. If someone would try to fix this new problem
-using \Macro{immediate} just before \Macro{write}, the inverse problem would
-occur: If the last page was not shipped out before
-\Macro{end}\PParameter{document} the \Macro{writethistoaux} would be written
-into \File{aux}-file before ship-out the last page. Another often seen
-suggestion for this problem therefore is:
+However, this does not really solve the problem. If the last page of the
+document has already been shipped out before \Macro{end}\PParameter{document},
+the code above will not result in any output to the \File{aux} file. If you
+try to fix this new problem using \Macro{immediate} just before \Macro{write},
+you would have the opposite problem: if the last page has not yet been shipped
+out before \Macro{end}\PParameter{document}, \Macro{writethistoaux} would be
+written to the \File{aux} file too early. Therefore you often see solutions
+like:
\begin{lstcode}
\AtEndDocument{%
\if@filesw
@@ -347,23 +348,23 @@ suggestion for this problem therefore is:
\fi
}
\end{lstcode}
-This suggestion has a disadvantage again: The ship-out of the last page has
-been enforced by the \DescRef{maincls.cmd.clearpage}. After that, instructions
-like
+However, this solution has the disadvantage that it forces the last page to be
+shipped out. A command such as
\begin{lstcode}
\AtEndDocument{%
\par\vspace*{\fill}%
Note at the end of the document.\par
}
\end{lstcode}
-would not any longer output the note at the end of the last page of the
-document but at the end of one more page. Additionally \Macro{writethistoaux}
-would be written one page to early into the \File{aux}-file again.
-
-The best solution for this problem would be, to write to the \File{aux}-file
-immediately after the final \DescRef{maincls.cmd.clearpage}, that is part of
-\Macro{end}\PParameter{document}, but just before closing the
-\File{aux}-file. This is the purpose of \Macro{BeforeClosingMainAux}:
+will no longer cause the note to appear beneath the text of the last real page
+of the document but at the end of one additional page. Furthermore,
+\Macro{writethistoaux} will again be written to the \File{aux} file one page
+too early.
+
+The best solution for this problem would be if you could write directly to the
+\File{aux} file immediately after the final \DescRef{maincls.cmd.clearpage}
+that is part of \Macro{end}\PParameter{document} but before closing the
+\File{aux} file. This is the purpose of \Macro{BeforeClosingMainAux}:
\begin{lstcode}
\BeforeClosingMainAux{%
\if@filesw
@@ -373,25 +374,24 @@ immediately after the final \DescRef{maincls.cmd.clearpage}, that is part of
\fi
}
\end{lstcode}
-This would be successful even if the final \DescRef{maincls.cmd.clearpage}
-inside of \Macro{end}\PParameter{document} would not really ship-out any page
-or if someone have had used \DescRef{maincls.cmd.clearpage} in the argument of
-\Macro{AtEndDocument}.
-
-Nevertheless there one important limitation using
-\Macro{BeforeClosingMainAux}: You should not use a typeset instruction inside
-the \PName{instructions} of \Macro{BeforeClosingMainAux}! If you miss this
-limitation the result would be as unpredictable as the results of the
-problematic suggestions using \Macro{AtEndDocument} upward.
-
-Command \Macro{AfterReadingMainAux}\ChangedAt{v3.03}{\Package{scrlfile}}
-actually executes the \PName{instructions} just after closing and input of the
-\File{aux}-file inside of \Macro{end}\PParameter{document}. This will make
-sense only in some cases, e.\,g., to show statistic information, that will be
-valid only after input of the \File{aux}-file, or to write such information
-into the \File{log}-file, or to implement additional \emph{rerun}
-requests. Typeset instructions are even more critical inside these
-\PName{instructions} that inside the argument of
+This will be successful even if the final \DescRef{maincls.cmd.clearpage}
+inside of \Macro{end}\PParameter{document} does not actually ship out any page
+or if \DescRef{maincls.cmd.clearpage} is used within an \Macro{AtEndDocument}
+command.
+
+However, there one important limitation using \Macro{BeforeClosingMainAux}:
+you should not use any typesetting commands inside the \PName{commands} of
+\Macro{BeforeClosingMainAux}! If you ignore this restriction, the result is
+just as unpredictable as the results of the problematic suggestions above that
+use \Macro{AtEndDocument}.
+
+The \Macro{AfterReadingMainAux}\ChangedAt{v3.03}{\Package{scrlfile}} command
+actually executes the \PName{commands} after closing and reading the
+\File{aux} file inside \Macro{end}\PParameter{document}. This is only useful
+in a few very rare cases, for example to write statistical information to the
+\File{log} file which is valid only after reading the \File{aux} file, or to
+implement additional \emph{rerun} requests. Typesetting commands are even more
+dangerous inside these \PName{commands} than inside the argument of
\Macro{BeforeClosingMainAux}.%
%
\EndIndexGroup
@@ -400,114 +400,107 @@ requests. Typeset instructions are even more critical inside these
\section{Replacing Files at Input}
\seclabel{replace}
-All previous sections in this chapter describe commands to execute
-instructions before or after input of a file, class, or package. Package
-\Package{scrlfile} also provides commands to input another file, class, or
-package instead of the one, that has been declared.
+The previous sections in this chapter have explained commands to perform
+actions before or after loading a particular file, package, or class. You can
+also use \Package{scrlfile} to input a completely different file than the one
+that was requested.
\begin{Declaration}
- \Macro{ReplaceInput}\Parameter{source file name}%
- \Parameter{replacement file name}%
+ \Macro{ReplaceInput}\Parameter{original file}%
+ \Parameter{replacement file}%
\end{Declaration}%
This\ChangedAt{v2.96}{\Package{scrlfile}} command defines a replacement for
-the file of the first argument: \PName{source file name}, by the file of the
-second argument: \PName{replacement file name}. If \LaTeX{} will be instructed
-to input the file with \PName{source file name} at any time afterward, the
-file with the \PName{replacement file name} will be input instead. The
-replacement definition will be valid for all files, that the user will input
-with \Macro{InputIfFileExists} and for all files, that will be input with a
-command, that uses \Macro{InputIfFileExists} internally. To do so,
-\Package{scrlfile} redefined \Macro{InputIfFileExists}.
+the file specified in the first argument, \PName{original file}. If \LaTeX{}
+is instructed to load this file, the \PName{replacement file} will be loaded
+instead. The replacement-file definition affects all files loaded using
+\Macro{InputIfFileExists}, whether they are loaded by the user or internally
+by \LaTeX{}. To do so, \Package{scrlfile} redefines \Macro{InputIfFileExists}.
\begin{Example}
- You want \LaTeX{} to input file \File{\Macro{jobname}.xua} instead of file
- \File{\Macro{jobname.aux}}. This may be done using
+ You want to input the \File{\Macro{jobname}.xua} file instead of the
+ \File{\Macro{jobname.aux}} file. To do this, you use
\begin{lstcode}
\ReplaceInput{\jobname.aux}{\jobname.xua}
\end{lstcode}
- Additionally you may replace \File{\Macro{jobname}.xua} by
- \File{\Macro{jobname}.uxa} using:
+ If additionally you replace \File{\Macro{jobname}.xua} by
+ \File{\Macro{jobname}.uxa} using
\begin{lstcode}
\ReplaceInput{\jobname.xua}{\jobname.uxa}
\end{lstcode}
- This will also replace input of \File{\Macro{jobname}.aux}, i.\,e., while
- \Macro{end}\PParameter{document}, by \File{\Macro{jobname}.uxa}. As you see,
- the whole replacement chain will be executed.
+ then \File{\Macro{jobname}.aux} will also be replaced by
+ \File{\Macro{jobname}.uxa}. In this way, you can process the whole
+ replacement chain.
- Nevertheless a round robin replacement like
+ However, a replacement that results in a loop such as
\begin{lstcode}
\ReplaceInput{\jobname.aux}{\jobname.xua}
\ReplaceInput{\jobname.xua}{\jobname.aux}
\end{lstcode}
- would result in a \emph{stack size error}. So it is not possible to define a
- replacement of a file by itself directly or indirectly.
+ will cause a \emph{stack size error}. So it is not possible to replace
+ a file that has already been replaced once by itself again.
\end{Example}
-In theory is would also be possible to replace a package or class by another
-one. But \LaTeX{} would recognize the usage of the wrong file name in this
-case. A solution for this problem will be shown next.%
-%
+In theory, it would also be possible to use this command to replace one
+package or class with another. But \LaTeX{} would recognize that the requested
+file name does not match the name of the package or class. You can find a
+solution for this problem below.%
\EndIndexGroup
\begin{Declaration}
- \Macro{ReplaceClass}\Parameter{source class}%
- \Parameter{replacement package}%
- \Macro{ReplacePackage}\Parameter{source package}%
+ \Macro{ReplaceClass}\Parameter{original class}%
+ \Parameter{replacement class}%
+ \Macro{ReplacePackage}\Parameter{original package}%
\Parameter{replacement package}%
\end{Declaration}%
-Classes\ChangedAt{v2.96}{\Package{scrlfile}}\textnote{Attention!} or packages
-should never be replaced using previously described command
-\DescRef{\LabelBase.cmd.ReplaceInput}. Using this command would result in a \LaTeX{} warning
-because of class or package name not according the file name.
+You\ChangedAt{v2.96}{\Package{scrlfile}}\textnote{Attention!} should never
+replace a class or package using the \DescRef{\LabelBase.cmd.ReplaceInput}
+command described above. Doing so would result in a \LaTeX{} warning about
+mismatched class or package names. Real errors are also possible if a class or
+package is loaded under an incorrect file name.
\begin{Example}
- You replace package \Package{fancyhdr} by package \Package{scrpage2}
- inconsiderately using
-\begin{lstcode}
- \ReplaceInput{fancyhdr.sty}{scrpage2.sty}
+ You replace the \Package{scrpage2} package with its official successor,
+ \Package{scrlayer-scrpage}, by using
+\begin{lstcode}[escapechar=\$]
+ \ReplaceInput{scrpage2.sty}{scrlayer-scrpage.sty}$\textnote{Do not try this!}$
\end{lstcode}
- Loading \Package{fancyhdr}, would result in
+ Loading \Package{scrpage2} will then lead to the following warning:
\begin{lstcode}
LaTeX warning: You have requested `scrpage2',
- but the package provides `fancyhdr'.
+ but the package provides `scrlayer-scrpage'.
\end{lstcode}
- after this. Users may be confused by such a warning, because they've used,
- e.\,g., \Macro{usepackage}\PParameter{fancyhdr} and never requested package
- \Package{scrpage2} on their own. But \Package{scrlfile} replaced the input
- of \File{fancyhdr.sty} by \File{scrpage2.sty} because of your replacement
- definition.
+ Users may be greatly confused by such a warning because they requested not
+ \Package{scrlayer-scrpage} but \Package{scrpage2}, which was replaced by
+ \Package{scrlayer-scrpage}.
\end{Example}
-A solution for this problem would be, to use \Macro{ReplaceClass} or
-\Macro{ReplacePackage} instead of
-\DescRef{\LabelBase.cmd.ReplaceInput}. Please note, that in this case you have
-to use the names of the classes or packages only instead of the whole file
-name. This is similar to usage of \Macro{documentclass} and
-\Macro{usepackage}.
-
-The class replacement would perform for all classes, that will be loaded using
+One solution to this problem is to use \Macro{ReplaceClass} or
+\Macro{ReplacePackage} instead of \DescRef{\LabelBase.cmd.ReplaceInput}. Note
+that in this case, as with \Macro{documentclass} and \Macro{usepackage}, you
+should give the name of the class or package and not the complete file name.
+
+The replacement class works for all classes loaded with
\Macro{documentclass}, \Macro{LoadClassWithOptions}, or \Macro{LoadClass}. The
-package replacement would perform for all packages, that will be loaded using
+replacement package works for all packages loaded with
\Macro{usepackage}, \Macro{RequirePackageWithOptions}, or
\Macro{RequirePackage}.
-Please\textnote{Attention!} note, that the \PName{replacement class} or the
-\PName{replacement package} will be loaded with the same options, the
-\PName{source class} or \PName{replacement class} would until it has been
-replaced. Replacement of a class or package by a class or package, that does
-not support a requested option, would result in a warning or even an error
-message. But you may declare such missing options using
-\DescRef{\LabelBase.cmd.BeforeClass} or
+Please\textnote{Attention!} note that the \PName{replacement class} or the
+\PName{replacement package} will be loaded with the same options that would
+have been passed to the \PName{original class} or \PName{original package}. If
+you replace a class or package with one that does not support a requested
+option, you will receive the usual warnings and errors. However, you can
+declare such missing options using \DescRef{\LabelBase.cmd.BeforeClass} or
\DescRef{\LabelBase.cmd.BeforePackage}.
\begin{Example}
- Assumed, package \Package{oldfoo} should be replaced by
- \Package{newfoo}. This may be done using:
+ Suppose you want to replace the \Package{oldfoo} package with the
+ \Package{newfoo} package when the former package is loaded. You can do this with
\begin{lstcode}
\ReplacePackage{oldfoo}{newfoo}
\end{lstcode}
- Assumed the old package provides an option \Option{oldopt}, but the new
- package does not. Using
+ Suppose the old package provides an \Option{oldopt} option, but the new
+ package does not. With
\begin{lstcode}
\BeforePackage{newfoo}{%
\DeclareOption{oldopt}{%
@@ -515,21 +508,21 @@ message. But you may declare such missing options using
{option `oldopt' not supported}%
}}%
\end{lstcode}
- additionally, would declare this missing option for package
- \Package{newfoo}. This would avoid warning message about unsupported
- options.
+ you can declare this missing option for the \Package{newfoo} package. This
+ avoids an error message when the \Package{oldfoo} package is loaded with the
+ option that is unsupported by \Package{newfoo}.
- However, if package \Package{newfoo} supports an option \Option{newopt},
- that should be used instead of option \Option{oldopt} of old package
- \Package{oldfoo}, this may achieved using:
+ If, on the other hand, the \Package{newfoo} package supports a
+ \Option{newopt} option that should be used instead of the \Option{oldopt}
+ option, you can also achieved this:
\begin{lstcode}
\BeforePackage{newfoo}{%
\DeclareOption{oldopt}{%
\ExecuteOptions{newopt}%
}}%
\end{lstcode}
- Last but not least different default options may be selected, that should be
- valid while package replacement:
+ You can even specify different default options that apply when loading the
+ new package:
\begin{lstcode}
\BeforePackage{newfoo}{%
\DeclareOption{oldopt}{%
@@ -539,7 +532,7 @@ message. But you may declare such missing options using
{newfoo}%
}
\end{lstcode}
- or somehow more directly:
+ or directly:
\begin{lstcode}
\BeforePackage{newfoo}{%
\DeclareOption{oldopt}{%
@@ -549,9 +542,11 @@ message. But you may declare such missing options using
\PassOptionsToPackage{newdefoptA,newdefoptB}%
{newfoo}%
\end{lstcode}
+ Note that in the last example, the call to \Macro{PassOptionsToPackage}
+ occurs not within but after \Macro{BeforePackage}
\end{Example}
-To replace classes package \Package{scrlfile} has to be loaded before the
+Of course, to replace classes, you must load \Package{scrlfile} before the
class using \Macro{RequirePackage} instead of \Macro{usepackage}.
%
\EndIndexGroup
@@ -562,74 +557,71 @@ class using \Macro{RequirePackage} instead of \Macro{usepackage}.
\Macro{UnReplacePackage}\Parameter{package}%
\Macro{UnReplaceClass}\Parameter{class}%
\end{Declaration}
-A\ChangedAt{v3.12}{\Package{scrlfile}} replacement definition can be removed
-using one of these commands. The replacement definition of a input file should
-be removed using \Macro{UnReplaceInput}, the replacement definition of a
-package should be removed using \Macro{UnReplacePackage}, and the replacement
-definition of a class should be removed using \Macro{UnReplaceClass}.%
+You\ChangedAt{v3.12}{\Package{scrlfile}} can also remove a replacement. You
+should remove the replacement definition for an input file using
+\Macro{UnReplaceInput}, for a package using \Macro{UnReplacePackage}, and for
+a class using \Macro{UnReplaceClass}.%
\EndIndexGroup
-\section{Prevent File Loading}
+\section{Preventing File Loading}
\seclabel{prevent}
-Especially\ChangedAt{v3.08}{\Package{scrlfile}} classes or packages, that have
-been made for companies or institutes, often load a lot of packages not needed
-by the classes or packages itself but only because the users often use
-them. Now, if such a not essential package causes any kind of problem, loading
-of that package has to prevented. For this purpose \Package{scrlfile} again
-provides a solution.
+Classes\ChangedAt{v3.08}{\Package{scrlfile}} and packages written for use
+within companies or academic institutions often load many packages only
+because users need them frequently, not because they are required by the class
+or package itself. If a problem occurs with one of these automatically loaded
+packages, you somehow have to keep the problematic package from being loaded.
+Once again, \Package{scrlfile} provides a simple solution.
\begin{Declaration}
- \Macro{PreventPackageFromLoading}\OParameter{instead code}%
+ \Macro{PreventPackageFromLoading}\OParameter{alternate code}%
\Parameter{package list}%
- \Macro{PreventPackageFromLoading*}\OParameter{instead code}%
+ \Macro{PreventPackageFromLoading*}\OParameter{alternate code}%
\Parameter{package list}
\end{Declaration}
Calling this command\ChangedAt{v3.08}{\Package{scrlfile}} before loading a
-package using \Macro{usepackage}\IndexCmd{usepackage},
+package with \Macro{usepackage}\IndexCmd{usepackage},
\Macro{RequirePackage}\IndexCmd{RequirePackage}, or
-\Macro{RequirePackageWithOptions}\IndexCmd{RequirePackageWithOptions} will
-prevent the package from being loaded effectively if the package is part of
-the \PName{package list}.
+\Macro{RequirePackageWithOptions}\IndexCmd{RequirePackageWithOptions}
+effectively prevents the package from being loaded if it is found in the the
+\PName{package list}.
%
\begin{Example}
- Assumed you're working in a company, that uses font Latin-Modern for all
- kind of documents. Because of this the company class, \Class{compycls}
- contains the lines:
+ Suppose you work at a company where all documents are created using Latin
+ Modern. The company class, \Class{compycls}, therefore contains these lines:
\begin{lstcode}
\RequirePackage[T1]{fontenc}
\RequirePackage{lmodern}
\end{lstcode}
- But now, you want to use
- X\kern-.125em\lower.5ex\hbox{\reflectbox{E}}\LaTeX{} oder Lua\LaTeX{} the
- first time. In this case loading of \Package{fontenc} would not be a good
- suggestion and Latin-Modern would be the default font of the recommended
- package \Package{fontspec}. Because of this you want to prevent both
- packages from being loaded. This may be done, loading the class like this:
+ But now, for the first time, you want to use \XeLaTeX{} or Lua\LaTeX{}.
+ Since the recommended \Package{fontspec} package uses Latin Modern as the
+ default font anyway, and loading \Package{fontenc} would not be a good idea,
+ you want to prevent both packages from being loaded. Therefore, you load the
+ class in your own document as follows:
\begin{lstcode}
\RequirePackage{scrlfile}
\PreventPackageFromLoading{fontenc,lmodern}
\documentclass{firmenci}
\end{lstcode}
\end{Example}
-The example above also shows, that package \Package{scrlfile} may be loaded
-before the class. In this case \Macro{RequirePackage}\IndexCmd{RequirePackage}
-has to be used, because \Macro{usepackage} before \Macro{documentclass} is not
-permitted.
-
-If \PName{package list} is empty or contains a package, that already has been
-loaded, \Macro{PreventPackageFromLoading} will warn. If you'd prefer an
-info\ChangedAt{v3.12}{\Package{scrlfile}} at the log-file only, you may use
-\Macro{PreventPackageFromLoading*} instead.
-
-The optional argument\ChangedAt{v3.12}{\Package{scrlfile}} may be used to
-execute code instead of loading the package. But you must not load another
-packages or files inside \PName{instead code}. See
+The example above also shows that you can load \Package{scrlfile} before the
+class. In this case, you must use
+\Macro{RequirePackage}\IndexCmd{RequirePackage} because \Macro{usepackage}
+before \Macro{documentclass} is not permitted.
+
+If you specify an empty \PName{package list} or if it contains a package that
+has already been loaded, \Macro{PreventPackageFromLoading} issues a warning,
+while\ChangedAt{v3.12}{\Package{scrlfile}} \Macro{PreventPackageFromLoading*}
+merely writes a note to the log file only.
+
+You\ChangedAt{v3.12}{\Package{scrlfile}} can use the optional argument to
+execute code instead of loading the package. But you cannot load any other
+packages or files inside \PName{alternate code}. To load another package, see
\DescRef{\LabelBase.cmd.ReplacePackage} in \autoref{sec:scrlfile.macros} on
-\DescPageRef{\LabelBase.cmd.ReplacePackage} for information about replacing a
-package by another one. Note also, that the \PName{instead code} will be
-executed several times, if you try to load the package more than once!%
+\DescPageRef{\LabelBase.cmd.ReplacePackage}. Note also that the
+\PName{alternate code} will be executed several times if you try to load the
+package more than once!%
\EndIndexGroup
@@ -638,23 +630,23 @@ executed several times, if you try to load the package more than once!%
\Macro{ResetPreventPackageFromLoading}
\end{Declaration}
\Macro{StorePreventPackageFromLoad}\ChangedAt{v3.08}{\Package{scrlfile}}
-defines \Macro{command} to be the current list of packages, that should be
-prevented from being loaded. In opposite to this,
+defines \Macro{command} to be the current list of packages that should not be
+loaded. In contrast,
\Macro{ResetPreventPackageFromLoading}\ChangedAt{v3.08}{\Package{scrlfile}}
-resets the list of packages, that should be prevented from being loaded. After
-\Macro{ResetPreventPackageFromLoading} all packages may be loaded again.
+resets the list of packages that should not be loaded. After
+\Macro{ResetPreventPackageFromLoading}, you can load all packages again.
\begin{Example}
- Assumed, you really need a package inside your own package and you want the
- user inhibit to prevent loading of that package with
+ Suppose you need to load a package inside another package and you do not
+ want the user to be able to prevent that package from being loaded with
\DescRef{\LabelBase.cmd.PreventPackageFromLoading}%
- \IndexCmd{PreventPackageFromLoading}. Because of this, you reset the package
- preventing list before loading the package:
+ \IndexCmd{PreventPackageFromLoading}. So you reset the do-not-load list
+ before you load this package:
\begin{lstcode}
\ResetPreventPackageFromLoading
\RequirePackage{foo}
\end{lstcode}
- Unfortunately the complete prevention list of the user would be lost after
- that. To avoid this, you first store the list and restore it at the end:
+ Unfortunately, from this point on the user's entire do-not-load list would
+ be lost. To avoid this, you first store the list and then restore it later:
\begin{lstcode}
\newcommand*{\Users@PreventList}{}%
\StorePreventPackageFromLoading\Users@PreventList
@@ -662,23 +654,22 @@ resets the list of packages, that should be prevented from being loaded. After
\RequirePackage{foo}
\PreventPackageFromLoading{\Users@PreventList}
\end{lstcode}
- Please\textnote{Attention!} note, that
- \Macro{StorePreventPackageFromLoading} would define
- \Macro{Users@PreventList} even if it already has been defined before. In other
- words: \Macro{StorePreventPackageFromLoading} overwrites existing
- \Macro{command} definitions without care. Because of this,
- \Macro{newcommand*} has been used in the example to get an error message, if
+ Note\textnote{Attention!} that \Macro{StorePreventPackageFromLoading}
+ defines the \Macro{Users@PreventList} macro even if it has already been
+ defined. In other words, calling \Macro{StorePreventPackageFromLoading}
+ overwrites existing \Macro{command} definitions without checking. Therefore
+ this example uses \Macro{newcommand*} to get an error message if
\Macro{Users@PreventList} has already been defined.
\end{Example}
-At this point please note, that everybody who manipulates the list, that has
-been stored using \Macro{StorePreventPackageFromLoading} is responsible for
-the correct restorability. For example the list elements must be separated by
-comma, must not contain white space or group braces, and must be fully
-expandable.
-
-Please note\textnote{Attention!}, that \Macro{ResetPreventPackageFromLoading}
-does not clean the \PName{instead code} of a package. Only the execution is not
-done as long as the prevention is not reactivated.%
+Note that when you manipulate the list stored by
+\Macro{StorePreventPackageFromLoading}, you are responsible for making sure it
+can be restored. For example, the list elements must be separated by comma,
+must not contain white space or group braces, and must be fully expandable.
+
+Also note\textnote{Attention!}, that \Macro{ResetPreventPackageFromLoading}
+does not clear the \PName{alternate code} for a package. But this code
+will not be executed so long as the package is not added again to the
+do-not-load list.%
\EndIndexGroup
@@ -686,35 +677,35 @@ done as long as the prevention is not reactivated.%
\Macro{UnPreventPackageFromLoading}\Parameter{package list}%
\Macro{UnPreventPackageFromLoading*}\Parameter{package list}
\end{Declaration}
-Instead\ChangedAt{v3.12}{\Package{scrlfile}} of resetting the whole list of
-packages, that should prevented from being loaded, you may also remove some
-packages from that list. The star version of the command does also clean the
-\PName{instead code}. So reactivation of the prevent package list, e.\,g.,
-from a stored one, will not reactivate the \PName{instead code} of the
-packages.%
+Instead\ChangedAt{v3.12}{\Package{scrlfile}} of completely resetting the list
+of packages that should not be loaded, you can also specify individual
+packages to remove from the list. The starred version of the command also
+deletes the \PName{alternate code}. For example, restoring packages to the
+do-not-load list from a stored list will not reactivate their \PName{alternate
+code} in this case.%
%
\begin{Example}
- Assuming, you want to prevent a package \Package{foo} from being loaded, but
- you do not want an already stored \PName{instead code} to be
- executed. Instead of that code, you're own \PName{instead code} should be
- executed. You can do this:
+ Suppose you want to prevent a \Package{foo} package from being loaded, but
+ you do not want to execute any outdated \PName{alternate code} that may
+ exist. Instead, only your new \PName{alternate code} should be executed. You
+ can do this as follows:
\begin{lstcode}
\UnPreventPackageFromLoading*{foo}
- \PreventPackageFromLoading[\typeout{Stattdessencode}]{foo}
+ \PreventPackageFromLoading[\typeout{alternate code}]{foo}
\end{lstcode}
- For \Macro{UnPreventPackageFromLoading} it does not matter whether or not
- the package has been prevented from being loaded before.
+ For the \Macro{UnPreventPackageFromLoading} command, it does not matter
+ whether or not the package has been prevented from being loaded before.
- Surely you can use the command also to remove only the \PName{instead code}
- of all packages:
+ Of course you can also use the command to indirectly delete the
+ \PName{alternate code} of all packages:
\begin{lstcode}
\StorePreventPackageFromLoading\TheWholePreventList
\UnPreventPackageFromLoading*{\TheWholePreventList}
\PreventPackageFromLoading{\TheWholePreventList}
\end{lstcode}
- In this case the packages, that has been prevented from being loaded, are
- still prevented from being loaded, but their \PName{instead code} has been
- cleaned and will not be executed any longer.%
+ In this case the packages that have been prevented from being loaded are
+ still prevented from being loaded, but their \PName{alternate code} has been
+ deleted and will no longer be executed.%
\end{Example}%
\EndIndexGroup
%
@@ -729,5 +720,3 @@ packages.%
%%% coding: us-ascii
%%% TeX-master: "../guide"
%%% End:
-
-% LocalWords: restorability
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2-experts.tex
index f27ff563f2c..2e0af8b703d 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2-experts.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2-experts.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlttr2-experts.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlttr2-experts.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,39 +46,43 @@
% ============================================================================
\KOMAProvidesFile{scrlttr2-experts.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-21 10:37:34 +0100 (Wed, 21 Mar 2018) $
KOMA-Script guide (chapter: scrlttr2 for experts)]
\translator{Harald Bongartz\and Georg Grandke\and Raimund Kohl\and Jens-Uwe
- Morawski\and Stephan Hennig\and Gernot Hassenpflug\and Markus Kohm}
+ Morawski\and Stephan Hennig\and Gernot Hassenpflug\and Markus Kohm\and
+ Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-01-02
-\chapter{Additional Information about the Letter Class
- \Class{scrlttr2} and the Letter Package \Package{scrletter}}
+\chapter{Additional Information about the \Class{scrlttr2} Class and the
+ \Package{scrletter} Package}
\labelbase{scrlttr2-experts}
+
\BeginIndexGroup
\BeginIndex{Class}{scrlttr2}
-\BeginIndex{Package}{scrletter}
-
-This chapter gives additional information about the \KOMAScript{} class
-\Class{scrlttr2}. \iffree{Some parts of the chapter are subject to the
- \KOMAScript{} book \cite{book:komascript} only. This should not be a
- problem, because the}{The} average user, who only want to use the package,
-does not need the information. Other information is addressed to users, who
-want additional information about details. For example the first section will
-describe pseudo-lengths in detail. These may be used to modify the note paper.
-Another part of the information describes features of the class that exist
-only because of compatibility to deprecated \Class{scrlettr} class. Last but
-not least it will be described in detail how to change a document from the old
-\Class{scrlettr} class to be used with the current \Class{scrlttr2} class.
-
-Since \KOMAScript~3.15\ChangedAt[2014/11]{v3.15}{\Package{scrletter}} the
-additional package \Package{scrletter} exists. It can
-be used with one of the \KOMAScript{} classes \Class{scrartcl},
-\Class{scrreprt}, or \Class{scrbook} and provides all the features of
-\Class{scrlttr2} for those classes. There are, however, small differences
-described later in this section.%
+This chapter provides additional information about the \KOMAScript{} class
+\Class{scrlttr2}. \iffree{Some parts of the chapter are found only in the
+ German \KOMAScript{} book \cite{book:komascript}. This should not be a
+ problem, because the}{The} average user, who only wants to use the class
+or package, will not normally need this information. Part of this information
+is addressed to users for whom the default options are insufficient. Thus,
+for example, the first section describes in detail the pseudo-lengths that
+specify the letterhead page and which can be used be used to modify the its
+layout.%
+\iffalse% Es wird Zeit das komplett rauszuwerfen!
+ In addition, this chapter also describes features that exist only to
+ provide compatibility with the deprecated \Class{scrlettr} class. It also
+ explains in detail how to convert a document from this obsolete class
+ to the current class.
+\fi
+
+\BeginIndex{Package}{scrletter}%
+Starting with \KOMAScript~3.15\ChangedAt[2014/11]{v3.15}{\Package{scrletter}},
+you can use the \Package{scrletter} package with one of the \KOMAScript{}
+classes \Class{scrartcl}, \Class{scrreprt}, or \Class{scrbook}. It provides
+nearly all the features of \Class{scrlttr2} for those classes. There are,
+however, a few differences described later in this chapter.%
\section{Pseudo-Lengths for Experienced Users}
@@ -86,269 +90,285 @@ described later in this section.%
\BeginIndexGroup
\BeginIndex{}{pseudo-lengths}
-{\TeX} works with a fixed number of registers. There are registers for tokens,
-for boxes, for counters, for skips and for dimensions. Overall there are 256
-registers for each of these categories. For {\LaTeX} lengths, which are
-addressed with \Macro{newlength}, skip registers are used. Once all these
-registers are in use, you can not define any more additional lengths. The
-letter class \Class{scrlttr2} would normally use up more than 20 of such
-registers for the first page alone. {\LaTeX} itself already uses 40 of these
-registers. The \Package{typearea} package needs some of them too; thus,
-approximately a quarter of the precious registers would already be in
-use. That is the reason why lengths specific to letters in \Class{scrlttr2}
-are internally defined with macros instead of lengths. The drawback of this
-approach is that computations with macros is somewhat more complicated than
-with real lengths.
-
-Please note\textnote{Attention!}: Even though these pseudo-lengths are
-internally implemented as macros, the commands for pseudo-length management
-expect only the names of the pseudo-lengths not the macros representing the
-pseudo-lengths. The names of pseudo-lengths are without backslash at the very
-beginning similar to the names of \LaTeX{} counters and in opposite to macros
-or \LaTeX{} lengths.
-
-It can be pointed out that the now recommended {\LaTeX} installation with
-{\eTeX} no longer suffers from the above-mentioned limitation. However, that
-improvement came too late for \Class{scrlttr2}.
-
-The pseudo-lengths defined and uses by \Class{scrlttr2} are listed in
-\autoref{tab:scrlttr2-experts.pseudoLength}. Cross references to the detailed
-descriptions of each pseudo-lengths in the following sub-sections are also
-given in the table.
-
-A schematic display of the most important distances of the note paper is shown
-in \autoref{fig:scrlttr2-experts.pseudoLength} at
-\autopageref{fig:scrlttr2-experts.pseudoLength}. Beside the
-pseudo-lengths for the modifiable distances, also some lengths, which may not
-be modified, are shown in light gray. Some rarely needed pseudo-length of the
-note paper have been omitted to get a more clear arrangement.
+\TeX{} works with a fixed number of registers. There are registers for tokens,
+for boxes, for counters, for skips, and for dimensions. Overall there are 256
+registers for each of these categories. For \LaTeX{} lengths, which are
+defined with \Macro{newlength}, skip registers are used. Once all these
+registers are in use, you can not define any more lengths. Both
+\Class{scrlttr2} and \Package{scrletter} would normally use more than 20 of
+these registers for the first page alone. \LaTeX{} itself already uses 40 of
+these registers. The \hyperref[cha:typearea]{\Package{typearea}}%
+\IndexPackage{typearea} package needs some of them too; thus, approximately a
+quarter of these precious registers would already be in use. For this reason,
+\KOMAScript{} stores letter-specific lengths in macros instead of lengths. The
+drawback of this approach is that computations with macros are somewhat more
+complicated than with real lengths.
+
+Note\textnote{Attention!} that even though these pseudo-lengths are internally
+implemented as macros, the commands for pseudo-length management expect only
+the names of the pseudo-lengths not the macros representing the
+pseudo-lengths. The names of pseudo-lengths are written without the initial
+backslash, like the names of \LaTeX{} counters and unlike macros or \LaTeX{}
+lengths.
+
+Anyone who wants to argue that the recommended \LaTeX{} installation with
+\eTeX{}, which is required for \KOMAScript{} anyway, no longer suffers from
+the above-mentioned limitation would be right. However, that improvement came
+too late for \Class{scrlttr2}. With \Package{scrletter}, the concept of
+psuedo-lengths was adopted for reasons of compatibility.
+
+The pseudo-lengths defined and uses by \KOMAScript{} are listed in
+\autoref{tab:scrlttr2-experts.pseudoLength}, which also provides cross
+references to the detailed descriptions of each pseudo-lengths in the
+following sub-sections.
+
+A schematic display of the most important distances of the letterhead page is
+shown in \autoref{fig:scrlttr2-experts.pseudoLength} on
+\autopageref{fig:scrlttr2-experts.pseudoLength}. In addition to the
+pseudo-lengths for the configurable distances, some non-configurable lengths
+are also shown in light gray. For the sake of clarity, however, some rarely
+required pseudo-lengths have been omitted.
%
\begin{desclist}
\renewcommand{\abovecaptionskipcorrection}{-\normalbaselineskip}%
\desccaption{%
- Pseudo-lengths provided by class \Class{scrlttr2}%
+ Pseudo-lengths provided by \Class{scrlttr2} and \Package{scrletter}%
\label{tab:scrlttr2-experts.pseudoLength}%
}{%
- Pseudo-lengths provided by class \Class{scrlttr2} (\emph{continued})%
+ Pseudo-lengths provided by \Class{scrlttr2} and \Package{scrletter}
+ (\emph{continued})%
}%
\pentry{backaddrheight}{%
- height of the return address at the upper edge of the address field %
+ the height of the return address at the upper edge of the address field
(\autoref{sec:scrlttr2-experts.addressee},
\DescPageRef{scrlttr2-experts.plength.backaddrheight})%
}%
\pentry{bfoldmarklength}{%
- length of the bottommost folding mark %
+ the length of the bottommost fold mark
(\autoref{sec:scrlttr2-experts.foldmarks},
\DescPageRef{scrlttr2-experts.plength.bfoldmarkvpos})%
}%
\pentry{bfoldmarkvpos}{%
- vertical distance of bottommost folding mark from top paper edge %
- (\autoref{sec:scrlttr2-experts.foldmarks},
+ the vertical distance of the bottommost fold mark from the top edge of the
+ paper (\autoref{sec:scrlttr2-experts.foldmarks},
\DescPageRef{scrlttr2-experts.plength.bfoldmarkvpos})%
}%
\pentry{firstfoothpos}{%
- horizontal distance of the letter footer from the left paper edge; values
- greater than the width of the paper or smaller than the negative value of
- the width of the paper will activate special handling %
+ the horizontal distance of the letterhead page footer from the left edge
+ of the paper; values greater than the width of the paper or less than the
+ negative value of the width of the paper activate special handling %
(\autoref{sec:scrlttr2-experts.firstFoot},
\DescPageRef{scrlttr2-experts.plength.firstfoothpos})%
}%
\pentry{firstfootvpos}{%
- vertical distance of letter footer from top paper edge %
- (\autoref{sec:scrlttr2-experts.firstFoot},
+ the vertical distance of letterhead page footer from the top edge of the
+ paper (\autoref{sec:scrlttr2-experts.firstFoot},
\DescPageRef{scrlttr2-experts.plength.firstfootvpos})%
}%
\pentry{firstfootwidth}{%
- width of letter footer %
+ the width of the letterhead page footer
(\autoref{sec:scrlttr2-experts.firstFoot},
\DescPageRef{scrlttr2-experts.plength.firstfootwidth})%
}%
\pentry{firstheadhpos}{%
- horizontal distance of the letterhead from the left paper edge; values
- greater than the width of the paper or smaller than the negative value of
- the width of the paper will activate special handling %
+ the horizontal distance of the letterhead from the left edge of the paper;
+ values greater than the width of the paper or less than the negative value
+ of the width of the paper activate special handling
(\autoref{sec:scrlttr2-experts.firstHead},
\DescPageRef{scrlttr2-experts.plength.firstheadhpos})%
}%
\pentry{firstheadvpos}{%
- vertical distance of letterhead from top paper edge %
+ the vertical distance of the letterhead from the top edge of the paper
(\autoref{sec:scrlttr2-experts.firstHead},
\DescPageRef{scrlttr2-experts.plength.firstheadvpos})%
}%
\pentry{firstheadwidth}{%
- width of the letterhead %
- (\autoref{sec:scrlttr2-experts.firstHead},
+ the width of the letterhead (\autoref{sec:scrlttr2-experts.firstHead},
\DescPageRef{scrlttr2-experts.plength.firstheadwidth})%
}%
\pentry{foldmarkhpos}{%
- horizontal distance of the horizontal folding marks from left paper edge %
- (\autoref{sec:scrlttr2-experts.foldmarks},
+ the horizontal distance of the horizontal fold marks from the left edge of
+ the paper (\autoref{sec:scrlttr2-experts.foldmarks},
\DescPageRef{scrlttr2-experts.plength.foldmarkhpos})%
}%
\pentry{foldmarkvpos}{%
- vertical distance of the vertical folding marks from the top paper edge %
- (\autoref{sec:scrlttr2-experts.foldmarks},
+ the vertical distance of the vertical fold marks from the top edge of the
+ paper (\autoref{sec:scrlttr2-experts.foldmarks},
\DescPageRef{scrlttr2-experts.plength.foldmarkvpos})%
}%
\pentry{fromrulethickness}{%
- thickness of an optional horizontal rule in the letterhead %
+ the thickness of an optional horizontal rule in the letterhead
(\autoref{sec:scrlttr2-experts.firstHead},
\DescPageRef{scrlttr2-experts.plength.fromrulethickness})%
}%
\pentry{fromrulewidth}{%
- length of an optional horizontal rule in letterhead %
+ the length of an optional horizontal rule in the letterhead
(\autoref{sec:scrlttr2-experts.firstHead},
\DescPageRef{scrlttr2-experts.plength.fromrulewidth})%
}%
\pentry{lfoldmarkhpos}{%
- horizontal distance of the vertical folding mark from the left paper edge %
- (\autoref{sec:scrlttr2-experts.foldmarks},
+ the horizontal distance of the vertical fold mark from the left edge of
+ the paper (\autoref{sec:scrlttr2-experts.foldmarks},
\DescPageRef{scrlttr2-experts.plength.lfoldmarkhpos})%
}%
\pentry{lfoldmarklength}{%
- length of the vertical folding mark %
+ the length of the vertical fold mark
(\autoref{sec:scrlttr2-experts.foldmarks},
\DescPageRef{scrlttr2-experts.plength.lfoldmarklength})%
}%
\pentry{locheight}{%
- height of the field with the extended sender's information, of the value
- is not zero; \PLength{toaddrheight} will be used instead of zero value %
+ the height of the field containing the additional sender information if
+ the value is not 0; if it is 0, \PLength{toaddrheight} is used instead
(\autoref{sec:scrlttr2-experts.locationField},
\DescPageRef{scrlttr2-experts.plength.locheight})%
}%
\pentry{lochpos}{%
- horizontal distance of the field with the extended sender's information
- from the right paper edge, if the value is positive; negative horizontal
- distance from the left paper edge, if the value is negative; negative
- value of \PLength{toaddrhpos} will be used instead of zero value %
+ the horizontal distance of the field containing the additional sender
+ information; if the value is positive, the distance is measured from the
+ right paper edge; if negative, from the left paper edge; if 0, the
+ negative value of \PLength{toaddrhpos} is used instead
(\autoref{sec:scrlttr2-experts.locationField},
\DescPageRef{scrlttr2-experts.plength.lochpos})%
}%
\pentry{locvpos}{%
- vertical distance of the field with the extended sender's information from
- the top paper edge, if the value is not zero; \PLength{toaddrvpos} will be
- used instead of zero value %
+ the vertical distance of the field containing the additional sender
+ information from the top edge of the paper if the value is not 0; if it is
+ 0, \PLength{toaddrvpos} is used instead
(\autoref{sec:scrlttr2-experts.locationField},
\DescPageRef{scrlttr2-experts.plength.locvpos})%
}%
\pentry{locwidth}{%
- width of the field with the extended sender's information; for zero value
- width is calculated automatically with respect to option \DescRef{scrlttr2.option.locfield}
- that is described in \autoref{sec:scrlttr2.firstpage},
- \DescPageRef{scrlttr2.option.locfield} %
+ the width of the field containing the additional sender information; if it
+ is 0, the width is calculated automatically based on the
+ \DescRef{scrlttr2.option.locfield} option described in
+ \autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.locfield} %
(\autoref{sec:scrlttr2-experts.locationField},
\DescPageRef{scrlttr2-experts.plength.locwidth})%
}%
\pentry{mfoldmarklength}{%
- length of the middle horizontal folding mark %
+ the length of the middle horizontal fold mark
(\autoref{sec:scrlttr2-experts.foldmarks},
\DescPageRef{scrlttr2-experts.plength.mfoldmarklength})%
}%
\pentry{mfoldmarkvpos}{%
- vertical distance of the middle horizontal folding mark from the top paper
- edge %
- (\autoref{sec:scrlttr2-experts.foldmarks},
+ the vertical distance of the middle horizontal fold mark from the top edge
+ of the paper (\autoref{sec:scrlttr2-experts.foldmarks},
\DescPageRef{scrlttr2-experts.plength.mfoldmarkvpos})%
}%
\pentry{pfoldmarklength}{%
- length of the puncher hole mark %
+ the length of the hole-punch mark
(\autoref{sec:scrlttr2-experts.foldmarks},
\DescPageRef{scrlttr2-experts.plength.pfoldmarklength})%
}%
+ \pentry{PPdatamatrixvskip}{%
+ the vertical distance between the postpaid header and the data array with
+ \OptionValueRef{scrlttr2}{addrfield}{PP}
+ (\autoref{sec:scrlttr2-experts.addressee},
+ \DescPageRef{scrlttr2-experts.plength.PPdatamatrixvskip})%
+ }%
+ \pentry{PPheadheight}{%
+ the height of the postpaid header
+ (\autoref{sec:scrlttr2-experts.addressee},
+ \DescPageRef{scrlttr2-experts.plength.PPheadheight})%
+ }%
+ \pentry{PPheadwidth}{%
+ the width of the left postpaid field with
+ \OptionValueRef{scrlttr2}{addrfield}{PP}
+ (\autoref{sec:scrlttr2-experts.addressee},
+ \DescPageRef{scrlttr2-experts.plength.PPheadwidth})%
+ }%
\pentry{refaftervskip}{%
- vertical skip below reference fields or business line %
+ vertical skip below reference-field line %
(\autoref{sec:scrlttr2-experts.refLine},
\DescPageRef{scrlttr2-experts.plength.refaftervskip})%
}%
\pentry{refhpos}{%
- horizontal distance of reference fields or business line from left paper
- edge; for zero value reference fields line is centered horizontally on
- letter paper %
+ the horizontal distance of reference-field line from the left
+ edge of the paper; if the value is 0, the reference-field line is centred
+ horizontally on the letterhead page
(\autoref{sec:scrlttr2-experts.refLine},
\DescPageRef{scrlttr2-experts.plength.refhpos})%
}%
\pentry{refvpos}{%
- vertical distance of reference fields or business line from top paper
- edge %
- (\autoref{sec:scrlttr2-experts.refLine},
+ the vertical distance of reference-field line from the top
+ edge of the paper (\autoref{sec:scrlttr2-experts.refLine},
\DescPageRef{scrlttr2-experts.plength.refvpos})%
}%
\pentry{refwidth}{%
- width of reference fields line %
+ the width of the reference-field line
(\autoref{sec:scrlttr2-experts.refLine},
\DescPageRef{scrlttr2-experts.plength.refwidth})%
}%
\pentry{sigbeforevskip}{%
- vertical skip between closing and signature %
+ the vertical skip between the closing and the signature
(\autoref{sec:scrlttr2-experts.closing},
\DescPageRef{scrlttr2-experts.plength.sigbeforevskip})%
}%
\pentry{sigindent}{%
- indentation of signature with respect to text body %
+ the indentation of the signature with respect to the text body
(\autoref{sec:scrlttr2-experts.closing},
\DescPageRef{scrlttr2-experts.plength.sigindent})%
}%
\pentry{specialmailindent}{%
- left indentation of mode of dispatch within address field %
+ the left indentation of the delivery method within the address field
(\autoref{sec:scrlttr2-experts.addressee},
\DescPageRef{scrlttr2-experts.plength.specialmailindent})%
}%
\pentry{specialmailrightindent}{%
- right indentation of mode of dispatch within address field %
+ the right indentation of the delivery method within the address field
(\autoref{sec:scrlttr2-experts.addressee},
\DescPageRef{scrlttr2-experts.plength.specialmailrightindent})%
}%
\pentry{subjectaftervskip}{%
- vertical distance after the subject %
+ the vertical skip after the subject
(\autoref{sec:scrlttr2-experts.subject},
\DescPageRef{scrlttr2-experts.plength.subjectaftervskip})%
}%
\pentry{subjectbeforevskip}{%
- additional vertical distance before the subject %
+ additional vertical skip before the subject
(\autoref{sec:scrlttr2-experts.subject},
\DescPageRef{scrlttr2-experts.plength.subjectbeforevskip})%
}%
\pentry{subjectvpos}{%
- vertical distance of the subject from the top paper edge; zero value will
- set the subject depending on option \DescRef{scrlttr2.option.subject} %
+ the vertical distance of the subject from the top edge of the paper; if it
+ is 0, the position is calculated based on the
+ \DescRef{scrlttr2.option.subject} option
(\autoref{sec:scrlttr2-experts.subject},
\DescPageRef{scrlttr2-experts.plength.subjectaftervskip})%
}%
\pentry{tfoldmarklength}{%
- length of the topmost horizontal folding mark %
+ the length of the topmost horizontal fold mark
(\autoref{sec:scrlttr2-experts.foldmarks},
\DescPageRef{scrlttr2-experts.plength.tfoldmarklength})%
}%
\pentry{tfoldmarkvpos}{%
- vertical distance of the topmost horizontal folding mark from the top
- paper edge %
- (\autoref{sec:scrlttr2-experts.foldmarks},
+ the vertical distance of the topmost horizontal folding mark from the top
+ edge of the paper (\autoref{sec:scrlttr2-experts.foldmarks},
\DescPageRef{scrlttr2-experts.plength.tfoldmarkvpos})%
}%
\pentry{toaddrheight}{%
- height of address field %
- (\autoref{sec:scrlttr2-experts.addressee},
+ the height of the address field (\autoref{sec:scrlttr2-experts.addressee},
\DescPageRef{scrlttr2-experts.plength.toaddrheight})%
}%
\pentry{toaddrhpos}{%
- horizontal distance of the address field from left paper edge, for
- positive values; negative horizontal distance of the address field from
- right paper edge, for negative values %
+ the horizontal distance of the address field from left edge of the paper,
+ if the value is positive; if it is negative, the negative horizontal
+ distance of the address field from the right edge of the paper
(\autoref{sec:scrlttr2-experts.addressee},
\DescPageRef{scrlttr2-experts.plength.toaddrhpos})%
}%
\pentry{toaddrindent}{%
- left and right indentation of address within address field %
+ the left and right indentation of the address within the address field
(\autoref{sec:scrlttr2-experts.addressee},
\DescPageRef{scrlttr2-experts.plength.toaddrindent})%
}%
\pentry{toaddrvpos}{%
- vertical distance of the address field from the top paper edge %
- (\autoref{sec:scrlttr2-experts.addressee},
+ the vertical distance of the address field from the the top edge of the
+ paper (\autoref{sec:scrlttr2-experts.addressee},
\DescPageRef{scrlttr2-experts.plength.toaddrvpos})%
}%
\pentry{toaddrwidth}{%
- width of address field %
+ the width of the address field %
(\autoref{sec:scrlttr2-experts.addressee},
\DescPageRef{scrlttr2-experts.plength.toaddrwidth})%
}%
@@ -365,22 +385,26 @@ note paper have been omitted to get a more clear arrangement.
\begin{Declaration}
\Macro{@newplength}\Parameter{name}
\end{Declaration}
-This command defines an new pseudo-length. This new pseudo-length is
-uniquely identified by its \PName{name}. If with this command a
-redefinition of an already existing pseudo-length is attempted, the
+This command defines a new pseudo-length. The new pseudo-length is
+uniquely identified by its \PName{name}. Each name can therefore be
+assigned only once. If you attempt to redefine an existing pseudo-length, the
commands exits with an error message.
-Since the user in general does not define own pseudo-lengths, this command is
-not intended as a user command. Thus, it can not be used within a document,
-but it can, for example, be used within an
-\File{lco}-file\Index{lco-file=\File{lco}-file}.\iffree{}{ Nevertheless, if
- someone likes to define a pseudo-length inside the document, i.\,e. the
- document preamble, then one may avoid that constriction using
+Since the ordinary user does not normally need to define pseudo-lengths, this
+command is not a user instruction. It cannot be used within a document, but it
+can, for example, be used within an \File{lco}
+file\Index{lco file=\File{lco} file}.
+%
+\iftrue % Umbruchoptimierung!!!
+\iffree{}{ If you want to
+ define a pseudo-length inside the document anyway, you can override the
+ restriction with the help of
\Macro{makeatletter}\important[i]{\Macro{makeatletter}\\
\Macro{makeatother}}\IndexCmd{makeatletter} and
\Macro{makeatother}\IndexCmd{makeatother} (see
- \cite{UK:FAQ}). But\textnote{Attention!} inside an \File{lco}-file these two
- commands should never be used!}%
+ \cite{UK:FAQ}). But\textnote{Attention!} you should never use these two
+ commands inside an \File{lco} file!}%
+\fi
%
\EndIndexGroup
@@ -391,90 +415,91 @@ but it can, for example, be used within an
\Macro{@addtoplength}%
\OParameter{factor}\Parameter{pseudo-length}\Parameter{value}
\end{Declaration}
-Using the command \Macro{@setplength} you can assign the multiple of a
+Using \Macro{@setplength}, you can assign the multiple of a
\PName{value} to a \PName{pseudo-length}. The \PName{factor} is given as an
optional argument (see also \DescRef{scrlttr2.cmd.setlengthtoplength},
\autoref{sec:scrlttr2.pseudoLength},
\DescPageRef{scrlttr2.cmd.setlengthtoplength}).
-The command \Macro{@addtoplength} adds the \PName{value} to a
-\PName{pseudo-length}. Again a \PName{factor} may be given as an optional
+With \Macro{@addtoplength} you can add the multiple of a \PName{value} to a
+\PName{pseudo-length}. Again, you can pass a \PName{factor} as an optional
argument.
-To assign, or to add the multiple of, one \PName{pseudo-length} to another
-pseudo-length, the command \Macro{useplength} (siehe
-\autoref{sec:scrlttr2.pseudoLength},
-\DescPageRef{scrlttr2.cmd.useplength}) is used within \PName{value}. To
-subtract the value of one pseudo-length from another \PName{pseudo-length} a
-minus sign, or \PValue{-1}, is used as the \PName{factor}.
-
-Since the user in general does not define own pseudo-lengths, this command is
-not intended as a user command. Thus, it can not be used within a document,
-but can, for example, be used within an \File{lco}-file.\iffree{}{
- Nevertheless, if someone likes to change the value of a pseudo-length inside
- the document, i.\,e. the document preamble, then one may avoid that
- constriction using
+To assign or to add the multiple of one \PName{pseudo-length} to another
+pseudo-length, use the \Macro{useplength} command (see
+\autoref{sec:scrlttr2.pseudoLength}, \DescPageRef{scrlttr2.cmd.useplength})
+within the \PName{value}. To subtract the value of one \PName{pseudo-length}
+from another \PName{pseudo-length}, you use should use at the same time a
+minus sign or \PValue{-1} as the \PName{factor}.
+
+Since the ordinary user does not normally need to define pseudo-lengths, this
+command is not a user instruction. It cannot be used within a document, but it
+can, for example, be used within an \File{lco}
+file\Index{lco file=\File{lco} file}.\iffree{}{ If you want to
+ define a pseudo-length inside the document anyway, you can override the
+ restriction with the help of
\Macro{makeatletter}\important[i]{\Macro{makeatletter}\\
\Macro{makeatother}}\IndexCmd{makeatletter} and
\Macro{makeatother}\IndexCmd{makeatother} (see
- \cite{UK:FAQ}). But\textnote{Attention!} inside an \File{lco}-file these two
- commands should never be used!}%
+ \cite{UK:FAQ}). But\textnote{Attention!} you should never use these two
+ commands inside an \File{lco} file!}%
%
\EndIndexGroup
-\subsection{Folding Marks}
+\subsection{Fold Marks}
\seclabel{foldmarks}
\BeginIndexGroup
-\index{marks>folding|see{folding marks}}
-\BeginIndex{}{folding marks}%
+\BeginIndex{}{fold marks}%
+\index{marks>folding|see{fold marks}}
-Folding mark are short horizontal lines at the left edge, and short vertical
-lines at the upper edge of the paper. \KOMAScript{} at present supports three
-configurable horizontal and one configurable vertical foldmarks. In addition,
-there is support for a puncher hole mark or center mark which cannot be
-shifted in the vertical direction.
+Fold marks, or folding marks, are short horizontal lines at the left edge, and
+short vertical lines at the upper edge of the paper. \KOMAScript{} currently
+supports three configurable horizontal and one configurable vertical fold
+marks. In addition, there is support for a hole-punch mark, or centre mark,
+which cannot be shifted vertically.
\begin{Declaration}
\PLength{tfoldmarkvpos}%
\PLength{mfoldmarkvpos}%
\PLength{bfoldmarkvpos}
\end{Declaration}
-The letter class \Class{scrlttr2} knows a total of three vertically placed
-configurable foldmarks. The position of the topmost foldmark, taken from the
-upper edge of the paper, is governed by the pseudo-length
-\PLength{tfoldmarkvpos}; the position of the middle foldmark by pseudo-length
-\PLength{mfoldmarkvpos}\ChangedAt{v2.97e}{\Class{scrlttr2}}; the position of
-the bottommost foldmark by pseudo-length \PLength{bfoldmarkvpos}. With the
-addition of the puncher hole\Index{puncher hole mark} or center\Index{center
- mark|see{punch hole mark}} mark, there is still a fourth horizontal
-mark. This one is however always placed at the vertical center of the paper.
-\iffalse% Umbruchkorrekturtext
-There's no pseudo-length for this last mark, because it vertical position is
-not configurable. \fi
-
-The\textnote{Attention!} topmost and bottommost foldmarks do not serve to
-divide the paper into exactly equal thirds. Instead, with their help, the
-paper should be folded such that the address field appears correctly in the
-space available in the chosen window envelope format, which is determined by
-choice of \File{lco}-file. Several such files are available offering
-predefined formats. An anomaly is present with \Option{DINmtext}: for this
-format, an envelope format of C6/5 (also known as ``C6 long'') is
-assumed. Letters written with this option are not suited to envelopes of
-formats C5 or C4.
-
-The middle foldmark is not normally required for Western letters. In Japan,
-however, a larger number of envelope formats exists, requiring one more
-foldmark (see the Japanese \File{lco}-files). At this point attention is drawn
-to the fact that reference to ``topmost'', ``middle'', and ``bottommost''
-foldmarks is simply a convenience. In fact, it is not defined that
-\PLength{tfoldmarkvpos} must be smaller than \PLength{mfoldmarkvpos}, which in
-turn must be smaller than \PLength{bfoldmarkvpos}. If on the other hand one of
-the pseudo-lengths is set to null, then the corresponding foldmark will not be
-set even if the option
-\DescRef{scrlttr2.option.foldmarks}\IndexOption{foldmarks~=\PName{Einstellung}}%
-\important{\DescRef{scrlttr2.option.foldmarks}} (see \autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.foldmarks}) is explicity activated.
+\KOMAScript{} recognises a total of three fold marks whose vertical position
+can be configured. The distance of the top fold mark from the upper edge of
+the paper is determined by the \PLength{tfoldmarkvpos} pseudo-length; the
+distance of the middle fold mark, by the
+\PLength{mfoldmarkvpos}\ChangedAt{v2.97e}{\Class{scrlttr2}} pseudo-length; the
+distance of the bottommost fold mark, by \PLength{bfoldmarkvpos}
+pseudo-length. With the addition of the hole-punch\Index{hole-punch mark} or
+centre\Index{centre mark|see{hole-punch mark}} mark, there is yet a fourth
+horizontal mark. This one is however always placed at the vertical centre of
+the paper.
+\iftrue% Umbruchkorrekturtext
+There is no pseudo-length for this last mark because its vertical position is
+not configurable.
+\fi
+
+The\textnote{Attention!} top and bottom fold marks do not serve to divide the
+paper exactly into equal thirds. Instead, the paper should be folded with
+their help such that the address field can be seen in a window envelope. The
+settings are therefore different depending on the \File{lco} file chosen.
+Several such files are available offering predefined formats. One format
+particularly worth noting is \Option{DINmtext}. This format assumes an
+envelope format of C6/5 (also known as ``C6 long''). Letters written with this
+option are typically not suited for C5 or C4 envelopes.
+
+The middle fold mark is not normally required for Western letters. In Japan,
+however, a larger number of envelope formats exists, requiring one more fold
+mark (see the Japanese \File{lco} files). Note that the terms ``top'',
+``middle'', and ``bottom'' fold marks only represent a naming convention. In
+fact, it is not required that \PLength{tfoldmarkvpos} must be smaller than
+\PLength{mfoldmarkvpos}, which in turn must be smaller than
+\PLength{bfoldmarkvpos}. If, though, one of the pseudo-lengths is zero, then
+the corresponding fold mark will not be set even if the
+\DescRef{scrlttr2.option.foldmarks}\IndexOption{foldmarks~=\PName{setting}}%
+\important{\DescRef{scrlttr2.option.foldmarks}} option (see
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.foldmarks}) is
+explicitly activated.
%
\EndIndexGroup
@@ -486,26 +511,26 @@ set even if the option
\PLength{pfoldmarklength}
\end{Declaration}
These\ChangedAt{v2.97e}{\Class{scrlttr2}} four pseudo-lengths determine the
-lengths of the four horizontal foldmarks. One\textnote{Attention!}
-exceptional behaviour exists. If the length is given as null, then the three
-vertically-configurable pseudo-lengths \PLength{tfoldmarklength},
-\PLength{mfoldmarklength} and \PLength{bfoldmarklength} are set to 2\Unit{mm}
-in length. The length of the punchmark, \PLength{pfoldmarklength}, is instead
-set to 4\Unit{mm}.%
+lengths of the four horizontal fold marks. One\textnote{Attention!} feature is
+particularly worth noting. If the length is given as zero, then the three
+vertically configurable pseudo-lengths \PLength{tfoldmarklength},
+\PLength{mfoldmarklength} and \PLength{bfoldmarklength} are set to 2\Unit{mm}.
+The length of the hole-punch mark, \PLength{pfoldmarklength}, however, is set
+to 4\Unit{mm}.%
\EndIndexGroup
\begin{Declaration}
\PLength{foldmarkhpos}
\end{Declaration}
-This pseudo-length gives the distance of all horizontal foldmarks from the
-left edge of the paper. Normally, this is 3.5\Unit{mm}. This\textnote{Hint!}
-value can be changed in the user's own \File{lco}-file, in case the user's
-printer has a wider unprintable left margin. Whether the foldmarks are typeset
-at all depends on the option \DescRef{scrlttr2.option.foldmarks}\important{\DescRef{scrlttr2.option.foldmarks}}%
-\IndexOption{foldmarks~=\PName{Einstellung}} (see
-\autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.foldmarks}).
+This pseudo-length gives the distance of all horizontal fold marks from the
+left edge of the paper. Normally, this is 3.5\Unit{mm}. You\textnote{Hint!}
+can change this value in your own \File{lco} file if you are using a printer
+that has a wider unprintable left margin. Whether the fold marks are typeset
+at all depends on the option \DescRef{scrlttr2.option.foldmarks}%
+\important{\DescRef{scrlttr2.option.foldmarks}}%
+\IndexOption{foldmarks~=\PName{setting}} (see
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.foldmarks}).
%
\EndIndexGroup
@@ -513,39 +538,38 @@ at all depends on the option \DescRef{scrlttr2.option.foldmarks}\important{\Desc
\begin{Declaration}
\PLength{lfoldmarkhpos}
\end{Declaration}
-Apart from\ChangedAt{v2.97e}{\Class{scrlttr2}} the horizontal foldmarks there
-is also a vertical foldmark, whose position from the left margin is set via
-the pseudo-length \PLength{lfoldmarkhpos}. This foldmark is used, for example,
-in Japanese Chou- or You-format envelopes, when one wishes to use A4 size
-sheets with them. This can also be useful for envelopes in C6 format.%
+In\ChangedAt{v2.97e}{\Class{scrlttr2}} addition to the horizontal fold marks,
+there is also a vertical fold mark. Its distance from the left margin is set
+via the \PLength{lfoldmarkhpos} pseudo-length. This fold mark is used, for
+example, in Japanese Chou- or You-format envelopes if you want to use them
+with A4 paper. It can also be useful for envelopes in C6 format.%
\EndIndexGroup
\begin{Declaration}
\PLength{lfoldmarklength}
\end{Declaration}
-The\ChangedAt{v2.97e}{\Class{scrlttr2}} length of the vertical foldmark is set
-via the pseudo-length \PLength{lfoldmarklength}. Here too there is an
-exceptional behaviour. When the length is set to null, a length of 4\Unit{mm}
-is actually used.%
+The\ChangedAt{v2.97e}{\Class{scrlttr2}} \PLength{lfoldmarklength}
+pseudo-length determines the length of the vertical fold mark. Once again, a
+feature worth noting is that if the length is given as zero, a length of
+4\Unit{mm} is actually used.%
\EndIndexGroup
\begin{Declaration}
\PLength{foldmarkvpos}
\end{Declaration}
-This\ChangedAt{v2.97e}{\Class{scrlttr2}} pseudo-length gives the distance of
-all vertical foldmarks from the upper edge of the paper. Normally this is
-3.5\Unit{mm}, but\textnote{Hint!} the value can be changed in the user's
-personal \File{lco}-file in case the user's printer has a wider unprintable
-top margin. Whether the foldmarks are typeset at all depends on the option
+This\ChangedAt{v2.97e}{\Class{scrlttr2}} pseudo-length determines the distance of
+all vertical fold marks from the upper edge of the paper. Normally this is
+3.5\Unit{mm}, but\textnote{Hint!} you can change the value in your own
+\File{lco} file in case your printer has a wider unprintable
+top margin. Whether or not the foldmarks are actually typeset depends on the
\DescRef{scrlttr2.option.foldmarks}%
\important{\DescRef{scrlttr2.option.foldmarks}}%
-\IndexOption{foldmarks~=\PName{Einstellung}} (see
-\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.foldmarks}). At
-present there is only one vertical foldmark, which is designated the left
-vertical foldmark.
-%
+\IndexOption{foldmarks~=\PName{setting}} option (see
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.foldmarks}).
+\iffree{At present there is only one vertical fold mark, called the left
+ vertical fold mark.}{}%
\EndIndexGroup
@@ -553,9 +577,9 @@ vertical foldmark.
\PLength{foldmarkthickness}
\end{Declaration}
This\ChangedAt{v2.97c}{\Class{scrlttr2}} pseudo-length determines the
-thickness of all foldmarks. Default value is 0.2\Unit{pt}, in other words a
-very thin hairline. In particular, if the color of the foldmarks is
-changed, this can be too thin!%
+thickness of all fold marks. The default is 0.2\Unit{pt}, in other words a
+very thin hairline. In\textnote{Hint!} particular, if the colour of the fold
+marks is changed, this may not be enough.%
\EndIndexGroup
%
\EndIndexGroup
@@ -564,68 +588,67 @@ changed, this can be too thin!%
\subsection{Letterhead}
\seclabel{firstHead}
\BeginIndexGroup
-\BeginIndex{}{letterhead}
-
-The term letterhead here refers to all of the data pertaining to the sender
-and which is set above the addressee's address. It is usually expected that
-this information is set via the page style settings. In fact, this was the
-case in the earlier incarnation of the letter class,
-\Class{scrlettr}. But\textnote{Attention!} with \Class{scrlttr2}, the
-letterhead is made independent of the page style setting, and is set by the
-command \DescRef{scrlttr2.cmd.opening}\IndexCmd{opening}.
+\BeginIndex{}{letterhead}%
+
+The term letterhead refers here to all of the information concerning the
+sender that appears above the recipient's address. Normally you would expect
+that this information would be set through the page-style settings. In fact,
+this was the case with the old letter class, \Class{scrlettr}.
+But\textnote{Attention!} \Class{scrlttr2} and \Package{scrletter} output the
+letterhead independently of the page style by means of the
+\DescRef{scrlttr2.cmd.opening}\IndexCmd{opening} command.
% Fuellmaterial
\iftrue%
-The position of the letterhead is absolute and independent of the type
-area. In fact, the first page of a letter, the page that holds the letterhead,
-is set using the page style \PValue{empty}.%
+ The letterhead is positioned absolutely, so that it is independent of the
+ type area. In fact, the first page of a letter, the page that holds the
+ letterhead, is set using the page style
+ \DescRef{scrlttr2.pagestyle.empty}\IndexPagestyle{empty}.%
\fi
% Ende des Fuellmaterials
+
\begin{Declaration}
\PLength{firstheadvpos}
\end{Declaration}
-The pseudo-length \PLength{firstheadvpos} gives the distance between the top
-edge of the paper and start of the letterhead. This value is set differently
-in the various predefined
-\File{lco}-files\textnote{\File{lco}-file}\Index{lco-file=\File{lco}-file}. A
+The \PLength{firstheadvpos} pseudo-length gives the distance between the top
+edge of the paper and the start of the letterhead. This value is set
+differently in the various predefined
+\File{lco} files\textnote{\File{lco} file}\Index{lco file=\File{lco} file}. A
typical value is 8\Unit{mm}.%
-%
\EndIndexGroup
\begin{Declaration}
\PLength{firstheadhpos}
\end{Declaration}
-A positive value of pseudo-length
-\PLength{firstheadhpos}\ChangedAt{v3.05}{\Class{scrlttr2}} gives the distance
-between the left edge of the paper and the start of the
-letterhead. If\textnote{Attention!} is actually greater than or equal to the
-paper width,
+A positive value of the
+\PLength{firstheadhpos}\ChangedAt{v3.05}{\Class{scrlttr2}} pseudo-length gives
+the distance between the left edge of the paper and the start of the
+letterhead. If\textnote{Attention!} the value is actually greater than or
+equal to the paper width,
\Length{paperwidth}\important{\Length{paperwidth}}\IndexLength{paperwidth},
-then the letterhead will be centered to the note paper width. A negative value
-gives the distance between the distance between the right paper edge and the
-end of the letterhead. If the value is even less or equal to the negative
-value of the width of the paper, then the letterhead will be left aligned to
-the left edge of the typing area.
-
-Typical default\textnote{Attention!} is a value of
-\Length{maxdimen}\IndexLength{maxdimen}, though the greatest allowed value of
-a length. This will result in horizontal centering.%
-%
+the letterhead will be centred horizontally on the letterhead paper. A
+negative value gives the distance between the right edge of the paper and the
+right edge of the letterhead. If the value actually less than or equal to the
+negative value of the width of the paper, the letterhead is placed flush with
+the left edge of the type area.
+
+The default\textnote{Attention!} value is typically
+\Length{maxdimen}\IndexLength{maxdimen}, which is the maximum allowed value of
+a length. This results in horizontal centring.%
\EndIndexGroup
\begin{Declaration}
\PLength{firstheadwidth}
\end{Declaration}
-The pseudo-length \PLength{firstheadwidth} gives the width of the
-letterhead. This value is set differently in the various predefined
-\File{lco}-files\textnote{\File{lco}-file}\Index{lco-file=\File{lco}-file}.
-While this value usually depends on the paper width and the distance between
-the left edge of the paper and the adressee address field, it was the type
-area width in \Option{KOMAold} and has a definite value of 170\Unit{mm} in
+The \PLength{firstheadwidth} pseudo-length gives the width of the letterhead.
+This value is set differently in the various predefined \File{lco}
+files\textnote{\File{lco} file}\Index{lco file=\File{lco} file}. While this
+value usually depends on the paper width and the distance between the left
+edge of the paper and the recipient's address field, it was the width of the
+type area in \Option{KOMAold} and has a fixed value of 170\Unit{mm} in
\Option{NF}.%
-%
\EndIndexGroup
@@ -633,20 +656,19 @@ area width in \Option{KOMAold} and has a definite value of 170\Unit{mm} in
\PLength{fromrulethickness}%
\PLength{fromrulewidth}
\end{Declaration}
-Depending on the class option \Option{fromrule} (see
-\autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.fromrule}), a horizontal rule can be drawn
-the predefined letterheads under or within the sender
-address. If\textnote{Attention!} the pseudo-length \PLength{fromrulewidth} has
-a value of 0\Unit{pt}, which is the default in the predefined \File{lco}
-files, the rule length is calculated automatically taking into account,
-e.\,g., letterhead width or an optional logo. Users can adjust rule length
-manually in their own \File{lco}-files by setting this pseudo-length to
-positive values using \Macro{\@setplength} (see
-\DescPageRef{scrlttr2-experts.cmd.@setplength}). The default thickness of
-the line\ChangedAt{v2.97c}{\Class{scrlttr2}}, \PLength{fromrulethickness}, is
-0.4\Unit{pt}.%
-%
+As mentioned in the explanation of the
+\DescRef{scrlttr2.option.fromrule}\IndexOption{fromrule} option in
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.fromrule}, you
+can put a horizontal rule within or below the sender's address in the
+predefined letterheads. If\textnote{Attention!} the \PLength{fromrulewidth}
+pseudo-length has a value of 0\Unit{pt}, which is the default in the
+predefined \File{lco} files, the length of this rule is calculated
+automatically taking into account, for example, letterhead width or an
+optional logo. You can adjust rule length manually in your own \File{lco}
+files by setting this pseudo-length to positive values using
+\Macro{\@setplength} (see \DescPageRef{scrlttr2-experts.cmd.@setplength}). The
+default thickness of the line\ChangedAt{v2.97c}{\Class{scrlttr2}},
+\PLength{fromrulethickness}, is 0.4\Unit{pt}.%
\EndIndexGroup
%
\EndIndexGroup
@@ -656,63 +678,62 @@ the line\ChangedAt{v2.97c}{\Class{scrlttr2}}, \PLength{fromrulethickness}, is
\seclabel{addressee}%
\BeginIndexGroup
\BeginIndex{}{addressee}
-\index{address|seealso{addressee}}
+\index{recipient|seealso{addressee}}
-The term addressee here refers to the addressee's name and address which
-are output in an address field. Additional information can be output
-within this address field, such as dispatch type or a return address;
-the latter is especially useful when using window envelopes. The
-address directly follows the letterhead.
+The term \emph{addressee} normally refers only to the recipient's name and
+address, which are output in an address field. Additional information,
+however, can be placed within this address field, including the delivery
+method, for example registered mail or special delivery. For window envelopes,
+the return address also counts as part of the address field, as it will be
+displayed in the address window. The address field directly follows the
+letterhead.
\begin{Declaration}
\PLength{toaddrvpos}%
\PLength{toaddrhpos}
\end{Declaration}
-These pseudo-lengths define vertical and horizontal position of the address
-field relative to the top-left corner of the paper. Values are set differently
-in the various predefined
-\File{lco}-files\textnote{\File{lco}-file}\Index{lco-file=\File{lco}-file},
-according to standard envelope window measures. A special feature of
-\PLength{toaddrhpos} is that with negative values the offset is that of the
-right edge of the address field relative to the right edge of the paper. This
-can be found, for instance, in the case of \Option{SN} or \Option{NF}. The
-smallest value of \PLength{toaddrvpos} is found with \Option{DINmtext}. Care
-must be taken to avoid overlap of letterhead and address field. Whether the
-address field is output or not can be controlled by class option
-\Option{addrfield} (see \autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.addrfield}).%
-%
+These pseudo-lengths define the vertical and horizontal distance of the
+address field from the top-left corner of the paper. Values are set
+differently in the various predefined \File{lco} files\textnote{\File{lco}
+file}\Index{lco file=\File{lco} file}, according to standard envelope window
+measures. For \PLength{toaddrhpos}, one property worth noting is that with
+negative values, the offset is the distance from the right edge of the address
+field to the right edge of the paper. You will find this, for instance, in
+\Option{SN} or \Option{NF}. The smallest value of \PLength{toaddrvpos} is
+found with \Option{DINmtext}. With this setting, the letterhead can easily
+protrude into the address window. Whether the address field is output or not
+depends on the \Option{addrfield} option (see
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.addrfield}).%
\EndIndexGroup
\begin{Declaration}
\PLength{toaddrheight}
\end{Declaration}
-The pseudo-length \PLength{toaddrheight} defines the height of the
-address field, including the dispatch type. If no dispatch type is
-specified, then the address is vertically centered in the field. If a
-dispatch type is specified, then the address is set below the dispatch
-type, and vertically centered in the remaining field height.
-%
+This pseudo-length defines the height of the address field, including the
+delivery method. Whether the name and address of the recipient are vertically
+centred in the address field, taking into account the presence or absence of
+the delivery method, depends on the \DescRef{scrlttr2.option.addrfield}
+option.%
\EndIndexGroup
\begin{Declaration}
\PLength{toaddrwidth}
\end{Declaration}
-This pseudo-length defines the width of the address field. Values are set
-differently in the various predefined
-\File{lco}-files\textnote{\File{lco}-files}\Index{lco-file=\File{lco}-files},
-according to standard envelope window measures. Typical values are between
-70\Unit{mm} and 100\Unit{mm}.
+This pseudo-length defines the width of the address field. The various
+predefined \File{lco} files\textnote{\File{lco} files}\Index{lco
+file=\File{lco} files} use different settings according to the different
+standards for window envelopes. Typical values are between 70\Unit{mm} and
+100\Unit{mm}.
\begin{Example}
- Assume that your printer has a very wide left or right margin of
- 15\Unit{mm}. In this case, when using the option \Option{SN}, the
- letterhead, sender's extensions and the address can not be completely
- printed. Thus, you create a new \File{lco}-file with the following content:
+ Suppose your printer has very wide, non-printable left and right margins of 15\Unit{mm}.
+ This means that the letterhead, the additional sender information, and the address field cannot
+ be completely printed if you use the \Option{SN} option. You therefore
+ create a new \File{lco} file with the following content:
\begin{lstcode}
\ProvidesFile{SNmmarg.lco}
- [2002/06/04 v0.1 my own lco]
+ [2002/06/04 v0.1 my lco]
\LoadLetterOption{SN}
\@addtoplength{toaddrwidth}{%
-\useplength{toaddrhpos}}
@@ -722,8 +743,8 @@ according to standard envelope window measures. Typical values are between
\endinput
\end{lstcode}
Then, until you can obtain a printer with smaller page margins, you
- simply use the option \Option{SNmmarg} instead of \Option{SN}.
-\end{Example}
+ simply use the option \Option{SNmmarg} instead of \Option{SN}.%
+\end{Example}%
%
\EndIndexGroup
@@ -731,53 +752,48 @@ according to standard envelope window measures. Typical values are between
\begin{Declaration}
\PLength{toaddrindent}
\end{Declaration}
-Additional indentation of the address within address field can be controlled
-by the pseudo-length \PLength{toaddrindent}. Its value applies to both left
-and right margin. Default value is 0\Unit{pt}.
+Sometimes you do not want the address field to extend the full width of the
+address window but to be indented a bit. You can set the amount of this
+indentation with the \PLength{toaddrindent} pseudo-length. Typically, the
+default value is 0\Unit{pt}.
-With\textnote{Attention!} each of the
-settings\ChangedAt{v3.03}{\Class{scrlttr2}}
-\OptionValueRef{scrlttr2}{addrfield}{PP}\important[i]{%
+For\textnote{Attention!} the\ChangedAt{v3.03}{\Class{scrlttr2}}
+\OptionValueRef{scrlttr2}{addrfield}{PP}\important{%
\OptionValueRef{scrlttr2}{addrfield}{PP}\\
\OptionValueRef{scrlttr2}{addrfield}{image}\\
- \begin{tabular}{@{}l@{}}
- \KOption{addrfield}\\
- \quad\PValue{backgroundimage}
- \end{tabular}}\IndexOption{addrfield~=\PValue{PP}},
-\OptionValueRef{scrlttr2}{addrfield}{image}\IndexOption{addrfield~=\PValue{image}}, and
+ \OptionValueRef{scrlttr2}{addrfield}{backgroundimage}
+}\IndexOption{addrfield~=\textKValue{PP}},
+\OptionValueRef{scrlttr2}{addrfield}{image}%
+\IndexOption{addrfield~=\textKValue{image}}, and
\OptionValueRef{scrlttr2}{addrfield}{backgroundimage}%
-\IndexOption{addrfield~=\PValue{backgroundimage}} (see
-\autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.addrfield}) a value of 0\Unit{pt} will be
-replaced by a value of 8\Unit{mm}. If really no indent should be used in this
-case, then 1\Unit{sp} may be used to set a negligible small
-indent. Additionally \PLength{toaddrindent} will be used also for the distance
-to the right edge of the address window with the mentioned \Option{addrfield}
-settings.%
-%
+\IndexOption{addrfield~=\textKValue{backgroundimage}} settings (see
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.addrfield}) a
+value of 0\Unit{pt} will be replaced by a value of 8\Unit{mm}. If you really
+do not want any indentation, you can use a value of 1\Unit{sp} to set a
+negligibly small indentation. Furthermore, \PLength{toaddrindent} is also used
+for the distance to the right edge of the address window with the these
+\Option{addrfield} settings.%
\EndIndexGroup
\begin{Declaration}
\PLength{backaddrheight}
\end{Declaration}
-For window envelopes the sender is often printed with small font at one line
-above the addressee. This kind of sender's information is known as return
+For window envelopes, the sender is often printed in a small font on one line
+above the addressee. This sender information is called the return
address\textnote{return address}\Index{return address}, because it is visible
-at the address window and will be used by the post officers to return the
-letter (back) to the sender. In this return address only that information
-should be that is needed for this purpose.
-
-The height, that is reserved for the return address at the top of the address
-field, is given by pseudo-length \PLength{backaddrheight}. A typical value for
-this is 5\Unit{mm} in the predefined
-\File{lco}-files\textnote{\File{lco}-file}\Index{}{lco-file=\File{lco}-file}.
-Whether or not to print the return address depend on option \Option{addrfield}
-(see \autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.addrfield}) and
-\DescRef{scrlttr2.option.backaddress} (see \autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.backaddress}).%
-%
+in the address window and will be used by the post office to return an
+undeliverable letter to the sender. This return address, therefore, requires
+only the information necessary for that purpose.
+
+The height reserved for the return address within the address window is given
+by the \PLength{backaddrheight} pseudo-length. This value is typically
+5\Unit{mm} in the predefined \File{lco} files\textnote{\File{lco}
+file}\Index{}{lco file=\File{lco} file}. Whether to print the return address
+at all depends on the \Option{addrfield} (see
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.addrfield}) and
+\DescRef{scrlttr2.option.backaddress} options (see
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.backaddress}).%
\EndIndexGroup
@@ -785,17 +801,16 @@ Whether or not to print the return address depend on option \Option{addrfield}
\PLength{specialmailindent}%
\PLength{specialmailrightindent}
\end{Declaration}
-An optional dispatch type can be output within the address field between the
-return address and the addressee address, by setting the variable
-\DescRef{scrlttr2.variable.specialmail}. Left and right alignment are determined by
-pseudo-lengths \PLength{specialmailindent} and
-\PLength{specialmailrightindent}, respectively. In the predefined
-\File{lco}-files\textnote{\File{lco}-file}\Index{lco-file=\File{lco}-file}
-provided by \KOMAScript, \PLength{specialmailindent} is set to rubber length
-\Macro{fill}, while \PLength{specialmailrightindent} is set to
-1\Unit{em}. Thus the dispatch type is set 1\Unit{em} from the address field's
-right margin.
-%
+You can print an optional delivery method between the return address and the
+recipient's address. This field is printed only if the
+\DescRef{scrlttr2.variable.specialmail} variable has non-empty contents. Its
+alignment is determined by the \PLength{specialmailindent} and
+\PLength{specialmailrightindent} pseudo-lengths, which specify the left and
+right indentation, respectively. In the predefined \File{lco}
+files\textnote{\File{lco} file}\Index{lco file=\File{lco} file},
+\PLength{specialmailindent} is set to rubber length \Macro{fill}, while
+\PLength{specialmailrightindent} is set to 1\Unit{em}. Thus the delivery
+method is set 1\Unit{em} from the address field's right margin.%
\EndIndexGroup
@@ -803,27 +818,26 @@ right margin.
\PLength{PPheadheight}%
\PLength{PPheadwidth}
\end{Declaration}
-The pseudo-length \PLength{PPheadheight}\ChangedAt{v3.03}{\Class{scrlttr2}} is
-the height, that will be reserved for the Port-Pay\'e head using the options
-\OptionValueRef{scrlttr2}{addrfield}{PP}\important[i]{%
+The \PLength{PPheadheight}\ChangedAt{v3.03}{\Class{scrlttr2}} pseudo-length
+specifies the height reserved for the postpaid header at the start of the
+address field for the two options
+\OptionValueRef{scrlttr2}{addrfield}{PP}\important{%
\OptionValueRef{scrlttr2}{addrfield}{PP}\\
- \begin{tabular}{@{}l@{}}
- \KOption{addrfield}\\
- \quad\PValue{backgroundimage}
- \end{tabular}}\IndexOption{addrfield~=\PValue{PP}} and
+ \OptionValueRef{scrlttr2}{addrfield}{backgroundimage}}%
+\IndexOption{addrfield~=\textKValue{PP}} and
\OptionValueRef{scrlttr2}{addrfield}{backgroundimage}%
-\IndexOption{addrfield~=\PValue{backgroundimage}}. Pseudo-length
-\PLength{PPheadwidth} will be used only with \OptionValueRef{scrlttr2}{addrfield}{PP} (see
-\autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.addrfield}) and gives the width of the left
-field in the Port-Pay\'e head that contains P.\,P. logo, zip-code and
-place. The width of the right field with the sender's code and the priority is
-the remaining width.
-
-Class\textnote{Attention!} \Class{scrlttr2} automatically changes
-pseudo-length \PLength{PPheadheight}'s\textnote{Attention} usual default value
-from 0\Unit{mm} into 20,74\Unit{pt} and \PLength{PPheadwidth}'s default from
-0\Unit{mm} into 42\Unit{mm}.%
+\IndexOption{addrfield~=\textKValue{backgroundimage}}. The
+\PLength{PPheadwidth} pseudo-length is used only with
+\OptionValueRef{scrlttr2}{addrfield}{PP} (see
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.addrfield}) and
+gives the width of the left-hand field within the postpaid header, which
+contains the postpaid logo, the postal code, and the location. The width of
+the right-hand field containing the sender's code and the priority is the
+remaining width.
+
+\KOMAScript{}\textnote{Attention!} automatically changes the default value of
+0\Unit{mm} for the \PLength{PPheadheight} pseudo-length to 20.74\Unit{pt}, and
+\PLength{PPheadwidth}'s default from 0\Unit{mm} to 42\Unit{mm}.%
%
\EndIndexGroup
@@ -831,32 +845,31 @@ from 0\Unit{mm} into 20,74\Unit{pt} and \PLength{PPheadwidth}'s default from
\begin{Declaration}
\PLength{PPdatamatrixvskip}
\end{Declaration}
-This\ChangedAt{v3.03}{\Class{scrlttr2}} pseudo-length gives the vertical
-distance between the Port-Pay\'e head and the data array or data matrix of
-option \OptionValueRef{scrlttr2}{addrfield}{PP}%
+This\ChangedAt{v3.03}{\Class{scrlttr2}} pseudo-length specifies the vertical
+distance between the postpaid header and the data array used with
+\OptionValueRef{scrlttr2}{addrfield}{PP}%
\important{\OptionValueRef{scrlttr2}{addrfield}{PP}}%
\IndexOption{addrfield~=\PValue{PP}} (see \autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.addrfield}). Class\textnote{Attention!}
-\Class{scrlttr2} automatically changes the default value 0\Unit{mm} into
-9\Unit{mm}. The data matrix will be set right aligned with the Port-Pay\'e
-head.%
-%
+\DescPageRef{scrlttr2.option.addrfield}). \KOMAScript{}\textnote{Attention!}
+automatically changes the default value of 0\Unit{mm} to 9\Unit{mm}. The data
+matrix is flush right within the postpaid header.%
\EndIndexGroup
%
\EndIndexGroup
-\subsection{Sender's Extensions}
+\subsection{Extra Sender Information}
\seclabel{locationField}
\BeginIndexGroup
-\BeginIndex{}{sender's extension}
-\index{sender>extension|see{sender's extension}}
+\BeginIndex{}{extra sender information}
+\index{sender>extra information|see{extra sender information}}
-Often, especially with business letters, the space for the letterhead or page
-footer seems to be too tight to include all you want. To give more details
-about the sender, often the space right beside the addressee's field is
-used. In this manual this field is called the \emph{sender's extension}. In
-former manuals is has been called \emph{location field}.
+Often, especially with business letters, there is not enough space in the
+letterhead and footer to accommodate all the information about the sender that
+you want to include. For such additional information, you can use the space
+next to the addressee. In this manual, this field is called the
+\emph{extra sender information}. In earlier versions of this manual, it
+was called the \emph{sender's extension} or the \emph{location field}.
\begin{Declaration}
\PLength{locheight}%
@@ -864,60 +877,52 @@ former manuals is has been called \emph{location field}.
\PLength{locvpos}%
\PLength{locwidth}
\end{Declaration}
-The pseudo-lengths \PLength{locwidth} and
-\PLength{locheight}\ChangedAt{v2.97d}{\Class{scrlttr2}} set the width and
-height of the sender's extension field. The pseudo-lengths \PLength{lochpos}
-and \PLength{locvpos} determine the distances from the right and upper paper
-edges. These value is typically set to 0\Unit{pt} in the predefined \File{lco}
-files. This\textnote{Attention!} does not mean that the sender's extension has
-no width; instead, it means that the actual width is set within
-\DescRef{scrlttr2.cmd.opening} when the paper width, address window width, and
-the distance between the left and upper edges of the paper and the address
-window are known. The option \DescRef{scrlttr2.option.locfield} (see
-\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.locfield}) is
-also taken into account. As is the case for \PLength{toaddrhpos}, negative
-values of \PLength{lochpos} take on a special meaning. In that case, instead
-of referring to a distance from the right edge of the paper, \PLength{lochpos}
-now means a distance from the left edge of the paper. The meaning is thus the
-opposite to that of \PLength{toaddrhpos} (see
-\autoref{sec:scrlttr2-experts.addressee},
+The \PLength{locwidth} and
+\PLength{locheight}\ChangedAt{v2.97d}{\Class{scrlttr2}} pseudo-lengths set the
+width and height of the extra-sender-information field. The \PLength{lochpos}
+and \PLength{locvpos} pseudo-lengths determine the distances from the
+top-right edge of the paper. These values are typically set to 0\Unit{pt} in
+the predefined \File{lco} files. These\textnote{Attention!} zero-length values
+have a special meaning. They result in the actual values being set within
+\DescRef{scrlttr2.cmd.opening} based on the paper width, the address-window
+width, the address window's distance from the top-left edge of the paper, and
+the \DescRef{scrlttr2.option.locfield} option (see
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.locfield}). As
+is the case for \PLength{toaddrhpos}, negative values of \PLength{lochpos}
+also take on a special meaning. Instead of referring to the distance from the
+right edge of the paper, \PLength{lochpos} then refers to the distance from
+the left edge of the paper. The meaning is thus the opposite of that of
+\PLength{toaddrhpos} (see \autoref{sec:scrlttr2-experts.addressee},
\DescPageRef{scrlttr2-experts.plength.toaddrhpos}).%
-%
\EndIndexGroup
%
\EndIndexGroup
-\subsection{Business Line}
+\subsection{Reference Line}
\seclabel{refLine}%
\BeginIndexGroup
-\BeginIndex{}{business line}
-\index{reference>field line|see{business line}}
-\index{reference>line|see{business line}}
-
-Especially with business letters, a line can be found that gives initials,
-dial code, customer number, invoice number, or a reference to a previous
-letter. This line is sometimes called \emph{reference fields line} or
-\emph{reference line}, sometimes \emph{business line}. The business line can
-consist of more than just one line and is set only if one of those variables
-mentioned above is given. Only those fields will be set that are
-given. To\textnote{Hint!} set a seemingly empty field, one needs to give as
-value at least a forced white space or \Macro{null}. If you want to have your
-letter without a business line, then instead of it the label and contents of
-the variable \DescRef{scrlttr2.variable.date} will be set. Information about adding variables
-to the business line or clean up the business line may be found in
-\autoref{sec:scrlttr2-experts.variables},
+\BeginIndex{}{reference line}
+\index{business line|see{reference line}}
+
+The reference line can actually be longer than just one line. It is printed
+only if at least one of variables for the reference line is not empty. Only
+non-empty fields will be printed. To\textnote{Hint!} set a seemingly empty
+field, you can provide content for the variable that appears empty, such as
+\Macro{mbox}\Parameter{}. If the reference line is omitted, the description
+and contents of the \DescRef{scrlttr2.variable.date} variable are printed in
+its place. You can find information about adding variables to or removing them
+from the reference line in \autoref{sec:scrlttr2-experts.variables},
\DescPageRef{scrlttr2-experts.cmd.removereffields}.
+
\begin{Declaration}
\PLength{refvpos}
\end{Declaration}
-This pseudo-length gives the distance between the upper edge of the paper and
-the reference fields line. Its value is set differently in the various
-predefined
-\File{lco}-files\textnote{\File{lco}-file}\Index{lco-file=\File{lco}-file}.
-Typical values are between 80.5\Unit{mm} and 98.5\Unit{mm}.
-%
+This pseudo-length specifies the distance from the upper edge of the paper to
+the reference line. Its value is set differently in the various predefined
+\File{lco} files\textnote{\File{lco} file}\Index{lco file=\File{lco} file}.
+Typical values are between 80.5\Unit{mm} and 98.5\Unit{mm}.%
\EndIndexGroup
@@ -925,52 +930,49 @@ Typical values are between 80.5\Unit{mm} and 98.5\Unit{mm}.
\PLength{refwidth}%
\PLength{refhpos}
\end{Declaration}
-This pseudo-length gives the width that is available for the reference fields
-line. The value is set typically to 0\Unit{pt} in the predefined
-\File{lco}-files\textnote{\File{lco}-file}\Index{lco-file=\File{lco}-file}.
-This\textnote{Attention!} value has a special meaning: in no way does it
-determine that there is no available width for the business line; instead,
-this value means that the width will be calculated within the command
-\DescRef{scrlttr2.cmd.opening}\IndexCmd{opening}. Thus the calculated width depends on the
-determination of the options \DescRef{scrlttr2.option.refline}\important{\DescRef{scrlttr2.option.refline}}%
-\IndexOption{refline~=\PName{Einstellung}} (see
-\autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.refline}). At the same time,
-\PLength{refhpos} will be set according to this option. With
-\OptionValueRef{scrlttr2}{refline}{wide}\IndexOption{refline~=\PValue{wide}}, the reference
-fields line is centered, while with
-\OptionValueRef{scrlttr2}{refline}{narrow}\IndexOption{refline~=\PValue{narrow}} it is
-aligned on the left inside the typing area.
-
-If \PLength{refwidth} is not null, i.\,e., the width of the reference fields
-line is therefore not determined by the option \DescRef{scrlttr2.option.refline}, then
-\PLength{refhpos} gives the distance of the reference fields line from the
-left edge of the paper. If\textnote{Attention!} this distance is null, then
-the reference fields line is set so that the ratio between its distances from
-the left and right edges of the paper equal the ratio of distance of the type
+The \PLength{refwidth} pseudo-length specifies the width available for the
+reference line. Its value is typically set to 0\Unit{pt} in the predefined
+\File{lco} files\textnote{\File{lco} file}\Index{lco file=\File{lco} file}.
+This\textnote{Attention!} value has a special meaning. In no way does it
+indicate that there is no available width for the reference line. Instead, it
+indicates that the width will be calculated within the
+\DescRef{scrlttr2.cmd.opening}\IndexCmd{opening} command. This calculated
+width then depends on the value of the \DescRef{scrlttr2.option.refline}%
+\important{\DescRef{scrlttr2.option.refline}}%
+\IndexOption{refline~=\PName{setting}} options (see
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.refline}). At
+the same time, \PLength{refhpos} will also be set according to this option.
+With \OptionValueRef{scrlttr2}{refline}{wide}%
+\IndexOption{refline~=\textKValue{wide}}, the reference fields line is
+centred, while with \OptionValueRef{scrlttr2}{refline}{narrow}%
+\IndexOption{refline~=\textKValue{narrow}} it is aligned flush left with the
+type area.
+
+If \PLength{refwidth} is not zero, the width of the reference line is not
+determined by the \DescRef{scrlttr2.option.refline} option, and so
+\PLength{refhpos} specifies the distance of the reference line from the left
+edge of the paper. If\textnote{Attention!} this distance is zero, the the
+reference line is placed so that the ratio between its distances from the left
+and right edges of the paper corresponds to the ratio of distance of the type
area from the left and right edges of the paper. Thus, for a type area
-horizontally centered on the paper, the reference fields line too will be
-centered.
-
-As a rule, these special cases are likely to be of little interest to the
-normal user. The\textnote{Attention!} simplest rule is as follows: either
-\PLength{refhpos} is left at null and so the width and alignment of the
-reference fields line are left to the option
-\DescRef{scrlttr2.option.refline}, or \PLength{refwidth} as well as
-\PLength{refhpos} are set by the user.%
-%
+horizontally centred on the paper, the reference line will also be centred.
+
+As a rule, these special cases are likely of little interest to the normal
+user. The\textnote{Attention!} simplest rule is as follows: either
+\PLength{refhpos} remains zero, and so the width and alignment of the
+reference line are determined with the \DescRef{scrlttr2.option.refline}
+option, or the user sets both \PLength{refwidth} and \PLength{refhpos}.%
\EndIndexGroup
\begin{Declaration}
\PLength{refaftervskip}
\end{Declaration}
-This pseudo-length gives the vertical space that has to be inserted beneath
-the reference fields line. The value is set in the predefined
-\File{lco}-files\textnote{\File{lco}-file}\Index{lco-file=\File{lco}-file}. It
-directly affects the text height of the first page. A typical value lies
+This pseudo-length specifies the vertical skip to be inserted beneath the
+reference line. The value is set in the predefined \File{lco}
+files\textnote{\File{lco} file}\Index{lco file=\File{lco} file}. It directly
+affects the height of the text area on the first page. A typical value is
between one and two lines.%
-%
\EndIndexGroup
%
\EndIndexGroup
@@ -981,26 +983,26 @@ between one and two lines.%
\BeginIndexGroup
\BeginIndex{}{subject}
-In different countries the letter's subject will be set different. Some like
-to have the subject before the opening phrase, some prefer the subject below
-the opening phrase. Some professional guilds at least want the subject before
-the business line.
+Different countries have different conventions for placing the subject line of
+a letter. Some place it before the opening phrase; others place it after. Some
+professional groups even want it before the reference line.
\begin{Declaration}
\PLength{subjectvpos}
\end{Declaration}
\ChangedAt{v3.01}{\Class{scrlttr2}}%
If\textnote{Attention!} the value of this pseudo-length is 0\Unit{pt}, the
-position of the subject is given by option
\DescRef{scrlttr2.option.subject}\important{\DescRef{scrlttr2.option.subject}}%
-\IndexOption{subject~=\PName{Einstellung}} (see
-\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.subject}).
-Every other value defines the distance between the top edge of the paper and
-the subject. It\textnote{Hint!} is recommended to take care of the available
-space to surely avoid interferences with other elements.
+\IndexOption{subject~=\PName{Einstellung}} option (see
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.subject})
+determines the position of the subject. Any other value defines the distance
+between the top edge of the paper and the subject. In this
+case\textnote{Hint!}, you should ensure that there is enough space available
+that overlapping with other elements is unlikely.
\begin{Example}
- Some professional guilds prefer to have the subject at least before the
- business line. To achieve this, the position may be defined like this:
+ A few professionals prefer to have the subject above the reference line. For
+ this, you can specify the position as follows, which also changes the
+ position of the reference line itself:
\begin{lstcode}
\ProvidesFile{lawsubj.lco}
[2008/11/03 lawyers lco file]
@@ -1008,9 +1010,8 @@ space to surely avoid interferences with other elements.
\@addtoplength{refvpos}{3\baselineskip}
\endinput
\end{lstcode}
- which also changes the position of the business line itself. If at least one
- empty line between subject and business line should stay empty, this
- provides a maximum of two subject lines.
+ If you want to leave at least one empty line between the subject and the
+ reference, you have space for a maximum of two lines.
\end{Example}
\EndIndexGroup
@@ -1020,13 +1021,12 @@ space to surely avoid interferences with other elements.
\PLength{subjectaftervskip}
\end{Declaration}
\ChangedAt{v3.01}{\Class{scrlttr2}}%
-If the subject is not positioned absolutely, but before or after the opening
-phrase, additional vertical spaces may be inserted before and after the
-subject. Thereby, the space before the subject may interfere with other
-distances like the automatic distance of one line after the title. Because of
-this the default is to use no additional space here. In contrast, the class's
-default for the space after the subject is two lines.%
-%
+If the subject is placed not absolutely but before or after the salutation,
+you can insert additional vertical space before and after the subject. The
+space before the subject may interfere with other distances, such as the
+automatic distance of one line after the title. Therefore the default is to
+use no additional space here. The default of the class and the package for the
+space after the subject is two lines.%
\EndIndexGroup
%
\EndIndexGroup
@@ -1037,87 +1037,92 @@ default for the space after the subject is two lines.%
\BeginIndexGroup
\BeginIndex{}{closing}
-The closing consists of three parts: besides the closing phrase there
-are a hand-written inscription and the signature, which acts as an
-explanation for the inscription.
+The closing of a letter consists of three parts: In addition to the closing
+phrase, there is a hand-written signature and a printed text such as a name,
+which acts as a kind of explanation of the hand-written signature.
\begin{Declaration}
\PLength{sigindent}%
\PLength{sigbeforevskip}
\end{Declaration}
-Closing phrase\Index{closing>phrase}\Index{signature} and signature will be
-typeset in a box. The width of the box is determined by the length of the
-longest line of the closing phrase or signature.
-
-The box will be typeset with indentation of the length set in pseudo-length
-\PLength{sigindent}. In the predefined
-\File{lco}-files\textnote{\File{lco}-file}\Index{lco-file=\File{lco}-file}
-this length is set to 0\Unit{mm}.
-
-Between closing phrase and signature a vertical space is inserted, the height
-of which is defined in the pseudo-length \PLength{sigbeforevskip}. In the
-predefined
-\File{lco}-files\textnote{\File{lco}-file}\Index{lco-file=\File{lco}-file}
-this is set to two lines. In this space you can then write your inscription.%
+The closing phrase\Index{closing>phrase}\Index{signature} and signature
+explanation are typeset in a box whose width is determined by the length of
+the longest line of the closing phrase or explanation.
+
+The box will be indented by the distance specified in the \PLength{sigindent}
+pseudo-length. In the predefined \File{lco} files\textnote{\File{lco}
+file}\Index{lco file=\File{lco} file}, this length is set to 0\Unit{mm}.
+
+Between the closing phrase and the signature explanation, a vertical skip is
+inserted whose height is defined in the \PLength{sigbeforevskip}
+pseudo-length. In the predefined \File{lco} files\textnote{\File{lco}
+file}\Index{lco file=\File{lco} file} this value is set to two lines. In this
+space you can then write your signature.%
+\iffalse% Umbruchkorrekturtext
+\ If you decide to include a facsimile of your signature in the
+\DescRef{scrlttr2.variable.signature}\IndexVariable{signature}%
+\important{\DescRef{scrlttr2.variable.signature}} with the
+\Package{graphicx}\IndexPackage{graphicx} package, it would be useful
+to reduce the value of \PLength{sigbeforevskip} and thus the gap between
+the closing phrase and the signature.%
+\fi%
\EndIndexGroup
%
\EndIndexGroup
-\subsection{Letter Footer}
+\subsection{Letterhead Page Footer}
\seclabel{firstFoot}%
\BeginIndexGroup
-\BeginIndex{}{letter>footer}%
-\index{note paper>footer|see{letter footer}}%|
+\BeginIndex{}{letterhead page>footer}%
-
-As the first page of a letter, the note paper, holds a letterhead of its own,
-it also holds a footer\Index{footer>of note paper}\Index{footer>of letter} of
-its own. And, as with the letterhead, it will not be set by the page style
-settings, but directly with the use of
-\DescRef{scrlttr2.cmd.opening}\IndexCmd{opening}\important{\DescRef{scrlttr2.cmd.opening}}.
+The first page of a letter, the letterhead page, contains not just its own
+header, the letterhead, but also its own footer\Index{footer>letterhead
+page}\Index{footer}. Just like the letterhead, it will be set not by the page
+style but directly within \DescRef{scrlttr2.cmd.opening}\IndexCmd{opening}%
+\important{\DescRef{scrlttr2.cmd.opening}}.
\begin{Declaration}
\PLength{firstfootvpos}
\end{Declaration}
-This pseudo-length gives the distance between the letter footer and the upper
-edge of the paper. It also takes care of preventing text from jutting into the
-footer area. For this the text height on the first page will be decreased
-using \Macro{enlargethispage}\IndexCmd{enlargethispage}%
-\important{\Macro{enlargethispage}} if needed. Likewise, and if it is wanted,
-the text height can conversely be extended with the help of the option
-\DescRef{scrlttr2.option.enlargefirstpage}\important{\DescRef{scrlttr2.option.enlargefirstpage}} (see
+This pseudo-length gives the distance from the top of the paper to the footer
+of the letterhead page. It also ensures that the text area does not protrude
+into the footer. To do so, the height of the text area on the first page will
+be decreased, if necessary, using
+\Macro{enlargethispage}\IndexCmd{enlargethispage}%
+\important{\Macro{enlargethispage}}. The
+\DescRef{scrlttr2.option.enlargefirstpage}%
+\important{\DescRef{scrlttr2.option.enlargefirstpage}} option (see
\autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.enlargefirstpage}). This way, the distance
-between text area and the first letter footer can be reduced to the value
-\Length{footskip}\IndexLength{footskip}\important{\Length{footskip}}.
+\DescPageRef{scrlttr2.option.enlargefirstpage}) can also ensure that the
+height of the text area is increased, if necessary. Thus, the distance between
+text area and the letterhead page footer can be reduced to the value of the
+\Length{footskip}\IndexLength{footskip}\important{\Length{footskip}} length.
With\textnote{Attention!} the compatibility option
-set\ChangedAt{v2.9t}{\Class{scrlttr2}} up to version
+set\ChangedAt{v2.9t}{\Class{scrlttr2}} to versions up to
2.9t\IndexOption{version~=\PValue{2.9t}} (see
\DescRef{scrlttr2.option.version} in
\autoref{sec:scrlttr2.compatibilityOptions},
\DescPageRef{scrlttr2.option.version}) the footer is set independently of the
-type area in all predefined
-\File{lco}-files\textnote{\File{lco}-file}\Index{lco-file=\File{lco}-file}
-(see \autoref{sec:scrlttr2.lcoFile}) except for \Option{KOMAold} and
-\Option{NF}. The option \DescRef{scrlttr2.option.enlargefirstpage}%
-\important{\DescRef{scrlttr2.option.enlargefirstpage}} also loses its
-effect. From version 2.9u\IndexOption{version~=\PValue{2.9u}} onwards the
-footer is set in a position at the bottom edge of the paper. In this
-situation, the height of the type area also becomes dependent on
-\DescRef{scrlttr2.option.enlargefirstpage}.
-
-If the letter footer be switched off using option
+type area in all predefined \File{lco} files\textnote{\File{lco}
+file}\Index{lco file=\File{lco} file} (see \autoref{sec:scrlttr2.lcoFile})
+except for \Option{KOMAold} and \Option{NF}. Thus the
+\DescRef{scrlttr2.option.enlargefirstpage}%
+\important{\DescRef{scrlttr2.option.enlargefirstpage}} option has no effect.
+From version 2.9u on, the footer is placed at the bottom edge of the paper.
+Thus, the height of the letterhead page's type area may also depend on the
+\DescRef{scrlttr2.option.enlargefirstpage} option.
+
+If the letter footer is deactivated with the
\OptionValueRef{scrlttr2}{firstfoot}{false}%
\important{\OptionValueRef{scrlttr2}{firstfoot}{false}}%
\IndexOption{firstfoot~=\PValue{false}}\ChangedAt{v2.97e}{\Class{scrlttr2}}
-(see \autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.firstfoot}), then the setting of
+option (see \autoref{sec:scrlttr2.firstpage},
+\DescPageRef{scrlttr2.option.firstfoot}), the setting of
\PLength{firstfootvpos} is ignored, and instead
-\Length{paperheight}\IndexLength{paperheight} is applied. Thus, there remains
-a mimimum bottom margin of length \Length{footskip}\IndexLength{footskip}.%
-%
+\Length{paperheight}\IndexLength{paperheight} is applied. There remains then a
+minimum bottom margin of length \Length{footskip}\IndexLength{footskip}.%
\EndIndexGroup
@@ -1125,28 +1130,28 @@ a mimimum bottom margin of length \Length{footskip}\IndexLength{footskip}.%
\PLength{firstfoothpos}
\end{Declaration}
\ChangedAt{v3.05}{\Class{scrlttr2}}%
-A\textnote{Attention!} positive value of pseudo-length \PLength{firstfoothpos}
-gives the distance between the letter footer and the left edge of the
-paper. If the value is even greater than or equal to the paper width,
-\Length{paperwidth}\IndexLength{paperwidth}, then the footer will be centered
-horizontally to the note paper. But if the value is less than or equal to the
-negative width of the paper, then the footer will be aligned left to the
-typing area.
-
-Typical default for this value is \Length{maxdimen}\IndexLength{maxdimen},
-that is the maximum allowed value of a length. This results in horizontal
-centering.%
+A\textnote{Attention!} positive value of the \PLength{firstfoothpos}
+pseudo-length specifies the distance from the left edge of the paper to the
+letterhead page footer. If the value is greater than or equal to the paper
+width, \Length{paperwidth}\IndexLength{paperwidth}, the footer is centred
+horizontally on the letterhead page. But if the value is less than or equal to
+the negative width of the paper, the footer is placed flush with the left edge
+of the typing area.
+
+The typical default for this value is \Length{maxdimen}\IndexLength{maxdimen},
+which is the maximum possible value for a length. This results in horizontal
+centring.%
\EndIndexGroup
\begin{Declaration}
\PLength{firstfootwidth}
\end{Declaration}
-This pseudo-length gives the width of the letter's first page footer. The
-value is set equal to that of the pseudo-length
+This pseudo-length specifies the width of the footer of the first page of the
+letter, that is the letterhead page. The value in the predefined \File{lco}
+files\textnote{\File{lco} file}\Index{lco file=\File{lco} file} matches
\PLength{firstheadwidth}\important{\PLength{firstheadwidth}}%
-\IndexPLength{firstheadwidth} in the predefined
-\File{lco}-files\textnote{\File{lco}-file}\Index{lco-file=\File{lco}-file}.%
+\IndexPLength{firstheadwidth}.%
%
\EndIndexGroup
%
@@ -1160,9 +1165,9 @@ value is set equal to that of the pseudo-length
\BeginIndexGroup
\BeginIndex{}{variables}
-\KOMAScript{} provides beside the feature of using predefined variable also
-commands to define new variable or to manipulate the automatic usage of
-variables in the business line\Index{business line}.
+\KOMAScript{} provides commands not only to use predefined variables but also
+to define new variables or to change their automatic use within the reference
+line\Index{reference line}.
\begin{Declaration}
\Macro{newkomavar}\OParameter{description}\Parameter{name}%
@@ -1171,56 +1176,56 @@ variables in the business line\Index{business line}.
\Macro{defaultreffields}%
\Macro{addtoreffields}\Parameter{name}
\end{Declaration}
-With \Macro{newkomavar} a new variable is defined. This variable is
-addressed via \PName{name}. As an option you can define a
-\PName{description} for the variable \PName{name}. In opposite to \PName{name}
-the \PName{description} is not used to reference a variable. In fact the
-\PName{description} defines an addition to the content of a variable, that may
-be output similar to the variable content.
-
-Using the command \Macro{addtoreffields} you can add the variable \PName{name}
-to the reference fields line\Index{business line} (see
-\autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.refline}). The \PName{description} and the
-content of the variable are added at the end of the reference fields line. The
-starred version \Macro{newkomavar*} is similar to the unstarred version, with
-a subsequent call of the command \Macro{addtoreffields}. Thus, the starred
-version automatically adds the variable to the reference fields line.
+\Macro{newkomavar} defines a new variable. This variable is referenced as
+\PName{name}. Optionally, you can define a \PName{description} for the
+\PName{name} variable. Unlike the \PName{name}, the \PName{description} is not
+used to reference a variable. Instead, the \PName{description} acts as a
+supplement to the content of a variable that can be printed as a label along
+with its content.
+
+You can use the \Macro{addtoreffields} command to add the \PName{name}
+variable to the reference line\Index{reference line} (see
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.refline}). The
+\PName{description} and the content of the variable are added to the end of
+the reference line. The starred version \Macro{newkomavar*} is similar to the
+unstarred version but also calls the \Macro{addtoreffields} command. Thus, the
+starred version automatically adds the variable to the reference line.
\begin{Example}
- Suppose you need an additional field for direct dialling. You can
- define this field either with
+ Suppose you need an additional field for a telephone extension in the
+ reference line. You can define this field with
\begin{lstcode}
- \newkomavar[Direct dialling]{myphone}
+ \newkomavar[Extension]{myphone}
\addtoreffields{myphone}
\end{lstcode}
or more concisely with
\begin{lstcode}
- \newkomavar*[direct dialling]{myphone}
+ \newkomavar*[Extension]{myphone}
\end{lstcode}
\end{Example}
-When\textnote{Attention!} you define a variable for the reference fields line
-you should always give it a description.
-
-With the command \Macro{removereffields} all variables in the reference field
-line can be removed. This also includes the predefined variables of the
-class. The reference fields line is then empty. This can be useful, for
-example, if you wish to change the order of the variables in the reference
-fields line.
-
-The command \Macro{defaultreffields} acts to reset the reference
-fields line to its predefined format. In doing so, all custom-defined
-variables are removed from the reference fields line.
-
-The\textnote{Attention!} date should not be added to the reference fields line
-using \Macro{addtoreffields}. Instead option \Option{date}%
-\important[i]{\OptionValueRef{scrlttr2}{refline}{dateleft}\\
- \OptionValueRef{scrlttr2}{refline}{dateright}\\
- \OptionValueRef{scrlttr2}{refline}{nodate}}%
-\IndexOption{refline~=\PValue{dateleft}}%
-\IndexOption{refline~=\PValue{dateright}}%
-\IndexOption{refline~=\PValue{nodate}} should be used to select the date left,
-right or not at the business line. This option also will change the position
-of the date if no reference fields will be output.%
+When\textnote{Attention!} you define a variable for the reference line, you
+should always give it a description.
+
+You can use the \Macro{removereffields} command to remove all variables from
+the reference field. This includes the predefined variables of the class. The
+reference line is then empty. This can be useful, for example, if you wish to
+change the order of the variables in the reference fields line.
+
+The \Macro{defaultreffields} command resets the reference fields line to its
+predefined format. In doing so, all custom-defined variables are removed from
+the reference fields line.
+
+You\textnote{Attention!} should not add the date to the reference line with
+the \Macro{addtoreffields} command. Instead you should use the
+\DescRef{scrlttr2.option.refline}%
+\important{\OptionValueRef{scrlttr2}{refline}{dateleft}\\
+\OptionValueRef{scrlttr2}{refline}{dateright}\\
+\OptionValueRef{scrlttr2}{refline}{nodate}}%
+\IndexOption{refline~=\textKValue{dateleft}}%
+\IndexOption{refline~=\textKValue{dateright}}%
+\IndexOption{refline~=\textKValue{nodate}} option to select whether the date
+should appear on the left or right side of the reference line, or not at all.
+These settings also affect the position of the date when no reference line is
+used.%
%
\EndIndexGroup
@@ -1229,22 +1234,22 @@ of the date if no reference fields will be output.%
\Macro{usekomavar}\OParameter{command}\Parameter{name}%
\Macro{usekomavar*}\OParameter{command}\Parameter{name}
\end{Declaration}
-The commands \DescRef{scrlttr2.cmd.usekomavar} and
-\DescRef{scrlttr2.cmd.usekomavar*} are, similarly to all commands where a
-starred version exists or which can take an optional argument, not fully
-expandable. Nevertheless, if used within
-\DescRef{scrlttr2.cmd.markboth}\IndexCmd{markboth},
+The \DescRef{scrlttr2.cmd.usekomavar} and \DescRef{scrlttr2.cmd.usekomavar*}
+commands are, like all commands where a starred version exists or which can
+take an optional argument, not fully expandable. Nevertheless, if you use them
+within \DescRef{scrlttr2.cmd.markboth}\IndexCmd{markboth},
\DescRef{scrlttr2.cmd.markright}\IndexCmd{markright} or similar commands, you
-need not insert a \Macro{protect}\IndexCmd{protect} before using them. Of
-course this is also true for
-\DescRef{scrlayer-scrpage.cmd.markleft}\IndexCmd{markleft} if using package
-\Package{scrlayer-scrpage}. However\textnote{Attention!}, these kinds of
-commands can not be used within commands like
-\Macro{MakeUppercase}\important{\Macro{MakeUppercase}}\IndexCmd{MakeUppercase}
-which directly influence their argument. To avoid this problem you may use
-commands like \Macro{MakeUppercase} as an optional argument to
-\Macro{usekomavar} or \Macro{usekomavar*}. Then you will get the uppercase
-content of a variable using:
+need not insert \Macro{protect}\IndexCmd{protect} beforehand. Of course
+this is also true for
+\DescRef{scrlayer-scrpage.cmd.markleft}\IndexCmd{markleft} if you use the
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage} package. These\textnote{Attention!} commands
+cannot be used within commands that directly affect their argument, such as
+\Macro{MakeUppercase}\important{\Macro{MakeUppercase}}%
+\IndexCmd{MakeUppercase}. To avoid this problem you can use commands like
+\Macro{MakeUppercase} as an optional argument to \Macro{usekomavar} or
+\Macro{usekomavar*}. Then you will get the upper-case content of a variable
+with
\begin{lstcode}[escapeinside=`']
\usekomavar[\MakeUppercase]{`\PName{Name}'}
\end{lstcode}
@@ -1256,194 +1261,110 @@ content of a variable using:
\Macro{ifkomavarempty}\Parameter{name}\Parameter{true}\Parameter{false}%
\Macro{ifkomavarempty*}\Parameter{name}\Parameter{true}\Parameter{false}
\end{Declaration}
-It is important to know that the content or description of the variable will
-be expanded as far as this is possible with \Macro{edef}. If this results in
-spaces or unexpandable macros like \Macro{relax}, the result will be not empty
-even where the use of the variable would not result in any visible output.
-
-Both\textnote{Attention!} variants of the command also must not be used as the
-argument of \Macro{MakeUppercase}\IndexCmd{MakeUppercase} or other commands
-which have similar effects to their arguments However, they are robust enough
-to be used as the argument of, e.\,g., \DescRef{scrlttr2.cmd.markboth} or
-\Macro{footnote}.%
+It is important to know that the content of the variable will be expanded as
+far as this is possible with \Macro{edef}. If this results in spaces or
+unexpandable macros like \Macro{relax}, the result will be not empty even
+where the use of the variable would not result in any visible output.
+
+Once\textnote{Attention!} again, this command cannot be used as the argument
+of \Macro{MakeUppercase}\IndexCmd{MakeUppercase} or similar commands However,
+it is robust enough to be used as the argument of
+\DescRef{scrlttr2.cmd.markboth} or \DescRef{scrlttr2.cmd.footnote}, for
+example.%
%
\EndIndexGroup
%
\EndIndexGroup
-\section{Differences in the Page Styles of \Package{scrletter}}
+\section{Additional Information about Page Styles}
\seclabel{pagestyleatscrletter}
\BeginIndexGroup
\BeginIndex{}{page>style}
-As described in \autoref{sec:scrlttr2.pagestyle}, the page style
-\PageStyle{headings} shows the content of variables \DescRef{scrlttr2.variable.nexthead} and
-\DescRef{scrlttr2.variable.nextfoot}. Page style \PageStyle{headings} has already another
-meaning in the \KOMAScript{} classes \Class{scrbook}, \Class{scrreprt}, and
-\Class{scrartcl}. Therefore \Package{scrletter} defines a new pair of page
-styles (see \autoref{sec:scrlayer-scrpage-experts.pagestyle.pairs},
-\autopageref{sec:scrlayer-scrpage-experts.pagestyle.pairs}). The definition
-is done using package
-\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage}.
-
-Hence, you cannot use \Package{scrletter} with the outdated packages
-\Package{scrpage2}\IndexPackage{scrpage2} and
-\Package{scrpage}\IndexPackage{scrpage}. Same applies to
-\Package{fancyhdr}\IndexPackage{fancyhdr} that is in general not recommended
-for use with \KOMAScript. Additionally, internally loading package
-\Package{scrlayer-scrpage} automatically activates page style
-\PageStyle{scrheadings}\IndexPagestyle{scrheadings}. This activation
-changes page styles \PageStyle{headings} and \PageStyle{plain} into aliases of
-\PageStyle{scrheadings} and \PageStyle{plain.scrheadings}. So these page
-styles are also controlled by \Package{scrlayer-scrpage}.
-
-\begin{Declaration}
- \PageStyle{letter}
- \PageStyle{plain.letter}
- \DescRef{scrlttr2.variable.nexthead}
- \DescRef{scrlttr2.variable.nextfoot}
-\end{Declaration}
-Package \Package{scrletter} defines the pair of page style \PageStyle{letter}
-using \Package{scrlayer-scrpage} to become independent from the page styles of
-the document class. Variables \DescRef{scrlttr2.variable.nexthead} and
-\DescRef{scrlttr2.variable.nextfoot} are used by \Package{scrletter}'s
-\PageStyle{letter} in the same way as for \Class{scrlttr2}'s
-\PageStyle{headings}. The corresponding \PageStyle{plain} page style is also
-similar to \Class{scrlttr2}'s page style \PageStyle{plain}. Notably the
-position of the page number depends on option
-\DescRef{scrlttr2.option.pagenumber}\IndexOption{pagenumber} (see
-\DescPageRef{scrlttr2.option.pagenumber}).%
-\EndIndexGroup
-
-
-\begin{Declaration}
- \Option{headsepline}%
- \Option{footsepline}
-\end{Declaration}
-Because of the different internal approach of \Package{scrletter}, the options
-\Option{headsepline}\important[i]{\Option{headsepline}\\%
- \Option{footsepline}} and \Option{footsepline} differ slightly from
-class \Class{scrlttr2}, because they are controlled by package
-\Package{scrlayer-scrpage}. Especially the horizontal lines in page head and
-foot of the \PageStyle{plain} page style depend on the options of
-\Package{scrlayer-scrpage}. See
-\autoref{sec:scrlayer-scrpage.pagestyle.content},
-\DescPageRef{scrlayer-scrpage.option.headsepline} and
-\DescPageRef{scrlayer-scrpage.option.plainheadsepline} for information
-about those options.%
-\EndIndexGroup
-
-
-\begin{Declaration}
- \Macro{pagemark}%
- \Macro{letterpagemark}
-\end{Declaration}
-The \KOMAScript{} classes already define and use \Macro{pagemark}. So when
-\Package{scrletter} is loaded, it cannot simply redefine \Macro{pagemark} to
-add the prefix ``Page'' using \Macro{pagename}, because this would not only
-influence the pagination of the letter pages but the pagination of the whole
-document. Therefore\ChangedAt{v3.17}{\Package{scrletter}} \Package{scrletter}
-defines a new command \Macro{letterpagemark} with the prefix and lets
-\Macro{pagemark} become \Macro{letterpagemark} in
-\Macro{begin}\PParameter{letter} until the end of the letter only. If you want
-to redefine \Macro{pagemark} for the whole document including the letter
-pages, you have to add
-\begin{lstcode}
- \let\letterpagemark\pagemark
-\end{lstcode}
-just after the normal redefinition of \Macro{pagemark}. This add-on also will
-not violate anything if you later decide to switch from package
-\Package{scrletter} to class \Class{scrlttr2}. Note that the class
-\Class{scrlttr2} does not provide or use \Macro{letterpagemark}.%
-\EndIndexGroup
-%
+\LoadNonFree{scrlttr2-experts}{0}%
\EndIndexGroup
-
-\section{Differences in the Handling of \File{lco}-Files in
- \Package{scrletter}}
+\iffalse% Wurde bereits in Kapitel 4.21 behandelt
+\section{Differences in How \Package{scrletter} Handles \File{lco} Files}
\seclabel{lcoatscrletter}
\BeginIndexGroup
\BeginIndex{File}{lco}
-\BeginIndex{}{letter>class option}%
-\BeginIndex{}{letter class option}%
-\BeginIndex{}{lco-file=\File{lco}-file}
+\BeginIndex{}{lco file=\File{lco} file}
-As\ChangedAt{v3.15}{\Package{scrletter}} shown in
-\autoref{sec:scrlttr2.lcoFile}, \Class{scrlttr2} can load \File{lco}-files via
-the optional argument of \Macro{documentclass}. Package \Package{scrletter}
+As\ChangedAt{v3.15}{\Package{scrletter}} explained in
+\autoref{sec:scrlttr2.lcoFile}, \Class{scrlttr2} can load \File{lco} files via
+the optional argument of \Macro{documentclass}. The \Package{scrletter} package
does not support this.
\begin{Declaration}
\Macro{LoadLetterOption}\Parameter{name}%
\Macro{LoadLetterOptions}\Parameter{list of names}
\end{Declaration}
-For \Class{scrlttr2} it is only recommended to load \File{lco}-files using
+For \Class{scrlttr2}, load \File{lco} files with
\DescRef{scrlttr2.cmd.LoadLetterOption} or
-\DescRef{scrlttr2.cmd.LoadLetterOptions}. With \Package{scrletter} you must
-use these commands to load \File{lco}-files. Of course, you can use these
-commands at the earliest after loading \Package{scrletter}.%
+\DescRef{scrlttr2.cmd.LoadLetterOptions} is only a recommendation. For
+\Package{scrletter}, it is mandatory. Of course, you can only load the
+\File{lco} files after you load \Package{scrletter}.
+%
\EndIndexGroup
%
\EndIndexGroup
+\fi
-\section{\File{lco}-Files for Experienced Users}
+\section{\File{lco} Files for Experienced Users}
\seclabel{lcoFile}
\BeginIndexGroup
-\BeginIndex{File}{lco}%
-\BeginIndex{}{lco-file=\File{lco}-file}%
-
-\BeginIndex{}{paper>size>limitation}%
-Even though each paper size, that may be set up using package
-\Package{typearea}, may be also used with \Class{scrlttr2}, the result of the
-first page may be unwanted with some of those page sizes. The conception of
-the class is not the reason for this, but the fact, that there are mainly
-parameter sets for ISO~A4 paper. Unfortunately their are not any universal
-rules, to calculate, e.\,g., the position of the address field or similar for
-every available paper sizes. But it is possible to make parameter sets for any
-paper size that is needed.%
-%
-\EndIndex{}{paper>size>limitation}%
-
-
-\subsection{Survey of Paper Size}
-\seclabel{papersize}
-
-At present there exist only parameter sets and \File{lco}-files for A4-sized
-or letter-sized paper. Nevertheless, class \Class{scrlttr2} supports many more
-paper sizes. Because of this it's necessary to survey setting up the correct
-paper size.
+\BeginIndex{File}{lco}
+\BeginIndex{}{lco file=\File{lco} file}
+
+\BeginIndexGroup%
+\BeginIndex{}{paper>format}%
+Although you can use any paper size that the
+\hyperref[cha:typearea]{\Package{typearea}}%
+\IndexPackage{typearea} package can configure, the output of the letterhead
+page may produce undesirable results with some formats. Unfortunately, there
+are no general rules to calculate the position of the address fields and the
+like for every available paper size. Instead, different parameter sets are
+needed for different paper sizes.%
+
+%\subsection{Verifying the Paper Size}
+%\seclabel{papersize}
+
+At present parameter sets and \File{lco} files exist only for A4-sized and
+letter-sized paper. Theoretically, however, the \Class{scrlttr2} class can
+support many more paper sizes. Therefore, it's necessary to verify that the
+correct paper size is used. This is even more true if you use
+\Package{scrletter}, since the paper size depends on the class you use.
\begin{Declaration}
\Macro{LetterOptionNeedsPapersize}%
\Parameter{option name}\Parameter{paper size}
\end{Declaration}
-In order that you will at least be warned when using another \PName{paper
- size}, you will find a \Macro{LetterOptionNeedsPapersize} command in every
-\File{lco}-file distributed with {\KOMAScript}. The first argument is the name
-of the \File{lco}-file without the ``\File{.lco}'' suffix. The second argument
-is the paper size for which the \File{lco}-file is designed.
+To provide at least a warning when another \PName{paper size} is used, you can
+find a \Macro{LetterOptionNeedsPapersize} command in every \File{lco} file
+distributed with {\KOMAScript}. The first argument is the name of the
+\File{lco} file without the ``\File{.lco}'' suffix. The second argument is the
+paper size for which the \File{lco} file is designed.
If several \File{lco} files are loaded in succession, a
\Macro{LetterOptionNeedsPapersize} command can be contained in each of them,
-but the \DescRef{scrlttr2.cmd.opening} command will only check the last given \PName{paper
- size}. As shown in the following example, an experienced user can thus
-easily write \File{lco}-files with parameter sets for other paper sizes.
+but the \DescRef{scrlttr2.cmd.opening} command will only check the last given
+\PName{paper size}. As the following example shows, an experienced user can
+thus easily write \File{lco} files with parameter sets for other paper sizes.
\iffalse% Umbruchoptimierung
-If you do not plan to set up such \File{lco}-files yourself, you may just
+If you do not plan to set up such \File{lco} files yourself, you can just
forget about this option and skip the example.%
\fi
\begin{Example}
- Suppose you use A5-sized paper in normal, i.\,e., upright or portrait,
- orientation for your letters. We further assume that you want to put them
- into standard C6 window envelopes. In that case, the position of the address
- field would be the same as for a DIN standard letter on A4-sized paper. The
- main difference is that A5 paper needs only one fold. So you want to disable
- the topmost and bottommost folding marks. If their would not be options for
- this, the easiest way to achieve this would be to place the marks outside of
- the paper area.
+ Suppose you use A5-sized paper in normal, that is upright or portrait,
+ orientation for your letters. Let's assume that you want to put them into
+ standard C6 window envelopes. In that case, the position of the address
+ field would be the same as for a standard letter on A4-sized paper. The main
+ difference is that A5 paper needs only one fold. So you want to disable the
+ top and bottom fold marks. You can do this, for example, by placing the
+ marks outside the paper area.
\begin{lstcode}
\ProvidesFile{a5.lco}
[2002/05/02 letter class option]
@@ -1451,66 +1372,66 @@ forget about this option and skip the example.%
\@setplength{tfoldmarkvpos}{\paperheight}
\@setplength{bfoldmarkvpos}{\paperheight}
\end{lstcode}
- Besides this, the placement of the foot, that is, the pseudo-length
- \PLength{firstfootvpos}, must be adjusted. It is left to the reader to find
- an appropriate value. When using such an \File{lco} file, you must only take
- care that other \File{lco} file options, like \File{SN}, are declared before
- loading ``\File{a5.lco}''.
-\iffalse% Umbruchoptimierung
- Does this seem too complicated? Only before you have used it the first
- time. Anyway, how often do you write letters not using your standard formats
- for A4-size or letter-size paper?
-\fi%
+ Of course, it would be more elegant to deactivate the marks with the
+ \DescRef{scrlttr2.option.foldmarks} option. In addition, you must adjust the
+ position of the footer, that is, the \PLength{firstfootvpos} pseudo-length.
+ I leave it to the reader to find an appropriate value. When using such an
+ \File{lco} file, you must declare other \File{lco} file options like
+ \File{SN} before you load ``\File{a5.lco}''.
\end{Example}
%
-\EndIndexGroup
+\EndIndexGroup%
+\EndIndexGroup%
+\vskip-\ht\strutbox% Wegen Beispiel am Ende der Erklaerung
-\subsection{Visualization of Positions}
-\seclabel{visualize}
-\BeginIndexGroup
-\BeginIndex{Option}{visualize}
-
-If someone develops a new \File{lco}-file, e.\,g., to adapt the positions of
-the several fields of the note paper because of own wishes or because it's
-simply necessary, then it often will be useful to make at least some elements
-directly visual. This is the sense of \File{lco}-file
-\File{visualize.lco}\ChangedAt{v3.04}{\Class{scrlttr2}}. This file may be
-loaded like each other \File{lco}-file. But in difference to other
-\File{lco}-files it has to be done in the document preamble and it's not
-possible to switch off the effects of that \File{lco}-file. This
-\File{lco}-file uses packages \Package{eso-pic}\IndexPackage{eso-pic}%
-\important[i]{\Package{eso-pic}\\\Package{graphicx}}
-and \Package{graphicx}\IndexPackage{graphicx}, that are not part of
+%\subsection{Visualizing Positions}
+%\seclabel{visualize}
+%\BeginIndexGroup
+\begin{Declaration}
+ \File{visualize.lco}
+\end{Declaration}
+\BeginIndex{Option}{visualize}%
+If you develop your own \File{lco} file, for example to modify the positions
+of various fields on the letterhead page because your own desires or
+requirements, it is helpful if you can make at least some elements directly
+visible. The \File{lco} file
+\File{visualize.lco}\ChangedAt{v3.04}{\Class{scrlttr2}} exists for this
+purpose. You can load this file as you would any other \File{lco} file. But
+this \emph{letter class options} file must be loaded in the document preamble,
+and its effects cannot be deactivated. The \File{lco} file uses the
+\Package{eso-pic}\IndexPackage{eso-pic}%
+\important[i]{\Package{eso-pic}\\\Package{graphicx}} and
+\Package{graphicx}\IndexPackage{graphicx} packages, which are not part of
\KOMAScript.
\begin{Declaration}
\Macro{showfields}\Parameter{field list}
\end{Declaration}
-This command activates the visualization of note paper fields. Argument
-\PName{field list} is a comma separated list of fields that should be
-visualized. Following are the supported fields:
+This command makes the space occupied by the fields on the letterhead page
+visible. The \PName{field list} argument is a comma-separated list of fields
+to be shown. The following fields are supported:
\begin{labeling}[~--]{\PValue{location}}
-\item[\PValue{test}] is a test field of size 10\Unit{cm} by 15\Unit{cmd} with
- position 1\Unit{cm} down and right from the topmost and leftmost edges of
- the paper. This field exists for debugging purpose. It may be used as an
- measure comparison in the case, that the measures will be adulterated while
- printing.
-\item[\PValue{head}] is the header area of the note paper. This area has an
- open bottom.
-\item[\PValue{foot}] is the footer area of the note paper. This area has an
- open top.
+\item[\PValue{test}] is a 10\Unit{cm} by 15\Unit{cm} test field, 1\Unit{cm}
+ from the top and left edges of the paper. This field exists for debugging.
+ You can use it as a benchmark to check whether the measurements have been
+ distorted during the creation of the document.
+\item[\PValue{head}] is the header area of the letterhead page. This field
+ is open at the bottom.
+\item[\PValue{foot}] is the footer area of the letterhead page. This field is
+ open at the top.
\item[\PValue{address}] is the address window area used by window envelopes.
-\item[\PValue{location}] is the field of the sender's extension.
-\item[\PValue{refline}] is the business line. This are has an open bottom.
+\item[\PValue{location}] is the field for the extra sender information.
+\item[\PValue{refline}] is the reference line. This field is open at the
+ bottom.
\end{labeling}%
\BeginIndex{FontElement}{field}\LabelFontElement{field}%
-The color of the visualization may be changed using
-commands\DescRef{scrlttr2.cmd.setkomafont} und
-\DescRef{scrlttr2.cmd.addtokomafont} (see \autoref{sec:scrlttr2.textmarkup},
-\DescPageRef{scrlttr2.cmd.setkomafont}) with the element
-\FontElement{field}\important{\FontElement{field}}. Default is
+You can change the colour of the visualisation with
+the\DescRef{scrlttr2.cmd.setkomafont} and \DescRef{scrlttr2.cmd.addtokomafont}
+(see \autoref{sec:scrlttr2.textmarkup},
+\DescPageRef{scrlttr2.cmd.setkomafont}) commands using the
+\FontElement{field}\important{\FontElement{field}} element. The default is
\Macro{normalcolor}.%
\EndIndex{FontElement}{field}%
%
@@ -1518,20 +1439,21 @@ commands\DescRef{scrlttr2.cmd.setkomafont} und
\begin{Declaration}
- \Macro{setshowstyle}\Parameter{visualization style}%
+ \Macro{setshowstyle}\Parameter{style}%
\Macro{edgesize}
\end{Declaration}
-The default for the visualization of single areas are
-frames\important{\PValue{frame}} around the areas. Areas with open top or
-bottom are not framed completely but have an open edge with arrows at the end
-of the ending lines. Alternatively\important{\PValue{rule}} the
-\PName{visualization style} \PValue{rule} may be used. In this case a
-background color will be used to visualize the areas. This does not differ open
-and closed areas. Instead a minimal height will be used for open areas. The
-third\important{\PValue{edges}} available \PName{visualization style} is
-\PValue{edges}. This will mark the corners of the areas. The corner marks at
-the open edge of open areas will be omitted. The size of two edges of the
-corner marks are given by the macro \Macro{edgesize} with default 1\Unit{ex}.%
+By default, \File{visualize.lco} indicates the individual areas with
+frames\important{\PValue{frame}}, which corresponds to the \PName{style}
+\PValue{frame}. Areas open at top or bottom are not completely framed but have
+an open edge with with small arrows pointing up or down.
+Alternatively\important{\PValue{rule}}, you can use the \PName{style}
+\PValue{rule}. In this case, the area is highlighted by a background colour.
+It isnot possible to distinguish open and closed areas. Instead a minimal
+height will be used for open areas. The third\important{\PValue{edges}}
+available \PName{style} is \PValue{edges}, which shows the corners of the
+areas. The corner marks at the open edge of open areas will be omitted. The
+size of two edges of the corner marks are given by the \Macro{edgesize} macro
+with a default of 1\Unit{ex}.%
\EndIndexGroup
@@ -1544,60 +1466,55 @@ corner marks are given by the macro \Macro{edgesize} with default 1\Unit{ex}.%
\Macro{showUScheck}\OParameter{instructions}%
\Macro{unitfactor}
\end{Declaration}
-These commands may be used to output a graphics of an envelope. The envelope
-of the graphic will be rotated by 90\textdegree{} and printed in measure~1:1
-to one document page. The addressee window will be generated automatically
-using the current data of the address position of the note paper:
-\PLength{toaddrvpos}, \PLength{toaddrheight}, \PLength{toaddrwidth}, and
-\PLength{toaddrhpos}. For this the differences \PName{h-offset} and
-\PName{v-offset} of size of the folded letter sheet to the size of the
-envelope, \PName{width} and \PName{height}, will be needed. If both values,
-\PName{h-offset} and \PName{v-offset}, will be omitted using
-\Macro{showenvelope}, then these will be calculated from the folding marks and
-the paper size.
-
-Commands \Macro{showISOenvelope}, \Macro{showUScommercia}, and
-\Macro{showUScheck} base on \Macro{showenvelope}. With \Macro{showISOenvelope}
-ISO-envelopes with \PName{format} C4, C5, C5/6, DL (also known as C5/6) or C6
-may be generated. With \Macro{showUScommercial} an US-commercial envelope of
-\PName{format} 9 or 10 may be generated. \Macro{showUScheck} may be used for
-envelopes in format US-check.
-
-The \PName{instructions} may be used to print additional elements inside the
-envelope.
+If you have loaded \File{visualize.lco}, you can use these commands to output
+a page with a drawing of an envelope. The envelope drawing is always rotated
+by 90\textdegree{} on a separate page and printed in 1:1~scale. The addressee
+window is generated automatically from the current data for the address
+position of the letterhead page: \PLength{toaddrvpos}, \PLength{toaddrheight},
+\PLength{toaddrwidth}, and \PLength{toaddrhpos}. To do so requires knowing how
+much smaller the folded letter pages are than the width and height of the
+envelope. If you do not specify these two values, \PName{h-offset} and
+\PName{v-offset}, when calling \Macro{showenvelope}, they are calculated from
+the fold marks and the paper size itself.
+
+The \Macro{showISOenvelope}, \Macro{showUScommercial}, and \Macro{showUScheck}
+commands are based on \Macro{showenvelope}. With \Macro{showISOenvelope}, you
+can create ISO-envelopes in C4, C5, C5/6, DL (also known as C5/6) or C6
+\PName{format}. With \Macro{showUScommercial}, you can create a US commercial
+envelope in the 9 or 10 \PName{format}. You can use \Macro{showUScheck} for
+envelopes in US check format.
\BeginIndex{FontElement}{letter}\LabelFontElement{letter}%
-The position of the letter sheet will be signed with dash lines inside the
-envelope. The color of this dash lines may be changed using commands
-\DescRef{scrlttr2.cmd.setkomafont} und \DescRef{scrlttr2.cmd.addtokomafont}
+The position of the letterhead page inside the envelope is indicated with
+dashed lines. You can change the colour of these lines with the
+\DescRef{scrlttr2.cmd.setkomafont} and \DescRef{scrlttr2.cmd.addtokomafont}
(see \autoref{sec:scrlttr2.textmarkup},
-\DescPageRef{scrlttr2.cmd.setkomafont}) with element
-\FontElement{letter}\important{\FontElement{letter}}. Default is
+\DescPageRef{scrlttr2.cmd.setkomafont}) using the
+\FontElement{letter}\important{\FontElement{letter}} element. The default is
\Macro{normalcolor}.%
-%
\EndIndex{FontElement}{letter}%
\BeginIndex{FontElement}{measure}\LabelFontElement{measure}%
-The envelope will be dimensioned automatically. The color of the dimensioning
-may be changed using commands \DescRef{scrlttr2.cmd.setkomafont} und
-\DescRef{scrlttr2.cmd.addtokomafont} (see \autoref{sec:scrlttr2.textmarkup},
-\DescPageRef{scrlttr2.cmd.setkomafont}) with element
-\FontElement{measure}\important{\FontElement{measure}}. Default is
-\Macro{normalcolor} The dimensioning will be done in multiply of
-\Length{unitlength} with accuracy of $1/\Macro{unitfactor}$. Nevertheless
-accuracy of the \TeX{} arithmetic also limits the accuracy of
-dimensioning. Default is 1. The \Macro{unitfactor} may be changed using
-\Macro{renewcommand}.%
+The envelope drawing will be provided with dimensions automatically. You can
+change the colour of these dimension labels with the commands
+\DescRef{scrlttr2.cmd.setkomafont} and \DescRef{scrlttr2.cmd.addtokomafont}
+(see \autoref{sec:scrlttr2.textmarkup},
+\DescPageRef{scrlttr2.cmd.setkomafont}) using the
+\FontElement{measure}\important{\FontElement{measure}} element. The default is
+\Macro{normalcolor}. The dimensions are given in multiples of
+\Length{unitlength}, with an accuracy of $1/\Macro{unitfactor}$, where the
+accuracy of \TeX{} arithmetic is the actual limits. The default is 1. You can
+redefine \Macro{unitfactor} using \Macro{renewcommand}.%
\EndIndex{FontElement}{measure}%
\begin{Example}
- An example letter in format ISO-A4 will be produced. The supported fields
- should be visualized with yellow frame lines. Additionally the position of
- the window of an envelope with size DL should be checked with a
- graphics. The measure lines of the dimensioning should be red and the
- measure numbers should use a small font. The accuracy of the dimensioning
- should be 1\Unit{mm}. The dashed note paper sheet in the envelope should be
- colored green.
+ You are generating a sample letter using the ISO-A4 format. The supported
+ fields should be marked with yellow borders to check their position.
+ Furthermore, the position of the window for a DL-size envelope should be
+ checked with drawing. The dimension lines in this drawing should be red, and
+ the numbers should use a smaller font, with the dimensions printed in cm
+ with an accuracy of 1\Unit{mm}. The dashed letterhead page in the envelope
+ should be coloured green.
\begin{lstcode}
\documentclass[visualize]{scrlttr2}
\usepackage{xcolor}
@@ -1605,16 +1522,17 @@ dimensioning. Default is 1. The \Macro{unitfactor} may be changed using
\setkomafont{measure}{\color{red}\small}
\setkomafont{letter}{\color{green}}
\showfields{head,address,location,refline,foot}
- \usepackage[ngerman]{babel}
+ \usepackage[british]{babel}
\usepackage{lipsum}
\begin{document}
- \setkomavar{fromname}{Peter Musterfrau}
- \setkomavar{fromaddress}{Hinter dem Tal 2\\
- 54321 Musterheim}
+ \setkomavar{fromname}{Joe Public}
+ \setkomavar{fromaddress}{2 Valley\\
+ SAMPLEBY\\
+ ZY32 1XW}
\begin{letter}{%
- Joana Public\\
- Hillside 1\\
- 12345 Public City%
+ 1 Hillside\\
+ SAMPLESTEAD\\
+ WX12 3YZ%
}
\opening{Hello,}
\lipsum[1]
@@ -1625,14 +1543,14 @@ dimensioning. Default is 1. The \Macro{unitfactor} may be changed using
\showISOenvelope{DL}
\end{document}
\end{lstcode}
- This will show the note paper on the first and the envelope graphic on the
- second document page.
+ This will show the letterhead page as the first page and the drawing of the
+ envelope on the second page.
\end{Example}
-Please note, that inauspicious combinations of \Length{unitlength} and
-\Macro{unitfactor} may provoke \TeX{} errors like \emph{arithmetic overflow}
-very soon. Also shown measure numbers may differ a little bit from the real
-value. Both are not mistakes of \Option{visualize} but simple implementation
+Note that poorly chosen combinations of \Length{unitlength} and
+\Macro{unitfactor} can quickly lead to a \TeX{} \emph{arithmetic overflow}
+error. The dimension numbers shown may also differ slightly from the actual
+values. Neither are errors in \Option{visualize} but merely implementation
limitations of \TeX.
%
\EndIndexGroup
@@ -1645,161 +1563,87 @@ limitations of \TeX.
\section{Language Support}
\seclabel{languages}%
\BeginIndexGroup
-\BeginIndex{}{language}%
-
-The document class \Class{scrlttr2} supports many languages. These include
-German\Index{language>German} (\PValue{german} for old German orthography,
-\PValue{ngerman} for the new orthography, \PValue{austrian} for Austrian with
-old German orthography, and
-\PValue{naustrian}\ChangedAt{v3.09}{\Class{scrlttr2}} for Austrian with new
-orthography), English\Index{language>English} (\PValue{english} without
-specification as to whether American or British should be used,
-\PValue{american} and \PValue{USenglish} for American, and \PValue{british}
-and \PValue{UKenglish} for British), French\Index{language>French},
-Italian\Index{language>Italian}, Spanish\Index{language>Spanish},
-Dutch\Index{language>Dutch}, Croatian\Index{language>Croatian},
-Finnish\Index{language>Finnish},
-Norsk\Index{language>Norsk}\ChangedAt{v3.02}{\Class{scrlttr2}}, and
-Swedish\Index{language>Swedish}\ChangedAt{v3.08}{\Class{scrlttr2}}.
-
-If the package \Package{babel}\IndexPackage{babel} (see
-\cite{package:babel}) is used, one can switch between languages with
-the command \Macro{selectlanguage}\Parameter{language}. Other
-packages like \Package{german}\IndexPackage{german} (see
-\cite{package:german}) and \Package{ngerman}\IndexPackage{ngerman}
-(see \cite{package:ngerman}) also define this command. As a rule
-though, the language selection takes place already as a direct
-consequence of loading such a package.
+\BeginIndex{}{languages}%
+
+The \Class{scrlttr2} class and the \Package{scrletter} package support many
+languages. These include German\Index{language>German} (\PValue{german} for
+the old German orthography, \PValue{ngerman} for the new orthography;
+\PValue{austrian} for Austrian with the old German orthography,
+\PValue{naustrian}\ChangedAt{v3.09}{\Class{scrlttr2}} for Austrian with the
+new orthography; and \PValue{nswissgerman}\ChangedAt{v3.13}{\Class{scrlttr2}}
+for Swiss German with the new orthogrphy, \PValue{swissgerman} for Swiss
+German with the old orthography), English\Index{language>English} (among
+others, \PValue{english} without specification as to whether American or
+British should be used, \PValue{american} and \PValue{USenglish} for American
+English, and \PValue{british} and \PValue{UKenglish} for British English),
+French\Index{language>French}, Italian\Index{language>Italian},
+Spanish\Index{language>Spanish}, Dutch\Index{language>Dutch},
+Croatian\Index{language>Croatian}, Finnish\Index{language>Finnish},
+Norwegian\Index{language>Norwegian}\ChangedAt{v3.02}{\Class{scrlttr2}},
+Swedish\Index{language>Swedish}\ChangedAt{v3.08}{\Class{scrlttr2}},
+Polish\ChangedAt{v3.13}{\Class{scrlttr2}},
+Czech\ChangedAt{v3.13}{\Class{scrlttr2}}, and Slovak.
+
+You can switch languages using the \Package{babel}\IndexPackage{babel} package
+(see \cite{package:babel}) with the \Macro{selectlanguage}\Parameter{language}
+command. Other packages like \Package{german}\IndexPackage{german} (see
+\cite{package:german}) and \Package{ngerman}\IndexPackage{ngerman} (see
+\cite{package:ngerman}) also define this command. As a rule though, the
+language selection occurs immediately as a direct consequence of loading such
+a package.
\iffalse% Umbruchkorrekturtext
-Further information can be obtained in the documentation of the relevant
-packages.
+For details, please refer to the documentation of the relevant packages.
\fi
-There\textnote{Attention!} is one thing more to mention about language
-packages. The package
-\Package{french}\IndexPackage{french}\important{\Package{french}} (see
-\cite{package:french}) redefines not only the terms of
-\autoref{tab:scrlttr2-experts.languageTerms}, but also other, for instance
-some versions of that package even redefine the command
-\DescRef{scrlttr2.cmd.opening}, since the package assumes that the definition
-of the standard \Class{letter} is used. With \Class{scrlttr2} this is not the
-case, therefore the package \Package{french} destroys the definition in
-\Class{scrlttr2} and does not work correctly with \KOMAScript. The author
-views this is a fault in the \Package{french} package.
-
-If one utilizes the \Package{babel}\IndexPackage{babel} package in order to
-switch to language \PValue{french} while the package
-\Package{french}\IndexPackage{french} is simultaneously installed, then the
-same problems may likely occur, since \Package{babel} employs definitions
-from the \Package{french} package.
-%
-\iffalse% Umbruchergaenzungstext
-If the package \Package{french} is not
-installed then there are no problems. Aimilarly, there is no problem if for
-\Package{babel} instead of \PValue{french} other languages like
-\PValue{acadian}, \PValue{canadien}, \PValue{francais} or \PValue{frenchb} are
-chosen.
+There\textnote{Attention!} is one more point to note about language-switching
+packages. The
+\Package{french}\IndexPackage{french}\important{\Package{french}} package (see
+\cite{package:french}) makes changes well beyond redefining the terms in
+\autoref{tab:scrlttr2-experts.languageTerms}. For instance, it redefines the
+\DescRef{scrlttr2.cmd.opening} command, since the package simply assumes that
+\DescRef{scrlttr2.cmd.opening} is always defined as it is in the standard
+\Class{letter} class. This, however, is not the case with \KOMAScript{}. The
+\Package{french} package thus overwrites the definition and does not work
+correctly with \KOMAScript. I regard this as a fault in the \Package{french}
+package which, although reported decades ago, was unfortunately never
+eliminated.
+
+If you use the \Package{babel}\IndexPackage{babel} package to switch to
+\PValue{french}, problems can occasionally occur. With \Package{babel},
+however, you can usually deactivate changes to a language in a targeted
+manner.%
+\iffalse% This is actually outdated!
+\ If the package \Package{french} is not installed, the problem with
+ \Package{babel} does not arise. Similarly, the problem usually does not
+ exist when you use \Package{babel} with other varieties of French such as
+ \PValue{acadian}, \PValue{canadien}, \PValue{francais} or \PValue{frenchb}
+ instead of \PValue{french}.
\fi
-From \Package{babel} version 3.7j this problem only occurs when it is
-indicated explicitly by means of an option that \Package{babel} should use the
-\Package{french} package. If it cannot be ascertained that a new version of
-\Package{babel} is being used, it is recommended to use
+\iffalse% This is also outdated!
+ However, with \Package{babel} version 3.7j and above, this problem only occurs
+ if the option explicitly indicates that \Package{babel} should use the
+ \Package{french} package.
+%
+\iftrue
+ If you cannot be sure you are not using an old version of \Package{babel}, I
+ recommend you use
\begin{lstcode}
\usepackage[...,frenchb,...]{babel}
\end{lstcode}
-in order to select french.
-
-Other languages can possibly cause similar problems. Currently there
-are no known problems with the \Package{babel} package for the
-german language and the various english language selections.
-
-\begin{Declaration}
- \Macro{captionsenglish}%
- \Macro{captionsUSenglish}%
- \Macro{captionsamerican}%
- \Macro{captionsbritish}%
- \Macro{captionsUKenglish}%
- \Macro{captionsgerman}%
- \Macro{captionsngerman}%
- \Macro{captionsaustrian}%
- \Macro{captionsnaustrian}%
- \Macro{captionsfrench}%
- \Macro{captionsitalian}%
- \Macro{captionsspanish}%
- \Macro{captionsdutch}%
- \Macro{captionscroatian}%
- \Macro{captionsfinnish}%
- \Macro{captionsnorsk}%
- \Macro{captionsswedish}
-\end{Declaration}
-If one switches the language of a letter then
-using these commands the language-dependent terms from
-\autoref{tab:scrlttr2-experts.languageTerms},
-\autopageref{tab:scrlttr2-experts.languageTerms} are redefined. If the used
-language selection scheme does not support this then the commands
-above can be used directly.
-%
-\EndIndexGroup
-
-
-\begin{Declaration}
- \Macro{dateenglish}%
- \Macro{dateUSenglish}%
- \Macro{dateamerican}%
- \Macro{datebritish}%
- \Macro{dateUKenglish}%
- \Macro{dategerman}%
- \Macro{datengerman}%
- \Macro{dateaustrian}%
- \Macro{datenaustrian}%
- \Macro{datefrench}%
- \Macro{dateitalian}%
- \Macro{datespanish}%
- \Macro{datedutch}%
- \Macro{datecroatian}%
- \Macro{datefinnish}%
- \Macro{datenorsk}%
- \Macro{dateswedish}
-\end{Declaration}
-The numerical representation of the date\Index{date} (see option
-\DescRef{scrlttr2.option.numericaldate} in \autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.numericaldate}) will be written depending on the
-selected language. Some examples can be found in \autoref{tab:date}.%
-%
-\begin{table}
-% \centering
- \KOMAoptions{captions=topbeside}%
- \setcapindent{0pt}%
-% \caption
- \begin{captionbeside}{Language-dependent forms of the date}[l]
- \begin{tabular}[t]{ll}
- \toprule
- Command & Date example \\
- \midrule
- \Macro{dateenglish} & 24/12/1993\\
- \Macro{dateUSenglish} & 12/24/1993\\
- \Macro{dateamerican} & 12/24/1993\\
- \Macro{datebritish} & 24/12/1993\\
- \Macro{dateUKenglish} & 24/12/1993\\
- \Macro{dategerman} & 24.\,12.\,1993\\
- \Macro{datengerman} & 24.\,12.\,1993\\
- \Macro{dateaustrian} & 24.\,12.\,1993\\
- \Macro{datefrench} & 24.\,12.\,1993\\
- \Macro{dateitalian} & 24.\,12.\,1993\\
- \Macro{datespanish} & 24.\,12.\,1993\\
- \Macro{datedutch} & 24.\,12.\,1993\\
- \Macro{datecroatian} & 24.\,12.\,1993.\\
- \Macro{datefinnish } & 24.12.1993.\\
- \Macro{datenorsk} & 24.12.1993\\
- \Macro{dateswedish} & 24/12 1993\\
- \bottomrule
- \end{tabular}
- \end{captionbeside}
- \label{tab:date}
-\end{table}
-%
-\EndIndexGroup
+ to select French.
+ \iffalse %
+ If necessary, you can still switch to French with
+ \Macro{selectlanguage}\PParameter{french}.%
+ \fi%
+\fi
+\fi
+
+\iftrue
+ It cannot be ruled out that similar problems will not occur with other
+ languages or packages. For German and English, however, there are currently
+ no known problems with the \Package{babel} package.
+\fi
\begin{Declaration}
@@ -1822,30 +1666,67 @@ selected language. Some examples can be found in \autoref{tab:date}.%
\Macro{wwwname}%
\Macro{bankname}
\end{Declaration}
-The commands contain the language-dependent terms. These definitions can be
-modified in order to support a new language or for private customization.
-How\important[i]{%
+These commands contain the language-dependent terms. These\important[i]{%
\DescRef{scrbase.cmd.newcaptionname}\\
\DescRef{scrbase.cmd.renewcaptionname}\\
- \DescRef{scrbase.cmd.providecaptionname}} this can be done is described in
-\autoref{sec:scrbase.languageSupport}. The definitions become active only at
-\Macro{begin}\PParameter{document}. Therefore they are not available in the
-{\LaTeX} preamble and cannot be redefined there. In
-\autoref{tab:scrlttr2-experts.languageTerms} the default settings for
-\Option{english} and \Option{ngerman} can be found.%
+ \DescRef{scrbase.cmd.providecaptionname}} definitions can be
+modified to support a new language or for your private customization, as
+described in
+\autoref{sec:scrbase.languageSupport}. \KOMAScript{} sets these terms only in
+\Macro{begin}\PParameter{document}. Therefore they are not available in the
+preamble and cannot be redefined there. The default settings for
+\Option{english} and \Option{ngerman} are listed in
+\autoref{tab:scrlttr2-experts.languageTerms}.%
+\EndIndexGroup
+%\iffree{}{\clearpage}% Siehe Kommentar zur Tabelle
+
+\begin{Declaration}
+ \Macro{captionsacadian}
+ \Macro{captionsamerican}
+ \Macro{captionsaustralien}
+ \Macro{captionsaustrian}
+ \Macro{captionsbritish}
+ \Macro{captionscanadian}
+ \Macro{captionscanadien}
+ \Macro{captionscroatian}
+ \Macro{captionsczech}
+ \Macro{captionsdutch}
+ \Macro{captionsenglish}
+ \Macro{captionsfinnish}
+ \Macro{captionsfrancais}
+ \Macro{captionsfrench}
+ \Macro{captionsgerman}
+ \Macro{captionsitalian}
+ \Macro{captionsnaustrian}
+ \Macro{captionsnewzealand}
+ \Macro{captionsngerman}
+ \Macro{captionsnorsk}
+ \Macro{captionsnswissgerman}
+ \Macro{captionspolish}
+ \Macro{captionsslovak}
+ \Macro{captionsspanish}
+ \Macro{captionsswedish}
+ \Macro{captionsswissgerman}
+ \Macro{captionsUKenglish}
+ \Macro{captionsUSenglish}
+\end{Declaration}
+If you change the language of a letter, the language-dependent terms listed in
+\autoref{tab:scrlttr2-experts.languageTerms},
+\autopageref{tab:scrlttr2-experts.languageTerms} are redefined using these
+commands. If your language-switching package does not support this, you can
+also use the above commands directly.
%
\begin{table}
\begin{minipage}{\textwidth}
-% \centering
- \KOMAoptions{captions=topbeside}%
- \setcapindent{0pt}%
- %\caption
- \begin{captionbeside}[{%
- Default settings for language-dependent terms
+ \centering
+% \KOMAoptions{captions=topbeside}%
+% \setcapindent{0pt}%
+ \caption[{%
+ Defaults for language-dependent terms
}]{%
- Default settings for language-dependent terms using languages
- \Option{english} and \Option{ngerman}, as long as language selection
- packages have not been used%
+ Defaults for language-dependent terms for the languages
+ \Option{english} and \Option{ngerman}, if they are not already defined
+ by the packages used for language switching%
\label{tab:scrlttr2-experts.languageTerms}%
}[l]
\begin{tabular}[t]{lll}
@@ -1874,45 +1755,127 @@ How\important[i]{%
\end{tabular}
\deffootnote{1em}{1em}{1\ }% brutal aber effektiv
\footnotetext[1000]{Normally these terms are defined by language
- packages like \Package{babel}. In this case they are not redefined by
- \Class{scrlttr2} and may differ from the table above.}
- \end{captionbeside}
+ packages like \Package{babel}. In this case, \KOMAScript{} does not
+ redefine them. The actual wording may therefore differ and can
+ be found in the documentation for the language package used.}
+% \end{captionbeside}
\end{minipage}
\end{table}
%
\EndIndexGroup
+\iffree{}{\clearpage}% Umbruchkorrektur
+
+\begin{Declaration}
+ \Macro{dateacadian}
+ \Macro{dateamerican}
+ \Macro{dateaustralien}
+ \Macro{dateaustrian}
+ \Macro{datebritish}
+ \Macro{datecanadian}
+ \Macro{datecanadien}
+ \Macro{datecroatian}
+ \Macro{dateczech}
+ \Macro{datedutch}
+ \Macro{dateenglish}
+ \Macro{datefinnish}
+ \Macro{datefrancais}
+ \Macro{datefrench}
+ \Macro{dategerman}
+ \Macro{dateitalian}
+ \Macro{datenaustrian}
+ \Macro{datenewzealand}
+ \Macro{datengerman}
+ \Macro{datenorsk}
+ \Macro{datenswissgerman}
+ \Macro{datepolish}
+ \Macro{dateslovak}
+ \Macro{datespanish}
+ \Macro{dateswedish}
+ \Macro{dateswissgerman}
+ \Macro{dateUKenglish}
+ \Macro{dateUSenglish}
+\end{Declaration}
+Depending on the language used, the numerical representation of the date\Index{date} (see option
+\DescRef{scrlttr2.option.numericaldate} in \autoref{sec:scrlttr2.firstpage},
+\DescPageRef{scrlttr2.option.numericaldate}) is formatted in various ways.
+The exact format can be found in \autoref{tab:date}.%
+\EndIndexGroup
%
\EndIndexGroup
+\iffree{}{\clearpage}% Umbruchkorrektur zwecks Ausgabe der Tabellen
+\begin{table}[!tp]% Umbruchoptimierung
+% \centering
+ \KOMAoptions{captions=topbeside}%
+ \setcapindent{0pt}%
+% \caption
+ \begin{captionbeside}{Language-dependent Forms of the Date}[l]
+ \begin{tabular}[t]{ll}
+ \toprule
+ Command & Date Example \\
+ \midrule
+ \Macro{dateacadian} & 24.\,12.\,1993\\
+ \Macro{dateamerican} & 12/24/1993\\
+ \Macro{dateaustralien}& 24/12/1993\\
+ \Macro{dateaustrian} & 24.\,12.\,1993\\
+ \Macro{datebritish} & 24/12/1993\\
+ \Macro{datecanadian} & 1993/12/24\\
+ \Macro{datecanadien} & 1993/12/24\\
+ \Macro{datecroatian} & 24.\,12.\,1993.\\
+ \Macro{dateczech} & 24.\,12.\,1993\\
+ \Macro{datedutch} & 24.\,12.\,1993\\
+ \Macro{dateenglish} & 24/12/1993\\
+ \Macro{datefinnish } & 24.12.1993.\\
+ \Macro{datefrancais} & 24.\,12.\,1993\\
+ \Macro{datefrench} & 24.\,12.\,1993\\
+ \Macro{dategerman} & 24.\,12.\,1993\\
+ \Macro{dateitalian} & 24.\,12.\,1993\\
+ \Macro{datenaustrian} & 24.\,12.\,1993\\
+ \Macro{datenewzealand}& 24/12/1993\\
+ \Macro{datengerman} & 24.\,12.\,1993\\
+ \Macro{datenorsk} & 24.12.1993\\
+ \Macro{datenswissgerman} & 24.\,12.\,1993\\
+ \Macro{datepolish} & 24.\,12.\,1993\\
+ \Macro{dateslovak} & 24.\,12.\,1993\\
+ \Macro{datespanish} & 24.\,12.\,1993\\
+ \Macro{dateswedish} & 24/12 1993\\
+ \Macro{dateswissgerman} & 24.\,12.\,1993\\
+ \Macro{dateUKenglish} & 24/12/1993\\
+ \Macro{dateUSenglish} & 12/24/1993\\
+ \bottomrule
+ \end{tabular}
+ \end{captionbeside}
+ \label{tab:date}
+\end{table}
+%
+\section{Obsolete Commands in \Class{scrlttr2}}
+\seclabel{obsolete}
+\BeginIndexGroup
+
+\LoadNonFree{scrlttr2-experts}{1}
+\EndIndexGroup
+%
+\iffalse% Es wird Zeit das komplett rauszuwerfen!
\section{From Obsolete \Class{scrlettr} to Current \Class{scrlttr2}}
\seclabel{fromscrlettr}
-With\textnote{Attention!} the June 2002 release of \Class{scrlttr2} (see
-\autoref{cha:scrlttr2}) the old letter class \Class{scrlettr} became
-obsolete. It is recommended not to use that class for new applications. There
-is no more active development of the old letter class, and support is very
-restricted. However, if you really need the documentation of the old letter
-class, you can still find it in the file \File{scrlettr.dtx}, but only in
-German. You should run it through {\LaTeX} several times, like this:
-\begin{lstoutput}[morekeywords={latex,mkindex}]
- latex scrlettr.dtx
- mkindex scrlettr
- latex scrlettr.dtx
- mkindex scrlettr
- latex scrlettr.dtx
-\end{lstoutput}
-Then you obtain the file \File{scrlettr.dvi} containing the old German
-manual. If you want \File{scrlettr.pdf} instead of \File{scrlettr.dvi} you
-should use \File{pdflatex} instead of \File{latex}.
+With\textnote{Attention!} the 2002 release of \Class{scrlttr2} (see
+\autoref{cha:scrlttr2}), the old letter class, \Class{scrlettr}, became
+obsolete, and it is no longer part of \KOMAScript. If you still need the class
+or information about it, you will find it in
+\cite{package:koma-script-obsolete}.
To facilitate the transition to the new class, there is the compatibility
-option \Option{KOMAold}. In general, the complete older functionality still
-remains in the new class. Without \Option{KOMAold}, the user
-interface and the defaults will be different. More details on
+option \Option{KOMAold}. Basically, all the older functionality still
+exists in the new class. Without \Option{KOMAold}, however, the user
+interface and the defaults are different. More details on
this option are provided in \autoref{sec:scrlttr2.lcoFile},
\autoref{tab:lcoFiles}.
-\LoadNonFree{scrlttr2-experts}{0}
+\LoadNonFree{scrlttr2-experts}{2}
+%
+\EndIndexGroup
+\fi
%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex
index ef26c720cab..ff758441c91 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlttr2.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlttr2.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,36 +46,56 @@
% ============================================================================
\KOMAProvidesFile{scrlttr2.tex}%
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (chapter: scrlttr2)]
\translator{Harald Bongartz\and Georg Grandke\and Raimund Kohl\and Jens-Uwe
- Morawski\and Stephan Hennig\and Gernot Hassenpflug\and Markus Kohm}
+ Morawski\and Stephan Hennig\and Gernot Hassenpflug\and Markus Kohm\and
+ Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-02-13
-\chapter{The New Letter Class \Class{scrlttr2}}
+\chapter{Letters with the \Class{scrlttr2} Class or the \Package{scrletter}
+ Package}
\labelbase{scrlttr2}
-\BeginIndexGroup%
-\BeginIndex{Class}{scrlttr2}%
-\BeginIndex{}{letters}%
-\iffalse
- Since the June 2002 release {\KOMAScript} provides a completely
- rewritten letter class\ChangedAt{v2.8q}{\Class{scrlttr2}}. Although
- part of the code is identical to that of the main classes described
- in \autoref{cha:maincls}, letters
-\else
- Letters
-\fi
-are quite different from articles,
-reports, books, and suchlike. That alone justifies a separate
-chapter about the letter class. But there is another reason for a
-chapter on \Class{scrlttr2}. This class has been redeveloped from
-scratch and provides a new user interface different from every other
-class the author knows of. This new user interface may be uncommon,
-but the author is convinced both experienced and new {\KOMAScript}
-users will benefit from its advantages.
+\BeginIndexGroup
+\BeginIndex{Class}{scrlttr2}\BeginIndex{Package}{scrletter}%
+\BeginIndex{}{letters}%
+Letters are quite different in many ways from articles, reports, books, and
+the like. That alone justifies a separate chapter on letters. But there are
+other reasons for a separate chapter on \Class{scrlttr2} and
+\Package{scrletter}.
+
+The \Class{scrlttr2}\important{\Class{scrlttr2}} class was developed from
+scratch in 2002. It provides a completely new user interface, different from
+every other class I know. This new user interface may be unusual, but it
+offers benefits to both new and experienced {\KOMAScript} users.
+
+The \Package{scrletter}\important{\Package{scrletter}}%
+\ChangedAt{v3.15}{\Package{scrletter}} package has supplemented \KOMAScript{}
+since Version~3.15. It also provides all the letter-based functionality of
+\Class{scrlttr2} to the other classes. I recommend you use one of the
+\KOMAScript{} classes\,---\,\Class{scrbook}, \Class{scrreprt} or
+\Class{scrartcl}\,---\, which are explained in the previous chapter. With
+minor limitations, \Package{scrletter} also works well with the standard
+classes.
+
+The starting point for developing \Package{scrletter} was, on the one hand,
+requests from users who also wanted to have elements such as
+section\textnote{headings, floating environments, indexes} headings, floating
+environments, or a bibliography in letters. On the other hand, there were also
+requests to use \Class{scrlttr2} variables in the remaining \KOMAScript{}
+classes. You can achieve both by combining the desired \KOMAScript{} class
+with \Package{scrletter}.
+
+Compared to the letter class, the letter package has a few small changes that
+were necessary to avoid conflicts with other classes. These changes mainly
+affect the page styles and are explicitly documented (see
+\autoref{sec:\LabelBase.pagestyle}, starting at
+\autopageref{sec:\LabelBase.pagestyle}). Where \Package{scrletter} is not
+explicitly mentioned, everything that is documented for \Class{scrlttr2}
+applies without change.
\section{Variables}
@@ -83,41 +103,39 @@ users will benefit from its advantages.
\BeginIndexGroup
\BeginIndex{}{variables}
-Apart from options, commands, environments, counters and lengths,
-additional elements have already been introduced in \KOMAScript. A
-typical property of an element is the font style and the option to
-change it (see \autoref{sec:\LabelBase.textmarkup},
-\DescPageRef{\LabelBase.cmd.setkomafont}). At this point we now
-introduce variables. Variables have a name by which they are called,
-and they have a content. The content of a variable can be set
-independently from time and location of the actual usage in the same
-way as the contents of a command can be separated from its usage. The
-main difference between a command and a variable is that a command
-usually triggers an action, whereas a variable only consists of plain
-text which is then output by a command. Furthermore, a variable can
-additionally have a description which can be set and output.
-
-This section specifically only gives an introduction to the concept of
-variables. The following examples have no special meaning. More
-detailed examples can be found in the explanation of predefined
-variables of the letter class in the following sections. An overview
-of all variables is given in \autoref{tab:\LabelBase.variables}.
+In addition to options, commands, environments, counters, and lengths,
+\autoref{cha:maincls} introduced the concept of additional elements for
+\KOMAScript{}. A typical property of an element is its font style and the
+ability to change it (see \autoref{sec:\LabelBase.textmarkup},
+\DescPageRef{\LabelBase.cmd.setkomafont}). In this section we introduce
+variables. Variables can have a label used to identify them when they are
+output in the document as well as their actual content. To avoid confusion
+with labels used for cross-references, this guide refers to such labels as the
+``description'' of the variable. The content of a variable can be set
+independently of the time and place it is used the same way that the content
+of a command can be defined separately from its use. The main difference
+between a command and a variable is that a command usually triggers an action,
+whereas a variable usually consists of plain text which is then output by a
+command. In addition, a variable can also have a description which can be
+customised and output.
+
+This section deliberately confines itself to introducing the concept of
+variables. The examples below have no special meaning. More detailed
+examples can be found in the explanation of predefined variables used in the
+class and the package. An overview of all defined variables is given in
+\autoref{tab:\LabelBase.variables}.
%
\begin{desclist}
- % Umbruchkorrektur
- \renewcommand*{\abovecaptionskipcorrection}{-\normalbaselineskip}%
- \desccaption{%
- Alphabetical list of all supported variables in
- \Class{scrlttr2}\label{tab:\LabelBase.variables}%
- }{%
- Alphabetical list of all supported variables in \Class{scrlttr2}
- (\emph{continuation})%
- }%
+ %\renewcommand*{\abovecaptionskipcorrection}{-\normalbaselineskip}%
+ \desccaption{Supported variables in \Class{scrlttr2} and
+ \Package{scrletter}\label{tab:\LabelBase.variables}}%
+ {Supported variables in \Class{scrlttr2} and \Package{scrletter}
+ (\emph{continued})}%
\ventry{addresseeimage}{%
- instuctions, that will be used to print the Port-Pay\'e head of option
- \OptionValueRef{\LabelBase}{addrfield}{backgroundimage} or the Port-Pay\'e
- addressee of option \OptionValueRef{\LabelBase}{addrfield}{image} %
- (\autoref{sec:\LabelBase.firstpage},
+ commands used to print the postpaid postmark for the
+ \OptionValueRef{\LabelBase}{addrfield}{backgroundimage} option or the
+ postpaid address for the \OptionValueRef{\LabelBase}{addrfield}{image}
+ option (\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.addresseeimage})}%
\ventry{backaddress}{%
return address for window envelopes %
@@ -128,8 +146,8 @@ of all variables is given in \autoref{tab:\LabelBase.variables}.
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.backaddressseparator})}%
\ventry{ccseparator}{%
- separator between title of additional addressees, and additional
- addressees %
+ separator between title of additional addresses (cc list)
+ and additional addresses %
(\autoref{sec:\LabelBase.document},
\DescPageRef{\LabelBase.variable.ccseparator})}%
\ventry{customer}{%
@@ -141,23 +159,23 @@ of all variables is given in \autoref{tab:\LabelBase.variables}.
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.date})}%
\ventry{emailseparator}{%
- separator between e-mail name and e-mail address %
+ separator between email name and email address %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.emailseparator})}%
\ventry{enclseparator}{%
- separator between title of enclosure, and enclosures %
+ separator between title of enclosure and enclosures %
(\autoref{sec:\LabelBase.document},
\DescPageRef{\LabelBase.variable.enclseparator})}%
\ventry{faxseparator}{%
- separator between title of fax, and fax number %
+ separator between title of fax and fax number %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.faxseparator})}%
\ventry{firstfoot}{%
- page\ChangedAt{v3.08}{\Class{scrlttr2}} foot of the note paper %
+ footer\ChangedAt{v3.08}{\Class{scrlttr2}} of the letterhead page %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.firstfoot})}%
\ventry{firsthead}{%
- page\ChangedAt{v3.08}{\Class{scrlttr2}} head of the note paper %
+ header\ChangedAt{v3.08}{\Class{scrlttr2}} of the letterhead page %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.firsthead})}%
\ventry{fromaddress}{%
@@ -165,7 +183,7 @@ of all variables is given in \autoref{tab:\LabelBase.variables}.
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.fromaddress})}%
\ventry{frombank}{%
- sender's bank account %
+ sender's bank details %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.frombank})}%
\ventry{fromemail}{%
@@ -194,12 +212,12 @@ of all variables is given in \autoref{tab:\LabelBase.variables}.
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.fromphone})}%
\ventry{fromurl}{%
- a URL of the sender, e.\,g., the URL of his homepage %
+ URL of the sender, e.\,g. of the sender's homepage %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.fromurl})}%
\ventry{fromzipcode}{%
- zip code or postcode of the sender used at the Port-Pay\'e head of option
- \OptionValueRef{\LabelBase}{addrfield}{PP} %
+ ZIP code (postal code) of the sender for the postpaid postmark of the
+ \OptionValueRef{\LabelBase}{addrfield}{PP} option %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.fromzipcode})}%
\ventry{invoice}{%
@@ -207,7 +225,7 @@ of all variables is given in \autoref{tab:\LabelBase.variables}.
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.invoice})}%
\ventry{location}{%
- more details of the sender %
+ extra details of the sender %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.location})}%
\ventry{myref}{%
@@ -215,13 +233,13 @@ of all variables is given in \autoref{tab:\LabelBase.variables}.
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.myref})}%
\ventry{nextfoot}{%
- page\ChangedAt{v3.08}{\Class{scrlttr2}} foot using page style
+ footer\ChangedAt{v3.08}{\Class{scrlttr2}} using page style
\PageStyle{headings}\IndexPagestyle{headings} or
\PageStyle{myheadings}\IndexPagestyle{myheadings} %
(\autoref{sec:\LabelBase.pagestyle},
\DescPageRef{\LabelBase.variable.nextfoot})}%
\ventry{nexthead}{%
- page\ChangedAt{v3.08}{\Class{scrlttr2}} head using page style
+ header\ChangedAt{v3.08}{\Class{scrlttr2}} using page style
\PageStyle{headings}\IndexPagestyle{headings} or
\PageStyle{myheadings}\IndexPagestyle{myheadings} %
(\autoref{sec:\LabelBase.pagestyle},
@@ -231,29 +249,29 @@ of all variables is given in \autoref{tab:\LabelBase.variables}.
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.phoneseparator})}%
\ventry{place}{%
- sender's place used near date %
+ sender's location; used next to date %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.place})}%
\ventry{placeseparator}{%
- separator between place and date %
+ separator between location and date %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.placeseparator})}%
\ventry{PPdatamatrix}{%
- instruction, that print the data array of option
- \OptionValueRef{\LabelBase}{addrfield}{PP} %
+ command to print the data array for the
+ \OptionValueRef{\LabelBase}{addrfield}{PP} option %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.PPdatamatrix})}%
\ventry{PPcode}{%
- instructions for the sender's identification code of option
- \OptionValueRef{\LabelBase}{addrfield}{PP} %
+ commands for the sender's identification code for the
+ \OptionValueRef{\LabelBase}{addrfield}{PP} option %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.PPcode})}%
\ventry{signature}{%
- signature beneath the ending of the letter %
+ signature annotation beneath the closing text of the letter %
(\autoref{sec:\LabelBase.closing},
\DescPageRef{\LabelBase.variable.signature})}%
\ventry{specialmail}{%
- mode of dispatch %
+ delivery method %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.specialmail})}%
\ventry{subject}{%
@@ -261,7 +279,7 @@ of all variables is given in \autoref{tab:\LabelBase.variables}.
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.subject})}%
\ventry{subjectseparator}{%
- separator between title of subject and subject %
+ separator between subject title and subject %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.subjectseparator})}%
\ventry{title}{%
@@ -269,23 +287,23 @@ of all variables is given in \autoref{tab:\LabelBase.variables}.
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.title})}%
\ventry{toaddress}{%
- address of addressee without addressee name %
+ address of recipient without recipient name %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.toaddress})}%
\ventry{toname}{%
- complete name of addressee %
+ complete name of recipient %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.toname})}%
\ventry{yourmail}{%
- date of addressee's referenced mail %
+ date of recipient's referenced mail %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.yourmail})}%
\ventry{yourref}{%
- addressee's reference %
+ recipient's reference %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.yourref})}%
\ventry{zipcodeseparator}{%
- separator between the zip code's or postcode's title and the code itself %
+ separator between the title of ZIP code (postal code) and the code itself %
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.zipcodeseparator})}%
\end{desclist}
@@ -295,44 +313,44 @@ of all variables is given in \autoref{tab:\LabelBase.variables}.
\Parameter{name}\OParameter{description}\Parameter{content}%
\Macro{setkomavar*}\Parameter{name}\Parameter{description}
\end{Declaration}
-With the command \Macro{setkomavar} you determine the
-\PName{content} of the variable \PName{name}. Using an optional
-argument you can at the same time change the \PName{description}
-of the variable. In contrast, \Macro{setkomavar*} can only set the
-\PName{description} of the variable \PName{name}.
-% Wir haben hier ein anderes Beispiel als in der deutschen Anleitung, aber das
-% passt hier sehr gut so!
+The \Macro{setkomavar} command sets the \PName{content} of the \PName{name}
+variable. Using the optional argument, you can change the \PName{description}
+of the variable at the same time. In contrast, \Macro{setkomavar*} sets only
+the \PName{description} of the \PName{name} variable.
\begin{Example}
- Suppose you have defined a direct dialling as mentioned above
- and you now want to set the content. You write:
-\begin{lstlisting}
- \setkomavar{myphone}{-\,11}
-\end{lstlisting}
- In addition, you want to replace the term ``direct dialling''
- with ``Connection''. Thus you add the description:
-\begin{lstlisting}
- \setkomavar*{myphone}{Connection}
-\end{lstlisting}
- or you can combine both in one command:
-\begin{lstlisting}
- \setkomavar{myphone}[Connection]{-\,11}
-\end{lstlisting}
+ It is customary for letters to indicate the sender in the letterhead.
+ First, \KOMAScript{} must know the name of the sender. For
+ ``Joe Public'' that would be done with:
+\begin{lstcode}
+ \setkomavar{fromname}{Joe Public}
+\end{lstcode}
+ The default for the description of the sender is ``From''. Assuming,
+ however, that Mr Public wants to have ``Sender'' in the places where
+ \KOMAScript{} outputs his name, he would have to add
+\begin{lstcode}
+ \setkomavar*{fromname}{Sender}
+\end{lstcode}
+ or combine the two commands into one:
+\begin{lstcode}
+ \setkomavar{fromname}[Sender]{Joe Public}
+\end{lstcode}
+ He thus kills two birds with one stone, so to speak.
\end{Example}
-By the way: You may delete the content of a variable using an empty
-\PName{content} argument. You can also delete the description using an
-empty \PName{description} argument.
+By the way, you can delete the content of the variable by providing an empty
+\PName{content} argument. Of course, you can delete the \PName{description} of
+the variable in the same way, with an empty argument for the description.
\begin{Example}
- Suppose you have defined a direct dialling as mentioned above and
- you now no longer want a description to be set. You write:
-\begin{lstlisting}
- \setkomavar*{myphone}{}
-\end{lstlisting}
- You can combine this with the definition of the content:
-\begin{lstlisting}
- \setkomavar{myphone}[]{-\,11}
-\end{lstlisting}
- So you may setup the content and delete the description using only
- one command.
+ Suppose Mr Public wants to have no label for the name of the sender. He can
+ either delete it for himself with
+\begin{lstcode}
+ \setkomavar*{fromname}{}
+\end{lstcode}
+ or he could again kill two birds with one stone and use
+\begin{lstcode}
+ \setkomavar{fromname}[]{Joe Public}
+\end{lstcode}
+ This will simultaneously set the contents of the variable and delete its
+ description.
\end{Example}
%
\EndIndexGroup
@@ -342,94 +360,91 @@ empty \PName{description} argument.
\Macro{usekomavar}\OParameter{command}\Parameter{name}%
\Macro{usekomavar*}\OParameter{command}\Parameter{name}
\end{Declaration}
-In\ChangedAt{v2.9i}{\Class{scrlttr2}} some cases it is necessary for the user
-to access the content or the description of a variable, and not to leave this
-only up to the class. This is specially important when you have defined a
-variable which is not added to the reference fields line. Using the command
-\Macro{usekomavar} you have access to the content of the variable
-\PName{name}, whereas the starred version \Macro{usekomavar*} allows you to
-access the description or title. In \autoref{sec:scrlttr2-experts.variables},
-\DescPageRef{scrlttr2-experts.cmd.newkomavar} you may find more
-information about defining variable on your own.%
+In\ChangedAt{v2.9i}{\Class{scrlttr2}} some cases, it is necessary to access
+the content or description of a variable and not to leave this solely to the
+class. This is especially important if you have defined a variable which is
+not added to the reference fields line. Using the command \Macro{usekomavar}
+you have access to the content of the \PName{name} variable, whereas the
+starred version \Macro{usekomavar*} allows you to access the description or
+title. In \autoref{sec:scrlttr2-experts.variables},
+\DescPageRef{scrlttr2-experts.cmd.newkomavar} you can find more information
+about defining your own variables.%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifkomavar}\Parameter{name}\Parameter{true-code}\Parameter{false-code}
+ \Macro{ifkomavar}\Parameter{name}\Parameter{then code}\Parameter{else code}
\end{Declaration}
-This\ChangedAt{v3.03}{\Class{scrlttr2}} command may be used to test, whether
-or not a variable has already been defined. The \PName{true-code} will be
-executed only, if the variable already exists. The contents of the variable
-will not be examined, so it may be empty. The \PName{false-code} will be
-executed if the variable does not yet exist. Such tests make sense if a
-variable will be defined at one
-\File{lco}-file\Index{lco-file=\File{lco}-file} (see
-\autoref{sec:\LabelBase.lcoFile} from \autopageref{sec:\LabelBase.lcoFile}
-onward), but used in another \File{lco}-file if it exists only.%
-%
+With\ChangedAt{v3.03}{\Class{scrlttr2}} this command, you can determine if a
+variable has already been defined. The \PName{then code} will be executed only
+if the variable already exists. The variable's contents will not be examined
+and so can be empty. The \PName{else code} will be executed if the variable
+does not exist. Such tests can be useful, for example, if your own variables
+are defined in one \File{lco} file\Index{lco file=\File{lco} file} (see
+\autoref{sec:\LabelBase.lcoFile} starting at
+\autopageref{sec:\LabelBase.lcoFile}) but used in another \File{lco} file only
+if they exist.%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifkomavarempty}\Parameter{name}\Parameter{true-code}%
- \Parameter{false-code}%
- \Macro{ifkomavarempty*}\Parameter{name}\Parameter{true-code}%
- \Parameter{false-code}
+ \Macro{ifkomavarempty}\Parameter{name}\Parameter{then code}%
+ \Parameter{else code}%
+ \Macro{ifkomavarempty*}\Parameter{name}\Parameter{then code}%
+ \Parameter{else code}
\end{Declaration}
-With\ChangedAt{v2.9i}{\Class{scrlttr2}} these commands you may check
-whether or not the expanded content or description of a variable is
-empty. The \PName{true-code} will be executed if the content or
-description is empty. Otherwise the \PName{false-code} will be
-executed. The starred variant handles the description of a variable,
-the unstarred variant handles the contents.%
+With\ChangedAt{v2.9i}{\Class{scrlttr2}} these commands, you can determine
+whether either the content or the description of a variable is empty. The
+\PName{then code} will be executed if the expanded content or the expanded
+description of the \PName{name} variable is empty. Otherwise, the \PName{else
+code} will be executed. The starred variant tests the variable's description,
+while the normal variant tests its contents.%
\EndIndexGroup
%
\EndIndexGroup
-\section{Pseudo-Lengths}
+\section{Pseudo-lengths}
\seclabel{pseudoLength}
-
\BeginIndexGroup
\BeginIndex{}{pseudo-lengths}
-\LaTeX{} processes length with commands \Macro{newlength}, \Macro{setlength},
-\Macro{addtolength}, and \Macro{the\PName{length}}. Many packages also use
-macros, that are commands, to storage lengths. \KOMAScript{} extends the
-method of storing length at macros by some commands similar to the commands
-above, that are used to handle real lengths. \KOMAScript calls this kind of
-lengths, that are stored at macros instead of real \LaTeX{} lengths,
-pseudo-lengths.
-
-A list of all pseudo-lengths in \Class{scrlttr2} is shown in
-\autoref{tab:scrlttr2-experts.pseudoLength} starting at
-\autopageref{tab:scrlttr2-experts.pseudoLength}. The meaning of the various
-pseudo-lengths is shown graphically in
+
+\LaTeX{} processes lengths with three commands:
+\Macro{newlength}\IndexCmd{newlength}, \Macro{setlength}\IndexCmd{setlength}
+and \Macro{addtolength}\IndexCmd{addtolength}. Many packages also use macros,
+which are commands, to store lengths. \KOMAScript{} extends this method with
+the ability to process such lengths stored in macros with commands similar to
+those used to handle real lengths. \KOMAScript{} calls lengths that are
+actually stored in macros \emph{pseudo-lengths}.
+
+You can find a list of all pseudo-lengths defined by \Class{scrlttr2} in
+\autoref{tab:scrlttr2-experts.pseudoLength},
+\autopageref{tab:scrlttr2-experts.pseudoLength}. A graphical representation of
+the main pseudo-lengths for the letterhead page is given in
\autoref{fig:scrlttr2-experts.pseudoLength}. The dimensions used in the figure
correspond to the default settings of \Class{scrlttr2}. More detailed
-description of the individual pseudo-lengths is found in the individual
+descriptions of the individual pseudo-lengths are found in the individual
sections of this chapter.
-Normally users would not need to define a pseudo-length on their own. Because
-of this, definition of pseudo-lengths will be described in the expert part at
+Since users will usually not need to define their own pseudo-lengths, the
+method for defining them is described in the part for experts, in
\autoref{sec:scrlttr2-experts.pseudoLengths},
-\DescPageRef{scrlttr2-experts.cmd.@newplength}. Setting pseudo-lengths to
-new values is also a work for advanced users. So this will be described in the
-expert part too at \DescPageRef{scrlttr2-experts.cmd.@setplength}.
+\DescPageRef{scrlttr2-experts.cmd.@newplength}. Setting pseudo-lengths to new
+values should also be a matter for advanced users, so this is also described
+in the part for experts, on \DescPageRef{scrlttr2-experts.cmd.@setplength}.
-Please note\textnote{Attention!}: Even though these pseudo-lengths are
-internally implemented as macros, the commands for pseudo-length management
-expect only the names of the pseudo-lengths not the macros representing the
-pseudo-lengths. The names of pseudo-lengths are without backslash at the very
-beginning similar to the names of \LaTeX{} counters and in opposite to macros
-or \LaTeX{} lengths.
+Note\textnote{Attention!} that although these pseudo-lengths are internally
+implemented as macros, the commands to use pseudo-lengths expect only the the
+pseudo-length names. These are written without backslashes, like the names of
+\LaTeX{} counters and unlike macros or real lengths.
\begin{Declaration}
\Macro{useplength}\Parameter{name}
\end{Declaration}
-Using this command you can access the value of the pseudo-length with
+Using this command you can access the value of the pseudo-length of
the given \PName{name}. This is one of the few user commands in
connection with pseudo-lengths. Of course this command can also be
-used with an \File{lco}-file\Index{lco-file=\File{lco}-file} (see
+used with an \File{lco} file\Index{lco file=\File{lco} file} (see
\autoref{sec:\LabelBase.lcoFile} ab \autopageref{sec:\LabelBase.lcoFile}).%
%
\EndIndexGroup
@@ -441,30 +456,19 @@ used with an \File{lco}-file\Index{lco-file=\File{lco}-file} (see
\Macro{addtolengthplength}%
\OParameter{factor}\Parameter{length}\Parameter{pseudo-length}
\end{Declaration}
-\begin{Explain}%
- While you can simply prepend a factor to a length, this is not
- possible with pseudo-lengths. Suppose you have a length \Macro{test}
- with the value 2\Unit{pt}; then \texttt{3\Macro{test}} gives you the
- value 6\Unit{pt}. Using pseudo-lengths instead,
- \texttt{3\Macro{useplength}\PParameter{test}} would give you
- 32\Unit{pt}. This is especially annoying if you want a real
- \PName{length} to take the value of a \PName{pseudo-length}.
-\end{Explain}
-Using the command \Macro{setlengthtoplength} you can assign the
-multiple of a \PName{pseudo-length} to a real \PName{length}. Here,
-instead of prepending the \PName{factor} to the \PName{pseudo-length},
-it is given as an optional argument. You should also use this command
-when you want to assign the negative value of a \PName{pseudo-length}
-to a \PName{length}. In this case you can either use a minus sign or
-\PValue{-1} as the \PName{factor}. The command
-\Macro{addtolengthplength} works very similarly; it adds the multiple
-of a \PName{pseudo-length} to the \PName{length}.
+With the \Macro{setlengthtoplength} command, you can assign a multiple of a
+\PName{pseudo-length} to a real \PName{length}. The \PName{factor} is given
+as an optional argument instead of directly preceding the
+\PName{pseudo-length}. You should also use this command when you want to
+assign the negative of a \PName{pseudo-length} to a \PName{length}. In this
+case, you can use either a minus sign or \PValue{-1} as the \PName{factor}.
+The \Macro{addtolengthplength} command works very similarly. It adds the
+\PName{pseudo-length} multiplied by the \PName{factor} to the \PName{length}.%
%
\EndIndexGroup
%
\EndIndexGroup
-
\LoadCommonFile{options} % \section{Early or Late Selection of Options}
\LoadCommonFile{compatibility} % \section{Compatibility with Earlier Versions of
@@ -474,13 +478,14 @@ of a \PName{pseudo-length} to the \PName{length}.
\LoadCommonFile{typearea} % \section{Page Layout}
-Normally it makes no sense to distinguish letters with single-side layout and
-letters with double-side layout. Mostly letters are not bound like
-books. Therefor each page will be viewed on its own. This is also true if both
-sides of the paper sheet will be used for printing. Vertical adjustment is
-unusual at letters too. Nevertheless, if you need or want it, you may read the
-description of \Macro{raggedbottom} and \Macro{flushbottom} in
-\autoref{sec:maincls.typearea} at \DescPageRef{maincls.cmd.flushbottom}.%
+For letters, it is normally not useful to distinguish one-sided and two-sided
+printing. Since letters are not usually bound, each page of a letter will be
+viewed on its own. This is also true even if both the letter is printed on
+both sides of the paper. Vertical adjustment usually does not matter for
+letters either. If you nevertheless need it, or want to understand what it is,
+please refer to the commands \Macro{raggedbottom} and \Macro{flushbottom}
+explained in \autoref{sec:maincls.typearea} on
+\DescPageRef{maincls.cmd.flushbottom}.%
%
\EndIndexGroup
@@ -490,20 +495,19 @@ description of \Macro{raggedbottom} and \Macro{flushbottom} in
\BeginIndexGroup
\BeginIndex{}{letter>structure}
-The general structure of a letter document differs somewhat from the
-structure of a normal document. Whereas a book document in general
-contains only one book, a letter document can contain several
-letters. As illustrated in \autoref{fig:\LabelBase.document}, a letter
-document consists of a preamble, the individual letters, and the
-closing.
+The general structure of a letter document differs somewhat from the structure
+of a normal document. Whereas a book document usually contains only one book,
+a letter document can contain several letters. As illustrated in
+\autoref{fig:\LabelBase.document}, a letter document consists of a preamble,
+the individual letters, and the closing.
\begin{figure}
\KOMAoptions{captions=bottombeside}%
\setcapindent{0pt}%
\begin{captionbeside}[{%
- General structure of a letter document with several individual letters%
+ General structure of a letter document containing several individual letters%
}]{%
- General structure of a letter document with several individual letters
+ General structure of a letter document containing several individual letters
(the structure of a single letter is shown in
\autoref{fig:\LabelBase.letter})%
\label{fig:\LabelBase.document}%
@@ -522,7 +526,7 @@ closing.
\dots\\
}}\\
\fbox{\parbox{\linewidth}{\raggedright%
- \Macro{begin}\PParameter{letter}\Parameter{addressee}\\
+ \Macro{begin}\PParameter{letter}\Parameter{recipient}\\
\dots\\
{\centering\emph{content of the individual letter}\\}
\dots\\
@@ -536,24 +540,29 @@ closing.
\end{captionbeside}
\end{figure}
-The preamble comprises all settings that in general concern all letters. Most
-of them can also be overwritten in the settings of the individual letters. The
-only setting which can not be changed within a single letter is compatibility
-to prior versions of \Class{scrlttr2} (see option \DescRef{\LabelBase.option.version} in
+The preamble contains all the settings that apply generally to all letters.
+Most of them can also be overwritten in the settings of the individual
+letters. The only setting which cannot currently be changed within a single
+letter is the version of \Class{scrlttr2} for which compatibility is required
+(see the \DescRef{\LabelBase.option.version} option in
\autoref{sec:\LabelBase.compatibilityOptions},
\DescPageRef{\LabelBase.option.version}).
-It is recommended that only general settings such as the loading of packages
-and the setting of options be placed before
-\Macro{begin}\PParameter{document}. All settings that comprise the setting of
-variables or other text features should be done after
-\Macro{begin}\PParameter{document}. This is particularly recommended when the
-\Package{babel} package\IndexPackage{babel} (see \cite{package:babel}) is
-used, or language-dependent variables of \Class{scrlttr2} are to be changed.
+If you use \Package{scrletter}\important{scrletter}, the only difference is
+that another class is loaded, with
+\DescRef{\LabelBase.cmd.usepackage}\PParameter{scrletter} added before the
+settings for all letters. For setting options with \Package{scrletter}, see
+\autoref{sec:\LabelBase.options}, on \autopageref{sec:\LabelBase.options}.
-The closing usually consists only of
-\Macro{end}\PParameter{document}. Of course you can also insert
-additional comments at this point.
+I recommended that you place only general settings such as loading packages
+and setting options before \Macro{begin}\PParameter{document}. You should
+initialise all variables or other textual features after
+\Macro{begin}\PParameter{document}, particularly when you use the
+\Package{babel} package\IndexPackage{babel} (see \cite{package:babel}) or
+change language-dependent variables of \Class{scrlttr2}.
+
+The closing usually consists only of \Macro{end}\PParameter{document}. Of
+course you can also add additional comments at this point.
\begin{figure}
\KOMAoptions{captions=bottombeside}%
@@ -569,11 +578,11 @@ additional comments at this point.
\addtolength{\linewidth}{-\dimexpr2\fboxrule+2\fboxsep\relax}%
\fbox{\parbox{\linewidth}{\raggedright%
\Macro{begin}\PParameter{letter}%
- \OParameter{Optionen}\Parameter{addressee}\\
+ \OParameter{options}\Parameter{recipient}\\
\dots\\[\dp\strutbox]
{\centering\emph{settings for this letter}\\}
\dots\\
- \DescRef{\LabelBase.cmd.opening}\Parameter{opening}\\
+ \DescRef{\LabelBase.cmd.opening}\Parameter{salutation}\\
}}\\[1pt]
\fbox{\parbox{\linewidth}{\raggedright%
\dots\\[\dp\strutbox]
@@ -581,71 +590,77 @@ additional comments at this point.
\dots\\
}}\\[1pt]
\fbox{\parbox{\linewidth}{\raggedright%
- \DescRef{\LabelBase.cmd.closing}\Parameter{closing}\\
+ \DescRef{\LabelBase.cmd.closing}\Parameter{concluding text}\\
\DescRef{\LabelBase.cmd.ps}\\
\dots\\[\dp\strutbox]
{\centering\emph{postscript}\\}
\dots\\
\DescRef{\LabelBase.cmd.encl}\Parameter{enclosures}\\
- \DescRef{\LabelBase.cmd.cc}\Parameter{additional addressees}\\
+ \DescRef{\LabelBase.cmd.cc}\Parameter{additional recipients}\\
\Macro{end}\PParameter{letter}\\
}}\\[\dimexpr\fboxsep+\fboxrule\relax]
\end{minipage}
\end{captionbeside}
\end{figure}
-As shown in \autoref{fig:\LabelBase.letter}, every single letter itself consists
-of an introduction, the letter body, and the closing. In the introduction, all
-settings pertaining only to the current letter are defined. It is important
-that this introduction always ends with
-\DescRef{\LabelBase.cmd.opening}\IndexCmd{opening}. Similarly, the closing always starts with
-\DescRef{\LabelBase.cmd.closing}\IndexCmd{closing}. The two arguments \PName{opening} and
-\PName{closing} can be left empty, but both commands must be used and must
-have an argument.
-
-It should be noted that several settings can be changed between the individual
-letters. Such changes then have an effect on all subsequent letters. For
-reasons of maintainability of your letter documents, it is however not
-recommended to use further general settings with limited scope between the
-letters.
+As detailed in \autoref{fig:\LabelBase.letter}, individual letters each
+consist of an introduction, the body of the letter, and the closing. In the
+introduction, all settings pertaining to the current letter alone are defined.
+It is important that this introduction always ends with
+\DescRef{\LabelBase.cmd.opening}\IndexCmd{opening}. Similarly, the closing
+always starts with \DescRef{\LabelBase.cmd.closing}\IndexCmd{closing}. The
+\PName{opening} and \PName{closing} arguments of the two commands can be left
+empty, but both commands must be used and must have an argument.
+
+Note that you can change additional settings between the individual letters.
+Such changes then apply to all subsequent letters. However, to keep your
+letter documents clear and maintainable, you should think carefully before
+actually placing further general settings of limited scope between the
+letters. I cannot recommend this practice. However, if you use
+\Package{scrletter2}, there is nothing wrong with inserting additional parts
+of the document between or after letters that should not be in the same scope.
+For example, you can combine a cover letter and a CV in one document.
\begin{Declaration}
- \begin{Environment}{letter}\OParameter{options}\Parameter{addressee}
+ \begin{Environment}{letter}\OParameter{options}\Parameter{recipient}
\end{Environment}
\end{Declaration}
-\BeginIndex{}{addressee}%
+\BeginIndex{}{address}%
The \Environment{letter} environment is one of the key environments of the
-letter class. A special\textnote{\KOMAScript{} vs. standard classes}
-\Class{scrlttr2} feature are optional arguments to the \Environment{letter}
-environment. These \PName{options} are executed internally via the
+letter class. A noteworthy\textnote{\KOMAScript{} vs. standard classes}
+feature of \Class{scrlttr2} and \Package{scrletter} is that they can provide
+additional \PName{options} for the \Environment{letter} environment. These
+\PName{options} are executed internally using the
\DescRef{\LabelBase.cmd.KOMAoptions} command.
-The \PName{addressee} is a mandatory argument passed to the
-\Environment{letter} environment. Parts\textnote{Attention!} of the addressee
-contents are separated by double backslashes. These parts are output on
-individual lines in the address field. Nevertheless, the double backslash
-should not be interpreted as a certain line break. Vertical material such as
-paragraphs or vertical space is not permitted within \PName{addressee}, and
-could lead to unexpected results and error messages, as is the case also for
-the standard letter class.
+The \PName{recipient}, or addressee, is a mandatory argument passed to the
+\Environment{letter} environment and includes both the name and the address of
+the recipient of the letter. Double\textnote{Attention!} backslashes serve to
+separate the individual parts of the address. These parts are output on
+individual lines in the address field. Nevertheless, you should not interpret
+the double backslash as a mandatory line break. Vertical material such as new
+paragraphs or vertical space is not permitted within the address. They can
+lead to unexpected results and error messages. Incidentally, this is the same
+for the standard letter class.
\begin{Example}
\phantomsection\label{desc:\LabelBase.env.letter.example}%
- Assumed, someone wants to send a letter to Joana Public. A minimalistic
- letter document for this may be:
+ Suppose you want to write a letter to Joanna Public. A minimalist
+ letter document would look like this:
\begin{lstcode}
\documentclass[version=last]{scrlttr2}
- \usepackage[english]{babel}
+ \usepackage[british]{babel}
\begin{document}
- \begin{letter}{Joana Public\\
- Hillside 1\\
- 12345 Public-City}
+ \begin{letter}{Joanna Public\\
+ 1 Hillside\\
+ SAMPLESTEAD\\
+ WX12 3YZ}
\end{letter}
\end{document}
\end{lstcode}
- However, this would not result in any printable output. At least there
- would not be an addressee at the note paper sheet. The reason for this will
- be explained at the description of command \DescRef{\LabelBase.cmd.opening} at
+ However, this would not result in any output. It would not even print the
+ recipient on the letterhead page. Why this is the case is explained in the
+ description of the \DescRef{\LabelBase.cmd.opening} command on
\DescPageRef{\LabelBase.cmd.opening}.
\end{Example}
%
@@ -653,31 +668,32 @@ the standard letter class.
\begin{Declaration}
- \Macro{AtBeginLetter}\Parameter{instruction code}%
- \Macro{AtEndLetter}\Parameter{instruction code}
+ \Macro{AtBeginLetter}\Parameter{code}%
+ \Macro{AtEndLetter}\Parameter{code}
\end{Declaration}
-{\LaTeX} enables the user to declare \PName{instruction code} whose execution
-is delayed until a determined point. Such points are called
-\emph{hooks}\Index{hook}. Known macros for using hooks are
+As mentioned in \cite{latex:clsguide}, \LaTeX{} lets the user declare
+additional \PName{code} to be executed at certain points in a \LaTeX{} run.
+For this purpose, the \LaTeX{} kernel provides, for example,
\Macro{AtBeginDocument}\IndexCmd{AtBeginDocument} and
-\Macro{AtEndOfClass}\IndexCmd{AtEndOfClass} at the \LaTeX{} kernel. The class
-\Class{scrlttr2} provides two more hooks. The \PName{instruction code} for
-these may be declared using \Macro{AtBeginLetter} and
+\Macro{AtEndOfClass}\IndexCmd{AtEndOfClass}. Such points are called
+\emph{hooks}\Index{hook}. The \Class{scrlttr2} class and the
+\Package{scrletter} package provide two additional hooks. You can declare the
+\PName{code} for these using \Macro{AtBeginLetter} and
\Macro{AtEndLetter}\ChangedAt{v2.95}{\Class{scrlttr2}}. Originally, hooks were
-provided for package and class authors, so they are documented in
-\cite{latex:clsguide} only, and not in \cite{latex:usrguide}. However, with
-letters there are useful applications of \Macro{AtBeginLetter} as the
-following example may illustrate.
+intended for package and class authors, so they are documented only in
+\cite{latex:clsguide} and not in \cite{latex:usrguide}. However, with letters
+there are useful applications at the user level for both new hooks, as the
+following example illustrates.
%
\begin{Example}
- It is given that one has to set multiple letters with questionnaires
- within one document. Questions are numbered automatically within
- single letters using a counter. Since, in contrast to page
- numbering, that counter is not known by \Class{scrlttr2}, it would
- not be reset at the start of each new letter. Given that each
- questionnaire contains ten questions, question~1 would get number~11
- in the second letter. A solution is to reset this counter at the
- beginning of each new letter:
+ Suppose you have several letters in a document that use their own commands
+ to insert a questionnaire in the letters. The questions are numbered
+ automatically using a counter. Since \KOMAScript{} is unaware of this
+ counter, it would not be reset at the start of each new letter, unlike the
+ page number. If each questionnaire contains ten questions, the first
+ question in the fifth letter would get the number~41. You can solve this
+ problem by telling \KOMAScript{} to reset this counter at the beginning of
+ each letter:
\begin{lstlisting}
\newcounter{Question}
\newcommand{\Question}[1]{%
@@ -689,9 +705,10 @@ following example may illustrate.
\AtBeginLetter{\setcounter{Question}{0}}
\end{lstlisting}
This way first question remains question~1, even in the 1001st letter. Of
- course the definition at this example needs package
- \Package{tabularx}\IndexPackage{tabularx} (see \cite{package:tabularx}).
-\end{Example}
+ course the definition in this example requires the
+ \Package{tabularx}\IndexPackage{tabularx} package (see
+ \cite{package:tabularx}).
+\end{Example}%
%
\EndIndexGroup
@@ -702,14 +719,15 @@ following example may illustrate.
\Macro{letterlastpage}
\end{Declaration}
If\ChangedAt{v3.19}{\Class{scrlttr2}\and \Package{scrletter}} you have more
-than one letter in one document, it is useful to have a letter number. Since
-version~3.19 \KOMAScript{} provides counter \Counter{letter} and increases it
-at every \Macro{begin}\PParameter{letter}.
+than one letter in a document, it is useful to have a letter number. For this
+purpose, \KOMAScript{} has provided the \Counter{letter} counter, which
+is incremented by one at each \Macro{begin}\PParameter{letter}, since
+version~3.19.
\begin{Example}
- Have one more look into the \DescRef{\LabelBase.cmd.AtBeginLetter}
+ Let's return to the \DescRef{\LabelBase.cmd.AtBeginLetter}
example. Instead of resetting the counter explicitly at
- \Macro{begin}\PParameter{letter}, we can do it implicitly by defining
- counter \Counter{Question} depending on counter \Counter{letter}:
+ \Macro{begin}\PParameter{letter}, we can do so implicitly by defining
+ counter \Counter{Question} to depend on counter \Counter{letter}:
\begin{lstlisting}
\newcounter{Question}[letter]
\newcommand{\Question}[1]{%
@@ -719,91 +737,100 @@ at every \Macro{begin}\PParameter{letter}.
\end{tabularx}%
}%
\end{lstlisting}
- Now, the new counter will be reset at every start of a new letter and
- the first question of every letter will be number one.
+ Now the new counter will be reset at every start of each letter so that
+ the first question in each letter will be number one.
\end{Example}
-If you want the output of current value of \Counter{letter}, you may usually
-use \Macro{theletter}. Indeed the letter can also be used for
+If you want to display the current value of \Counter{letter}, this is
+possible, as usual, with \Macro{theletter}. The counter can also be used for
cross-references. So you can use \Macro{label}\Parameter{name} to generate a
label immediately after \Macro{begin}\PParameter{letter} and reference it
somewhere in the document using \Macro{ref}\Parameter{name}. Inside the same
-letter you can simply use \Macro{thisletter} without generating a label to get
-the same result.
-
-\KOMAScript{} itself uses \Macro{thisletter} to put a label onto the last page
-of every letter. You can use
-\Macro{letterlastpage}\IndexCmd{label}\IndexCmd{pageref} to reference the last
-page number of the current letter. Please note, the value of
-\Macro{letterlastpage} is valid after some \LaTeX{} runs, because it uses
-\Macro{label} and \Macro{pageref}. So you need at least two or three \LaTeX{}
-runs, if you use \Macro{letterlastpage}. Please have a look at \emph{Rerun}
-terminal or \File{log}-file messages about labels that have been changed.%
+letter you can get the same result by simply using \Macro{thisletter} without
+creating a label.
+
+For labels in form letters, it is necessary to give them a unique name across
+all letters. Once again, you can use \Macro{thisletter} for this purpose.
+\KOMAScript{} also uses \Macro{thisletter} internally to put a label on the
+last page of each letter. This makes it possible to use
+\Macro{letterlastpage}\IndexCmd{label}\IndexCmd{pageref} to reference the
+number of the last page of the current letter at any point within the letter.
+Since \Macro{letterlastpage} uses \Macro{label} and \Macro{pageref}, it is
+only valid after several \LaTeX{} runs\,---\,usually two or three. If you use
+\Macro{letterlastpage}, pay attention to the \emph{Rerun} messages in the
+terminal output or \File{log} file messages about labels that have been
+changed.%
\EndIndexGroup
\begin{Declaration}
- \Macro{opening}\Parameter{opening}
+ \Macro{opening}\Parameter{salutation}
\end{Declaration}
-This is one of the most important commands in \Class{scrlttr2}. For the user
-it may seem that only the \PName{opening}\Index{letter>opening}, e.\,g.,
-``Dear Mrs~\dots'', is typeset, but\textnote{Attention!} the command also
-typesets the folding marks\Index{folding marks},
-letterhead\Index{letter>head}, address field\Index{address field}, reference
-fields line\Index{reference line}, subject\Index{subject}, the page
-footer\Index{page>footer} and others. In short, without \Macro{opening} there
-is no letter. And if you want to print a letter without opening you have to
-use an \Macro{opening} command with an empty argument.
+This is one of the most important commands for letters. On the surface, it may
+seem that only the \PName{salutation}\Index{letter>salutation}, for example
+``Dear Mrs~\dots'', is printed. Actually\textnote{Attention!}, this command
+also prints the fold marks\Index{fold marks}, the
+letterhead\Index{letterhead}, the address\Index{address}, the extra sender
+information, the reference line\Index{reference line}, the title\Index{title},
+the subject\Index{subject}, and the footer\Index{page>footer}. In short,
+without \Macro{opening} there is no letter. If, in fact, you want to print a
+letter without a salutation, you have to use an \Macro{opening} command with
+an empty argument.
\begin{Example}
- Let's extend the example from
- \DescPageRef{\LabelBase.env.letter.example} by an opening:
+ Let's return to the example of
+ \DescPageRef{\LabelBase.env.letter.example} and add a salutation:
\lstinputcode[xleftmargin=1em]{letter-0.tex}
- This will result in a note paper sheet shown in
+ This will result in the letterhead shown in
\autoref{fig:\LabelBase.letter-0}.
\begin{figure}
\setcapindent{0pt}%
- \begin{captionbeside}[{Example: letter with addressee and opening}]{%
- result of a minimalistic letter with addressee and opening only
- (date and folding marks are defaults of DIN-letters)}[l]
+ \begin{captionbeside}[{Example: letter with recipient and salutation}]{%
+ result of a minimalist letter with recipient and salutation only
+ (the date is set by default)}[l]
\frame{\includegraphics[width=.4\textwidth]{letter-0}}
\end{captionbeside}
\label{fig:\LabelBase.letter-0}
\end{figure}
\end{Example}
\iffalse% Umbruchkorrekturtext
-
-In the early days of computer-generated letters, programs did not have many
-capabilities, therefore the letters seldom had an opening. Today the
-capabilities have been enhanced. Thus personal openings are very common, even
-in mass-production advertising letters.%
+\begin{Explain}
+ In the early days of computer-generated letters, a salutation was normally
+ omitted, since individualised form letters were hardly possible. Today
+ personalised greetings are common in in mass mailings.%
+\end{Explain}
\fi
%
\EndIndexGroup
+
\begin{Declaration}
- \Macro{closing}\Parameter{closing phrase}
+ \Macro{closing}\Parameter{concluding text}
\end{Declaration}
The main purpose of the command \Macro{closing} is to typeset the
-\PName{closing phrase}\Index{closing}. This may even consists of multiple
-lines. The lines should be separated by double backslash. Paragraph breaks
-inside the \PName{closing phrase} are not allowed.
+\PName{concluding text}\Index{closing}. This can even consist of multiple
+lines. In that case, the individual lines should be separated by a double
+backslash. Paragraph breaks inside the \PName{concluding text} are not
+allowed.
-Beyond that the command also typesets the content of the variable
-\DescRef{\LabelBase.variable.signature}. More information about the signature and the
-configuration of the signature may be found at \autoref{sec:\LabelBase.closing}
-ab \DescPageRef{\LabelBase.variable.signature}.
+In addition, this command also prints the content of the
+\DescRef{\LabelBase.variable.signature} variable. You can find more
+information about the signature and its configuration in
+\autoref{sec:\LabelBase.closing} on
+\DescPageRef{\LabelBase.variable.signature}.
\begin{Example}
- Let's extend the our example by some lines of text and a closing phrase:
+ Let's extend the our example with a few lines of text and a closing phrase:
\lstinputcode[xleftmargin=1em]{letter-1.tex}
This will result in a the letter shown in \autoref{fig:\LabelBase.letter-1}.
\begin{figure}
\setcapindent{0pt}%
- \begin{captionbeside}[{Example: letter with addressee, opening, text, and
+ \begin{captionbeside}[{Example: letter with recipient, opening, text, and
closing}]{%
- result of a small letter with addressee, opening, text, and closing
- (date and folding marks are defaults of DIN-letters)}[l]
+ result of a short letter with recipient, opening, text, and closing
+ % The refernce to DIN-letters in the German guide isn't relevant for
+ % English-language letters
+ (the date is set by default)}[l]
\frame{\includegraphics[width=.4\textwidth]{letter-1}}
\end{captionbeside}
\label{fig:\LabelBase.letter-1}
@@ -815,25 +842,24 @@ ab \DescPageRef{\LabelBase.variable.signature}.
\begin{Declaration}
\Macro{ps}
\end{Declaration}%
-This instruction merely switches to the postscript. Hence, a new
-paragraph begins, and a vertical distance\,---\,usually below the
-signature\,---\,is inserted. The command \Macro{ps} is followed by
-normal text. If you want the postscript to be introduced with the
-acronym ``PS:'' , which by the way is written without a full stop, you
-have to type this yourself. The acronym is typeset neither
-automatically nor optionally by the class \Class{scrlttr2}.
+This instruction merely switches to the postscript. To do so, a new paragraph
+begins, and a vertical gap\,---\,usually below the signature\,---\,is
+inserted. The \Macro{ps} text can be followed by any text. If you want the
+postscript to be introduced with the acronym ``PS:'', which in most current
+usage is written without full stops, you have to type this yourself. This
+abbreviation is printed neither automatically nor optionally by the
+\Class{scrlttr2} class.
\begin{Example}
- The example letter extended by a postscript
+ The sample letter with the addition of a postscript
\lstinputcode[xleftmargin=1em]{letter-2.tex}
results in \autoref{fig:\LabelBase.letter-2}.
\begin{figure}
\setcapindent{0pt}%
- \begin{captionbeside}[{Example: letter with addressee, opening, text,
+ \begin{captionbeside}[{Example: letter with recipient, opening, text,
closing, and postscript}]{%
- result of a small letter with addressee, opening, text, closing, and
- postscript
- (date and folding marks are defaults of DIN-letters)}[l]
+ result of a short letter with recipient, opening, text, closing, and
+ postscript (the date is set by default)}[l]
\frame{\includegraphics[width=.4\textwidth]{letter-2}}
\end{captionbeside}
\label{fig:\LabelBase.letter-2}
@@ -841,13 +867,12 @@ automatically nor optionally by the class \Class{scrlttr2}.
\end{Example}
\begin{Explain}
- In the time when letters were written by hand it was quite common to use a
- postscript because this was the only way to add information which one had
- forgotten to mention in the main part of the letter. Of course, in letters
- written with {\LaTeX} you can insert additional lines easily. Nevertheless,
- it is still popular to use the postscript. It gives one a good possibility
- to underline again the most important or sometimes the less important things
- of the particular letter.
+ When letters were written still by hand, it was quite common to use a
+ postscript because this was the only way to add information which had been
+ forgotten in the main part of the letter. For letters written with \LaTeX{},
+ of course, you can easily insert additional lines. Nevertheless, postscripts
+ remain popular. They can be useful to emphasize important points once more,
+ or even to mention the less important matters.
\end{Explain}
%
\EndIndexGroup
@@ -857,34 +882,32 @@ automatically nor optionally by the class \Class{scrlttr2}.
\Macro{cc}\Parameter{distribution list}%
\Variable{ccseparator}%
\end{Declaration}
-With the command \Macro{cc}%
-\Index{addressee>additional}\Index{distribution list}\Index{carbon copy} it is
-possible to typeset a \PName{distribution list}. The command takes the
-\PName{distribution list} as its argument. If the content of the variable
-\Variable{ccseparator}\Index{separator}\Index{delimiter} is not empty, then
-the name and the content of this variable is inserted before
-\PName{distribution list}. In this case the \PName{distribution list} will be
-indented appropriately. It is a good idea\textnote{Hint!} to set the
+You can print a \PName{distribution list}\Index{recipient>additional}%
+\Index{distribution list}\Index{carbon copy} with the \Macro{cc} command. The
+command takes the \PName{distribution list} as its argument. If the content of
+the variable \Variable{ccseparator}\Index{separator}\Index{delimiter} is not
+empty, the name and content of this variable are inserted before the
+\PName{distribution list}. In this case, the \PName{distribution list} will be
+indented appropriately. It's a good idea\textnote{Hint!} to set the
\PName{distribution list} \Macro{raggedright}\IndexCmd{raggedright} and to
separate the individual entries with a double backslash.
\begin{Example}
- This time, the example letter should be send not only to the chairman, but
- also to all club members:
+ This time, the sample letter should go not only to the chairman but also to
+ all club members:
\lstinputcode[xleftmargin=1em]{letter-3.tex}%
The result is shown in \autoref{fig:\LabelBase.letter-3}.
\begin{figure}
\setcapindent{0pt}%
- \begin{captionbeside}[{Example: letter with addressee, opening, text,
+ \begin{captionbeside}[{Example: letter with recipient, opening, text,
closing, postscript, and distribution list}]{%
- result of a small letter with addressee, opening, text, closing,
- postscript, and distribution list
- (date and folding marks are defaults of DIN-letters)}[l]
+ result of a short letter with recipient, opening, text, closing,
+ postscript, and distribution list (the date is set by default)}[l]
\frame{\includegraphics[width=.4\textwidth]{letter-3}}
\end{captionbeside}
\label{fig:\LabelBase.letter-3}
\end{figure}
\end{Example}
-In front of the distribution list a vertical gap is inserted automatically.%
+A vertical gap is inserted automatically before the distribution list.%
%
\EndIndexGroup
@@ -893,24 +916,23 @@ In front of the distribution list a vertical gap is inserted automatically.%
\Macro{encl}\Parameter{enclosures}%
\Variable{enclseparator}%
\end{Declaration}
-The \PName{enclosures} have the same structure as the distribution list.
-The only difference is that here the enclosures starts with the name
-and content of the variable
-\Variable{enclseparator}\Index{separator}\Index{delimiter}.
+The \PName{enclosures} have the same structure as the distribution list. The
+only difference is that the list of enclosures begins with the name and
+content of the \Variable{enclseparator}\Index{separator}\Index{delimiter}
+variable.
\begin{Example}
- Now, the example letter will be extended by some paragraphs from the
- constitution. These will be added as an enclosure. The description title
- will be changed also, because there is only one enclosure and the default
- may be prepared for several enclosures:
+ To the sample letter we will attach an excerpt from the club's articles of
+ association. These will be added as an enclosure. Because there is only one
+ enclosure, we change the description title accordingly:
\lstinputcode[xleftmargin=1em]{letter-4.tex}
This will result in \autoref{fig:\LabelBase.letter-4}.
\begin{figure}
\setcapindent{0pt}%
- \begin{captionbeside}[{Example: letter with addressee, opening, text,
+ \begin{captionbeside}[{Example: letter with recipient, opening, text,
closing, postscript, distribution list, and enclosure}]{%
- result of a small letter with addressee, opening, text, closing,
- postscript, distribution list, and enclosure
- (date and folding marks are defaults of DIN-letters)}[l]
+ result of a short letter with recipient, opening, text, closing,
+ postscript, distribution list, and enclosure (the date is set by
+ default)}[l]
\frame{\includegraphics[width=.4\textwidth]{letter-4}}
\end{captionbeside}
\label{fig:\LabelBase.letter-4}
@@ -922,69 +944,72 @@ and content of the variable
\EndIndexGroup
-\LoadCommonFile{fontsize} % \section{Selection of Document Font Size}
+\LoadCommonFile{fontsize} % \section{Choosing the Document Font Size}
\LoadCommonFile{textmarkup} % \section{Text Markup}
-\section{Note Paper}
+\section{Letterhead Page}
\seclabel{firstpage}
\BeginIndexGroup
-\BeginIndex{}{note paper}%
-\BeginIndex{}{letter>first page}
-
-The note paper is the first page and therefore the signboard of each
-letter. In business scope often preprinted forms are used, that already
-contains elements like the letter head with the sender's information and
-logo. \KOMAScript{} provides to position these elements independent. With this
-it is not only possible to replicate the note paper directly, but also to
-complete the destined fields instantaneously. The independent position is
-provided by pseudo-lengths (see \autoref{sec:\LabelBase.pseudoLength} from
-\autopageref{sec:\LabelBase.pseudoLength} onward). A schematic display of the
-note page and the used variable is shown by
-\autoref{fig:\LabelBase.variables}. Thereby the names of the variables are
-printed boldly for better distinction from the commands and their arguments.
-
-Following pages\Index{page>following}\Index{following page} are different from
-the note paper. Following pages in the meaning of this manual are all letter
-pages but the first one.
+\BeginIndex{}{letterhead page}%
+
+The letterhead page is the first page of, and therefore the signpost for, each
+letter. In a business context, the paper for this page is often preprinted
+stationery containing elements such as a header with the sender's information
+and logo. This header itself is also known as a letterhead. \KOMAScript{} lets
+you position these elements freely, and so you can not only replicate the
+letterhead page directly but also fill in the required fields instantaneously.
+This free positioning is achieved with pseudo-lengths (see
+\autoref{sec:\LabelBase.pseudoLength} starting on
+\autopageref{sec:\LabelBase.pseudoLength}). You can find a schematic
+representation of the letterhead page and the variables used for it in
+\autoref{fig:\LabelBase.variables}. The names of the variables are printed in
+bold to better distinguish the commands from their arguments.
+
+Subsequent pages\Index{page>subsequent}\Index{subsequent pages} should be
+distinguished from the letterhead page. For the purposes of this manual,
+subsequent pages are all pages of a letter except the first one.
+
\begin{figure}
\centering
\includegraphics[scale=0.99]{varDIN}
- \caption{schematic display of the note paper with the most important
- commands and variables for the drafted elements}
+ \caption{schematic display of the letterhead page outlining the most
+ important commands and variables}
\label{fig:\LabelBase.variables}
\end{figure}
+
\begin{Declaration}
- \OptionVName{foldmarks}{selection}
+ \OptionVName{foldmarks}{setting}
\end{Declaration}
-Foldmarks\Index{foldmark} or folding marks\Index{folding mark} are tiny
-horizontal rules at the left margin or tiny vertical rules at the top
-margin. \KOMAScript{} currently provides three configurable horizontal folding
-marks and one configurable vertical folding mark. Additionally it provides a
-horizontal hole puncher mark, also known as page middle mark. This additional
-mark cannot be moved vertically.
-
-This option activates or deactivates folding marks for vertical
-two-, three- or four-panel folding, and a single horizontal folding, of the
-letter, whereby the folding need not result in equal-sized parts. The position
-of the four horizontal and the single vertical marks are configurable via
-pseudo-lengths (see \autoref{sec:scrlttr2-experts.foldmarks} from
-\DescPageRef{scrlttr2-experts.plength.foldmarkvpos} onwards).
-
-The user has a choice: Either one may use the standard values for simple
-switches, as described in \autoref{tab:truefalseswitch},
-\autopageref{tab:truefalseswitch}, to activate or deactivate at once all
-configured folding marks on the left and upper edges of the paper;
-or\ChangedAt{v2.97e}{\Class{scrlttr2}} one may specify by one or more letters,
-as listed in \autoref{tab:\LabelBase.foldmark}, the use of the individual
-folding marks independently. Also in the latter case the folding marks will only be
-shown if they have not been switched off generally with one of \PValue{false},
-\PValue{off}, or \PValue{no}. The exact positioning of the folding marks is
-specified in the user settings, that is, the \File{lco} files (see
-\autoref{sec:\LabelBase.lcoFile} from \autopageref{sec:\LabelBase.lcoFile} onward)
-chosen for a letter. Default values are \PValue{true} and \PValue{TBMPL}.
+Fold marks\Index{fold mark}, or folding marks, are small horizontal rules in
+the left margin and small vertical rules in the top margin. \KOMAScript{}
+currently provides three configurable horizontal fold marks and one
+configurable vertical fold mark. Additionally it provides a horizontal
+hole-punch or page-centre mark. This additional mark cannot be moved
+vertically.
+
+The \Option{foldmarks} option activates or deactivates fold marks for two,
+three, or four vertical divisions and one horizontal division. The individual
+parts do not have to be of equal size. The positions of three of the four
+horizontal marks and the single vertical mark are configurable via
+pseudo-lengths (see \autoref{sec:scrlttr2-experts.foldmarks} starting on
+\DescPageRef{scrlttr2-experts.plength.foldmarkvpos}).
+
+With the \Option{foldmarks} option, you can either use the default values for
+simple switches described in \autoref{tab:truefalseswitch},
+\autopageref{tab:truefalseswitch} in order to activate or deactivate all
+configured fold marks on the left and upper edges of the paper at once,
+or\ChangedAt{v2.97e}{\Class{scrlttr2}} you can configure the individual fold
+marks independently by specifying one or more letters, as listed in
+\autoref{tab:\LabelBase.foldmark}. In the latter case, the fold marks are only
+shown if they have not been deactivated globally with \PValue{false},
+\PValue{off}, or \PValue{no}. The exact position of the fold marks is depends
+on the user settings or the \File{lco} files (see
+\autoref{sec:\LabelBase.lcoFile} starting on
+\autopageref{sec:\LabelBase.lcoFile}). The default values are \PValue{true}
+and \PValue{TBMPL}.\textnote{default}
%
\begin{table}
% \centering
@@ -992,25 +1017,25 @@ chosen for a letter. Default values are \PValue{true} and \PValue{TBMPL}.
\setcapindent{0pt}%
% \caption
\begin{captionbeside}{%
- Combinable values for the configuration of folding marks with
- option \Option{foldmarks}%
+ Combinable values for configuring fold marks with the
+ \Option{foldmarks} option%
}[l]
\begin{tabular}[t]{ll}
\toprule
- \PValue{B} & activate upper horizontal foldmark on left paper edge\\%
- \PValue{b} & deactivate upper horizontal foldmark on left paper edge\\%
- \PValue{H} & activate all horizontal folding marks on left paper edge\\%
- \PValue{h} & deactivate all horizontal folding marks on left paper edge\\%
- \PValue{L} & activate left vertical foldmark on upper paper edge\\%
- \PValue{l} & deactivate left vertical foldmark on upper paper edge\\%
- \PValue{M} & activate middle horizontal foldmark on left paper edge\\%
- \PValue{m} & deactivate middle horizontal foldmark on left paper edge\\%
- \PValue{P} & activate punch or center mark on left paper edge\\%
- \PValue{p} & deactivate punch or center mark on left paper edge\\%
- \PValue{T} & activate lower horizontal foldmark on left paper edge\\%
- \PValue{t} & deactivate lower horizontal foldmark on left paper edge\\%
- \PValue{V} & activate all vertical folding marks on upper paper edge\\%
- \PValue{v} & deactivate all vertical folding marks on upper paper edge\\%
+ \PValue{B} & activate bottom horizontal fold mark on left paper edge\\%
+ \PValue{b} & deactivate bottom horizontal fold mark on left paper edge\\%
+ \PValue{H} & activate all horizontal fold marks on left paper edge\\%
+ \PValue{h} & deactivate all horizontal fold marks on left paper edge\\%
+ \PValue{L} & activate left vertical fold mark on upper paper edge\\%
+ \PValue{l} & deactivate left vertical fold mark on upper paper edge\\%
+ \PValue{M} & activate middle horizontal fold mark on left paper edge\\%
+ \PValue{m} & deactivate middle horizontal fold mark on left paper edge\\%
+ \PValue{P} & activate hole-punch or centre mark on left paper edge\\%
+ \PValue{p} & deactivate hole-punch or centre mark on left paper edge\\%
+ \PValue{T} & activate top horizontal fold mark on left paper edge\\%
+ \PValue{t} & deactivate top horizontal fold mark on left paper edge\\%
+ \PValue{V} & activate all vertical fold marks on upper paper edge\\%
+ \PValue{v} & deactivate all vertical fold marks on upper paper edge\\%
\bottomrule
\end{tabular}
\end{captionbeside}
@@ -1018,59 +1043,57 @@ chosen for a letter. Default values are \PValue{true} and \PValue{TBMPL}.
\end{table}
%
\begin{Example}
- Assume that you would like to deactivate all folding marks except the punching
- mark. This you can accomplish with, for example:
+ Suppose you want to deactivate all fold marks except the hole-punch mark. If
+ the default has not already been changed, you can deactivate it as follows:
\begin{lstlisting}
\KOMAoptions{foldmarks=blmt}
\end{lstlisting}
- as long as the defaults have not been changed previously. If some changes
- might have been made before, a safer method should be used. This changes our
- example a little bit:
+ If there is a chance that the default has already been changed, you should
+ use a safer method. This changes our example a little bit:
\lstinputcode[xleftmargin=1em]{letter-7}%
The result is shown in \autoref{fig:\LabelBase.letter-7}.
\begin{figure}
\setcapindent{0pt}%
- \begin{captionbeside}[{Example: letter with addressee, opening, text,
- closing, postscript, distribution list, enclosure, and hole puncher
+ \begin{captionbeside}[{Example: letter with recipient, opening, text,
+ closing, postscript, distribution list, enclosure, and hole-punch
mark}]{%
- result of a small letter with addressee, opening, text, closing,
- postscript, distribution list, enclosure, and hole puncher mark
- (the date is a default of DIN-letters)}[l]
+ result of a short letter with recipient, opening, text, closing,
+ postscript, distribution list, enclosure, and hole-punch mark
+ (the date is set by default)}[l]
\frame{\includegraphics[width=.4\textwidth]{letter-7}}
\end{captionbeside}
\label{fig:\LabelBase.letter-7}
\end{figure}
\end{Example}
\BeginIndex{FontElement}{foldmark}\LabelFontElement{foldmark}%
-The color of the folding mark may be changed
-using\ChangedAt{v2.97c}{\Class{scrlttr2}} using the commands
-\DescRef{\LabelBase.cmd.setkomafont} and
-\DescRef{\LabelBase.cmd.addtokomafont} (see
+You\ChangedAt{v2.97c}{\Class{scrlttr2}} can change the colour of the fold mark
+with the \DescRef{\LabelBase.cmd.setkomafont} and
+\DescRef{\LabelBase.cmd.addtokomafont} commands (see
\autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont})
-with element \FontElement{foldmark}. Default is not change.%
-\EndIndex{FontElement}{foldmark}%
-%
+with the \FontElement{foldmark} element. The default is no change.%
\EndIndexGroup
\begin{Declaration}
\OptionVName{enlargefirstpage}{simple switch}
\end{Declaration}
-The first page of a letter always uses a different page layout. The
-\Class{scrlttr2} class provides a mechanism to calculate height and vertical
-alignment of header and footer of the first page independently of the
-following pages. If, as a result, the footer of the first page would reach
-into the text area, this text area is automatically made smaller using the
-\Macro{enlargethispage}\IndexCmd{enlargethispage} macro. On the other hand, if
-the text area should become larger, supposing that the footer on the first
-page allows that, you can use this option. At best, a little more text will
-then fit on the first page. See also the description of the pseudo-length
-\PLength{firstfootvpos} on
-\DescPageRef{scrlttr2-experts.plength.firstfootvpos}. This option can
-take the standard values for simple switches, as listed in
-\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. Default is
-\PValue{false}.
-%
+\begin{Explain}
+ The first page of a letter always uses a different page layout because of
+ the many predefined elements such as the letterhead or the address. The
+ \Class{scrlttr2} class provides a mechanism to calculate height and vertical
+ alignment of header and footer of the first page independently of the
+ subsequent pages. If, as a result, the footer of the first page would
+ protrude into the text area, this text area of the first page is
+ automatically reduced using
+ \Macro{enlargethispage}\IndexCmd{enlargethispage}.
+\end{Explain}
+If the text area should become larger, assuming the footer on the first page
+permits this, you can use this option. At best, a little more text will then
+fit on the first page. See also the description of the \PLength{firstfootvpos}
+pseudo-length on \DescPageRef{scrlttr2-experts.plength.firstfootvpos}. This
+option takes the standard values for simple switches, as listed in
+\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. The default
+is \PValue{false}.\textnote{default}%
\EndIndexGroup
@@ -1078,12 +1101,12 @@ take the standard values for simple switches, as listed in
\OptionVName{firsthead}{simple switch}
\end{Declaration}
\BeginIndex{}{letterhead}%
-\BeginIndex{}{letter>head}%
+\BeginIndex{}{letter>header}%
The\ChangedAt{v2.97e}{\Class{scrlttr2}} letterhead is usually the topmost
-element of the note paper. This option determines whether the letterhead will
-be typeset at all. The option accepts the standard values for simple keys,
-given in \autoref{tab:truefalseswitch} at
-\autopageref{tab:truefalseswitch}. Default is for the letterhead to be set.%
+element of the letterhead page. With the \Option{firsthead} option, you can
+choose whether the letterhead will be typeset at all. The option accepts the
+standard values for simple switches given in \autoref{tab:truefalseswitch} on
+\autopageref{tab:truefalseswitch}. The default is to typeset the letterhead.%
%
\EndIndexGroup
@@ -1093,47 +1116,49 @@ given in \autoref{tab:truefalseswitch} at
\end{Declaration}
\BeginIndex{}{letterhead}%
\BeginIndex{}{letter>head}%
-Option\important{\Option{fromalign}} \Option{fromalign} defines the placement
-of the return address in the letterhead of the first page. Apart from the
-various options for positioning the return address in the letterhead, there is
-also the option\ChangedAt{v2.97e}{\Class{scrlttr2}} of adding the return
-address to the sender's extension\Index{sender's
- extension}. Further\textnote{Attention!}, this option serves as a switch to
-activate or deactivate the letterhead extensions. If these extensions are
-deactivated, some other options will have no effect. This will be noted in the
-explanations of the respective options. Possible values for \Option{fromalign}
-are shown in \autoref{tab:\LabelBase.fromalign}. Default is \PValue{left}.%
+The\important{\Option{fromalign}} \Option{fromalign} option determines where
+the sender information should be placed on the first page. In addition to the
+various placement options in the letterhead, you also have the
+ability\ChangedAt{v2.97e}{\Class{scrlttr2}} to accommodate extra sender
+information\Index{extra sender information}. At the same
+time\textnote{Attention!}, this option serves as a central switch to activate
+or deactivate letterhead extensions. If these extensions are deactivated, some
+other options will have no effect. This will be noted in the explanations of
+the respective options. Available values for \Option{fromalign} are shown in
+\autoref{tab:\LabelBase.fromalign}. The default value is \PValue{left}.%
%
\begin{table}
- \caption[{Available values for option \Option{fromalign} with
- \Class{scrlttr2}}]{Available values for option \Option{fromalign} to
+ \caption[{Available values for the \Option{fromalign} option with
+ \Class{scrlttr2}}]{Available values for the \Option{fromalign} option to
define the position of the from address in the letterhead with
\Class{scrlttr2}}
\label{tab:\LabelBase.fromalign}
\begin{desctabular}
\entry{\PValue{center}, \PValue{centered}, \PValue{middle}}{%
- return address centered; an optional logo will be above the extended
- return address; letterhead extensions will be activated}%
+ Sender information is centred inside the letterhead; a logo is
+ placed at the beginning of the extra sender information, if
+ applicable; letterhead extensions are activated.}%
\entry{\PValue{false}, \PValue{no}, \PValue{off}}{%
- standard design will be used for the return address; the letterhead
- extensions are deactivated}%
+ The default design will be used for the sender information; the
+ letterhead extensions are deactivated.}%
\entry{\PValue{left}}{%
- left-justified return address; an optional logo will be right justified;
- letterhead extensions will be activated}%
+ Sender information is left-aligned in the letterhead; a logo is
+ placed right-aligned, if applicable; letterhead extensions are
+ activated.}%
\entry{\PValue{locationleft}, \PValue{leftlocation}}{%
- return address is set left-justified in the sender's extension; a logo,
- if applicable, will be placed above it; the letterhead is automatically
- deactivated but can be reactivated using option
- \DescRef{\LabelBase.option.firsthead}.}%
+ Sender information is left-justified and uses the extra sender
+ information; a logo is placed at the top of it, if applicable; the
+ letterhead is automatically deactivated but can be reactivated using the
+ \DescRef{\LabelBase.option.firsthead} option.}%
\entry{\PValue{locationright}, \PValue{rightlocation},
\PValue{location}}{%
- return address is set right-justified in the sender's extension; a logo,
- if applicable, will be placed above it; the letterhead is automatically
- deactivated but can be reactivated using option
- \DescRef{\LabelBase.option.firsthead}.}%
+ Sender information is right-justified and uses the extra sender
+ information; a logo is placed at the top of it, if applicable; the
+ letterhead is automatically deactivated but can be reactivated using the
+ \DescRef{\LabelBase.option.firsthead} option.}%
\entry{\PValue{right}}{%
- right-justified return address; an optional logo will be left justified;
- letterhead extensions will be activated}%
+ Sender information is right-justified; a logo is placed left-justified,
+ if applicable; letterhead extensions are activated}%
\end{desctabular}
\end{table}
%
@@ -1147,31 +1172,31 @@ are shown in \autoref{tab:\LabelBase.fromalign}. Default is \PValue{left}.%
\end{Declaration}
\BeginIndex{}{letterhead}%
\BeginIndex{}{letter>head}%
-The\important{\Variable{fromname}} sender's name will be determined by
-variable \Variable{fromname}. Thereby the \PName{description} (see also
-\autoref{tab:\LabelBase.fromTerm}, \autopageref{tab:\LabelBase.fromTerm}) will not
-be used by the predefined letterheads.
+The\important{\Variable{fromname}} sender's name is determined by the
+\Variable{fromname} variable. Its \PName{description} (see also
+\autoref{tab:\LabelBase.fromTerm}, \autopageref{tab:\LabelBase.fromTerm}) is
+not used in the default letterheads.
-At\important{\OptionValue{fromrule}{aftername}} the extended letterhead an
-optional horizontal rule below the name may be selected using
+In\important{\OptionValue{fromrule}{aftername}} the extended letterhead, you
+can create a horizontal rule below the sender's name with
\OptionValue{fromrule}{aftername}.
-Alternatively\important[i]{\begin{tabular}{@{}l@{}}
- \KOption{fromrule}\\\quad\PValue{afteraddress}\end{tabular}} this rule may
-be placed below the while sender using \OptionValue{fromrule}{afteraddress}. A
-summary of all available rule position settings shows
-\autoref{tab:\LabelBase.fromrule}. The length of this rule is determined by
-pseudo-length \PLength{fromrulewidth}\IndexPLength[indexmain]{fromrulewidth}.
+Alternatively\important{\OptionValue{fromrule}{afteraddress}} you can place
+this rule below the complete sender information with
+\OptionValue{fromrule}{afteraddress}. A summary of all available settings for
+the rule position is shown in \autoref{tab:\LabelBase.fromrule}. The length of
+this rule is determined by the
+\PLength{fromrulewidth}\IndexPLength[indexmain]{fromrulewidth} pseudo-length.
\begin{table}
- \caption[{Possible values of option \Option{fromrule} with
- \Class{scrlttr2}}]{Possible values of option \Option{fromrule} for the
- position of the rule in the from address with
+ \caption[{Available values of the \Option{fromrule} option with
+ \Class{scrlttr2}}]{Available values of the \Option{fromrule} option for the
+ position of the rule in the sender information with
\Class{scrlttr2}}
\label{tab:\LabelBase.fromrule}
\begin{desctabular}
\entry{\PValue{afteraddress}, \PValue{below}, \PValue{on}, \PValue{true},
\PValue{yes}}{%
- rule below the return address}%
+ rule below the sender's address}%
\entry{\PValue{aftername}}{%
rule directly below the sender's name}%
\entry{\PValue{false}, \PValue{no}, \PValue{off}}{%
@@ -1179,100 +1204,101 @@ pseudo-length \PLength{fromrulewidth}\IndexPLength[indexmain]{fromrulewidth}.
\end{desctabular}
\end{table}
-Default for the rule at the extended letterhead is \PValue{false}. But at the
-standard letterhead the rule will always be placed below the sender's name.
+The default\textnote{default} for the rule with the extended letterhead is
+\PValue{false}. But in the standard letterhead, the rule will always be placed
+below the sender's name.
-The\important{\Variable{fromaddress}} sender's address follows below the
-name. The \PName{content} of variable \Variable{fromaddress} determines this
-address. The \PName{description} (see also \autoref{tab:\LabelBase.fromTerm})
-will not be used at the predefined letterheads
+The\important{\Variable{fromaddress}} sender's address follows below the name.
+The \PName{content} of variable \Variable{fromaddress} determines this
+address. The address \PName{description} (see also
+\autoref{tab:\LabelBase.fromTerm}) is not used in the default letterheads
\BeginIndexGroup
\BeginIndex{FontElement}{fromaddress}\LabelFontElement{fromaddress}%
\BeginIndex{FontElement}{fromname}\LabelFontElement{fromname}%
\BeginIndex{FontElement}{fromrule}\LabelFontElement{fromrule}%
-The font of the whole address is determined by the element
+You can set the font used for the complete sender information with the
\FontElement{fromaddress}\IndexFontElement{fromaddress}%
-\important{\FontElement{fromaddress}}. Modifications to this may be defined
-with element \FontElement{fromname}\IndexFontElement{fromname}%
-\important{\FontElement{fromname}} for the sender's name and with element
+\important{\FontElement{fromaddress}} element. You can define modifications to
+this with the \FontElement{fromname}\IndexFontElement{fromname}%
+\important{\FontElement{fromname}} element for the sender's name, and with the
\FontElement{fromrule}\IndexFontElement{fromrule}%
-\important{\FontElement{fromrule}} for the rule, that may be activated using
-option \Option{fromrule}. Nevertheless changing the font style of the rule
-would make sense. But you may use the elements also to change the color,
-e.\,g. color the rule gray instead of black. See \cite{package:xcolor} for
-information about colors.%
+\important{\FontElement{fromrule}} element for the rule created with the
+\Option{fromrule} option. The default setting does not change the font. For
+the rule, font switching is mainly intended to change the colour of the rule,
+for example to use grey instead of black. See \cite{package:xcolor} for
+information about colours.%
%
\EndIndexGroup
\begin{Example}
- Let's now define the name of the sender at our letter example:
+ Now let's give the sender of our sample letter a name:
\lstinputcode[xleftmargin=1em]{letter-8.tex}
\begin{figure}
\centering
\frame{\includegraphics[width=.4\textwidth]{letter-8}}\quad
\frame{\includegraphics[width=.4\textwidth]{letter-9}}
- \caption[{Example: letter with sender, addressee, opening, text, closing,
+ \caption[{Example: letter with sender, recipient, opening, text, closing,
postscript, distribution list, and enclosure}]
- {result of a small letter with sender, addressee, opening, text, closing,
- postscript, distribution list, and enclosure (date and folding marks are
- defaults of DIN-letters): at left one the standard letterhead using
- \OptionValueRef{\LabelBase}{fromalign}{false}, at right one the
+ {result of a short letter with sender, recipient, opening, text, closing,
+ postscript, distribution list, and enclosure (the date is set by
+ default): on the left, the standard letterhead using
+ \OptionValueRef{\LabelBase}{fromalign}{false}; on the right, the
extended letterhead using \OptionValueRef{\LabelBase}{fromalign}{center}}
\label{fig:\LabelBase.letter-8-9}
\end{figure}
- First of all not the extended but the standard letterhead has been used. The
- result is shown at the left side of \autoref{fig:\LabelBase.letter-8-9}. The
- right side shows almost the same letter but with
- \OptionValueRef{\LabelBase}{fromalign}{center} and therefore with the extended
- letterhead. You may see, that this variation is without any rule.
-
- For the first time \autoref{fig:\LabelBase.letter-8-9} also shows a signature
- below the closing phrase. This has been generated automatically from the
- sender's name. More information about configuration of the signature may be
- found in \autoref{sec:\LabelBase.closing} from
- \autopageref{sec:\LabelBase.closing} onward.
-
- Now, the letter with extended letterhead should use option \Option{fromrule}
- to print a rule below the sender's name:%
+ Initially, the standard rather than the extended letterhead is used. The
+ result can be seen in \autoref{fig:\LabelBase.letter-8-9} on the left. For
+ comparison, the same example is shown on the right with
+ \OptionValueRef{\LabelBase}{fromalign}{center} (that is, with the extended
+ letterhead). You can see that this variation initially has no rule.
+
+ For the first time, \autoref{fig:\LabelBase.letter-8-9} also shows a
+ signature below the closing phrase. This is generated automatically from the
+ sender's name. You can find more information about how to configure the
+ signature in \autoref{sec:\LabelBase.closing}, starting on
+ \autopageref{sec:\LabelBase.closing}.
+
+ Next, the letter with the extended letterhead should use the
+ \Option{fromrule} option to print a rule below the sender's name:%
\lstinputcode[xleftmargin=1em]{letter-11.tex}%
- The result may be found at the right side of
- \autoref{fig:\LabelBase.letter-10-11}.
+ You can see the result on the right in
+ \autoref{fig:\LabelBase.letter-10-11}. By comparison, the same example on
+ the left uses the standard letterhead, which ignores the additional options.
+ %
\begin{figure}
\centering
\frame{\includegraphics[width=.4\textwidth]{letter-10}}\quad
\frame{\includegraphics[width=.4\textwidth]{letter-11}}
- \caption[{Example: letter with sender, separation rule, addressee,
+ \caption[{Example: letter with sender, rule, recipient,
opening, text, closing, signature, postscript, distribution list,
- enclosure, and puncher hole mark}]
- {result of a small letter with sender, separation rule, addressee,
+ enclosure, and hole-punch mark}]
+ {result of a short letter with sender, rule, recipient,
opening, text, closing, signature, postscript, distribution list,
- enclosure and puncher hole mark (the date is a default of DIN-letters):
+ enclosure and hole-punch mark (the date is set by default):
at left one the standard letterhead using
\OptionValueRef{\LabelBase}{fromalign}{false}, at right one the extended letterhead
using \OptionValueRef{\LabelBase}{fromalign}{center}}
\label{fig:\LabelBase.letter-10-11}
\end{figure}
- In difference to this, the left letter has been set once again with the
- standard letter head, that does not react on the additional option.
\end{Example}
An\textnote{Attention!} important note concerns the sender's address: within
-the sender's address, parts such as street, P.O.~Box, state, country, etc.,
-are separated with a double backslash. Depending on how the sender's address
-is used, this double backslash will be interpreted differently and therefore
-is not strictly always a line break. Paragraphs, vertical spacing and the like
-are usually not allowed within the sender's address declaration. One has to
-have very good knowledge of \Class{scrlttr2} to use things like those
-mentioned above, intelligently. Another point to note is the one should most
-certainly set the variables for return address (see variable
-\DescRef{\LabelBase.variable.backaddress}, \DescPageRef{\LabelBase.variable.backaddress}) and
-signature (see variable \DescRef{\LabelBase.variable.signature},
-\DescPageRef{\LabelBase.variable.signature}) oneself.%
+the sender's address, individual parts such as house number and street, city
+and postal code, etc., are separated with a double backslash. This double
+backslash is interpreted differently depending on how the sender's address is
+used and therefore is not necessarily a line break. Paragraphs, vertical
+spacing, and the like are usually not allowed within the sender's information.
+You have to know \KOMAScript{} very well to put such things into the sender
+information, if necessary. In addition, note that if you do so, you should
+definitely set the variables for return address (see
+\DescRef{\LabelBase.variable.backaddress},
+\DescPageRef{\LabelBase.variable.backaddress}) and signature (see
+\DescRef{\LabelBase.variable.signature},
+\DescPageRef{\LabelBase.variable.signature}) yourself.%
%
\EndIndexGroup
-
\begin{Declaration}
\OptionVName{symbolicnames}{simple switch}%
\OptionVName{fromphone}{simple switch}%
@@ -1290,42 +1316,47 @@ signature (see variable \DescRef{\LabelBase.variable.signature},
\Variable{faxseparator}%
\Variable{emailseparator}%
\Variable{urlseparator}%
-\end{Declaration}%
+\end{Declaration}
\BeginIndex{}{letterhead}%
-\BeginIndex{}{letter>head}%
-Whether or not a telephone number\Index{telephone}\Index{phone}, a
-mobile\ChangedAt{v3.12}{\Class{scrlttr2}} telephone number\Index{mobile
- phone}\Index{cell phone}\Index{cellphone}, a fax number\Index{fax}, an
-e-mail address\Index{e-mail}, or a sender's URL should be set as part of the
-letterhead may be configured by the options \Option{fromphone},
-\Option{fromfax}, \Option{fromemail}, and \Option{fromurl}. Any standard value
-for simple switches from \autoref{tab:truefalseswitch},
-\autopageref{tab:truefalseswitch} may be assigned to these options. Default is
-\PValue{false} for all of them. The \PName{contents} depends on the
-corresponding variable. The default of the \PName{description} or title of
-each variable may be found in \autoref{tab:\LabelBase.fromTerm}. The separators,
-that will be inserted between \PName{description} and \PName{content}, may be
-found in \autoref{tab:\LabelBase.fromSeparator}.
-
-You may\ChangedAt{v3.12}{\Class{scrlttr2}}\important{\Option{symbolicnames}}
-change the defaults for the description of the separator variables at once
-using option \Option{symbolicnames}. The option understands the values for
-simple switches from \autoref{tab:truefalseswitch},
-\autopageref{tab:truefalseswitch}. Switching on the option replaces the
-descriptions from the language depending terms \DescRef{scrlttr2-experts.cmd.emailname},
-\DescRef{scrlttr2-experts.cmd.faxname}, \DescRef{scrlttr2-experts.cmd.mobilephonename}, and \DescRef{scrlttr2-experts.cmd.phonename} into symbols
-of the package \Package{marvosym}\IndexPackage{marvosym}. Also the colon will
-be removed from the content of the separator variables. And in this case the
-description and the content of the URL separator will be
-empty. Note\textnote{Attention!}, that you have to load package
-\Package{marvosym} on your own, if you switch on \Option{symbolicnames}
-first time after \Macro{begin}\PParameter{document}.
+\BeginIndex{}{letter>header}
+\iffree{\clearpage}{}
+You can use the five options \Option{fromphone}, \Option{fromfax},
+\Option{fromemail}, and \Option{fromurl} to specify whether to include the
+phone number\Index{telephone}\Index{phone},
+mobile\ChangedAt{v3.12}{\Class{scrlttr2}} phone number\Index{mobile
+phone}\Index{cell phone}\Index{cellphone}, fax number\Index{fax}, e-mail
+address\Index{e-mail}, or sender's URL should be as part of the sender's
+information. You can assign any standard value for simple switches from
+\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} to these
+options. The default for all of them is \PValue{false}. The \PName{contents}
+themselves are determined by the variables of the same name. You can find the
+defaults for the \PName{description} or title of each variable in
+\autoref{tab:\LabelBase.fromTerm}. You can find the separators that will be
+inserted between the \PName{description} and the \PName{content} in
+\autoref{tab:\LabelBase.fromSeparator}.
+
+You can\ChangedAt{v3.12}{\Class{scrlttr2}}\important{\Option{symbolicnames}}
+change the defaults for describing the variables all at once with the
+\Option{symbolicnames} option. This option understands the values for simple
+switches found in \autoref{tab:truefalseswitch},
+\autopageref{tab:truefalseswitch}. Activating the option replaces the
+descriptions from the language-dependant labels of
+\DescRef{scrlttr2-experts.cmd.emailname},
+\DescRef{scrlttr2-experts.cmd.faxname},
+\DescRef{scrlttr2-experts.cmd.mobilephonename}, and
+\DescRef{scrlttr2-experts.cmd.phonename} with symbols from the
+\Package{marvosym}\IndexPackage{marvosym} package. At the same time, the colon
+is omitted when defining the separators. In this case, both the description
+and the content of the URL separator will be empty. Note\textnote{Attention!}
+that you have to load the \Package{marvosym} package on your own if you activate
+\Option{symbolicnames} for the first time after
+\Macro{begin}\PParameter{document}.
\begin{table}
\centering
- \caption[{Predefined descriptions of the variables of the
- letterhead}]{Predefined descriptions of the variables of the letterhead
- (the description and contents of the separator variables may be found at
+ \caption[{Default descriptions of the letterhead variables}]{Default
+ descriptions of the letterhead variables (you can find the description and
+ contents of the separator variables in
\autoref{tab:\LabelBase.fromSeparator}}
\begin{desctabular}[1.8em]
\ventry{fromemail}{\DescRef{\LabelBase.cmd.usekomavar*}\PParameter{emailseparator}%
@@ -1346,13 +1377,12 @@ first time after \Macro{begin}\PParameter{document}.
\end{table}
\begin{table}[tp]
-% \centering
- \KOMAoptions{captions=topbeside}%
- \setcapindent{0pt}%
-% \caption
- \begin{captionbeside}{Predefined description and content of the separators
- at the letterhead without option \Option{symbolicnames}}
- [l]
+ \centering
+% \KOMAoptions{captions=topbeside}%
+% \setcapindent{0pt}%
+ \caption{Default descriptions and contents of the letterhead
+ separators without the \Option{symbolicnames} option}
+% [l]
\begin{tabular}[t]{lll}
\toprule
variable name & description & content \\
@@ -1364,56 +1394,58 @@ first time after \Macro{begin}\PParameter{document}.
\Variable{urlseparator} & \DescRef{scrlttr2-experts.cmd.wwwname} & \texttt{:\~} \\
\bottomrule
\end{tabular}
- \end{captionbeside}
+% \end{captionbeside}
\label{tab:\LabelBase.fromSeparator}
\end{table}
\begin{Example}
- Mr Public from the example letter has telephone and e-mail. He wants to show
- this also in the letterhead. Furthermore the separation rule should be
- placed below the letterhead. So he uses the corresponding options and
- defines the content of the needed variables:%
+ Mr Public from our sample letter has a telephone and an e-mail address. He
+ also wants to show these in the letterhead. At the same time, the separation
+ rule should now be placed after the letterhead. So he uses the appropriate
+ options and also sets the required variables:%
\lstinputcode[xleftmargin=1em]{letter-12.tex}%
- Nevertheless the result at the left side of
- \autoref{fig:\LabelBase.letter-12-13} is not disillusioning: the options are
- ignored. That's the case because the additional variables and options will
- be used at the extended letterhead only. So option \DescRef{\LabelBase.option.fromalign} has to
- be used, like done at the right letter of
+ The results on the left side of \autoref{fig:\LabelBase.letter-12-13},
+ however, are confounding: the options are ignored. That's because the
+ additional variables and options are only used in the extended letterhead.
+ So the \DescRef{\LabelBase.option.fromalign} option must be used, as it is
+ in the right side of
\autoref{fig:\LabelBase.letter-12-13}.
\begin{figure}
\centering
\frame{\includegraphics[width=.4\textwidth]{letter-12}}\quad
\frame{\includegraphics[width=.4\textwidth]{letter-13}}
- \caption[{Example: letter with extended sender, separation rule, addressee,
- opening, text, closing, signature, postscript, distribution list,
- enclosure, and puncher hole mark; standard vs. extended letterhead}]
- {result of a small letter with sender, separation rule, addressee,
- opening, text, closing, signature, postscript, distribution list,
- enclosure and puncher hole mark (the date is a default of DIN-letters):
- at left one the standard letterhead using
- \OptionValueRef{\LabelBase}{fromalign}{false}, at right one the extended letterhead
- using \OptionValueRef{\LabelBase}{fromalign}{center}}
+ \caption[{Example: letter with extra sender information, rule,
+ recipient, opening, text, closing, signature, postscript, distribution
+ list, enclosure, and hole-punch mark; standard vs. extended letterhead}]
+ {result of a short letter with sender, rule, recipient, opening, text,
+ closing, signature, postscript, distribution list, enclosure and
+ hole-punch mark (the date is set by default): the left one uses the
+ standard letterhead with
+ \OptionValueRef{\LabelBase}{fromalign}{false}; the right one uses the
+ extended letterhead with \OptionValueRef{\LabelBase}{fromalign}{center}}
\label{fig:\LabelBase.letter-12-13}
\end{figure}
\lstinputcode[xleftmargin=1em]{letter-13.tex}
- An arrangement of alternatives with left aligned using
- \OptionValueRef{\LabelBase}{fromalign}{left} and right aligned sender
- using \OptionValueRef{\LabelBase}{fromalign}{right} may be found in
+ You can compare two other alternatives with left-aligned sender information using
+ \OptionValueRef{\LabelBase}{fromalign}{left} and right-aligned sender information
+ using \OptionValueRef{\LabelBase}{fromalign}{right} in
\autoref{fig:\LabelBase.letter-14-15}.
\begin{figure}
\centering
\frame{\includegraphics[width=.4\textwidth]{letter-14}}\quad
\frame{\includegraphics[width=.4\textwidth]{letter-15}}
- \caption[{Example: letter with extended sender, separation rule, addressee,
- opening, text, closing, signature, postscript, distribution list,
- enclosure, and puncher hole mark; left vs. right aligned letterhead}]
- {result of a small letter with sender, separation rule, addressee,
- opening, text, closing, signature, postscript, distribution list,
- enclosure and puncher hole mark (the date is a default of DIN-letters):
- at left one left aligned letterhead using
- \OptionValueRef{\LabelBase}{fromalign}{left}, at right one right aligned letterhead
- using \OptionValueRef{\LabelBase}{fromalign}{right}}
+ \caption[{Example: letter with extra sender information, rule,
+ recipient, opening, text, closing, signature, postscript, distribution
+ list, enclosure, and hole-punch mark; left- vs. right-aligned
+ letterhead}]
+ {result of a short letter with extra sender information, rule,
+ recipient, opening, text, closing, signature, postscript, distribution
+ list, enclosure and hole-punch mark (the date is set by default):
+ the left one uses a left-aligned letterhead with
+ \OptionValueRef{\LabelBase}{fromalign}{left}; the right one uses a
+ right-aligned letterhead using
+ \OptionValueRef{\LabelBase}{fromalign}{right}}
\label{fig:\LabelBase.letter-14-15}
\end{figure}
\end{Example}
@@ -1427,37 +1459,38 @@ first time after \Macro{begin}\PParameter{document}.
\end{Declaration}
\BeginIndex{}{letterhead}%
\BeginIndex{}{letter>head}%
-With option \Option{fromlogo} you may configure whether or not to use a
-logo\Index{Logo} at the letterhead. The option value may be any \PName{simple
- switch} from \autoref{tab:truefalseswitch},
-\autopageref{tab:truefalseswitch}. Default is \PValue{false}, that means no
-logo. The logo itself is defined by the \PName{content} of variable
-\Variable{fromlogo}. The \PName{description} of the logo is empty by default
-and \KOMAScript{} does not use it anywhere at the predefined note papers (see
-also \autoref{tab:\LabelBase.fromTerm}).%
+You can use the \Option{fromlogo} to configure whether to put a
+logo\Index{Logo} in the letterhead. You can use any of the default values from
+\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} for the
+\PName{simple switch}. The default is \PValue{false}, which means no logo. The
+logo itself is defined by the \PName{content} of the \Variable{fromlogo}
+variable. The \PName{description} of the logo is empty by default and
+\KOMAScript{} does not use it in the default letterhead pages (see also
+\autoref{tab:\LabelBase.fromTerm}).%
\begin{Example}
- Mr Public likes to use a letterhead with logo. He generated a graphics file
- with the logo and would like to include this using
- \Macro{includegraphics}. Therefor he uses the additional package
- \Package{graphics}\IndexPackage{graphics} (see \cite{package:graphics}).%
+ Mr Public finds it particularly stylish when he provides his letterhead with
+ a logo. He has saved his logo as a graphics file, which he would like to
+ load using \Macro{includegraphics}. To do this, he uses the loads the
+ \Package{graphics}\IndexPackage{graphics} package (see
+ \cite{package:graphics}).%
\lstinputcode[xleftmargin=1em]{letter-16}%
- The result may be seen at the left top position of
- \autoref{fig:\LabelBase.letter-16-18}. The additional letter prints at this
- figure shows the result with right aligned or centered sender.
+ You can see the result in the top left of
+ \autoref{fig:\LabelBase.letter-16-18}. The other two images in this figure
+ show the results with right-aligned and centred sender information.
\begin{figure}
\setcapindent{0pt}%
{\hfill
\frame{\includegraphics[width=.4\textwidth]{letter-16}}\quad
\frame{\includegraphics[width=.4\textwidth]{letter-17}}\par\bigskip}
- \begin{captionbeside}[{Example: letter with extended sender, logo,
- separation rule, addressee, opening, text, closing, signature,
- postscript, distribution list, enclosure, and puncher hole mark; left
- vs. right aligned vs. centered sender}]
- {result of a small letter with extended sender, logo, separation rule,
- addressee, opening, text, closing, signature, postscript, distribution
- list, enclosure and puncher hole mark (the date is a default of
- DIN-letters): at top left one left aligned sender using, at right
- beneath one with centered sender, and at right one right aligned
+ \begin{captionbeside}[{Example: letter with extra sender information,
+ logo, rule, recipient, opening, text, closing, signature, postscript,
+ distribution list, enclosure, and hole-punch mark; left-aligned vs.
+ right-aligned vs. centred sender information}]
+ {result of a short letter with extra sender information, logo, rule,
+ recipient, opening, text, closing, signature, postscript, distribution
+ list, enclosure and hole-punch mark (the date is set by default):
+ at top left the sender is left-aligned, at top right the sender is
+ centred, and at bottom right the sender is right-aligned
sender}[l]
\frame{\includegraphics[width=.4\textwidth]{letter-18}}\quad
\end{captionbeside}
@@ -1471,35 +1504,26 @@ also \autoref{tab:\LabelBase.fromTerm}).%
\begin{Declaration}
\Variable{firsthead}%
\end{Declaration}
-\BeginIndex{}{letterhead}%
-\BeginIndex{}{letter>head}%
-For many cases, \Class{scrlttr2} with its options and variables offers
-enough possibilities to create a letterhead. In very rare situations
-one may wish to have more freedom in terms of layout. In those
-situations one will have to do without predefined letterheads, which
-could have been chosen via options. Instead, one needs to create one's
-own letterhead from scratch. To do so, one has to define the preferred
-construction as content of variable \Variable{firsthead}. Within
-\Macro{firsthead}, and with the help of the \Macro{parbox} command
-(see \cite{latex:usrguide}), one can set several boxes side by side,
-or one underneath the other. An advanced user will thus be able to
-create a letterhead on his own. Of course the construct may
-and should use other variables with the help of
+In many cases, the capabilities that \Class{scrlttr2} offers with the
+foregoing options and variables will be sufficient to design a letterhead. In
+some cases, however, you may want even more flexibility. In those situations,
+you will have to do without the possibilities offered by the predefined
+letterhead, which you can select via the options described above. Instead, you
+must create your own letterhead from scratch. To do so, you must specify the
+desired structure as the \PName{contents} of the \Variable{firsthead}
+variable. For example, you can set several boxes side by side or one beneath
+the other using the \Macro{parbox} command (see \cite{latex:usrguide}).
+Experienced users should thus be able to create their own a letterheads. Of
+course you can and should use other variables with
\DescRef{\LabelBase.cmd.usekomavar}. \KOMAScript{} does not use the
-\PName{description} of variable \Variable{firsthead}.
-\iffree{}{A detailed example for the definition of a letterhead will be shown
- in \autoref{cha:modernletters}.}
-
-The\textnote{Attention!} command
-\Macro{firsthead}\IndexCmd[indexmain]{firsthead} exists only for reason of
-compatibility to former \Class{scrlttr2} versions. However it is deprecated
-and you should not use it anymore.%
-%
+\PName{description} of variable \Variable{firsthead}. \iffree{}{You can find
+ a detailed example of a letterhead definition in
+ \autoref{cha:modernletters}.}%
\EndIndexGroup
\begin{Declaration}
- \OptionVName{addrfield}{mode}%
+ \OptionVName{addrfield}{format}%
\OptionVName{backaddress}{value}%
\OptionVName{priority}{priority}%
\Variable{toname}%
@@ -1514,110 +1538,112 @@ and you should not use it anymore.%
\Variable{PPdatamatrix}%
\Variable{addresseeimage}%
\end{Declaration}%
-\BeginIndex{}{addressee}%
+\BeginIndex{}{address}%
+The \Option{addrfield} option determines whether or not to print an address
+field. The default\textnote{default} is to include an address field. The
+option recognizes the formats described in
+\autoref{tab:\LabelBase.addrfield}\ChangedAt{v3.03}{\Class{scrlttr2}}. With
+the values \PValue{true},
+\PValue{topaligned}\ChangedAt{v3.17}{\Class{scrlttr2}\and
+\Package{scrletter}}, \PValue{PP}, and \PValue{backgroundimage}, the name and
+address of the recipient are determined by the mandatory argument of the
+\DescRef{\LabelBase.env.letter} environment (see
+\autoref{sec:\LabelBase.document}, \DescPageRef{\LabelBase.env.letter}). This
+information is also copied into the variables \Variable{toname} and
+\Variable{toaddress}.
+
\BeginIndexGroup
\BeginIndex{FontElement}{addressee}\LabelFontElement{addressee}%
\BeginIndex{FontElement}{toname}\LabelFontElement{toname}%
\BeginIndex{FontElement}{toaddress}\LabelFontElement{toaddress}%
-Option \Option{addrfield} defines whether or not to set an address
-field. Default is to use an address field. This option can take the mode
-values from
-\autoref{tab:\LabelBase.addrfield}\ChangedAt{v3.03}{\Class{scrlttr2}}. Default
-is \PValue{true}. With values \PValue{true},
-\PValue{topaligned}\ChangedAt{v3.17}{\Class{scrlttr2}\and
- \Package{scrletter}}, \PValue{PP}, and
-\PValue{backgroundimage} name and address of the addressee will be defined by
-the mandatory argument of the \DescRef{\LabelBase.env.letter} environment (see
-\autoref{sec:\LabelBase.document},
-\DescPageRef{\LabelBase.env.letter}). These elements will additionally be
-copied into the variables \Variable{toname} and \Variable{toaddress}. The
-predefined font styles may be changed\ChangedAt{v2.97c}{\Class{scrlttr2}} by
-execution of command \DescRef{\LabelBase.cmd.setkomafont} or \DescRef{\LabelBase.cmd.addtokomafont} (siehe
+You can change the default font styles\ChangedAt{v2.97c}{\Class{scrlttr2}}
+with the \DescRef{\LabelBase.cmd.setkomafont} or
+\DescRef{\LabelBase.cmd.addtokomafont} commands (see
\autoref{sec:\LabelBase.textmarkup},
-\DescPageRef{\LabelBase.cmd.setkomafont}). Thereby three elements
-exist. First of all element
-\FontElement{addressee}\important{\FontElement{addressee}}, that is
-responsible for the addressee overall. The additional elements
-\FontElement{toname}\important{\FontElement{toname}} and
+\DescPageRef{\LabelBase.cmd.setkomafont}). There are three elements. First,
+the \FontElement{addressee}\important{\FontElement{addressee}} element is
+responsible for the overall style of the recipient's name and address. The
+elements \FontElement{toname}\important{\FontElement{toname}} and
\FontElement{toaddress}\important{\FontElement{toaddress}} are responsible
-only either for the name or the address of the addressee. They may be used to
-define modifications from the \FontElement{addressee} configuration.%
+only for the name and the address of the recipient, respectively. You can use
+\FontElement{toname} and \FontElement{toaddress} to define modifications from
+the basic \FontElement{addressee} configuration.%
\EndIndexGroup
-
+%
\begin{table}
- \caption[{available values for option \Option{addrfield} using
- \Class{scrlttr2}}]{available values for option \Option{addrfield} to
- change the addressee mode of \Class{scrlttr2}}%
+ \caption[{available values for the \Option{addrfield} option with
+ \Class{scrlttr2}}]{available values for the \Option{addrfield} option to
+ change the recipient format of \Class{scrlttr2}}%
\label{tab:\LabelBase.addrfield}%
\begin{desctabular}
\entry{\PValue{backgroundimage}, \PValue{PPbackgroundimage},
\PValue{PPBackgroundImage}, \PValue{PPBackGroundImage},
\PValue{ppbackgroundimage}, \PValue{ppBackgroundImage},
\PValue{ppBackGroundImage}}{%
- Prints an address field with Port-Pay\'e head, in variable
- \Variable{addresseimage} defined background graphics, but without return
- address or mode of dispatch.}%
+ Prints an address with a background image stored in the
+ \Variable{addresseimage} variable as the postpaid postmark, but without
+ a return address or delivery type.}%
\entry{\PValue{false}, \PValue{off}, \PValue{no}}{%
- Omits the address field.}%
+ Does not print an address.}%
\entry{\PValue{image}, \PValue{Image}, \PValue{PPimage}, \PValue{PPImage},
\PValue{ppimage}, \PValue{ppImage}}{%
- Prints variable \Variable{addresseeimage} as addressee with Port-Pay\'e,
- but ignores addressee information and definitions for return address,
- mode of dispatch or priority.}%
+ Prints an image stored in the \Variable{addresseeimage} variable as an
+ address with a postpaid postmark. Recipient information, return address,
+ and delivery type or priority are ignored.}%
\entry{\PValue{PP}, \PValue{pp}, \PValue{PPexplicite},
\PValue{PPExplicite}, \PValue{ppexplicite}, \PValue{ppExplicite}}{%
- Prints an address field with Port-Pay\'e head, defined by the variables
- \Variable{fromzipcode}, \Variable{place}, and \Variable{PPcode} and when
- indicated with priority and data array defined by
- \Variable{PPdatamatrix} but without return address and mode of
- dispatch.}%
+ Prints an address with a postage print impression (pospaid) header
+ filled in with the variables \Variable{fromzipcode}, \Variable{place},
+ and \Variable{PPcode}, and when applicable with a priority and a data
+ array defined by \Variable{PPdatamatrix}, but without a return address
+ or delivery type.}%
\entry{\PValue{topaligned}, \PValue{alignedtop}%
\ChangedAt{v3.17}{\Class{scrlttr2}\and \Package{scrletter}}}{%
- Prints an address field including a return address and a mode of
- dispatch or priority without centring the address vertically in the
- available space.}%
+ Prints an address including a return address and a delivery type
+ or priority. The address is not centred vertically beneath the delivery
+ type.}%
\entry{\PValue{true}, \PValue{on}, \PValue{yes}}{%
- Prints an address field including a return address and a mode of
- dispatch or priority.}%
+ Prints an address field including a return address and delivery type
+ or priority.}%
\end{desctabular}
\end{table}%
-With the default \OptionValue{addrfield}{true} an additional return address
-will be printed. Option \Option{backaddress} defines whether a return address
-for window envelopes will be set. This
-option\important{\OptionValue{backaddress}{false}} can take the standard
-values for simple switches, as listed in \autoref{tab:truefalseswitch},
+The default \OptionValue{addrfield}{true} also prints an underlined return
+address in the address field. The \Option{backaddress} option defines if and
+in what form a return address will be printed for window envelopes. On the one
+hand, this option\important{\OptionValue{backaddress}{false}} accepts the
+standard values for simple switches listed in \autoref{tab:truefalseswitch},
\autopageref{tab:truefalseswitch}. These values do not change style of the
-return address. On the other hand,
-additionally\ChangedAt{v2.96}{\Class{scrlttr2}} to switching on the return
-address, the style of the return address may be selected. Option value
-\PValue{underlined} selects an underlined return address. In opposite to
-this value \PValue{plain}\important{\OptionValue{backaddress}{plain}} selects
-a style without underline. Default is \PValue{underlined} and therefore
-printing an underlined return address.
-
-\BeginIndex{FontElement}{backaddress}\LabelFontElement{backaddress}%
-The return address itself is defined by the \PName{content} of variable
-\Variable{backaddress}. Default is a combination of variable \Variable{toname}
-and \Variable{toaddress} with redefinition of the double backslash to set the
-\PName{content} of variable \Variable{backaddressseparator}. The predefined
-separator \PName{content} is a comma followed by a non-breakable white
-space. The \PName{description} of variable \Variable{backaddress} is not used
-by \KOMAScript. The font style of the return address is configurable via
-element
-\FontElement{backaddress}\important{\FontElement{backaddress}}. Default for
-this is \Macro{sffamily} (see
-\autoref{tab:\LabelBase.AddresseeElements}). Before execution of the element's
-font style \KOMAScript{} switches to \Macro{scriptsize}.%
-\EndIndex{FontElement}{backaddress}%
-
-By default, \OptionValue{addrfield}{true}, the address will be vertically
-centred in the available space below the mode of dispatch or
-priority. In\ChangedAt{v3.17}{\Class{scrlttr2}\and \Package{scrletter}}
-opposite to this, \OptionValue{addrfield}{topaligned}%
+return address. On the other hand, when\ChangedAt{v2.96}{\Class{scrlttr2}} the
+return address is enabled, you can select its format at the same time. For
+example, the \PValue{underlined} option value enables an underlined return
+address, while \PValue{plain}\important{\OptionValue{backaddress}{plain}}
+selects a style without underlining. The default is \PValue{underlined} and
+thus prints an underlined return address.
+
+The return address itself is defined by the \PName{content} of the
+\Variable{backaddress} variable. The default is the name specified in
+\DescRef{\LabelBase.variable.fromname} and the address specified in
+\DescRef{\LabelBase.variable.fromaddress}. The double backslash is also
+replaced with the \PName{content} of the \Variable{backaddressseparator}
+variable. The default separator is a comma followed by a non-breaking space.
+\KOMAScript{} does not use the \PName{description} of the
+\Variable{backaddress} variable.
+\BeginIndexGroup\BeginIndex{FontElement}{backaddress}%
+\LabelFontElement{backaddress}%
+You can configure the font style of the return address via the
+\FontElement{backaddress}\important{\FontElement{backaddress}} element. The
+default is \Macro{sffamily} (see \autoref{tab:\LabelBase.AddresseeElements}).
+Before applying the element's font style \KOMAScript{} switches to
+\Macro{scriptsize}.%
+\EndIndexGroup
+
+The default \OptionValue{addrfield}{true}, centres the address vertically
+within the space available for the address.
+In\ChangedAt{v3.17}{\Class{scrlttr2}\and \Package{scrletter}} contrast,
+\OptionValue{addrfield}{topaligned}%
\important{\OptionValue{addrfield}{topaligned}} will not centre the address
-but follow it aligned top at the available space. This is the only difference
-to \OptionValue{addrfield}{true}.%
+but place it flush with the top of the available space.%
\begin{table}
% \centering
@@ -1625,7 +1651,7 @@ to \OptionValue{addrfield}{true}.%
\setcapindent{0pt}%
% \caption
\begin{captionbeside}{%
- Predefined font style for the elements of the address field.%
+ Default font styles for the elements of the address field.%
}%
[l]
\begin{tabular}[t]{ll}
@@ -1663,52 +1689,54 @@ to \OptionValue{addrfield}{true}.%
\label{tab:\LabelBase.AddresseeElements}%
\end{table}
-\BeginIndex{FontElement}{specialmail}\LabelFontElement{specialmail}%
-At the default \OptionValue{addrfield}{true} an optional dispatch
-type\Index{mode of dispatch}\Index{dispatch type} can be output within the
-address field between the return address and the addressee address, This will
-be done only if variable \Variable{specialmail} is not empty and
+\BeginIndexGroup
+\BeginIndex{FontElement}{specialmail}\LabelFontElement{specialmail}
+With the default \OptionValue{addrfield}{true} setting, you can output an
+optional delivery type\Index{delivery type} between the return address and the
+recipient address. This will be output only if the \Variable{specialmail}
+variable has non-empty content and
\OptionValue{priority}{manual}\ChangedAt{v3.03}{\Class{scrlttr2}} has been
-selected, which is also the default. Class \Class{scrlttr2} itself does not use
-the \PName{description} of variable \Variable{specialmail}. The alignment is
-defined by the pseudo-lengths PLength{specialmailindent} and
-\PLength{specialmailrightindent} (siehe
-\DescPageRef{scrlttr2-experts.plength.specialmailindent}). The predefined
-font style of element\ChangedAt{v2.97c}{\Class{scrlttr2}}
-\FontElement{specialmail}\important{\FontElement{specialmail}}, that has been
-listed in \autoref{tab:\LabelBase.AddresseeElements}, may be changed using
-commands \DescRef{\LabelBase.cmd.setkomafont} and \DescRef{\LabelBase.cmd.addtokomafont} (see
+selected, which is the default. The \Class{scrlttr2} class itself does not use
+the \PName{description} of the \Variable{specialmail} variable. The alignment
+is defined by the \PLength{specialmailindent} and
+\PLength{specialmailrightindent} pseudo-lengths (see
+\DescPageRef{scrlttr2-experts.plength.specialmailindent}). You can change the
+default font style of the\ChangedAt{v2.97c}{\Class{scrlttr2}}
+\FontElement{specialmail}\important{\FontElement{specialmail}} element, which
+is listed in \autoref{tab:\LabelBase.AddresseeElements}, with the
+\DescRef{\LabelBase.cmd.setkomafont} and
+\DescRef{\LabelBase.cmd.addtokomafont} commands (see
\autoref{sec:\LabelBase.textmarkup},
\DescPageRef{\LabelBase.cmd.setkomafont}).%
-\EndIndex{FontElement}{specialmail}%
+\EndIndexGroup
\BeginIndexGroup
\BeginIndex{FontElement}{priority}\LabelFontElement{priority}%
\BeginIndex{FontElement}{prioritykey}\LabelFontElement{prioritykey}%
-\BeginIndex{FontElement}{PPlogo}\LabelFontElement{PPlogo}%
-On\ChangedAt{v3.03}{\Class{scrlttr2}}\important[i]{\OptionValue{priority}{A}\\
- \OptionValue{priority}{B}} the other hand, using an international priority
+However\ChangedAt{v3.03}{\Class{scrlttr2}}\important{\normalcolor
+ \OptionValue{priority}{A}\\
+ \normalcolor\OptionValue{priority}{B}}, selecting an international priority
with \OptionValue{priority}{A} or \OptionValue{priority}{B} (see
-\autoref{tab:\LabelBase.priority}) together with \OptionValue{addrfield}{true}
-will print the priority as mode of dispatch. Using it together with
-\OptionValue{addrfield}{PP}\important{\OptionValue{addrfield}{PP}} will print
-the priority at the corresponding position in the Port-Pay\'e head. Thereby
-the element \FontElement{priority} defines the basic font style and
-\FontElement{prioritykey} the modification of the basic font style for the
-priority key, ``A'' or ``B''. The Port-Pay\'e logo ``P.~P.'' uses the font
-style of element \FontElement{PPlogo}. The default font styles are listed in
-\autoref{tab:\LabelBase.AddresseeElements} and may be changed using commands
-\DescRef{\LabelBase.cmd.setkomafont} und
-\DescRef{\LabelBase.cmd.addtokomafont} (siehe
+\autoref{tab:\LabelBase.priority}) together with
+\OptionValue{addrfield}{true}, prints the priority as the delivery type. Using
+it together with
+\OptionValue{addrfield}{PP}\important{\OptionValue{addrfield}{PP}} prints the
+priority at the corresponding position in the postpaid postmark (also known as
+the postage print impression or \emph{port pay\'e}). The \FontElement{priority}
+element defines the basic font style, and \FontElement{prioritykey} defines
+the modification of the basic font style for the priority keys ``A'' or ``B''.
+You can find the default font styles listed in
+\autoref{tab:\LabelBase.AddresseeElements} and can change then using the
+\DescRef{\LabelBase.cmd.setkomafont} and
+\DescRef{\LabelBase.cmd.addtokomafont} commands (see
\autoref{sec:\LabelBase.textmarkup},
\DescPageRef{\LabelBase.cmd.setkomafont}).%
\EndIndexGroup
-
\begin{table}
- \caption[{available values for option \Option{priority} in
- \Class{scrlttr2}}]{available values for option \Option{priority} to select
- the international priority at the address field of\Class{scrlttr2}}
+ \caption[{available values for the \Option{priority} option in
+ \Class{scrlttr2}}]{available values for the \Option{priority} option to
+ select the international priority in the address field of\Class{scrlttr2}}
\label{tab:\LabelBase.priority}
\begin{desctabular}
\entry{\PValue{false}, \PValue{off}, \PValue{no}, \PValue{manual}}{%
@@ -1717,99 +1745,106 @@ style of element \FontElement{PPlogo}. The default font styles are listed in
\PValue{ECONOMY}, \PValue{B-ECONOMY}, \PValue{B-Economy},
\PValue{b-economy}}{%
Use international priority B-Economy. With
- \OptionValue{addrfield}{true} this will be printed instead of the mode
- of dispatch.}%
+ \OptionValue{addrfield}{true}, this is printed instead of the delivery
+ type.}%
\entry{\PValue{A}, \PValue{a}, \PValue{priority}, \PValue{Priority},
\PValue{PRIORITY}, \PValue{A-PRIORITY}, \PValue{A-Priority},
\PValue{a-priority}}{%
Use international priority A-Priority. With
- \OptionValue{addrfield}{true} this will be printed instead of the mode
- of dispatch.}%
+ \OptionValue{addrfield}{true}, this is printed instead of the delivery
+ type.}%
\end{desctabular}
\end{table}
With\ChangedAt{v3.03}{\Class{scrlttr2}}\important{\OptionValue{addrfield}{PP}}
-\OptionValue{addrfield}{PP} also the zip-code of
-variable \Variable{fromzipcode} and the place from \PName{content} of variable
-\Variable{place} will be set in the Port-Pay\'e head. Thereby the
-\PName{content} of variable \Variable{fromzipcode} will be preceded by the
-\PName{description} of variable \Variable{fromzipcode} and the \PName{content}
-of variable \Variable{zipcodeseparator}. The predefined \PName{description}
-depends on the used \File{lco}-file (see \autoref{sec:\LabelBase.lcoFile} from
-\autopageref{sec:\LabelBase.lcoFile} onward). On the other hand the default of
-the \PName{content} of variable \Variable{zipcodeseparator} is a small
-distance followed by an endash followed by one more small distance
+\OptionValue{addrfield}{PP}, the postal code in the \Variable{fromzipcode}
+variable and the location from the \Variable{place} pariable will be output in
+the postpaid postmark. The postal code (that is, the \PName{content} of
+\Variable{fromzipcode}) is preceded by the \PName{description} of the
+\Variable{fromzipcode} variable and the \PName{content} of
+\Variable{zipcodeseparator}. The default for the \PName{description} depends
+on the \File{lco} file used (see \autoref{sec:\LabelBase.lcoFile} starting on
+\autopageref{sec:\LabelBase.lcoFile}). On the other hand, the default
+\PName{content} of the \Variable{zipcodeseparator} variable is a thin space
+followed by an en rule followed by another thin space
(\Macro{,}\texttt{-{}-}\Macro{,}).
-Beyond\ChangedAt{v3.03}{\Class{scrlttr2}} that, with
-\OptionValue{addrfield}{PP}\important{\OptionValue{addrfield}{PP}} and
-sender's identification code will be used at the Port-Pay\'e head. This is the
-\PName{content} of variable \Variable{PPcode}. Right beside the address of the
-addressee an additional data array may be printed. The \PName{content} of
-variable \Variable{PPdatamatrix} will be used for this.
-
-\BeginIndex{FontElement}{PPdata}\LabelFontElement{PPdata}%
-Zip-code\ChangedAt{v3.03}{\Class{scrlttr2}}, place and code will be printed
-with default font size 8\Unit{pt}. Thereby the font style of element
-\FontElement{PPdata}\important{\FontElement{PPdata}} will be used. The default
-of the element is listed in \autoref{tab:\LabelBase.AddresseeElements} and may
-be changed using commands \DescRef{\LabelBase.cmd.setkomafont} and \DescRef{\LabelBase.cmd.addtokomafont} (see
+With\ChangedAt{v3.03}{\Class{scrlttr2}}
+\OptionValue{addrfield}{PP}\important{\OptionValue{addrfield}{PP}}, a code is
+placed in the postpaid postmark that uniquely identifies the sender. This is
+stored in the \Variable{PPcode} variable. You can also print an additional
+data array to the right of the address, which is stored in the
+\Variable{PPdatamatrix} variable.
+
+\BeginIndexGroup
+\BeginIndex{FontElement}{PPdata}\LabelFontElement{PPdata}
+The ZIP code\ChangedAt{v3.03}{\Class{scrlttr2}} (postal code), place, and
+sender code will be printed by default in an 8\Unit{pt} font. The the font
+style of the \FontElement{PPdata}\important{\FontElement{PPdata}} is used to
+do so. The default is listed in \autoref{tab:\LabelBase.AddresseeElements} and
+can be changed with the \DescRef{\LabelBase.cmd.setkomafont} and
+\DescRef{\LabelBase.cmd.addtokomafont} commands (see
\autoref{sec:\LabelBase.textmarkup},
\DescPageRef{\LabelBase.cmd.setkomafont}).%
-\EndIndex{FontElement}{PPdata}%
+\EndIndexGroup
-With\important[i]{\begin{tabular}[t]{@{}l@{}}
- \KOption{addrfield}\\\quad\PValue{backgroundimage}\end{tabular}\strut\\
- \strut\OptionValue{addrfield}{image}} options
+\BeginIndexGroup
+\BeginIndex{FontElement}{PPlogo}\LabelFontElement{PPlogo} For the postpaid
+logo ``P.P.'', however, the font style of the
+\FontElement{PPlogo}\important{\FontElement{PPlogo}} element is used. Its
+default can also be found in \autoref{tab:\LabelBase.AddresseeElements}.%
+\EndIndexGroup
+
+With\important{\OptionValue{addrfield}{backgroundimage}\\
+ \OptionValue{addrfield}{image}} the two settings
\OptionValue{addrfield}{backgroundimage}\ChangedAt{v3.03}{\Class{scrlttr2}}
-or \OptionValue{addrfield}{image} a picture will be print inside the address
-field. The \PName{content} of variable \Variable{addresseeimage} will be used
-for this. \KOMAScript{} does not use the \PName{description} of that
-variable. Nothing else but the picture will be printed with option
-\OptionValue{addrfield}{image}. But with option
-\OptionValue{addrfield}{backgroundimage} the addressee's name and address from
+and \OptionValue{addrfield}{image}, an image is print inside the address
+window. This image is stored in the \PName{content} of variable
+\Variable{addresseeimage}. \KOMAScript{} does not use the \PName{description}
+of this variable. Although only the image is printed with the
+\OptionValue{addrfield}{image} option, the recipient's name and address from
the mandatory argument of the \DescRef{\LabelBase.env.letter} environment will
-be output.
+be printed with the \OptionValue{addrfield}{backgroundimage} option.
-The alignment of the Port-Pay\'e head as long as the alignment of the
-Port-Pay\'e address is defined by pseudo-length \PLength{toaddrindent} (see
+The position of the postpaid postmark and that of the
+postpaid address is defined by the \PLength{toaddrindent} pseudo-length (see
\DescPageRef{scrlttr2-experts.plength.toaddrindent}) as well as
-\PLength{PPheadwidth} and \PLength{PPheadheight} (siehe
-\DescPageRef{scrlttr2-experts.plength.PPheadheight}). The alignment of
-the data array is defined by pseudo-length \PLength{PPdatamatrixvskip}
+\PLength{PPheadwidth} and \PLength{PPheadheight} (see
+\DescPageRef{scrlttr2-experts.plength.PPheadheight}). The position of
+the data array is defined by the \PLength{PPdatamatrixvskip} pseudo-length
(see \DescPageRef{scrlttr2-experts.plength.PPdatamatrixvskip}).
-Please note\textnote{Attention!} that \KOMAScript{} itself cannot set any
-external graphics or pictures. So, if you want to put external picture files
+Note\textnote{Attention!} that \KOMAScript{} cannot print any external
+graphics or pictures by itself. So if you want to put external picture files
into variables like \Variable{addresseeimage} or \Variable{PPdatamatrix}, you
-have to use an additional graphics package like
+must load an additional graphics package like
\Package{graphics}\IndexPackage{graphics} or
-\Package{graphicx}\IndexPackage{graphicx} to use, i.\,e., the command
-\Macro{includegraphics} at the \PName{content} of the variables.%
+\Package{graphicx}\IndexPackage{graphicx} and use, for instance, the
+\Macro{includegraphics} command in the \PName{content} of the variables.%
%
\EndIndexGroup
\begin{Declaration}
- \OptionVName{locfield}{selection}
+ \OptionVName{locfield}{setting}
\end{Declaration}
-\BeginIndex{}{sender>additional information}%
-\Class{scrlttr2} places a field with additional sender attributes next to the
-address field. This can be used, for example, for bank account
-or similar additional information.
-Depending\important[i]{\OptionValueRef{\LabelBase}{fromalign}{center}\\
- \begin{tabular}[t]{@{}l@{}}
- \KOption{fromalign}\\\quad\PValue{locationleft}\end{tabular}\\
- \begin{tabular}[t]{@{}l@{}}
- \KOption{fromalign}\\\quad\PValue{locationright}\end{tabular}} on the
+\BeginIndex{}{extra sender information}%
+In addition to the address field, \Class{scrlttr2} can print a field with
+extra sender attributes next to the address field. Its content can be
+anything you want, for example a location, a bank-account number, or other
+information. Depending\important{%
+ \OptionValueRef{\LabelBase}{fromalign}{locationleft}\\
+ \OptionValueRef{\LabelBase}{fromalign}{center}\\
+ \OptionValueRef{\LabelBase}{fromalign}{locationright}} on the
\DescRef{\LabelBase.option.fromalign} option, it will also be used for the
-sender logo. The width of this field may be defined within an \File{lco} file
-(see \autoref{sec:\LabelBase.lcoFile}). If the width is set to 0 in that file,
-then the \Option{locfield} option can toggle between two presets for
-the field width. See the explanation on the \PLength{locwidth} pseudo
-length in \autoref{sec:scrlttr2-experts.locationField},
-\DescPageRef{scrlttr2-experts.plength.locwidth}. Possible values for this
-option are shown in \autoref{tab:\LabelBase.locfield}. Default is
+sender's logo. The width of this field can be specified in an \File{lco} file
+(see \autoref{sec:\LabelBase.lcoFile}). If the width is set to zero there, the
+\Option{locfield} option can toggle between two defaults for the field width.
+This is the case for most of the \File{lco} files that come with
+\KOMAScript{}. See also the explanation on the \PLength{locwidth}
+pseudo-length in \autoref{sec:scrlttr2-experts.locationField},
+\DescPageRef{scrlttr2-experts.plength.locwidth}. Available values for this
+option are shown in \autoref{tab:\LabelBase.locfield}. The default is
\PValue{narrow}.%
%
\begin{table}
@@ -1818,16 +1853,16 @@ option are shown in \autoref{tab:\LabelBase.locfield}. Default is
\setcapindent{0pt}%
% \caption
\begin{captionbeside}
- [{Possible values of option \Option{locfield} with
- \Class{scrlttr2}}]{Possible values of option \Option{locfield} for
- setting the width of the field with additional sender attributes with
+ [{Available values of the \Option{locfield} option with
+ \Class{scrlttr2}}]{Available values of the \Option{locfield} option to
+ set the width of the field for extra sender information with
\Class{scrlttr2}%
\label{tab:\LabelBase.locfield}}%
[l]
\begin{minipage}[t]{.45\linewidth}
\begin{desctabular}[t]
- \pventry{narrow}{narrow sender supplement field}%
- \pventry{wide}{wide sender supplement field}%
+ \pventry{narrow}{narrow extra sender information field}%
+ \pventry{wide}{wide extra sender information field}%
\end{desctabular}
\end{minipage}
\end{captionbeside}
@@ -1836,36 +1871,34 @@ option are shown in \autoref{tab:\LabelBase.locfield}. Default is
\begin{Declaration}
\Variable{location}%
\end{Declaration}
-\BeginIndex{}{sender>additional information}%
-The contents of the sender's extension field is determined by the
-variable \Variable{location}. To set this variable's \PName{content}, it is
-permitted to use formatting commands like \Macro{raggedright}. \KOMAScript{}
-does not use the \PName{description} of the variable.
+The contents of the extra sender information field, unless it contains
+the logo or the basic sender information itself, are specified by the
+\Variable{location} variable. You can use formatting commands like
+\Macro{raggedright} within this variable's \PName{content}. \KOMAScript{} does
+not use the \PName{description} of this variable.
\begin{Example}
- Mr Public likes to show some additional information about his
- membership. Therefor he uses the \Variable{location} variable:%
+ Mr Public would like to provide some additional information about his
+ membership. Therefore he uses the \Variable{location} variable:%
\lstinputcode[xleftmargin=1em]{letter-19.tex}%
- This will define the field beside the addressee's address like shown in
- \autoref{fig:\LabelBase.letter-19}.
+ This will place the corresponding field beside the recipient's address, as
+ shown in \autoref{fig:\LabelBase.letter-19}.
\begin{figure}
\setcapindent{0pt}%
\begin{captionbeside}[{Example: letter with extended sender, logo,
- addressee, additional sender information, opening,
- text, closing, signature, postscript, distribution list, enclosure,
- and puncher hole mark}]
- {result of a small letter with extended sender, logo,
- addressee, additional sender information, opening, text, closing,
- signature, postscript, distribution list, enclosure and puncher hole
- mark (the date is a default of DIN-letters)}[l]
+ recipient, extra sender information, opening, text, closing,
+ signature, postscript, distribution list, enclosure, and hole-punch
+ mark}]
+ {result of a short letter with extended sender, logo, recipient,
+ extra sender information, opening, text, closing, signature,
+ postscript, distribution list, enclosure, and hole-punch mark (the
+ date is set by default)}[l]
\frame{\includegraphics[width=.4\textwidth]{letter-19}}
\end{captionbeside}
\label{fig:\LabelBase.letter-19}
\end{figure}
\end{Example}
-%
\EndIndexGroup
-%
\EndIndexGroup
@@ -1874,30 +1907,30 @@ does not use the \PName{description} of the variable.
\end{Declaration}
This option toggles between the standard, language-dependent
date\Index{date}\Index{reference line} presentation, and a short, numerical
-one. {\KOMAScript} does not provide the standard presentation. It should be
-defined by packages such as \Package{ngerman}\IndexPackage{ngerman},
+one. \KOMAScript{} does not provide the standard date format. It should be
+defined by a package such as \Package{ngerman}\IndexPackage{ngerman},
\Package{babel}\IndexPackage{babel}, or
\Package{isodate}\IndexPackage{isodate}.
The\important{\OptionValue{numericaldate}{true}} short, numerical
-presentation, on the other hand, is produced by \Class{scrlttr2} itself. This
-option can take the standard values for simple switches, as listed in
-\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. Default is
-\PValue{false}, which results in standard date presentation.
+representation, however, is produced by \Class{scrlttr2} itself. The option
+recognizes the standard values for simple switches as listed in
+\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. The default
+is \PValue{false}, which results in standard date format.
\begin{Declaration}
\Variable{date}%
\end{Declaration}
-The date in the selected presentation will become the \PName{content} of
-variable \Variable{date}. The selection of option
-\DescRef{\LabelBase.option.numericaldate} does not influence the date any
-longer, if the \PName{content} of this variable will be changed by the
-user. Normally the date will be part of the reference line. If all other
-elements of the reference line will be empty and therefore unused a date line
-instead of a reference line will be printed. See the description of variable
+The date in the selected format is stored as \PName{content} of the
+\Variable{date} variable. Setting the
+\DescRef{\LabelBase.option.numericaldate} option has no effect if this
+variable is overridden. The date is usually output as part of the reference
+line. If all other elements of the reference line are empty, a date line
+consisting of the location and the date is printed instead. However in this
+case, the settings of the \DescRef{\LabelBase.option.refline} option described
+below also affect the date line. See the description of variable
\DescRef{\LabelBase.variable.place} on
\DescPageRef{\LabelBase.variable.placeseparator} for more information about
-the date line. You should note, that you can change the automatic printing of
-the date using option \DescRef{\LabelBase.option.refline}, that will be described next.
+the location.
%
\EndIndexGroup
\EndIndexGroup
@@ -1907,37 +1940,39 @@ the date using option \DescRef{\LabelBase.option.refline}, that will be describe
\OptionVName{refline}{selection}
\end{Declaration}
\BeginIndex{}{reference line}%
-\index{business line|see{reference line}}% |
-Especially in business letters a line with information like identification
-code\Index{identification>code}, direct dial, customer's number, invoice's
-number, or references to previous letters may be found usually. This line will
-be named \emph{reference line}\textnote{reference line} in this manual.
-
-With the \Class{scrlttr2} class, the header, footer, address, and sender
-attributes may extend beyond the normal type area to the left and to the
-right. Option \OptionValue{refline}{wide} defines that this should also apply to
-the reference fields line. Normally, the reference fields line contains at
-least the date, but it can hold additional data. Possible values for this
-option are shown in \autoref{tab:\LabelBase.refline}. Default is \PValue{narrow}
-and \PValue{dateright}\ChangedAt{v3.09}{\Class{scrlttr2}}.%
+\index{business line|see{reference line}}%
+Business letters in particular often contain an area with information such as
+an identification code\Index{identification code}, phone
+extension\Index{phone>extension}, customer number\Index{customer number},
+invoice number\Index{invoice number}, or references to previous letters. This
+guide calls this area the \emph{reference-field line}\textnote{reference-field
+ line}, or simply the \emph{reference line}.
+
+With \Class{scrlttr2} and \Package{scrletter}, the header, footer, address,
+and extra sender information can extend left and right beyond the normal
+type area. The
+\OptionValue{refline}{wide}\important{\OptionValue{refline}{wide}} option
+specifies that this should also apply to the reference-field line. Normally,
+the reference-field line contains at least the date, but it can hold
+additional data. Available values for this option are shown in
+\autoref{tab:\LabelBase.refline}. The default is \PValue{narrow} and
+\PValue{dateright}\ChangedAt{v3.09}{\Class{scrlttr2}}.%
%
\begin{table}
- \caption[{Possible value of option \Option{refline} with
- \Class{scrlttr2}}]{Possible value of option \Option{refline} for setting
- the width of the reference fields line with
- \Class{scrlttr2}}
+ \caption[{Available values of the \Option{refline} option with
+ \Class{scrlttr2}}]{Available value of the \Option{refline} option to set
+ the width of the reference line with \Class{scrlttr2}}
\label{tab:\LabelBase.refline}
\begin{desctabular}
\pventry{dateleft}{\ChangedAt{v3.09}{\Class{scrlttr2}}%
- The date will be placed leftmost at the reference line.}%
+ The date is placed leftmost in the reference line.}%
\pventry{dateright}{\ChangedAt{v3.09}{\Class{scrlttr2}}%
- The date will be placed rightmost at the reference line.}%
- \pventry{narrow}{The reference line will be restricted to type
- area.}%
+ The date is placed rightmost in the reference line.}%
+ \pventry{narrow}{The reference line is restricted to the type area.}%
\pventry{nodate}{\ChangedAt{v3.09}{\Class{scrlttr2}}%
The date is not placed automatically into the reference line.}%
- \pventry{wide}{The with of the reference line corresponds to address and
- sender's additional information.}%
+ \pventry{wide}{The width of the reference line depends on the positions of
+ the address and extra sender information.}%
\end{desctabular}
\end{table}
@@ -1948,58 +1983,60 @@ and \PValue{dateright}\ChangedAt{v3.09}{\Class{scrlttr2}}.%
\Variable{customer}%
\Variable{invoice}%
\end{Declaration}
-These five variables represent typical fields of the reference line. Their
-meanings are given in \autoref{tab:\LabelBase.variables} on
-\autopageref{tab:\LabelBase.variables}. Each variable has also a predefined
-\PName{description}, shown in \autoref{tab:\LabelBase.reflineTerm}. Additional
-information about adding other variables to the reference line may be found
-in \autoref{sec:scrlttr2-experts.variables} from
-\DescPageRef{scrlttr2-experts.cmd.newkomavar} onward.%
+You can manage the typical contents of the reference-field line with five
+variables: \Variable{yourref}, \Variable{yourmail}, \Variable{myref},
+\Variable{customer} and \Variable{invoice}. Their meanings are listed in
+\autoref{tab:\LabelBase.variables} on \autopageref{tab:\LabelBase.variables}.
+Each variable has also a predefined \PName{description}, shown in
+\autoref{tab:\LabelBase.reflineTerm}. How to add more variables to the
+reference-field line is explained in \autoref{sec:scrlttr2-experts.variables}
+starting on \DescPageRef{scrlttr2-experts.cmd.newkomavar}.%
%
\begin{table}
% \centering
\KOMAoptions{captions=topbeside}%
\setcapindent{0pt}%
% \caption
- \begin{captionbeside}[{predefined descriptions of variables of the reference
- line}]{predefined descriptions of typical variables of the reference
- fields line using macros depending on the current language}%
+ \begin{captionbeside}[{default descriptions of variables in the
+ reference line}]{default descriptions of typical variables in the
+ reference line using language-dependent commands}%
[l]
\begin{tabular}[t]{lll}
\toprule
- variable name & description & e.\,g., in english \\
+ name & description & English default text\\
\midrule
\Variable{yourref} & \DescRef{scrlttr2-experts.cmd.yourrefname} & Your reference \\
\Variable{yourmail} & \DescRef{scrlttr2-experts.cmd.yourmailname} & Your letter from \\
\Variable{myref} & \DescRef{scrlttr2-experts.cmd.myrefname} & Our reference \\
\Variable{customer} & \DescRef{scrlttr2-experts.cmd.customername} & Customer No.: \\
\Variable{invoice} & \DescRef{scrlttr2-experts.cmd.invoicename} & Invoice No.: \\
- \DescRef{\LabelBase.variable.date} & \DescRef{scrlttr2-experts.cmd.datename} & date \\
+ \DescRef{\LabelBase.variable.date} & \DescRef{scrlttr2-experts.cmd.datename} & date \\
\bottomrule
\end{tabular}
\end{captionbeside}
\label{tab:\LabelBase.reflineTerm}
\end{table}
+\BeginIndexGroup
\BeginIndex{FontElement}{refname}\LabelFontElement{refname}%
\BeginIndex{FontElement}{refvalue}\LabelFontElement{refvalue}%
-Font style and color\ChangedAt{v2.97c}{\Class{scrlttr2}} of the
-\PName{description} and \PName{content} of the fields of the reference line
-may be changed with elements \FontElement{refname}%
+You\ChangedAt{v2.97c}{\Class{scrlttr2}} can change the font style and colour
+of the \PName{description} and \PName{content} of the fields in the reference
+line with the \FontElement{refname}%
\important[i]{\FontElement{refname}\\\FontElement{refvalue}} and
-\FontElement{refvalue}. Therefor the commands \DescRef{\LabelBase.cmd.setkomafont} and \DescRef{\LabelBase.cmd.addtokomafont} (see
+\FontElement{refvalue} elements using the \DescRef{\LabelBase.cmd.setkomafont}
+and \DescRef{\LabelBase.cmd.addtokomafont} commands (see
\autoref{sec:\LabelBase.textmarkup},
-\DescPageRef{\LabelBase.cmd.setkomafont}) should be used. The default
-configuration of both elements is listed in
-\autoref{tab:\LabelBase.refnamerefvalue}.%
+\DescPageRef{\LabelBase.cmd.setkomafont}). The defaults for both elements are
+listed in \autoref{tab:\LabelBase.refnamerefvalue}.%
\begin{table}[tp]
% \centering
\KOMAoptions{captions=topbeside}%
\setcapindent{0pt}%
% \caption
\begin{captionbeside}
- [{font style default of elements of the reference line}]{default font
- style configuration of the elements of the reference line%
+ [{default font styles for elements in the reference line}]{default font
+ style settings for the elements in the reference line%
\label{tab:\LabelBase.refnamerefvalue}}
[l]
\begin{tabular}[t]{ll}
@@ -2013,8 +2050,6 @@ configuration of both elements is listed in
\end{captionbeside}
\end{table}%
%
-\EndIndex{FontElement}{refvalue}%
-\EndIndex{FontElement}{refname}%
\EndIndexGroup
@@ -2022,48 +2057,56 @@ configuration of both elements is listed in
\Variable{placeseparator}%
\end{Declaration}%
\BeginIndex{Variable}{place}%
-If all variables of the reference line are empty, the line will be omitted.
-In this case, the \PName{content} of \DescRef{\LabelBase.variable.place} and
-\Variable{placeseparator} will be set, followed by the \PName{content} of
-\DescRef{\LabelBase.variable.date}. The predefined \PName{content} of the
-\Variable{placeseparator} is a comma followed by a non-breaking space. If the
-variable \DescRef{\LabelBase.variable.place} has no \PName{content} value then
-the hyphen remains unset also. The predefined \PName{content} of
-\DescRef{\LabelBase.variable.date} is \Macro{today}\IndexCmd{today} and
-depends on the setting of the option \DescRef{\LabelBase.option.numericaldate}
-(see \DescPageRef{\LabelBase.option.numericaldate}).
-
-Since version~3.09\ChangedAt{v3.09}{\Class{scrlttr2}} place and date the
-alignment of place and date is given by option \DescRef{\LabelBase.option.refline}. The available
-alignment values for this option are listed in \autoref{tab:\LabelBase.refline}.
+If all variables in the reference-field line, with the exception of
+\DescRef{\LabelBase.variable.date}%
+\important{\DescRef{\LabelBase.variable.date}}\IndexVariable{date}, are empty,
+no actual reference line is output. Instead, a date line consisting only of a
+location\Index{location} and a date\Index{date} is output. The \PName{content}
+of the \DescRef{\LabelBase.variable.place} variable contains the location. The
+delimiter, which in this case is placed after the location, is specified by
+the \PName{content} of the \Variable{placeseparator} variable. The
+default\textnote{default} \PName{content} of the delimiter is a comma followed
+by a non-breaking space. If the location is empty, the delimiter is not
+output. The default \PName{content} of \DescRef{\LabelBase.variable.date} is
+\Macro{today}\IndexCmd{today} and depends on the setting of the
+\DescRef{\LabelBase.option.numericaldate} option (see
+\DescPageRef{\LabelBase.option.numericaldate}).
+
+Starting with version~3.09\ChangedAt{v3.09}{\Class{scrlttr2}}, the location
+and date are no longer required to be right-aligned. Instead, when a date
+line is used, its alignment is specified by the date setting of the
+\DescRef{\LabelBase.option.refline} option, as listed in
+\autoref{tab:\LabelBase.refline}.
+\BeginIndexGroup
\BeginIndex{FontElement}{placeanddate}\LabelFontElement{placeanddate}%
-The\ChangedAt{v3.12}{\Class{scrlttr2}} font setting of place and date in the
-date line are given by font
-element\FontElement{placeanddate}\important[i]{\FontElement{placeanddate}}
-instead of element \DescRef{\LabelBase.fontelement.refvalue}, which would be used for general
-reference lines. You can change the empty default of the font element using
-commands \DescRef{\LabelBase.cmd.setkomafont} and \DescRef{\LabelBase.cmd.addtokomafont} (see
+If\ChangedAt{v3.12}{\Class{scrlttr2}} such a date line is output with a
+location rather than a reference-field line, the font setting of the
+\DescRef{\LabelBase.fontelement.refvalue} element does not apply. In this
+case, the \FontElement{placeanddate}\important{\FontElement{placeanddate}}
+element is used. You can change the empty default of this font element as
+usual with the \DescRef{\LabelBase.cmd.setkomafont} and
+\DescRef{\LabelBase.cmd.addtokomafont} commands (see
\autoref{sec:\LabelBase.textmarkup},
\DescPageRef{\LabelBase.cmd.setkomafont}).%
-\EndIndex{FontElement}{placeanddate}%
+\EndIndexGroup
\begin{Example}
- Now Mr Public also sets the place:%
+ Now Mr Public also sets the variable for the location:%
\lstinputcode[xleftmargin=1em]{letter-20.tex}%
- In this case \autoref{fig:\LabelBase.letter-20} shows the place and the
- automatic separator in front of the date. The date has been defined
- explicitly to make the printed date independent from the date of the
- \LaTeX{} run.
+ As seen in \autoref{fig:\LabelBase.letter-20}, the location appears
+ in front of the date, followed by the automatic delimiter. This date has
+ been defined explicitly so that the original date is maintained in any later
+ \LaTeX{} run rather than using the date of the \LaTeX{} run.
\begin{figure}
\setcapindent{0pt}%
\begin{captionbeside}[{Example: letter with extended sender, logo,
- addressee, additional sender information, place, date, opening,
+ recipient, extra sender information, location, date, opening,
text, closing, signature, postscript, distribution list, enclosure,
- and puncher hole mark}]
- {result of a small letter with extended sender, logo, addressee,
- additional sender information, place, date, opening, text, closing,
- signature, postscript, distribution list, enclosure and puncher hole
+ and hole-punch mark}]
+ {result of a short letter with extended sender, logo, recipient,
+ extra sender information, location, date, opening, text, closing,
+ signature, postscript, distribution list, enclosure and hole-punch
mark}[l]
\frame{\includegraphics[width=.4\textwidth]{letter-20}}
\end{captionbeside}
@@ -2072,41 +2115,44 @@ commands \DescRef{\LabelBase.cmd.setkomafont} and \DescRef{\LabelBase.cmd.addtok
\end{Example}
%
\EndIndexGroup
-%
+\EndIndexGroup
\EndIndexGroup
\begin{Declaration}
\Variable{title}%
\end{Declaration}
-\BeginIndex{}{title}%
+With \KOMAScript{}, you can also give a letter a title\Index{title}. The title
+is centred, using the \Macro{LARGE} font size, and placed directly beneath the
+reference-field line.
+
\BeginIndex{FontElement}{lettertitle}\LabelFontElement{lettertitle}%
\BeginIndex{FontElement}{title}\LabelFontElement{title}%
-With \Class{scrlttr2} a letter can carry an additional title. The title is
-centered and set with font size \Macro{LARGE} directly after and beneath the
-reference fields line. The predefined font setup for the element
-\FontElement{lettertitle}\important{\FontElement{lettertitle}} can be changed
-with commands \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (see
+You can change the font style for the
+\FontElement{lettertitle}\important{\FontElement{lettertitle}} element with
+the \DescRef{\LabelBase.cmd.setkomafont} and
+\DescRef{\LabelBase.cmd.addtokomafont} commands (see
\autoref{sec:\LabelBase.textmarkup},
\DescPageRef{\LabelBase.cmd.setkomafont}). Font size declarations are
-allowed. Font size \Macro{LARGE} is not part of the predefined default
-\Macro{normalcolor}\Macro{sffamily}\Macro{bfseries} but nevertheless will be
-used before the font style of the element. With \Class{scrlttr2} you can also
-use \FontElement{title}\important{\FontElement{title}} as an alias of
-\FontElement{lettertitle}. This is not provided using \Package{scrletter} with
-a \KOMAScript{} class, because these classes already define an element
-\FontElement{title} with different meaning for the document title.%
+allowed. The \Macro{LARGE} font size always precedes the font selection in
+\KOMAScript{}, and is therefore not part of the default setting
+\Macro{normalcolor}\Macro{sffamily}\Macro{bfseries}. With \Class{scrlttr2},
+you can also use \FontElement{title}\important{\FontElement{title}} as an
+alias for \FontElement{lettertitle}. This is not possible when using
+\Package{scrletter} with a \KOMAScript{} class because these classes already
+define a \FontElement{title} element for the document title with different
+setting.%
\EndIndex{FontElement}{title}%
\EndIndex{FontElement}{lettertitle}%
\begin{Example}
- Assume that you are to write a reminder. Thus you put as title:
+ Suppose you are writing a reminder letter. You set a corresponding title:
\begin{lstlisting}
\setkomavar{title}{Reminder}
\end{lstlisting}
- This way the addressee will recognize a reminder as such.
+ This way the recipient should recognize the reminder as such.
\end{Example}
-Like shown in the example, the \PName{content} of the variable defines the
-title. \KOMAScript{} will not use the \PName{description}.%
+As shown in the example, the \PName{content} of the variable defines the
+title. \KOMAScript{} does not use the \PName{description}.%
%
\EndIndexGroup
@@ -2117,23 +2163,22 @@ title. \KOMAScript{} will not use the \PName{description}.%
\Variable{subjectseparator}%
\end{Declaration}
\BeginIndex{}{subject}%
-In case a subject should be set, the \PName{content} of the variable
-\Variable{subject} need to be defined. First of all with option
-\OptionValue{subject}{true}\important{\OptionValue{subject}{titled}} the usage
-of the \PName{description} before the output of the subject may be
-configured. See \autoref{tab:\LabelBase.subjectTerm} for the predefined
-\PName{description}. In case of using the \PName{description} the
-\PName{content} of variable \Variable{subjectseparator}\Index{separator} will
-be set between the \PName{description} and \PName{content} of the
-\Variable{subject}. The predefined \PName{content} of \PName{subjectseparator}
-is a colon followed by a white space.
+To include a subject, define the \PName{content} of the \Variable{subject}
+variable accordingly. First of all, you can use the
+\OptionValue{subject}{true}\important{\OptionValue{subject}{titled}} option,
+to choose whether the subject should be preceded with a \PName{description} or
+not. If you use the \PName{description} the \PName{content} of the
+\Variable{subjectseparator}\Index{separator} variable is output between the
+\PName{description} and the \PName{content} of the \Variable{subject}
+variable. The default \PName{content} of \PName{subjectseparator} consists of
+a colon followed by a space.
\begin{table}
% \centering
\KOMAoptions{captions=topbeside}%
\setcapindent{0pt}%
% \caption
- \begin{captionbeside}{predefined descriptions of subject-related variables}
+ \begin{captionbeside}{default descriptions of variables for the subject}
[l]
\begin{tabular}[t]{lll}
\toprule
@@ -2150,17 +2195,18 @@ is a colon followed by a white space.
\label{tab:\LabelBase.subjectTerm}
\end{table}
-On the other hand, \OptionValue{subject}{afteropening}%
-\important{\OptionValue{subject}{afteropening}} may be used to place the
-subject below instead of before the letter opening. Furthermore, the
-formatting\important[i]{\OptionValue{subject}{underlined}\\
+Additionally, you can use \OptionValue{subject}{afteropening}%
+\important{\OptionValue{subject}{afteropening}\\
+ \OptionValue{subject}{beforeopening}} to place the subject after the letter
+opening instead of the default \OptionValue{subject}{beforeopening}. You can
+also specify other formatting\important{\OptionValue{subject}{underlined}\\
\OptionValue{subject}{centered}\\
- \OptionValue{subject}{right}} of the subject may be changed using either
+ \OptionValue{subject}{right}} for the subject with
\OptionValue{subject}{underlined}, \OptionValue{subject}{centered}, or
-\OptionValue{subject}{right}\ChangedAt{v2.97c}{\Class{scrlttr2}}. All
-available values are listed in \autoref{tab:\LabelBase.subject}. Please
-note\textnote{Attention!}, that with option \OptionValue{subject}{underlined}
-the while subject must fit at one line! Defaults are
+\OptionValue{subject}{right}\ChangedAt{v2.97c}{\Class{scrlttr2}}. The
+available values are listed in \autoref{tab:\LabelBase.subject}.
+Note\textnote{Attention!} that with the \OptionValue{subject}{underlined}
+option, the whole subject must fit onto one line. The defaults are
\OptionValue{subject}{left}, \OptionValue{subject}{beforeopening}, and
\OptionValue{subject}{untitled}.%
%
@@ -2170,8 +2216,8 @@ the while subject must fit at one line! Defaults are
\setcapindent{0pt}%
% \caption
\begin{captionbeside}
- [{available values of option \Option{subject} with \Class{scrlttr2}}]
- {available values of option \Option{subject} for the position and
+ [{Available values of the \Option{subject} option with \Class{scrlttr2}}]
+ {Available values of the \Option{subject} option for the position and
formatting of the subject with
\Class{scrlttr2}\label{tab:\LabelBase.subject}}%
[l]
@@ -2179,49 +2225,51 @@ the while subject must fit at one line! Defaults are
\begin{desctabular}[t]
\pventry{afteropening}{subject after opening}%
\pventry{beforeopening}{subject before opening}%
- \pventry{centered}{subject centered}%
+ \pventry{centered}{subject centred}%
\pventry{left}{subject left-justified}%
\pventry{right}{subject right-justified}%
\pventry{titled}{add title/description to subject}%
- \pventry{underlined}{set subject underlined (see note in text please)}%
+ \pventry{underlined}{set subject underlined (see note in text)}%
\pventry{untitled}{do not add title/description to subject}%
\end{desctabular}
\end{minipage}
\end{captionbeside}
\end{table}
+\BeginIndexGroup
\BeginIndex{FontElement}{lettersubject}\LabelFontElement{lettersubject}%
\BeginIndex{FontElement}{subject}\LabelFontElement{subject}%
-The subject line is set in a separate font\Index{font>style}. To change this
-use the commands \DescRef{\LabelBase.cmd.setkomafont} and
-\DescRef{\LabelBase.cmd.addtokomafont} (siehe
+The subject line is set in a separate font\Index{font>style}. To change this,
+use the \DescRef{\LabelBase.cmd.setkomafont} and
+\DescRef{\LabelBase.cmd.addtokomafont} commands (see
\autoref{sec:\LabelBase.textmarkup},
-\DescPageRef{\LabelBase.cmd.setkomafont}). For element
-\FontElement{lettersubject}\important{\FontElement{lettersubject}} the
-predetermined font is \Macro{normalcolor}\Macro{bfseries}. With
-\Class{scrlttr2} you can also use
+\DescPageRef{\LabelBase.cmd.setkomafont}). For the
+\FontElement{lettersubject}\important{\FontElement{lettersubject}} element,
+the default font is \Macro{normalcolor}\Macro{bfseries}. With the
+\Class{scrlttr2} class, you can also use
\FontElement{subject}\important{\FontElement{subject}} as an alias of
-\FontElement{lettersubject}. This is not provided using \Package{scrletter}
-with a \KOMAScript{} class, because these classes already define an element
-\FontElement{subject} with different meaning for the document title.%
-\EndIndex{FontElement}{subject}%
-\EndIndex{FontElement}{lettersubject}%
+\FontElement{lettersubject}. This is not possible with the \Package{scrletter}
+package when using a \KOMAScript{} class, because these classes already define
+a \FontElement{subject} element for the document title with different
+settings.%
+\EndIndexGroup
+
\begin{Example}
- Now, Mr Public sets a subject. He's a more traditional person, so he likes
- to have a kind of heading to the subject and therefor sets the corresponding
+ Mr Public now includes a subject. As a traditionalist, he also wants the
+ subject to be labelled accordingly and therefore sets the corresponding
option:%
\lstinputcode[xleftmargin=1em]{letter-21.tex}%
- The result is shown by \autoref{fig:\LabelBase.letter-21}.
+ The result is shown in \autoref{fig:\LabelBase.letter-21}.
\begin{figure}
\setcapindent{0pt}%
\begin{captionbeside}[{Example: letter with extended sender, logo,
- addressee, additional sender information, place, date, subject,
+ recipient, extra sender information, place, date, subject,
opening, text, closing, signature, postscript, distribution list,
- enclosure, and puncher hole mark}]
- {result of a small letter with extended sender, logo, addressee,
- additional sender information, place, date, subject opening, text,
+ enclosure, and hole-punch mark}]
+ {result of a short letter with extended sender, logo, recipient,
+ extra sender information, place, date, subject, opening, text,
closing, signature, postscript, distribution list, enclosure and
- puncher hole mark}[l]
+ hole-punch mark}[l]
\frame{\includegraphics[width=.4\textwidth]{letter-21}}
\end{captionbeside}
\label{fig:\LabelBase.letter-21}
@@ -2234,51 +2282,36 @@ with a \KOMAScript{} class, because these classes already define an element
\begin{Declaration}
\OptionVName{firstfoot}{simple switch}
\end{Declaration}
-\BeginIndex{}{letter>foot}%
-\BeginIndex{}{letterfoot}%
-This\ChangedAt{v2.97e}{\Class{scrlttr2}} option determines whether the
-letterfoot is set or not. Switching off the letterfoot, e.\,g., using
-\OptionValue{firstfoot}{false}\important{\OptionValue{firstfoot}{false}}, has
-an effect when the option \DescRef{\LabelBase.option.enlargefirstpage} (see
-\DescPageRef{\LabelBase.option.enlargefirstpage}) is used concurrently. In
-this case the text area of the page will be enlarged down to the bottom. Then
-the normal distance between typing area and the letter foot will become the
-only distance remaining between the end of the typing area and the end of the
-page.
-
-The option understands the standard values for simple switches, as given in
-\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. Default is
-the setting of the letter foot.
+\BeginIndex{}{letterhead page>footer}%
+This\ChangedAt{v2.97e}{\Class{scrlttr2}} option determines whether the footer
+for the letterhead page is output. Switching off the letterhead page footer
+with \OptionValue{firstfoot}{false}\important{\OptionValue{firstfoot}{false}},
+has an effect when the \DescRef{\LabelBase.option.enlargefirstpage} option
+(see \DescPageRef{\LabelBase.option.enlargefirstpage}) is used at the same
+time, as this will logically extend the page downwards. In this case, the
+distance that is ordinarily between type area and the footer becomes the
+distance between the end of the type area and the bottom of the page.
+
+The option recognizes the standard values for simple switches listed in
+\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. The default
+is to include the letterhead page footer.
\EndIndexGroup
\begin{Declaration}
\Variable{firstfoot}%
\end{Declaration}%
-\BeginIndex{}{letter>foot}%
-\BeginIndex{}{letterfoot}%
-The first page's footer is preset to
-empty. However\ChangedAt{v3.08}{\Class{scrlttr2}}, a new construction may be
-made at the \PName{content} of variable \Variable{firstfoot}. \KOMAScript{}
-does not use the \PName{description} of the variable. For more information see
-the example following the next description. Only for compatibility reason the
-deprecated command \Macro{firstfoot}\IndexCmd[indexmain]{firstfoot} of
-\Class{scrlttr2} before release~3.08 still exists. Nevertheless it should not
-be used any longer.
+\BeginIndex{}{letterhead page>footer}%
+The footer of the first page is empty by default.
+However\ChangedAt{v3.08}{\Class{scrlttr2}}, you can specify a new footer
+in the \PName{content} of the \Variable{firstfoot} variable. \KOMAScript{}
+does not use the \PName{description} of the variable.
-\begin{Declaration}
- \Variable{frombank}%
-\end{Declaration}%
-This variable at the moment takes on a special meaning: it is not used
-internally at this point, and the user can make use of it to set, for example,
-his bank account\Index{bank account} within the sender's additional
-information (see variable \DescRef{\LabelBase.variable.location},
-\DescPageRef{\LabelBase.variable.location}) or the footer.%
-%
+\BeginIndex{Variable}{frombank}%
\begin{Example}
- In the first page's footer, you may want to set the \PName{content} of the
- variable \Variable{frombank} (the bank account). The double
- backslash should be exchanged with a comma at the same time:
+ You want to put the \PName{content} of the \Variable{frombank} variable
+ (i.\,e. the bank account details) in the footer of the first page. The
+ double backslash should be replaced with a comma:
\begin{lstcode}
\setkomavar{firstfoot}{%
\parbox[b]{\linewidth}{%
@@ -2286,12 +2319,11 @@ information (see variable \DescRef{\LabelBase.variable.location},
}%
}
\end{lstcode}
- For the hyphen you might define a variable of your own if you like.
- This is left as an exercise for the reader.
+ You can also define your own variable for the separator. I leave
+ this as an exercise for the reader.
- Nowadays it has become very common to create a proper footer in
- order to obtain some balance with respect to the letterhead. This
- can be done as follows:
+ If you want to create a footer in order to counterbalance the letterhead, you
+ can do so, for example, as follows:
\begin{lstcode}
\setkomavar{firstfoot}{%
\parbox[t]{\textwidth}{\footnotesize
@@ -2302,9 +2334,9 @@ information (see variable \DescRef{\LabelBase.variable.location},
\end{tabular}%
\hfill
\begin{tabular}[t]{l@{}}%
- \multicolumn{1}{@{}l@{}}{Manager:}\\
- Jane Fonda\\[1ex]
- \multicolumn{1}{@{}l@{}}{Court Of Jurisdiction:}\\
+ \multicolumn{1}{@{}l@{}}{Managing Director:}\\
+ Lisa Mayer\\[1ex]
+ \multicolumn{1}{@{}l@{}}{Court Jurisdiction:}\\
Great Plains
\end{tabular}%
\ifkomavarempty{frombank}{}{%
@@ -2317,90 +2349,105 @@ information (see variable \DescRef{\LabelBase.variable.location},
}%
}
\end{lstcode}
- This example, by the way, came from Torsten Kr\"uger. With
+ This example originally came from Torsten Kr\"uger. You should
+ consider placing a definition intended for multiple use in different
+ documents in a separate \File{lco} file\Index{lco file=\File{lco} file}.
\begin{lstcode}
- \setkomavar{frombank}{Account No. 12\,345\,678\\
- at Citibank\\
- bank code no: 876\,543\,21}
+ \setkomavar{frombank}{Account No. 12345678\\
+ Buffoon Bank\\
+ Bank Code: 65-43-21}
\end{lstcode}
- the bank account can be set accordingly.
-% If the footer will have such a large height then it might happen that you
-% have to shift its position. You can do this with the pseudo-length
-% \PLength{firstfootvpos}\IndexPLength{firstfootvpos}, which is
-% described above in this section.
+ can then be used to set the bank details in the document.
+% However depending on your settings, there may not be sufficient space
+% for such a large footer, and it may therefore be placed too low on the
+% page. In such a case, you can adjust its vertical position with the
+% pseudo-length \PLength{firstfootvpos}\IndexPLength{firstfootvpos}.
\end{Example}
-In the previous example a multi-line footer was set. With a compatibility
-setting to version 2.9u (see \DescRef{\LabelBase.option.version} in
+
+The previous example uses a multi-line footer. With a compatibility setting
+of version 2.9u (see \DescRef{\LabelBase.option.version} in
\autoref{sec:\LabelBase.compatibilityOptions},
-\DescPageRef{\LabelBase.option.version}) the space will in general not
-suffice. In that case, you may need to reduce \PLength{firstfootvpos} (see
+\DescPageRef{\LabelBase.option.version}) the space is generally insufficient.
+In this case, you should reduce \PLength{firstfootvpos} (see
\DescPageRef{scrlttr2-experts.plength.firstfootvpos}) appropriately.%
-%
\EndIndexGroup
+
+\begin{Declaration}
+ \Variable{frombank}
+\end{Declaration}%
+\BeginIndex{}{letterhead page>footer}%
+The \Variable{frombank} variable used in the previous example
+occupies a special position. It is not currently used internally. However, you
+can use it to put the bank information\Index{bank information} in the
+extra sender information field or in the footer, as in the example (see
+the variable \DescRef{\LabelBase.variable.location},
+\DescPageRef{\LabelBase.variable.location}).%
%
\EndIndexGroup
%
\EndIndexGroup
-
\LoadCommonFile{parmarkup} % \section{Paragraph Markup}
\LoadCommonFile{oddorevenpage} % \section{Detection of Odd and Even Pages}
-\section{Head and Foot Using Predefined Page Style}
+\section{Headers and Footers with the Default Page Style}
\seclabel{pagestyle}
\BeginIndexGroup
\BeginIndex{}{page>style}%
-\BeginIndex{}{page>head}%
-\BeginIndex{}{page>foot}%
+\BeginIndex{}{page>header}%
+\BeginIndex{}{page>footer}%
-One of the general properties of a document is the page style. In {\LaTeX}
-this means mostly the contents of headers and
-footers. Like\textnote{Attention!} already mentioned in
-\autoref{sec:\LabelBase.firstpage}, the head and foot of the note paper are
-treated as elements of the note paper. Therefore they do not depend on the
-settings of the page style. So this section describes the page styles of the
-consecutive pages of letter after the note paper. At single-side letters this is
-the page style of the secondary letter sheet. At double-side letters this is
-also the page style of all backsides.
+One of the general properties of a document is its page style. In \LaTeX{}
+this mostly consists of the contents of headers and footers.
+As\textnote{Attention!} already mentioned in
+\autoref{sec:\LabelBase.firstpage}, the header and footer of the letterhead
+page are treated as elements of the letterhead page. Therefore they do not
+depend on the settings of the page style. So this section describes the page
+styles of the subsequent pages of a letter after the letterhead page. For
+one-sided letters, this is the page style of the second sheet. For two-sided
+letters, this is also the page style of all verso pages.
\begin{Declaration}
\Macro{letterpagestyle}
\end{Declaration}
The\ChangedAt{v3.19}{\Class{scrlttr2}\and \Package{scrletter}} default page
-style used for letters is specified by the contents of command
-\Macro{letterpagestyle}. With \Class{scrlttr2} an empty value has been
-predefined that does not change the
-page style of the letter from the page style of the document. This has been
-done, because \Class{scrlttr2} has been made for letter-only-documents. So it
-is much easier to define the page style of all letters with the page style of
-the document using \DescRef{\LabelBase.cmd.pagestyle} inside the preamble or before starting
-the first letter.
-
-The \PageStyle{plain} page style of letters differs from the \PageStyle{plain}
-page style of most classes. Therefore package \Package{scrletter} defines
-\Macro{letterpagestyle} with the contents
-\PageStyle{plain.letter}\IndexPagestyle{plain.letter}. So all letters will use
-the \PageStyle{plain} style of page style pair
-\PageStyle{letter}\IndexPagestyle{letter} by default and independent from the
-page style of the rest of the document. See
+style for letters is specified by the contents of the \Macro{letterpagestyle}
+command. By default\textnote{default},
+\Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} leaves this command empty. This
+means that the page style of letters is the same as in the rest of the
+document. This is useful because \Class{scrlttr2} is intended for letter-only
+documents, and it is easier to define the page style for all letters globally,
+using \DescRef{\LabelBase.cmd.pagestyle} as usual.
+
+Since both the \DescRef{\LabelBase.pagestyle.plain} and the
+\DescRef{\LabelBase.pagestyle.headings} page styles of other classes differs
+from the page style necessary for letters, the
+\Package{scrletter}\OnlyAt{\Package{scrletter}}\textnote{default} package
+defines \Macro{letterpagestyle} with to be
+\DescRef{\LabelBase.pagestyle.plain.letter}\IndexPagestyle{plain.letter}%
+\important{\DescRef{\LabelBase.pagestyle.plain.letter}}. This causes all
+letters to use the
+\hyperref[desc:\LabelBase.pagestyle.plain.letter]{\PageStyle{plain}} style of
+the \DescRef{\LabelBase.pagestyle.letter}\IndexPagestyle{letter} page style
+pair, regardless of the page style of the rest of the document. See
\autoref{sec:scrlttr2-experts.pagestyleatscrletter} for more information about
-the characteristics of the page style of package \Package{scrletter}.
+the characteristics of the page style of the \Package{scrletter} package.
\begin{Example}
- You are using package \Package{scrletter} and want to have the same page
- style inside letters as for the rest of the document. So you are using
+ You are using the \Package{scrletter} package and want letters to use the
+ same page style that was set for the rest of the document with
+ \DescRef{\LabelBase.cmd.pagestyle}. To do this, put the command
\begin{lstcode}
\renewcommand*{\letterpagestyle}{}
\end{lstcode}
- in your document preamble. Take care about the star of
- \Macro{renewcommand*}!
+ in your document preamble. Notice the star in \Macro{renewcommand*}.
\end{Example}
-Nevertheless, if you use \DescRef{\LabelBase.cmd.pagestyle} or \DescRef{\LabelBase.cmd.thispagestyle} inside a
-letter, this will overwrite the setting of \Macro{letterpagestyle} that is
-only the default for the initialisation inside
-\Macro{begin}\PParameter{document}.%
+Of course, if you use \DescRef{\LabelBase.cmd.pagestyle} or
+\DescRef{\LabelBase.cmd.thispagestyle} inside a letter, this will take
+precedence over the page style set in \Macro{begin}\PParameter{letter} with
+\Macro{letterpagestyle}.%
\EndIndexGroup
@@ -2408,39 +2455,67 @@ only the default for the initialisation inside
\OptionVName{headsepline}{simple switch}%
\OptionVName{footsepline}{simple switch}
\end{Declaration}
-These two options select whether or not to insert a separator
-line\Index{line>separator}\Index{rule>separator} below the header or above the
-footer, respectively, on consecutive pages. This option can take the standard
-values for simple switches, as listed in \autoref{tab:truefalseswitch},
-\autopageref{tab:truefalseswitch}.
-Activation\important{\OptionValue{headsepline}{true}} of option
-\Option{headsepline} switches on a rule below the page
-head. Activation\important{\OptionValue{footsepline}{true}} of option
-\Option{footsepline} switches on a rule above the page foot. Deactivation of
-the options switches of the corresponding rules.
-
-Obviously option \Option{headsepline} does not influence page style
-\PValue{empty}\important[i]{\PageStyle{empty}} (see afterwards at this
-section). This page style explicitly does not use any page head.
-
-Typographically\important[i]{\PageStyle{headings}\\
- \PageStyle{myheadings}\\\PageStyle{plain}} such a rule make a hard optical
-connection of head or foot and the text area. This would not mean, that the
-distance between head and text or text and foot should be increased. Instead
-of this the head or foot should be seen as parts of the typing area, while
-calculation of margins and typing area. To achieve this \KOMAScript{} will
-pass option \DescRef{typearea.option.headinclude}%
-\important[i]{\DescRef{typearea.option.headinclude}\\
- \DescRef{typearea.option.footinclude}} or
-\DescRef{typearea.option.footinclude}, respectively, to the \Package{typearea}
-package, if option \Option{headsepline} or \Option{footsepline}, respectively,
-are used as a class option. In\important{\PageStyle{plain}} opposite to
-\Option{headsepline} option \Option{footsepline} does influence page style
-\PValue{plain} also, because \PValue{plain} uses a page number at the
-foot. Package \Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage}%
-\important{\Package{scrlayer-scrpage}} (see \autoref{cha:scrlayer-scrpage})
-provides additional features for rules at head and foot and may be combined
-with \Class{scrlttr2}.%
+With these options \Class{scrlttr2}\OnlyAt{scrlttr2} can select whether to put
+a separator rule\Index{line>separator}\Index{rule>separator} below the header
+or above the footer, respectively, on subsequent pages. This option acccepts
+the standard values for simple switches listed in
+\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}.
+Activating\important{\OptionValue{headsepline}{true}} the \Option{headsepline}
+option enables a rule below the header.
+Activating\important{\OptionValue{footsepline}{true}} the \Option{footsepline}
+option enables a rule above the footer. Deactivating the options disables the
+corresponding rules.
+
+Of course, the \Option{headsepline} and \Option{footsepline} options have no
+effect on the \DescRef{\LabelBase.pagestyle.empty}%
+\important{\DescRef{\LabelBase.pagestyle.empty}} page style (see later in this
+section). This page style explicitly does not use headers or footers.
+
+Typographically\important{\DescRef{\LabelBase.pagestyle.headings}\\
+ \DescRef{\LabelBase.pagestyle.myheadings}\\
+ \DescRef{\LabelBase.pagestyle.plain}} speaking, such a rule creates an
+optical effect of making the header or footer appear to be closer to the text
+area. This does not mean that the distance between the header or footer and
+the text should be increased. Instead, they should be seen as part of the text
+body\Index{text>body} when calculating the type area. To achieve this
+\Class{scrlttr2} uses the \Option{headsepline} class option to automatically
+pass the \DescRef{typearea.option.headinclude}%
+\important{\DescRef{typearea.option.headinclude}} package option to the
+\hyperref[cha:typearea]{\Package{typearea}} package. The same applies to
+\DescRef{\LabelBase.option.footsepline} for
+\DescRef{typearea.option.footinclude}%
+\important{\DescRef{typearea.option.footinclude}}.
+
+The options themselves do not automatically recalculate the type area. To
+recalculate the type area, see the \DescRef{typearea.option.DIV} option with
+the \PValue{last} or \PValue{current} values (see
+\DescPageRef{typearea.option.DIV.last}), or the
+\DescRef{typearea.cmd.recalctypearea} command (see
+\DescPageRef{typearea.cmd.recalctypearea}) in \autoref{cha:typearea}.
+
+The \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}
+package (see \autoref{cha:scrlayer-scrpage}) provides further control over
+header and footer rules and you can also combine it with \Class{scrlttr2}. The
+\Package{scrletter} package automatically uses
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} to
+define the \DescRef{\LabelBase.pagestyle.letter} and
+\DescRef{\LabelBase.pagestyle.plain.letter} page styles.
+
+The\OnlyAt{\Package{scrletter}} \DescRef{\LabelBase.pagestyle.letter} and
+\DescRef{\LabelBase.pagestyle.plain.letter} page styles defined by
+\Package{scrletter} follow the rules of
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}. This particularly
+applies to setting the header and footer rules of the \PageStyle{plain} page
+style \DescRef{\LabelBase.pagestyle.plain.letter}. See in
+\autoref{sec:scrlayer-scrpage.pagestyle.content},
+\DescPageRef{scrlayer-scrpage.option.headsepline} and
+\DescPageRef{scrlayer-scrpage.option.plainheadsepline} the options
+\DescRef{scrlayer-scrpage.option.headsepline} and
+\DescRef{scrlayer-scrpage.option.plainheadsepline}. Also, settings like
+\DescRef{scrlayer-scrpage.option.automark} are of some importance for the
+\DescRef{\LabelBase.pagestyle.letter} page style.%
%
\EndIndexGroup
@@ -2448,51 +2523,59 @@ with \Class{scrlttr2}.%
\begin{Declaration}
\OptionVName{pagenumber}{position}
\end{Declaration}
-This option defines if and where a page number will be placed on consecutive
-pages. This option affects the page
-styles\important[i]{\PageStyle{headings}\\
- \PageStyle{myheadings}\\
- \PageStyle{plain}} \PageStyle{headings}, \PageStyle{myheadings}, and
-\PageStyle{plain}. It also affects the default page styles of the
-\Package{scrlayer-scrpage}\important{\Package{scrlayer-scrpage}} package, if
-set before loading the package (see \autoref{cha:scrlayer-scrpage}). It can
-take values only influencing horizontal, only vertical, or both
-positions. Available value are shown in
-\autoref{tab:\LabelBase.pagenumber}. Default is \PValue{botcenter}.
+With this option you can select if and where a page number should be placed on
+subsequent pages. In \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} this option
+affects the page styles\important{\DescRef{\LabelBase.pagestyle.headings}\\
+ \DescRef{\LabelBase.pagestyle.myheadings}\\
+ \DescRef{\LabelBase.pagestyle.plain}}
+\DescRef{\LabelBase.pagestyle.headings},
+\DescRef{\LabelBase.pagestyle.myheadings} and
+\DescRef{\LabelBase.pagestyle.plain}; in
+\Package{scrletter}\OnlyAt{\Package{scrletter}}, it affects the
+\DescRef{\LabelBase.pagestyle.letter} and
+\DescRef{\LabelBase.pagestyle.plain.letter} page styles. It also affects the
+default page styles of the
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}%
+\IndexPackage{scrlayer-scrpage} package, as long as it is set before that
+package is loaded (see \autoref{cha:scrlayer-scrpage}). It accepts values that
+influence only the horizontal position, only the vertical position, or both
+positions simultaneously. Available values are listed in
+\autoref{tab:\LabelBase.pagenumber}. The default is \PValue{botcenter}.
\begin{table}
- \caption[{available values of option \Option{pagenumber} with
- \Class{scrlttr2}}]{available values of option \Option{pagenumber} for the
- position of the page number in page styles \PageStyle{headings},
+ \caption[{Available values for the \Option{pagenumber} option with
+ \Class{scrlttr2}}]{Available values of the \Option{pagenumber} option to
+ position the page number in page styles \PageStyle{headings},
\PageStyle{myheadings}, and \PValue{plain} with \Class{scrlttr2}}
\label{tab:\LabelBase.pagenumber}
\begin{desctabular}
\entry{\PValue{bot}, \PValue{foot}}{%
- page number in footer, horizontal position not changed}%
+ page number in footer, horizontal position unchanged}%
\entry{\PValue{botcenter}, \PValue{botcentered}, \PValue{botmittle},
\PValue{footcenter}, \PValue{footcentered}, \PValue{footmiddle}}{%
- page number in footer, centered}%
+ page number in footer, centred}%
\entry{\PValue{botleft}, \PValue{footleft}}{%
- page number in footer, left justified}%
+ page number in footer, left-justified}%
\entry{\PValue{botright}, \PValue{footright}}{%
- page number in footer, right justified}%
+ page number in footer, right-justified}%
\entry{\PValue{center}, \PValue{centered}, \PValue{middle}}{%
- page number centered horizontally, vertical position not changed}%
+ page number centred horizontally, vertical position unchanged}%
\entry{\PValue{false}, \PValue{no}, \PValue{off}}{%
no page number}%
\entry{\PValue{head}, \PValue{top}}{%
- page number in header, horizontal position not changed}%
+ page number in header, horizontal position unchanged}%
\entry{\PValue{headcenter}, \PValue{headcentered}, \PValue{headmiddle},
\PValue{topcenter}, \PValue{topcentered}, \PValue{topmiddle}}{%
- page number in header, centered}%
+ page number in header, centred}%
\entry{\PValue{headleft}, \PValue{topleft}}{%
- page number in header, left justified}%
+ page number in header, left-justified}%
\entry{\PValue{headright}, \PValue{topright}}{%
- page number in header, right justified}%
+ page number in header, right-justified}%
\entry{\PValue{left}}{%
- page number left, vertical position not changed}%
+ page number left, vertical position unchanged}%
\entry{\PValue{right}}{%
- page number right, vertical position not changed}%
+ page number right, vertical position unchanged}%
\end{desctabular}
\end{table}
%
@@ -2503,59 +2586,124 @@ positions. Available value are shown in
\Macro{pagestyle}\Parameter{page style}%
\Macro{thispagestyle}\Parameter{local page style}
\end{Declaration}%
-In letters written with \Class{scrlttr2} there are four different
+\BeginIndex{Pagestyle}{empty}%
+\BeginIndex{Pagestyle}{plain}%
+\BeginIndex{Pagestyle}{headings}%
+\BeginIndex{Pagestyle}{myheadings}%
+Letters written with \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} have four
+different page styles available. In contrast,
+\Package{scrletter}\OnlyAt{\Package{scrletter}} defines only two of its own
page styles.
-\begin{description}
-\item[{\PageStyle{empty}%
- \IndexPagestyle[indexmain]{empty}\LabelPageStyle{empty}}] is the page
- style, in which the header and footer of consecutive pages are completely
- empty. This page style is also used for the first page, because header and
- footer of this page are set by other means using the macro
+\begin{description}\setkomafont{descriptionlabel}{}
+\item[{\PageStyle{empty}}]
+ \LabelPageStyle{empty} is the page style where the headers and footers of
+ subsequent pages are completely empty. This page style is also automatically
+ used for the first page of the letter because the header and footer of this
+ page are set by other means, using
\DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} (see
\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.cmd.opening}).
-\item[{\PageStyle{headings}%
- \IndexPagestyle[indexmain]{headings}\LabelPageStyle{heading}}] is the page
- style for running (automatic) headings on consecutive pages. The inserted
- marks are the sender's name from the variable
- \DescRef{\LabelBase.variable.fromname}\IndexVariable{fromname} and the
- subject from the variable \DescRef{\LabelBase.variable.subject}\IndexVariable{subject} (see
- \autoref{sec:\LabelBase.firstpage},
+\item[{\PageStyle{headings}}]
+ \LabelPageStyle{headings} is, for \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}},
+ the page style for automatic running heads on subsequent pages. The sender's
+ name from the \DescRef{\LabelBase.variable.fromname}\IndexVariable{fromname}
+ variable and the subject from the
+ \DescRef{\LabelBase.variable.subject}\IndexVariable{subject} variable are
+ used to set the marks (see \autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.fromname} and
- \DescPageRef{\LabelBase.variable.subject}). At which position these marks
- and the page numbers are placed, depends on the previously described option
- \DescRef{\LabelBase.option.pagenumber} and the \PName{content} of the variables
+ \DescPageRef{\LabelBase.variable.subject}). Where exactly these marks and
+ page numbers are placed depends on the
+ \DescRef{\LabelBase.option.pagenumber} described above and the
+ \PName{content} of the
\DescRef{\LabelBase.variable.nexthead}\IndexVariable{nexthead} and
- \DescRef{\LabelBase.variable.nextfoot}\IndexVariable{nextfoot}. The author can also change
- these marks manually after the \DescRef{\LabelBase.cmd.opening} command. To
- this end, the commands \DescRef{\LabelBase.cmd.markboth} and
- \DescRef{\LabelBase.cmd.markright} are available as usual, and with the use
- of package \Package{scrlayer-scrpage} also
- \DescRef{scrlayer-scrpage.cmd.markleft} (see
- \autoref{sec:scrlayer-scrpage.pagestyle.content},
- \DescPageRef{scrlayer-scrpage.cmd.automark}) is available.
-\item[{\PageStyle{myheadings}%
- \IndexPagestyle[indexmain]{myheadings}\LabelPageStyle{myheadings}}] is the
- page style for manual page headings on consecutive pages. This is very
- similar to \PValue{headings}, but here the marks must be set by the author
- using the commands \DescRef{\LabelBase.cmd.markboth}\IndexCmd{markboth} and
- \DescRef{\LabelBase.cmd.markright}\Index{markright}. With the use of package
- \Package{scrlayer-scrpage} also \DescRef{scrlayer-scrpage.cmd.markleft} can be utilized.
-\item[{\PageStyle{plain}%
- \IndexPagestyle[indexmain]{plain}\LabelPageStyle{plain}}] is the page
- style with only page numbers in the header or footer on consecutive
- pages. The placement of these page numbers is influenced by the previously
- described option \DescRef{\LabelBase.option.pagenumber}.
+ \DescRef{\LabelBase.variable.nextfoot}\IndexVariable{nextfoot} variables. An
+ author can also change these marks manually after the
+ \DescRef{\LabelBase.cmd.opening} command. As usual, the
+ \DescRef{\LabelBase.cmd.markboth} and \DescRef{\LabelBase.cmd.markright}
+ commands are available, as is \DescRef{scrlayer-scrpage.cmd.markleft} if you
+ use \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ \IndexPackage{scrlayer-scrpage}%
+ \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}
+ (see \autoref{sec:scrlayer-scrpage.pagestyle.content},
+ \DescPageRef{scrlayer-scrpage.cmd.automark}).
+
+ Since \Package{scrletter}\OnlyAt{scrletter} uses
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} internally, any
+ page style \DescRef{maincls.pagestyle.headings} provided by the class are
+ redefined as an alias of \DescRef{scrlayer-scrpage.pagestyle.scrheadings}.
+ You can find more about this page style in \autoref{cha:scrlayer-scrpage} on
+ \DescPageRef{scrlayer-scrpage.pagestyle.scrheadings}.
+\item[{\PageStyle{letter}}]
+ \LabelPageStyle{letter}%
+ Since the \PageStyle{headings} page style is generally already in use by
+ the classes, the \Package{scrletter}\OnlyAt{scrletter} package instead
+ defines the \PageStyle{letter} page style. This is accomplished with the
+ help of \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} in
+ \autoref{cha:scrlayer-scrpage}, \autopageref{cha:scrlayer-scrpage}. With the
+ \OptionValueRef{scrlayer-scrpage}{automark}{true}%
+ \important{\OptionValueRef{scrlayer-scrpage}{automark}{true}}%
+ \IndexOption{automark} setting enabled, \PageStyle{letter} then assumes the
+ role played by \PageStyle{headings} in \Class{scrlttr2}. With
+ \OptionValueRef{scrlayer-scrpage}{automark}{false}%
+ \important{\OptionValueRef{scrlayer-scrpage}{automark}{false}}%
+ \IndexOption{automark} set, \PageStyle{letter} assumes the role of
+ \PageStyle{myheadings}.
+
+ When\textnote{Attention!} you use
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} with
+ \Package{scrletter}, you cannot use the obsolete
+ \Package{scrpage2}\IndexPackage{scrpage2} package or the
+ \Package{fancyhdr}\IndexPackage{fancyhdr} package, which is incompatible
+ with \KOMAScript{}.
+\item[{\PageStyle{myheadings}}]
+ \LabelPageStyle{myheadings}%
+ in \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} is the page style for manual
+ running heads on subsequent pages. Unlike \PValue{headings}, you must set
+ the marks yourself with the
+ \DescRef{\LabelBase.cmd.markboth}\IndexCmd{markboth} and
+ \DescRef{\LabelBase.cmd.markright}\IndexCmd{markright} commands. When you
+ use \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}},
+ \DescRef{scrlayer-scrpage.cmd.markleft}\IndexCmd{markleft} is also
+ available.
+
+ With the \Package{scrletter}\OnlyAt{\Package{scrletter}} package, the
+ \PageStyle{letter} page style also assumes the role of
+ \PageStyle{myheadings}.
+\item[{\PageStyle{plain}}]
+ \LabelPageStyle{plain}%
+ is the default page style for \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}},
+ which does not use any headers on subsequent pages and only outputs
+ a single page number. Where this is placed depends on the
+ \DescRef{\LabelBase.option.pagenumber} option explained above.
+
+ Since \Package{scrletter}\OnlyAt{scrletter} uses
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} internally, the
+ \DescRef{maincls.pagestyle.plain} page style is redefined as an alias of
+ \DescRef{scrlayer-scrpage.pagestyle.plain.scrheadings}. You can find more
+ about this page style in \autoref{cha:scrlayer-scrpage} on
+ \DescPageRef{scrlayer-scrpage.pagestyle.scrheadings}.
+\item[{\PageStyle{plain.letter}}]
+ \LabelPageStyle{plain.letter}%
+ Since the \PageStyle{plain} page style is generally already in use by the
+ classes, the \Package{scrletter}\OnlyAt{scrletter} defines a
+ \PageStyle{plain.letter} page style instead. This is accomplished with the
+ help of \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}.
+ When\textnote{Attention!} you use
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} with
+ \Package{scrletter}, you cannot use the obsolete
+ \Package{scrpage2}\IndexPackage{scrpage2} package or the
+ \Package{fancyhdr}\IndexPackage{fancyhdr} package, which is incompatible
+ with \KOMAScript{}.
\end{description}
-Page styles are also influenced by the previously described
-options\important[i]{\DescRef{\LabelBase.option.headsepline}\\
+The appearance of the page styles is also influenced by
+the\important{\DescRef{\LabelBase.option.headsepline}\\
\DescRef{\LabelBase.option.footsepline}}
\DescRef{\LabelBase.option.headsepline}\IndexOption{headsepline} and
-\DescRef{\LabelBase.option.footsepline}\IndexOption{footsepline}. The page
-style beginning with the current page is switched using \Macro{pagestyle}. In
-contrast, \Macro{thispagestyle} changes only the page style of the current
-page. The\textnote{Attention!} letter class itself uses
-\Macro{thispagestyle}\PParameter{empty} within
+\DescRef{\LabelBase.option.footsepline}\IndexOption{footsepline} options
+described above. The page style beginning with the current page is changed
+using \Macro{pagestyle}. In contrast, \Macro{thispagestyle} changes only the
+page style of the current page. The\textnote{Attention!} letter class itself
+uses \Macro{thispagestyle}\PParameter{empty} within
\DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} for the first page of the
letter.
@@ -2564,24 +2712,23 @@ letter.
\BeginIndex{FontElement}{pageheadfoot}\LabelFontElement{pageheadfoot}%
\BeginIndex{FontElement}{pagefoot}\LabelFontElement{pagefoot}%
\BeginIndex{FontElement}{pagenumber}\LabelFontElement{pagenumber}%
-For changing the font style of headers or footers you should use the user
-interface described in \autoref{sec:maincls.textmarkup}. For header and
-footer the same element is used, which you can name either
+To changing the font style of headers or footers, you should use the user
+interface described in \autoref{sec:maincls.textmarkup}. The header and footer
+use the same element, which you can refer to by either
\FontElement{pageheadfoot}\important{\FontElement{pagehead}} or
-\FontElement{pagehead}. There\ChangedAt{v3.00}{\Class{scrlttr2}} is an
-additional element \FontElement{pagefoot}\important{\FontElement{pagefoot}}
-for the page foot. This will be used after \FontElement{pageheadfoot} at page
-foots, that has been defined either with variable
-\DescRef{\LabelBase.variable.nextfoot}\IndexVariable{nextfoot} or Package
-\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} (see
-\autoref{cha:scrlayer-scrpage},
-\DescPageRef{scrlayer-scrpage.fontelement.pagefoot}). The element for the
-page number within the header or footer is named
-\FontElement{pagenumber}\important{\FontElement{pagenumber}}. Default settings
-are listed in \autoref{tab:maincls.defaultFontsHeadFoot},
-\autopageref{tab:maincls.defaultFontsHeadFoot}. Please have also a look at
-the example in \autoref{sec:maincls.pagestyle},
-\PageRefxmpl{maincls.cmd.pagestyle}.
+\FontElement{pagehead}. The\ChangedAt{v3.00}{\Class{scrlttr2}}
+\FontElement{pagefoot}\important{\FontElement{pagefoot}} element
+additionally controls the formatting of the footer. This element is applied
+after \FontElement{pageheadfoot} in the
+\DescRef{\LabelBase.variable.nextfoot}\IndexVariable{nextfoot} variable or
+when \Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} page styles are
+used (see \autoref{cha:scrlayer-scrpage},
+\DescPageRef{scrlayer-scrpage.fontelement.pagefoot}). The element for the page
+number within the header or footer is called
+\FontElement{pagenumber}\important{\FontElement{pagenumber}}. The default
+settings are listed in \autoref{tab:maincls.defaultFontsHeadFoot},
+\autopageref{tab:maincls.defaultFontsHeadFoot}. Please also note the example
+from \autoref{sec:maincls.pagestyle}, \PageRefxmpl{maincls.cmd.pagestyle}.
%
\EndIndexGroup
%
@@ -2592,55 +2739,56 @@ the example in \autoref{sec:maincls.pagestyle},
\Macro{markboth}\Parameter{left mark}\Parameter{right mark}%
\Macro{markright}\Parameter{right mark}
\end{Declaration}
-The possibilities that are offered with variables and options in
-\Class{scrlttr2} should be good enough in most cases to create letterheads and
-footers for the consecutive pages that follow the first letter page. Even more
-so since you can additionally change with \Macro{markboth} and
-\Macro{markright} the sender's statements that \Class{scrlttr2} uses to create
-the letterhead. The commands \Macro{markboth}\IndexCmd{markboth} and
-\Macro{markright}\IndexCmd{markright} can in particular be used together with
-pagestyle \PageStyle{myheadings}\IndexPagestyle{myheadings}%
-\important{\PageStyle{myheadings}}. If the package
-\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} is used then this,
-of course, is valid also for pagestyle
-\PValue{scrheadings}\IndexPagestyle{scrheadings}. There the command
-\DescRef{scrlayer-scrpage.cmd.markleft}\IndexCmd{markleft} is furthermore
+In most cases, \KOMAScript{}'s options and variables should be quite adequate
+for creating headers\Index{header} and footers\Index{footer} for the
+subsequent pages, all the more so because, in addition to \Macro{markboth} and
+\Macro{markright}, you can change the sender information that \Class{scrlttr2}
+or \Package{scrletter} puts in the header. You can, in particular, use the
+\Macro{markboth}\IndexCmd{markboth} and \Macro{markright}\IndexCmd{markright}
+commands with the \PageStyle{myheadings}\IndexPagestyle{myheadings}%
+\important{\PageStyle{myheadings}} pagestyle. Of course, if you use the
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}
+package, this is also valid for the
+\PValue{scrheadings}\IndexPagestyle{scrheadings} page style. In that case, the
+\DescRef{scrlayer-scrpage.cmd.markleft}\IndexCmd{markleft} command is also
available.
\begin{Declaration}
\Variable{nexthead}%
\Variable{nextfoot}%
\end{Declaration}
-At times one wants to have more freedom with creating the letterhead or footer
-of subsequent pages. Then one has to give up the previously described
-possibilities of predefined letterheads or footers that could have been chosen
-via the option
-\DescRef{\LabelBase.option.pagenumber}\IndexOption{pagenumber}. Instead one is
-free to create the letterhead and footer of consecutive pages just the way one
-wants to have them set with page style
-\PageStyle{headings}\IndexPagestyle{headings}\important{\PageStyle{headings},
- \PageStyle{myheadings}} or
-\PageStyle{myheadings}\IndexPagestyle{myheadings}. For that, one creates the
-desired letterhead or footer construction using the \PName{content} of
-variable\ChangedAt{v3.08}{\Class{scrlttr2}} \Variable{nexthead} or
-\Variable{nextfoot}, respectively. Within the \PName{content} of
-\Variable{nexthead} and \Variable{nextfoot} you can, for example, have several
-boxes side by side or one beneath the other by use of the \Macro{parbox}
-command (see \cite{latex:usrguide}). A more advanced user should have no
-problems creating letterheads of footers of his own. Within \PName{content}
-you can and should of course also make use of other variables by using
+At times, however, you may want to the header or the footer of subsequent pages
+to more closely resemble the letterhead page. In these cases, you must dispense
+with the predefined options that can be selected with the
+\DescRef{\LabelBase.option.pagenumber}\IndexOption{pagenumber} option described above.
+Instead, you can customise the header and footer of subsequent pages using the
+\DescRef{\LabelBase.pagestyle.headings}\IndexPagestyle{headings}%
+\important{\DescRef{\LabelBase.pagestyle.headings},
+ \DescRef{\LabelBase.pagestyle.myheadings}} or
+\DescRef{\LabelBase.pagestyle.myheadings}\IndexPagestyle{myheadings} page styles with \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}},
+and the \DescRef{\LabelBase.pagestyle.letter}%
+\IndexPagestyle{letter}\important{\DescRef{\LabelBase.pagestyle.letter}} page style
+with \Package{scrletter}\OnlyAt{\Package{scrletter}}. To do so, you create the
+structure you want in the \PName{content} of
+the\ChangedAt{v3.08}{\Class{scrlttr2}} \Variable{nexthead} or
+\Variable{nextfoot} variables. Within the \PName{content} of
+\Variable{nexthead} and \Variable{nextfoot} you can, for example, use the \Macro{parbox}
+command to place several boxes next to or beneath each other (see \cite{latex:usrguide}). More advanced users should
+be able to create their own headers and footers. Of course, you can
+and should also make use of additional variables using
\DescRef{\LabelBase.cmd.usekomavar}. \KOMAScript{} does not use the
-\PName{description} of both variables.
-
-Only\textnote{Attention!} for compatibility reason the deprecated commands
-\Macro{nexthead}\IndexCmd[indexmain]{nexthead} and
-\Macro{nextfoot}\IndexCmd[indexmain]{nextfoot} of former \Class{scrlttr2}
-releases before 3.08 are also implemented. Nevertheless, you should not use
-those.%
+\PName{description} for either variable.
%
-\EndIndexGroup
+%Only\textnote{Attention!} for compatibility reason the deprecated commands
+%\Macro{nexthead}\IndexCmd[indexmain]{nexthead} and
+%\Macro{nextfoot}\IndexCmd[indexmain]{nextfoot} of former \Class{scrlttr2}
+%releases before 3.08 are also implemented. Nevertheless, you should not use
+%those.%
%
\EndIndexGroup
+\EndIndexGroup
%
\EndIndexGroup
@@ -2652,46 +2800,45 @@ those.%
\LoadCommonFile{lists}% \section{Lists}
-\section{Math}
+\section{Mathematics}
\seclabel{math}%
\BeginIndexGroup
\BeginIndex{}{equations}%
\BeginIndex{}{formulas}%
\BeginIndex{}{mathematics}%
-There are not math environments implemented at the \KOMAScript{}
-classes. Instead of this, the math features of the \LaTeX{} kernel have been
-supported. Furthermore\textnote{Attention!} regular math with numbered
-equations or formulas is very unusual at letters. Because of this
-\Class{scrlttr2} does not actively support numbered equations. Therefore
-options \DescRef{maincls.option.leqno} and \DescRef{maincls.option.fleqn},
-that has been described for \Class{scrbook}, \Class{scrreprt}, and
-\Class{scrartcl} at \autoref{sec:maincls.math} are not available from
-\Class{scrlttr2}.
-
-You will not find a description of the math environments of the \LaTeX{} kernel
-here. If you want to use \Environment{displaymath}\IndexEnv{displaymath},
-\Environment{equation}\IndexEnv{equation} and
-\Environment{eqnarray}\IndexEnv{eqnarray} you should read a short introduction
-into \LaTeX{} like \cite{lshort}. But\textnote{Hint!} if you want more than
-very simple mathematics, usage of package \Package{amsmath} would be
-recommended (see \cite{package:amsmath}).%
+The \KOMAScript{} classes do not provide their own maths environments.
+Instead, \KOMAScript{} relies completely on the maths features of the \LaTeX{}
+kernel. However\textnote{Attention!}, since numbered equations and formulas
+are very unusual in letters, \KOMAScript{} does not actively support them.
+Therefore, the \DescRef{maincls.option.leqno} and
+\DescRef{maincls.option.fleqn} options for \Class{scrbook}, \Class{scrreprt},
+and \Class{scrartcl}, documented in \autoref{sec:maincls.math}, are not
+available with \Class{scrlttr2}.
+
+You will not find a description here of the maths environments of the \LaTeX{}
+kernel, that is \Environment{displaymath}\IndexEnv{displaymath},
+\Environment{equation}\IndexEnv{equation}, and
+\Environment{eqnarray}\IndexEnv{eqnarray}. If you want to use them, consult an
+introduction to \LaTeX{} like \cite{lshort}. But\textnote{Hint!} if you want
+more than very simple mathematics, you should use the \Package{amsmath}
+package (see \cite{package:amsmath}).%
%
\EndIndexGroup
-\section{Floating Environments of Tables and Figures}
+\section{Floating Environments for Tables and Figures}
\seclabel{floats}
-Floating environments for tables or figures are very unusual in
-letters. Therefore\textnote{Attention!} \Class{scrlttr2} does not provide
-them. If someone nevertheless needs floating environments, then this is often
-points out a malpractice of the letter class. In such cases you may try to
-define the floating environments with help of packages like \Package{tocbasic}\important{\Package{tocbasic}} (siehe
-\autoref{cha:tocbasic}). Nevertheless, tabulars and pictures or graphics
-without floating environment may still be done with the letter class
-\Class{scrlttr2}.
-
+Floating environments for tables or figures are very unusual in letters.
+Therefore\textnote{Attention!} \Class{scrlttr2} does not provide them. If you
+still believe you need them, this often indicates a misuse of the letter
+class. In such cases, it is advisable to combine one of the \KOMAScript{}
+classes from \autoref{cha:maincls} with the
+\Package{scrletter}\important{\Package{scrletter}} package instead. In this
+case you, the floating environments documented for the class can also be used
+in letters. You could also define your own floating environments with help of
+\Package{tocbasic}\important{\Package{tocbasic}} (see \autoref{cha:tocbasic}).
\LoadCommonFile{marginpar} % \section{Margin Notes}
@@ -2704,68 +2851,73 @@ without floating environment may still be done with the letter class
\BeginIndex{}{signature}%
\BeginIndex{}{letter>signature}%
-That the letter closing will be set by
-\DescRef{\LabelBase.cmd.closing}\IndexCmd{closing} has been explained already
-in \autoref{sec:\LabelBase.document}, \DescPageRef{\LabelBase.cmd.closing}. A kind
-of annotation to the signature is often placed below the signature of the
-letter. The signing or hand-written inscription itself is placed between this
-signature annotation and the closing phrase.
+It has already been mentioned in \autoref{sec:\LabelBase.document},
+\DescPageRef{\LabelBase.cmd.closing} that the letter's closing text is
+provided by \DescRef{\LabelBase.cmd.closing}\IndexCmd{closing}. Beneath the
+closing text, there is often a space for a handwritten signature, beneath
+which there can be a printed name, which serves as a kind of annotation to the
+actual signature.
\begin{Declaration}
\Variable{signature}%
\end{Declaration}
-The variable \Variable{signature} holds an explanation or annotation for the
-inscription, the signing of the letter. The \PName{content} is predefined as
-\DescRef{\LabelBase.cmd.usekomavar}\PParameter{fromname}. The annotation may
-consist of multiple lines. The lines should then be separated by a double
-backslash. Paragraph\textnote{Attention!} breaks in the annotation are however
-not permitted.%
+The \Variable{signature} variable contains the printed name or annotation for
+the handwritten signature. Its default \PName{content} is the
+\DescRef{\LabelBase.cmd.usekomavar}\PParameter{fromname}. This annotation can
+consist of multiple lines. In that case, you should separate the individual
+lines with double backslashes. Paragraph\textnote{Attention!} breaks in the
+signature annotation, however, are not permitted.%
\EndIndexGroup
\begin{Declaration}
\Macro{raggedsignature}
\end{Declaration}
-Closing phrase and signature will be typeset in a box. The width of
-the box is determined by the length of the longest line of the closing
-phrase or signature's \PName{content}.
-
-Where to place this box is determined by the pseudo-lengths
-\PLength{sigindent}\IndexPLength{sigindent} and
-\PLength{sigbeforevskip}\IndexPLength{sigbeforevskip} (see
-\autoref{sec:scrlttr2-experts.closing},
-\DescPageRef{scrlttr2-experts.plength.sigindent}). The command
-\Macro{raggedsignature} defines the alignment inside the box. In the
-predefined \File{lco} files the command is either defined as \Macro{centering}
-(all besides \Option{KOMAold}) or \Macro{raggedright} (\Option{KOMAold}). In
-order to obtain flush-right or flush-left alignment inside the box, the
-command can be redefined in the same way as
-\DescRef{maincls.cmd.raggedsection} (see \autoref{sec:maincls.structure},
+The closing phrase and the signature will be typeset in a box. The width of
+the box is determined by the length of the longest line in the closing
+phrase or signature.
+
+The \PLength{sigindent}\IndexPLength{sigindent} and
+\PLength{sigbeforevskip}\IndexPLength{sigbeforevskip} pseudo-lengths determine
+exactly where this box is placed (see \autoref{sec:scrlttr2-experts.closing},
+\DescPageRef{scrlttr2-experts.plength.sigindent}). The \Macro{raggedsignature}
+command defines the alignment inside the box. In the default \File{lco} files,
+the command is either defined as \Macro{centering} (all besides
+\Option{KOMAold}) or \Macro{raggedright} (\Option{KOMAold}). In order to
+obtain flush-right or flush-left alignment inside the box, you can redefine
+the command in the same way as \DescRef{maincls.cmd.raggedsection} (see the
+example in \autoref{sec:maincls.structure},
\DescPageRef{maincls.cmd.raggedsection}).
\begin{Example}
- Now, Mr Public really wants to aggrandize himself. Therefor he uses the
- signature to show again, that he himself was formerly chairman. Because of
- this he changes \PName{contents} of variable
- \DescRef{\LabelBase.variable.signature}. Additionally he wants the signature
- be flush-left aligned and so he also redefines \Macro{raggedsignature}:%
+ Now Mr Public wants to make himself seem really important, and therefore he uses the
+ signature to show once again that he was formerly a chairman himself. So
+ he changes \PName{contents} of the
+ \DescRef{\LabelBase.variable.signature} variable. He also wants the signature
+ be aligned flush-left and so he also redefines \Macro{raggedsignature}:%
\lstinputcode[xleftmargin=1em]{letter-22}%
See \autoref{fig:\LabelBase.letter-22} for the result.
\begin{figure}
\setcapindent{0pt}%
\begin{captionbeside}[{Example: letter with extended sender, logo,
- addressee, additional sender information, place, date, subject,
+ recipient, extra sender information, place, date, subject,
opening, text, closing, modified signature, postscript, distribution
- list, enclosure, and puncher hole mark}]
- {result of a small letter with extended sender, logo, addressee,
- additional sender information, place, date, subject opening, text,
+ list, enclosure, and hole-punch mark}]
+ {result of a short letter with extended sender, logo, recipient,
+ extra sender information, place, date, subject opening, text,
closing, modified signature, postscript, distribution list, enclosure
- and puncher hole mark}[l]
+ and hole-punch mark}[l]
\frame{\includegraphics[width=.4\textwidth]{letter-22}}
\end{captionbeside}
\label{fig:\LabelBase.letter-22}
\end{figure}
\end{Example}
+
+\iftrue% Umbruchkorrekturtext
+ The preceding example shows the most important, although not all possible,
+ elements of a letter. It can, however, serve quite well as a general
+ template.%
+\fi
%
\EndIndexGroup
%
@@ -2775,244 +2927,283 @@ command can be redefined in the same way as
\section{Letter Class Option Files}
\seclabel{lcoFile}%
\BeginIndexGroup
-\BeginIndex{}{lco-file=\File{lco}-file}%
+\BeginIndex{}{lco file=\File{lco} file}%
\BeginIndex{}{letter class option}%
-\BeginIndex{}{letter>class option}%
Normally, you would not redefine selections like the sender's information
every time you write a letter. Instead, you would reuse a whole set of
-parameters for certain occasions. It will be much the same for the letterhead
-and footer used on the first page. Therefore, it is reasonable to save these
-settings in a separate file. For this purpose, the \Class{scrlttr2} class
-offers the \File{lco}-files. The \File{lco} suffix is an abbreviation for
+parameters for certain occasions. The same applies to the letterhead
+and footer used on the first page. Therefore it makes sense to save these
+settings in a separate file. For this purpose, \KOMAScript{} offers
+\File{lco} files. The \File{lco} suffix is an abbreviation for
\emph{\emph{l}etter \emph{c}lass \emph{o}ption}.
-In an \File{lco} file you can use all commands available to the document at
-the time the \File{lco} file is loaded. Additionally, it can contain internal
-commands available to package writers. For \Class{scrlttr2}, these are in
-particular the commands
+In an \File{lco} file, you can use all commands available to the document at
+the time the \File{lco} file is loaded. You can also use internal commands
+available to package writers. For \Class{scrlttr2} and \Package{scrletter},
+these are, in particular, the commands
\DescRef{scrlttr2-experts.cmd.@newplength}\IndexCmd{@newplength},
\DescRef{scrlttr2-experts.cmd.@setplength}\IndexCmd{@setplength}, and
\DescRef{scrlttr2-experts.cmd.@setplength}\IndexCmd{@addtoplength} (see
\autoref{sec:scrlttr2-experts.pseudoLengths}).
-There are already some \File{lco} files included in the {\KOMAScript}
-distribution. The \File{DIN.lco}, \File{DINmtext.lco}, \File{SNleft.lco},
-\File{SN.lco}, \File{UScommercial9}, \File{UScommercial9DW},
-\File{NF.lco}\ChangedAt{v3.04}{\Class{scrlttr2}} files serve to adjust
-{\KOMAScript} to different layout standards. They are well suited as templates
-for your own parameter sets, while you become a \KOMAScript{} expert. The
-\File{KOMAold.lco} file, on the other hand, serves to improve compatibility
-with the old letter class \Class{scrlettr}. Since it contains internal
-commands not open to package writers, you should not use this as a template
-for your own \File{lco} files. You can find a list of predefined \File{lco}
-files in \autoref{tab:lcoFiles}, \autopageref{tab:lcoFiles}.
-
-If you have defined a parameter set for a letter standard not yet supported by
-\KOMAScript, you are explicitly invited to send this parameter set to the
-{\KOMAScript} support address. Please do not forget to include the permission
-for distribution under the {\KOMAScript} license (see the \File{lppl.txt}
-file). If you know the necessary metrics for an unsupported letter standard,
-but are not able to write a corresponding \File{lco} file yourself, you can
-also contact the {\KOMAScript} author, Markus Kohm, directly. More
-particular complex examples of \File{lco}-files are shown at \cite{homepage}
-or in \cite{DANTE:TK0203:MJK}. Both locations are mainly in German.
+\KOMAScript{} comes provided with some \File{lco} files. The \File{DIN.lco},
+\File{DINmtext.lco}, \File{SNleft.lco}, \File{SN.lco}, \File{UScommercial9},
+\File{UScommercial9DW}, and \File{NF.lco}\ChangedAt{v3.04}{\Class{scrlttr2}}
+files serve to adapt \Class{scrlttr2} and \Package{scrletter} to different
+standards. They are well suited as templates for your own parameter sets as
+you become a \KOMAScript{} expert. The \File{KOMAold.lco} file, on the other
+hand, serves to improve compatibility with the old letter class
+\Class{scrlettr}. This class was removed from \KOMAScript{} over fifteen years
+ago. It is therefore not discussed in any detail. Since this file also
+contains internal commands that are not released for package writers, you
+should not use this as a template for your own \File{lco} files. You can find
+a list of predefined \File{lco} files in \autoref{tab:lcoFiles},
+\autopageref{tab:lcoFiles}.
+
+If you have defined a parameter set for a letter standard that is not yet
+supported by \KOMAScript{}, you are explicitly requested to send this
+parameter set to the \KOMAScript{} support address. Please also provide
+permission for distribution under the \KOMAScript{} license (see the
+\File{lppl.txt} file). If you have the necessary measurements for an
+unsupported letter standard but are unable to write a corresponding \File{lco}
+file yourself, you can also contact the \KOMAScript{} author, Markus Kohm,
+directly. you can find further examples of \File{lco} files, some very
+complex, at \cite{homepage} or in \cite{DANTE:TK0203:MJK}. Both sites are
+mainly in German.
+
\begin{Declaration}
\Macro{LoadLetterOption}\Parameter{name}%
\Macro{LoadLetterOptions}\Parameter{list of names}
\end{Declaration}
-With \Class{scrlttr2} \File{lco}-files can be loaded by the
-\Macro{documentclass} command. You enter the name of the \File{lco}-file
-without suffix as an option\Index{option}. In this case, the \File{lco}-file
-will be loaded right after the class file.
-
-However, it is recommended to load an \File{lco}-file using
-\Macro{LoadLetterOption} or
-\Macro{LoadLetterOptions}\ChangedAt{v3.14}{\Class{scrlttr2}}. You can do this
-even from within another \File{lco}-file. Both commands take the \PName{name}
-of the \File{lco}-file without suffix, \Macro{LoadLetterOption} as a single
-parameter, \Macro{LoadLetterOptions} as one member of a comma-separated
-\PName{list of names}. The corresponding \File{lco}-files will be loaded in
-the order given by the list.
+With \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} you can load \File{lco} files
+with the \Macro{documentclass} command. To do so, give the name of the
+\File{lco} file without the extension as an option\Index{option}. The
+\File{lco} file is then loaded directly after the class. The
+\Package{scrletter}\textnote{Attention!} package does not offer this option.
+To load \File{lco} files, you must use \Macro{LoadLetterOption} or
+\Macro{LoadLetterOptions}\ChangedAt{v3.14}{\Class{scrlttr2}}.
+This\textnote{Recommendation!} is also recommended for \Class{scrlttr2}.
+
+You can also use \Macro{LoadLetterOption} and \Macro{LoadLetterOptions} after
+\Macro{begin}\PParameter{document}, or even from within another \File{lco}
+file. Both commands take the \PName{name} of the \File{lco} file without the
+extension. While the argument of \Macro{LoadLetterOption} should be exactly
+one \File{lco} file, \Macro{LoadLetterOptions} accepts a comma-separated
+\PName{list of names}. The corresponding \File{lco} files with those names are
+loaded in the order given by the list.
\begin{Example}
- Mr Public also writes a document containing several letters. Most of them
- should comply with the German DIN standard. So he starts with:
+ Joe Public also writes a document containing several letters. For most of
+ them, the default format, which follows the format of the German Institute
+ for Standardisation, or \emph{Deutsches Institut f\"{u}r Normung} (DIN), is
+ sufficient. So he starts with:
\begin{lstcode}
\documentclass{scrlttr2}
\end{lstcode}
- However, one letter should use the \File{DINmtext} variant, with the
- address field placed more toward the top, which results in more text
- fitting on the first page. The folding will be modified so that the
- address field still matches the address window in a DIN~C6/5 envelope.
- You can achieve this as follows:
+ However, he wants to send one letter in a C6/5 envelope, and so he
+ uses the \File{DINmtext} variant, in which the
+ address field appears higher on the page, so that more text
+ fits on the first page. The fold marks are adjusted so that the
+ address field still fits the address window in a C6/5 envelope.
+ He achieves this as follows:
\begin{lstcode}
\begin{letter}{%
- Joana Public\\
- Hillside 1\\
- 12345 Public-City}
+ Joanna Public\\
+ 1 Hillside\\
+ SAMPLESTEAD\\
+ WX12 3YZ}
\LoadLetterOption{DINmtext}
\opening{Hello,}
\end{lstcode}
- Since construction of the page does not start before the
- \DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} command, it is sufficient
- to load the \File{lco}-file before this. In particular, the loading need not
- be done before \Macro{begin}\PParameter{letter}. Therefore the changes made
- by loading the \File{lco}-file are local to the corresponding letter.
+ Since construction of the first page only really begins with the
+ \DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} command, you only need to
+ load the \File{lco} file before this point. In particular, you do not need
+ to load it before \Macro{begin}\PParameter{letter}. That way the changes
+ made by loading the \File{lco} file are local to the corresponding letter.
\end{Example}
-If\ChangedAt{v2.97}{\Class{scrlttr2}} an \File{lco}-file is loaded via
-\Macro{documentclass}, then it may no longer have the same name as an option.
+If\ChangedAt{v2.97}{\Class{scrlttr2}} an \File{lco} file is loaded via
+\Macro{documentclass}, then it must not have the same name as an option.
\begin{Example}
- Since Mr~Public often writes letters with the same options and parameters,
- he does not like to copy all these to each new letter. To simplify the effort
- of writing a new letter, he therefore makes a \File{lco}-file:%
+ Since Mr Public often writes letters with the same options and parameters,
+ he finds it quite annoying to copy this information to each new letter. To
+ simplify the effort of writing a new letter, he therefore creates an
+ \File{lco} file:%
\lstinputcode[xleftmargin=1em]{ich.lco}%
- With this the size of the previous letter decreases to:
- \lstinputcode[xleftmargin=1em]{letter-23.tex}%
- Nevertheless, as shown in \autoref{fig:\LabelBase.letter-23}, the result
- does not change.
+ With this, the size of his letter from the previous example shrinks
+ considerably: \lstinputcode[xleftmargin=1em]{letter-23.tex}%
+ Nevertheless, the result does not change, as shown in
+ \autoref{fig:\LabelBase.letter-23}.
\begin{figure}
\setcapindent{0pt}%
\begin{captionbeside}[{Example: letter with extended sender, logo,
- addressee, additional sender information, place, date, subject,
+ recipient, extra sender information, place, date, subject,
opening, text, closing, modified signature, postscript, distribution
- list, enclosure, and puncher hole mark using a \File{lco}-file}]
- {result of a small letter with extended sender, logo, addressee,
- additional sender information, place, date, subject opening, text,
+ list, enclosure, and hole-punch mark using an \File{lco} file}]
+ {result of a short letter with extended sender, logo, recipient,
+ extra sender information, place, date, subject opening, text,
closing, modified signature, postscript, distribution list, enclosure
- and puncher hole mark using a \File{lco}-file}[l]
+ and hole-punch mark using an \File{lco} file}[l]
\frame{\includegraphics[width=.4\textwidth]{letter-23}}
\end{captionbeside}
\label{fig:\LabelBase.letter-23}
\end{figure}
\end{Example}
-Please note\textnote{Attention!} that immediately after loading the
-document class normally neither a package for the input encoding nor a
-language package has been loaded. Because of this, you should use \TeX's 7-bit
-encoding for all characters, e.\,g., use ``\Macro{ss}'' to produce a German
+Note\textnote{Attention!} that immediately after loading the document class,
+normally neither a package for the input encoding nor a language package has
+been loaded. Because of this, you should use \TeX's 7-bit encoding for all
+non-ASCII characters. For example, use ``\Macro{ss}'' to produce a German
``\ss''.
In \autoref{tab:lcoFiles}, \autopageref{tab:lcoFiles} you can find a list of
all predefined \File{lco} files. If\textnote{Attention!} you use a printer
that has large unprintable areas on the left or right side, you might have
problems with the \Option{SN}\IndexOption{SN} option. Since the Swiss standard
-SN~101\,130 defines the address field to be placed 8\Unit{mm} from the right
-paper edge, the headline and the sender attributes too will be set with the
-same small distance from the paper edge. This also applies to the reference
-line when using the \DescRef{\LabelBase.option.refline}\PValue{=wide} option
-(see \autoref{sec:\LabelBase.firstpage},
-\DescPageRef{\LabelBase.option.refline}). If\textnote{Hint!} you have this
-kind of problem, create your own \File{lco} file that loads \Option{SN} first
-and then changes \PLength{toaddrhpos}\IndexPLength{toaddrhpos} (see
+SN~101\,130 stipulates that the address field should be placed 8\Unit{mm} from
+the right edge of the paper, the headline and the sender attributes are also
+placed at a correspondingly small distance from the paper edge. This also
+applies to the reference line when using the
+\DescRef{\LabelBase.option.refline}\PValue{=wide} option (see
+\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.option.refline}).
+If\textnote{Hint!} you have this kind of problem, create your own \File{lco}
+file that loads \Option{SN} first and then changes
+\PLength{toaddrhpos}\IndexPLength{toaddrhpos} (see
\autoref{sec:scrlttr2-experts.addressee},
-\DescPageRef{scrlttr2-experts.plength.toaddrvpos}) to a smaller
-value. Additionally, also reduce \PLength{toaddrwidth} accordingly.%
+\DescPageRef{scrlttr2-experts.plength.toaddrvpos}) to a smaller value. In
+addition, you should also reduce \PLength{toaddrwidth} accordingly.%
-By\textnote{Hint!} the way, the \File{DIN} \File{lco}-file will always be
-loaded as the first \File{lco} file. This ensures that all pseudo-lengths will
-have more or less reasonable default values. Because of this, it is not
-necessary to load this default file on your own.
+By\textnote{Hint!} the way, the \File{DIN} \File{lco} file is always loaded
+automatically as the first \File{lco} file. This ensures that all
+pseudo-lengths will have more or less reasonable default values. Therefore you
+do not need to load this default file on your own.
-Please\textnote{Attention!} note that it is not possible to use
-\Macro{PassOptionsToPackage} to pass options to packages from within an
-\File{lco}-file that have already been loaded by the class. Normally, this
-only applies to the \Package{typearea}, \Package{scrlfile}, \Package{scrbase},
-and \Package{keyval} packages.%
+%Please\textnote{Attention!} note that it is not possible to use
+%\Macro{PassOptionsToPackage} to pass options to packages from within an
+%\File{lco} file that have already been loaded by the class. Normally, this
+%only applies to the \Package{typearea}, \Package{scrlfile}, \Package{scrbase},
+%and \Package{keyval} packages.%
\begin{desclist}
\renewcommand*{\abovecaptionskipcorrection}{-\normalbaselineskip}%
\desccaption{%
- predefined \File{lco}-files\label{tab:lcoFiles}%
+ Predefined \File{lco} files\label{tab:lcoFiles}%
}{%
- predefined \File{lco}-files (\emph{continuation})%
+ Predefined \File{lco} files (\emph{continued})%
}%
\oentry{DIN}{%
- parameter set for letters on A4-size paper, complying with German standard
+ \leavevmode%
+ \IndexOption[indexmain]{DIN}\IndexFile[indexmain]{DIN.lco}%
+ parameters for letters on A4 paper, complying with German standard
DIN~676; suitable for window envelopes in the sizes C4, C5, C6, and C6/5
(C6 long).}%
\oentry{DINmtext}{%
- parameter set for letters on A4-size paper, complying with DIN~676, but
- using an alternate layout with more text on the first page; only suitable
- for window envelopes in the sizes C6 and C6/5 (C6 long).}%
+ \leavevmode%
+ \IndexOption[indexmain]{DINmtext}\IndexFile[indexmain]{DINmtext.lco}%
+ parameters for letters on A4 paper, complying with DIN~676 but using an
+ alternate layout with more text on the first page; only suitable for
+ window envelopes in the sizes C6 and C6/5 (C6 long).}%
\oentry{KakuLL}{%
- parameter set for Japanese letters in A4 format; suitable for Japanese
- window envelopes of type Kaku A4, in which the windows is approximately
- 90\Unit{mm} wide, 45\Unit{mm} high, and positioned 25\Unit{mm} from the
+ \leavevmode%
+ \IndexOption[indexmain]{KakuLL}\IndexFile[indexmain]{KakuLL.lco}%
+ parameters for Japanese letters on A4 paper; suitable for Japanese
+ window envelopes of type Kaku A4, in which the window is approximately
+ 90\Unit{mm} wide by 45\Unit{mm} high, and positioned 25\Unit{mm} from the
left and 24\Unit{mm} from the top edge (see \autoref{cha:japanlco}).}%
\oentry{KOMAold}{%
- parameter set for letters on A4-size paper using a layout close to the now
+ \leavevmode%
+ \IndexOption[indexmain]{KOMAold}\IndexFile[indexmain]{KOMAold.lco}%
+ parameters for letters on A4 paper using a layout close to that of the
obsolete \Class{scrlettr} letter class; suitable for window envelopes in
the sizes C4, C5, C6, and C6/5 (C6 long); some additional commands to
improve compatibility with obsolete \Class{scrlettr} commands are defined;
- \Class{scrlttr2} may behave slightly different when used with this
- \File{lco}-file than with the other \File{lco}-files.}%
+ \Class{scrlttr2} may behave slightly differently with this \File{lco} file
+ than with the other \File{lco} files.}%
\oentry{NF}{%
- parameter set for French letters, according to NF~Z~11-001; suitable for
- window envelopes of type DL (110\Unit{mm} to 220\Unit{mm}) with a window
- of about 20\Unit{mm} from right and bottom with width 45\Unit{mm} and
- height 100\Unit{mm}; this file was originally developed by Jean-Marie
- Pacquet, who provides an extended version and additional information on
+ \leavevmode%
+ \IndexOption[indexmain]{NF}\IndexFile[indexmain]{NF.lco}%
+ parameters for French letters, complying with NF~Z~11-001; suitable for
+ window envelopes of type DL (110\Unit{mm} by 220\Unit{mm}) with a window
+ 45\Unit{mm} wide by 100\Unit{mm} high placed about 20\Unit{mm} from the
+ lower right edge; this file was originally developed by Jean-Marie
+ Pacquet, who also provides LyX integration in addition to extensions at
\cite{www:NF.lco}.}%
\oentry{NipponEH}{%
- parameter set for Japanese letters in A4 format; suitable for Japanese
- window envelopes of types Chou or You 3 or 4, in which the windows is
- approximately 90\Unit{mm} wide, 55\Unit{mm} high, and positioned
+ \leavevmode%
+ \IndexOption[indexmain]{NipponEH}\IndexFile[indexmain]{NipponEH.lco}%
+ parameters for Japanese letters on A4 paper; suitable for Japanese
+ window envelopes of types Chou or You 3 or 4, in which the window is
+ approximately 90\Unit{mm} wide by 55\Unit{mm} high, and positioned
22\Unit{mm} from the left and 12\Unit{mm} from the top edge (see
\autoref{cha:japanlco}).}%
\oentry{NipponEL}{%
- parameter set for Japanese letters in A4 format; suitable for Japanese
- window envelopes of types Chou or You 3 or 4, in which the windows is
- approximately 90\Unit{mm} wide, 45\Unit{mm} high, and positioned
+ \leavevmode%
+ \IndexOption[indexmain]{NipponEL}\IndexFile[indexmain]{NipponEL.lco}%
+ parameters for Japanese letters on A4 paper; suitable for Japanese
+ window envelopes of types Chou or You 3 or 4, in which the window is
+ approximately 90\Unit{mm} wide by 45\Unit{mm} high, and positioned
22\Unit{mm} from the left and 12\Unit{mm} from the top edge (see
\autoref{cha:japanlco}).}%
\oentry{NipponLH}{%
- parameter set for Japanese letters in A4 format; suitable for Japanese
- window envelopes of types Chou or You 3 or 4, in which the windows is
- approximately 90\Unit{mm} wide, 55\Unit{mm} high, and positioned
+ \leavevmode%
+ \IndexOption[indexmain]{NipponLH}\IndexFile[indexmain]{NipponLH.lco}%
+ parameters for Japanese letters on A4 paper; suitable for Japanese
+ window envelopes of types Chou or You 3 or 4, in which the window is
+ approximately 90\Unit{mm} wide by 55\Unit{mm} high, and positioned
25\Unit{mm} from the left and 12\Unit{mm} from the top edge (see
\autoref{cha:japanlco}).}%
\oentry{NipponLL}{%
- parameter set for Japanese letters in A4 format; suitable for Japanese
- window envelopes of types Chou or You 3 or 4, in which the windows is
- approximately 90\Unit{mm} wide, 45\Unit{mm} high, and positioned
+ \leavevmode%
+ \IndexOption[indexmain]{NipponLL}\IndexFile[indexmain]{NipponLL.lco}%
+ parameters for Japanese letters on A4 paper; suitable for Japanese
+ window envelopes of types Chou or You 3 or 4, in which the window is
+ approximately 90\Unit{mm} wide by 45\Unit{mm} high, and positioned
25\Unit{mm} from the left and 12\Unit{mm} from the top edge (see
\autoref{cha:japanlco}).}%
\oentry{NipponRL}{%
- parameter set for Japanese letters in A4 format; suitable for Japanese
- window envelopes of types Chou or You 3 or 4, in which the windows is
- approximately 90\Unit{mm} wide, 45\Unit{mm} high, and positioned
+ \leavevmode%
+ \IndexOption[indexmain]{NipponRL}\IndexFile[indexmain]{NipponRL.lco}%
+ parameters for Japanese letters on A4 paper; suitable for Japanese
+ window envelopes of types Chou or You 3 or 4, in which the window is
+ approximately 90\Unit{mm} wide by 45\Unit{mm} high, and positioned
25\Unit{mm} from the left and 24\Unit{mm} from the top edge (see
\autoref{cha:japanlco}).}%
\oentry{SN}{%
- parameter set for Swiss letters with address field on the right side,
+ \leavevmode%
+ \IndexOption[indexmain]{SN}\IndexFile[indexmain]{SN.lco}%
+ parameters for Swiss letters with the address field on the right side,
according to SN~010\,130; suitable for Swiss window envelopes in the sizes
C4, C5, C6, and C6/5 (C6 long).}%
\oentry{SNleft}{%
- parameter set for Swiss letters with address field on the left side;
- suitable for Swiss window envelopes with window on the left side in the
- sizes C4, C5, C6, and C6/5 (C6 long).}%
+ \leavevmode%
+ \IndexOption[indexmain]{SNleft}\IndexFile[indexmain]{SNleft.lco}%
+ parameters for Swiss letters with the address field on the left side;
+ suitable for Swiss window envelopes with the window on the left side in
+ the sizes C4, C5, C6, and C6/5 (C6 long).}%
\oentry{UScommercial9}{%
- parameter set for US-American letters with paper size letter; suitable for
- US-American window envelopes of size \emph{commercial~No.\,9} with window
- width of 4\,1/2\Unit{in}, height of 1\,1/8\Unit{in}, and position of
- 7/8\Unit{in} from the left and 1/2\Unit{in} from the bottom, without
- sender's return address inside of the window; with folding it first at the
- puncher mark then at the top folder mark also legal paper may be used but
- would result in a page size warning}%
+ \leavevmode%
+ \IndexOption[indexmain]{UScommercial9}%
+ \IndexFile[indexmain]{UScommercial9.lco}%
+ parameters for US letters on American letter paper; suitable for
+ \emph{commercial~No.\,9} US window envelopes with a window 4\,1/2\Unit{in}
+ wide by 1\,1/8\Unit{in} high, positioned 7/8\Unit{in} from the left and
+ 1/2\Unit{in} from the bottom, without the return address inside the
+ window; when folded first at the middle mark then at the top fold mark,
+ legal paper can also be used but results in a paper-size warning}%
\oentry{UScommercial9DW}{%
- parameter set for US-American letters with paper size letter; suitable for
- US-American window envelopes of size \emph{commercial~No.\,9} with
- addressee's window width of 3\,5/8\Unit{in}, height of 1\,1/8\Unit{in},
- and position of 3/4\Unit{in} from the left and 1/2\Unit{in} from the
- bottom, and with a sender's window width of 3\,1/2\Unit{in}, height of
- 7/8\Unit{in}, and position of 5/16\Unit{in} from the left and
- 2\,1/2\Unit{in} from the bottom, but without a sender's return address at
- any of the windows; with folding it first at the puncher mark then at the
- top folder mark also legal paper may be used but would result in a page
- size warning}%
+ \leavevmode%
+ \IndexOption[indexmain]{UScommercial9DW}%
+ \IndexFile[indexmain]{UScommercial9DW.lco}%
+ parameters for US letters on American letter paper; suitable for
+ \emph{commercial~No.\,9} US window envelopes with an recipient-address
+ window 3\,5/8\Unit{in} wide by 1\,1/8\Unit{in} high, positioned
+ 3/4\Unit{in} from the left and 1/2\Unit{in} from the bottom, and with a
+ return-address window 3\,1/2\Unit{in} wide by 7/8\Unit{in} high,
+ positioned 5/16\Unit{in} from the left and 2\,1/2\Unit{in} from the
+ bottom; when folded first at the middle mark and then at the top fold
+ mark, legal paper can also be used but results in a paper-size warning}%
\end{desclist}
%
\EndIndexGroup
@@ -3020,182 +3211,183 @@ and \Package{keyval} packages.%
\EndIndexGroup
-\section{Address Files and Circular Letters}
+\section{Address Files and Form Letters}
\seclabel{addressFile}%
\BeginIndexGroup
\BeginIndex{}{address>file}%
-\BeginIndex{}{circular letters}%
-\index{serial letters|see circular letters}%
+\BeginIndex{}{form letters}%
+\index{serial letters|see form letters}%
+\index{circular letters|see form letters}%
-When people write circular letters one of the more odious tasks is the typing
-of many different addresses. The class \Class{scrlttr2}%
+One of the most annoying things about creating form letters is typing up
+the different addresses. \KOMAScript{} provides basic support for this task%
\iffalse% Umbruchkorrekturtext
-, as did its predecessor \Class{scrlettr} as well,%
+, as did its predecessor \Class{scrlettr}%
\fi%
-\ provides basic support for this task.%
+.%
\iffalse% Umbruchkorrekturtext
-\ Currently there are plans for much enhanced support.%
+\ Currently there are plans for greatly enhanced support.%
\fi
\begin{Declaration}
- \Macro{adrentry}\Parameter{last-name}\Parameter{first-name}%
+ \Macro{adrentry}\Parameter{last~name}\Parameter{first~name}%
\Parameter{address}\Parameter{phone}\Parameter{F1}\Parameter{F2}%
\Parameter{comment}\Parameter{key}
\end{Declaration}%
-The class \Class{scrlttr2} supports the use of address files which
-contain address entries, very useful for circular letters. The file
-extension of the address file has to be \File{.adr}. Each entry is an
-\Macro{adrentry} command with eight parameters, for example:
+\Class{scrlttr2} and \Package{scrletter} can evaluate address files.
+This can be very useful for form letters. An address file must have the
+extension \File{.adr} and consists of a number \Macro{adrentry} entries.
+An individual entry consists of eight parameters and may look, for example,
+like this:
\begin{lstcode}
\adrentry{McEnvy}
{Flann}
- {Main Street 1\\ Glasgow}
- {123 4567}
- {male}
+ {1 High Street\\ Glasgow}
+ {0141 123 4567}
+ {builder}
{}
- {niggard}
+ {buys everything}
{FLANN}
\end{lstcode}
-The 5\textsuperscript{th} and 6\textsuperscript{th} elements, \PValue{F1} and
-\PValue{F2}, can be used freely: for example, for the gender, the academic
-grade, the birthday, or the date on which the person joined a society. The
-last parameter \PName{key} should only consist of more than one uppercase
-letters in order to not interfere with existing {\TeX} or {\LaTeX} commands.
+You can use the fifth and sixth elements, \PValue{F1} and \PValue{F2}, for
+anything you want. Gender, academic grade, birth date, or the date the person
+joined a society are all possibilities. The last parameter, \PName{key},
+should consist of more than one letter and be upper-case only so as not to
+interfere with existing \TeX{} or \LaTeX{} commands.
\begin{Example}
- Mr McEnvy is one of your most important business partners, but
- every day you receive correspondence from him. Before long you do
- not want to bother typing his boring address again and again. Here
- \Class{scrlttr2} can help. Assume that all your business partners
- have an entry in your \File{partners.adr} address file. If you now
- have to reply to Mr~McEnvy again, then you can save typing as
- follows:
+ Mr McEnvy is one of your most important business partners. Since you
+ maintain a frequent correspondence with him, it is too tedious to
+ enter all his data again and again. \KOMAScript{} will do this work for you.
+ For example, if you have saved your customer contacts in the
+ \File{partners.adr} address file and you would like to write a letter to
+ Mr~McEnvy, you can save a great deal of effort by typing:
\begin{lstcode}
\input{partners.adr}
\begin{letter}{\FLANN}
Your correspondence of today \dots
\end{letter}
\end{lstcode}
- Your {\TeX} system must be configured to have access to your address
- file. Without access, the \Macro{input} command results in an
- error. You can either put your address file in the same directory
- where you are running {\LaTeX}, or configure your system to find the
- file in a special directory.
+ Please make sure that your {\TeX} system can access your address file.
+ Otherwise the \Macro{input} command results in an error message. You can
+ either put your address file in the same directory as your letter or
+ configure your \TeX{} system to look for a dedicated address directory.
\end{Example}
%
\EndIndexGroup
+
\begin{Declaration}
\Macro{addrentry}\Parameter{last-name}\Parameter{first-name}%
\Parameter{address}\Parameter{phone}\Parameter{F1}\Parameter{F2}%
\Parameter{F3}\Parameter{F4}\Parameter{key}
\end{Declaration}%
-Over the years people have objected that the \DescRef{\LabelBase.cmd.adrentry} has only two
-free parameters. To cater to this demand, there now exists a new command
-called \Macro{addrentry}\,---\,note the additional ``d''\,---\,which supports
-four freely-definable parameters. Since {\TeX} supports maximally nine
-parameters per command, the comment parameter has fallen away. Other than this
-difference, the use is the same as that of \DescRef{\LabelBase.cmd.adrentry}.
-
-Both \DescRef{\LabelBase.cmd.adrentry} and \Macro{addrentry} commands can be freely mixed in
-the \File{adr} files. However, it should be noted that there are some packages
-which are not suited to the use of \Macro{addrentry}. For example, the
-\Package{adrconv} by Axel Kielhorn can be used to create address lists from
-\File{adr} files, but it has currently no support for command
-\Macro{addrentry}. In this case, the only choice is to extend the package
-yourself.%
+Before you object that a total of two free parameters is too few,
+\KOMAScript{} alternatively offers the \Macro{addrentry} command\,---\,note
+the additional ``d''\,---\,which adds two more freely definable parameters but
+omits the comment parameter. Otherwise, you can use this command in exactly
+the same way as \DescRef{\LabelBase.cmd.adrentry}.
+
+Both \DescRef{\LabelBase.cmd.adrentry} and \Macro{addrentry} commands can be
+freely mixed in the \File{adr} files. I should note, however, that other
+packages, such as \Package{adrconv}\IndexPackage{adrconv} by Axel Kielhorn,
+may not be designed to use \Macro{addrentry}. If necessary, you have to create
+the appropriate extensions yourself.%
%
\EndIndexGroup
-Besides the simple access to addresses, the address files can be
-easily used in order to write circular letters. Thus, there is no
-requirement to access a complicated database system via {\TeX}.
+In addition to simplifying access to addresses, you can also use the
+\File{adr} files to create circulars or form letters. Thus you can create such
+mass mailings without a complicated connection to a database system.
%
\begin{Example}
- Suppose you are member of a society and want write an invitation for
- the next general meeting to all members.
+ You want to sent a form letter to all members of your fishing club to invite
+ them to the next general meeting.
\begin{lstcode}
\documentclass{scrlttr2}
\begin{document}
\renewcommand*{\adrentry}[8]{
\begin{letter}{#2 #1\\#3}
- \opening{Dear members,} Our next general meeting will be on
- Monday, August 12, 2002. The following topics are \dots
+ \opening{Dear members,}
+ Our next general meeting will be on
+ Monday, 12 August 2002.
+
+ The following topics are \dots
\closing{Regards,}
\end{letter}
}
\input{members.adr}
\end{document}
\end{lstcode}
- If the address file contains \DescRef{\LabelBase.cmd.addrentry} commands too, than an
- additional definition for \DescRef{\LabelBase.cmd.addrentry} is required before loading
- the address file:
+ If the address file also contains \DescRef{\LabelBase.cmd.addrentry}
+ commands, you must add a corresponding definition before loading the address
+ file:
\begin{lstcode}
\renewcommand*{\addrentry}[9]{%
\adrentry{#1}{#2}{#3}{#4}{#5}{#6}{#7}{#9}%
}
\end{lstcode}
- In this simple example the extra freely-definable parameter is not
- used, and therefore \DescRef{\LabelBase.cmd.addrentry} is defined with the help of
+ In this example, the extra freely-definable parameter is not used, and
+ therefore \DescRef{\LabelBase.cmd.addrentry} is defined using
\DescRef{\LabelBase.cmd.adrentry}.
\end{Example}
-With some additional programming one can let the content of the
-letters depend on the address data. For this the free parameters of
-the \DescRef{\LabelBase.cmd.adrentry} and and \DescRef{\LabelBase.cmd.addrentry} commands can be used.
-
+Of course, the letter's contents can also be adapted to the characteristics of
+the address data. You can use the free parameters of the
+\DescRef{\LabelBase.cmd.adrentry} and \DescRef{\LabelBase.cmd.addrentry}
+commands for this.
\begin{Example}
- Suppose the 5\textsuperscript{th} parameter of the \DescRef{\LabelBase.cmd.adrentry}
- command contains the gender of a member (\PValue{m/f}), and the
- 6\textsuperscript{th} parameter contains what amount of subscription
- has not yet been paid by the member. If you would like to write a
- more personal reminder to each such member, then the next example
- can help you:
+ Suppose you use the fifth parameter of the \DescRef{\LabelBase.cmd.adrentry}
+ command to indicate the gender of a club member (\PValue{m/f}), and the
+ sixth parameter to indicate the amount of membership dues that is unpaid.
+ If you would like to write a reminder to each such member and address them
+ personally, the next example will help you:
\begin{lstcode}
\renewcommand*{\adrentry}[8]{
\ifdim #6pt>0pt\relax
- % #6 is an amount greater than 0.
- % Thus, this selects all members with due subscription.
+ % #6 is an amount (floating-point number) greater than 0.
+ % Thus, this selects all members owing dues.
\begin{letter}{#2 #1\\#3}
- \if #5m \opening{Dear Mr.\,#2,} \fi
- \if #5f \opening{Dear Mrs.\,#2,} \fi
+ \if #5m \opening{Dear Mr #2,} \fi
+ \if #5f \opening{Dear Ms #2,} \fi
- Unfortunately we have to remind you that you have
- still not paid the member subscription for this
- year.
+ Unfortunately, we have noticed that you are in arrears
+ with the payment of your membership fees.
- Please remit EUR #6 to the account of the society.
+ Please remit the outstanding balance of \pounds #6 to the club
+ account.
\closing{Regards,}
\end{letter}
\fi
}
\end{lstcode}
\end{Example}
-As you can see, the letter text can be made more personal by depending on
-attributes of the letter's addressee. The number of attributes is only
-restricted by number of two free parameters of the \DescRef{\LabelBase.cmd.adrentry} command,
-or four free parameters of the \DescRef{\LabelBase.cmd.addrentry} command.
+It is therefore possible to tailor the text of the letter to the specific
+characteristics of the recipient and create the impression of a personal
+letter. The extent of the customisation is only limited by the maximum number
+of two free \DescRef{\LabelBase.cmd.adrentry} parameters and four free
+\DescRef{\LabelBase.cmd.addrentry} parameters.
\begin{Declaration}
\Macro{adrchar}\Parameter{initial letter}%
\Macro{addrchar}\Parameter{initial letter}
\end{Declaration}
-\Index[indexmain]{address>list}\Index[indexmain]{telephone list}%
-As already mentioned above, it is possible to create address and telephone
-lists using \File{adr} files. For that, the additional package
-\Package{adrconv} by Axel Kielhorn (see \cite{package:adrconv}) is needed.
-This package contains interactive {\LaTeX} documents which help to create
-those lists.
-
-The address files have to be sorted already in order to obtain sorted
-lists. It is recommended to separate the sorted entries at each different
-initial letter of \PName{last name}. As a separator, the commands
-\Macro{adrchar} and \Macro{addrchar} can be used. These commands will be
-ignored if the address files are utilized in \Class{scrlettr2}.
+\Index[indexmain]{address>list}\Index[indexmain]{telephone directory}%
+It is possible to create address lists and telephone directories using
+\File{adr} files. You also need the \Package{adrconv}\IndexPackage{adrconv}
+package by Axel Kielhorn (see \cite{package:adrconv}). This package contains
+interactive \LaTeX{} documents which make it easy to create such lists.
+
+The address files have to be sorted already in order to obtain sorted lists.
+It is advisable to insert an \Macro{adrchar} or \Macro{addrchar} command
+containing the initial letter of the \PName{last name} before the point in the
+list where this letter changes. \Class{scrlettr2} and \Package{scrletter} will
+ignore these commands.
%
\begin{Example}
- Suppose you have the following short address file:
+ Suppose you have the following, rather tiny address file from which you
+ want to create an address book:
\begin{lstlisting}
\adrchar{A}
\adrentry{Angel}{Gabriel}
@@ -3210,9 +3402,16 @@ ignored if the address files are utilized in \Class{scrlettr2}.
{+49~62\,03~1\,??\,??}{}{}{no angel at all}
{KOMA}
\end{lstlisting}
- This address file can be treated with \File{adrdir.tex} of the
- \Package{adrconv} package~\cite{package:adrconv}.
- The result should look like this:
+ You can now process these entries using the \File{adrdir.tex} document from
+ \cite{package:adrconv}. One potential problem with this is that
+ \File{adrdir.tex} up to and including Version~1.3 uses both the obsolete
+ \Package{scrpage} package and obsolete font commands which \KOMAScript{} has
+ not supported for some time. If you receive an error message and cannot
+ install a newer version, you can find a listing of \File{adrdir.tex} which
+ indicates the changes necessary to avoid these errors at
+ \cite{https://komascript.de/node/2154} (in German).
+
+ The result looks something like this:
\begin{center}
\setlength{\unitlength}{1mm}
\begin{picture}(80,57)
@@ -3237,15 +3436,15 @@ ignored if the address files are utilized in \Class{scrlettr2}.
\qbezier(0,3)(10,6)(40,3)\qbezier(40,3)(60,0)(80,3)
\end{picture}
\end{center}
- The letter in the page header is created by the \Macro{adrchar}
- command. The definition can be found in \File{adrdir.tex}.
+ The letter in the header is generated by answering ``no'' to the
+ question ``Names in the header?'' See explanation in \File{adrdir.tex}.
\end{Example}
-More about the \Package{adrconv} package can be found in its
-documentation. There you should also find information about whether the
+You can find more about the \Package{adrconv}\IndexPackage{adrconv} package in
+its documentation. There you should also find information about whether the
current version of \Package{adrconv} supports the
-\DescRef{\LabelBase.cmd.addrentry} and \Macro{addrchar} commands. Former
-versions only know the commands \DescRef{\LabelBase.cmd.adrentry} and
-\Macro{adrchar}.%
+\DescRef{\LabelBase.cmd.addrentry} and \Macro{addrchar} commands. Previous
+versions only recognised the \DescRef{\LabelBase.cmd.adrentry} and
+\Macro{adrchar} commands.%
%
\EndIndexGroup
%
@@ -3253,6 +3452,7 @@ versions only know the commands \DescRef{\LabelBase.cmd.adrentry} and
%
\EndIndexGroup
+\endinput
%%% Local Variables:
%%% mode: latex
@@ -3261,6 +3461,3 @@ versions only know the commands \DescRef{\LabelBase.cmd.adrentry} and
%%% ispell-local-dictionary: "en_GB"
%%% TeX-master: "../guide"
%%% End:
-
-% LocalWords: scrlttr simpleSwitchValues afteropening beforeopening Combinable
-% LocalWords: locfield Hennig Kohm Foldmarks
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2examples.dtx b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2examples.dtx
index acfbde56775..18286886b38 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2examples.dtx
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2examples.dtx
@@ -2,7 +2,7 @@
% \iffalse
% ======================================================================
% scrlttr2examples.dtx
-% Copyright (c) Markus Kohm, 2008-2013
+% Copyright (c) Markus Kohm, 2008-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -20,7 +20,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlttr2examples.dtx
-% Copyright (c) Markus Kohm, 2008-2013
+% Copyright (c) Markus Kohm, 2008-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -101,13 +101,13 @@
% \begin{macrocode}
%<*lco&23>
\ProvidesFile{ich.lco}[2008/06/11 lco
-%<english> (John Public)]
+%<english> (Joe Public)]
%<ngerman> (Peter Musterfrau)]
\KOMAoptions{foldmarks=true,foldmarks=blmtP,
fromphone,fromemail,fromlogo,subject=titled}
%<*english>
-\setkomavar{fromname}{John Public}
-\setkomavar{signature}{John Public\\
+\setkomavar{fromname}{Joe Public}
+\setkomavar{signature}{Joe Public\\
(former chairman)}
%</english>
%<*ngerman>
@@ -117,15 +117,16 @@
%</ngerman>
\renewcommand*{\raggedsignature}{\raggedright}
%<*english>
-\setkomavar{fromaddress}{Valley 2\\
- 54321 Public-Village}
+\setkomavar{fromaddress}{2 Valley\\
+ SAMPLEBY\\
+ ZY32 1XW}
%</english>
%<*ngerman>
\setkomavar{fromaddress}{Hinter dem Tal 2\\
54321 Musterheim}
%</ngerman>
\setkomavar{fromphone}{0\,12\,34~56\,78}
-%<english>\setkomavar{fromemail}{Peter@Public.invalid}
+%<english>\setkomavar{fromemail}{joe@public.invalid}
%<ngerman>\setkomavar{fromemail}{Peter@Musterfrau.invalid}
\setkomavar{fromlogo}{%
\includegraphics{musterlogo}}
@@ -134,7 +135,7 @@
Club member no.~4711\\
since 11.09.2001\\
chairman 2003--2005}
-\setkomavar{place}{Public-Village}
+\setkomavar{place}{Sampleby}
\setkomavar{frombank}{Bank of Friendly Greetings}
%</english>
%<*ngerman>
@@ -192,15 +193,15 @@
%<nipponB>\LoadLetterOption{NipponEL}
%<label>\documentclass[version=last,ich,settleford600label]{scrlttr2}
%<ngerman>\usepackage[ngerman]{babel}
-%<english>\usepackage[english]{babel}
+%<english>\usepackage[british]{babel}
%<16|17|18|19|20|21|22|23|label>\usepackage{graphics}
\begin{document}
%<*!0&!1&!2&!3&!4&!5&!6&!7&!23&!label>
-%<english>\setkomavar{fromname}{John Public}
+%<english>\setkomavar{fromname}{Joe Public}
%<ngerman>\setkomavar{fromname}{Peter Musterfrau}
%<*22>
%<*english>
-\setkomavar{signature}{John Public\\
+\setkomavar{signature}{Joe Public\\
(former chairman)}
%</english>
%<*ngerman>
@@ -210,8 +211,9 @@
\renewcommand*{\raggedsignature}{\raggedright}
%</22>
%<*english>
-\setkomavar{fromaddress}{Valley 2\\
- 54321 Public-Village}
+\setkomavar{fromaddress}{2 Valley\\
+ SAMPLEBY\\
+ ZY32 1XW}
%</english>
%<*ngerman>
\setkomavar{fromaddress}{Hinter dem Tal 2\\
@@ -219,7 +221,7 @@
%</ngerman>
%<*!9&!10&!11>
\setkomavar{fromphone}{0\,12\,34~56\,78}
-%<english>\setkomavar{fromemail}{Peter@Public.invalid}
+%<english>\setkomavar{fromemail}{joe@public.invalid}
%<ngerman>\setkomavar{fromemail}{Peter@Musterfrau.invalid}
%<*!12&!13&!14&!15>
\setkomavar{fromlogo}{\includegraphics{musterlogo}}
@@ -230,7 +232,7 @@
%<*!23&!label&!nipponA&!nipponB>
\setkomavar{location}{\raggedright
%<*english>
- Club nember no.~4711\\
+ Club member no.~4711\\
since 11.09.2001\\
chairman 2003--2005}
%</english>
@@ -244,7 +246,7 @@
%<english>\setkomavar{date}{29th February 2011}
%<ngerman>\setkomavar{date}{29. Februar 2011}
%<*!23&!label>
-%<english>\setkomavar{place}{Public-Village}
+%<english>\setkomavar{place}{Sampleby}
%<ngerman>\setkomavar{place}{Musterheim}
%</!23&!label>
%<*21|22|23|label>
@@ -256,9 +258,10 @@
%<!5>\begin{letter}{%
%<5>\begin{letter}[fontsize=14pt]{%
%<*english>
- Joana Public\\
- Hillside 1\\
- 12345 Public-City%
+ Joanna Public\\
+ 1 Hillside\\
+ SAMPLESTEAD\\
+ WX12 3YZ%
%</english>
%<*ngerman>
Petra Mustermann\\
@@ -267,29 +270,28 @@
%</ngerman>
}
%<label>\savelabel{3}{2}
-%<english>\opening{Dear chairman,}
+%<english>\opening{Dear Madam Chair,}
%<ngerman>\opening{Liebe Vereinsvorsitzende,}
%<*!0>
%<*english>
-the last general meeting was about one year ago.
-I want to remind you, that the constitution of our
-club advises you to make a general meeting every
-six month. Because of this I expect the executive
-board to detain such a meeting immediately.
-\closing{Expecting an invitation}
+The last general meeting was more than a year ago.
+I would like to remind you that the articles of our
+club stipulate that one should be held every
+six months. For this reason, I call on the executive
+board to arrange such a meeting immediately.
+\closing{Anticipating an invitation}
%</english>
%<*ngerman>
seit einem Jahr gab es keine Mitgliederversammlung
mehr. Ich erinnere daran, dass unsere Satzung eine
-solche alle halbe Jahr vorsieht. Ich fordere den
+solche jedes halbe Jahr vorsieht. Ich fordere den
Vorstand daher auf, umgehend eine solche in
Angriff zu nehmen.
\closing{In Erwartung einer Einladung}
%</ngerman>
%<*!1>
%<*english>
-\ps PS: I hope you accept this as an friendly
- demand note.
+\ps PS: I hope you do not take this request amiss.
%</english>
%<*ngerman>
\ps PS: Ich hoffe, Du nimmst mir das nicht krumm.
@@ -298,8 +300,8 @@ Angriff zu nehmen.
%<*!3>
%<*english>
\setkomavar*{enclseparator}{Enclosure}
-\encl{Compendium of the constitution with the
- general meeting paragraphs.}
+\encl{Excerpt from the articles governing general
+ meetings}
%</english>
%<*ngerman>
\setkomavar*{enclseparator}{Anlage}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrwfile.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrwfile.tex
index 56b8569d7bf..78253e34e09 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrwfile.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrwfile.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrwfile.tex
-% Copyright (c) Markus Kohm, 2010-2017
+% Copyright (c) Markus Kohm, 2010-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrwfile.tex
-% Copyright (c) Markus Kohm, 2010-2017
+% Copyright (c) Markus Kohm, 2010-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,177 +46,190 @@
% ============================================================================
\KOMAProvidesFile{scrwfile.tex}%
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-27 11:46:14 +0200 (Tue, 27 Mar 2018) $
KOMA-Script guide (chapter: scrwfile)]
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-02-15
-\translator{Markus Kohm\and Jana Schubert}
+\translator{Markus Kohm\and Jana Schubert\and Karl Hagen}
-\chapter[{Economise and Replace Files Using \Package{scrwfile}}]
-{Economise and Replace Files Using \Package{scrwfile}%
-}
+\chapter{Economising and Replacing Files with \Package{scrwfile}}
\labelbase{scrwfile}
\BeginIndexGroup
\BeginIndex{Package}{scrwfile}
-\TeX{} supports 18 write handles only. Handle 0 is used by \TeX{} itself (log
-file). \LaTeX{} needs at least handle 1 for \Macro{@mainaux}, handle 2 for
-\Macro{@partaux}, one handle for \Macro{tableofcontents}, one handle for
-\Macro{listoffigures}, one handle for \Macro{listoftables}, one handle for
-\Macro{makeindex}. So there are 11 left. Seams a lot and enough. But every new
-type of float, every new index and several other packages, e.g.,
-\Package{hyperref} need write handles, too.
-
-The bottom line is, that this eventually will result in the error message:
+One of the problems not solved by the introduction of \eTeX{} is the fact that
+\TeX{} can support only 18 open write handles. This number seems quite large
+at first, but many of these handles are already reserved. \TeX{} itself uses
+handle 0 for the log file. \LaTeX{} needs handle 1 for \Macro{@mainaux},
+handle 2 for \Macro{@partaux}, one handle for \Macro{tableofcontents}, one
+handle for \Macro{listoffigures}, one handle for \Macro{listoftables}, and one
+handle for \Macro{makeindex}. Every other such list generates another handle,
+and packages like \Package{hyperref} or \Package{minitoc} require write
+handles too.
+
+The bottom line is that eventually you may get the following error message:
\begin{lstcode}
! No room for a new \write .
\ch@ck ...\else \errmessage {No room for a new #3}
\fi
\end{lstcode}
-There is an additional disadvantage of immediately opening a new write handle
-for every table of contents, list of figures, list of tables etc. These are
-not only set by the corresponding commands, they also could not be set once
-more, because their helper files are empty after the corresponding commands
-until the end of the document.
-
-Package \Package{scrwfile} provides an amendment of the \LaTeX{} kernel,
-that solves both problems.
-
-\section{General Modifications of the \LaTeX{} Kernel}
+For some time, the simplest solution to this problem has been to use
+\mbox{Lua\LaTeX} instead of \mbox{pdf\LaTeX} or \XeLaTeX. This eliminates the
+restriction, and the maximum number of files you can have open for writing is
+then limited only by the operating system. In reality, you usually so not need
+to worry about it any more.
+
+The fact that \LaTeX{} always opens a new file for writing every table of
+contents, list of figures, list of tables, etc. has another disadvantage. Such
+lists are not only output by their respective commands, they also could not be
+output a second time because the associated auxiliary file\footnote{The term
+ \emph{auxiliary file} here refers not to the main \File{aux} file but to the
+ other internal files used indirectly via the \File{aux} file, e.\,g. the
+ \File{toc} file, the \File{lof} file, or the \File{lot} file.} is empty
+after the respective command until the end of the document.
+
+The \Package{scrwfile} package makes a fundamental change to the \LaTeX{}
+kernel, which can solve both problems not only for \mbox{Lua\LaTeX} but also
+for \mbox{pdf\LaTeX} or \XeLaTeX.
+
+\section{Fundamental Changes to the \LaTeX{} Kernel}
\seclabel{kernelpatches}
-To allocate a new file handle eg. for \Macro{listoffigures} or
-\Macro{listoftables} \LaTeX{} classes use the \LaTeX{} kernel command
-\Macro{@starttoc}\IndexCmd{@starttoc}. This command not only inputs the
-associated helper file but also allocates a new write handle for the
-associated helper file and opens it for writing. Nevertheless, if afterwards
-new entries to these lists of floats are added using \Macro{addcontentsline},
-then these file handles are not used immediately, instead \LaTeX{} writes
-\Macro{@writefile}\IndexCmd{@writefile} commands into the
-\File{aux}-file. Only while reading the \File{aux}-file while the end of the
-document, those \Macro{@writefile} commands become real write operations
-on the helper files. Additionally \LaTeX{} does not close the helper files
-explicitly. Instead \LaTeX{} relies on \TeX{} to close all open files at
-the end.
-
-Thus all the helper files are open throughout the entire process. However the
-content is written at \Macro{end}\PParameter{document}. The basic idea of
-\Package{scrwfile} is tackling this contradiction by redefining
+\LaTeX{} classes use the \LaTeX{} kernel command
+\Macro{@starttoc}\IndexCmd{@starttoc} to allocate a new file handle, such as
+for \Macro{tableofcontents} or \Macro{listoffigures}. This command not only
+loads the associated auxiliary file but also reopens it for writing. If
+entries to these lists are added using \Macro{addcontentsline}, however, the
+system does not write directly to these auxiliary files. Instead, \LaTeX{}
+writes \Macro{@writefile}\IndexCmd{@writefile} commands to the \File{aux}
+file. Only while reading the \File{aux} file at the end of the document do
+those \Macro{@writefile} commands become actual write operations in the
+auxiliary files. Additionally, \LaTeX{} does not close the auxiliary files
+explicitly. Instead it relies on \TeX{} to close all open files at the end.
+
+This procedure ensures that the auxiliary files are only written to within
+\Macro{end}\PParameter{document}, but they remain open throughout the entire
+\LaTeX{} run. \Package{scrwfile} takes is starting point here, by redefining
\Macro{@starttoc} and \Macro{@writefile}.
-Surely\textnote{Attention!}, changes of the \LaTeX{} kernel may
-result in incompatibilities with other packages. In case of
-\Package{scrwfile}, clashes my arise with all packages also redefining
-\Macro{@starttoc} or \Macro{@writefile}. Sometimes changing the order of
-loading the packages may help.
-
-However, only few such problems have been reported eventhough several users
-have tested the package for one year before its first release. See
-\autoref{sec:scrwfile.incompatible} for more information about known
-incompatibilities. If you find such a problem, please contact the
+Of course\textnote{Attention!} changes to the \LaTeX{} kernel always have the
+potential to cause incompatibilities with other packages. Those primarily
+affected may be those which also redefine \Macro{@starttoc} or
+\Macro{@writefile}. In some cases, it may help to change the order the
+packages are loaded. If you encounter such a problem, please contact the
\KOMAScript{} author.
-\section{The Single File Feature}
+\section{The Single-File Method}
\seclabel{singlefilefeature}
-At the point the package is loaded using, e.\,g.,
+As soon as the package is loaded with
\begin{lstcode}
\usepackage{scrwfile}
\end{lstcode}
-\Package{scrwfile} will redefine \Macro{@starttoc}\IndexCmd{@starttoc} to not
-longer allocate a write handle or open any file for writing. Immediately before
-closing the \File{aux}-file in \Macro{end}\PParameter{document} it will
-redefine \Macro{@writefile} to no longer write into the usual helper files
-but into one single new file with file extension \File{wrt}. After
-reading the \File{aux}-file this \File{wrt}-file will be processed once per
-helper file. This means, that not all of the helper file have to be open at
-the same time, but only one at a time. And this single file will be closed
-afterwards and the write handle is not longer needed after it is closed. An
-internal write handle of \LaTeX{} is used for this. So \Package{scrwfile}
-doesn't need any own write handle.
-
-Because of this, even if only one table of contents should be generated,
-loading \Package{scrwfile} gives one extra write file handle,
-e.\,g., for bibliographies, indexes, glossaries and similar, that are not
-using \Macro{@starttoc}. Additionally the number of tables of contents and
-lists of whatever, that use \Macro{@starttoc}\IndexCmd{@starttoc} is not
-limited any longer.
-
-\section{The Clone File Write Feature}
+\Package{scrwfile} redefines \Macro{@starttoc}\IndexCmd{@starttoc} so that it
+no longer allocates a write handle or opens a file for writing.
+\Macro{@writefile} is redefined so that immediately before closing the
+\File{aux} file in \Macro{end}\PParameter{document}, it writes not to the
+usual auxiliary files but to a single new file with extension \File{wrt}.
+After reading the \File{aux} file, this \File{wrt} file will be processed once
+for each of the auxiliary files that \Macro{@writefile} writes information to.
+However these auxiliary files do not all have to be open at the same time.
+Instead, only one is open at a time and is explicitly closed afterwards. Since
+\LaTeX{} reuses an internal write file, \Package{scrwfile} doesn't need its
+own write handle for this type of table of contents or list of floating
+environments.
+
+Because of this behaviour, even if you have only one table of contents, once
+you load \Package{scrwfile} you will have access to a write file handle for
+bibliographies, indexes, glossaries, and similar lists that do not use
+\Macro{@starttoc}. Additionally, you can create any number of tables of
+contents and other lists that use \Macro{@starttoc}\IndexCmd{@starttoc}.
+
+\section{The File Cloning Method}
\seclabel{clonefilefeature}
-Sometimes it is useful to input a file not only once but several times. As
-\Macro{@starttoc} does not open files for writing any more, this can be done
-by simply using \Macro{@starttoc} several times with the same extension. But
-sometimes you may have additional entries in only some of the content
-directories. \Package{scrwfile} allows to copy all entries of a file to
-another file, too. We call this cloning.
+Since \Macro{@writefile}\IndexCmd{@writefile} has already been modified for
+the single-file method described in the previous system so that it no longer
+writes directly to the corresponding auxiliary file, a further possibility
+suggests itself. When copying the \Macro{@writefile} statements into the
+\File{wrt} file, you can also copy them to other destinations.
\begin{Declaration}
\Macro{TOCclone}%
- \OParameter{heading}\Parameter{source}\Parameter{destination}
+ \OParameter{list heading}\Parameter{source extension}%
+ \Parameter{destination extension}
\end{Declaration}
-activates the clone feature for files with extensions \PName{source} and
-\PName{destination}. All entries to the file
-\Macro{jobname}\File{.}\PName{source} will be added to
-\Macro{jobname}\File{.}\PName{destination}.
-
-If extension \PName{destination} is a new one, \PName{destination} will be
-added to the list of known extensions using the \KOMAScript{} package
-\Package{tocbasic}.
-
-If the optional argument \PName{heading} is given, a new list-of macro
-\Macro{listof}\PName{destination} is defined. \PName{heading} will be used
-as section (or chapter) heading of this list. In this case several
-\Package{tocbasic} features of the \PName{source} will be copied to
-\PName{destination}, if and only if they have been set up when
-\Macro{TOCclone} was used. Feature \PName{nobabel} will always be set,
-because the language selection commands are part of the helper file and
-would be cloned, anyway.
+This cloning of file entries copies entire tables of contents or other lists.
+For this, you only need to specify the extension of the auxiliary file whose
+entries should be copied and the extension of a destination file. The entries
+are then copied there. Of course, you can also write additional entries to
+this cloned file.
+
+You can manage the \PName{destination extention} using
+\hyperref[cha:tocbasic]{\Package{tocbasic}}%
+\important{\hyperref[cha:tocbasic]{\Package{tocbasic}}} (see
+\autoref{cha:tocbasic}). If such a file is already under the control of
+\hyperref[cha:tocbasic]{\Package{tocbasic}}, a warning will be issued.
+Otherwise, a new list for this extension will be created using
+\hyperref[cha:tocbasic]{\Package{tocbasic}}. You can set the heading for this
+list with the optional argument \PName{list heading}.
+
+You can then output this new content list, for example, with the command
+\Macro{listof\PName{destination extension}}. The content-list
+attributes\important{\hyperref[cha:tocbasic]{\Package{tocbasic}}}
+\PValue{leveldown}, \PValue{numbered}, \PValue{onecolumn}, and \PValue{totoc}
+(see \DescRef{tocbasic.cmd.setuptoc} in \autoref{sec:tocbasic.toc},
+\DescPageRef{tocbasic.cmd.setuptoc}) are automatically copied to the
+destination list if they were already set in the source list. The
+\PValue{nobabel} attribute is always set for cloned content lists, because the
+language-selection commands in the source content list are already copied
+anyway.
\begin{Example}
-Assumed, you want a short table of contents
-with only the chapter level but an additional entry with the table of
-contents:
+ Suppose you want a short table of contents with only the chapter level in
+ addition to the normal the table of contents:
\begin{lstcode}
\usepackage{scrwfile}
- \TOCclone[Short \contentsname]{toc}{stoc}
+ \TOCclone[Summary Contents]{toc}{stoc}
\end{lstcode}
-This would create a new table of contents with the heading ``Short
-Contents''. The new table of contents uses a helper file with extension
-\File{stoc}. All entries to the helper file with extension \File{toc} will
-also be copied to this new helper file.
+ This creates a new table of contents with the heading ``Summary Contents''.
+ The new table of contents uses an auxiliary file with the extension
+ \File{stoc}. All entries to the auxiliary file with extension \File{toc}
+ will also be copied to this new auxiliary file.
-The new short table of contents should only have the chapter entries. This may
-be done using:
+ In order to have the new short table of contents display only the chapter
+ entries, we use:
\begin{lstcode}
\addtocontents{stoc}{\protect\value{tocdepth}=0}
\end{lstcode}
-Normally you cannot write into a helper file before
-\Macro{begin}\PParameter{document}. But using \Package{scrwfile} changes
-this. So the code above is correct already after loading \Package{scrwfile}.
-
-To show the new short contents of helper file extension \File{stoc} we
-use
+ Although\textnote{Attention!} normally you cannot write to an auxiliary file
+ before \Macro{begin}\PParameter{document}, the code above works in the
+ preamble after loading \Package{scrwfile}. Owing to the unconventional way
+ of changing the \DescRef{maincls.counter.tocdepth} counter within the TOC
+ file, this change only applies to this content list.
+
+ Later in the document, we then output the content list with the file
+ extension \File{stoc} with:
\begin{lstcode}[moretexcs={listofsttoc}]
\listofstoc
\end{lstcode}
-somewhere after \Macro{begin}\PParameter{document}.
+ and this shows only the parts and chapters of the document.
-If we also want an entry for the table of contents at the short contents, we
-cannot use
+ Things become a bit more difficult if the summary contents are to be
+ listed in the table of contents. This would seem to be possible with
\begin{lstcode}
- \addtocontents{toc}{% write to the Contents
- \protect\addcontentslinedefault{stoc}% write to Short Contents
- {chapter}% a chapter entry with
- {\contentsname}% the Contents' name
+ \addtocontents{toc}{%
+ \protect\addxcontentsline
+ {stoc}{chapter}{\protect\contentsname}%
}
\end{lstcode}
-because the \Macro{addcontentsline} command would be copied to \File{stoc}
-too. So we cannot add the command to the \File{toc}-file. Package
-\Package{tocbasic}\important{\Package{tocbasic}} may be used to solve this:
+However, since all entries in \File{toc} are also copied to \File{stoc}, this
+entry would also be copied from the summary contents. So we cannot generate
+the entry from the content list. Because we use the
+\Package{tocbasic}\important{\Package{tocbasic}} package, we can use the
+following:
\phantomsection\xmpllabel{cmd.BeforeStartingTOC}
\begin{lstcode}
\BeforeStartingTOC[toc]{%
@@ -224,45 +237,48 @@ too. So we cannot add the command to the \File{toc}-file. Package
{\protect\contentsname}%
}
\end{lstcode}
-However, this needs, that the file with extension \File{toc} is under control
-of package \Package{tocbasic}, which is indeed the case within all
+Of course, this assumes that the \File{toc} file is under the control
+of the \Package{tocbasic} package, which is indeed the case for all
\KOMAScript{} classes. See \autoref{sec:tocbasic.toc} on
\DescPageRef{tocbasic.cmd.BeforeStartingTOC} for more information about
-\DescPageRef{tocbasic.cmd.BeforeStartingTOC}.%
+\DescRef{tocbasic.cmd.BeforeStartingTOC}.%
\end{Example}
+Incidentally, the \DescRef{tocbasic.cmd.addxcontentsline} command used in the
+examples is also documented in \autoref{cha:tocbasic},
+\DescPageRef{tocbasic.cmd.addxcontentsline}.%
\EndIndexGroup
-\section{Note on State of Development}
+\section{Note on the State of Development}
\seclabel{draft}
-Eventhough this package has been tested by several users and even is in
-productivity usage several times it is still under construction. Therefore,
-there might be amendments especially to the internal functionality. Most likely
-the package will be extended. Some code for extensions is already in the
-package. However, there is currently no user documentation available, as up to
-now nobody has requested any of these extensions.
+Although this package has already been tested by many users and is often in
+production use, its development is still ongoing. Therefore, it is
+theoretically possible that there might be changes, especially to the internal
+functionality. It is likely that the package will be extended in the future.
+Some code for such extensions is already in the package. However, as there are
+no user commands that make use of these features, they are currently
+undocumented.
\section{Known Package Incompatibilities}
\seclabel{incompatible}
-As mentioned in \autoref{sec:scrwfile.kernelpatches},
-\Package{scrwfile} redefines some commands of the \LaTeX{} kernel. This
-happens not only while loading the package, but indeed at different times of
-processing a document, e.\,g., just before reading the
-\File{aux}-file. This\textnote{Attention!} results in incompatibility with
-packages that also redefine these commands at run-time.
+As mentioned in \autoref{sec:scrwfile.kernelpatches}, \Package{scrwfile}
+redefines some commands of the \LaTeX{} kernel. This happens not only while
+loading the package, but indeed at various times while the document is
+processed, for example just before reading the \File{aux} file.
+This\textnote{Attention!} results in incompatibility with packages that also
+redefine these commands at run time.
The \Package{titletoc}\important{Package{titletoc}}\IndexPackage{titletoc}
-package is an example for such an incompatibility. That
-package redefines \Macro{@writefile} under some conditions at run-time. If you
-use both, \Package{scrwfile} and \Package{titletoc}, there is no warranty for
-the correct behaviour of neither of them. This is neither an error of
-\Package{titletoc} nor of \Package{scrwfile}.
-
+package is an example for such an incompatibility. That package redefines
+\Macro{@writefile} under some conditions at run time. If you use both
+\Package{scrwfile} and \Package{titletoc}, there is no warranty for the
+correct behaviour of either one. This is neither an error of
+\Package{titletoc} nor of \Package{scrwfile}.%
+%
\EndIndexGroup
-
%%% Local Variables:
%%% mode: latex
%%% mode: flyspell
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex
index 729122fa94c..446e8fedd1a 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex
@@ -1,6 +1,6 @@
% ======================================================================
% tocbasic.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% tocbasic.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,75 +46,75 @@
% ======================================================================
\KOMAProvidesFile{tocbasic.tex}
- [$Date: 2017-08-08 11:57:30 +0200 (Tue, 08 Aug 2017) $
+ [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (package tocbasic)]
-% Date of the translated German file: 2017-08-08
+% Date of the translated German file: 2018-03-27
-\translator{Markus Kohm\and Arndt Schubert}
+\translator{Markus Kohm\and Arndt Schubert\and Karl Hagen}
-\chapter[{Management of Tables and Lists of Contents Using
- \Package{tocbasic}}]
- {Management of Tables and Lists of Contents Using
- \Package{tocbasic}\protect\footnote{Translation of this chapter has been
- made by the package author and needs editing!}}
+\chapter{Managing Content Lists with \Package{tocbasic}}
\labelbase{tocbasic}
\BeginIndexGroup%
\BeginIndex{Package}{tocbasic}%
\BeginIndex{}{table of contents}%
-\BeginIndex{}{list>of contents}%
+\BeginIndex{}{content list}%
\BeginIndex{}{file>extension}%
-The main purpose of package \Package{tocbasic} is to provide features for
-authors of classes and packages to create own tables or lists of contents like
-the list of figures and the list of tables and thereby allow other classes or
-packages some types of control over these. For examples package
-\Package{tocbasic} delegates language control of all these tables and lists of
-contents to package \Package{babel}\IndexPackage{babel} (see
-\cite{package:babel}). So automatic change of language will be provided
-inside all these tables and lists of contents. Using \Package{tocbasic} will
-exculpate authors of classes and packages from implementation of such
-features.
+The main purpose of the \Package{tocbasic} package is to give authors of
+packages and classes the ability to create their own tables or lists of
+content, content lists for short, similar to the list of figures and the list
+of tables, allowing classes and other packages some control over these lists.
+The \Package{tocbasic} package also delegates control of the
+language-dependent parts of these content lists to the
+\Package{babel}\IndexPackage{babel} package (see \cite{package:babel}). Using
+\Package{tocbasic} relieves package and class authors from the burden of
+implementing such features themselves.
+
+As a minor side effect, the package can also be used to define new floating
+environments, or floating environments like non-floating environments for
+reference objects. For more details, after you read about the basic commands
+in the next four sections, see the example in \autoref{sec:tocbasic.example},
+which is compactly summarized in \autoref{sec:tocbasic.declarenewtoc}.
\KOMAScript{} itself uses \Package{tocbasic} not only for the table of
-contents but also for the already mentioned lists of figures and
-tables. In\textnote{TOC} this chapter we call all kinds of tables of contents
-or lists of contents simply TOC\Index[indexmain]{TOC}.
+contents but also for the already mentioned lists of figures and tables.
\section{Basic Commands}
\label{sec:tocbasic.basics}
-Basic commands are used to handle a list of all file name
-extensions\textnote{file name extension, table or list of contents} known for
-files representing a table or list of contents. We call these auxiliary
-files\Index{auxiliary file}\footnote{Here we do not talk about the
- \File{aux}-file but the auxiliary files used indirect via the
- \File{aux}-file, e.\,g., the \File{toc}-file, the \File{lof}-file, or the
- \File{lot}-file.} TOC-files\textnote{TOC-file}\Index[indexmain]{TOC-file}
-independent from the file name extension that is used. Entries to such files
-are typically written using
+The basic commands are primarily used to handle a list of all known file
+extensions\textnote{file extension, content lists} that
+represent a table or list of contents. We call these auxiliary
+files\Index{auxiliary file}\footnote{The term \emph{auxiliary file} here
+ refers not to the main \File{aux} file but to the other internal files used
+ indirectly via the \File{aux} file, e.\,g. the \File{toc} file, the
+ \File{lof} file, or the \File{lot} file.} TOC files\textnote{TOC
+ file}\Index[indexmain]{TOC file} regardless of the file extension that is
+actually used. Entries to such files are typically written using
\Macro{addtocontents}\important{\Macro{addtocontents},
- \Macro{addcontentsline}} or \Macro{addcontentsline}. Later in this chapter
-you will learn to know recommended, additional commands. There are also
-commands to do something for all known extensions. Additionally, there are
-commands to set or unset features of a file name extension or the file
-represented by the extension. Typically an extension also has an
-owner\textnote{file owner}. This owner may be a class or package or a term
-decided by the author of the class or package using \Package{tocbasic},
-e.\,g., \KOMAScript{} uses the owner \texttt{float} for list of figures and
-list of tables, and the file name of the class file as owner for the table of
-contents.
+\DescRef{\LabelBase.cmd.addxcontentsline}}, or
+\DescRef{\LabelBase.cmd.addxcontentsline}. There are also commands to perform
+actions on all of these file extensions. Additionally, there are commands to
+set or unset features for the file associated with a given extension.
+Typically an file extension also has an owner\textnote{file owner}. This owner
+may be a class or package, or an identifier that the author of the class or
+package using \Package{tocbasic} has chosen independently. For example,
+\KOMAScript{} uses the owner \texttt{float} for the \File{lof} and \File{lot}
+file extensions that are associated with the list of figures and list of
+tables, respectively. For the table of contents, \KOMAScript{} uses the file
+name of the class.
\begin{Declaration}
- \Macro{ifattoclist}\Parameter{extension}\Parameter{true
- part}\Parameter{false part}
+ \Macro{ifattoclist}\Parameter{extension}\Parameter{then code}%
+ \Parameter{else code}
\end{Declaration}
-This command may be used to ask, whether or not a file name \PName{extension}
-is already a known extension. If the \PName{extension} is already known the
-\PName{true instructions} will be used, otherwise the \PName{false
- instructions} will be used.
+This command tests whether or not the \PName{extension} already exists in the
+list of known file extensions. If the \PName{extension} is already known, the
+\PName{then code} will be executed. Otherwise, the \PName{else code} will be
+executed.
\begin{Example}
- Maybe you want to know if the file name extension ``\File{foo}'' is already
- in use to report an error, if you can not use it:
+ Suppose you want to know if the file name extension ``\File{foo}'' is
+ already in use in order to report an error because it cannot be used:
\begin{lstcode}
\ifattoclist{foo}{%
\PackageError{bar}{%
@@ -138,39 +138,40 @@ is already a known extension. If the \PName{extension} is already known the
\Macro{addtotoclist}\OParameter{owner}\Parameter{extension}
\end{Declaration}
This command adds the \PName{extension} to the list of known extensions. But
-if the \PName{extension} is a known one already, then an error will be
-reported to avoid double usage of the same \PName{extension}.
-
-If the optional argument, \OParameter{owner}, was given, this \PName{owner}
-will be stored to be the owner of the \PName{extension}. If the optional
-argument has been omitted, \Package{tocbasic} tries to find out the file name
-of the current processed class or package and stores this as owner.
-This\textnote{Attention!} will fail if \Macro{addtotoclist} was not used,
-loading a class or package but using a command of a class or package after
-loading this class or package. In this case the owner will be set to
+if the \PName{extension} is known already, an error is reported to prevent
+duplicate use of the same \PName{extension}.
+
+If you specify the optional \OParameter{owner} argument, the given
+\PName{owner} for this file extension is also saved. If you omit the optional
+argument, \Package{tocbasic} tries to determine the file name of the class or
+package currently being processed and saves it as the owner.
+This\textnote{Attention!} procedure only works if you call
+\Macro{addtotoclist} while loading a class or package. It will fail if a user
+calls \Macro{addtotoclist} afterwards. In this case, the owner is set to
``\PValue{.}''.
-Please note\textnote{Attention!} that an empty \PName{owner} is not the same
-like omitting the optional argument with the braces. An empty argument would
-result in an empty owner.
+Note\textnote{Attention!} that passing an empty \PName{owner} argument is not
+the same as completely omitting the optional argument, including the square
+brackets. An empty argument would also result in an empty owner.
\begin{Example}
- You want to add the extension ``\File{foo}'' to the list of known extension,
- while loading your package with file name ``\File{bar.sty}'':
+ Suppose you want to add the extension ``\File{foo}'' to the list of known
+ file extensions while loading your package with the file name
+ ``\File{bar.sty}'':
\begin{lstcode}
\addtotoclist{foo}
\end{lstcode}%
- This will add the extension ``\PValue{foo}'' with owner ``\PValue{bar.sty}''
- to the list of known extensions, if it was not already in the list of known
- extensions. If the class or another package already added the extension you
- will get the error:
+ This will add the extension ``\PValue{foo}'' with the owner
+ ``\PValue{bar.sty}'' to the list of known extensions if this extension was
+ not already in the list. If the class or another package has already added
+ the extension, you will get the error:
\begin{lstoutput}
Package tocbasic Error: file extension `foo' cannot be used twice
See the tocbasic package documentation for explanation.
Type H <return> for immediate help.
\end{lstoutput}
- and after typing \texttt{h} and pressing the return key you will get the
- help:
+ If you press the ``\texttt{h}'' key followed by return, you will get the
+ following help:
\begin{lstoutput}
File extension `foo' is already used by a toc-file, while bar.sty
tried to use it again for a toc-file.
@@ -178,49 +179,60 @@ result in an empty owner.
or a mistake by the user.
\end{lstoutput}
- Maybe your package has a command, that creates list of files dynamically. In
- this case you should use the optional argument of \Macro{addtotoclist} to
- set the owner.
+ Perhaps your package also provides a command that dynamically generates a
+ content list. In this case, you should use the optional argument of
+ \Macro{addtotoclist} to specify the owner.
\begin{lstcode}
\newcommand*{\createnewlistofsomething}[1]{%
\addtotoclist[bar.sty]{#1}%
- % Do something more to make this list of something available
+ % Do something more to make this content list available
}
\end{lstcode}
- If the user calls now, e.\,g.,
+ Now if the user calls this command, for example with
\begin{lstcode}
\createnewlistofsomething{foo}
\end{lstcode}
- this would add the extension ``\PValue{foo}'' with the owner
+ this will add the extension ``\PValue{foo}'' with the owner
``\PValue{bar.sty}'' to the list of known extension or report an error, if
the extension is already in use.
\end{Example}
-You may use any owner you want. But it should be unique! So, if you would
-be, e.\,g., the author of package \Package{float} you could use for example
-owner ``\PValue{float}'' instead of owner ``\PValue{float.sty}'', so the
-\KOMAScript{} options for the list of figures and the list of tables will also
-handle the lists of this package. Those are already added to the known
-extensions when the option is used. This is because \KOMAScript{} already
-registers file name extension ``\PValue{lof}'' for the list of figures and
-file name extension ``\PValue{lot}'' for the list of tables with owner
-``\PValue{float}'' and sets options for this owner. Package \Package{scrhack}
-redefines some of package \Package{float}'s commands to do this.%
+You can specify any \PName{owner} you want, but it must be unique. For
+example, if you were the author of the \Package{float} package, you could
+specify ``\PValue{float}'' instead of ``\PValue{float.sty}'' as the
+\PName{owner}. In this case, the \KOMAScript{}
+options\important{\DescRef{maincls.option.listof}}%
+\IndexOption{listof~=\PName{setting}} for the list of figures and the list of
+tables would also affect your content lists because these lists are already
+added to the list of known file extensions at the time the option is set, and
+\KOMAScript{} associates the file extensions ``\PValue{lof}'' for the list of
+figures and ``\PValue{lot}'' for the list of tables with the owner
+``\PValue{float}'' and sets the options for this owner.
+
+By the way, the \hyperref[cha:scrhack]{\Package{scrhack}}%
+\IndexPackage{scrhack}\important{\hyperref[cha:scrhack]{\Package{scrhack}}}
+package contains patches for several packages, such as \Package{float} or
+\Package{listings}, which provide their own content lists. If you use
+\hyperref[cha:scrhack]{\Package{scrhack}}, among other things, the respective
+file extensions will be added to the list of known file extensions. Their
+\PName{owner} is also ``\PValue{float}''. This is the basic building block, so
+to speak, allowing you to use the features of \Package{tocbasic} and the
+\KOMAScript{} classes with these content lists as well.%
\EndIndexGroup
\begin{Declaration}
- \Macro{AtAddToTocList}\OParameter{owner}\Parameter{instructions}
+ \Macro{AtAddToTocList}\OParameter{owner}\Parameter{commands}
\end{Declaration}
-This command adds the \PName{instructions} to an internal list of instructions
-that will be processed whenever a file name extension with the given
-\PName{owner} will be added to the list of known extensions using
-\DescRef{\LabelBase.cmd.addtotoclist}. The optional argument is handled in the same way as
-with the command \DescRef{\LabelBase.cmd.addtotoclist}. With an empty \PName{owner} you may
-add \Parameter{instructions}, that will be processed at every successful
-\DescRef{\LabelBase.cmd.addtotoclist}, after processing the instructions for the individual
-owner. While processing the \PValue{instructions},
-\Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} will be set to
-the extension of the currently added extension.
+This command adds the \PName{commands} to an internal list of commands that
+will be processed whenever a file extension with the specified \PName{owner}
+is added to the list of known extensions with
+\DescRef{\LabelBase.cmd.addtotoclist}. The optional argument is handled in the
+same way as in the \DescRef{\LabelBase.cmd.addtotoclist} command. If you leave
+the optional argument blank, the commands will always be executed, regardless
+of the owner, every time a new file extension is added to the list of known
+file extensions. Furthermore, while processing the \PValue{commands},
+\Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} is set to the
+extension of the extension currently being added.
\begin{Example}
\Package{tocbasic} itself uses
\begin{lstcode}
@@ -229,14 +241,15 @@ the extension of the currently added extension.
\expandafter{\@currext}%
}
\end{lstcode}
- to add every extension to the \Package{tocbasic}-internal babel handling of
- files.
+ to add every file extension to the existing \Package{tocbasic} integration
+ with the \Package{babel} package.
\end{Example}
-The two \Macro{expandafter} commands are needed, because the argument of
-\DescRef{\LabelBase.cmd.tocbasic@extend@babel} has to be expanded! See the description of
-\DescRef{\LabelBase.cmd.tocbasic@extend@babel} at \autoref{sec:tocbasic.internals}%
-, \DescPageRef{\LabelBase.cmd.tocbasic@extend@babel} for more information.%
+The two \Macro{expandafter} commands in the example are needed because the
+argument of \DescRef{\LabelBase.cmd.tocbasic@extend@babel} has to be expanded.
+See the description of \DescRef{\LabelBase.cmd.tocbasic@extend@babel} in
+\autoref{sec:tocbasic.internals},
+\DescPageRef{\LabelBase.cmd.tocbasic@extend@babel} for more information.%
\EndIndexGroup
@@ -244,296 +257,316 @@ The two \Macro{expandafter} commands are needed, because the argument of
\Macro{removefromtoclist}\OParameter{owner}\Parameter{extension}
\end{Declaration}
This command removes the \PName{extension} from the list of known extensions.
-If the optional argument, \OParameter{owner}, was given, the \PName{extension}
-will only be removed if it was added by this \PName{owner}. See description of
-\DescRef{\LabelBase.cmd.addtotoclist} for information of omitting optional argument. Note that
-an empty \PName{owner} is not the same like omitting the optional argument,
-but removes the \PName{extension} without any owner test.%
+If the optional argument, \OParameter{owner}, is given, the \PName{extension}
+will only be removed if it was added by this \PName{owner}. See
+\DescRef{\LabelBase.cmd.addtotoclist} for an explanation of how the list owner
+is determined if the optional argument is omitted. If you specify an empty
+\PName{owner}, the owner is not tested and the \PName{extension} is removed
+regardless of the owner.%
\EndIndexGroup
\begin{Declaration}
- \Macro{doforeachtocfile}\OParameter{owner}\Parameter{instructions}
+ \Macro{doforeachtocfile}\OParameter{owner}\Parameter{commands}
\end{Declaration}
-Until now you've learned to know commands that result in more safety in
-handling file name extensions, but also needs some additional effort. With
-\Macro{doforeachtocfile} you will win for this. The command provides to
-processes \PName{instructions} for every known file name extension of the
-given \PName{owner}. While processing the \PName{instructions}
-\Macro{@currext} is the extension of the current file. If you omit the
-optional argument, \OParameter{owner}, every known file name extension
-independent from the owner will be used. If the optional argument is empty,
-only file name extensions with an empty owner will be processed.
+To this point, we've introduced commands provide additional security for class
+and package authors, but also more overhead. With \Macro{doforeachtocfile},
+you can reap the first benefit for this. This command lets you execute the
+specified \PName{commands} for each file extension associated with an
+\PName{owner}. While processing the \PName{commands}, \Macro{@currext} is the
+extension of the current file. If you omit the optional \OParameter{owner}
+argument, all file extensions are processed regardless of the owner. If the
+optional argument is empty, on the other hand, only extensions with an empty
+owner will be processed.
\begin{Example}
- If you want to type out all known extensions, you may simply write:
+ If you want to output a list of all known file extensions to the terminal
+ and to the \File{log} file, you can easily accomplish this:
\begin{lstcode}
\doforeachtocfile{\typeout{\@currext}}
\end{lstcode}
- and if only the extensions of owner ``\PValue{foo}'' should be typed out:
+ If, on the other hand, you only want to output the extensions owned by
+ ``\PValue{foo}'', this too is easy:
\begin{lstcode}
\doforeachtocfile[foo]{\typeout{\@currext}}
\end{lstcode}
\end{Example}
+The \KOMAScript{} classes \Class{scrbook} and \Class{scrreprt} use this
+command to optionally put a vertical skip or the chapter heading in content
+lists using the \PValue{chapteratlist} feature. You can learn how to set this
+feature in \autoref{sec:tocbasic.toc} on
+\DescPageRef{\LabelBase.cmd.setuptoc}.%
\EndIndexGroup
\begin{Declaration}
\Macro{tocbasicautomode}
\end{Declaration}
-This command redefines \LaTeX{} kernel macro \Macro{@starttoc} to add all not
-yet added extensions to the list of known extensions and use
-\DescRef{\LabelBase.cmd.tocbasic@starttoc} instead of \Macro{@starttoc}. See
-\autoref{sec:tocbasic.internals},
+This command redefines \LaTeX{} kernel macro \Macro{@starttoc} for class and
+package authors so that every time \Macro{@starttoc} is called, the specified
+file extension is added to the list of known extensions, if it has not already
+been added. It also uses \DescRef{\LabelBase.cmd.tocbasic@starttoc} instead of
+\Macro{@starttoc}. See \autoref{sec:tocbasic.internals},
\DescPageRef{\LabelBase.cmd.tocbasic@starttoc} for more information about
\DescRef{\LabelBase.cmd.tocbasic@starttoc} and \Macro{@starttoc}.
-This means that after using \Macro{tocbasicautomode} every table of contents
-or list of something, that will be generated using \Macro{@starttoc} will be
-at least partially under control of \Package{tocbasic}. Whether or not this
-will make the wanted result, depends on the individual TOC. At least the
-\Package{babel} control extension for all those TOCs will work. Nevertheless,
-it would be better if the author of the corresponding class or package will
-use \Package{tocbasic} explicitly. In that case additional advantages of
-\Package{tocbasic} may be used that will be described at the following
-sections.%
+After you use \Macro{tocbasicautomode}, every content list created with
+\Macro{@starttoc} is automatically put under the control of
+\Package{tocbasic}. Whether or not this leads to the desired result, however,
+depends very much on the individual content list. The \Package{babel} package
+extensions, at least, will work for all those content lists. Nevertheless, it
+is preferable for the class or package authors to use \Package{tocbasic}
+explicitly. That way they can also take advantage of the other features of
+\Package{tocbasic}, which are described in the following sections.%
\EndIndexGroup
-\section{Creating a Table or List of Contents}
+\section{Creating a Content List}
\label{sec:tocbasic.toc}
-In the previous section you've seen commands to handle a list of known file
-name extensions and to trigger commands while adding a new extension to this
-list. You've also seen a command to do something for all known extensions or
-all known extensions of one owner. In this section you will learn to know
-commands to handle the file corresponding with an extension or the list of
-known extensions.
+In the previous section, you learned how to maintain a list of known file
+extensions and how to automatically execute commands when adding new
+extensions to this list. You also saw a command that can be used to execute
+instructions for all known extensions or all extensions belonging to one
+owner. In this section, you will learn commands that apply to the files
+associated with these file extensions.
\begin{Declaration}
\Macro{addtoeachtocfile}\OParameter{owner}\Parameter{content}
\end{Declaration}
-This command writes \PName{content} to the TOC-files\Index{TOC} of every known
-file name extension of \PName{owner} using \LaTeX{} kernel command
-\Macro{addtocontents}. If you omit the optional argument, \PName{content} is
-written to the files of every known file name extension. Furthermore, the
-practical file name is built from \Macro{jobname} and the file name
-extension. While writing the \PName{content},
+The \Macro{addtoeachtocfile} command uses the \LaTeX{} kernel command
+\Macro{addtocontents} to write the \PName{content} to every TOC file\Index{TOC
+file} in the list of known file extensions that has the specified
+\PName{owner}. If you omit the optional argument, the \PName{content} is
+written to each file in the list of known file extensions. Incidentally, the
+actual file name is constructed from \Macro{jobname} and the file extension.
+While writing the \PName{content},
\Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} is the
-extension of the currently handled file.
+extension of the file currently being processed.
\begin{Example}
- You may add a vertical space of one text line to all toc-files.
+ You want to add a vertical space of one line to all TOC files.
\begin{lstcode}
\addtoeachtocfile{%
\protect\addvspace{\protect\baselineskip}%
}
\end{lstcode}
- And if you want to do this, only for the TOC-files of owner
- ``\PValue{foo}'':
+ If, on the other hand, you want to do this only for the files that have the
+ owner ``\PValue{foo}'', use:
\begin{lstcode}
\addtoeachtocfile[foo]{%
\protect\addvspace{\protect\baselineskip}%
}
\end{lstcode}
\end{Example}
-Commands, that shouldn't be expanded while writing, should be prefixed by
-\Macro{protect} in the same way like they should be in the argument of
+You should protect commands that should not be expanded when they are written
+by prefixing them with \Macro{protect}, in the same way as you would in
\Macro{addtocontents}.
\EndIndexGroup
\begin{Declaration}
\Macro{addxcontentsline}%
- \Parameter{extension}\Parameter{level}\OParameter{number}%
+ \Parameter{extension}\Parameter{level}\OParameter{section number}%
\Parameter{text}
\end{Declaration}
-The command \Macro{addxcontentsline} adds an entry of given \PName{level} to
-TOC-file with file name \PName{extension}. If the \Parameter{number} is empty
-or omitted the entry will not have number for the entry with the given
-\PName{text}. Entries without number may be left aligned to the number of the
-numbered entries of the same \PName{level} or indented like the text of the
-numbered entries of the same \PName{level}, depending on the
-\PValue{numberline} feature.
-
-\begin{Example}
- Maybe you are not using a \KOMAScript{} class but need a not numbered
- chapter with entry to the table of contents. This may be done using
-\begin{lstcode}
- \cleardoublepage
- \csname phantomsection\endcsname
- \addxcontentsline{toc}{chapter}
- {Chapters without Numbers}
- \chapter*{Chapters without Numbers}
- \markboth{Chapters without Numbers}{}
-\end{lstcode}
- As you can see, you simply have to replace usual \Macro{addcontentsline} by
- \Macro{addxcontentsline} to support the \Package{tocbasic} feature
- \PValue{numberline}.
-\end{Example}
-
-Note that \Macro{addxcontentsline} uses
-\Macro{add\PName{level}\PName{extension}entry} if such a macro exists and
-\DescRef{\LabelBase.cmd.tocbasic@addxcontentsline} otherwise. Therefore you cannot define
-a macro \Macro{add\PName{level}\PName{extension}entry} using
-\Macro{addxcontentsline} but \DescRef{\LabelBase.cmd.tocbasic@addxcontentsline}.
+This command is very similar to
+\Macro{addcontentsline}\IndexCmd{addcontentsline} from the \LaTeX{} kernel.
+However, it has an additional optional argument for the \PName{section number}
+of the entry, whereas for \Macro{addcontentsline}, it is specified in the
+\PName{text} argument. It is used to include numbered or unnumbered entries in
+the content list specified by the file \PName{extension}, where \PName{level}
+is the sectioning level and \PName{text} is the content of the corresponding
+entry. The page number is determined automatically.
+
+In contrast to \Macro{addcontentsline}, \Macro{addxcontentsline} first tests
+whether the \Macro{add\PName{level}\PName{extension}entry} command is defined.
+If so, it will be used for the entry, passing the \PName{section number} as an
+optional argument and \PName{text} as a mandatory argument. You can find an
+example of such a command provided by the \KOMAScript{} classes in
+\DescRef{maincls-experts.cmd.addparttocentry} (see
+\autoref{sec:maincls-experts.experts},
+\DescPageRef{maincls-experts.cmd.addparttocentry}). If the corresponding
+command is undefined, the internal command
+\DescRef{\LabelBase.cmd.tocbasic@addxcontentsline} is used instead. This takes
+all four arguments as mandatory arguments and then uses
+\Macro{addcontentsline} to create the desired entry. You can find more about
+\DescRef{\LabelBase.cmd.tocbasic@addxcontentsline} in
+\autoref{sec:tocbasic.internals},
+\DescPageRef{\LabelBase.cmd.tocbasic@addxcontentsline}.
-It is recommended to use \Macro{addxcontentsline} instead of
-\Macro{addcontentsline} whenever possible.%
+One advantage of using \Macro{addxcontentsline} rather than
+\Macro{addcontentsline} is that the \PValue{numberline} feature is respected
+(see \DescPageRef{\LabelBase.cmd.setuptoc}). Furthermore, you can configure
+the form of the entries by defining the appropriate commands specific to the
+\PName{level} and file \PName{extension}.%
+%
\EndIndexGroup
\begin{Declaration}
- \Macro{addcontentslinetoeachtocfile}\OParameter{owner}\Parameter{level}%
- \Parameter{contentsline}%
- \Macro{addxcontentslinetoeachtocfile}\OParameter{owner}%
- \Parameter{level}\OParameter{number}\Parameter{text}
+ \Macro{addxcontentslinetoeachtocfile}\OParameter{owner}
+ \Parameter{level}
+ \OParameter{section number}%
+ \Parameter{text}
+ \Macro{addcontentslinetoeachtocfile}\OParameter{owner}
+ \Parameter{level}\Parameter{text}%
\end{Declaration}
-The first command is something like \Macro{addcontentsline} from \LaTeX{}
-kernel. In difference to that it writes the \PName{contentsline} not only into
-one file, but into all files of all known file name extensions or of all known
-file name extensions of a given owner.
-
-The command \Macro{addxcontentslinetoeachtocfile} is similar but uses
-\DescRef{\LabelBase.cmd.addxcontentsline} instead of \Macro{addcontentsline} and
-therefore supports \Package{tocbasic} feature \PValue{numberline}.
+These two commands are directly related to
+\DescRef{\LabelBase.cmd.addxcontentsline}\ChangedAt{v3.12}{\Package{tocbasic}}
+explained above, or to \Macro{addcontentsline} from the \LaTeX kernel. The
+difference is that these statements write \PName{text} not just to a single
+file but to all the files of a given \PName{owner} and, if the first optional
+argument is omitted, to all files in the list of known file extensions.
\begin{Example}
- You are a class author and want to write the chapter entry not only to the
- table of contents TOC-file but to all TOC-files, while \texttt{\#1} is the
- title, that should be written to the files.
+ Suppose you are a class author and you want to write the chapter entry not
+ just in the table of contents but in all content-list files. Suppose further
+ that \PValue{\#1} currently contains the text to be written.
\begin{lstcode}
- \addxcontentslinetoeachtocfile
- {chapter}[\thechapter]{#1}%
+ \addxcontentslinetoeachtocfile{chapter}%
+ [\thechapter]{#1}
\end{lstcode}
- In this case the current chapter number should be expanded while writing
- into the file. So it isn't protected from expansion using \Macro{protect}.
+ In this case, of course, the current chapter number should be expanded
+ directly when writing to the TOC file, which is why it was not protected
+ from expansion with \Macro{protect}.
\end{Example}
-While writing \Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}}
-is the file name extension of the file into which \PName{contentsline} will be
-written.
-
-It is recommended to use \Macro{addxcontentslinetoeachtocfile} instead
-of \Macro{addcontentslinetoeachtocfile} whenever possible.
+While writing the \PName{content},
+\Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} here is also
+the extension of the file being written to, as it is with
+\DescRef{\LabelBase.cmd.addtoeachtocfile}.%
+
+Whenever\ChangedAt{v3.12}{\Package{tocbasic}} possible, the
+\Macro{addxcontentslinetoeachtocfile} command is preferable to
+\Macro{addcontentslinetoeachtocfile} because only the former offers the
+enhancements of \DescRef{\LabelBase.cmd.addxcontentsline}. You can find more
+about these enhancements and benefits in the explanation of
+\DescRef{\LabelBase.cmd.addxcontentsline} above.%
+%
\EndIndexGroup
\begin{Declaration}
- \Macro{listoftoc}\OParameter{list of title}\Parameter{extension}%
+ \Macro{listoftoc}\OParameter{list-of title}\Parameter{extension}%
\Macro{listoftoc*}\Parameter{extension}%
\Macro{listofeachtoc}\OParameter{owner}%
\Macro{listof\PName{extension}name}
\end{Declaration}
-These commands may be used to print the TOC corresponding to file name
-\PName{extension}. The\important{\Macro{listoftoc*}} star version
-\Macro{listoftoc*} needs only one argument, the \PName{extension} of the
-file. It does setup the vertical and horizontal spacing of paragraphs, calls
-before hooks, reads the file, and last but not least calls the after hooks.
-You may interpret it as direct replacement of the \LaTeX{} kernel macro
+You can use these commands to print the content lists.
+The\important{\Macro{listoftoc*}} stared version \Macro{listoftoc*} needs only
+one argument, the \PName{extension} of the file. The command first initializes
+the vertical and horizontal spacing of paragraphs, calls the hook to execute
+commands before reading the file, then reads the file, and finally executes
+the hook to execute commands after reading the file. Thus you can think of
+\Macro{listoftoc*} as a direct replacement for the \LaTeX{} kernel macro
\Macro{@starttoc}\IndexCmd{@starttoc}\important{\Macro{@starttoc}}.
-The\important{\Macro{listoftoc}} version without star, prints the whole file
-with title, optional table of contents entry, and running heads. If the
-optional argument \OParameter{list of title} was given, it will be used as
-title term, optional table of contents entry and running head. Please
-note\textnote{Attention!}: If the optional argument is empty, this term will
-be empty, too! If you omit the optional argument, but
-\Macro{listof\PName{extension}name} was defined, that will be used. If that is
-also not defined, a standard replacement name will be used and reported by a
-warning message.
-
-The\important{\Macro{listofeachtoc}} command \Macro{listofeachtoc} outputs all
-lists of something of the given \PName{owner} or of all known file
-extensions. Thereby\textnote{Attention!}
-\Macro{listof\PName{extension}name} should be defined to get the correct
-titles.
-
-It\textnote{Hint!} is recommended to define
-\Macro{listof\PName{extension}name} for all used file name extensions, because
-the user itself may use \Macro{listofeachtoc}.
+The\important{\Macro{listoftoc}} version of \Macro{listoftoc} without the star
+prints the complete content list and also creates an optional entry in the
+table of contents and the running heads. If you provide the optional
+\OParameter{list-of title} argument, it is used both as the title for the list
+and as an optional entry in the table of contents and the running head.
+If\textnote{Attention!} the \OParameter{list-of title} argument is empty, the
+title will be empty too. If, on the other hand, you completely omit the
+optional argument, including the square brackets, the
+\Macro{listof\PName{extension}name} command will be used if it is defined. If
+it is undefined, a default replacement name is used and a warning is issued.
+
+The\important{\Macro{listofeachtoc}} \Macro{listofeachtoc} command outputs all
+content lists associated with the given \PName{owner}, or of all known file
+extensions if the optional argument is omitted. To\textnote{Attention!} output
+the correct titles, \Macro{listof\PName{extension}name} should be defined.
+
+You\textnote{Hint!} should define \Macro{listof\PName{extension}name}
+appropriately for all file extensions because users may use \Macro{listoftoc}
+without the optional argument, or \Macro{listofeachtoc}, themselves.
\begin{Example}
- Assumed, you have a new ``list of algorithms'' with extension \PValue{loa}
- and want to show it:
+ Suppose you have a new ``list of algorithms'' with the file extension
+ \PValue{loa} and want to output it. The command
\begin{lstcode}
\listoftoc[List of Algorithms]{loa}
\end{lstcode}
- will do it for you. But maybe the ``list of algorithms'' should not be set
- with a title. So you may use
+ will do it for you. If, however, you want to output this list without a
+ title, you could use
\begin{lstcode}
\listof*{loa}
\end{lstcode}
- Note that in this case no entry at the table of contents will be created,
- even if you'd used the setup command above.
- See command \DescRef{\LabelBase.cmd.setuptoc}
- at \DescPageRef{\LabelBase.cmd.setuptoc}
- for more information about the
- attribute of generating entries into the table of contents using
- \DescRef{\LabelBase.cmd.setuptoc}.
-
- If you've defined
+ In the second case, of course, there will be no entry in the table of
+ contents. For more information about creating entries in the table of
+ contents, see the \DescRef{\LabelBase.cmd.setuptoc} command on
+ \DescPageRef{\LabelBase.cmd.setuptoc}.
+
+ If you have defined
\begin{lstcode}
\newcommand*{\listofloaname}{%
List of Algorithms%
}
\end{lstcode}
- before, then
+ already, then
\begin{lstcode}
\listoftoc{loa}
\end{lstcode}
- would be enough to print the list of algorithms with the wanted heading. For
- the user it may be easier to operate, if you'd define
+ will suffice to print the content list with the desired heading. It may be
+ easier for users to remember if you also define a simple list-of command:
\begin{lstcode}
\newcommand*{\listofalgorithms}{\listoftoc{loa}}
\end{lstcode}
- additionally.
\end{Example}
Because\textnote{Attention!} \LaTeX{} normally opens a new file for each of
-those lists of something immediately, the call of each of those commands may
+these content lists, calling each of these commands may
result in an error like:
\begin{lstoutput}
! No room for a new \write .
\ch@ck ...\else \errmessage {No room for a new #3}
\fi
\end{lstoutput}
-if there are no more write handles left. Loading package
+if there are no more write handles left. Loading the
\Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile}
-(see \autoref{cha:scrwfile})
-may solve this problem.
+package (see \autoref{cha:scrwfile}) can solve this problem.
+
+Also, the \hyperref[cha:scrhack]{\Package{scrhack}}\IndexPackage{scrhack}%
+\important{\hyperref[cha:scrhack]{\Package{scrhack}}} package contains patches
+for several packages, such as \Package{float} or \Package{listings}, so that
+their content-list commands can use \Macro{listoftoc}. As a result, many
+features of \Package{tocbasic} and the \KOMAScript{} classes are also
+available for their content lists.%
\EndIndexGroup
\begin{Declaration}
- \Macro{BeforeStartingTOC}\OParameter{extension}\Parameter{instructions}%
- \Macro{AfterStartingTOC}\OParameter{extension}\Parameter{instructions}
+ \Macro{BeforeStartingTOC}\OParameter{extension}\Parameter{commands}%
+ \Macro{AfterStartingTOC}\OParameter{extension}\Parameter{commands}
\end{Declaration}
-Sometimes it's useful, to process \PName{instructions} immediately before
-reading the auxiliary file of a TOC. These commands may be used to process
-\PName{instructions} before or after loading the file with given
-\PName{extension} using \DescRef{\LabelBase.cmd.listoftoc*}, \DescRef{\LabelBase.cmd.listoftoc}, or
-\DescRef{\LabelBase.cmd.listofeachtoc}. If you omit the optional argument (or set an empty
-one) the general hooks will be set. The general before hook will be called
-before the individuel one and the general after hook will be called after the
-individuel one. While calling the hooks
+Sometimes it's useful to be able to execute \PName{commands} immediately
+before reading the auxiliary TOC file. With \Macro{BeforeStartingTOC} you can
+do so either for a single file \PName{extension} or for all files that are
+read using \DescRef{\LabelBase.cmd.listoftoc*},
+\DescRef{\LabelBase.cmd.listoftoc}, or \DescRef{\LabelBase.cmd.listofeachtoc}.
+You can also execute \PName{commands} after reading the file if you define
+them with \Macro{AfterStartingTOC}. If you omit the optional argument (or set
+an empty one) a general hook will be set and the commands will be applied to
+all content lists. The general before-hook is called before the individual
+one, and the general after-hook is called after the individual one. While
+executing the commands in these hooks,
\Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} is the
-extension of the TOC-file and should not be changed.
+extension of the TOC file which is about to be or has just been read.
-An example\textnote{Example} for usage of \Macro{BeforeStartingTOC} may be
-found in \autoref{sec:scrwfile.clonefilefeature} at
+You can find an example\textnote{Example} using \Macro{BeforeStartingTOC} in
+\autoref{sec:scrwfile.clonefilefeature} on
\PageRefxmpl{scrwfile.cmd.BeforeStartingTOC}.
+%
\EndIndexGroup
\begin{Declaration}
- \Macro{BeforeTOCHead}\OParameter{extension}\Parameter{instructions}%
- \Macro{AfterTOCHead}\OParameter{extension}\Parameter{instructions}
+ \Macro{BeforeTOCHead}\OParameter{extension}\Parameter{commands}%
+ \Macro{AfterTOCHead}\OParameter{extension}\Parameter{commands}
\end{Declaration}
-This commands may be used to process \PName{instructions} before or after
-setting the title of a TOC corresponding to given file name \PName{extension}
-using \DescRef{\LabelBase.cmd.listoftoc*} or
-\DescRef{\LabelBase.cmd.listoftoc}. If you omit the optional argument (or set
-an empty one) the general hooks will be set. The general before hook will be
-called before the individuel one and the general after hook will be called
-after the individuel one. While calling the hooks
-\Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} is the
-extension of the corresponding file and should not be changed.
+You can also define \PName{commands} that will be executed immediately before
+or after setting the title of a content list using
+\DescRef{\LabelBase.cmd.listoftoc*} or \DescRef{\LabelBase.cmd.listoftoc}. The
+treatment of the optional parameter and the meaning of
+\Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} is the same as
+described for \DescRef{\LabelBase.cmd.BeforeStartingTOC} and
+\DescRef{\LabelBase.cmd.AfterStartingTOC}.%
\EndIndexGroup
@@ -541,56 +574,56 @@ extension of the corresponding file and should not be changed.
\Macro{MakeMarkcase}\Parameter{text}
\end{Declaration}
Whenever \Package{tocbasic} sets a mark for a running head, The text of the
-mark will be an argument of \Macro{MakeMarkcase}. This command may be used, to
-change the case of the letters at the running head if wanted. The default is,
-to use
-\Macro{@firstofone}\IndexCmd{@firstofone}\important{\Macro{@firstofone}} for
-\KOMAScript{} classes. This means the text of the running head will be set
-without change of case.
-\Macro{MakeUppercase}\IndexCmd{MakeUppercase}\important{\Macro{MakeUppercase}}
-will be used for all other classes. If you are the class author you may define
-\Macro{MakeMarkcase} on your own. If \Package{scrlayer} or another package,
-that defines \Macro{MakeMarkcase} will be used, \Package{tocbasic} will not
-overwrite that definition.
+mark will be an argument of \Macro{MakeMarkcase}. You can use this command to
+change the case of the running head if necessary. The \KOMAScript{} classes
+use \Macro{@firstofone}\IndexCmd{@firstofone}\important{\Macro{@firstofone}}
+by default. This means the text of the running head will be set without
+changing the capitalisation. If you use a different class,
+\Macro{MakeMarkcase} will be set to
+\Macro{MakeUppercase}\IndexCmd{MakeUppercase}%
+\important{\Macro{MakeUppercase}}. However, \Package{tocbasic} only defines
+this command if it is not already defined. It can therefore be predefined by
+another class or package and \Package{tocbasic} will use that definition
+rather than overwriting it.
\begin{Example}
- For incomprehensible reasons, you want to set the running heads in lower
- case letters only. To make this automatically for all running heads, that
- will be set by \Package{tocbasic}, you define:
+ For some strange reason, you want to set the running heads entirely in
+ lower-case letters. To apply this change automatically for all running heads
+ set by \Package{tocbasic}, you define:
\begin{lstcode}
\let\MakeMarkcase\MakeLowercase
\end{lstcode}
\end{Example}
-Please\textnote{Hint!} allow me some words about
-\Macro{MakeUppercase}\IndexCmd{MakeUppercase}, First of all this command isn't
-fully expandable. This means, that problems may occur using it in the context
-of other commands. Beyond that typographers accord, that whenever setting
-whole words or phrases in capitals, letter spacing is absolutely
-necessary. But correct letter spacing of capitals should not be done with a
-fix white space between all letters. Different pairs of letters need different
-space between each other. Additional some letters build holes in the text,
-that have to be taken into account. Packages like \Package{ulem} or
-\Package{soul} doesn't provide this and \Macro{MakeUppercase} does not do
-anything like this. Also automatic letter spacing using package
-\Package{microtype} is only one step to a less-than-ideal solution, because it
-cannot recognize and take into account the glyphs of the letters. Because of
-this\textnote{Attention!} typesetting whole words and phrases is expert work
-and almost ever must be hand made. So average users are recommended to not do
-that or to use it only spare and not at exposed places like running heads.%
+Let\textnote{Hint!} me give you some advice about
+\Macro{MakeUppercase}\IndexCmd{MakeUppercase}. First of all, this command is
+not fully expandable. This means that it can cause problems interacting with
+other commands. Beyond that, typographers agree that whenever you set whole
+words or phrases in capital letters, additional spacing is absolutely
+necessary. However, adding a fixed spacing between all letters is not an
+adequate solution. Different pairs of letters require different spaces between
+them. Additionally, some letters already create gaps in the text that must be
+taken into account. Packages like \Package{ulem} or \Package{soul} can
+scarcely achieve this, nor can \Macro{MakeUppercase}. The automatic letter
+spacing using the \Package{microtype} package is in this respect only an
+approximate solution, because it does not take into account the concrete,
+font-dependent glyphs. Because\textnote{Attention!} typesetting all-capital
+text is expert work and almost always requires manual adjustment, ordinary
+users are recommended avoid using it, or to use it only sparingly and not in
+such an exposed place as the running head.%
\EndIndexGroup
\begin{Declaration}
\Macro{deftocheading}\Parameter{extension}\Parameter{definition}
\end{Declaration}
-The package \Package{tocbasic} contains a standard definition for typesetting
-headings of TOCs. This standard definition is configurable by several
-features, described at \DescRef{\LabelBase.cmd.setuptoc} next. But if all those features are
-not enough, an alternative heading command may be defined using
-\Macro{deftocheading}. Thereby \PName{extension} is the file name extension of
-the corresponding TOC-file. The \PName{definition} of the heading command may
-use one single parameter \PValue{\#1}. While calling the newly defined command
-inside of \DescRef{\LabelBase.cmd.listoftoc} or \DescRef{\LabelBase.cmd.listofeachtoc} that \PValue{\#1} will be
-replaced by the corresponding heading term.%
+The \Package{tocbasic} package contains a default definition for typesetting
+the titles of content lists. You can configure this default definition through
+various features discussed in the \DescRef{\LabelBase.cmd.setuptoc} comand
+below. If those features are not enough, you can use \Macro{deftocheading}
+to define your own title for the content list with the given file
+\PName{extension}. The \PName{definition} of the title can use a single
+parameter, \PValue{\#1}. When the command is called inside
+\DescRef{\LabelBase.cmd.listoftoc} or \DescRef{\LabelBase.cmd.listofeachtoc},
+that \PValue{\#1} will be replaced by the title of this content list.%
\EndIndexGroup
@@ -598,203 +631,207 @@ replaced by the corresponding heading term.%
\Macro{setuptoc}\Parameter{extension}\Parameter{feature list}%
\Macro{unsettoc}\Parameter{extension}\Parameter{feature list}
\end{Declaration}
-This commands set up and unset features bound to a file name
-\PName{extension}. The \PName{feature list} is a comma separated list of
-single features. \Package{tocbasic} does know following features:
+You can use these two commands to set and clear features for a TOC file
+\PName{extension} or the content list associated with it. The \PName{feature
+list} is a comma-separated list of features. The \Package{tocbasic} package
+recognizes following features:
\begin{description}
-\item[\texttt{leveldown}] uses not the top level heading below
+\item[\texttt{leveldown}] means that the content list's heading is created not
+ with the highest sectioning level below
\DescRef{maincls.cmd.part}\,---\,\DescRef{maincls.cmd.chapter} if available,
- \DescRef{maincls.cmd.section} otherwise\,---\,but the first sub level. This
- feature will be evaluated by the internal heading command. On the other
- hand, if an user defined heading command has been made with
- \DescRef{\LabelBase.cmd.deftocheading}, that user is responsible for the evaluation of the
- feature. The \KOMAScript{} classes set this feature using option
- \OptionValueRef{maincls}{listof}{leveldown}%
+ \DescRef{maincls.cmd.section} otherwise\,---\,but with a heading of the next
+ level below that. This feature is evaluated by the internal heading command.
+ On the other hand, if a user-defined heading command has been created with
+ \DescRef{\LabelBase.cmd.deftocheading}, the person defining that command is
+ responsible for evaluating the feature. The \KOMAScript{} classes set this
+ feature using the \OptionValueRef{maincls}{listof}{leveldown}%
important{\OptionValueRef{maincls}{listof}{leveldown}}%
- \IndexOption{listof~=\PValue{leveldown}} for all file name extensions of the
- owner \PValue{float}.
-\item[\texttt{nobabel}] prevents usage of the language switch of
- \Package{babel}\IndexPackage{babel} at the TOC-file with the corresponding
- file name \PName{extension}. This feature should be used only for auxiliary
- files, that contain text in one language only. Changes of the language
- inside of the document will not longer regarded at the TOC-file. Package
- \Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile} uses
- this feature also for clone destinations, because those will get the
- language change from the clone source already.
-
- Please note\textnote{Attention!}, the feature is executed while adding a
- file extension to the list of known file extension. Changing the feature
- afterwards would not have any effect.
+ \IndexOption{listof~=\textKValue{leveldown}} option for all file extensions
+ with the owner \PValue{float}.
+\item[\texttt{nobabel}] prevents using the language-switching features of
+ \Package{babel}\IndexPackage{babel} for the TOC file associated with the
+ this file \PName{extension}. This feature should be used only for content
+ lists that are created in a fixed language, which means that changes of the
+ language inside of the document will no longer affect the content list. The
+ \Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile}
+ package also uses this feature for cloned destinations, as because those
+ files already inherit any language changes from the cloning source.
+
+ Note\textnote{Attention!} that you must set this feature before you add a
+ file extension to the list of known extensions. Changing the feature
+ afterwards will have no effect.
\item[\texttt{noparskipfake}] prevents\ChangedAt{v3.17}{\Package{tocbasic}}
- usage of an extra \Length{parskip} before switching \Length{parskip} off. In
- general, the consequence of this feature for documents using paragraph
- distance is less vertical space between heading and first entry than between
- normal headings and normal text.
+ the insertion of a final \Length{parskip} before switched off paragraph
+ spacing for content lists. In general, this will cause documents that use
+ spacing between paragraphs to have less vertical space between the list
+ heading and first entry than between normal headings and normal text.
+ Normally, therefore, you will obtain a more uniform formatting without this
+ feature.
\item[\texttt{noprotrusion}] prevents\ChangedAt{v3.10}{\Package{tocbasic}}
- disabling character protrusion at the TOC. Character protrusion at the TOCs
- will be disabled by default if package
- \Package{microtype}\IndexPackage{microtype} or another package, that
- supports \Macro{microtypesetup}\IndexCmd{microtypesetup}, was loaded. So if
- you want protrusion at a TOC, you have to set this feature. But
- note\textnote{Attention!}, with character protrusion TOC-entries may be
- printed wrong. This is a known issue of character protrusion.
-\item[\texttt{numbered}] uses a numbered heading for the TOC and because of
- this also generates an entry to the table of contents. This feature will be
- evaluated by the internal heading command. On the other hand, if an user
- defined heading command has been made with \DescRef{\LabelBase.cmd.deftocheading}, that user
- is responsible for the evaluation of the feature. The \KOMAScript{} classes
- set this feature using option \OptionValueRef{maincls}{listof}{numbered}%
+ character protrusion, which allows optical margin alignment, from being
+ disabled in the content lists. By default, character protrusion is disabled
+ when the \Package{microtype}\IndexPackage{microtype} package, or another
+ package that supports \Macro{microtypesetup}\IndexCmd{microtypesetup}, is
+ loaded. So if you want optical margin alignment in the content lists, you
+ must set this feature. Note\textnote{Attention!}, however, that character
+ protrusion in content lists often results in incorrect results. This is a
+ known issue with character protrusion.
+\item[\texttt{numbered}] means that the heading for the content list should
+ be numbered and included in the table of contents. This feature is evaluated
+ by the internal heading command. However, if a user-defined heading command
+ has been created with \DescRef{\LabelBase.cmd.deftocheading}, the person
+ creating that definition is responsible evaluating the feature. The
+ \KOMAScript{} classes set this feature using the
+ \OptionValueRef{maincls}{listof}{numbered}%
\important{\OptionValueRef{maincls}{listof}{numbered}}%
- \IndexOption{listof~=\PValue{numbered}} for all file name extensions of the
- owner \PValue{float}.
+ \IndexOption{listof~=\textKValue{numbered}} option for all file extensions
+ with the owner \PValue{float}.
\item[\texttt{numberline}] \leavevmode\ChangedAt{v3.12}{\Package{tocbasic}}%
- redefines \Macro{nonumberline} to use \DescRef{\LabelBase.cmd.numberline}. With this the not
- numbered entries generated by \KOMAScript{} or using \Macro{nonumberline} at
- the very beginning of the last argument of \Macro{addcontentline} will also
- be indented like numbered entries of the same
- type. Using\ChangedAt{v3.20}{\Package{tocbasic}} \DescRef{\LabelBase.cmd.numberline} for
- entries without number\ChangedAt{v3.20}{\Package{tocbasic}} can have
- additional side effects if you use entry style \PValue{tocline}. See style
- attribute \Option{breakafternumber} and \Option{entrynumberformat} in
- \autoref{tab:tocbasic.tocstyle.attributes} from
- \autopageref{tab:tocbasic.tocstyle.attributes} downwards.
-
- \KOMAScript{} classes set this feature for the file name extensions of the
- owner \PValue{float} if you use option
+ means that any entries made using \DescRef{\LabelBase.cmd.addxcontentsline}
+ or \DescRef{\LabelBase.cmd.addxcontentslinetoeachtocfile}, where the
+ optional argument for the number is missing or empty, will be provided with
+ an empty \DescRef{\LabelBase.cmd.numberline} command. This usually results
+ in these entries being left-aligned not with the number but with the text of
+ the numbered entries of the same level.
+ Using\ChangedAt{v3.20}{\Package{tocbasic}} the \PValue{tocline} entry style
+ can have additional side effects. See the style attribute
+ \Option{breakafternumber} and \Option{entrynumberformat} in
+ \autoref{tab:tocbasic.tocstyle.attributes} starting on
+ \autopageref{tab:tocbasic.tocstyle.attributes}.
+
+ \KOMAScript{} classes set this feature for the file extensions with the
+ owner \PValue{float} if you use the
\OptionValueRef{maincls}{listof}{numberline}%
\important{\OptionValueRef{maincls}{listof}{numberline}}%
- \IndexOption{listof~=\PValue{numberline}} and for file name extension
- \PValue{toc} if you use option \OptionValueRef{maincls}{toc}{numberline}%
+ \IndexOption{listof~=\textKValue{numberline}} option and for the file
+ extension \PValue{toc} if you use the
+ \OptionValueRef{maincls}{toc}{numberline}%
\important{\OptionValueRef{maincls}{toc}{numberline}}%
- \IndexOption{toc~=\PValue{numberline}}. Analogous they reset this feature if
- you use \OptionValueRef{maincls}{listof}{nonumberline}%
+ \IndexOption{toc~=\textKValue{numberline}} option. Similarly, this feature
+ is reset if you use \OptionValueRef{maincls}{listof}{nonumberline}%
\important{\OptionValueRef{maincls}{listof}{nonumberline}}%
- \IndexOption{listof~=\PValue{nonumberline}} or
+ \IndexOption{listof~=\textKValue{nonumberline}} or
\OptionValueRef{maincls}{toc}{nonumberline}%
\important{\OptionValueRef{maincls}{toc}{nonumberline}}%
- \IndexOption{toc~=\PValue{nonumberline}}.
+ \IndexOption{toc~=\textKValue{nonumberline}}.
\item[\texttt{onecolumn}] \leavevmode\ChangedAt{v3.01}{\Package{tocbasic}}%
- typesets the corresponding TOC with internal one column mode of
- \Macro{onecolumn}\IndexCmd{onecolumn}. This\textnote{Attention!} will be
- done only, if the corresponding table of contents or list of something does
- not use feature \PValue{leveldown}\important{\PValue{leveldown}}. The
+ means that this content list will automatically use \LaTeX's internal
+ one-column mode with \Macro{onecolumn}\IndexCmd{onecolumn}.
+ However\textnote{Attention!}, this applies only if this content list does
+ not use the \PValue{leveldown}\important{\PValue{leveldown}} feature. The
\KOMAScript{} classes \Class{scrbook} and \Class{scrreprt} activate this
feature with \DescRef{\LabelBase.cmd.AtAddToTocList} (see
\autoref{sec:tocbasic.basics}, \DescPageRef{\LabelBase.cmd.AtAddToTocList})
- for all TOCs with owner \PValue{float} or with themselves as owner. With
- this, e.\,g., the table of contents, the list of figures and the list of
- tables of both classes will be single columned automatically. The
- multiple-column-mode of package \Package{multicol}\IndexPackage{multicol}
- will not be recognised or changed by this option.
-\item[\texttt{totoc}] writes the title of the corresponding TOC to the table
- of contents. This feature will be evaluated by the internal heading
- command. On the other hand, if an user defined heading command has been made
- with \DescRef{\LabelBase.cmd.deftocheading}, that user is responsible for the evaluation of
- the feature. The \KOMAScript{} classes set this feature using option
- \OptionValueRef{maincls}{listof}{totoc}%
+ for all content lists with the owner \PValue{float} or with themselves as
+ owner. Thus, for example, the table of contents, the list of figures, and
+ the list of tables are automatically printed in a single column for both
+ these classes. The multicolumn mode of the
+ \Package{multicol}\IndexPackage{multicol} package is expressly unaffected by
+ this option.
+\item[\texttt{totoc}] means that the title of content list should be included
+ in the table of contents. This feature will be evaluated by the internal
+ heading command. However, if an user-defined heading command has been
+ created with \DescRef{\LabelBase.cmd.deftocheading}, the person defining
+ that command is responsible for evaluating this feature. The \KOMAScript{}
+ classes set this feature using the \OptionValueRef{maincls}{listof}{totoc}%
\important{\OptionValueRef{maincls}{listof}{totoc}}%
- \IndexOption{listof~=\PValue{totoc}} for all file name extensions of the
- owner \PValue{float}.
+ \IndexOption{listof~=\textKValue{totoc}} option for all file extensions with
+ the owner \PValue{float}.
\end{description}
-Classes and packages may know features, too, e.\,g, the \KOMAScript{} classes
-know following additional features:
+The \KOMAScript{} classes recognize an additional feature:
\begin{description}
-\item[\texttt{chapteratlist}] activates special code to be put into the TOC at
- start of a new chapter. This code may either be vertical space or the
- heading of the chapter. See \DescRef{maincls.option.listof}%
+\item[\texttt{chapteratlist}] ensures that an optional subdivision is added
+ to the content list for each new chapter. By default, this subdivision is a
+ vertical space. See \DescRef{maincls.option.listof}%
\IndexOption{listof}\important{\DescRef{maincls.option.listof}} in
\autoref{sec:maincls.floats}, \DescPageRef{maincls.option.listof} for more
- information about such features.
+ information about this option.
\end{description}
\begin{Example}
Because \KOMAScript{} classes use \Package{tocbasic} for the list of figures
- and list of tables, there's one more way to remove chapter structuring at
- those:
+ and list of tables, there is another way to prevent chapter subdivisions in
+ these lists:
\begin{lstcode}
\unsettoc{lof}{chapteratlist}
\unsettoc{lot}{chapteratlist}
\end{lstcode}
- And if you want to have the chapter structuring of the \KOMAScript{} classes
- at your own list of algorithms with file name \PName{extension}
- ``\PValue{loa}'' from the previous examples, you may use
+ If you want the chapter subdivisions for your own list that you have defined
+ with the file \PName{extension} ``\PValue{loa}'' to use the same subdivision
+ format used by the \KOMAScript{} classes, you can use
\begin{lstcode}
\setuptoc{loa}{chapteratlist}
\end{lstcode}
- And if classes with \DescRef{maincls.cmd.chapter} should also force single
- column mode for the list of algorithms you may use
+ And if you also want classes that use \DescRef{maincls.cmd.chapter} as the
+ top-level structure to use the one-column mode automatically, you can
+ use
\begin{lstcode}
\ifundefinedorrelax{chapter}{}{%
\setuptoc{loa}{onecolumn}%
}
\end{lstcode}
- Usage of \DescRef{scrbase.cmd.ifundefinedorrelax} presumes package
- \Package{scrbase} (see \autoref{sec:scrbase.if},
+ Using \DescRef{scrbase.cmd.ifundefinedorrelax} requires the
+ \Package{scrbase} package (see \autoref{sec:scrbase.if},
\DescPageRef{scrbase.cmd.ifundefinedorrelax}).
- It\textnote{Hint!} doesn't matter if you're package would be used with
- another class. You should never the less set this feature. And if the other
- class would also recognise the feature your package would automatically use
- the feature of that class.
+ Even\textnote{Hint!} if your package will be used with another class, it
+ does not hurt to set these features. To the contrary, if another class also
+ evaluates these features, then your package would automatically use the
+ features of that class.
\end{Example}
-As you may see, packages that use \Package{tocbasic}, already provide several
-interesting features, without the need of a lot of implementation effort. Such
-an effort would be needed only without \Package{tocbasic} and because of this,
-most packages currently lack of such features.%
+As you can see, packages that use \Package{tocbasic} already support a wide
+range of options for content lists that would otherwise require a great deal
+of effort to implement and which are therefore missing in many packages.%
\EndIndexGroup
\begin{Declaration}
\Macro{iftocfeature}\Parameter{extension}\Parameter{feature}%
- \Parameter{true-instructions}\Parameter{false-instructions}
+ \Parameter{then code}\Parameter{else code}
\end{Declaration}
-This command may be used, to test, if a \PName{feature} was set for file name
-\PName{extension}. If so the \PName{true-instructions} will be processed,
-otherwise the \PName{false-instruction} will be. This may be useful, e.\,g.,
-if you define your own heading command using
+You can use this command to test if a \PName{feature} was set for the given
+file \PName{extension}. If so the \PName{then code} will be executed,
+otherwise the \PName{else code} will be. This can be useful, for example, if
+you define your own heading command using
\DescRef{\LabelBase.cmd.deftocheading} but want to support the features
\PValue{totoc}, \PValue{numbered} or \PValue{leveldown}.%
\EndIndexGroup
-\section{Configuration of Entries to a Table or List of Contents}
+\section{Configuring Content-List Entries}
\seclabel{tocstyle}%
\BeginIndexGroup
\BeginIndex{}{table of contents>entry}%
\Index{list of contents|\see{table of contents}}
-
-Since\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} version~3.20 package
-\Package{tocbasic} can not only configure the tables or lists of contents and
-their auxiliary files but also influence their entries. To do so, you can
-define new styles or you can use and configure one of the predefined
-styles. In the medium term \Package{tocbasic} will replace the experimental
-package \Package{tocstyle} that never became an official part of the
-\KOMAScript{} bundle. The \KOMAScript{} classes intensively use the TOC-entry
-styles of \Package{tocbasic} since version~3.20.
-
+Since\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} version~3.20, the
+\Package{tocbasic} package has been able not only to configure the tables or
+lists of contents and their auxiliary files but also to influence their
+entries. To do so, you can define new styles or you can use and configure one
+of the predefined styles. In the medium term, \Package{tocbasic} will replace
+the experimental \Package{tocstyle} package that never became an official part
+of the \KOMAScript{} bundle. The \KOMAScript{} classes themselves have relied
+completely on the \Package{tocbasic} entry styles since version~3.20.
\begin{Declaration}
\Counter{tocdepth}
\end{Declaration}
-Entries to tables or lists of contents are in hierarchical order. Therefore
-each entry level has a numerical value. Higher values correspond with deeper
-levels. Within the standard classes, e.\,g., parts have the numerical entry
-level -1 in the table of contents and chapter entries have value 0. Counter
-\Counter{tocdepth} defines the deepest level that should be shown in the
-tables and lists of any contents.
-
-Class \Class{book} sets \Counter{tocdepth} to 2, so entries of the levels
-\PValue{part}, \PValue{chapter}, \PValue{section}, and \PValue{subsection} are
-printed. Deeper levels like \PValue{subsubsection}, which has the numerical
-value 3, are not printed. Nevertheless the entries are part of the auxiliary
-file for the table of contents.
-
-Most entry styles of \Package{tocbasic} also cares about
-\Counter{tocdepth}. Only style \PValue{gobble} (see
-\DescRef{\LabelBase.cmd.DeclareTOCStyleEntry}\iffree{}{, later in this
- section}) ignores \Counter{tocdepth}.
-%
+Entries to content lists are usually hierarchical. For this purpose, each
+entry level has a numerical value. The higher this value, the lower in the
+hierarchy is this level. In the standard classes, for example, parts have the
+level -1 and chapters have the value 0. The \LaTeX{} counter
+\Counter{tocdepth} determines the deepest level that should be shown in the
+table of contents and other content lists.
+
+For example, the \Class{book} class sets \Counter{tocdepth} to 2, so entries
+of the levels \PValue{part}, \PValue{chapter}, \PValue{section}, and
+\PValue{subsection} are printed. Deeper levels like \PValue{subsubsection},
+which has the numerical value 3, are not printed. Nevertheless the entries are
+part of the auxiliary file for the table of contents.
+
+Note that most \Package{tocbasic} entry styles, with the exception of
+\PValue{gobble} (see \DescRef{\LabelBase.cmd.DeclareTOCStyleEntry}\iffree{}{,
+later in this section}) observe \Counter{tocdepth}.%
\EndIndexGroup
@@ -802,26 +839,24 @@ Most entry styles of \Package{tocbasic} also cares about
\Macro{numberline}\Parameter{entry number}%
\Macro{usetocbasicnumberline}\OParameter{code}
\end{Declaration}
-Though\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} the \LaTeX{} kernel
-already defines command \Macro{numberline}, the kernel definition is not
-sufficient for \Package{tocbasic}. Therefore \Package{tocbasic} has its own
-definition of \Macro{numberline}. The package uses
-\Macro{usetocbasicnumberline} to activate this definition whenever a TOC-entry
-needs it. Because of this, re-defining \Macro{numberline} often does not work
-and even may result in warnings if you use \Package{tocbasic}.
-
-You can use the definition of \Package{tocbasic} putting
+Although\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} the \LaTeX{} kernel
+already defines a \Macro{numberline} command, the definition is not sufficient
+for \Package{tocbasic}. Therefore \Package{tocbasic} defines its own commands
+and sets \Macro{numberline} as needed using \Macro{usetocbasicnumberline} for
+each content-list entry. Redefining \Macro{numberline}, therefore, is often
+ineffective and may result in warnings if you use \Package{tocbasic}.
+
+You can use the definition of \Package{tocbasic} by putting
\Macro{usetocbasicnumberline} into your document's preamble. The command first
-of all checks, whether or not the current definition of \Macro{numberline}
-uses essential, internal commands of \Package{tocbasic}. Only if this is not
-the case \Macro{usetocbasicnumberline} redefines \Macro{numberline} and
-executes \PName{code}. If you omit the optional argument, a
-\Macro{PackageInfo} outputs a message about the successful re-definition. If
+checks if the current definition of \Macro{numberline}
+uses certain important, internal commands of \Package{tocbasic}. If this is not
+the case, \Macro{usetocbasicnumberline} redefines \Macro{numberline} and
+executes \PName{code}. If you omit the optional argument, it issues
+a message about the redefinition with \Macro{PackageInfo}. If
you just do not want such a message, use an empty optional argument.
-Please note\textnote{Attention!}, as a side effect
-\Macro{usetocbasicnumberline} can globally change the internal switch
-\Macro{@tempswa}!%
+Note\textnote{Attention!} that \Macro{usetocbasicnumberline} can change the
+internal switch \Macro{@tempswa} globally!%
\EndIndexGroup
@@ -829,34 +864,34 @@ Please note\textnote{Attention!}, as a side effect
\Macro{DeclareTOCStyleEntry}\OParameter{option list}\Parameter{style}%
\Parameter{entry level}
\end{Declaration}
-This\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} command is used to define
-or configure the TOC-entries of a given \PName{entry level}. Argument
-\PName{entry level} is a symbolic name, e.\,g., \PValue{section} for the entry
-to the table of contents of the section level with the same name or
+This\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} command defines or
+configures the content-list entries of a given \PName{entry level}. The
+\PName{entry level} argument is a symbolic name, e.\,g. \PValue{section}, for
+the entry to the table of contents of the section level with the same name or
\PValue{figure} for an entry of a figure to the list of figures. A
\PName{style} is assigned to each \PName{entry level}. The \PName{style} has
-to be defined before using it as an argument of
-\Macro{DeclareTOCStyleEntry}. The \PName{option list} is used to configure
-several \PName{style}-dependent attributes of the \PName{entry level}.
+to be defined before using it as an argument of \Macro{DeclareTOCStyleEntry}.
+You can use the \PName{option list} to configure the various, usually
+\PName{style}-dependent, attributes of the entries.
Currently, \Package{tocbasic} defines the following entry styles:
\begin{description}
-\item[\PValue{default}] defaults to a clone of style
- \PValue{dottedtocline}. It is recommended to class authors, who use
- \Package{tocbasic}, to change this style into the default style of the class
- using \Macro{CloneTOCStyle}. For example the \KOMAScript{} classes change
+\item[\PValue{default}] defaults to a clone of the \PValue{dottedtocline}
+ style. Class authors who use \Package{tocbasic} are encouraged to change
+ this style to the default content-list style of the class using
+ \Macro{CloneTOCStyle}. For example the \KOMAScript{} classes change
\PValue{default} into a clone of \PValue{tocline}.
\item[\PValue{dottedtocline}] is similar to the style used by the standard
classes \Class{book} and \Class{report} for the \PValue{section} down to
\PValue{subparagraph} entry levels of the table of contents and for the
entries at the list of figures or list of tables. It supports the attributes
- \PValue{level}, \PValue{indent}, and \PValue{numwidth}. The entries will be
+ \PValue{level}, \PValue{indent}, and \PValue{numwidth}. The entries are
indented by the value of \PValue{indent} from the left. The width of the
- entry number is given by the value of \PValue{numwidth}. For multiline
- entries the indent will be increased by the value of \PValue{numwidth} for
+ entry number is given by the value of \PValue{numwidth}. For multi-line
+ entries, the indent will be increased by the value of \PValue{numwidth} for
the second and following lines. The page number is printed using
- \Macro{normalfont}\IndexCmd{normalfont}. Entry text and page number are
- connected by a dotted line. \hyperref[fig:tocbasic.dottedtocline]%
+ \Macro{normalfont}\IndexCmd{normalfont}. The entry text and the page number
+ are connected by a dotted line. \hyperref[fig:tocbasic.dottedtocline]%
{Figure~\ref*{fig:tocbasic.dottedtocline}} illustrates the attributes of
this style.
\begin{figure}
@@ -873,8 +908,8 @@ Currently, \Package{tocbasic} defines the following entry styles:
\setlength{\parindent}{-3.2em}%
\addtolength{\parfillskip}{-2.55em}%
\makebox[3.2em][l]{1.1.10}%
- Text of an entry to the table of contents with style
- \PValue{dottedtocline} and more than one line%
+ Text of an entry in the table of contents with the
+ \PValue{dottedtocline} style and more than one line%
\leaders\hbox{$\csname m@th\endcsname
\mkern 4.5mu\hbox{.}\mkern 4.5mu$}\hfill\nobreak
\makebox[1.55em][r]{12}%
@@ -902,40 +937,40 @@ Currently, \Package{tocbasic} defines the following entry styles:
(\linewidth-1.55em,-\baselineskip);
\end{tikzpicture}%
}
- \caption{Illustrations of some attributes of a TOC-entry with style
- \PValue{dottedtocline}}
+ \caption{Illustrations of some attributes of a TOC entry with the
+ \PValue{dottedtocline} style}
\label{fig:tocbasic.dottedtocline}
\end{figure}
-\item[\PValue{gobble}] is the most ordinary style. Independently from the
- setting of \DescRef{\LabelBase.counter.tocdepth}%
+\item[\PValue{gobble}] is the simplest possible style. Entries in this style,
+ regardless of the setting of \DescRef{\LabelBase.counter.tocdepth}%
\IndexCounter{tocdepth}\important{\DescRef{\LabelBase.counter.tocdepth}},
- entries with this style will never be printed. The style simply gobbles the
- entries. Nevertheless, it supports the standard attribute \PValue{level} but
- does ignore it.
+ will never be printed. The style simply gobbles the
+ entries, so to speak. It has the default \PValue{level} attribute, but
+ it is never evaluated.
\item[\PValue{largetocline}] is similar to the style used by the standard
- classes for the level \PValue{part}. It supports attributes \PValue{level}
- and \PValue{indent} only. The last one is already a variation of the
- standard classes that do not support an indent of the \PValue{part} entries.
-
- Before an entry a page break will be made easier. The entries will be
- indented by the value of \PValue{indent} from the left. They are printed
- using \Macro{large}\Macro{bfseries}. If \DescRef{\LabelBase.cmd.numberline}
- is used, the number width is 3\Unit{em}. \DescRef{\LabelBase.cmd.numberline}
- is not redefined. The standard classes do not use
- \DescRef{\LabelBase.cmd.numberline} for \PName{part} entries. The value of
- \PName{indent} even does not influence the indent from the second line of an
- entry.
+ classes for the \PValue{part} level. It supports the \PValue{level} and
+ \PValue{indent} attributes only. The latter deviates from the standard
+ classes, which do not support an indent of the \PValue{part} entries.
+
+ A penalty is set to permit page breaks before an entry of an appropriate
+ level. The entries will be indented by the value of \PValue{indent} from the
+ left and printed with the font style \Macro{large}\Macro{bfseries}. If
+ \DescRef{\LabelBase.cmd.numberline} is used, the number width is 3\Unit{em}.
+ \DescRef{\LabelBase.cmd.numberline} is not redefined. The standard classes
+ do not use \DescRef{\LabelBase.cmd.numberline} for \PName{part} entries. The
+ value of \PName{indent} also has no effect on the indentation from the
+ second line and after in a multi-line entry.
\hyperref[fig:tocbasic.largetocline]%
- {Figure~\ref*{fig:tocbasic.largetocline}} illustrates the attributes of this
- style. There you can also see that the style copies inconsistencies of the
- standard classes, e.\,g. the missing indent of the second and following
- lines of an entry or the different values of \Macro{@pnumwidth} that results
- from the font size dependency. This can even result in a to small distance
- between the entry text and the page number. Please note, the entry number
- width shown in the figure is only valid if
- \DescRef{\LabelBase.cmd.numberline} has been used. In contrast, the standard
- classes use a distance of 1\Unit{em} after the number.
+ {Figure~\ref*{fig:tocbasic.largetocline}} illustrates the characteristics of
+ this style. You will also notice that the style has adopted some
+ inconsistencies present in the standard classes, e.\,g. the missing indent
+ of the second and following lines of an entry or the different values of
+ \Macro{@pnumwidth} that results from the font-size dependency. This can
+ result, in extreme cases, in the entry text coming too close. Note that the
+ width of the entry number shown in the figure is only valid if
+ \DescRef{\LabelBase.cmd.numberline} has been used. The standard classes,
+ however, use a distance of 1\Unit{em} after the number.
\begin{figure}
\centering
\resizebox{.8\linewidth}{!}{%
@@ -947,8 +982,8 @@ Currently, \Package{tocbasic} defines the following entry styles:
\parbox[t]{\dimexpr \linewidth-1.55em\relax}{%
\makebox[3em][l]{\large\bfseries I}%
\large\bfseries
- Text of an entry to the table of contents with style
- \PValue{largetocline} and more than one line%
+ Text of an entry to the table of contents with the
+ \PValue{largetocline} style and more than one line%
\hfill
\makebox[0pt][l]{\normalsize\normalfont
\makebox[1.55em][r]{\large\bfseries 1}}%
@@ -968,39 +1003,42 @@ Currently, \Package{tocbasic} defines the following entry styles:
(\linewidth-1.55em,-\baselineskip);
\end{tikzpicture}%
}
- \caption{Illustrations of some attributes of a TOC-entry with style
+ \caption{Illustrations of some attributes of a TOC entry with style
\PValue{largetocline}}
\label{fig:tocbasic.largetocline}
\end{figure}
-\item[\PValue{tocline}] is a very flexible style. The \KOMAScript{} classes
- use this style by default for all kinds of entries. Classes \Class{scrbook}
- and \Class{scrreprt} respectively \Class{scrartcl} also define
- clones \PValue{part}, \PValue{chapter} and \PValue{section} respectively
- \PValue{section} and \PValue{subsection}, but add extra
+\item[\PValue{tocline}] is a flexible style. The \KOMAScript{} classes use
+ this style by default for all kinds of entries. Likewise, these classes
+ define the clones \PValue{part}, \PValue{chapter}, and \PValue{section}, or
+ \PValue{section} and \PValue{subsection} using this style, but add extra
\PName{initial code} to the clones to change their defaults.
- The style supports attributes \PValue{level}, \PValue{beforeskip},
- \PValue{dynnumwidth}, \PValue{entryformat}, \PValue{entrynumberformat},
- \PValue{breakafternumber}, \PValue{indent}, \PValue{linefill},
- \PValue{numsep}, \PValue{numwidth}, \PValue{onstarthigherlevel},
- \PValue{onstartlowerlevel}, \PValue{onstartsamelevel},
- \PValue{pagenumberbox}, \PValue{pagenumberformat}, \PValue{raggedentrytext},
- and \PValue{raggedpagenumber}. The defaults of all these attributes depend
- on the name of the \PName{entry level}. They correspond to the results of
- the standard classes. So after loading \Package{tocbasic}, you can change
- the style of the standard classes entries to the table of contents into
- \PValue{tocline} using \DescRef{\LabelBase.cmd.DeclareTOCEntryStyle} without obvious visual
- changes unless you change exactly these attributes that should induce such
- changes. Same is valid for list of figures or list of tables of the standard
+ The style supports 16\important{\PValue{level}, \PValue{beforeskip},
+ \PValue{breakafternumber}, \PValue{dynnumwidth}, \PValue{entryformat},
+ \PValue{entrynumberformat}, \PValue{indent}, \PValue{linefill},
+ \PValue{numsep}, \PValue{numwidth}, \PValue{onstarthigherlevel},
+ \PValue{onstartlowerlevel}, \PValue{onstartsamelevel},
+ \PValue{pagenumberbox}, \PValue{pagenumberformat},
+ \PValue{raggedentrytext}, \PValue{raggedpagenumber}} additional attributes
+ in addition to the default \PValue{level} attribute. The defaults of all
+ these attributes depend on the name of the \PName{entry level} and
+ correspond to the results of the standard classes. So after loading
+ \Package{tocbasic}, you can change the style of the entries in the table of
+ contents of the standard classes into \PValue{tocline} using
+ \DescRef{\LabelBase.cmd.DeclareTOCEntryStyle} without this leading directly
+ to major changes in their appearance. Thus you can precisely change only
+ those attributes that are necessary for the desired changes. The same
+ applies to the list of figures and the list of tables for the standard
classes.
- Because of the flexibility of this style it even could be used instead of
- the styles \PValue{dottedtocline}, \PValue{undottedtocline} or
- \PValue{largetocline}. However it needs more effort for configuration.
+ Because its great flexibility, this style can in principle replace the
+ \PValue{dottedtocline}, \PValue{undottedtocline}, and \PValue{largetocline}
+ styles, but this requires more effort to configure.
+ \hyperref[fig:tocbasic.tocline]%
{Figure~\ref*{fig:tocbasic.tocline}} illustrates some of the length
- attributes of this style. All attributes are described in
- \autoref{tab:tocbasic.tocstyle.attributes} from
+ attributes of this style. The others are explained in
+ \autoref{tab:tocbasic.tocstyle.attributes} starting on
\autopageref{tab:tocbasic.tocstyle.attributes}.
\begin{figure}
\centering
@@ -1027,8 +1065,8 @@ Currently, \Package{tocbasic} defines the following entry styles:
\setlength{\parindent}{-3em}%
\addtolength{\parfillskip}{-2.55em}%
\makebox[3em][l]{\large\bfseries I.}%
- \textbf{\large Text of a part entry with style
- \PValue{tocline} and with at least two lines of text}%
+ \textbf{\large Text of a part entry with the
+ \PValue{tocline} style and at least two lines of text}%
\hfill
\makebox[1.55em][r]{\bfseries 12}\large
}%
@@ -1058,9 +1096,9 @@ Currently, \Package{tocbasic} defines the following entry styles:
\setlength{\parindent}{-1.5em}%
\addtolength{\parfillskip}{-2.55em}%
\makebox[1.5em][l]{\bfseries 1.}%
- \textbf{Text of a chapter entry with style
- \PValue{tocline} and for demonstration purpose with more than one
- line of text}%
+ \textbf{Text of a chapter entry with the
+ \PValue{tocline} style and more than one line of text
+ for demonstration purposes}%
\hfill
\makebox[1.55em][r]{\bfseries 12}%
}%
@@ -1096,9 +1134,9 @@ Currently, \Package{tocbasic} defines the following entry styles:
\setlength{\parindent}{-2.3em}%
\addtolength{\parfillskip}{-2.55em}%
\makebox[2.3em][l]{1.1.}%
- Text of a section entry with style
- \PValue{tocline} and for demonstration purpose with more than one
- line of text%
+ Text of a section entry with the \PValue{tocline}
+ style and more than one line of text for
+ demonstration purposes%
\leaders\hbox{$\csname m@th\endcsname
\mkern 4.5mu\hbox{.}\mkern 4.5mu$}\hfill\nobreak
\makebox[1.55em][r]{3}%
@@ -1111,9 +1149,9 @@ Currently, \Package{tocbasic} defines the following entry styles:
\setlength{\parindent}{-3.2em}%
\addtolength{\parfillskip}{-2.55em}%
\makebox[3.2em][l]{1.1.10.}%
- Text of a subsection entry with style
- \PValue{tocline} and for demonstration purpose with more than one
- line of text%
+ Text of a subsection entry with the \PValue{tocline}
+ and more than one line of text for demonstration
+ purposes%
\leaders\hbox{$\csname m@th\endcsname
\mkern 4.5mu\hbox{.}\mkern 4.5mu$}\hfill\nobreak
\makebox[1.55em][r]{12}%
@@ -1145,24 +1183,23 @@ Currently, \Package{tocbasic} defines the following entry styles:
($(subsection)+(\linewidth-1.55em,-\baselineskip)$);
\end{tikzpicture}%
}
- \caption{Illustrations of some attributes of a TOC-entry with style
- \PValue{tocline}}
+ \caption{Illustrations of some attributes of a TOC entry with the
+ \PValue{tocline} style}
\label{fig:tocbasic.tocline}
\end{figure}
\item[\PValue{undottedtocline}] is similar to the style used by the standard
- classes \Class{book} and \Class{report} for the \PValue{chapter} entry level
- or by \Class{article} for the \PValue{section} entry level of the table of
- contents. It supports the attributes \PValue{level}, \PValue{indent}, and
- \PValue{numwidth}. The last one is already a variation of the standard
- classes that do not support an indent of these entry levels.
-
- Before an entry, a page break will be made easier. The entries will be
- indented by the value of \PValue{indent} from the left. They are printed
- using \Macro{bfseries}. \DescRef{\LabelBase.cmd.numberline} is used
- unchanged. The width of the entry number is given by the value of
- \PValue{numwidth}. For multiline entries the indent will be increased by the
- value of \PValue{numwidth} for the second and following
- lines. \hyperref[fig:tocbasic.undottedtocline]%
+ \Class{book} and \Class{report} classes for the \PValue{chapter} entry
+ level, or by \Class{article} for the \PValue{section} entry level in the
+ table of contents. It supports\important{\PValue{level}, \PValue{indent},
+ \PValue{numwidth}} only three attributes. A penalty is inserted permitting
+ an appropriate page break before the entry, as is a vertical skip. The
+ entries are printed with an indentation of \PValue{indent} from the left and
+ in \Macro{bfseries}. This is a departure from the standard classes, which do
+ not support the indentation of these entry levels.
+ \DescRef{\LabelBase.cmd.numberline} is used unchanged. The width of the
+ entry number is determined by \PValue{numwidth}. For multi-line entries the
+ indent will be increased by the value of \PValue{numwidth} for the second
+ and following lines. \hyperref[fig:tocbasic.undottedtocline]%
{Figure~\ref*{fig:tocbasic.undottedtocline}} illustrates the attributes of
this style.
\begin{figure}
@@ -1177,8 +1214,8 @@ Currently, \Package{tocbasic} defines the following entry styles:
\makebox[1.5em][l]{\bfseries 1}%
\parbox[t]{\dimexpr \linewidth-4.05em\relax}{%
\bfseries
- Text of an entry to the table of contents with style
- \PValue{undottedtocline} and more than one line%
+ Text of an entry to the table of contents with the
+ \PValue{undottedtocline} style and more than one line%
}%
\raisebox{-\baselineskip}{\makebox[2.55em][r]{\bfseries 3}}%
};
@@ -1199,93 +1236,94 @@ Currently, \Package{tocbasic} defines the following entry styles:
(\linewidth-1.55em,-\baselineskip);
\end{tikzpicture}%
}
- \caption{Illustration of some attributes of style \PValue{undottedtocline}
- by the example of a chapter title}%
+ \caption{Illustration of some attributes of the \PValue{undottedtocline}
+ style with the example of a chapter title}%
\label{fig:tocbasic.undottedtocline}
\end{figure}
\end{description}
-\hyperref[tab:tocbasic.tocstyle.attributes]%
-{Table~\ref*{tab:tocbasic.tocstyle.attributes}} describes all attributes of
-all styles defined by
-\Package{tocbasic}. If\ChangedAt[2016/06]{v3.21}{\Package{tocbasic}} you want
-to use these attributes as options to \DescRef{\LabelBase.cmd.DeclareNewTOC}
-(see \DescPageRef{\LabelBase.cmd.DeclareNewTOC}) you have to prefix the names
-of the attribute by \PValue{tocentry}, e\,g., attribute \PValue{level} becomes
-option \Option{tocentrylevel}.
-If\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}} you want to use these
-attributes as options to \DescRef{maincls-experts.cmd.DeclareSectionCommand}
-(see \DescPageRef{maincls-experts.cmd.DeclareSectionCommand}) and similar
-commands you have to prefix the names of the attributes by \PValue{toc},
-e\,g., attribute \PValue{level} becomes option \Option{toclevel}.
-
-Last but not least using \Macro{DeclareTOCStyleEntry} will define internal
-command \Macro{l@\PName{entry level}}.
+You can find an explanation of the attributes of all styles that
+\Package{tocbasic} defines in \autoref{tab:tocbasic.tocstyle.attributes}.
+If\ChangedAt[2016/06]{v3.21}{\Package{tocbasic}} you use these attributes as
+options to \DescRef{\LabelBase.cmd.DeclareNewTOC} (see
+\DescPageRef{\LabelBase.cmd.DeclareNewTOC}), you must prefix the names of the
+attribute by \PValue{tocentry}, e\,g. \PValue{level} becomes
+\Option{tocentrylevel}. If\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}} use
+these attributes as options for
+\DescRef{maincls-experts.cmd.DeclareSectionCommand}%
+\IndexCmd{DeclareSectionCommand}\IndexCmd{DeclareNewSectionCommand}%
+\IndexCmd{RedeclareSectionCommand}\IndexCmd{ProvideSectionCommand} (see
+\DescPageRef{maincls-experts.cmd.DeclareSectionCommand}) and similar commands,
+you must prefix the names of the attributes with \PValue{toc}, e\,g.
+\PValue{level} becomes \Option{toclevel}.
+
+Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command
+\Macro{l@\PName{entry level}}.
\begin{desclist}
\desccaption{%
Attributes of the predefined TOC-entry styles of \Package{tocbasic}%
\label{tab:tocbasic.tocstyle.attributes}%
}{%
- Attributes of the TOC-entry styles (\emph{continuation})%
+ Attributes of the TOC-entry styles (\emph{continued})%
}%
\entry{\OptionVName{beforeskip}{length}}{%
- vertical distance, inserted before an entry of this level using style
- \PValue{tocline} (see \autoref{fig:tocbasic.tocline}). The distance is
- made using either \Macro{vskip} or \Macro{addvspace} depending on the
- \PName{entry level} to adapt the differences of the standard classes and
- former versions of \KOMAScript.
-
- At \PName{entry level} \PValue{part} the attribute will be initialised
- with \texttt{2.25em plus 1pt}, at \PValue{chapter} with \texttt{1em plus
- 1pt}. If \PName{entry level} currently is unknown, rather
- \PValue{section} is initialised with \texttt{1em plus 1pt}. The initial
- value for all other levels is \texttt{0pt plus .2pt}.%
+ The vertical distance inserted before an entry of this level in the
+ \PValue{tocline} style (see \autoref{fig:tocbasic.tocline}). The distance
+ is made using either \Macro{vskip} or \Macro{addvspace} depending on the
+ \PName{entry level}, to maintain compatibility as far as possible with the
+ standard classes and earlier versions of \KOMAScript.
+
+ For the \PValue{part} \PName{entry level}, the attribute will be
+ initialised with \texttt{2.25em plus 1pt}; for \PValue{chapter}, with
+ \texttt{1em plus 1pt}. If the \PName{chapter} \PName{entry level} is
+ undefined, \PValue{section} is initialised with \texttt{1em plus 1pt}
+ instead. The initial value for all other levels is \texttt{0pt plus
+ .2pt}.%
}%
\entry{\OptionVName{breakafternumber}{switch}}{%
\PName{switch} is one of the values for simple switches from
\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. If the
- switch is active with style \PValue{tocline}, there will be a line break
- after the entry number of
+ switch is active in the \PValue{tocline} style, there will be a line break
+ after the number set with
\DescRef{\LabelBase.cmd.numberline}\IndexCmd{numberline}. The line after
- the entry number again starts left aligned with the number.
-
- This switch is not active by default at style \PValue{tocline}.
+ the entry number again starts flush left with the number. The default is
+ false for the \PValue{tocline} style.
- If\textnote{Attention!} the feature \Option{numberline} of a list of
- something has been activated (see \DescRef{\LabelBase.cmd.setuptoc},
- \autoref{sec:tocbasic.toc}, \DescPageRef{\LabelBase.cmd.setuptoc}), i.\,e.,
- if a \KOMAScript{} class with option
+ If\textnote{Attention!} the \Option{numberline} feature has been activated
+ for a content list (see \DescRef{\LabelBase.cmd.setuptoc},
+ \autoref{sec:tocbasic.toc}, \DescPageRef{\LabelBase.cmd.setuptoc}), as is
+ the case with the \KOMAScript{} classes when the
\OptionValueRef{maincls}{toc}{numberline}%
- \IndexOption{toc~=\PValue{numberline}} is used, then the not numbered
- entries will nevertheless have a (by default empty) number line using the
- format code of \Option{entrynumberformat}.%
+ \IndexOption{toc~=\textKValue{numberline}} option is used, then the
+ unnumbered entries will nevertheless have a (by default empty) number line
+ using the formatting of \Option{entrynumberformat}.%
}%
\entry{\OptionVName{dynnumwidth}{switch}}{%
\PName{switch} is one of the values for simple switches from
\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. If the
- switch is active with style \PValue{tocline}, attribute \PValue{numwidth}
- will become a minimum value. If the maximum number width detected at the
- previous \LaTeX{} run increased by the value of \PValue{numsep} is greater
- than this minimum the calculated value will be used.%
+ switch is active with the \PValue{tocline} style, the \PValue{numwidth}
+ attribute specifies a minimum value. If a previous \LaTeX{} run has
+ determined that the maximum width of the entry numbers of the same level
+ plus the value of \PValue{numsep} is greater than this minimum, the
+ calculated value will be used instead.%
}%
\entry{\OptionVName{entryformat}{command}}{%
- This attributes makes the format of the entry. The value should be a
- \PName{command} with exactly one argument. The \PName{command} should not
- expect the argument to be fully expandable. Commands like
- \Macro{MakeUppercase}, that need a fully expandable argument, must no be
- used here. Font changes are allowed and are relative to
- \Macro{normalfont}\Macro{normalsize}. Please note that the output of
- \Option{linefill} and the page number are independent from
- \Option{entryformat}. See also attribute \Option{pagenumberformat}.
-
- The initial value of the attribute for \PName{entry level} \PValue{part}
- is printing the argument in \Macro{large}\Macro{bfseries} and for
- \PValue{chapter} printing the argument in \Macro{bfseries}. If currently
- no level \PValue{chapter} exists, \PValue{section} used
- \Macro{bfseries}. All other levels print the argument unchanged.%
+ You can use this attributes to change the format of the entry. The value
+ should be a \PName{command} with exactly one argument. This argument is
+ not necessarily fully expandable. You should not use commands like
+ \Macro{MakeUppercase}, which expects a fully expandable argument. Font
+ changes are relative to \Macro{normalfont}\Macro{normalsize}. Note that
+ the output of \Option{linefill} and the page number are independent of
+ \Option{entryformat}. See also the \Option{pagenumberformat} attribute .
+
+ The initial value of the attribute for the \PValue{part} \PName{entry
+ level} is \Macro{large}\Macro{bfseries}, and for \PValue{chapter}, it is
+ \Macro{bfseries}. If the \PValue{chapter} level is not defined,
+ \PValue{section} uses \Macro{bfseries}. All other levels print the
+ argument unchanged.%
}%
\entry{\OptionVName{entrynumberformat}{command}}{%
- This attribute makes the format of the entry number within
+ You can use this attribute to format the entry number within
\DescRef{\LabelBase.cmd.numberline}. The value should be a \PName{command}
with exactly one argument. Font changes are relative to the one of
attribute \Option{entryformat}.
@@ -1293,135 +1331,148 @@ command \Macro{l@\PName{entry level}}.
The initial \PName{command} prints the argument unchanged. This means the
entry number will be printed as it is.
- If\textnote{Attention!} the feature \Option{numberline} of a list of
- something has been activated (see \DescRef{\LabelBase.cmd.setuptoc},
- \autoref{sec:tocbasic.toc}, \DescPageRef{\LabelBase.cmd.setuptoc}), i.\,e.,
- if a \KOMAScript{} class with option
+ If\textnote{Attention!} the \Option{numberline} feature for a content list
+ has been activated (see \DescRef{\LabelBase.cmd.setuptoc},
+ \autoref{sec:tocbasic.toc}, \DescPageRef{\LabelBase.cmd.setuptoc}), as is
+ the case with the \KOMAScript{} classes using the
\OptionValueRef{maincls}{toc}{numberline}%
- \IndexOption{toc~=\PValue{numberline}}
- is used, then the not numbered entries will nevertheless execute the
- \PName{command}.%
+ \IndexOption{toc~=\textKValue{numberline}} option, the unnumbered entries
+ will execute the \PName{command} as well.%
}%
\entry{\OptionVName{indent}{length}}{%
- Horizontal distance of the entry relative to the left margin (siehe
+ The horizontal distance of the entry from the left margin (see
\autoref{fig:tocbasic.dottedtocline} and \autoref{fig:tocbasic.tocline}).
- At style \PValue{tocline} all entry levels with a name that starts with
- ``\texttt{sub}'' are initialised with the sum of the values of
- \PValue{indent} and \PValue{numwidth} of the entry level without this
- prefix. At styles \PValue{dottedtocline}, \PValue{undottedtocline} and
- \PValue{tocline} the initial values of levels \PValue{part} down to
- \PValue{subparagraph} and the levels \PValue{figure} and \PValue{table}
- are compatible with the standard classes. All other levels do not have an
- initial value. Therefore you have to set an explicit value for such levels
- when they are defined first time.%
+ For the \PValue{tocline} style, all entry levels whose names start with
+ ``\texttt{sub}'' are initialised with the
+ \PValue{indent}+\PValue{numwidth} of the entry level of the same name
+ without this prefix. For the \PValue{dottedtocline},
+ \PValue{undottedtocline}, and \PValue{tocline} styles, the initial values
+ of levels \PValue{part} down to \PValue{subparagraph} and the levels
+ \PValue{figure} and \PValue{table} are compatible with the standard
+ classes. All other levels do not have an initial value. Therefore you have
+ to set an explicit value for such levels when they are defined first
+ time.%
}%
\entry{\OptionVName{level}{integer}}{%
- The numerical value of the \PName{entry level}. Only those entries are
- printed that have a numerical value less or equal to counter
+ The numerical value of the \PName{entry level}. Only those entries whose
+ numerical value is less than or equal to the
\DescRef{\LabelBase.counter.tocdepth}%
- \important{\DescRef{\LabelBase.counter.tocdepth}}\IndexCounter{tocdepth}.
+ \important{\DescRef{\LabelBase.counter.tocdepth}}\IndexCounter{tocdepth}
+ counter are printed.
This attribute is mandatory for all styles and will be defined
- automatically at the declaration of the style.
-
- At style \PValue{tocline} all entry levels with a name starting with
- ``\texttt{sub}'', the initial value is the level value of the entry level
- without this prefix increased by one. At the styles
- \PValue{dottedtocline}, \PValue{largetocline}, \PValue{tocline}, and
- \PValue{undottedtocline} entry levels \PValue{part} down to
- \PValue{subparagraph}, \PValue{figure}, and \PValue{table} are initialised
- compatible with the standard classes. For all other levels the
+ automatically when the style is declared.
+
+ For the \PValue{tocline} style, all entry levels whose name starts with
+ ``\texttt{sub}'' are initialised with the value of the entry level of the
+ same name without this prefix plus one. For the \PValue{dottedtocline},
+ \PValue{largetocline}, \PValue{tocline}, and \PValue{undottedtocline}
+ styles, the entry levels from \PValue{part} to \PValue{subparagraph}, as
+ well as \PValue{figure} and \PValue{table}, are initialised to be
+ compatible with the standard classes. For all other levels, the
initialisation is done with the value of \Macro{\PName{entry
- level}numdepth} if this is defined.%
+ level}numdepth}, if this is defined.%
}%
\entry{\OptionVName{linefill}{code}}{%
- At style \PValue{tocline} there can be a filler between the end of the
- entry text and the page number. The value of attribute \PName{linefill} is
- a \PName{code} that prints this filler. For \PName{entry level}
- \PValue{part} and \PValue{chapter} the attribute is initialised with
- \Macro{hfill}. If currently no \PName{entry level} \PValue{chapter} has
- been defined, \PValue{section} also uses \Macro{hfill}. All other entry
- levels are initialised with \DescRef{\LabelBase.cmd.TOCLineLeaderFill} (see
+ With the \PValue{tocline} style, you can change what is used to fill the
+ space between the end of the entry text and the page number. The
+ \PName{linefill} attribute contains the \PName{code} that prints this
+ filler. For the \PValue{part} and \PValue{chapter} \PName{entry level}s,
+ the attribute is initialised with \Macro{hfill}. If no \PValue{chapter}
+ \PName{entry level} has been defined, \PValue{section} also uses
+ \Macro{hfill}. All other entry levels are initialised with
+ \DescRef{\LabelBase.cmd.TOCLineLeaderFill} (see
\DescPageRef{\LabelBase.cmd.TOCLineLeaderFill}).
- If \PName{code} does not result in filling the distance, you should also
- activate attribute \PValue{raggedpagenumber}, to avoid ``\texttt{underfull
- \Macro{hbox}}'' messages.%
+ Incidentally, if the \PName{code} specified does not automatically fill
+ the gap, you should also activate the \PValue{raggedpagenumber} attribute
+ to avoid ``\texttt{underfull \Macro{hbox}}'' messages.%
}%
\entry{\OptionVName{numsep}{length}}{%
- Style \PValue{tocline} tries to ensure a minimum distance of
+ The \PValue{tocline} style tries to ensure a minimum distance of
\PName{length} between the entry number and the entry text. If
\PValue{dynnumwidth} is active, it will correct the number width to achieve
- this. Otherwise it simply throws a warning, if the condition is missed.
+ this. Otherwise it simply throws a warning, if the condition is not met.
The initial \PName{length} is 0.4\Unit{em}.%
}%
\entry{\OptionVName{numwidth}{length}}{%
- The reserved width for the entry number (see
- \autoref{fig:tocbasic.dottedtocline} until
- \autoref{fig:tocbasic.undottedtocline}). At the styles
- \PValue{dottedtocline}, \PValue{tocline}, and \PValue{undottedtocline}
- this \PName{length} will be added to the \PName{length} of attribute
- \PValue{indent} for the second and each following entry text line.
-
- At style \PValue{tocline} the initial \PName{length} of all entries with
- a name starting with ``\texttt{sub}'' is the value of the level without
- this prefix plus 0.9\Unit{em}. At the styles \PValue{dottedtocline},
- \PValue{undottedtocline} and \PValue{tocline} the initial \PName{length}
- of levels \PValue{part} down to \PValue{subparagraph} and levels
- \PName{figure} and \PName{table} is compatible to the standard
- classes. All other levels do not have an initial value. Therefore you
- have to explicitly set \PValue{numwidth} at the first definition of the
- entry.%
+ The width reserved for the entry number (see
+ \autoref{fig:tocbasic.dottedtocline} to
+ \autoref{fig:tocbasic.undottedtocline}). With the \PValue{dottedtocline},
+ \PValue{tocline}, and \PValue{undottedtocline} styles, this \PName{length}
+ is added to the \PName{length} of attribute \PValue{indent} for the second
+ and following lines of the entry text.
+
+ With the \PValue{tocline} style, the initial \PName{length} of all entries
+ whose name starts with ``\texttt{sub}'' is the value of the level without
+ this prefix plus 0.9\Unit{em}, if such a level with corresponding
+ attributes exists. With the \PValue{dottedtocline},
+ \PValue{undottedtocline}, and \PValue{tocline} styles, the initial
+ \PName{length}s of levels from \PValue{part} to \PValue{subparagraph}, as
+ well as \PName{figure} and \PName{table}, are compatible with those of the
+ standard classes. All other levels do not have an initial value. Therefore
+ you must set \PValue{numwidth} explicitly when the entry level is first
+ used.%
}%
\entry{\OptionVName{onstarthigherlevel}{code}}{%
- Style \PValue{tocline} can execute \PName{code} at the start of an entry,
- if the numerical level is greater than the numerical level of the previous
- entry. Remember: The numerical level of, e.\,g., \PValue{section} is
- greater than the numerical level of \PValue{part}. Nevertheless
- \PValue{part} has the highest position in the entry hierarchy.
+ The \PValue{tocline} style can execute \PName{code} at the start of an entry,
+ depending on whether the previous entry had numerical level greater than,
+ the same as, or less than the current
+ entry. The \PName{code} specified by this attribute will be executed if the
+ current entry has a greater numerical value, i.\,e. it is
+ lower in the entry hierarchy, than the previous one.
- Please note that the detection of the level of the previous entry depends
- on a valid unchanged value of \Macro{lastpenalty}.
+ Note that detecting the level of the previous entry only works so long as
+ \Macro{lastpenalty} has not changed since the previous entry.
The initial \PName{code} is \DescRef{\LabelBase.cmd.LastTOCLevelWasLower} (see
\DescPageRef{\LabelBase.cmd.LastTOCLevelWasLower}).%
}%
\entry{\OptionVName{onstartlowerlevel}{code}}{%
- Style \PValue{tocline} can execute \PName{code} at the start of an entry,
- if the numerical level is lower than the numerical level of the previous
- entry. Remember: The numerical level of, e.\,g., \PValue{part} is
- lower than the numerical level of \PValue{section}. Nevertheless
- \PValue{part} has the highest position in the entry hierarchy.
-
- Please note that the detection of the level of the previous entry depends
- on a valid unchanged value of \Macro{lastpenalty}.
-
- The initial \PName{code} is \DescRef{\LabelBase.cmd.LastTOCLevelWasHigher} (see
- \DescPageRef{\LabelBase.cmd.LastTOCLevelWasHigher}).%
+ The \PValue{tocline} style can execute \PName{code} at the start of an
+ entry, depending on whether the previous entry had numerical level greater
+ than, the same as, or less than the current entry. The \PName{code}
+ specified by this attribute will be executed if the current entry has a
+ lower numerical value, i.\,e. it is higher in the entry hierarchy, than
+ the previous one.
+
+ Note that detecting the level of the previous entry only works so long as
+ \Macro{lastpenalty} has not changed since the previous entry.
+
+ The initial \PName{code} is \DescRef{\LabelBase.cmd.LastTOCLevelWasHigher}
+ (see \DescPageRef{\LabelBase.cmd.LastTOCLevelWasHigher}), which usually
+ favours a page break before the entry.%
}%
\entry{\OptionVName{onstartsamelevel}{code}}{%
- Style \PValue{tocline} can execute \PName{code} at the start of an entry,
- if the level is same like the level of the previous entry.
-
- Please note that the detection of the level of the previous entry depends
- on a valid unchanged value of \Macro{lastpenalty}.
-
- The initial \PName{code} is \DescRef{\LabelBase.cmd.LastTOCLevelWasSame} (see
- \DescPageRef{\LabelBase.cmd.LastTOCLevelWasSame}).%
+ The \PValue{tocline} style can execute \PName{code} at the start of an
+ entry, depending on whether the previous entry had numerical level greater
+ than, the same as, or less than the current entry. The \PName{code}
+ specified by this attribute will be executed if the current entry has the
+ same numerical value, i.\,e. it is on the same level in the entry
+ hierarchy, as the previous one.
+
+ Note that detecting the level of the previous entry only works so long as
+ \Macro{lastpenalty} has not changed since the previous entry.
+
+ The initial \PName{code} is \DescRef{\LabelBase.cmd.LastTOCLevelWasSame}
+ (see \DescPageRef{\LabelBase.cmd.LastTOCLevelWasSame}), which usually
+ favours a page break before the entry.%
}%
\entry{\OptionVName{pagenumberbox}{command}}{%
- By default the page number of an entry is printed right aligned in a box
- of width \Macro{@pnumwidth}. At style \PValue{tocline} the \PName{command}
- to print the number can be changed using this attribute. The
- \PName{command} should have exactly one argument, the page number.%
+ By default the page number of an entry is printed flush right in a box
+ of width \Macro{@pnumwidth}. In the \PValue{tocline} style, you can
+ change the \PName{command} to print the number using this attribute. The
+ \PName{command} should expect exactly one argument, the page number.
+
+ This attribute is initialised with the box already mentioned.%
}%
\entry{\OptionVName{pagenumberformat}{command}}{%
- This attribute is the format of the page number of an entry. The
- \PName{command} should have exactly one argument, the page number. Font
- changes are relative to the font of \Option{entryformat} followed by
- \Macro{normalfont}\Macro{normalsize}.
+ You can use this attribute to change the format of the page number of an
+ entry. The \PName{command} should expect exactly one argument, the page
+ number. Font changes are relative to the font of \Option{entryformat}
+ followed by \Macro{normalfont}\Macro{normalsize}.
The initial \PName{command} of entry level \PValue{part} prints the
argument in \Macro{large}\Macro{bfseries}. The initial \PName{command} of
@@ -1429,28 +1480,30 @@ command \Macro{l@\PName{entry level}}.
\Macro{normalfont}\Macro{normalcolor}.%
}%
\entry{\OptionVName{raggedentrytext}{switch}}{%
- \ChangedAt{v3.21}{\Package{tocbasic}}%
- \PName{switch} is one of the values for simple switches from
- \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. If the
- switch is active, style \PValue{tocline} does print the text of an entry
- left-aligned instead of justified and only word, that are longer than a
- text line, are automatically hyphenated.
-
- This switch is not active by default.%
+ The\ChangedAt{v3.21}{\Package{tocbasic}} \PName{switch} is one of the
+ values for simple switches from \autoref{tab:truefalseswitch},
+ \autopageref{tab:truefalseswitch}. If the switch is active, the
+ \PValue{tocline} style prints the text of an entry ragged right instead of
+ fully justified, and only words that are longer than a text line are
+ automatically hyphenated.
+
+ This \PName{switch} is false by default.%
}%
\entry{\OptionVName{raggedpagenumber}{switch}}{%
- \PName{switch} is one of the values for simple switches from
+ The \PName{switch} is one of the values for simple switches from
\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. If the
- switch is active, style \PValue{tocline} does not force the page number to
- be right aligned.
-
- Depending on the value of \PValue{linefill}, the setting of this attribute
- could be needed for the wanted printing of the number, or only to avoid
- unwanted warning messages. So both attributes should correspond.
-
- By default the switch is not activated and therefore corresponds with an
- initial value \Macro{hfill} or \DescRef{\LabelBase.cmd.TOCLineLeaderFill} of attribute
- \PValue{linefill}.%
+ switch is active, the \PValue{tocline} style does not force the page
+ number to be right justified.
+
+ Depending on the value of \PValue{linefill}, setting this attribute could
+ affect only whether a warning message appears, or the formatting of the
+ page number as well. So it is important to set both attributes so that
+ they correspond.
+
+ By default the \PName{switch} is not activated and therefore corresponds
+ with an initial value of \Macro{hfill} or
+ \DescRef{\LabelBase.cmd.TOCLineLeaderFill} for the \PValue{linefill}
+ attribute.%
}%
\end{desclist}%
%
@@ -1495,101 +1548,103 @@ command \Macro{l@\PName{entry level}}.
%\OParameter{initial code}%
\end{Declaration}
\Macro{DeclareTOCEntryStyle}\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} is
-one of the most complex commands in \KOMAScript. It is addressed to \LaTeX{}
-developers not the \LaTeX{} users. It provides the definition of a new
-TOC-entry \PName{style}. Usually TOC-entries are made using
-\Macro{addcontentsline}\IndexCmd{addcontentsline}, or, if you use
-\Package{tocbasic}, with recommended
+one of the most complex commands in \KOMAScript. It is therefore explicitly
+intended for \LaTeX{} developers and not for ordinary \LaTeX{} users. It lets
+you define new a \PName{style} for content-list entries. Usually, entries to
+content lists are made using
+\Macro{addcontentsline}\IndexCmd{addcontentsline}, or preferably, if you use
+\Package{tocbasic}, with
\DescRef{\LabelBase.cmd.addxcontentsline}\IndexCmd{addxcontentsline} (see
-\autoref{sec:tocbasic.basics},
-\DescPageRef{\LabelBase.cmd.addxcontentsline}). In both cases \LaTeX{}
-writes a corresponding \Macro{contentsline}\IndexCmd{contentsline} into the
-given auxiliary file. Reading this auxiliary file each \Macro{contentsline}
-results in execution of a command \Macro{l@\PName{entry level}}.
-
-Whenever you assign a \PName{style} to a TOC-entry level using
-\DescRef{\LabelBase.cmd.DeclareTOCStyleEntry}, first of all the \PName{initial
- code} is executed and then \Macro{l@\PName{entry level}} is defined to be
-\PName{command code}. So \PName{command code} is the code that will be
-expanded and executed by \Macro{l@\PName{entry level}}. Inside \PName{command
- code} \texttt{\#1} is the name of the TOC-entry level and \texttt{\#\#1} and
-\texttt{\#\#2} are the arguments of \Macro{l@\PName{entry level}}.
-
-The \PName{initial code} should initialise all attributes of the
-\PName{style}. Developers are recommended to use \PName{initial code} to
-initialise all internal macros of the \PName{style} without the need of
-using an \PName{option list}. The second task of the \PName{initial code} is
-the definition of options to setup the attributes of the \PName{style}. Option
-\Option{level} is always defined automatically. The value of \Option{level}
-can be got in \PName{command code} using
-\Macro{@nameuse}\PParameter{\#1tocdepth}%
-\important{\Macro{\PName{entry level}tocdepth}}, e.\,g., to compare it with
-the counter \DescRef{\LabelBase.counter.tocdepth}\IndexCounter{tocdepth}.
-
-Commands \Macro{DefineTOCEntryBooleanOption},
+\autoref{sec:tocbasic.basics}, \DescPageRef{\LabelBase.cmd.addxcontentsline}).
+In both cases \LaTeX{} writes a corresponding
+\Macro{contentsline}\IndexCmd{contentsline} to the appropriate auxiliary file.
+When reading this auxiliary file, \LaTeX{} then executes a
+\Macro{l@\PName{entry level}} command for each \Macro{contentsline}.
+
+If you later assign a \PName{style} to an entry level using
+\DescRef{\LabelBase.cmd.DeclareTOCStyleEntry}, the \PName{initial code} is
+executed first, if provided, and then the \PName{command code} for the
+definition of \Macro{l@\PName{entry level}}. The \PName{command code} is the
+code that will be expanded and executed by \Macro{l@\PName{entry level}}.
+Inside \PName{command code} \texttt{\#1} is the name of the TOC entry level
+and \texttt{\#\#1} and \texttt{\#\#2} are the arguments of
+\Macro{l@\PName{entry level}}.
+
+The \PName{initial code} serves first to initialise all attributes of the
+\PName{style}. Developers should make sure that all attributes are provided
+with values here. Only then does \DescRef{\LabelBase.cmd.DeclareTOCStyleEntry}
+work without errors if an \PName{option list} is not specified. The second
+task of the \PName{initial code} is to define all the options that this
+\PName{style} recognises. The \Option{level} option is always defined
+automatically. The value of the \Option{level} can be queried within the
+\PName{command code} with \Macro{@nameuse}\PParameter{\#1tocdepth}%
+\important{\Macro{\PName{entry level}tocdepth}}, for example, to compare it
+with the \DescRef{\LabelBase.counter.tocdepth}\IndexCounter{tocdepth} counter.
+
+To define options for the attributes of the
+\PName{style} inside the \PName{initial code}, you can use the commands \Macro{DefineTOCEntryBooleanOption},
\Macro{DefineTOCEntryCommandOption}, \Macro{DefineTOCEntryIfOption},
-\Macro{DefineTOCEntryLengthOption}, and \Macro{DefineTOCEntryNumberOption}
-should be used to define options for the attributes of the
-\PName{style} inside \PName{initial code} only. If you use an \PName{option}
-defined by one of these commands, a macro \Macro{\PName{prefix}\PName{entry
- level}\PName{postfix}} will be defined to be the assigned value or the
-\PName{default value} of the option. Somehow special is
-\Macro{DefineTOCEntryIfOption}. It defines \Macro{\PName{prefix}\PName{entry
- level}\PName{postfix}} as a command with two arguments. If the value to
-the option is an activation value of \autoref{tab:truefalseswitch},
-\autopageref{tab:truefalseswitch} the command expands to the first
-argument. If the value to the option is a deactivation value, the command
+\Macro{DefineTOCEntryLengthOption}, and \Macro{DefineTOCEntryNumberOption}.
+These commands each define an \PName{option} that, when called,
+defines a macro named \Macro{\PName{prefix}\PName{entry
+ level}\PName{postfix}} set to the given value or to the
+\PName{default value} of the option. The
+\Macro{DefineTOCEntryIfOption} command is a somewhat special case. It defines \Macro{\PName{prefix}\PName{entry
+ level}\PName{postfix}} as a command with two arguments. If the value passed to
+the option is one of the activation (true) values from \autoref{tab:truefalseswitch},
+\autopageref{tab:truefalseswitch}, the command expands to the first
+argument. If the value to the option is a deactivation (false) value, the command
expands to the second argument.
-The \PName{description} should be a real short text that describes the sense
-of the option with some catchwords. Package \Package{tocbasic} uses this text
-in error messages, warnings or information output on the terminal and into the
-\File{log}-file.
+The \PName{description} should be a brief message that describes the sense
+of the option with some keywords. The \Package{tocbasic} package uses this text
+in error messages, warnings, and information output on the terminal and to the
+\File{log} file.
-The most simple style of \Package{tocbasic}, \PValue{gobble}, is defined
+The simplest style of \Package{tocbasic}, \PValue{gobble}, is defined
using:
\begin{lstcode}
\DeclareTOCEntryStyle{gobble}{}%
\end{lstcode}
-If you would define a entry level \PValue{dummy} using:
+If you now define an entry level \PValue{dummy} in this style using:
\begin{lstcode}
\DeclareTOCStyleEntry[level=1]{gobble}{dummy}
\end{lstcode}
-among others this would do something like:
+this would correspond, among other things, to:
\begin{lstcode}
\def\dummytocdepth{1}
\def\l@dummy#1#2{}
\end{lstcode}
-Inside style \PValue{tocline} for example
+For example, within the \PValue{tocline} style,
\begin{lstcode}
\DefineTOCEntryCommandOption{linefill}[\TOCLineLeaderFill]%
{scr@tso@}{@linefill}{filling between text and page number}%
\end{lstcode}
-is used to define option \Option{linefill} with \PName{default value}
-\DescRef{\LabelBase.cmd.TOCLineLeaderFill}. A call like:
+is used to define the \Option{linefill} option. By specifying
+\DescRef{\LabelBase.cmd.TOCLineLeaderFill} as the \PName{default value},
+a call such as
\begin{lstcode}
\RedeclareTOCStyleEntry[linefill]{tocline}{part}
\end{lstcode}
-would therefore result in a definition like:
+would, among other things, create the definition
\begin{lstcode}
\def\scr@tso@part@linefill{\TOCLineLeaderFill}
\end{lstcode}
-Whoever likes to define his own styles is recommended to first study the
-definition of style \PValue{dottedtocline}. If this definition is understood,
-the much more complex definition of style \PValue{tocline} gives a lot of
-hints of the correct usage of the described commands.
+If you want to define your own styles, you should first study the definition
+of the \PValue{dottedtocline} style. After you understand this definition, you
+can find many hints as to how to use the commands effectively in the much more
+complex definition of the \PValue{tocline} style.
-In many cases it will be enough to clone an existing style using
+However, in many cases it will be sufficient to clone an existing style using
\DescRef{\LabelBase.cmd.CloneTOCEntryStyle} and to change the initial code of
the new style using \DescRef{\LabelBase.cmd.TOCEntryStyleInitCode} or
\DescRef{\LabelBase.cmd.TOCEntryStyleStartInitCode}.
-\Macro{DefineTOCEntryOption} is merely used to define the other
-commands. It is not recommended to define options directly using
-\Macro{DefineTOCEntryOption}. Normally this is even not needed. It is
-alluded only for completeness.%
+\Macro{DefineTOCEntryOption} is merely used to define the other commands and
+you should not use it directly. Normally, there is no need for it. It is
+mentioned here only for the sake of completeness.%
\EndIndexGroup
@@ -1597,13 +1652,17 @@ alluded only for completeness.%
\Macro{CloneTOCEntryStyle}\Parameter{style}\Parameter{new style}%
\end{Declaration}
With\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} this command you can clone
-an existing \PName{style}. This defines a \PName{new style} with the same
-attributes and settings like the existing \PName{style}. The package itself
-uses \Macro{CloneTOCEntryStyle} to declare style \PValue{default} as a clone
-of \PValue{dottedtocline}. The \KOMAScript{} classes use the command to
-declare the styles \PValue{part}, \PValue{section}, and \PValue{chapter} or
-\PValue{subsection} as a clone of \PValue{tocline} and the style
-\PValue{default} new as a clone of \PValue{section} or \PValue{subsection}.%
+an existing \PName{style}. It defines a \PName{new style} with the same
+attributes and settings as the existing \PName{style}. The package itself uses
+\Macro{CloneTOCEntryStyle} to declare the \PValue{default} style as a clone of
+\PValue{dottedtocline}. The \KOMAScript{} classes use the command to declare
+the styles \PValue{part}, \PValue{section}, and \PValue{chapter} or
+\PValue{subsection} as clones of \PValue{tocline} and then modify them with
+\DescRef{\LabelBase.cmd.TOCEntryStyleInitCode} and
+\DescRef{\LabelBase.cmd.TOCEntryStyleStartInitCode}. The \Class{scrbook} and
+\Class{scrreprt} classes newly declare the \PValue{default} style as a clone
+of \PValue{section}, and \Class{scrartcl} declares it as a clone of
+\PValue{subsection}.%
\EndIndexGroup
@@ -1615,22 +1674,22 @@ declare the styles \PValue{part}, \PValue{section}, and \PValue{chapter} or
\end{Declaration}
Every\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} TOC-entry style has an
initialisation code. This is used whenever a \PName{style} is assigned to an
-TOC-entry using \DescRef{\LabelBase.cmd.DeclareTOCEntryStyle}. This
-\PName{initial code} should never do anything global, because it is also used
-for local initialisation inside other commands like
-\DescRef{\LabelBase.cmd.DeclareNewTOC}\IndexCmd{DeclareNewTOC}. The \PName{initial code} not
-only defines all attributes of a \PName{style}. It also should set the
-defaults for those attributes.
+TOC entry using \DescRef{\LabelBase.cmd.DeclareTOCEntryStyle}. This
+\PName{initial code} should not have global side effects, because it is also
+used for local initialisation inside other commands like
+\DescRef{\LabelBase.cmd.DeclareNewTOC}\IndexCmd{DeclareNewTOC}. The
+\PName{initial code} not only defines all attributes of a \PName{style}, but
+it also sets the defaults for those attributes.
You can use \Macro{TOCEntryStyleStartInitCode} and
-\Macro{TOCEntryStyleInitCode} to extend the already existing initialisation
-code by \PName{initial code}. \Macro{TOCEntryStyleStartInitCode} adds
-\PName{initial code} in front of the existing initialisation
-code. \Macro{TOCEntryStyleInitCode} adds the \PName{initial code} at the end
-of the existing initialisation code. The \KOMAScript{} classes, e.\,g., are
-using \Macro{TOCEntryStyleStartInitCode} to change the filling, font and
-vertical distances of style \PValue{part} that is a clone of
-\PValue{tocline}. Class \Class{scrbook} and \Class{scrreprt} use
+\Macro{TOCEntryStyleInitCode} to extend previously existing initialisation
+code with further \PName{initial code}. \Macro{TOCEntryStyleStartInitCode}
+adds \PName{initial code} in front of the existing code.
+\Macro{TOCEntryStyleInitCode} adds the \PName{initial code} at the end of the
+existing initialisation code. The \KOMAScript{} classes, for example, use
+\Macro{TOCEntryStyleStartInitCode} to properly initialise the fill, fonts, and
+vertical spacing of the \PValue{part} style cloned from \PValue{tocline}. For
+example, the \Class{scrbook} and \Class{scrreprt} classes use
\begin{lstcode}
\CloneTOCEntryStyle{tocline}{section}
\TOCEntryStyleStartInitCode{section}{%
@@ -1639,7 +1698,7 @@ vertical distances of style \PValue{part} that is a clone of
{\TOCLineLeaderFill\relax}%
}
\end{lstcode}
-to declare \PValue{section} as a modified clone of \PValue{tocline}.%
+to define \PValue{section} as a modified clone of \PValue{tocline}.%
\EndIndexGroup
@@ -1648,33 +1707,32 @@ to declare \PValue{section} as a modified clone of \PValue{tocline}.%
\Macro{LastTOCLevelWasSame}%
\Macro{LastTOCLevelWasLower}
\end{Declaration}
-At\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} the very beginning entries
-with style \PValue{tocline} \Package{tocbasic} executes one of these three
-commands depending on \Macro{lastpenalty}. \Macro{LastTOCLevelWasHigher} and
-\Macro{LastTOCLevelWasSame} used in vertical mode add
-\Macro{addpenalty}\PParameter{\Macro{@lowpenalty}} and therefore permit a
-page break before an entry with same or higher hierarchical
-position. \Macro{LastTOCLevelWasLower} is an empty command. Therefore page
-break between an entry and its sub-entry is not permitted.
-
-Users should not redefine these commands. Instead of a redefinition you should
-change the behaviour of single entry levels using attributes
-\PValue{onstartlowerlevel}, \PValue{onstartsamelevel}, and
-\PValue{onstarthigherlevel}.%
+At\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} the beginning of entries
+using the \PValue{tocline} style, \Package{tocbasic} executes one of these
+three commands depending on \Macro{lastpenalty}. \Macro{LastTOCLevelWasHigher}
+and \Macro{LastTOCLevelWasSame} used in vertical mode add
+\Macro{addpenalty}\PParameter{\Macro{@lowpenalty}} and therefore permit a page
+break before an entry with the same or higher hierarchical position.
+\Macro{LastTOCLevelWasLower} is empty, so a page break between an entry and
+its first sub-entry is not permitted.
+
+Users should not redefine these commands. Instead, you should change the
+behaviour of single entry levels using the \PValue{onstartlowerlevel},
+\PValue{onstartsamelevel}, and \PValue{onstarthigherlevel} attributes.%
\EndIndexGroup
\begin{Declaration}
- \Macro{TOCLineLeaderFill}\OParameter{filling code}
+ \Macro{TOCLineLeaderFill}\OParameter{leader}
\end{Declaration}
-Command\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} has been made to be used
-as value of option \Option{linefill} of assigning style \PName{tocline} to a
-TOC-entry. It is a line filler between the end of the entry text and the entry
-page number. The \PName{filling code} will be repeated with constant
-distance. The default for this optional argument is a dot.
-
-As implied by the name of the command it uses \Macro{leaders} to put the
-\PName{filling code}. The distance is defined analogous to the \LaTeX{} kernel
+This\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} command is intended to be
+used as a value for the \Option{linefill} option of the \PName{tocline}
+TOC-entry style. It creates a connection between the end of the entry text and
+the entry's page number. You can specify the \PName{leader}, which is repeated
+at regular intervals, as an optional argument. The default is a dot.
+
+As the name suggests, the command uses \Macro{leaders} to output the
+\PName{leader}. The spacing used is defined analogously to the \LaTeX{} kernel
command \Macro{@dottedtocline} by
\Macro{mkern}\Macro{@dotsep}\Unit{\texttt{mu}}.%
\EndIndexGroup
@@ -1682,75 +1740,79 @@ command \Macro{@dottedtocline} by
\section{Internal Commands for Class and Package Authors}
-\label{sec:tocbasic.internals}
+\seclabel{internals}
-Commands with prefix \Macro{tocbasic@} are internal but class and package
-authors may use them. But even if you are a class or package author you
-should not change them!
+The \Package{tocbasic} package provides some internal commands for the use of
+class and package authors. These commands all begin with the prefix
+\Macro{tocbasic@}. But\textnote{Attention!} even class or package authors
+should not redefine them! Their inner functioning may be changed or extended
+at any time, so redefining these commands could significantly damage the
+\Package{tocbasic}'s operation.
\begin{Declaration}
\Macro{tocbasic@extend@babel}\Parameter{extension}
\end{Declaration}
-The Package \Package{babel}\IndexPackage{babel} (see \cite{package:babel}),
-or more specifically a \LaTeX{} kernel that has been extended by the language
-management of \Package{babel} writes instructions to change the language
-inside of the files with the file name extensions \File{toc}, \File{lof}, and
-\File{lot} into those files at every change of the current language either at
-the begin of the document or inside the document. Package \Package{tocbasic}
-extends this mechanism with \Macro{tocbasic@extend@babel} to be used for other
-file name extensions too. Argument \PName{extension} has to be expandable!
-Otherwise the meaning of the argument may change until it will be used really.
-
-Normally this command will be used by default for every file name
-\PName{extension} that will be added to the list of known extensions using
-\DescRef{\LabelBase.cmd.addtotoclist}. This may be suppressed using feature
-\PValue{nobabel}\important{\PValue{nobabel}} (see \DescRef{\LabelBase.cmd.setuptoc},
-\autoref{sec:tocbasic.toc}, \DescPageRef{\LabelBase.cmd.setuptoc}). For the file
-name extensions \File{toc}, \File{lof}, and \File{lot} this will be done
-automatically by \Package{tocbasic} to avoid double language switching in the
-corresponding files.
-
-Normally there isn't any reason to call this command yourself. But there may
-by lists of something, that should not be under control of \Package{tocbasic},
-and so are not in \Package{tocbasic}'s list of known file name extensions, but
-nevertheless should be handled by the language change mechanism of
-\Package{babel}. The command may be used explicitly for those files. But please
-note that this should be done only once per file name extension!%
+At every change of the current language, either at the beginning of the
+document or inside the document, the \Package{babel}\IndexPackage{babel}
+package (see \cite{package:babel}), or rather a \LaTeX{} kernel enhanced by
+\Package{babel}'s language management, writes language-switching commands to
+the files with the \File{toc}, \File{lof}, and \File{lot} extensions. The
+\Package{tocbasic} package extends this mechanism with
+\Macro{tocbasic@extend@babel} so that it also works for other file extensions.
+The \PName{extension} argument must be completely expanded! Otherwise the
+there is a risk that, for example, the meaning of the argument has already
+change at the time it is actually evaluated.
+
+This command is typically invoked by default for every file \PName{extension}
+added to the list of known extensions with
+\DescRef{\LabelBase.cmd.addtotoclist}. You can suppress this with the
+\PValue{nobabel}\important{\PValue{nobabel}} feature (see
+\DescRef{\LabelBase.cmd.setuptoc}, \autoref{sec:tocbasic.toc},
+\DescPageRef{\LabelBase.cmd.setuptoc}). \Package{tocbasic} does this
+automatically for the extensions \File{toc}, \File{lof}, and \File{lot} to
+avoid switching languages twice in the corresponding files.
+
+There is usually no reason to call this command yourself. However, there could
+conceivably be content lists that are not under the control of
+\Package{tocbasic} and so are not in \Package{tocbasic}'s list of known file
+extensions, but which nevertheless should use \Package{babel}'s language
+switching mechanism. You can call the command explicitly for those files.
+But\textnote{Attention!} please note that this should be done only once per
+file extension!%
\EndIndexGroup
\begin{Declaration}
\Macro{tocbasic@starttoc}\Parameter{extension}
\end{Declaration}
-This command is something like the \LaTeX{} kernel macro
-\Macro{@starttoc}\IndexCmd{@starttoc}\important{\Macro{@starttoc}}. It is the
-command behind \DescRef{\LabelBase.cmd.listoftoc*} (see \autoref{sec:tocbasic.toc},
-\DescPageRef{\LabelBase.cmd.listoftoc*}). Authors of classes or packages
-who want to participate from the advantages of \Package{tocbasic} should at
-least use this command. Nevertheless it is recommended to use
-\DescRef{\LabelBase.cmd.listoftoc}. Command \Macro{tocbasic@starttoc} internally uses
-\Macro{\@starttoc}, but sets
+This command is the actual replacement for the
+\Macro{@starttoc}\IndexCmd{@starttoc}\important{\Macro{@starttoc}} command
+from the \LaTeX{} kernel. It is the command behind
+\DescRef{\LabelBase.cmd.listoftoc*} (see \autoref{sec:tocbasic.toc},
+\DescPageRef{\LabelBase.cmd.listoftoc*}). Class or package authors who want to
+take advantage of \Package{tocbasic} should at least use this command, or even
+better, \DescRef{\LabelBase.cmd.listoftoc}. The command uses
+\Macro{\@starttoc} internally, but sets
\Length{parskip}\IndexLength{parskip}\important{\Length{parskip}\\
- \Length{parindent}\\
- \Length{parfillskip}} and \Length {parindent}\IndexLength{parindent} to 0
-and \Length{parfillskip} to 0 until infinite before. Moreover,
-\Macro{@currext}\important{\Macro{@currext}}\IndexCmd{@currext} will be set to
-the file name extension of the current TOC-file, so this will be available
-while the execution of the hooks, that will be done before and after reading
-the auxiliary files.
-
-Because\textnote{Attention!} of \LaTeX{} will immediately open a new TOC-file
-for writing after reading that file, the usage of \Macro{tocbasic@starttoc}
-may result in an error message like
+\Length{parindent}\\ \Length{parfillskip}},
+\Length{parindent}\IndexLength{parindent} to 0, and \Length{parfillskip} to 0
+to infinity. Moreover,
+\Macro{@currext}\important{\Macro{@currext}}\IndexCmd{@currext} is set to the
+file extension of the current TOC file, so it can be evaluated during the
+subsequent execution of the hooks. You can find an explanation of these hooks
+below.
+
+Because\textnote{Attention!} \LaTeX{} opens a new content-list file for
+writing after reading that file, calling this command may result in an error
+message of the type
\begin{lstoutput}
! No room for a new \write .
\ch@ck ...\else \errmessage {No room for a new #3}
\fi
\end{lstoutput}
-if there are no more unused write handles. This may be solved, e.\,g., using
-package
-\Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile}.
-See \autoref{cha:scrwfile} for more information about that package.%
+if no more write handles are available. You can solve this problem by loading
+the \Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile}
+package described in \autoref{cha:scrwfile}, or by using Lua\LaTeX{}.%
\EndIndexGroup
@@ -1758,27 +1820,27 @@ See \autoref{cha:scrwfile} for more information about that package.%
\Macro{tocbasic@@before@hook}%
\Macro{tocbasic@@after@hook}
\end{Declaration}
-The hook \Macro{tocbasic@@before@hook} will be executed immediately before
-reading a auxiliary file for a TOC even before execution of the instructions
-of a \DescRef{\LabelBase.cmd.BeforeStartingTOC} command. It is permitted to
-extend this hook using \Macro{g@addto@macro}\IndexCmd{g@addto@macro}.
-
-Similarly \Macro{tocbasic@@after@hook} will be executed immediately after
-reading such an auxiliary file and before execution of instructions of
-\DescRef{\LabelBase.cmd.AfterStartingTOC}. It is permitted to extend this hook
-using \Macro{g@addto@macro}\IndexCmd{g@addto@macro}.
-
-\KOMAScript{} uses these hooks, to provide the automatic width calculation of
-the place needed by heading numbers. Only classes and packages should use
-these hooks. Users\textnote{Attention!} should really use
+The \Macro{tocbasic@@before@hook} hook is executed immediately before reading
+an auxiliary file for a content list, before executing the commands defined
+with \DescRef{\LabelBase.cmd.BeforeStartingTOC} command. You can extend this
+hook using \Macro{g@addto@macro}\IndexCmd{g@addto@macro}.
+
+Similarly, \Macro{tocbasic@@after@hook} is executed immediately after reading
+such an auxiliary file and before executing the commands defined with
+\DescRef{\LabelBase.cmd.AfterStartingTOC}. You can extend this hook using
+\Macro{g@addto@macro}\IndexCmd{g@addto@macro}.
+
+\KOMAScript{} uses these hooks to dynamically adjust content lists to the
+width of the heading numbers. Only classes and packages should use these
+hooks. Users\textnote{Attention!} should really use
\DescRef{\LabelBase.cmd.BeforeStartingTOC} and
\DescRef{\LabelBase.cmd.AfterStartingTOC} instead. Authors of packages should
-also favour those commands! These hooks should not be used to generate any
+also prefer these commands. These hooks should not be used to generate any
output!
If neither\textnote{Attention!} \DescRef{\LabelBase.cmd.listofeachtoc} nor
\DescRef{\LabelBase.cmd.listoftoc} nor \DescRef{\LabelBase.cmd.listoftoc*} are
-used for the output of a TOC, the hooks should be executed explicitly.%
+used to output the content list, the hooks should be executed explicitly.%
\EndIndexGroup
@@ -1786,26 +1848,31 @@ used for the output of a TOC, the hooks should be executed explicitly.%
\Macro{tocbasic@\PName{extension}@before@hook}%
\Macro{tocbasic@\PName{extension}@after@hook}
\end{Declaration}
-These hooks are processed after \DescRef{\LabelBase.cmd.tocbasic@@before@hook}, respectively
-before \DescRef{\LabelBase.cmd.tocbasic@@after@hook} before and after loading the TOC-file with
-the corresponding file \PName{extension}. Authors\textnote{Attention!} of
-classes and packages should never manipulate them! But if
+These hooks are executed directly after
+\DescRef{\LabelBase.cmd.tocbasic@@before@hook} or before
+\DescRef{\LabelBase.cmd.tocbasic@@after@hook} for the TOC file with the
+corresponding file \PName{extension}. Class\textnote{Attention!} and package
+authors should never change them under any circumstances! If
neither\textnote{Attention!} \DescRef{\LabelBase.cmd.listofeachtoc} nor
\DescRef{\LabelBase.cmd.listoftoc} nor \DescRef{\LabelBase.cmd.listoftoc*} are
-used for the output of a TOC, the hooks should be executed explicitly, if they
-are defined. Please note that they even can be undefined.%
+used to output a content list, the hooks should nevertheless be called, if
+they are defined. These commands can be undefined. For an appropriate test,
+see \DescRef{scrbase.cmd.scr@ifundefinedorrelax}%
+\IndexCmd{scr@ifundefinedorrelax} in \autoref{sec:scrbase.if},
+\DescPageRef{scrbase.cmd.scr@ifundefinedorrelax}.%
\EndIndexGroup
\begin{Declaration}
\Macro{tocbasic@listhead}\Parameter{title}
\end{Declaration}
-This command is used by \DescRef{\LabelBase.cmd.listoftoc} to set the heading of the TOC,
-either the default heading or the individually defined heading. If you define
-your own TOC-command not using \DescRef{\LabelBase.cmd.listoftoc} you may use
-\Macro{tocbasic@listhead}. In this case you should define
+This command is used by \DescRef{\LabelBase.cmd.listoftoc} and
+\DescRef{\LabelBase.cmd.listofeachtoc} to set the heading of the content list.
+This can be either the default heading of the \Package{tocbasic} package or a
+custom definition. If you define your own command for the heading, you can
+also use \Macro{tocbasic@listhead}. In this case, you should define
\Macro{@currext}\important{\Macro{@currext}}\IndexCmd{@currext} to be the file
-extension of the corresponding TOC-file before using
+extension of the corresponding TOC file before using
\Macro{tocbasic@listhead}.%
\EndIndexGroup
@@ -1813,10 +1880,10 @@ extension of the corresponding TOC-file before using
\begin{Declaration}
\Macro{tocbasic@listhead@\PName{extension}}\Parameter{title}
\end{Declaration}
-This command is used in \DescRef{\LabelBase.cmd.tocbasic@listhead} to set the individual
-headings, optional table of contents entry, and running head, if it was
-defined. If it was not defined it will be defined and used in
-\DescRef{\LabelBase.cmd.tocbasic@listhead} automatically.
+This command is used in \DescRef{\LabelBase.cmd.tocbasic@listhead} to set the
+individual headings, optional table of contents entry, and running head, if it
+is defined. Otherwise, \DescRef{\LabelBase.cmd.tocbasic@listhead} defines them
+before their use.%
\EndIndexGroup
@@ -1825,22 +1892,21 @@ defined. If it was not defined it will be defined and used in
\Parameter{extension}\Parameter{level}\Parameter{number}\Parameter{text}%
\Macro{nonumberline}
\end{Declaration}
-Command\ChangedAt{v3.12}{\Package{tocbasic}} \Macro{tocbasic@addxcontentsline}
-uses \Macro{addcontentsline} to either create a numbered or not numbered text
-entry to the TOC-file with the given \PName{extension}. Note, all parameters
-of \Macro{tocbasic@addxcontentsline} are mandatory. But you may use an empty
-\PName{number} argument, if you do not want a number. In this case the
-\PName{text} will be prefixed by \Macro{nonumberline} without any argument. In
-the other case, if \PName{number} is not empty,
-\DescRef{\LabelBase.cmd.numberline} with argument \PName{number} will used as
-usual.
-
-Command \Macro{nonumberline} is redefined inside
+The\ChangedAt{v3.12}{\Package{tocbasic}} \Macro{tocbasic@addxcontentsline}
+command creates entry of the specified level in the TOC file with the given
+\PName{extension}. Whether the entry is numbered or not depends on whether or
+not the \PName{number} argument is empty. In this case the \PName{text} will
+be prefixed by \Macro{nonumberline} without any argument. Otherwise,
+\DescRef{\LabelBase.cmd.numberline} with the \PName{number} argument will used
+as usual.
+
+The \Macro{nonumberline} command is redefined inside
\DescRef{\LabelBase.cmd.listoftoc} (see \autoref{sec:tocbasic.toc},
-\DescPageRef{\LabelBase.cmd.listoftoc}) depending on feature \PValue{numberline}
-(see \autoref{sec:tocbasic.toc}, \DescPageRef{\LabelBase.cmd.setuptoc}). This
-guarantees that changes of the feature results in changes of the corresponding
-TOC immediately at the next \LaTeX{} run.%
+\DescPageRef{\LabelBase.cmd.listoftoc}) depending on the \PValue{numberline}
+feature (see \autoref{sec:tocbasic.toc},
+\DescPageRef{\LabelBase.cmd.setuptoc}). As a result, changing this feature
+results in changes of the corresponding TOC immediately at the next \LaTeX{}
+run.%
\EndIndexGroup
@@ -1848,41 +1914,36 @@ TOC immediately at the next \LaTeX{} run.%
\Macro{tocbasic@DependOnPenaltyAndTOCLevel}\Parameter{entry level}%
\Macro{tocbasic@SetPenaltyByTOCLevel}\Parameter{entry level}
\end{Declaration}
-At\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} the end of TOC-entry style
-\PValue{tocline} (see \autoref{sec:tocbasic.tocstyle}) \Macro{penalty} is set
-to prohibit page breaks. The used penalty value depends on the \PName{entry
- level}. This is done by \Macro{tocbasic@SetPenaltyByTOCLevel}. At the very
-beginning of an entry \Macro{tocbasic@DependOnPenaltyAndTOCLevel} is used to
-execute the value of either style option \Option{onstartlowerlevel},
-\Option{onstartsamelevel}, or \Option{onstarthigherlevel} depending on
-\Macro{lastpenalty} and the current \PName{entry level}. The default of the
-first and second option would be to permit a page break, if used in vertical
-mode.
-
-Developers of \PValue{tocline}-compatible styles should adapt this. To do so,
-they are even allowed to copy the style option declarations of
-\Option{onstartlowerlevel}, \Option{onstartsamelevel}, and
-\Option{onstarthigherlevel}. These options should even use the same internal
-macros \Macro{scr@tso@\PName{entry level}@LastTOCLevelWasHigher},
-\Macro{scr@tso@\PName{entry level}@LastTOCLevelWasSame} and
-\Macro{scr@tso@\PName{entry level}@LastTOCLevelWasLower} to store the current
-values of the options.%
+The\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} \PValue{tocline}
+content-list style (see \autoref{sec:tocbasic.tocstyle}) sets a
+\Macro{penalty} at the end of each entry via
+\Macro{tocbasic@SetPenaltyByTOCLevel} so that no page break can occur after an
+entry. The exact value chosen depends on the \PName{entry level}.
+
+At the beginning of an entry, \Macro{tocbasic@DependOnPenaltyAndTOCLevel} is
+used to execute the value of the \Option{onstartlowerlevel}, the
+\Option{onstartsamelevel}, or the \Option{onstarthigherlevel} style option,
+depending on \Macro{lastpenalty} and the current \PName{entry level}. By
+default, the first two permit a page break when executed in vertical mode.
+
+Developers of \PValue{tocline}-compatible styles should copy this behaviour.
+To do so, they can fall back on these internal macros.%
\EndIndexGroup
\section{A Complete Example}
\seclabel{example}
-This section will show you a complete example of a user defined floating
-environment with list of that kind of floats and \KOMAScript{} integration
-using \Package{tocbasic}. This example uses internal commands, that have a
-``\texttt{@}'' in their name. This means\textnote{Attention}, that the code
-has to be put into a package or class, or has to be placed between
+This section provides a complete example of how to define your own floating
+environment including an associated content list and \KOMAScript{} integration
+using \Package{tocbasic}. This example uses internal commands, that is, they
+have a ``\texttt{@}'' in their name. This means\textnote{Attention}, that you
+must either put the code into a package or class or placed it between
\Macro{makeatletter}\important[i]{\Macro{makeatletter}\\\Macro{makeatother}}%
\IndexCmd{makeatletter} and \Macro{makeatother}\IndexCmd{makeatother}.
-First\textnote{environment} of all, a new floating environment will be
-needed. This could simply be done using:
+First\textnote{environment}, we need a new floating environment.
+That's easy with the following:
\begin{lstcode}
\newenvironment{remarkbox}{%
\@float{remarkbox}%
@@ -1890,21 +1951,22 @@ needed. This could simply be done using:
\end@float
}
\end{lstcode}
-To the new environment is named \Environment{remarkbox}.
+The new environment is named \Environment{remarkbox}.
-Each\textnote{placement} floating environment has a default
-placement. This is build by some of the well known placement options:
+Each\textnote{placement} floating environment has a default placement. It
+consists of one or more of the well-known placement options: \PValue{b},
+ \PValue{h}, \PValue{p} and \PValue{t}.
\begin{lstcode}
\newcommand*{\fps@remarkbox}{tbp}
\end{lstcode}
-So, the new floating environment should be placed by default only either at
-the top of a page, at the bottom of a page, or on a page on its own.
-
-Floating\textnote{type} environments have a numerical floating
-type. Environments with the same active bit at the floating type cannot change
-their order. Figures and table normally use type~1 and 2. So a figure that
-comes later at the source code than a table, may be output earlier than the
-table and vica versa.
+The new floating environment should be placed by default only either at
+the top of a page, at the bottom of a page, or on a separate page.
+
+Floating\textnote{type} environments also have a numerical floating
+type between 1 and 31. Environments with the same active bit at the floating type cannot change
+their order. Figures and tables normally use type~1 and 2. So a figure that
+comes later in the source code than a table may be output earlier than the
+table and vice versa.
\begin{lstcode}
\newcommand*{\ftype@remarkbox}{4}
\end{lstcode}
@@ -1918,157 +1980,156 @@ The\textnote{number} captions of floating environment also have numbers.
Remark~\theremarkbox\csname autodot\endcsname}
\newcommand*{\fnum@remarkbox}{\remarkboxformat}
\end{lstcode}
-Here first a new counter has been defined, that is independent from chapters
+Here, a new counter is defined first, which is independent of the chapters
or the counters of other structural levels. \LaTeX{} itself also defines
-\Macro{theremarkbox} with the default Arabic representation of the counter's
-value. Afterwards this has been used defining the formatted output of the
-counter. Last this formatted output has been used for the output of the
-environment number of the \DescRef{maincls.cmd.caption} command.
-
-Floating\textnote{file name extension} environments have lists of themselves
-and those need a auxiliary file with name \Macro{jobname} and a file name
-extension, the TOC-file\Index{TOC-file}:
+\Macro{theremarkbox} with the default output as an Arabic number.
+This is then used to define the formatted output of the
+counter. The formatted output is again defined as a floating-point
+number for use in the \DescRef{maincls.cmd.caption} command.
+
+Floating\textnote{file name extension} environments have their own content lists
+and those need an auxiliary file named \Macro{jobname} and a file
+extension:
\begin{lstcode}
\newcommand*{\ext@remarkbox}{lor}
\end{lstcode}
-The file name extension of the TOC-file for the list of
-\Environment{remarkbox}es is ``\File{lor}''.
+As the file extension, we use ``\File{lor}''.
-This was the definition of the floating environment. But the list of this new
-environment's captions is still missing. To reduce the implementation effort
-package \Package{tocbasic} will be used for this. This will be loaded using
+With this, the floating environment works. But the content list of
+is still missing. So that we do not have to implement it ourselves, we
+use the \Package{tocbasic} package. This is loaded with
\begin{lstcode}
\usepackage{tocbasic}
\end{lstcode}
-inside of document preambles. Authors of classes or packages would use
+inside of document preambles. Class or package authors would use
\begin{lstcode}
\RequirePackage{tocbasic}
\end{lstcode}
instead.
-Now\textnote{extension} we register the file name extension for package
-\Package{tocbasic}:
+Now\textnote{extension} we register the file name extension with the
+\Package{tocbasic} package:
\begin{lstcode}
\addtotoclist[float]{lor}
\end{lstcode}
-Thereby the owner \PValue{float} has been used, to allude all further
-\KOMAScript{} options for list of figures and list of tables also to the new
-one.
+We use \PValue{float} as the owner so that all subsequent \KOMAScript{}
+options that relate to lists of floating environments also apply to the new
+content list.
-Next\textnote{title} we define a title or heading for the list of
-\Environment{remarkbox}es:
+Next\textnote{title} we define a title or heading for this content list:
\begin{lstcode}
\newcommand*{\listoflorname}{List of Remarks}
\end{lstcode}
-You may use package \Package{scrbase} to additionally support titles in other
-languages than English.
-
-Also\textnote{entry} a command is needed to define the layout of the entries
-to the list of remarks:
+When working with multiple languages, the normal practice is to define an
+English title first and then, for example with the help of the
+\Package{scrbase} package, to add titles for all the other languages you want
+to support. See \autoref{sec:scrbase.languageSupport}, starting on
+\autopageref{sec:scrbase.languageSupport}.
+
+Now\textnote{entry} all we have to do is define what a single entry in the
+content list should look like:
\begin{lstcode}
\newcommand*{\l@remarkbox}{\l@figure}
\end{lstcode}
-Here simply the entries to the list of remarks get the same layout like the
-entries to the list of figures. This would be the easiest solution. A more
-explicit would be, e.\,g.,
+This specifies that entries in the list of remarks should look exactly like the
+entries in the list of figures. This would be the easiest solution. A more
+explicit definition would be something like:
\begin{lstcode}
\DeclareTOCStyleEntry[level=1,indent=1em,numwidth=1.5em]%
{tocline}{remarkbox}
\end{lstcode}
-Additionally\textnote{chapter entry} you may want structure the list of
-remarks depending on chapters.
+You\textnote{chapter entry} also want chapter entries to affect the content
+list.
\begin{lstcode}
\setuptoc{lor}{chapteratlist}
\end{lstcode}
-The \KOMAScript{} classes provide that feature and maybe other classes do so
-too. Unfortunately the standard classes do not.
-
-This\textnote{list of remarks} would already be enough. Now, users may already
-select different kinds of headings either using the corresponding options of
-the \KOMAScript{} classes, or \DescRef{\LabelBase.cmd.setuptoc}, e.\,g., with
-or without entry in the table of contents, with or without number. But a
-simple
+Setting this property allows this when you use a \KOMAScript{} class, and other class
+that supports this property. Unfortunately, the standard classes do not.
+
+This\textnote{list of remarks} should be enough. Users can now
+select different kinds of headings using the corresponding options of
+the \KOMAScript{} classes or \DescRef{\LabelBase.cmd.setuptoc}, (e.\,g. with
+or without an entry in the table of contents, with or without numbering). But
+with a simple
\begin{lstcode}
\newcommand*{\listofremarkboxes}{\listoftoc{lor}}
\end{lstcode}
-may make the usage a little bit easier again.
-
-As you've seen only five commands refers to the list of remarks. Only three of
-them are necessary. Nevertheless the new list of remarks already provides
-optional numbering of the heading and optional not numbered entry into the
-table of contents. Optional even a lower document structure level may be used
-for the heading. Running headers are provides with the \KOMAScript{} classes,
-the standard classes, and all classes that explicitly support
-\Package{tocbasic}. Supporting classes even pay attention to this new list of
-remarks at every new \DescRef{maincls.cmd.chapter}. Even changes of the
-current language are handled inside the list of remarks like they will inside
-the list of figures or inside the list of tables.
-
-Moreover,\textnote{additional features} an author of a package may add more
-features. For example, options to hide \DescRef{\LabelBase.cmd.setuptoc} from
-the users may be added. On the other hand, the \Package{tocbasic} manual may
-be referenced to describe the corresponding features. The advantage of this
-would be that user would get information about new features provides by
-\Package{tocbasic}. But if the user should be able to set the features of the
-remarks even without knowledge about the file name extension \File{lor} a
-simple
+you can simplify the usage even more.
+
+As you've seen, just five one-line commands, of which only three or four are
+really necessary, refer to the content list. Nevertheless, the new list of
+remarks already provides the ability to place both numbered and unnumbered
+entries into the table of contents.You can use a lower sectioning level for
+the headings. Running heads are set for the \KOMAScript{} classes, the
+standard classes, and all classes that explicitly support \Package{tocbasic}.
+Supporting classes even pay attention to this new list of remarks at each new
+\DescRef{maincls.cmd.chapter}. Even changes to the current language made with
+\Package{babel} are included in the list of remarks.
+
+Of course\textnote{additional features}, package authors can add more
+features. For example, they could explicitly offer options to hide
+\DescRef{\LabelBase.cmd.setuptoc} from users. Or they can refer to the
+\Package{tocbasic} manual when explaining the appropriate features. The
+advantage of this is that users automatically benefit from any future
+extensions to \Package{tocbasic}. However, if you do not want to burden the
+user with the fact that the file extension \File{lor} is used for the key
+terms, then
\begin{lstcode}
\newcommand*{\setupremarkboxes}{\setuptoc{lor}}
\end{lstcode}
-would be enough to use a list of features argument to
-\Macro{setupremarkboxes} as list of features of file name extension \File{lor}.
+is sufficient to set a list of features passed as an argument to
+\Macro{setupremarkboxes} as a list of features for the file extension
+\File{lor}.
-\section{Everything with One Command Only}
-\label{sec:tocbasic.highlevel}
+\section{Everything with Only One Command}
+\label{sec:tocbasic.declarenewtoc}
-The example from the previous section shows, that using \Package{tocbasic} to
-define floating environments and lists with the captions of those floating
-environments is easy. The following example will show, that it may be even
-easier.
+The example in the previous section has shows that \Package{tocbasic} makes it
+easy to define your own floating environments with their own content lists.
+This section shows how it can be even easier.
\begin{Declaration}
\Macro{DeclareNewTOC}\OParameter{options}\Parameter{extension}
\end{Declaration}
-This command declares\ChangedAt{v3.06}{\Package{tocbasic}} in one step only a
-new TOC, the heading of that TOC, the term used for the TOC-entries, and to
-manage the file name \PName{extension}. Additionally optional floating and
-non-floating environments may be defined, and inside of both such environments
-\DescRef{maincls.cmd.caption}%
-\important{\DescRef{maincls.cmd.caption}}\IndexCmd{caption} may be used. The
-additional features \DescRef{maincls.cmd.captionabove}\important[i]{%
+This command declares\ChangedAt{v3.06}{\Package{tocbasic}} a new content list,
+its heading, and the description of the entries controlled by
+\Package{tocbasic} all in a single step. Optionally, you can also define
+floating and non-floating environments at the same time. Inside of both such
+environments, \DescRef{maincls.cmd.caption}%
+\important{\DescRef{maincls.cmd.caption}}\IndexCmd{caption} creates entries
+for this new content list. You can also use the \KOMAScript{} extensions
+\DescRef{maincls.cmd.captionabove}\important[i]{%
\DescRef{maincls.cmd.captionabove}\\
\DescRef{maincls.cmd.captionbelow}}, \DescRef{maincls.cmd.captionbelow}, and
-\DescRef{maincls.env.captionbeside} of the \KOMAScript{} classes (see
-\autoref{sec:maincls.floats}) may also be used inside of those environments.
-
-Argument \PName{extension} is the file name extension of the TOC-file, that
-represents the list of something. See \autoref{sec:tocbasic.basics} for more
-information about this. This argument is mandatory and must not be empty!
-
-Argument \PName{options} is a comma separated list, like you know it from,
-e.\,g., \DescRef{maincls.cmd.KOMAoptions} (see
-\autoref{sec:typearea.options}). Nevertheless\textnote{Attention!}, those
-options cannot be set using
-\DescRef{maincls.cmd.KOMAoptions}\IndexCmd{KOMAoptions}! An overview of all
-available options may be found in
+\DescRef{maincls.env.captionbeside} (see \autoref{sec:maincls.floats}).
+
+The \PName{extension} argument is the file extension of the TOC file that
+represents the content list, as explained in \autoref{sec:tocbasic.basics}.
+This argument is mandatory and must not be empty!
+
+The \PName{options} argument is a comma-separated list, of the same type as,
+for example, \DescRef{maincls.cmd.KOMAoptions} (see
+\autoref{sec:typearea.options}). However\textnote{Attention!}, those options
+cannot be set using \DescRef{maincls.cmd.KOMAoptions}\IndexCmd{KOMAoptions}!
+You can find an overview of all available options in
\autoref{tab:tocbasic.DeclareNewTOC-options}.
-If\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}} option \Option{tocentrystyle}
-is not used, style \PValue{default} will be used. For information about this
-style see \autoref{sec:tocbasic.tocstyle}. If you do not want to define a
-command for entries to the list of something, you can use an empty argument,
-i.\,e., \OptionValue{tocentrystyle}{} or
-\OptionValue{tocentrystyle}{\PParameter{}}. Nevertheless, this would contain
-the risk to get a lot of errors while printing that list.
+If\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}} the \Option{tocentrystyle}
+option is not used, the \PValue{default} style will be used if required. For
+information about this style, see \autoref{sec:tocbasic.tocstyle}. If you do
+not want to define a command for entries to the content list, you can use an
+empty argument, i.\,e. \OptionValue{tocentrystyle}{} or
+\OptionValue{tocentrystyle}{\PParameter{}}.
Depending\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}%
\ChangedAt[2016/06]{v3.21}{\Package{tocbasic}} on the style of the entries to
-the list of something, you can setup all valid attributes of the selected
-style as part of the \PName{options}. To do so you have to prefix the names of
-the attributes given in \autoref{tab:tocbasic.tocstyle.attributes} from
-\autopageref{tab:tocbasic.tocstyle.attributes} by prefix
-\PValue{tocentry}. Later changes of the style of the entries can be made using
+the content list, you can set all valid attributes of the selected style as
+part of the \PName{options}. To do so, you must add the prefix
+\PValue{tocentry} to the names of the attributes given in
+\autoref{tab:tocbasic.tocstyle.attributes}, starting on
+\autopageref{tab:tocbasic.tocstyle.attributes}. You can make later changes to
+the style of the entries at any time using
\DescRef{\LabelBase.cmd.DeclareTOCStyleEntry}%
\IndexCmd{DeclareTOCStyleEntry}%
\important{\DescRef{\LabelBase.cmd.DeclareTOCStyleEntry}}. See
@@ -2079,112 +2140,141 @@ the styles.%
\begin{desclist}
\renewcommand*{\abovecaptionskipcorrection}{-\normalbaselineskip}%
\desccaption[{Options for command \Macro{DeclareNewTOC}}]{%
- Options for command
- \Macro{DeclareNewTOC}\ChangedAt{v3.06}{\Package{tocbasic}}%
+ Options for the
+ \Macro{DeclareNewTOC}\ChangedAt{v3.06}{\Package{tocbasic}} command%
\label{tab:tocbasic.DeclareNewTOC-options}%
}{%
- Options for command \Macro{DeclareNewTOC} (\emph{continuation})%
+ Options for the \Macro{DeclareNewTOC} command (\emph{continued})%
}%
- \entry{\OptionVName{atbegin}{instructions}%
+ \entry{\OptionVName{atbegin}{commands}%
\ChangedAt{v3.09}{\Package{tocbasic}}}{%
- The \PName{instructions} will be executed at the begin of the floating or
+ The \PName{commands} will be executed at the begin of the floating or
non-floating environment.%
}%
- \entry{\OptionVName{atend}{instructions}%
+ \entry{\OptionVName{atend}{commands}%
\ChangedAt{v3.09}{\Package{tocbasic}}}{%
- The \PName{instructions} will be executed at the end of the floating or
+ The \PName{commands} will be executed at the end of the floating or
non-floating environment.%
}%
\entry{\OptionVName{counterwithin}{\LaTeX{} counter}}{%
- If you define a float or non-float, the captions will be numbered and a
- counter \PName{type} (see option \Option{type}) will be defined. You may
- declare another counter to be the parent \LaTeX{} counter. In this case,
- the parent counter will be set before the float counter and the float
- counter will be reset whenever the parent counter is increased using
- \Macro{stepcounter} or \Macro{refstepcounter}.%
+ If you define a new floating or non-floating environment, a new counter
+ \Counter{\PName{type}} will be created as well (see option
+ \Option{type}). You can make this counter depenent another \LaTeX{}
+ counter in the same way, for example, that the \Counter{figure} counter in
+ the \Class{book} classes is dependent on the \Counter{chapter} counter.%
}%
\entry{\Option{float}}{%
- If set, float environments for that type will be defined. The names of the
- environments are the value of \PName{type} and for double column floats
- the value of \PName{type} with addendum ``\PValue{*}''.%
+ If set, defines a new content list and a floating environment, both named
+ \PName{type}, and an environment for double-column floats named
+ \PName{type*}.%
}%
\entry{\OptionVName{floatpos}{float positions}}{%
- The default floating position of the float. If no float position was
- given, ``tbp'' will be used like the standard classes do for figures and
- tables.%
+ Each floating environment has default \PName{float positions} that can be
+ changed through the optional argument of the floating environment. The
+ syntax and semantics are identical to those of the standard floating
+ environments. If the option is not used, the default \PName{float
+ positions} are ``\texttt{tbp}'', that is \emph{top}, \emph{bottom},
+ \emph{page}.%
}%
\entry{\OptionVName{floattype}{number}}{%
- The numerical float type of the defined floats. Float types with common
- bits cannot be reordered. At the standard classes figures has float type 1
- and tables has float type 2. If no float type was given, 16 will be used.%
+ Each floating environment has a \PName{number}. Floating environments
+ where only different bits are set can be moved past each other. The
+ floating environments \Environment{figure} and \Environment{table} usually
+ have the types 1 and 2, so they can move past each other. The numerical
+ float type can be between 1 and 31. If common bits are set, the float
+ types cannot be reordred. If no float type is given, the greatest possible
+ one-bit type, 16, will be used.%
}%
\entry{\Option{forcenames}}{%
- If set, the names will be even defined, if they where already defined
+ If set, the names will be defined even if they were already defined
before.%
}%
\entry{\OptionVName{hang}{length}}{%
\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}%
\ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}%
- This option is deprecated since \KOMAScript~3.20. Now, the amount of the
- hanging indent of the entries for that list\index{table of contents>entry}
- depend on attributes of the TOC-entry style given by option
- \Option{tocentrystyle}. The styles of \KOMAScript{} provide an attribute
- \PValue{numwidth}. If the used style has such an attribute,
- \Macro{DeclareNewTOC} will initialise it with 1.5\Unit{em}. You can change
- the real \PName{value} using \OptionVName{tocentrynumwidth}{value}. The
- \KOMAScript{} classes for example use
- \OptionValue{tocentrynumwidth}{2.3em}.%
+ This option has been deprecated since \KOMAScript~3.20. Instead, the
+ amount of the hanging indent of entries to the content list\index{content
+ list>entry} depends on attributes of the TOC-entry style given by the
+ \Option{tocentrystyle} option. The \KOMAScript{} styles provide the
+ \PValue{numwidth} attribute. If the style used has such an attribute,
+ \Macro{DeclareNewTOC} will initialise it with a default of 1.5\Unit{em}.
+ You can easily change the \PName{value} using
+ \OptionVName{tocentrynumwidth}{value}. The \KOMAScript{} classes, for
+ example, use \OptionValue{tocentrynumwidth}{2.3em}.%
}%
\entry{\OptionVName{indent}{length}}{%
\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}%
\ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}%
- This option is deprecated since \KOMAScript~3.20. Now, the amount of
- indenting the entries of that list\index{table of contents>entry} depend
- on attributes of the TOC-entry style given by option
- \Option{tocentrystyle}. The styles of \KOMAScript{} provide an attribute
- \PValue{indent}. If the used style has such an attribute,
- \Macro{DeclareNewTOC} will initialise it with 1\Unit{em}. You can change
- the real \PName{value} using \OptionVName{tocentryindent}{value}. The
- \KOMAScript{} classes for example use
- \OptionValue{tocentrynumwidth}{1.5em}.%
+ This option has been deprecated since \KOMAScript~3.20. Instead, the
+ amount that entries to the content list\index{content list>entry} are
+ indented depends on attributes of the TOC-entry style given by the
+ \Option{tocentrystyle} option. The \KOMAScript{} styles provide the
+ \PValue{indent} attribute. If the style used has such an attribute,
+ \Macro{DeclareNewTOC} will initialise it with a default of 1\Unit{em}. You
+ can easily change the \PName{value} using
+ \OptionVName{tocentryindent}{value}. The \KOMAScript{} classes for example
+ use \OptionValue{tocentrynumwidth}{1.5em}.%
}%
\entry{\OptionVName{level}{number}}{%
\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}%
\ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}%
- This option is deprecated since \KOMAScript~3.20. Now, the level of the
- entries of that list\index{table of contents>entry} depend on attributes
- of the TOC-entry style given by option
- \Option{tocentrystyle}. Nevertheless all styles have an attribute
- \PValue{level} and \Macro{DeclareNewTOC} initialises it with 1. You can
- change the real \PName{value} using \OptionVName{tocentrylevel}{value}.%
+ This option has been deprecated since \KOMAScript~3.20. Instead, the level
+ of the entries to the content list\index{content list>entry} depends on
+ attributes of the TOC-entry style given by the \Option{tocentrystyle}
+ option. Nevertheless, all styles have the \PValue{level} attrobite, and
+ \Macro{DeclareNewTOC} initialises it with a default value of 1. You can
+ easily change the \PName{value} using \OptionVName{tocentrylevel}{value}.%
}%
- \entry{\OptionVName{listname}{string}}{%
- The name of the TOC. If not given the value of \PValue{types} with upper
- case first char using \Macro{MakeUppercase}\IndexCmd{MakeUppercase}
- prefixed by ``List of '' will be used.%
+ \entry{\OptionVName{listname}{title}}{%
+ Each content list has a heading, or title, that you can specify with this
+ option. If the option is not specified, the title will be ``List of
+ \PName{entry type}'' (see the \Option{types} option), with the first
+ character of the \PName{entry type} changed to upper case. It also defines
+ the \Macro{list\PName{entry type}name} macro with this value, which you
+ can change at any time. This macro, however, is only defined if it is not
+ already defined or if the \Option{forcenames} option is also set.%
}%
- \entry{\OptionVName{name}{string}}{%
- The name of an element. If no name is given, the value of \PValue{type}
- with upper case first char will be used.%
+ \entry{\OptionVName{name}{entry name}}{%
+ Both the optional prefix for entries in the content list and the labels in
+ floating or non-floating environments (see the \Option{float} and
+ \Option{nonfloat} options) require an \PName{entry name} for an entry to
+ the content list. If no \PName{entry name} is given, the value of the
+ \PValue{type} (see the \Option{type} option) with the first character
+ changed to upper case will be used. It also defines a \Macro{\PName{entry
+ type}name} macro with this value, which you can change at any time. This
+ macro, however, is only defined if it is not already defined or if the
+ \Option{forcenames} option is also set.%
}%
\entry{\Option{nonfloat}}{%
- If set, a non floating environment will be defined. The name of the
- environment is the value of \PName{type} with attached ``\PValue{-}''.%
+ If set, defines not only a content list but also a non-floating environment,
+ \Environment{\PName{entry type}-} (see the \Option{type} option), which can
+ be used similarly to a floating environment, but which does not move from
+ the place where it is used.%
}%
\entry{\OptionVName{owner}{string}}{%
- The owner as described in the sections before. If no owner was given owner
- \PValue{float} will be used.%
+ Every new content list has an owner in \Package{tocbasic} (see
+ \autoref{sec:tocbasic.basics}). You can specify this here. If no owner is
+ specified, the owner ``\PValue{float}'' is used. The \KOMAScript{} classes
+ use this owner for the list of figures and the list of tables.%
+ }%
+ \entry{\OptionVName{setup}{list of attributes}}{%
+ \ChangedAt{v3.25}{\Package{tocbasic}}%
+ The \PName{list of attributes} is set with
+ \DescRef{\LabelBase.cmd.setuptoc}. Note that to specify multiple
+ attributes in a comma-separated list, you must put this list between
+ braces.%
}%
\entry{\OptionVName{tocentrystyle}{TOC-entry style}}{%
- \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}%
- \PName{TOC-entry style} is the style that should be used for all entries
- into the TOC corresponding to the \PName{extension}. The name of the entry
- level is given by option \Option{type}. Additional to the options of this
- table all attributes of the \PName{TOC-entry style} can be used as
- options. To do so, you have to prefix the name of such an attribute by
- \PValue{toc}. For example, you can change the numerical level of the
- entries using option \Option{tocentrylevel}. For more information about
- the styles and their attributes see \autoref{sec:tocbasic.tocstyle} from
+ \ChangedAt{v3.20}{\Package{tocbasic}}%
+ \PName{TOC-entry style} specifies the style that should be used for all
+ entries to the content list corresponding to the \PName{extension}. The
+ name of the entry level is given by the \Option{type} option. In addition
+ to the options in this table, all attributes of the \PName{TOC-entry
+ style} can be used as options. To do so, you have to prefix the name of
+ such an attribute with \PValue{toc}. For example, you can change the
+ numerical level of the entries using the \Option{tocentrylevel} option.
+ For more information about the styles and their attributes see
+ \autoref{sec:tocbasic.tocstyle}, starting on
\autopageref{sec:tocbasic.tocstyle}.%
}%
\entry{\OptionVName{tocentry\PName{style-option}}{value}}{%
@@ -2195,22 +2285,31 @@ the styles.%
TOC-entry styles. See \autoref{tab:tocbasic.tocstyle.attributes},
\autopageref{tab:tocbasic.tocstyle.attributes} for information about the
attributes of the predefined TOC-entry styles of package
- \Package{tocbasic}, that can be used as \PName{style-option}.%
+ \Package{tocbasic} that can be used as \PName{style-option}.%
}%
- \entry{\OptionVName{type}{string}}{%
- sets the type of the new declared TOC. The type will be used e.\,g. to
- defined a \Macro{listof}\PName{string}. If no type is set up the extension
- from the mandatory argument will be used.%
+ \entry{\OptionVName{type}{entry type}}{%
+ Sets the type of the newly declared content list. The \PName{entry type}
+ is also used as a base name for various macros and possibly environments
+ and counters. It should therefore consist only of letters. If this option
+ is not used, the file \PName{extension} from the mandatory argument will
+ be used as the \PName{entry type}.%
}%
\entry{\OptionVName{types}{string}}{%
- the plural of the type. If no plural was given the value of \PValue{type}
- with attached ``s'' will be used.%
+ In several places, the plural form of the \PName{entry type} is required.
+ If no plural is given, the value of the \PValue{entry type} with an ``s''
+ appended will be used.%
+ }%
+ \entry{\OptionVName{unset}{list of attributes}}{%
+ \ChangedAt{v3.25}{\Package{tocbasic}}%
+ The \PName{list of attributes} is unset with
+ \DescRef{\LabelBase.cmd.unsettoc}. Note that to specify a comma-separated
+ list of attributes, you must put this list between braces.%
}%
\end{desclist}
\begin{Example}
- Using \Macro{DeclareNewTOC} reduces the example from
- \autoref{sec:tocbasic.example} to:
+ Using \Macro{DeclareNewTOC} significantly shortens the example from
+ \autoref{sec:tocbasic.example}:
\begin{lstcode}
\DeclareNewTOC[%
type=remarkbox,%
@@ -2222,25 +2321,24 @@ the styles.%
]{lor}
\setuptoc{lor}{chapteratlist}
\end{lstcode}
- Beside environments \Environment{remarkbox} and \Environment{remarkbox*} the
- counter \Counter{remarkbox}, the commands \Macro{theremarkbox},
+ In addition to the \Environment{remarkbox} and \Environment{remarkbox*} environments,
+ this also defines the \Counter{remarkbox} counter; the commands \Macro{theremarkbox},
\Macro{remarkboxname}, and \Macro{remarkboxformat} that are used for
captions; the commands \Macro{listremarkboxnames} and
- \Macro{listofremarkboxes} that are used at the list of remarks; and some
- internal commands that depends on the file name extension \File{lor} are
- defined. If the package should use a default for the floating type, option
- Option{floattype} may be omitted. If option \Option{nonfloat} will be used
- additionally, then a non-floating environment \Environment{remarkbox-} will
- be also defined. You may use \DescRef{maincls.cmd.caption}\IndexCmd{caption} inside of
- that non-floating environment as usual for floating environments.
+ \Macro{listofremarkboxes} that are used in the list of remarks; and some
+ internal commands that depend on the file name extension \File{lor}.
+ If the package should use a default for the floating type, the
+ Option{floattype} option can be omitted. If the \Option{nonfloat} option is specified,
+ a non-floating environment, \Environment{remarkbox-}, will
+ also be defined, inside which you can use \DescRef{maincls.cmd.caption}\IndexCmd{caption}.
\hyperref[tab:tocbasic.comparison]{Figure~\ref*{tab:tocbasic.comparison}}
- shows a comparison of the commands, counters and environments of the
- example environment \Environment{remarkbox} and of the commands, counters
- and environments for figures.%
+ compares the commands, counters, and environments of the
+ example \Environment{remarkbox} environment to the commands, counters,
+ and environments of figures.%
\begin{table}
\centering
- \caption{Comparison of example environment \Environment{remarkbox}
- and environment \Environment{figure}}
+ \caption{Comparing the example \Environment{remarkbox} environment
+ with the \Environment{figure} environment}
\label{tab:tocbasic.comparison}
\begin{tabularx}{\textwidth}{ll>{\raggedright}p{6em}X}
\toprule
@@ -2277,42 +2375,41 @@ the styles.%
& numeric float type for order perpetuation\\[1ex]
\File{lor} & \File{lof}
&
- & file name extension of the TOC-file of the respective list \\
+ & file name extension of the TOC file of the respective list \\
\bottomrule
\end{tabularx}
\end{table}
- And now a possible usage of the example environment:
+ And here is a possible use of the example environment:
\begin{lstcode}
\begin{remarkbox}
\centering
- Equal should be typeset equally
- and with equal formatting.
- \caption{First theorem of typography}
+ The same thing should always be typeset in the same way
+ and with the same appearance.
+ \caption{First Law of Typography}
\label{rem:typo1}
\end{remarkbox}
\end{lstcode}
- A segment of an example page with this environment could be:
+ A snippet of a sample page with this environment might look like this:
\begin{center}\footnotesize
\begin{tabular}
{|!{\hspace{.1\linewidth}}p{.55\linewidth}!{\hspace{.1\linewidth}}|}
\\
\centering
- Equal should be typeset equally
- and with equal formatting.\\[\abovecaptionskip]
+ The same thing should always be typeset in the same way
+ and with the same appearance.\\[\abovecaptionskip]
{%
\usekomafont{caption}\footnotesize{\usekomafont{captionlabel}%
- Remark 1: }First theorem of typography
+ Remark 1: }First Law of Typography
}\\
\end{tabular}%
\end{center}%
\end{Example}
-Users of \Package{hyperref} should always use option
-\Option{listname}. Otherwise they may get an error message, because
-\Package{hyperref} usually has a problem with the
-\Macro{MakeUppercase}\IndexCmd{MakeUppercase} command that is used to change
-the case of the first letter of \Option{types} in the name of the list.%
+Users of \Package{hyperref} should always use the \Option{listname} option.
+Otherwise they may get an error message because \Package{hyperref} usually has
+a problem with the \Macro{MakeUppercase}\IndexCmd{MakeUppercase} command that
+is needed to convert the first letter of \Option{types} to upper case.%
\EndIndexGroup
%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/typearea-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/typearea-experts.tex
index 62b95b60d48..da2679cc7de 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/typearea-experts.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/typearea-experts.tex
@@ -1,6 +1,6 @@
% ======================================================================
% typearea-experts.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% typearea-experts.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,70 +46,71 @@
% ======================================================================
\KOMAProvidesFile{typearea-experts.tex}
- [$Date: 2017-04-13 09:47:38 +0200 (Thu, 13 Apr 2017) $
+ [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (chapter: typearea)]
-\translator{Markus Kohm\and Gernot Hassenpflug}
+\translator{Markus Kohm\and Gernot Hassenpflug\and Karl Hagen}
-% Date of the translated German file: 2017-04-13
+% Date of the translated German file: 2018-01-31
-\chapter{Additional Information about package \Package{typearea}}
+\chapter{Additional Information about the \Package{typearea} package}
\labelbase{typearea-experts}
\BeginIndexGroup
\BeginIndex{Package}{typearea}
-
-This chapter gives additional information about package
-\Package{typearea}. \iffree{Some parts of the chapter are subject to the
- \KOMAScript{} book \cite{book:komascript} only. This should not be a
- problem, because the}{The} average user, who only want to use the package,
-does not need the information that is addressed to users with non-standard
-requirements or who want to write their own packages using
-\Package{typearea}. Another part of the information describes features of
-\Package{typearea} that exist only because of compatibility to former releases
-of \KOMAScript{} or the standard classes. The features, that exist only
-because of compatibility to former \KOMAScript{} releases, are printed with a
-sans serif font. You should not use them any longer.
+This chapter provides additional information about the \Package{typearea}
+package. \iffree{Some parts of the chapter are found only in the German
+ \KOMAScript{} book \cite{book:komascript}. This should not be a problem,
+ because the}{The} average user, who only wants to use the package, will not
+normally need this information. Part of this material is intended for users
+who want to solve unusual problems or write their own packages using
+\Package{typearea}. Another part covers \Package{typearea} features that exist
+only for compatibility with earlier versions of \KOMAScript{} or with the
+standard classes. The features that exist only for compatibility with earlier
+versions of \KOMAScript{} are printed in a sans serif font. You should not use
+them any longer.
\section{Experimental Features}
\seclabel{experimental}
-This section describes experimental features. Experimental in this context
-means, the function of a feature is not guarantied. There are two reasons for
-this. First of all the final function is not yet defined or implementation is
-not yet established. Second reason is, that a feature may depend on internal
-functions of other packages and therefore the feature can not be guarantied,
-if the other package changes.
+This section describes experimental features. Experimental, in this context,
+means that correct functioning cannot be guaranteed. There can be two reasons
+for designating something experimental. First, the final function is not yet
+defined or its implementation is not yet finalised. Second, a feature may
+depend on internal functions of other packages and therefore the feature can
+not be guaranteed, if the other packages change.
\begin{Declaration}
\OptionVName{usegeometry}{simple switch}
\end{Declaration}
-Usually \Package{typearea} simply ignores whether or not it is used in any
-constellation with package \Package{geometry}\IndexPackage{geometry} (see
-\cite{package:geometry}). This means, \Package{geometry} does not recognize
-any page parameter change done with \Package{typearea}, especially if you
-change the page size or page orientation\,---\,a feature not provided by
-\Package{geometry} itself.
+Usually \Package{typearea} does not care much if you use it with the
+\Package{geometry}\IndexPackage{geometry} package (see
+\cite{package:geometry}) in any configuration. In particular, this means that
+\Package{geometry} does not recognise any changes to the page parameters done
+with \Package{typearea}, for example when it changes the paper size\,---\,a
+feature not provided by \Package{geometry} itself.
Once\ChangedAt{v3.17}{\Package{typearea}} you set option \Option{usegeometry},
\Package{typearea} tries to translate all of its options into options of
-\Package{geometry}. If you use \Package{typearea} inside the document, it even
-calls \Macro{newgeometry}. But since \Package{geometry} does not provide
-changes of page size or page orientation with \Macro{newgeometry},
-\Package{typearea} uses internal macros and lengths of \Package{geometry} to,
-nevertheless, provide such changes. This has been tested with
-\Package{geometry}~5.3 up to 5.6.
+\Package{geometry}. If you activate new parameters inside the document,
+\Package{typearea} even calls \Macro{newgeometry} (see
+\DescRef{\LabelBase.cmd.activateareas} in the following section). Since
+\Package{geometry} does not support changes of paper size or page orientation
+with \Macro{newgeometry}, \Package{typearea} uses internal commands and
+\Package{geometry} lengths to provide such changes as needed. This has been
+tested with \Package{geometry}~5.3 through 5.6.
Note that using \Package{geometry} and changing page size or orientation with
-\Package{typearea} and active \Option{usegeometry} does not mean, that
-\Package{geometry} will automatically use the new paper size in an expected
-manner. \Package{geometry} has an over estimated amount of options. So you
-often need to set up the margins and size of typing area newly using
-\Macro{newgeometry}, because otherwise the typing area may be to large or to
-small. Nevertheless the combination of \Package{typearea} with option
-\Option{usegeometry} and package \Package{geometry} can offer additional
-features or at least option \Option{usegeometry} can improve the co-existence
-of both packages.%
+\Package{typearea} does not mean that \Package{geometry} will automatically
+use the new paper size in an expected manner. For convenience,
+\Package{geometry} provides far more options to adjust the page than are
+required to determine the type area, margins, header, footer, etc.\,---\,this
+is called \emph{overdetermination}\,---\, and at the same time
+\Macro{newgeometry} derives missing information from the known
+values\,---\,known as \emph{value preservation}\,---\,so you often must
+explicitly specify all new values completely when you call \Macro{newgeometry}
+on your own. Nevertheless, when \Package{typearea} takes \Package{geometry}
+into consideration, it opens up additional possibilities.%
\EndIndexGroup
@@ -117,42 +118,43 @@ of both packages.%
\OptionVName{areasetadvanced}{simple switch}
\Macro{areaset}\OParameter{BCOR}\Parameter{width}\Parameter{height}
\end{Declaration}
-Usually \DescRef{typearea.cmd.areaset} does not care for options to define
-height of page header or page footer or whether or not margin elements should
-be part of the typing area same like \DescRef{typearea.cmd.typearea}. With
-option \Option{areasetadvance}\ChangedAt{v3.11}{\Package{typearea}} you can
-change this at most. Nevertheless, settings that result in same size of typing
-area still need not result in same top margin and bottom margin. This is,
-because \DescRef{typearea.cmd.typearea} only changes the bottom margin to have
-a integer number of lines in the typing area and
-\DescRef{typearea.cmd.areaset} always sets the ratio 1:2 for top margin to
-bottom margin. So the identical sizes of typing areas my be shifted vertically
-a little bit depending on which command has been used.%
+Usually, \DescRef{typearea.cmd.areaset} does not handle options to define the
+height of the header or footer, or whether margin elements should count as
+part of the type area in the same way as \DescRef{typearea.cmd.typearea}. With
+the \Option{areasetadvanced}\ChangedAt{v3.11}{\Package{typearea}} option, you
+can make \DescRef{typearea.cmd.areaset} behave more like
+\DescRef{typearea.cmd.typearea} in this regard. Nevertheless, settings for the
+two commands that result in type areas of equal size still can differ because
+\DescRef{typearea.cmd.typearea} always adjusts the type area so that it
+contains an integer number of lines, potentially making the bottom margin up
+to one line smaller, whereas \DescRef{typearea.cmd.areaset} always sets the
+ratio between the top and bottom margins at 1:2. The type area can therefore
+be slightly shifted vertically depending on which command was used.%
\EndIndexGroup
\section{Expert Commands}
\seclabel{experts}
-This section describes commands that are not of interest for average
-users. Nevertheless these commands provide additional features for
-experts. Because the information is addressed to experts it's condensed.
+This section describes commands that are of little or no interest to average
+users. These commands give experts additional possibilities. Because this
+information is addressed to experts, it appears in condensed form.
\begin{Declaration}
\Macro{activateareas}
\end{Declaration}%
-Package \Package{typearea} uses this command to assign settings of typing area
-and margins to internal \LaTeX{} lengths, whenever the type area is newly
-calculated inside of the document, i\.e., after
-\Macro{begin}\PParameter{document}. If option
-\DescRef{typearea.option.pagesize} has been used, it will be executed again
-afterward. With this, e.\,g., the page size may vary inside of a PDF document.
-
-Experts may use this command, if they change lengths like \Length{textwidth}
-or \Length{textheight} inside a document manually for any reason. Nevertheless
-the expert himself is responsible for eventually needed page breaks before or
-after usage of \Macro{activateareas}. Moreover all changes of
-\Macro{activateareas} are local!%
+The \Package{typearea} package uses this command convert the settings for the
+type area and margins to internal \LaTeX{} lengths whenever the type area has
+been recalculated inside of the document, that is after
+\Macro{begin}\PParameter{document}. If the \DescRef{typearea.option.pagesize}
+option has been used, it will be executed again with the same value. Thus, for
+example, the page size may actually vary within PDF documents.
+
+Experts can also use this command if they have manually changed lengths like
+\Length{textwidth} or \Length{textheight} inside a document for any reason. If
+you do so, however, you are responsible for any necessary page breaks before
+or after you call \Macro{activateareas}. Moreover, all changes made by
+\Macro{activateareas} are local.%
%
\EndIndexGroup
@@ -164,14 +166,13 @@ after usage of \Macro{activateareas}. Moreover all changes of
\Macro{AfterRestoreareas}\Parameter{code}%
\Macro{AfterRestoreareas*}\Parameter{code}
\end{Declaration}
-With \Macro{storeareas} a \PName{\Macro{command}} will be defined that may be
-used to restore all current settings of typing area and margins. This provides
-to store the current settings, change them, do anything with valid changed
-settings and restore the previous settings afterwards.
+\Macro{storeareas} defines a \PName{\Macro{command}} which you can use to
+restore all current type-area settings. So you can save the current settings,
+change them, and then restore the previous settings afterwards.
\begin{Example}
- You want a landscape page inside a document with portrait format. No problem
- using \Macro{storeareas}:
+ You want a landscape page inside a document with portrait format. That's
+ no problem using \Macro{storeareas}:
\begin{lstcode}
\documentclass[pagesize]{scrartcl}
@@ -187,59 +188,62 @@ settings and restore the previous settings afterwards.
\noindent\rule{\textwidth}{\textheight}
\end{document}
\end{lstcode}
- Command \DescRef{maincls.cmd.clearpage}\textnote{Attention} before calling
- \Macro{MySavedValues} is important to restore the saved values at the next
- page.
+ It's\textnote{Attention} important to call \DescRef{maincls.cmd.clearpage}
+ before \Macro{MySavedValues} so that the saved values are restored on the
+ next page. With two-sided documents, changes to the paper format should even
+ use \DescRef{maincls.cmd.cleardoubleoddpage}\IndexCmd{cleardoubleoddpage}
+ or\,---\,if you are not using a \KOMAScript{}
+ class\,---\,\DescRef{maincls.cmd.cleardoublepage}%
+ \IndexCmd{cleardoublepage}.%
+ \iffree{\par In addition, \Macro{noindent} is used to avoid paragraph
+ indents of the black boxes. Otherwise, you would not produce a correct
+ image of the type area.}{}%
\end{Example}
-In the example \Macro{noindent} has been used to avoid the paragraph indent of
-the black boxes. Without these commands the boxes would not show the
-typing area correctly.
-Please note\textnote{Attention!} that neither \Macro{storeareas} nor the
-defined \PName{\Macro{command}} should be used inside a group. Internally
+Note\textnote{Attention!} that neither \Macro{storeareas} nor the defined
+\PName{\Macro{command}} defined with it should be used inside a group.
+Internally,
\Macro{newcommand}\IndexCmd{newcommand*}\important{\Macro{newcommand*}} is
-used to define the \PName{\Macro{command}}. So re-usage of a
+used to define the \PName{\Macro{command}}. So reusing a
\PName{\Macro{command}} to store settings again would result in a
corresponding error message.
-Often\ChangedAt{v3.18}{\Package{typearea}} it is useful to automatically
+Often\ChangedAt{v3.18}{\Package{typearea}}, it is useful to automatically
execute commands like \DescRef{maincls.cmd.cleardoubleoddpage} before
-restoring the settings of a \Macro{command} generated by
-\Macro{storeareas}. You can do so using \Macro{BeforeRestoreareas} or
-\Macro{BeforeRestoreareas*}. Analogously you can use \Macro{AfterRestoreareas}
-or \Macro{AfterRestoreareas*} to automatically execute \PName{code} after
-restoring the settings. The variants with and without star differs so that the
-star variant changes only the auto-execution \PName{code} of future
-\PName{command}s and the variant without star also changes the auto-execution
-\PName{code} of already defined \PName{command}s.
-%
+restoring the settings of a \Macro{command} generated by \Macro{storeareas}.
+You can do so using \Macro{BeforeRestoreareas} or \Macro{BeforeRestoreareas*}.
+Similarly, you can use \Macro{AfterRestoreareas} or \Macro{AfterRestoreareas*}
+to automatically execute \PName{code} after restoring the settings. The
+variants with and without the star differ in that the starred variant only
+applies the \PName{code} to future \PName{command}s generated by
+\Macro{storeareas}, whereas the regular variant also adds the \PName{code} to
+previously defined \PName{command}s.%
\EndIndexGroup
\begin{Declaration}
- \Macro{AfterCalculatingTypearea}\Parameter{instructions}%
- \Macro{AfterCalculatingTypearea*}\Parameter{instructions}%
- \Macro{AfterSettingArea}\Parameter{instructions}%
- \Macro{AfterSettingArea*}\Parameter{instructions}
+ \Macro{AfterCalculatingTypearea}\Parameter{code}%
+ \Macro{AfterCalculatingTypearea*}\Parameter{code}%
+ \Macro{AfterSettingArea}\Parameter{cod}%
+ \Macro{AfterSettingArea*}\Parameter{code}
\end{Declaration}%
-These commands manage \emph{hooks}. \Macro{AfterCalculatingTypearea} and it's
-star version provide experts to execute \PName{instructions} every time
-\Package{typearea} has recalculated the typing area and margins either
-implicitly or because of an explicit usage of
-\DescRef{typearea.cmd.typearea}. Similar
-\Macro{AfterSettingArea}\ChangedAt{v3.11}{\Package{typearea}} and it's star
-version provide execution of \PName{instructions} every time
-\DescRef{typearea.cmd.areaset} has been used. While normal versions work
-globally the influence of the star versions is only local. The
-\PName{instructions} will be executed instantly before execution of
-\Macro{activateareas}.\iffree{}{ In \autoref{cha:modernletters}
- \Macro{AfterCalculatingTypearea} will be used in letter class option
- \File{asymTypB.lco} to change the division of the margins.}%
+These commands serve to manage two hooks\Index{hook}. The first two,
+\Macro{AfterCalculatingTypearea} and its starred variant let experts execute
+\PName{code} each time \Package{typearea} recalculates the type area and
+margins, that is after every implicitly or explicit invocation of
+\DescRef{typearea.cmd.typearea}. Similarly,
+\Macro{AfterSettingArea}\ChangedAt{v3.11}{\Package{typearea}} and its starred
+variant allow for executing \PName{code} every time
+\DescRef{typearea.cmd.areaset} has been used. The normal versions have a
+global scope, while changes made in the starred versions are only local. The
+\PName{code} is executed immediately before \Macro{activateareas}.\iffree{}{
+ In \autoref{cha:modernletters}, The letter-class-option file
+ \File{asymTypB.lco} uses it to change the distribution of the margins.}%
%
\EndIndexGroup
-\section{Local Settings with File \File{typearea.cfg}}
+\section{Local Settings with the \File{typearea.cfg} File}
\seclabel{cfg}
\BeginIndexGroup
\BeginIndex{File}{typearea.cfg}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/typearea.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/typearea.tex
index b9e81964ebb..8902d98f0cf 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/typearea.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/typearea.tex
@@ -1,6 +1,6 @@
% ======================================================================
% typearea.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% typearea.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,104 +46,101 @@
% ======================================================================
\KOMAProvidesFile{typearea.tex}%
- [$Date: 2017-08-08 14:38:15 +0200 (Tue, 08 Aug 2017) $
+ [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (chapter: typearea)]
-\translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi}
+\translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi\and
+ Karl Hagen}
-% Date of the translated German file: 2017-08-08
+% Date of the translated German file: 2018-01-31
-\chapter{Construction of the Page Layout with \Package{typearea}}
-\BeginIndexGroup
-\BeginIndex{Package}{typearea}
+\chapter{Calculating the Page Layout with \Package{typearea}}
\labelbase{typearea}
-Many {\LaTeX} classes, including the standard classes, present the user
-with the largely fixed configuration of margins and typearea. With the
-standard classes, the configuration determined is very much dependent
-on the chosen font size. There are
-separate packages, such as
-\Package{geometry}\IndexPackage{geometry} (see
-\cite{package:geometry}), which give the user complete control, but
-also full responsibility, of the settings of typearea and margins.
-
-\KOMAScript{} takes a somewhat different approach with its
-\Package{typearea} package. Here the user is given several
-construction setting and automatization possibilities based on
-established typography standards in order to help guide him or her in
-making a good choice.
-
-It should be noted that the \Package{typearea} package makes use of
-the \Package{scrbase} package. The latter is explained in the expert
-section \iffree{of this document}{of this book} in
-\autoref{cha:scrbase} from \autopageref{cha:scrbase} onwards. The
-majority of the rules documented there are however not directed at the
-user, but rather at authors of classes and packages.
-
+\BeginIndexGroup%
+\BeginIndex{Package}{typearea}%
+Many {\LaTeX} classes\iffree{, including the standard classes,}{} present the
+user with a largely fixed configuration of margins and page layout. In the
+standard classes, the choice is limited to selecting a font size.
+There are separate packages, such as \Package{geometry}\IndexPackage{geometry}
+(see \cite{package:geometry}), which give the user complete control over, but
+also full responsibility for, setting the type area and margins.
+
+\KOMAScript{} takes a somewhat different approach with the \Package{typearea}
+package. Users are offered ways to adjust the design and algorithms based on
+established typographic standards, making it easier for them to make good
+choices.
+
+\iffalse% Umbruchoptimierung!!!
+ Note that the \Package{typearea} package makes use of the \Package{scrbase}
+ package. The latter is explained in the expert section of this
+ \iffree{guide}{book} in \autoref{cha:scrbase} on \autopageref{cha:scrbase}.
+ However, most of the features documented there are directed not to users but
+ to class and package authors.
+\fi
\section{Fundamentals of Page Layout}
\seclabel{basics}
\begin{Explain}
- If you look at a single page of a book or other printed materials,
- you will see that it consists of top, bottom, left, and right
- margins, a (running) head area, the text block, and a (running) foot
- area. There is also a space between the head area and the text
- block, and between the text block and the foot area. The relations
- between these areas are called the \emph{page
- layout}.\Index[indexmain]{page layout}
-
-%%
-%% GH: sollte man schon Hinweise zum Buch hineinarbeiten? Auskommentiert?
-%% \ifx\BUCH\undefined\cite{DANTE:TK0402:MJK}\else(siehe
-%% \autoref{cha:typeareaconstruction})\fi
- The literature contains much discussion of different algorithms and
- heuristic approaches for constructing a good page layout%
+ At first glance, a single page of a book or other printed material
+ consists of the margins,
+ \iffalse% Umbruchkorrekturtext
+ \footnote{The author and the editor have considered the question as to
+ whether, since a page has only one periphery, the term should be
+ ``the margin.'' However, since \LaTeX{} logically divides this one
+ margin into several margins, which are determined separately, we
+ use the term ``the margins'' here.}%
+ \fi%
+ a header, a body of text, and a footer. More precisely, there
+ is also a space between the header area and the text
+ body, as well as between the body and the footer. The text body is
+ called, in the jargon of typographers and typesetters, the \emph{type area}.
+ The division of these areas, as well as their relations to each other and
+ to the paper, is called the \emph{page layout}.\Index[indexmain]{page layout}
+
+ Various algorithms and heuristic methods for constructing an appropriate
+ type area have been discussed in the literature%
\iffree{ \cite{DANTE:TK0402:MJK}}{. A short introduction to the basics may
- be found at \autoref{cha:typeareaconstruction}}%
- . Often mentioned is an approach which involves diagonals and their
- intersections. The result is a page where the text block proportions are
- related to the proportions of the \emph{page}. In a single-sided document,
- the left and the right margin should have equal widths. The relation of the
- upper margin to the lower margin should be 1\(:\)2. In a double-sided
- document\Index{double-sided} (e.\,g. a book) however, the complete inner
- margin (the margin at the spine) should be the same as each of the two outer
- margins; in other words, a single page contributes only half of the inner
- margin.
-
- In the previous paragraph, we mentioned and emphasized \emph{the
- page}. Erroneously, it is often thought that with the page format
- the page is the same as the paper format.\Index[indexmain]{paper
- format} However, if you look at a bound document, it is obvious
- that part of the paper vanishes in the
- binding\Index[indexmain]{binding} and is no longer part of the
- visible page. For the page layout, it is not the format of the paper
- which is important, it is the impression of the visible page to the
- reader. Therefore, it is clear that the calculation of the page
- layout must account for the ``lost'' paper in the binding and add
- this amount to the width of the inner margin. This is called the
- \emph{binding correction}.\Index[indexmain]{binding correction} The
- binding correction is therefore calculated as part of the
- \emph{gutter}\Index[indexmain]{gutter}, not % however of
- the visible
- inner margin.
-
- The binding correction depends on the process of actually
- producing the document and thus cannot be calculated in general.
- Every production process needs its own parameter. In professional
- binding, this parameter is not too important since the printing is
- done on oversized paper which is then cropped to the right size.
- The cropping is done in a way so that the relations for the
- visible double-sided page are as explained above.
-
- Now we know about the relations of the individual parts of a page.
- However, we do not yet know about the width and the height of the
- text block. Once we know one of these values, we can calculate
- all the other values from the paper format and the page format or
- the binding correction.
+ be found at \autoref{cha:typeareaconstruction}}.
+ These rules are known as the ``canons of page construction.'' One approach
+ often mentioned involves diagonals and their intersections. The result is
+ that the aspect ratio of the type area corresponds to the proportions of the
+ \emph{page}. In a one-sided document,\Index{one-sided} the left and right
+ margins should have equal widths, while the ratio of the top and bottom
+ margins should be 1:2. In a two-sided document\Index{two-sided} (e.\,g. a
+ book), however, the entire inner margin (the margin at the spine) should be
+ the same size as each of the two outer margins; in other words, a single
+ page contributes only half of the inner margin.
+
+ In the previous paragraph, we mentioned and emphasised \emph{the page}. It
+ is often mistakenly thought that the format of the page is the same as the
+ format of the paper.\Index[indexmain]{page>format}%
+ \Index[indexmain]{paper>format} However, if you look at
+ a bound document, you can see that part of the paper disappears in the
+ binding\Index[indexmain]{binding} and is no longer part of the visible page.
+ For the type area, however, it is not the format of the paper which is
+ important; it is the impression of the visible page to the reader. Thus, it
+ is clear that the calculation of the type area must account for the ``lost''
+ paper in the binding and add this amount to the width of the inner margin.
+ This is called the \emph{binding correction}.\Index[indexmain]{binding
+ correction} The binding correction is therefore calculated as part of the
+ \emph{gutter}\Index[indexmain]{gutter} but not the visible inner margin.
+
+ The binding correction depends on the production process and cannot be
+ defined in general terms. It is therefore a parameter that must be redefined
+ for each project. In professional printing, this value plays only a minor
+ role, since printing is done on larger sheets of paper and then cropped to
+ the right size. The cropping is done so that the above relations for the
+ visible, two-sided page are maintained.
+
+ So now we know how the individual parts of a page relate to each other.
+ However, we do not yet know how wide and high the type area is. Once we know
+ one of these two dimensions, we can calculate all the other dimensions from
+ the paper format and the page format or the binding correction.
\begin{align*}
- \Var{textblock~height} \Index{textblock height} : \Var{textblock~width} &=
+ \Var{type~area~height}\Index{type area} : \Var{type~area~width} &=
\Var{page~height}\Index{page} : \Var{page~width}\\
- \Var{top~margin}\Index{margin} : \Var{foot~margin} &=
+ \Var{top~margin}\Index{margin} : \Var{footer~margin} &=
\text{1} : \text{2} \\
%
\Var{left~margin} : \Var{right~margin} &= \text{1} : \text{1} \\
@@ -155,134 +152,156 @@ user, but rather at authors of classes and packages.
\Var{binding~correction}\Index{binding correction}\\
%
\Var{top~margin} + \Var{bottom~margin} &=
- \Var{page~height} - \Var{textblock~height} \\
+ \Var{page~height} - \Var{type~area~height} \\
%
\Var{left~margin} + \Var{right~margin} &=
- \Var{page~width} - \Var{textblock~width} \\
+ \Var{page~width} - \Var{type~area~width} \\
%
\Var{half~inner~margin} + \Var{outer~margin} &=
- \Var{page~width} - \Var{textblock~width} \\
+ \Var{page~width} - \Var{type~area~width} \\
%
\Var{half~inner~margin} + \Var{binding~correction} &=
\Var{gutter}\Index{gutter}
\end{align*}
\Index[indexmain]{margin}%
The values \Var{left~margin} and \Var{right~margin} only exist in a
- single-sided document while \Var{half~inner~margin} and
- \Var{outer~margin} only exist in a double-sided document. In these
- equations, we work with \Var{half~inner~margin} since the full inner
- margin belongs to a double-page. Thus, one page has only half of the
- inner margin, \Var{half~inner~margin}.
-
- The question of the width of the textblock is also discussed in
- the literature. The optimum width depends on several factors:
+ one-sided document while \Var{half~inner~margin} and \Var{outer~margin} only
+ exist in a two-sided document. We use \Var{half~inner~margin} in these
+ equations, since the full inner margin is an element of the whole two-page
+ spread. Thus, only half of the inner margin, \Var{half~inner~margin},
+ belongs to a single page.
+
+ The question of the width of the type area is also discussed in the
+ literature. The optimum width depends on several factors:
\begin{itemize}
- \item size, width, type of the font used
- \item line spacing
- \item word length
- \item available room
+ \item the size, width, and type of font used,
+ \item the line spacing,
+ \item the word length,
+ \item the available space.
\end{itemize}
- The importance of the font becomes clear once you think about the
- meaning of serifs. Serifs\Index[indexmain]{serifs} are fine strokes
- finishing off the lines of the letters. Letters whose main strokes
- run orthogonal to the text line disturb the flow rather than keeping
- and leading the eye along the line. Those letters then have serifs
- at the ends of the vertical strokes so that the horizontal serifs
- can help lead the eye horizontally. In addition, they help the eye
- to find the beginning of the next line more quickly. Thus, the line
- length for a serif font can be slightly longer than for a sans serif
- font.
-
- With leading\Index[indexmain]{leading} is meant the vertical
- distance between individual lines of text. In {\LaTeX}, the leading
- is set at about 20\% of the font size. With commands like
- \Macro{linespread}\IndexCmd{linespread} or, better, packages like
- \Package{setspace}\IndexPackage{setspace} (see
- \cite{package:setspace}), the leading can be changed. A wider
- leading helps the eye to follow the line. A very wide leading, on
- the other hand, disturbs reading because the eye has to move a wide
- distance between lines. Also, the reader becomes uncomfortable
- because of the visible stripe effect. The uniform gray value of the
- page is thereby spoiled. Still, with a wider leading, the lines can
- be longer.
+ The importance of the font becomes clear once you realize what serifs are
+ for. Serifs\Index[indexmain]{serifs} are small strokes that finish off the
+ lines of letters. Letters with vertical lines touching the text baseline
+ disturb the flow rather than keeping the eye on the line. It is precisely
+ with these letters that the serifs lie horizontally on the baseline and thus
+ enhance the horizontal effect of the font. The eye can better follow the
+ line of text, not only when reading the words but also when jumping back to
+ the beginning of the next line. Thus, the line length can actually be
+ slightly longer for a serif font than for a sans serif font.
+
+ Leading\Index[indexmain]{leading}\textnote{leading} refers to the vertical
+ distance between individual lines of text. In \LaTeX{}, the leading is set
+ at about 20\% of the font size. With commands like
+ \Macro{linespread}\IndexCmd{linespread}, or better, packages like
+ \Package{setspace}\IndexPackage{setspace} (see \cite{package:setspace}), you
+ can change the leading. A wider leading makes it easy for the eye to follow
+ the line. A very wide leading, however, disturbs reading because the eye has
+ to travel long distances between the lines. In addition, the reader becomes
+ uncomfortable because of the visible striped effect. The uniform grey value
+ of the page is thereby spoiled. Nevertheless, the lines can be longer with a
+ wider leading.
The literature gives different values for good line
- lengths\Index[indexmain]{line length}, depending on the author. To
- some extent, this is related to the native language of the
- author. Since the eye jumps from word to word, short words make this
- task easier. Considering all languages and fonts, a line length of
- 60 to 70 characters, including spaces and punctuation, forms a
- usable compromise. This requires well-chosen leading, but {\LaTeX}'s
- default is usually good enough. Longer line lengths should only be
- considered for highly-developed readers who spend several hours
- daily reading. However, even for such readers, line lengths greater than 80
- characters are unsuitable. In any case, the leading must be
- appropriately chosen. An extra 5\% to 10\% is recommended as a good
- rule of thumb. With fonts such as Palatino, which require some 5\%
- more leading even at normal line lengths, even more can be
- required.
-
- Before looking at the actual construction of the page layout, there
- are just some minor things left to know. {\LaTeX} does not start the
- first line in the text block of a page at the upper edge of the text
- block, but sets the baseline at a defined distance from the top of
- the text block. Also, {\LaTeX} knows the commands
- \Macro{raggedbottom}\IndexCmd{raggedbottom} and
- \Macro{flushbottom}\IndexCmd{flushbottom}. \Macro{raggedbottom}
- specifies that the last line of a page should be positioned wherever
- it was calculated. This means that the position of this line can be
- different on each page, up to the height of one line\,---\,in
- combination of the end of the page with titles, figures, tables or
- similar, even more. In double-sided documents this is usually
- undesirable. \Macro{flushbottom} makes sure that the last line is
- always at the lower edge of the text block. To achieve this,
- {\LaTeX} sometimes needs to stretch vertical glue more than
- allowed. Paragraph skip is such a stretchable, vertical glue, even
- when set to zero. In order to not stretch the paragraph skip on
- normal pages where it is the only stretchable glue, the height of
- the text block should be set to a multiple of the height of the text
- line, including the distance from the upper edge of the text block
- to the first line.
-
- This concludes the introduction to page layout as handled by
- {\KOMAScript}. Now, we can begin with the actual construction.
+ lengths\Index[indexmain]{line length}, depending on the author. To some
+ extent, this is related to the author's native language. Since the eye
+ usually jumps from word to word, short words make this task easier. Across
+ all languages and fonts, a line length of 60 to 70 characters, including
+ spaces and punctuation, forms a usable compromise. This requires well-chosen
+ leading, but {\LaTeX}'s default is usually good enough. Longer line lengths
+ should only be considered for highly-developed readers who spend many hours
+ a day reading. But even then, line lengths beyond 80 characters are
+ unacceptable. In each case, the leading must be appropriately chosen. An
+ extra 5\% to 10\% is recommended as a good rule of thumb. For typefaces like
+ Palatino, which require more than 5\% leading for normal line lengths, even
+ more can be required.
+
+ Before looking at the actual construction of the page layout, there are a
+ few minor points you should know. {\LaTeX} does not start the first line in
+ the text area of a page at the upper edge of the text area but sets the
+ baseline at a defined distance from the top of the text area. Also, {\LaTeX}
+ recognizes the commands
+ \DescRef{maincls.cmd.raggedbottom}\IndexCmd{raggedbottom} and
+ \DescRef{maincls.cmd.flushbottom}\IndexCmd{flushbottom}.
+ \DescRef{maincls.cmd.raggedbottom} specifies that the last line of a page
+ should be positioned wherever it was calculated. This means that the
+ position of this line can be different on each page, up to the height of one
+ line\,---\, even more when the end of the page coincides with headings,
+ figures, tables, or the like. In two-sided documents that is usually
+ undesirable. The second command, \DescRef{maincls.cmd.flushbottom}, makes
+ sure that the last line is always at the lower edge of the text area. To
+ achieve this vertical compensation, {\LaTeX} may have to stretch vertical
+ glue beyond what is normally allowed. Paragraph skip is such a stretchable,
+ vertical glue, even when set to zero. To avoid stretching on normal pages
+ where paragraph spacing is the only stretchable glue, the height of the text
+ area should be a multiple of the height of the text line, including the
+ distance of the first line from the top of the text area.
+
+\iffalse% Umbruchkorrektur
+ This explains all the basics of the type area calculation that play a role
+ in {\KOMAScript}.
+\else
+ This concludes the fundamentals.
+\fi
+\iffalse% Umbruchkorrektur
+ Below are two methods of construction offered by \KOMAScript{}.
+\else
+\iffalse% Umbruchkorrektur
+ Now, we can begin with the actual construction.
+\else
+ In the following two sections, the methods of construction offered by
+ {\KOMAScript} are presented in detail.
+\fi
+\fi
\end{Explain}
-\section{Page Layout Construction by Dividing}
+\section{Constructing the Type Area by Division}
\seclabel{divConstruction}
\begin{Explain}
- The easiest way to make sure that the text area has the same ratios
- as the page is as follows:
+ The easiest way to make sure that the text area has the same ratio as the
+ page is as follows:
\begin{itemize}
- \item First, subtract the part \Var{BCOR}, required for the binding
- correction\Index{binding correction}, from the inner edge of the paper,
- and divide the rest of the page vertically into \Var{DIV} rows of equal
+ \item First, subtract the \Var{BCOR} required for the binding
+ correction\Index{binding correction} from the inner edge of the paper, and
+ divide the rest of the page vertically into \Var{DIV} rows of equal
height.
\item Next, divide the page horizontally into the same number (\Var{DIV}) of
- columns.
+ columns of equal width.
\item Then, take the uppermost row as the upper margin and the two lowermost
- rows as the lower margin. If you are printing double-sided, you similarly
+ rows as the lower margin. If you are printing two-sided, you similarly
take the innermost column as the inner margin and the two outermost
columns as the outer margin.
\item Then add the binding correction \Var{BCOR} to the inner margin.
\end{itemize}
- What now remains of the page is the text area.\Index{text area} The width
- and the height of the text area and margins result automatically from the
- number of rows and columns \Var{DIV}. Since the margins always need three
- stripes, \Var{DIV} must be necessarily greater than three. In order that the
+ What remains within the page is the text area.\Index{text area} The width
+ and height of the text area and margins result automatically from the
+ number of rows and columns, \Var{DIV}. Since the margins always need three
+ stripes, \Var{DIV} must be greater than three. In order that the
text area occupy at least twice as much space as the margins, \Var{DIV}
- should really be equal to or greater than 9. With this value, the
- construction is also known as the \emph{classical division factor of 9} (see
+ should really be at least nine. With this value, the design
+ is also known as the \emph{classical nine-part division} (see
\autoref{fig:typearea.nineparts}).
\begin{figure}
- \centering
- \setlength{\unitlength}{.25mm}
- \definecolor{komalight}{gray}{.75}
- \definecolor{komamed}{gray}{.6}
- \definecolor{komadark}{gray}{.3}
+% \centering
+ \KOMAoption{captions}{bottombeside}%
+ \setcapindent{0pt}%
+ \setlength{\columnsep}{.6em}%
+ \begin{captionbeside}[{%
+ Two-sided layout with the box construction of the classical
+ nine-part division, after subtracting a binding correction%
+ }]{%
+ \label{fig:typearea.nineparts}%
+ \hspace{0pt plus 1ex}%
+ Two-sided layout with the box construction of the classical
+ nine-part division, after subtracting a binding correction%
+ }
+ [l]
+ \setlength{\unitlength}{.25mm}%
+ \definecolor{komalight}{gray}{.75}%
+ \definecolor{komamed}{gray}{.6}%
+ \definecolor{komadark}{gray}{.3}%
\begin{picture}(420,297)
% BCOR
\put(198,0){\color{komalight}\rule{24\unitlength}{297\unitlength}}
@@ -315,144 +334,153 @@ user, but rather at authors of classes and packages.
\footnotesize\makebox(0,0)[r]{\the\numexpr\@multicnt+1\relax}}
\makeatother
\end{picture}
- \caption{Double-sided layout with the box construction of the classical division factor of 9, after subtraction of a binding correction}
- \label{fig:typearea.nineparts}
+ \end{captionbeside}
+% \caption{Two-sided layout with the box construction of the classical
+% nine-part division, after subtracting a binding correction}
+% \label{fig:typearea.nineparts}
\end{figure}
- In {\KOMAScript}, this kind of construction is implemented in the
- \Package{typearea} package, where the bottom margin may drop any
- fractions of a line in order to conform with the minor condition for
- the text area height mentioned in the previous paragraph, and
- thereby to minimize the mentioned problem with
- \Macro{flushbottom}. For A4 paper, \Var{DIV} is predefined according
- to the font size (see \autoref{tab:typearea.div},
+ In {\KOMAScript}, this kind of design is implemented with the
+ \Package{typearea} package, where the bottom margin may drop any fractions
+ of a line in order to comply with the constraint for the height of the type
+ area mentioned in the previous paragraph and thereby reduce the problem
+ mentioned with \Macro{flushbottom}. For A4 paper, \Var{DIV} is predefined
+ according to the font size (see \autoref{tab:typearea.div},
\autopageref{tab:typearea.div}). If there is no binding correction
- (\(\Var{BCOR} = 0\Unit{pt}\)), the results roughly match the values
- of \autoref{tab:typearea.typearea},
- \autopageref{tab:typearea.typearea}.
+ (\(\Var{BCOR} = 0\Unit{pt}\)), the results roughly match the values of
+ \autoref{tab:typearea.typearea}, \autopageref{tab:typearea.typearea}.
- In addition to the predefined values, one can specify \Var{BCOR} and
+ In addition to the predefined values, you can specify \Var{BCOR} and
\Var{DIV} as options when loading the package (see
- \autoref{sec:typearea.options}, from
- \autopageref{sec:typearea.typearea} onwards). There is also a
- command to explicitly calculate the type area by providing these
- values as parameters (also see \autoref{sec:typearea.options},
- \DescPageRef{typearea.cmd.typearea}).
-
- The \Package{typearea} package can automatically determine the
- optimal value of \Var{DIV} for the font and leading used.
- Again, see \autoref{sec:typearea.options},
- \DescPageRef{typearea.option.DIV.calc}.
+ \autoref{sec:typearea.options}, starting on
+ \autopageref{sec:typearea.typearea}). There is also a command to calculate
+ the type area explicitly by providing these values as parameters (see also
+ \autoref{sec:typearea.options}, \DescPageRef{typearea.cmd.typearea}).
+
+ The \Package{typearea} package can automatically determine the optimal value
+ of \Var{DIV} for the font and leading used. Again, see
+ \autoref{sec:typearea.options}, \DescPageRef{typearea.option.DIV.calc}.
\end{Explain}
-\section{Page Layout Construction by Drawing a Circle}
+\section{Constructing the Type Area by Describing a Circle}
\seclabel{circleConstruction}
\begin{Explain}
- In addition to the page layout construction\Index{page layout}
- method previously described, a somewhat more classical method can be
- found in the literature. The aim of this method is not only to
- obtain identical ratios in the page proportions, but it is
- considered optimal when the height of the text block is the same as
- the width of the page. The exact method is described in
+ In addition to the construction method for the type area\Index{type area}
+ described above, there is an even more traditional, or even medieval, method
+ found in the literature. The aim of this method is not just to have the same
+ ratios between page size and type area; it is considered optimal when the
+ height of the text area corresponds to the width of the page. This means
+ that a circle can be drawn that will touch both the sides of the page and
+ the top and bottom of the text area. The exact procedure can be found in
\cite{JTsch87}.
- A disadvantage of this late Middle Age method is that the width of
- the text area is no longer dependent on the font. Thus, one does not
- choose the text area to match the font, but the author or typesetter
- has to choose the font according to the text area. This can be
- considered a ``must''.
-
- In the \Package{typearea} package this construction is changed
- slightly. By using a special (normally meaningless) \Var{DIV} value
- or a special package option, a \Var{DIV} value is chosen to match
- the perfect values of the late Middle Age method as closely as
- possible. See also \autoref{sec:typearea.options},
+ A disadvantage of this late-medieval canon of page construction is that the
+ width of the text area no longer depends on the font. One no longer chooses
+ the text area to match the font. Instead, the author or typesetter must
+ choose the appropriate font for the text area.
+%
+\iftrue
+% Umbruchkorrekturtext
+ This should be considered mandatory.
+\fi
+
+ In the \Package{typearea} package, this construction is modified to
+ determine the \Var{DIV} value by selecting a special (normally meaningless)
+ \Var{DIV} value or a special, symbolic indication of the \Var{DIV} value so
+ that the resulting type area comes as close as possible to the late-medieval
+ page canon. Hence it relies in turn on the method of constructing the type
+ area by division.
+%
+\iffalse
+% Umbruchkorrekturtext
+ If you choose a good font, the result often coincides with the search for
+ the optimal \Var{DIV} value. See also \autoref{sec:typearea.options},
\DescPageRef{typearea.option.DIV.calc}.
+%
+\fi
\end{Explain}
\LoadCommonFile{options}% \section{Early or late Selection of Options}
\LoadCommonFile{compatibility}% \section{Compatibility with Earlier Versions of \KOMAScript}
-\section{Options and Macros to Influence the Page Layout}
+\section{Adjusting the Type Area and Page Layout}
\seclabel{typearea}
-The package \Package{typearea} offers two different user interfaces to
-influence type area construction. The more important method is to load
-the package with options. For information on how to load packages and
-to give package options, please refer to the {\LaTeX} literature,
-e.\,g. \cite{lshort} and \cite{latex:usrguide}, or the examples given
-here. Since the \Package{typearea} package is loaded automatically
-when using the {\KOMAScript} main classes, the package options can be
-given as class options (see \autoref{sec:maincls.options}).
+The \Package{typearea} package offers two different user interfaces to
+influence the construction of the type area. The most important method is to
+specify options when loading the package. For information on how to load
+packages and pass options to packages, please refer to the {\LaTeX}
+literature, for example \cite{lshort} and \cite{latex:usrguide}, or the
+examples given here. Since the \Package{typearea} package is loaded
+automatically when using the main {\KOMAScript} classes, the package options
+can be given as class options (see \autoref{sec:maincls.options}).
-In this section the \Class{protocol} class will be used, not an
-existing {\KOMAScript} class but a hypothetical one. This\iffree{
- documentation}{ book} assumes that ideally there exists a class for
-every specific task.
+In\textnote{Note!} this section the classes used in the examples are not
+existing {\KOMAScript} classes but hypothetical ones. This
+\iffree{guide}{book} assumes that ideally an appropriate class is available
+for each task.
\begin{Declaration}
\OptionVName{BCOR}{correction}
\end{Declaration}%
-With the aid of the option
-\OptionVName{BCOR}{correction}\ChangedAt{v3.00}{\Package{typearea}}
-one may specify the absolute value of the binding
-correction\Index{binding correction}, i.\,e., the width of the area
-which will be lost from the paper width in the binding process. This
-value is then automatically taken into account in the page layout
-construction and in the final output is added to the inner (or the
-left) margin. For the \PName{correction} specification any measurement
-unit understood by \TeX{} is valid.
+Use the \OptionVName{BCOR}{correction}\ChangedAt{v3.00}{\Package{typearea}}
+option to specify the absolute value of the binding correction\Index{binding
+ correction}\textnote{binding correction}, i.\,e. the width of the area lost
+from the paper during the binding process. This value is then automatically
+taken into account when constructing the page layout and is added back to the
+inner (or left) margin during output. In the value of the \PName{correction},
+you can specify any measurement unit understood by \TeX{}.
\begin{Example}
- Assume one is creating a financial report, which should be printed
- out single-sided on A4 paper, and finally kept in a clamp
- folder. The clamp will hide 7.5\Unit{mm}. The stack of pages is very
- thin, thus through paging at most another 0.75\Unit{mm} will be
- lost. Therefore, one may write:
+ Suppose you create a financial report. The whole thing should be printed out
+ one-sided on A4 paper and then stapled in a binder folder. The clip of the
+ folder covers 7.5\Unit{mm}. The stack of pages is very thin, so at most
+ another 0.75\Unit{mm} will be lost from bending and the sheets themselves.
+ Therefore, you can write:
\begin{lstcode}
\documentclass[a4paper]{report}
\usepackage[BCOR=8.25mm]{typearea}
\end{lstcode}
- or
+ with \OptionValue{BCOR}{8.25mm} as an option to \Package{typearea} or
\begin{lstcode}
\documentclass[a4paper,BCOR=8.25mm]{report}
\usepackage{typearea}
\end{lstcode}
- when using \Option{BCOR} as a global option.
+ when using \OptionValue{BCOR}{8.25mm} as a global option.
- When using a {\KOMAScript} class, the explicit loading of the
- \Package{typearea} package can be omitted:
+ When using a {\KOMAScript} class, you do not need to load the
+ \Package{typearea} package explicitly:
\begin{lstcode}
\documentclass[BCOR=8.25mm]{scrreprt}
\end{lstcode}
- The option \Option{a4paper} could be omitted with \Class{scrreprt},
- since this is a predefined setting for all {\KOMAScript} classes.
+ You can omit the \Option{a4paper} option with \Class{scrreprt}, since this
+ is the default for all {\KOMAScript} classes.
- If the option is only later set to a new value, one may then use,
- for example, the following:
+ If you want to set the option to a new value later, you can, for example,
+ use the following:
\begin{lstcode}
\documentclass{scrreprt}
\KOMAoptions{BCOR=8.25mm}
\end{lstcode}
- Thus, at the loading of the \Class{scrreprt} class standard settings
- will be used. When changing the setting with the use of the command
- \DescRef{\LabelBase.cmd.KOMAoptions} or \DescRef{\LabelBase.cmd.KOMAoption} a new page layout with new
- margins will automatically be calculated.
+ Defaults are initialized when the \Class{scrreprt} class is loaded.
+ Changing a setting with the \DescRef{\LabelBase.cmd.KOMAoptions} or
+ \DescRef{\LabelBase.cmd.KOMAoption} commands will automatically calculate a
+ new type area with new margins.
\end{Example}
-Please note that when using this option with one of the {\KOMAScript} classes
-as in the example above, it must be used either as a class option, or passed
-via \DescRef{\LabelBase.cmd.KOMAoptions} or
-\DescRef{\LabelBase.cmd.KOMAoption} after loading the class. The
-\Package{typearea} package should neither be loaded explicitly with
-\DescRef{\LabelBase.cmd.usepackage} when using a {\KOMAScript} class, nor
-should the option be given as an optional argument thereto. If the option is
-changed via \DescRef{\LabelBase.cmd.KOMAoptions} or
-\DescRef{\LabelBase.cmd.KOMAoption} after loading the package, the textblock
-and margins are automatically recalculated anew.%
+Note\textnote{Attention!} you must pass this option as a class option when
+loading one of the {\KOMAScript} classes, as in the example above, or via
+\DescRef{\LabelBase.cmd.KOMAoptions} or \DescRef{\LabelBase.cmd.KOMAoption}
+after loading the class. When you use a {\KOMAScript} class, you should not
+load the \Package{typearea} package explicitly with
+\DescRef{\LabelBase.cmd.usepackage}, nor should you specify it as an optional
+argument when loading the package if you are using another class. If the
+option is changed with \DescRef{\LabelBase.cmd.KOMAoptions} or
+\DescRef{\LabelBase.cmd.KOMAoption} after loading the package, the type area
+and margins are automatically recalculated.%
%
\EndIndexGroup
@@ -460,39 +488,42 @@ and margins are automatically recalculated anew.%
\begin{Declaration}
\OptionVName{DIV}{factor}
\end{Declaration}%
-With the aid of the option
-\OptionVName{DIV}{factor}\ChangedAt{v3.00}{\Package{typearea}} the
-number of stripes into which the page is divided horizontally and
-vertically during the page layout construction is set. The exact
-construction method is found in
-\autoref{sec:typearea.divConstruction}. Of importance is that the
-larger the \PName{factor}, the larger the text block and the smaller
-the margins. Any integer value greater than 4 is valid for
-\PName{factor}. Please note that large values can lead to
-unfulfillment of various minor conditions in the type area, depending
-on further options chosen. Thus, in an extreme case, the header may
-fall outside of the page. Users applying the option
-\OptionVName{DIV}{factor} are themselves responsible for fulfillment
-of the marginal conditions and setting of a typographically aesthetic
-line length.
-
-In \autoref{tab:typearea.typearea} are found the type area sizes for
-several \Var{DIV} factors for an A4 page without binding correction. Here
-the minor conditions dependent on font size are not considered.
+The \OptionVName{DIV}{factor}\ChangedAt{v3.00}{\Package{typearea}} option
+specifies the number of strips into which the page is divided horizontally and
+vertically during the construction of the type area. The exact construction
+method is found in \autoref{sec:typearea.divConstruction}. It's important to
+realise that the larger the \PName{factor}, the larger the text block and the
+smaller the margins. Any integer value greater than 4 is valid for
+\PName{factor}. Note, however, that large values can cause violations in the
+constraints on the margins of the type area, depending on how you set other
+options. In extreme cases, the header may fall outside of the page. When you
+use the \OptionVName{DIV}{factor} option, you are responsible for complying
+with the margin constraints and for choosing a typographically pleasing line
+length.
+
+In \autoref{tab:typearea.typearea}, you will find the sizes of the type areas
+for several \Var{DIV} factors for the A4 page with no binding correction. In
+this case, the other constraints that are dependent on the font size are not
+taken into account.
\begin{table}
- \centering
- \caption[{Type area dimensions dependent on \Var{DIV} for A4}]{Type area
- dimensions dependent on \Var{DIV} for A4 regardless of \Length{topskip}}
- \begin{tabular}{ccccc}
+% \centering
+ \KOMAoptions{captions=topbeside}%
+ \setcapindent{0pt}%
+ \begin{captionbeside}
+% \caption
+ [{Type area dimensions dependent on \Var{DIV} for A4}]
+ {\label{tab:typearea.typearea}Type area dimensions dependent on \Var{DIV}
+ for A4 regardless of \Length{topskip} or \Var{BCOR}}
+ [l]
+ \begin{tabular}[t]{ccccc}
\toprule
&
\multicolumn{2}{c}{Type area} & \multicolumn{2}{c}{Margins}\\
%\raisebox{1.5ex}[0pt]{
\Var{DIV}
%}
- &
- width [mm] & height [mm] & top [mm] & inner [mm] \\
+ & width & height & top & inner \\
\midrule
6 & 105.00 & 148.50 & 49.50 & 35.00 \\
7 & 120.00 & 169.71 & 42.43 & 30.00 \\
@@ -505,43 +536,43 @@ the minor conditions dependent on font size are not considered.
14 & 165.00 & 233.36 & 21.21 & 15.00 \\
15 & 168.00 & 237.60 & 19.80 & 14.00 \\
\bottomrule
+ \multicolumn{5}{r}{\small (all lengths in mm)}
\end{tabular}
- \label{tab:typearea.typearea}
+ \end{captionbeside}
\end{table}
-\iffree{}{\clearpage}%
+
\begin{Example}
- Assume one wants to write a meeting protocol, using the
- \Class{protocol} class. The document should be double-sided. In the
- company 12\Unit{pt} Bookman font is used. This font, which belongs
- to the standard PostScript fonts, is activated in {\LaTeX} with the
- command \verb|\usepackage{bookman}|. The Bookman font is a very
- wide font, meaning that the individual characters have a large width
- relative to their height. Therefore, the predefined value for
- \Var{DIV} in \Package{typearea} is insufficient. Instead of the
- value of 12 it appears after thorough study of this entire chapter
- that a value of 15 should be most suitable. The protocol will not
- be bound but punched and kept in a folder. Thus, no binding
- correction is necessary. One may then write:
+ Suppose you are writing up the minutes of a meeting using the
+ \Class{minutes} class. The whole thing should be two-sided. Your company
+ uses 12\Unit{pt} Bookman font. This font, which is one of the standard
+ PostScript fonts, is enabled in {\LaTeX} with the command
+ \verb|\usepackage{bookman}|. Bookman is a very wide font, meaning that the
+ individual characters are relatively wide compared to their height.
+ Therefore, the default setting for \Var{DIV} in \Package{typearea} is too
+ small. After thoroughly studying this entire chapter, you conclude that a
+ value of 15, instead of 12, is most suitable. The minutes will not be bound
+ but punched and kept in a folder, and thus no binding correction is
+ necessary. So you write:
\begin{lstcode}
- \documentclass[a4paper,twoside]{protocol}
+ \documentclass[a4paper,twoside]{minutes}
\usepackage{bookman}
\usepackage[DIV=15]{typearea}
\end{lstcode}
- On completion, it is decided that the protocols will from now on be
- collected and bound quarterly into book format. The binding is to be
- a simple glue binding, because it is only done to conform with
- ISO\,9000 and nobody is actually going to read them. For the binding
- including space lost in turning the pages, an average of 12\Unit{mm}
- is required. Thus, one may change the options of the
- \Package{typearea} package accordingly, and use the class for
- protocols conforming to ISO\,9000 regulations:
+ When you're done, you become aware that the minutes will from now on be
+ collected and bound together as a book at the end of the quarter. The
+ binding is to be a simple glue binding because this is only being done to
+ conform to ISO\,9000 and nobody is actually going to read them. The binding,
+ including space lost in folding the pages, requires an average of
+ 12\Unit{mm} You change the options of the \Package{typearea} package
+ accordingly and use the class for minutes that conform to ISO\,9000
+ regulations:
\begin{lstcode}
\documentclass[a4paper,twoside]{iso9000p}
\usepackage{bookman}
\usepackage[DIV=15,BCOR=12mm]{typearea}
\end{lstcode}
- Of course, it is equally possible to use here a {\KOMAScript} class:
+ Of course, it is equally possible to use a {\KOMAScript} class here:
\begin{lstcode}
\documentclass[twoside,DIV=15,BCOR=12mm]{scrartcl}
\usepackage{bookman}
@@ -551,16 +582,16 @@ the minor conditions dependent on font size are not considered.
classes.
\end{Example}
-Please note that when using the \Option{DIV} option with one of the
-{\KOMAScript} classes as in the example above, it must be used either as a
-class option, or passed via \DescRef{\LabelBase.cmd.KOMAoptions} or
-\DescRef{\LabelBase.cmd.KOMAoption} after loading the class. The
-\Package{typearea} package should neither be loaded explicitly with
-\DescRef{\LabelBase.cmd.usepackage} when using a {\KOMAScript} class, nor
-should the option be given as an optional argument thereto. If the option is
-changed via \DescRef{\LabelBase.cmd.KOMAoptions} or
-\DescRef{\LabelBase.cmd.KOMAoption} after loading the package, the textblock
-and margins are automatically recalculated anew.%
+Note\textnote{Attention!} that when using this option with one of the
+{\KOMAScript} classes, as in the example above, it must be passed either as a
+class option, or via \DescRef{\LabelBase.cmd.KOMAoptions} or
+\DescRef{\LabelBase.cmd.KOMAoption} after loading the class. When using a
+{\KOMAScript} class, the \Package{typearea} package should not be loaded
+explicitly with \DescRef{\LabelBase.cmd.usepackage}, nor should the option be
+given as an optional argument thereto. If the option is changed via
+\DescRef{\LabelBase.cmd.KOMAoptions} or \DescRef{\LabelBase.cmd.KOMAoption}
+after loading the package, the type area and margins are automatically
+recalculated.%
\EndIndexGroup
\begin{Declaration}
@@ -568,198 +599,213 @@ and margins are automatically recalculated anew.%
\OptionValue{DIV}{classic}
\end{Declaration}%
As\ChangedAt{v3.00}{\Package{typearea}} already mentioned in
-\autoref{sec:typearea.divConstruction}, for A4 paper there are fixed
-predefined settings for the \Var{DIV} value. These can be found in
-\autoref{tab:typearea.div}. If a different paper format is chosen,
-then the \Package{typearea} package independently calculates an
-appropriate \Var{DIV} value. Of course this same calculation can be
-applied also to A4. To obtain this result, one simply uses the
-\OptionValue{DIV}{calc} option in place of the
-\OptionVName{DIV}{factor} option. This option can just as easily be
-explicity given for other paper formats. If one desires an automatic
-calculation, this also makes good sense, since the possibility exists
-to configure different predefined settings in a configuration file
-(see \autoref{sec:typearea-experts.cfg}). An explicit passing of the
-\OptionValue{DIV}{calc} option then overwrites such configuration
-settings.
+\autoref{sec:typearea.divConstruction}, there are fixed defaults for
+\Var{DIV} when using A4 paper. These can be found in \autoref{tab:typearea.div}.
+However, such fixed values have the disadvantage that they do not take into
+account the letter spacing of the font used. With A4 and fairly narrow fonts,
+this can quickly lead to an unpleasantly high number of characters per line.
+See the considerations in \autoref{sec:typearea.basics}. If you choose a
+different paper size, \Package{typearea} will calculate an appropriate
+\Var{DIV} value for you. Of course, you can also apply this same calculation
+to A4. To do so, simply use \OptionValue{DIV}{calc}%
+\important{\OptionValue{DIV}{calc}} in place of
+\OptionVNameRef{\LabelBase}{DIV}{factor}. Of course, you can also specify this
+option explicitly for all other paper sizes. If you want automatic
+calculation, this specification is useful, as it is possible to set different
+preferences in a configuration file (see \autoref{sec:typearea-experts.cfg}).
+Explicitly specifying the \OptionValue{DIV}{calc} option overrides such
+configuration settings.
\begin{table}
- \centering
- \caption{\label{tab:typearea.div}Predefined settings of \PName{DIV} for A4}
- \begin{tabular}{lccc}
+% \centering
+ \KOMAoptions{captions=topbeside}%
+ \setcapindent{0pt}%
+ \begin{captionbeside}
+ %\caption
+ [{\PName{DIV} defaults for A4}]
+ {\label{tab:typearea.div}\PName{DIV} defaults for A4}
+ [l]
+ \begin{tabular}[t]{lccc}
\toprule
base font size: & 10\Unit{pt} & 11\Unit{pt} & 12\Unit{pt} \\
\Var{DIV}: & 8 & 10 & 12 \\
\bottomrule
\end{tabular}
+ \end{captionbeside}
\end{table}
-The classical page layout construction, the Middle Age book design canon,
-mentioned in \autoref{sec:typearea.circleConstruction}, is similarly
-selectable. Instead of the
-\OptionVName{\DescRef{\LabelBase.option.DIV}}{factor} or
-\OptionValue{DIV}{calc} option, one may use the \OptionValue{DIV}{classic}
-option. A \Var{DIV} value closest to the Middle Age book design canon is then
-chosen.
+You can also select the traditional page layout mentioned in
+\autoref{sec:typearea.circleConstruction}, the medieval page canon. Instead of
+the \OptionVName{\DescRef{\LabelBase.option.DIV}}{factor} or
+\OptionValue{DIV}{calc} option, simply use the \OptionValue{DIV}{classic}
+option. A \Var{DIV} value which is as close as possible to the medieval page
+canon is then chosen.
\begin{Example}
- In the example using the Bookman font with the
- \OptionVName{\DescRef{\LabelBase.option.DIV}}{factor} option, exactly that
- problem of choosing a more appropriate \Var{DIV} value for the font
- arose. As a variation on that example, one could simply leave the choice of
- such a value to the \Package{typearea} package:
+ In the example using the Bookman font and the
+ \OptionVNameRef{\LabelBase}{DIV}{factor} option, the problem was to select a
+ \Var{DIV} value that better matched the font. Modifying that example, you
+ can simply leave the calculation of this value to \Package{typearea}:
\begin{lstcode}
\documentclass[a4paper,twoside]{protocol}
\usepackage{bookman}
\usepackage[DIV=calc]{typearea}
\end{lstcode}
\end{Example}
-
-Please note that when using this option with one of the {\KOMAScript} classes
-as in the example above, it must be used either as a class option, or passed
-via \DescRef{\LabelBase.cmd.KOMAoptions} or
-\DescRef{\LabelBase.cmd.KOMAoption} after loading the class. The
-\Package{typearea} package should neither be loaded explicitly with
-\DescRef{\LabelBase.cmd.usepackage} when using a {\KOMAScript} class, nor
-should the option be given as an optional argument thereto. If the option is
-changed via \DescRef{\LabelBase.cmd.KOMAoptions} or
-\DescRef{\LabelBase.cmd.KOMAoption} after loading the package, the textblock
-and margins are automatically recalculated anew.%
+\iffree{\par%
+ Note\textnote{Attention!} that when using this option with one of the
+ \KOMAScript{} classes%
+ \iftrue , as in the example above, \fi%
+ it must be passed either as a class option, or via
+ \DescRef{\LabelBase.cmd.KOMAoptions} or \DescRef{\LabelBase.cmd.KOMAoption}
+ after loading the class. When using a {\KOMAScript} class, the
+ \Package{typearea} package should not be loaded explicitly with
+ \DescRef{\LabelBase.cmd.usepackage}, nor should the option be given as an
+ optional argument. If the option is changed via
+ \DescRef{\LabelBase.cmd.KOMAoptions} or \DescRef{\LabelBase.cmd.KOMAoption}
+ after loading the package, the type area and margins are automatically
+ recalculated.%
+}{%
+\vskip-\dp\strutbox% Wegen Code im Beispiel am Ende
+}%
%
\EndIndexGroup
\begin{Declaration}
- \OptionValue{DIV}{current}%
+ \OptionValue{DIV}{current}
\OptionValue{DIV}{last}
\end{Declaration}%
-Readers\ChangedAt{v3.00}{\Package{typearea}} who have followed the
-examples with acuity actually already know how to calculate a
-\Var{DIV} value dependent on the chosen font, when a {\KOMAScript}
-class is used together with a font package.
+If\ChangedAt{v3.00}{\Package{typearea}} you've been following the
+examples closely, you already know how to calculate a \Var{DIV} value
+based on the font you chose when using a {\KOMAScript} class together
+with a font package.
\begin{Explain}
- The problem is that the {\KOMAScript} class already loads the
+ The problem with this is that the {\KOMAScript} class already loads the
\Package{typearea} package itself. Thus, it is not possible to pass options
as optional arguments to \DescRef{\LabelBase.cmd.usepackage}. It would also
- be pointless to pass the \OptionValueRef{\LabelBase}{DIV}{calc} option as an
- optional argument to \DescRef{\LabelBase.cmd.documentclass}. This option
+ be pointless to specify the \OptionValueRef{\LabelBase}{DIV}{calc} option as
+ an optional argument to \DescRef{\LabelBase.cmd.documentclass}. This option
would be evaluated immediately on loading the \Package{typearea} package and
- as a result the text block and margin would be chosen according to the
- {\LaTeX} standard font and not for the later loaded font. However, it is
- quite possible to recalculate the text block and margins anew after loading
- the font, with the aid of \DescRef{\LabelBase.cmd.KOMAoptions}%
+ as a result the type area and margins would be calculated for the standard
+ {\LaTeX} font and not for the font loaded later.
+
+ However, it is possible to recalculate the type area and margins after
+ loading the font with the aid of \DescRef{\LabelBase.cmd.KOMAoptions}%
\PParameter{\OptionValueRef{\LabelBase}{DIV}{calc}} or
\DescRef{\LabelBase.cmd.KOMAoption}%
- \PParameter{\DescRef{\LabelBase.option.DIV}}\PParameter{calc}. Via
- \PValue{calc} an appropriate \Var{DIV} value for a good line length is then
- chosen.
-
- As it is often more practical to set the \Option{DIV} option not
- after loading the font, but at a more visible point, such as when
- loading the class, the \Package{typearea} package offers two further
- symbolic values for this option.
+ \PParameter{\DescRef{\LabelBase.option.DIV}}\PParameter{calc}. The option
+ \PValue{calc} will then request a \Var{DIV} value for an appropriate line
+ length.
+
+ As it is often more convenient to set the \Option{DIV} option not after
+ loading the font but at a more noticeable point, such as when loading the
+ class, the \Package{typearea} package offers two further symbolic values for
+ this option.
\end{Explain}
-With \OptionVName{DIV}{current}\ChangedAt{v3.00}{\Package{typearea}}
-a renewed calculation of text block and margin is requested, in which
-the currently set \Var{DIV} will be used. This is less of interest for
-renewed type area calculations after loading a different font; it is
-rather more useful for determining, for example, after changing the
-leading, while keeping \Var{DIV} the same, that the marginal condition
-is fulfilled that \Length{textheight} less
-\Length{topskip} is a multiple of \Length{baselineskip}.
+The option \OptionVName{DIV}{current}\ChangedAt{v3.00}{\Package{typearea}}
+recalculates the type area and margins using the current \Var{DIV} value.
+This is less important for recalculating the type area after loading a
+different font. Instead, it is useful if, for example, you change the
+leading while keeping \Var{DIV} the same and want to ensure the
+margin constraint that \Length{textheight} minus \Length{topskip} is a
+multiple of \Length{baselineskip}.
-With \OptionVName{DIV}{last}\ChangedAt{v3.00}{\Package{typearea}} a
-renewed calculation of text block and margin is requested, where
-exactly the same setting is used as in the last calculation.
+The option \OptionVName{DIV}{last}\ChangedAt{v3.00}{\Package{typearea}} will
+recalculate type area and margins using exactly the same settings as the last
+calculation.
\begin{Example}
- Let us take up the previous example again, in which a good line
- length is required for a type area using the Bookman font. At the
- same time, a {\KOMAScript} class is to be used. This is easily
- possible using the symbolic value \PValue{last} and the command
- \DescRef{\LabelBase.cmd.KOMAoptions}:
+ Let's suppose again that we need to calculate an appropriate line length for
+ a type area using the Bookman font. At the same time, a {\KOMAScript} class
+ is used. This is very easy with the symbolic value \PValue{last} and the
+ command \DescRef{\LabelBase.cmd.KOMAoptions}:
\begin{lstcode}
\documentclass[BCOR=12mm,DIV=calc,twoside]{scrartcl}
\usepackage{bookman}
\KOMAoptions{DIV=last}
\end{lstcode}
-If it should later be decided that a different \Var{DIV} value is
-required, then only the setting of the optional argument to
-\DescRef{\LabelBase.cmd.documentclass} need be changed.
+If you decide later that you need a different \Var{DIV} value, just change the
+setting of the optional argument to \DescRef{\LabelBase.cmd.documentclass}.
\end{Example}
-A summary of all possible symbolic values for the \Option{DIV} option
-can be found in \autoref{tab:symbolicDIV}. At this point it is noted
-that the use of the \Package{fontenc}\IndexPackage{fontenc} package
-can also lead to \LaTeX{} loading a different font.
+For a summary of all possible symbolic values for the \Option{DIV} option, see
+\autoref{tab:symbolicDIV}. Note that the use of the
+\Package{fontenc}\IndexPackage{fontenc} package may also cause \LaTeX{} to
+load a different font.
\begin{table}
- \caption[{Symbolic values for the \Option{DIV} option and the
- \PName{DIV} argument to \DescRef{\LabelBase.cmd.typearea}}]{Possible symbolic values for the \Option{DIV} option or the \PName{DIV} argument to
- \DescRef{\LabelBase.cmd.typearea}\OParameter{BCOR}\Parameter{DIV}}
+ \caption[{%
+ Symbolic values for the \DescRef{typearea.option.DIV} option and the
+ \PName{DIV} argument to \DescRef{\LabelBase.cmd.typearea}%
+ }]{%
+ Available symbolic values for the \DescRef{typearea.option.DIV} option or
+ the \PName{DIV} argument to
+ \DescRef{typearea.cmd.typearea}\OParameter{BCOR}\Parameter{DIV}%
+ }
\label{tab:symbolicDIV}
\begin{desctabular}
\pventry{areaset}{Recalculate page
- layout.\IndexOption{DIV~=areaset}}%
- \pventry{calc}{Recalculate type area including choice of
- appropriate \Var{DIV} value.\IndexOption{DIV~=calc}}%
- \pventry{classic}{Recalculate type area using Middle Age book
- design canon (circle-based
- calculation).\IndexOption{DIV~=classic}}%
+ layout.\IndexOption{DIV~=\textKValue{areaset}}}%
+ \pventry{calc}{Recalculate type area including choice of appropriate
+ \Var{DIV} value.\IndexOption{DIV~=\textKValue{calc}}}%
+ \pventry{classic}{Recalculate type area using medieval book design canon
+ (circle-based calculation).\IndexOption{DIV~=\textKValue{classic}}}%
\pventry{current}{Recalculate type area using current \Var{DIV}
- value.\IndexOption{DIV~=current}}%
- \pventry{default}{Recalculate type area using the standard value
- for the current page format and current font size. If no
- standard value exists, \PValue{calc} is
- used.\IndexOption{DIV~=default}}%
- \pventry{last}{Recalculate type area using the same \PName{DIV}
- argument as was used in the last call.\IndexOption{DIV~=last}}%
+ value.\IndexOption{DIV~=\textKValue{current}}}%
+ \pventry{default}{Recalculate type area using the standard value for the
+ current page format and current font size. If no standard value exists,
+ \PValue{calc} is used.\IndexOption{DIV~=\textKValue{default}}}%
+ \pventry{last}{Recalculate type area using the same \PName{DIV} argument
+ as was used in the last call.\IndexOption{DIV~=\textKValue{last}}}%
\end{desctabular}
\end{table}
-Often the renewed type area calculation is required in combination
-with a change in the line spacing
-(\emph{leading})\Index{leading}. Since the type area should be
-calculated such that an integer number of lines fit in the text block,
-a change in the leading normally requires a recalculation of the page
-layout.
+Frequently\textnote{Attention!}, the type area must be recalculated in
+combination with a change in the line spacing (\emph{leading})\Index{leading}.
+Since the type area should be calculated in such a way that a whole number of
+lines fits in the text block, a change in the leading normally requires a
+recalculation of the type area.
\begin{Example}
- For a thesis document, a font of size 10\Unit{pt} and a spacing of
- 1.5 lines is required. By default, {\LaTeX} sets the leading for
- 10\Unit{pt} at 2\Unit{pt}, in other words 1.2 lines. Therefore, an
- additional stretch factor of 1.25 is needed. Additionally, a binding
- correction of \(12\Unit{mm}\) is stipulated. Then the solution could be
- written as follows:
+ Suppose that a 10\Unit{pt} font of and a spacing of 1.5 lines is required
+ for a dissertation. By default, {\LaTeX} sets the leading for 10\Unit{pt}
+ fonts at 2\Unit{pt}, in other words 1.2 lines. Therefore, an additional
+ stretch factor of 1.25 must be used. Suppose also that a binding correction
+ of \(12\Unit{mm}\) is needed. Then the solution to the problem might look
+ like this:
\begin{lstcode}
\documentclass[10pt,twoside,BCOR=12mm,DIV=calc]{scrreprt}
\linespread{1.25}
\KOMAoptions{DIV=last}
\end{lstcode}\IndexCmd{linespread}
- Since \Package{typearea} always executes the command
- \Macro{normalsize} itself upon calculation of a new type area, it is
- not necessary to activate the chosen leading with \Macro{selectfont}
- after \Macro{linespread}, since this will be used already in the
- recalculation.
-
- When using the \Package{setspace}\IndexPackage{setspace} package (see
- \cite{package:setspace}), the same example would appear as follows:
+ Since \Package{typearea} always executes the \Macro{normalsize} command
+ itself when calculating a new type area, it is not strictly necessary to
+ set the chosen leading with \Macro{selectfont} after \Macro{linespread},
+ since this will already be done in the recalculation.
+
+ When using the \Package{setspace}\IndexPackage{setspace}%
+ \important{\Package{setspace}} package (see \cite{package:setspace}), the
+ same example would appear as follows:
\begin{lstcode}
\documentclass[10pt,twoside,BCOR=12mm,DIV=calc]{scrreprt}
- \usepackage{setspace}
- \onehalfspacing
+ \usepackage[onehalfspacing]{setspace}
\KOMAoptions{DIV=last}
\end{lstcode}
- As can be seen, with the use of the \Package{setspace} package one no longer
- needs to know the correct stretch value.
+\end{Example}
- At this point it should be noted that the line spacing for the title
- page should be reset to the normal value.
-\iffalse% Umbruchkorrektur
- A complete example would be:\IndexPackage{setspace}
-\fi
+As\textnote{Hint!} you can see from the example, the \Package{setspace}
+package saves you from needing to know the correct stretch value. However,
+this only applies to the standard font sizes 10\Unit{pt}, 11\Unit{pt}, and
+12\Unit{pt}. For all other font sizes, the package uses an approximate value.
+
+At\textnote{Attention!} this point, note that the line spacing for the title
+page should be reset to the normal value, and the indexes should be set with
+the normal line spacing as well.
+\begin{Example}
+ Here\IndexPackage{setspace} is a complete example:
\begin{lstcode}
\documentclass[10pt,twoside,BCOR=12mm,DIV=calc]
{scrreprt}
@@ -777,28 +823,29 @@ layout.
\chapter{Ok}
\end{document}
\end{lstcode}
- See further also the notes in \autoref{sec:typearea.tips}. The command
- \DescRef{tocbasic.cmd.AfterTOCHead}\IndexCmd{AfterTOCHead} will be described
- in \autoref{cha:tocbasic} of \autoref{part:forExperts} on
+ Also see the notes in \autoref{sec:typearea.tips}. The
+ \DescRef{tocbasic.cmd.AfterTOCHead}\IndexCmd{AfterTOCHead} command is
+ described in \autoref{cha:tocbasic} of \autoref{part:forExperts} on
\DescPageRef{tocbasic.cmd.AfterTOCHead}.
\end{Example}
-Note, changing the line spacing could also influence page head and
-footer. For example, if you are using package \Package{scrlayer}, you have to
-decide in such cases whether you want to have the normal line spacing or the
-changed to be used in the page head and footer. See option
-\DescRef{scrlayer.option.singlespacing} in \autoref{cha:scrlayer} on
-\DescPageRef{scrlayer.option.singlespacing} for more information.
-
-Please note that when using this option with one of the {\KOMAScript} classes
-as in the example above, it must be used either as a class option, or passed
-via \DescRef{\LabelBase.cmd.KOMAoptions} or
-\DescRef{\LabelBase.cmd.KOMAoption} after loading the class. The
-\Package{typearea} package should neither be loaded explicitly with
-\DescRef{\LabelBase.cmd.usepackage} when using a {\KOMAScript} class, nor
-should the option be given as an optional argument thereto. If the option is
-changed via \DescRef{\LabelBase.cmd.KOMAoptions} or
-\DescRef{\LabelBase.cmd.KOMAoption} after loading the package, the textblock
-and margins are automatically recalculated anew.%
+Note also that changing the line spacing can also affect the page's header and
+footer. For example, if you are using the \Package{scrlayer-scrpage} package,
+you have to decide for yourself whether you prefer to have the normal or the
+changed leading. See the \DescRef{scrlayer.option.singlespacing} option in
+\autoref{cha:scrlayer}\important{\hyperref[cha:scrlayer]{\Package{scrlayer}}}%
+\IndexPackage{scrlayer}\IndexOption{singlespacing},
+\DescPageRef{scrlayer.option.singlespacing}.
+
+Note\textnote{Attention!} that when using this option with one of the
+{\KOMAScript} classes, as in the example above, it must be passed either as a
+class option, or via \DescRef{\LabelBase.cmd.KOMAoptions} or
+\DescRef{\LabelBase.cmd.KOMAoption} after loading the class. When using a
+{\KOMAScript} class, the \Package{typearea} package should not be loaded
+explicitly with \DescRef{\LabelBase.cmd.usepackage}, nor should the option be
+given as an optional argument thereto. If the option is changed via
+\DescRef{\LabelBase.cmd.KOMAoptions} or \DescRef{\LabelBase.cmd.KOMAoption}
+after loading the package, the type area and margins are automatically
+recalculated.%
%
\EndIndexGroup
@@ -809,57 +856,60 @@ and margins are automatically recalculated anew.%
\end{Declaration}%
\begin{Explain}
If the \DescRef{\LabelBase.option.DIV} option or the
- \DescRef{\LabelBase.option.BCOR} option is set after loading of the
- \Package{typearea} package, then internally the command \Macro{typearea} is
- called. When setting the \DescRef{\LabelBase.option.DIV} option the symbolic
- value \PValue{current} is used internally for \PName{BCOR}, which for
- reasons of completeness is found also in \autoref{tab:symbolicBCOR}. When
- setting the \DescRef{\LabelBase.option.BCOR} option, the symbolic value
- \PValue{last} is used internally for \PName{DIV}. If it is instead desired
- that the text block and margins should be recalculated using the symbolic
- value \PValue{current} for \PName{DIV}, then
- \Macro{typearea}\POParameter{current}\PParameter{current} can be used
- directly.
+ \DescRef{\LabelBase.option.BCOR} option is set after loading the
+ \Package{typearea} package, the \Macro{typearea} command will be called
+ internally. When setting the \DescRef{\LabelBase.option.DIV} option, the
+ symbolic value \PValue{current} is used internally for \PName{BCOR}, which
+ for reasons of completeness is also found in \autoref{tab:symbolicBCOR}.
+ When setting the \DescRef{\LabelBase.option.BCOR} option, the symbolic value
+ \PValue{last} is used internally for \PName{DIV}. If instead you want the
+ type area and margins to be recalculated using the symbolic value
+ \PValue{current} for \PName{DIV}, you can use
+ \Macro{typearea}\POParameter{current}\PParameter{current} directly.
\end{Explain}
\begin{table}
- \caption[{Symoblic \PName{BCOR} arguments for
- \Macro{typearea}}]{Possible symbolic \PName{BCOR} arguments for
- \Macro{typearea}\OParameter{BCOR}\Parameter{DIV}}
+ \caption[{%
+ Symbolic \PName{BCOR} arguments for \DescRef{typearea.cmd.typearea}%
+ }]{%
+ Available symbolic \PName{BCOR} arguments for
+ \Macro{typearea}\OParameter{BCOR}\Parameter{DIV}%
+ }
\label{tab:symbolicBCOR}
\begin{desctabular}
\pventry{current}{Recalculate type area with the currently valid
- \Var{BCOR} value.\IndexOption{BCOR~=current}}
+ \Var{BCOR} value.\IndexOption{BCOR~=\textKValue{current}}}
\end{desctabular}
\end{table}
-If both \PName{BCOR} and \PName{DIV} need changing, then it is recommended to
-use \Macro{typearea}, since then the text block and margins are recalculated
-only once. With
-\DescRef{\LabelBase.cmd.KOMAoptions}%
-\PParameter{\OptionVName{\DescRef{\LabelBase.option.DIV}}{DIV},%
- \OptionVName{\DescRef{\LabelBase.option.BCOR}}{BCOR}} the text block and
-margins are recalculated once for the change to \PName{DIV} and again for the
-change to \PName{BCOR}.
+If you change both \PName{BCOR} and \PName{DIV}, you should use
+\Macro{typearea}, since then the type area and margins are recalculated only
+once. With \DescRef{\LabelBase.cmd.KOMAoptions}%
+\PParameter{\OptionVNameRef{\LabelBase}{DIV}{factor},%
+ \OptionVNameRef{\LabelBase}{BCOR}{correction}} the type area and margins are
+recalculated once for the change to \DescRef{\LabelBase.option.DIV} and again
+for the change to \DescRef{\LabelBase.option.BCOR}.
\begin{Explain}
- The command \Macro{typearea} is currently defined so as to make it
- possible to change the type area anywhere within a
- document. Several assumptions about the structure of the {\LaTeX}
- kernel are however made and internal definitions and sizes of the
- kernel changed. There is a definite possibility, but no guarantee,
- that this will continue to function in future versions of
+ The command \Macro{typearea} is currently defined so as to make it possible
+ to change the type area in the middle of a document. However, several
+ assumptions about the structure of the {\LaTeX} kernel are made, and
+ internal definitions and sizes of the kernel are changed. Since changes are
+ only made to the {\LaTeX} kernel to fix bugs, there is a high likelihood,
+ though no guarantee, that this will still work in future versions of
\LaTeXe{}. When used within the document, a page break will result.
\end{Explain}
-Since \Macro{typearea}\POParameter{current}\PParameter{last} or
+Since\important{\Macro{recalctypearea}} \DescRef{\LabelBase.cmd.KOMAoption}%
+\PParameter{\hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}}}%
+\PParameter{\hyperref[desc:\LabelBase.option.DIV.last]{last}},
\DescRef{\LabelBase.cmd.KOMAoptions}%
-\PParameter{\OptionValueRef{\LabelBase}{DIV}{last}} are often needed for
-recalculation of the type area, there exists specially the abbreviated command
+\PParameter{\OptionValueRef{\LabelBase}{DIV}{last}}, or
+\Macro{typearea}\POParameter{current}\PParameter{last} is frequently needed
+to recalculate the type area and margins, there is a convenience command,
\Macro{recalctypearea}\ChangedAt{v3.00}{\Package{typearea}}.
-
\begin{Example}
- If one finds the notation
+ If you find the notation
\begin{lstcode}
\KOMAoptions{DIV=last}
\end{lstcode}
@@ -867,9 +917,8 @@ recalculation of the type area, there exists specially the abbreviated command
\begin{lstcode}
\typearea[current]{last}
\end{lstcode}
- for the recalculation of text block and margins too complicated for
- reasons of the many special characters, then one may use more simply
- the following.
+ too cumbersome for recalculating text area and margins because of
+ the many special characters, you can simply use
\begin{lstcode}
\recalctypearea
\end{lstcode}
@@ -881,19 +930,16 @@ recalculation of the type area, there exists specially the abbreviated command
\OptionVName{twoside}{simple switch}%
\OptionValue{twoside}{semi}
\end{Declaration}%
-As already explained in \autoref{sec:typearea.basics}, the margin
-configuration is dependent on whether the document is to be typeset
-single- or double-sided. For single-sided typesetting, the left and
-right margins are equally wide, whereas for double-sided printing the
-inner margin of one page is only half as wide as the corresponding
-outer margin. In order to implement this distinction, the
-\Package{typearea} package must be given the \Option{twoside} option,
-if the document is to be typeset double-sided. Being a \PName{simple switch},
-any of the standard values for simple switches in
-\autoref{tab:truefalseswitch} are valid. If the option is passed
-without a value, the value \PValue{true} is assumed, so double-sided
-typesetting is carried out. Deactivation of the option leads to
-single-sided typesetting.
+As explained in \autoref{sec:typearea.basics}, the distribution of the margins
+depends on whether the document is to be printed one-sided or two-sided. For
+one-sided printing, the left and right margins are the same width, whereas for
+two-sided printing the inner margin of one page is only half as wide as the
+corresponding outer margin. To invoke two-sided printing, you must give the
+\Package{typearea} package the \Option{twoside} option. For the
+\PName{simple switch}, you can use any of the standard values for
+simple switches in \autoref{tab:truefalseswitch}. If the option is passed
+without a value, the value \PValue{true} is assumed, so two-sided printing is
+enabled. Deactivating the option leads to one-sided printing.
\begin{table}
\centering
@@ -913,30 +959,32 @@ single-sided typesetting.
\label{tab:truefalseswitch}
\end{table}
-Apart from the values in \autoref{tab:truefalseswitch} the value
-\PValue{semi}\ChangedAt{v3.00}{\Package{typearea}} can also be given. The
-value \PValue{semi} results in a double-sided typesetting with single-sided
-margins and single-sided, i.\ e., not alternating, margin
-notes. Nevertheless\ChangedAt{v3.12}{\Package{typearea}}, since \KOMAScript{}
-version 3.12 binding corrections (see \DescRef{\LabelBase.option.BCOR},
-\DescPageRef{typearea.option.BCOR}) will be part of the left margin on
-odd pages but part of the right margin on even pages. But if you use
-compatibility with prior versions of \KOMAScript (see
-\autoref{sec:typearea.compatibilityOptions},
-\autopageref{sec:typearea.compatibilityOptions}), binding correction will be
-part of the left margin on both pages while using \OptionValue{twoside}{semi}.
+In addition to the values in \autoref{tab:truefalseswitch}, you can also use
+the value \PValue{semi}\ChangedAt{v3.00}{\Package{typearea}}. This value
+results in two-sided printing with one-sided margins and one-sided, that is
+non-alternating, marginal notes.
+Beginning\ChangedAt{v3.12}{\Package{typearea}} with \KOMAScript{} version
+3.12, binding corrections (see \DescRef{\LabelBase.option.BCOR},
+\DescPageRef{typearea.option.BCOR}) will be part of the left margin on odd
+pages but part of the right margin on even pages. But if you switch on
+compatibility with a prior
+version\important{\OptionValueRef{\LabelBase}{version}{3.12}} of \KOMAScript{}
+(see \autoref{sec:typearea.compatibilityOptions},
+\autopageref{sec:typearea.compatibilityOptions}), the binding correction will
+be part of the left margin on both pages while using
+\OptionValue{twoside}{semi}.
The option can also be passed as class option in
-\DescRef{\LabelBase.cmd.documentclass}, as package option to
-\DescRef{\LabelBase.cmd.usepackage}, or even after loading of the
-\Package{typearea} package with the use of
-\DescRef{\LabelBase.cmd.KOMAoptions} or
-\DescRef{\LabelBase.cmd.KOMAoption}. Use of the option after loading the
-\Package{typearea} package results automatically in recalculation of the type
-area using \DescRef{\LabelBase.cmd.recalctypearea} (see
-\DescPageRef{typearea.cmd.recalctypearea}). If double-sided typesetting
-was active before the option was set, then before the recalculation a page
-break is made to the next odd page.%
+\DescRef{\LabelBase.cmd.documentclass}, as a package option with
+\DescRef{\LabelBase.cmd.usepackage}, or even after loading
+\Package{typearea} with \DescRef{\LabelBase.cmd.KOMAoptions} or
+\DescRef{\LabelBase.cmd.KOMAoption}. Using this option after loading
+\Package{typearea} automatically\textnote{automatic recalculation} results in
+the recalculation of the type area using
+\DescRef{\LabelBase.cmd.recalctypearea} (see
+\DescPageRef{typearea.cmd.recalctypearea}). If the two-sided mode was active
+before the option was set, a page break is made to the next odd page before
+the recalculation.%
%
\EndIndexGroup
@@ -944,124 +992,127 @@ break is made to the next odd page.%
\begin{Declaration}
\OptionVName{twocolumn}{simple switch}
\end{Declaration}
-For the calculation of a good type area with the help of
-\OptionValueRef{\LabelBase}{DIV}{calc} it is useful to know in advance if the
-document is to be typeset one-column or two-column. Since the observations
-about line length in \autoref{sec:typearea.basics} then apply to each column,
-the width of a type area in a two-column document can be up to double that in
-a one-column document.
-
-To implement this difference, the \Package{typearea} package must be
-told via the \Option{twocolumn} option whether the document is to be
-two-column. Since this is a \PName{simple switch}, any of the standard values
-for simple switches from \autoref{tab:truefalseswitch} is valid. If
-the option is passed without a value, the value \PValue{true} is
-assumed, i.\,e., two-column typesetting. Deactivation of the option
-results in one-column typesetting.
-
-The option can also be passed as class option in
-\DescRef{\LabelBase.cmd.documentclass}, as package option to
-\DescRef{\LabelBase.cmd.usepackage}, or even after loading of the
-\Package{typearea} package with the use of
-\DescRef{\LabelBase.cmd.KOMAoptions} or
-\DescRef{\LabelBase.cmd.KOMAoption}. Use of the option after loading the
-\Package{typearea} package results automatically in recalculation of the type
-area using \DescRef{\LabelBase.cmd.recalctypearea} (see
+To compute an appropriate type area with the help of
+\OptionValueRef{\LabelBase}{DIV}{calc}, it is useful to know in advance if the
+document is to be typeset in one or two columns. Since the considerations
+about line length in \autoref{sec:typearea.basics} apply to each column, the
+type area in two-column documents can be up to twice as wide as in one-column
+documents.
+
+To make this distinction, you must tell \Package{typearea} if the document is
+to be set with two columns using the \Option{twocolumn} option. Since this is
+a \PName{simple switch}, any of the standard values for simple switches
+from \autoref{tab:truefalseswitch} are valid. If the option is passed without
+a value, the value \PValue{true}\important{\OptionValue{twocolumn}{true}} is
+used, i.\,e. the two-column setting. Deactivating the option returns you to
+the default one-column setting.
+
+The option can also be passed as a class option in
+\DescRef{\LabelBase.cmd.documentclass}, as a package option to
+\DescRef{\LabelBase.cmd.usepackage}, or even after loading \Package{typearea}
+with \DescRef{\LabelBase.cmd.KOMAoptions} or
+\DescRef{\LabelBase.cmd.KOMAoption}. Using this option after loading
+\Package{typearea} will\textnote{automatic recalculation} automatically
+recalculate the type area using \DescRef{\LabelBase.cmd.recalctypearea} (see
\DescPageRef{typearea.cmd.recalctypearea}).%
%
\EndIndexGroup
-
\begin{Declaration}
\OptionVName{headinclude}{simple switch}%
\OptionVName{footinclude}{simple switch}
\end{Declaration}%
\begin{Explain}%
- So far we have discussed how the type area is
- calculated\Index{type area} and the relationship of the
- margins\Index{margins} to one another and between margins and text
- block. However, one important question has not been answered: What
- constitutes the margins?
+ So far we have discussed how the type area is calculated\Index{type area}
+ and the relationship of the margins\Index{margins} to one another and
+ between margins and body of the text. But one important question has not
+ been answered: What exactly are \emph{the margins}?
At first glance the question appears trivial: Margins are those parts on the
- right, left, top and bottom which remain empty. But this is only half the
- story. Margins are not always empty. There may be margin notes, for example
- (see \DescRef{maincls.cmd.marginpar} command in \cite{lshort} or
- \autoref{sec:maincls.marginNotes}).
-
- One could also ask whether headers\Index{page header} and
- footers\Index{page footer} belong to the upper and lower margins or
- to the text. This can not be answered unambiguously. Of course an
- empty footer or header belongs to the margins, since they can not be
- distinguished from the rest of the margin. A header or footer that
- contains only a page
- number\Index[indexmain]{pagination}\footnote{Pagination refers to
- the indication of the page number.} will optically appear more
- like a margin. For the optical appearance it is not important
- whether headers or footers are easily recognized as such during
- reading. Of importance is only how a well-filled page appears when
- viewed \emph{out of focus}. One could use the glasses of one's
- far-sighted grandparents, or, lacking those, adjust one's vision to
- infinity and look at the page with one eye only. Those wearing
- spectacles will find this much easier, of course. If the footer
- contains not only the page number, but other material like a
- copyright notice, it will optically appear more like a part of the
- text body. This needs to be taken into account when calculating
- text layout.
-
- For the header this is even more complicated. The header frequently
- contains running headings\Index[indexmain]{running
- headings}.\footnote{Running headings refer to the repetition of a
- title in titling font, which is more often typeset in the page
- header, less often in the page footer.} In the case of running
- headings with long chapter and section titles, the header lines will
- be very long and appear to be part of the text body. This effect
- becomes even more significant when the header contains not only the
- chapter or section title but also the page number. With material on
- the right and left side, the header will no longer appear as an
- empty margin. It is more difficult if the pagination is in the
- footer, and the length of the titles varies so that the header may
- appear as a margin on one page and as text on another. However,
- these pages should not be treated differently under any
- circumstances, as this would lead to vertically jumping headers. In
- this case it is probably best to count the header as part of the
- text.
-
- The decision is easy when text and header or footer are separated
- from the text body by a line. This will give a ``closed'' appearance
- and header or footer become part of the text body. Remember: It is
- irrelevant that the line improves the optical separation of text and
- header or footer; only the appearance when viewed out
- of focus is important.
+ right, left, top, and bottom of the page which remain empty. But this is
+ only half the story. Margins are not always empty. Sometimes there can be
+ marginal notes, for example (see the \DescRef{maincls.cmd.marginpar} command
+ in \cite{lshort} or \autoref{sec:maincls.marginNotes}).
+
+ For the top and bottom margins, the question becomes how to handle
+ headers\Index{page header} and footers\Index{page footer}. Do these two
+ belong to the text body or to their respective margins? This question is not
+ easy to answer. Clearly an empty footer or header belongs to the margins,
+ since it cannot be distinguished from the rest of the margins. A footer that
+ contains only the
+ pagination\Index[indexmain]{pagination}\textnote{pagination} %
+ \iffalse %
+ \unskip\footnote{Pagination refers to the indication of the page number,
+ either inside or outside the type area, and usually appears in either the
+ header or the footer of the page.} %
+ \fi %
+ looks more like a margin and should therefore be counted as such. It is
+ irrelevant for the visual effect whether headers or footers are easily
+ recognized as such when reading or skimming. The decisive factor is how a
+ well-filled page appears when viewed \emph{out of focus}. For this purpose,
+ you could, for example, steal the glasses of a far-sighted grandparent and
+ hold the page about half a meter from the tip of your nose. If you lack an
+ available grandparent, you can also adjust your vision to infinity and look
+ at the page with one eye only. Those who wear glasses have a clear advantage
+ here. If the footer contains not only the pagination but also other material
+ like a copyright notice, it looks more like a slightly detached part of the
+ body of the text. This needs to be taken into account when calculating the
+ type area.
+
+ For the header, this is even more complicated. The header often contains
+ running heads\Index[indexmain]{running heads}\textnote{running heads}. %
+ \iffalse%
+ \unskip\footnote{Running heads refer to the repetition of a title, in
+ titling font, which usually appears in the page header, or rarely in the
+ page footer.} %
+ \fi If you use the current chapter and section titles in your running head
+ and these titles are long, the header itself will necessarily be very
+ long. In this case, the header again acts like a detached part of the text
+ body and less like an empty margin. This effect is reinforced if the header
+ contains not only the chapter or section title but also the pagination. With
+ material on the right and left side, the header no longer appears as an
+ empty margin. It is more difficult if the pagination is in the footer and
+ the length of the running titles varies, so that the header may look like
+ part of the margin on one page and part of the text body on another. Under
+ no circumstances should you treat the pages differently. That would lead to
+ vertically jumping headers, which is not suitable even for a flip book. In
+ this case it is probably best to count the header as part of the text body.
+
+ The decision is easy when the header or footer is separated from the actual
+ text body by a line. This will give a ``closed'' appearance and the header
+ or footer should be calculated as part of the text body. Remember: It is
+ irrelevant that the line improves the optical separation of text and header
+ or footer; only the appearance when viewed out of focus is important.
\end{Explain}
-The \Package{typearea} package cannot make the decision whether or
-not to count headers and footers as part of the text body or the
-margin. Options \Option{headinclude} and \Option{footinclude} cause
+The \Package{typearea} package cannot determine on its own whether
+to count headers and footers\important{\OptionValue{headinclude}{true}
+ \OptionValue{headinclude}{false} \OptionValue{footinclude}{true}
+ \OptionValue{footinclude}{false}} as part of the text body or the
+margin. The \Option{headinclude} and \Option{footinclude} options cause
the header or footer to be counted as part of the text. These
-options, being a \PName{simple switch}\ChangedAt{v3.00}{\Package{typearea}},
-understand the standard values for simple switches in
-\autoref{tab:truefalseswitch}. One may use the options without
+options, being \PName{simple switch}es\ChangedAt{v3.00}{\Package{typearea}},
+accept the standard values for simple switches in
+\autoref{tab:truefalseswitch}. You can use the options without
specifying a value, in which case the value \PValue{true} is used for
-the \PName{simple switch}, i.\,e., the header or footer is counted as part of
+the \PName{simple}, i.\,e. the header or footer is counted as part of
the text.
-Readers who are unsure about the the correct setting should re-read
-the above explanations. Default is usually
-\OptionValue{headinclude}{false} and \OptionValue{footinclude}{false},
-but this can change depending on {\KOMAScript} class and {\KOMAScript}
-packages used (see \autoref{sec:maincls.options} and
-\autoref{cha:scrlayer-scrpage}).
-
-Please note that when using these options with one of the
-{\KOMAScript} classes as in the example above, they must be used
-either as a class option, or passed via \DescRef{\LabelBase.cmd.KOMAoptions} or
-\DescRef{\LabelBase.cmd.KOMAoption} after loading the class. Changing of these options
-after loading the \Package{typearea} package does not result in an
-automatic recalculation of the type area. Instead, the changes only
-take effect at the next recalculation of the type area. For
-recalculation of the type area, refer to the \DescRef{\LabelBase.option.DIV} option with
-the values \PValue{last} or \PValue{current} (see
+If you are unsure what the correct setting should be, reread the explanations
+above. The default is usually \OptionValue{headinclude}{false} and
+\OptionValue{footinclude}{false}, but this can change in the {\KOMAScript}
+classes or in other {\KOMAScript} packages depending on the options used (see
+\autoref{sec:maincls.options} and \autoref{cha:scrlayer-scrpage}).
+
+Note\textnote{Attention!} that these options must be passed as class options
+when using one of the {\KOMAScript} classes, or after loading the class with
+\DescRef{\LabelBase.cmd.KOMAoptions} or \DescRef{\LabelBase.cmd.KOMAoption}.
+Changing these options after loading the \Package{typearea} package does not
+automatically recalculate the type area. Instead, the changes only take effect
+the next time the type area is recalculated. For recalculation of the type
+area, see the \hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}} option
+with the values \hyperref[desc:\LabelBase.option.DIV.last]{\PValue{last}} or
+\hyperref[desc:\LabelBase.option.DIV.current]{\PValue{current}} (see
\DescPageRef{typearea.option.DIV.last}) or the
\DescRef{\LabelBase.cmd.recalctypearea} command (see
\DescPageRef{typearea.cmd.recalctypearea}).%
@@ -1072,68 +1123,65 @@ the values \PValue{last} or \PValue{current} (see
\begin{Declaration}
\OptionVName{mpinclude}{simple switch}
\end{Declaration}
-Besides\ChangedAt{v2.8q}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} documents where the head and foot are part of the
-text area, there are also documents where the margin-note area must be
-counted as part of the text body as well. The option \Option{mpinclude} does
-exactly this. The option, as a
-\PName{simple switch}\ChangedAt{v3.00}{\Package{typearea}}, understands the
-standard values for simple switches in
-\autoref{tab:truefalseswitch}. One may also pass this option without
-specifying a value, in which case the value \PValue{true} for
-\PName{simple switch} is assumed.
-
-The effect of \OptionValue{mpinclude}{true} is that one width-unit of
-the text body is taken for the margin-note area. Using option
-\OptionValue{mpinclude}{false}, the default setting, the normal
-margin is used for the margin-note area. The width of that area is
-one or one and a half width-unit, depending on whether one-sided or
-double-sided page layout has been chosen. The option
-\OptionValue{mpinclude}{true} is mainly for experts and so is not recommended.
+In addition to\ChangedAt{v2.8q}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} documents where the header and footer are more likely to
+be part of the text body than the margins, there are also documents where
+marginal notes should be considered part of the text body as well. The option
+\Option{mpinclude} does exactly this. The option, as a \PName{simple
+ switch}\ChangedAt{v3.00}{\Package{typearea}}, accepts the standard values
+for simple switches in \autoref{tab:truefalseswitch}. You can also pass this
+option without specifying a value, in which case \PValue{true} is assumed.
+
+The effect of \OptionValue{mpinclude}{true}%
+\important{\OptionValue{mpinclude}{true}} is that a width-unit is removed from
+the main text body and used as the area for marginal notes. With the
+\OptionValue{mpinclude}{false} option, which is the default setting, part of
+the normal margin is used for marginal notes. The width of that area is one or
+one-and-a-half width units, depending on whether you have chosen one-sided or
+two-sided printing. The \OptionValue{mpinclude}{true} option is mainly for
+experts and so is not recommended.
\begin{Explain}
- In the cases where the option \Option{mpinclude} is used, often a
- wider margin-note area is required. In many cases not the whole
- margin-note width should be part of the text area, for example if
- the margin is used for quotations. Such quotations are typeset as
- ragged text with the flushed side where the text body is. Since
- ragged text gives no homogeneous optical impression, the long lines
- can reach right into the normal margin. This can be done using
- option \Option{mpinclude} and by an enlargement of length
- \Length{marginparwidth} after the type area has been set up. The
- length can be easily enlarged with the command \Macro{addtolength}.
- How much the length has to be enlarged depends on the special
- situation and it requires some flair. This is another reason the
- \Option{mpinclude} option is primarily left for experts. Of course
- one can set up the margin-width to reach a third right into the
- normal margin; for example, using
+ In most cases where the option \Option{mpinclude} makes sense, you also
+ require a wider area for marginal notes. Often, however, only a part of the
+ marginal note's width should be part of the text area, not the whole width,
+ for example if the margin is used for quotations. Such quotations are
+ usually set as unjustified text, with the flush edge against the text area.
+ Since the unjustified text gives no homogeneous optical impression, these
+ lines can protrude partially into the margin. You can accomplish that by
+ using the option \Option{mpinclude} and by increasing the length
+ \Length{marginparwidth} after the type area has been set up. The length can
+ be easily enlarged with the command \Macro{addtolength}. How much the length
+ has to be increased depends on the individual situation and it requires a
+ certain amount of sensitivity. This is another reason the \Option{mpinclude}
+ option is primarily intended for experts. Of course you can specify, for
+ example, that the marginal notes should project a third of the way into the
+ normal margin by using the following:
\begin{lstcode}
- \setlength{\marginparwidth}{1.5\marginparwidth}
+ \setlength{\marginparwidth}{1.5\marginparwidth}
\end{lstcode}
- gives the desired result.
-
- Currently there is no option to enlarge the margin by a given
- amount. The only solution is to either not use the option
- \Option{mpinclude} or to set \Option{mpinclude} to \PValue{false},
- and after the type area has been calculated, one reduces the
- width of the text body \Length{textwidth} and enlarges the margin
- width \Length{marginparwidth} by the same amount. Unfortunately,
- this cannot be combined with automatic calculation of the
- \PName{DIV} value. In contrast
- \OptionValueRef{\LabelBase}{DIV}{calc}\IndexOption{DIV~=calc} (see
- \DescPageRef{typearea.option.DIV.calc}) heeds
- \Option{mpinclude}.
+
+Currently there is no option to enlarge the space for marginal notes within
+the text area. There is only one way to accomplish this: first, either omit
+the \Option{mpinclude} option or set it to \PValue{false}, and then, after the
+type area has been calculated, reduce \Length{textwidth} (the width of the
+text body) and increase \Length{marginparwidth} (the width of the marginal
+notes) by the same amount. Unfortunately, this procedure cannot be combined
+with automatic calculation of the \PName{DIV} value. In contrast,
+\Option{mpinclude} is taken into account with
+\OptionValueRef{\LabelBase}{DIV}{calc}\IndexOption{DIV~=calc} (see
+\DescPageRef{typearea.option.DIV.calc}).
\end{Explain}
-Please note that when using this option with one of the {\KOMAScript}
-classes as in the example above, it must be used either as a class
-option, or passed via \DescRef{\LabelBase.cmd.KOMAoptions} or \DescRef{\LabelBase.cmd.KOMAoption} after
-loading the class. Changing of this option after loading the
-\Package{typearea} package does not result in an automatic
-recalculation of the type area. Instead, the changes only take effect
-at the next recalculation of the type area. For recalculation of the
-type area, refer to the \DescRef{\LabelBase.option.DIV} option with the values
-\PValue{last} or \PValue{current} (see
+Note\textnote{Attention!} that these options must be passed as class options
+when using one of the {\KOMAScript} classes, or after loading the class with
+\DescRef{\LabelBase.cmd.KOMAoptions} or \DescRef{\LabelBase.cmd.KOMAoption}.
+Changing these options after loading the \Package{typearea} package does not
+automatically recalculate the type area. Instead, the changes only take effect
+the next time the type area is recalculated. For recalculation of the type
+area, see the \hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}} option
+with the values \hyperref[desc:\LabelBase.option.DIV.last]{\PValue{last}} or
+\hyperref[desc:\LabelBase.option.DIV.current]{\PValue{current}} (see
\DescPageRef{typearea.option.DIV.last}) or the
\DescRef{\LabelBase.cmd.recalctypearea} command (see
\DescPageRef{typearea.cmd.recalctypearea}).%
@@ -1142,60 +1190,64 @@ type area, refer to the \DescRef{\LabelBase.option.DIV} option with the values
\begin{Declaration}
- \OptionVName{headlines}{number of lines}\\
+ \OptionVName{headlines}{number of lines}
\OptionVName{headheight}{height}
\end{Declaration}%
-We have seen how to calculate the type area using the
-\Package{typearea} package and how to specify whether header and
-footer are part of the text or the margins. However, in particular for
-the header, we still have to specify the height. This is achieved with
-the options \Option{headlines} and
+\BeginIndex{}{header>height}%
+We have seen how to calculate the type area using the \Package{typearea}
+package and how to specify whether the header and footer are part of the text
+or the margins. However, especially for the header, we still have to specify
+the height. This is achieved with the options \Option{headlines} and
\Option{headheight}\ChangedAt{v3.00}{\Package{typearea}}.
-The option \Option{headlines} is set to the number of header
-lines. The \Package{typearea} package uses a default of 1.25. This is
-a compromise, large enough for underlined headers (see
-\autoref{sec:maincls.options}) and small enough that the relative
-weight of the top margin is not affected too much when the header is
-not underlined. Thus in most cases you may leave \Option{headlines} at
-its default value and adapt it only in special cases.
+The \Option{headlines}\important{\Option{headlines}} option specifies the
+number of lines of text in the header. The \Package{typearea} package uses a
+default of 1.25. This is a compromise: large enough for underlined headers
+(see \autoref{sec:maincls.pagestyle}) and small enough that the relative
+weight of the top margin is not affected too much when the header is not
+underlined. Thus the default value will usually be adequate. In special cases,
+however, you may need to adjust the header height more precisely to your
+actual requirements.
\begin{Example}
- Assume that you want to use a header with two lines. Normally this would
- result in an ``\texttt{overfull} \Macro{vbox}'' warning for each page. To
- prevent this from happening, the \Package{typearea} package is told to
- calculate an appropriate type area:
+ Suppose you want to create a two-line header. Normally this would result in
+ {\LaTeX} issuing the warning ``\texttt{overfull} \Macro{vbox}'' for each
+ page. To prevent this from happening, you tell the \Package{typearea}
+ package to calculate an appropriate type area:
\begin{lstcode}
\documentclass[a4paper]{article}
\usepackage[headlines=2.1]{typearea}
\end{lstcode}
-If you use a {\KOMAScript} class, it is recommended to pass this option
-directly as a class option:
+ If you use a {\KOMAScript} class, you should pass this option directly to
+ the class:
\begin{lstcode}
\documentclass[a4paper,headlines=2.1]{scrartcl}
\end{lstcode}
-Commands that can be used to define the contents of a header with two lines
-are described in \autoref{cha:scrlayer-scrpage}.
+ Commands that can be used to define the contents of a two-line header
+ can be found in \autoref{cha:scrlayer-scrpage}.
\end{Example}
-In some cases it is useful to be able to specify the header height not
-in lines but directly as a length measurement. This is accomplished
-with the aid of the alternative option \Option{headheight}. For
-\PName{height} any lengths and sizes that \LaTeX{} understands are
-valid. It should be noted though that when using a \LaTeX{} length
-such as \Length{baselineskip} its value at the time of the calculation
-of the type area and margins, not at the time of setting of the
-option, is decisive.
-
-Please note that when using these options with one of the
-{\KOMAScript} classes as in the example above, they must be used
-either as a class option, or passed via \DescRef{\LabelBase.cmd.KOMAoptions} or
-\DescRef{\LabelBase.cmd.KOMAoption} after loading the class. Changing of these options
-after loading the \Package{typearea} package does not result in an
-automatic recalculation of the type area. Instead, the changes only
-take effect at the next recalculation of the type area. For
-recalculation of the type area, refer to the \DescRef{\LabelBase.option.DIV} option with
-the values \PValue{last} or \PValue{current} (see
+In some cases it is useful to be able to specify the header height not in
+lines but directly as a length. This is accomplished with the alternative
+option \Option{headheight}\important{\Option{headheight}}. All lengths and
+sizes that \LaTeX{} understands are valid for \PName{height}.
+Note\textnote{Attention!}, however, that if you use a \LaTeX{} length such as
+\Length{baselineskip}, its value is not fixed at the time the option is set.
+The value that will be used will be the one current at the time the type area
+and margins are calculated. Also\textnote{Attention!}, \LaTeX{} lengths like
+\Length{baselineskip} should never be used in the optional argument of
+\DescRef{\LabelBase.cmd.documentclass} or \DescRef{\LabelBase.cmd.usepackage}.
+
+Please be sure to note\textnote{Attention!} that these options must be passed
+as class options when using one of the {\KOMAScript} classes, or after loading
+the class with \DescRef{\LabelBase.cmd.KOMAoptions} or
+\DescRef{\LabelBase.cmd.KOMAoption}. Changing these options after loading the
+\Package{typearea} package does not\textnote{no automatic recalculation}
+automatically recalculate the type area. Instead, the changes only take effect
+the next time the type area is recalculated. For recalculation of the type
+area, see the \hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}} option
+with the values \hyperref[desc:\LabelBase.option.DIV.last]{\PValue{last}} or
+\hyperref[desc:\LabelBase.option.DIV.current]{\PValue{current}} (see
\DescPageRef{typearea.option.DIV.last}) or the
\DescRef{\LabelBase.cmd.recalctypearea} command (see
\DescPageRef{typearea.cmd.recalctypearea}).%
@@ -1208,68 +1260,79 @@ the values \PValue{last} or \PValue{current} (see
\OptionVName{footheight}{height}%
\Length{footheight}%
\end{Declaration}
-As\ChangedAt{v3.12}{\Package{typearea}} well as we needed a height value for
-the head, we need a height value for the page footer. But in difference to the
-height of the head, \LaTeX itself do not provide a length for the height of
-the page footer. So \Package{typearea} defines the new length
-\Length{footheight}\IndexLength[indexmain]{footheight}, if
-it does not exist. Wether or not this length will be used by classes or
-packages depends on the classes and packages, that will be used. The
-\KOMAScript{} package \Package{scrlayer-scrpage} incorporates
-\Length{footheight} and actively cooperates with
-\Package{typearea}. The \KOMAScript{} classes do not recognize
-\Length{footheight}, because without any package assistance
-they provide only page styles with single-line page footers.
-
-You can use \Option{footlines} to setup the \PName{number of lines} in the
-page footer, similar to \DescRef{\LabelBase.option.headlines} for the number
-of lines in the page header. By default \Package{typearea} uses 1.25
-footlines. This is a compromise, large enough for overlining or underlining
-footers and small enough that the relative weight of the bottom margin is not
-affected too mich when the footer is neither over- nor underlined. Thus in
-most cases you may leave \PName{number of lines} at its default value and
-adapt it only in special cases.
+\BeginIndex{}{footer>height}%
+Like\ChangedAt{v3.12}{\Package{typearea}} the header, the footer also requires
+an indication of how high it should be. But unlike the height of the header,
+the \LaTeX{} kernel does not provide a length for the height of the footer. So
+\Package{typearea} defines a new length,
+\Length{footheight}\IndexLength[indexmain]{footheight}, if it does not already
+exist. Whether this length will be used by classes or packages to design the
+headers and footers depends on the individual classes and packages. The
+\KOMAScript{} package
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}%
+\IndexPackage{scrlayer-scrpage} incorporates
+\Length{footheight} and actively cooperates with \Package{typearea}. The
+\KOMAScript{} classes, on the other hand, do not recognize \Length{footheight}
+because without the help of packages they offer only page styles with
+single-line page footers.
+
+You can use \Option{footlines}\important{\Option{footlines}} to set the number
+of lines in the footer, similar to \DescRef{\LabelBase.option.headlines} for
+the number of lines in the header. By default the \Package{typearea} package
+uses 1.25 footer lines. This value is a compromise: large enough to
+accommodate an overlined or underlined footer (see
+\autoref{sec:maincls.pagestyle}), and small enough that the relative weight of
+the bottom margin is not affected too much when the footer lacks a dividing
+line. Thus the default value will usually be adequate. In special cases,
+however, you may need to adjust the footer height more precisely to your
+actual requirements.
\begin{Example}
- Assume a two-lined copyright note should be placed in the page
- footer. Indeed, \LaTeX{} itself does not test, whether or not the footer has
- room enough for that, exceeding of the available height would probably could
- result in unbalanced margins. Moreover, for example package
- \Package{scrlayer-scrpage}, that may be used to define such a page footer,
- would definitely do such a test and would notify a recognised oversize. So
- it makes sense, to declare the needed footheight already for the calculation
- of the text area and the margins:
+ Suppose you need to place a two-line copyright notice in the footer.
+ Although there is no test in \LaTeX{} itself to check the space available
+ for the footer, exceeding the designated height will likely result in
+ unbalanced distribution of type area and margins. Moreover, a package such
+ as \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}%
+ \IndexPackage{scrlayer-scrpage}, which can be used to define such a footer,
+ performs the appropriate test and will report any overruns. So it makes
+ sense to specify the required footer height when calculating of the type
+ area:
\begin{lstcode}
\documentclass[a4paper]{article}
\usepackage[footlines=2.1]{typearea}
\end{lstcode}
- Again, if you use a \KOMAScript{} class, it is recommended to pass this
- option directly a a class option:
+ Again, if you use a \KOMAScript{} class, you should pass this
+ option directly to the class:
\begin{lstcode}
\documentclass[footlines=2.1]{scrartcl}
\end{lstcode}
- Commands that can be used to define the contents of a footer with two lines
+ Commands that can be used to define the contents of a two-line footer
are described in \autoref{cha:scrlayer-scrpage}.
\end{Example}
-In some cases it is useful to be able to specify the footer height not
-in lines but directly as a length measurement. This is accomplished
-with the aid of the alternative option \Option{footheight}. For
-\PName{height} any lengths and sizes that \LaTeX{} understands are
-valid. It should be noted though that when using a \LaTeX{} length
-such as \Length{baselineskip} its value at the time of the calculation
-of the type area and margins, not at the time of setting of the
-option, is decisive.
-
-Please note that when using these options with one of the
-{\KOMAScript} classes as in the example above, they must be used
-either as a class option, or passed via \DescRef{\LabelBase.cmd.KOMAoptions} or
-\DescRef{\LabelBase.cmd.KOMAoption} after loading the class. Changing of these options
-after loading the \Package{typearea} package does not result in an
-automatic recalculation of the type area. Instead, the changes only
-take effect at the next recalculation of the type area. For
-recalculation of the type area, refer to the \DescRef{\LabelBase.option.DIV} option with
-the values \PValue{last} or \PValue{current} (see
+In some cases it is useful to be able to specify the footer height not in
+lines but directly as a length. This is accomplished with the alternative
+option \Option{footheight}\important{\Option{footheight}}. All lengths and
+sizes that \LaTeX{} understands are valid for \PName{height}. Note, however,
+that if you use a \LaTeX{} length such as \Length{baselineskip}, its value is
+not fixed at the time the option is set. The value that will be used will be
+the one current at the time the type area and margins are calculated.
+Also\textnote{Attention!}, \LaTeX{} lengths like \Length{baselineskip} should
+never be used in the optional argument of
+\DescRef{\LabelBase.cmd.documentclass} or \DescRef{\LabelBase.cmd.usepackage}.
+
+Please be sure to note\textnote{Attention!} that these options must be passed
+as class options when using one of the {\KOMAScript} classes, or after loading
+the class with \DescRef{\LabelBase.cmd.KOMAoptions} or
+\DescRef{\LabelBase.cmd.KOMAoption}. Changing these options after loading
+\Package{typearea} does not\textnote{no automatic recalculation} automatically
+recalculate the type area. Instead, the changes only take effect the next time
+the type area is recalculated. For recalculation of the type area, see the
+\hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}} option with the
+values \hyperref[desc:\LabelBase.option.DIV.last]{\PValue{last}} or
+\hyperref[desc:\LabelBase.option.DIV.current]{\PValue{current}} (see
\DescPageRef{typearea.option.DIV.last}) or the
\DescRef{\LabelBase.cmd.recalctypearea} command (see
\DescPageRef{typearea.cmd.recalctypearea}).%
@@ -1279,17 +1342,17 @@ the values \PValue{last} or \PValue{current} (see
\begin{Declaration}
\Macro{areaset}\OParameter{BCOR}\Parameter{width}\Parameter{height}
\end{Declaration}%
-So far we have seen how a good or even very good type area\Index{type area} is
-calculated and how the \Package{typearea} package can support these
-calculations, giving you at the same time the freedom to adapt the layout to
-your needs. However, there are cases where the text body has to fit exactly
-some specified dimensions. At the same time the margins should be well spaced
-and a binding correction should be possible. The \Package{typearea} package
-offers the command \Macro{areaset} for this purpose. As parameters this
-command accepts the binding correction and the width and height of the text
-body. Width and position of the margins will then be calculated
-automatically, taking account of the options
-\DescRef{\LabelBase.option.headinclude},
+So far, we have seen how to create a nice type area\Index{type area} for
+standard situations and how the \Package{typearea} package makes it easier to
+accomplish this while still giving the freedom to adapt the layout. However,
+there are cases where the text body has to adhere precisely to specific
+dimensions. At the same time, the margins should be distributed as nicely as
+possible and, if necessary, a binding correction should be taken into account.
+The \Package{typearea} package offers the command \Macro{areaset} for this
+purpose. This command takes as parameters the width and height of the text
+body, as well as the binding correction as an optional parameter. The width
+and position of the margins are then calculated automatically, taking account
+of the options \DescRef{\LabelBase.option.headinclude},
\OptionValueRef{\LabelBase}{headinclude}{false},
\DescRef{\LabelBase.option.footinclude} and
\OptionValueRef{\LabelBase}{footinclude}{false} where needed. On the other
@@ -1298,19 +1361,19 @@ hand, the options
\DescRef{\LabelBase.option.headheight}\IndexOption{headheight},
\DescRef{\LabelBase.option.footlines}\IndexOption{footlines}, and
\DescRef{\LabelBase.option.footheight}\IndexOption{footheight} are ignored!
-See further information to \DescRef{typearea-experts.cmd.areaset} on
+For more information, see \DescRef{typearea-experts.cmd.areaset} on
\DescPageRef{typearea-experts.cmd.areaset} of
\autoref{sec:typearea-experts.experimental}.
-The default of \PName{BCOR} is 0\Unit{pt}. If you want to re-use the current
-binding correction, e.\,g. the value set by option
+The default for \PName{BCOR} is 0\Unit{pt}. If you want to preserve the
+current binding correction, for example the value set by option
\DescRef{\LabelBase.option.BCOR}\IndexOption{BCOR}, you can use the symbolic
-value \PValue{current} at the optional argument.
+value \PValue{current} at an optional argument.
\begin{Example}
- Assume a text, printed on A4 paper, should have a width of exactly 60
- characters of typewriter font and a height of exactly 30 lines. This could
- be achieved as follows:
+ Suppose a text on A4 paper needs a width of exactly 60 characters in a
+ typewriter font and a height of exactly 30 lines per page. You can
+ accomplish this with the following preamble:
\begin{lstcode}
\documentclass[a4paper,11pt]{article}
\usepackage{typearea}
@@ -1322,16 +1385,22 @@ value \PValue{current} at the optional argument.
\addtolength{\LinesXXX}{29\baselineskip}
\areaset{\CharsLX}{\LinesXXX}
\end{lstcode}
-You need only 29 instead of 30, because the base line of the topmost
-text line is \Macro{topskip} below the top margin of the type area, as
-long as the height of the topmost line is less than
-\Macro{topskip}. Thus, the uppermost line does not require any
-height. The descenders of characters on the lowermost line, on the
-other hand, hang below the dimensions of the type area.
-
-\item A poetry book with a square text body with a page length of
- 15\Unit{cm} and a binding correction of 1\Unit{cm} could be
- achieved like this:
+ The factor is 29 rather than 30 because the baseline of the topmost line of
+ text is \Macro{topskip} below the top margin of the type area, as long as
+ the height of the topmost line is less than \Macro{topskip}. So we don't
+ need to add any height for the first line. The descenders of characters on
+ the lowermost line, on the other hand, protrude below the dimensions of the
+ type area.
+
+\iffalse % Umbruchkorrekturtext
+ If instead you want to set a book of poetry in which the text area is
+ exactly square with a side length of 15\Unit{cm}, with a binding correction
+ of 1\Unit{cm} taken into account, you can achieve this as follows:%
+\else%
+ To set a book of poetry with a square text area with a side length of
+ 15\Unit{cm} and a binding correction of 1\Unit{cm}, the following is
+ possible:%
+\fi
\begin{lstcode}
\documentclass{poetry}
\usepackage{typearea}
@@ -1345,86 +1414,105 @@ other hand, hang below the dimensions of the type area.
\OptionValue{DIV}{areaset}
\end{Declaration}%
In\ChangedAt{v3.00}{\Package{typearea}} rare cases it is useful to be able to
-reconstruct the current type area anew. This is possible via the option
+realign the current type area. This is possible with the option
\OptionValue{DIV}{areaset}, where
\DescRef{\LabelBase.cmd.KOMAoptions}\PParameter{\OptionValue{DIV}{areaset}}
corresponds to the
\begin{lstcode}
\areaset[current]{\textwidth}{\textheight}
\end{lstcode}
-command. The same result is obtained if one uses
+command. The same result is obtained if you use
\OptionValueRef{\LabelBase}{DIV}{last} and the typearea was last set with
\DescRef{\LabelBase.cmd.areaset}.%
%
\EndIndexGroup
-
-The \Package{typearea} package was not made to set up predefined
-margin values. If you have to do so you may use package
-\Package{geometry}\IndexPackage{geometry} (see
-\cite{package:geometry}).
+\iftrue% Umbruchkorrekturtext: Alternativen
+ If you have concrete specifications for the margins, \Package{typearea} is
+ not suitable. In this case, you should use the
+ \Package{geometry}\IndexPackage{geometry}%
+ \important{\Package{geometry}} package (see \cite{package:geometry}).%
+\fi%
+\iffalse%
+ The \Package{typearea} package is not designed to set up predefined margins.
+ If you have to do so, the \Package{geometry}\IndexPackage{geometry} package
+ (see \cite{package:geometry}) is recommended.%
+\fi
-\section{Paper Format Selection}
+\section{Selecting the Paper Size}
\seclabel{paperTypes}%
\BeginIndexGroup
-\BeginIndex{}{paper>format}%
-The paper format is a definitive characteristic of any document. As
-already mentioned in the description of the supported page layout
-constructions (see \autoref{sec:typearea.basics} to
-\autoref{sec:typearea.circleConstruction} from
-\autopageref{sec:typearea.basics} onwards), the entire page division
-and document layout depends on the paper format. Whereas the {\LaTeX}
-standard classes are restricted to a few formats, {\KOMAScript}
-supports in conjunction with the \Package{typearea} package even
-exotic paper sizes.
+The paper size is a key feature of a document. As already mentioned in the
+description of the supported page layout constructions (see
+\autoref{sec:typearea.basics} to \autoref{sec:typearea.circleConstruction}
+starting on \autopageref{sec:typearea.basics}), the layout of the page, and
+hence the entire document, depends on the paper size. Whereas the {\LaTeX}
+standard classes are limited to a few formats, {\KOMAScript} supports even
+unusual paper sizes in conjunction with the \Package{typearea} package.
\begin{Declaration}
- \OptionVName{paper}{format}
+ \OptionVName{paper}{size}
+ \OptionVName{paper}{orientation}
\end{Declaration}%
-The option \Option{paper}\ChangedAt{v3.00}{\Package{typearea}} is the
-central element for format selection in \KOMAScript. \PName{Format}
-supports first of all the American formats \Option{letter},
-\Option{legal}, and \Option{executive}. In addition, it supports the
-ISO formats of the series A, B, C, and D, for example \PValue{A4}
-or\,---\,written in lowercase\,---\,\PValue{a4}.
-
-Landscape formats are supported by specifying the option again, this time with
-value \PValue{landscape}\Index{paper>orientation} or
-\PValue{seascape}\ChangedAt{v3.02c}{\Package{typearea}}. The difference is
-that application \File{dvips} rotates at \PValue{landscape} by
--90\Unit{\textdegree}, while it rotates by +90\Unit{\textdegree} at
-\PValue{seascape}. So you may use \PValue{seascape} whenever a PostScript
-viewer application shows landscape pages upside-down. But you may see the
-difference only if you do not deactivate option
-\DescRef{\LabelBase.option.pagesize}, which will be described next.
-
-Additionally\ChangedAt{v3.01b}{\Package{typearea}}, the \PName{format} can
-also be specified in the form \PName{height}\texttt{:}\PName{width} or
-\PName{width}\texttt{:}\PName{height}.
-Whether\ChangedAt{v3.22}{\Package{typearea}} the first or the second value is
-the \PName{height} or \PName{width} depends on the paper orientation. With
-\OptionValue{paper}{landscape} or \OptionValue{paper}{seascape} the smaller
-value is the \PName{height} and the larger one is the \PName{width}. With
-\OptionValue{paper}{portrait} the smaller value is the \PName{width} and the
-larger one is the \PName{height}.
+The \Option{paper}\ChangedAt{v3.00}{\Package{typearea}} option is the central
+element for paper-size selection\important[i]{%
+ \begin{tabular}[t]{@{}l@{}l@{}}
+ \KOption{paper} & \PValue{letter}, \\
+ & \PValue{legal}, \\
+ & \PValue{executive}, \\
+ & \PValue{A0}, \PValue{A1}, \PValue{A2} \dots\\
+ & \PValue{B0}, \PValue{B1}, \PValue{B2} \dots\\
+ & \PValue{C0}, \PValue{C1}, \PValue{C2} \dots\\
+ & \PValue{D0}, \PValue{D1}, \PValue{D2} \dots\end{tabular}} %
+in \KOMAScript. \PName{Size} supports the American formats \Option{letter},
+\Option{legal}, and \Option{executive}. In addition, it supports the ISO
+formats of the series A, B, C, and D, for example \PValue{A4} or\,---\,written
+in lower case\,---\,\PValue{a4}.
+
+Landscape orientations\important{%
+ \begin{tabular}[t]{@{}l@{}l@{}}
+ \KOption{paper} & \PValue{landscape}, \\
+ & \PValue{seascape}
+ \end{tabular}%
+} are supported by specifying the option one more time
+with the value \PValue{landscape}\Index{paper>orientation} or
+\PValue{seascape}\ChangedAt{v3.02c}{\Package{typearea}}. The only difference
+between \PValue{landscape} and \PValue{seascape} is that that the application
+\File{dvips} rotates \PValue{landscape} pages by -90\Unit{\textdegree}, while
+it rotates \PValue{seascape} pages by +90\Unit{\textdegree}. Thus
+\PValue{seascape} is particularly useful whenever a PostScript viewer shows
+landscape pages upside-down. In order for the difference to have an effect,
+you must not deactivate the \DescRef{\LabelBase.option.pagesize}%
+\IndexOption{pagesize}\important{\DescRef{\LabelBase.option.pagesize}} option
+described below.
+
+Additionally, the \PName{size} can also be specified either in the form
+\PName{width}\texttt{:}\PName{height}\ChangedAt{v3.01b}{\Package{typearea}}%
+\important{\OptionVName{paper}{width\textup{:}height}} or in the form
+\PName{height}\texttt{:}\PName{width}\ChangedAt{v3.22}{\Package{typearea}}%
+\important{\OptionVName{paper}{height\textup{:}width}}. Which value is taken
+as the \PName{height} and which as the \PName{width} depends on the
+orientation of the paper. With \OptionValue{paper}{landscape} or
+\OptionValue{paper}{seascape}, the smaller value is the \PName{height} and the
+larger one is the \PName{width}. With
+\OptionValue{paper}{portrait}\important{\OptionValue{paper}{portrait}}, the
+smaller value is the \PName{width} and the larger one is the \PName{height}.
Note\textnote{Attention!} that until version~3.01a the first value was always
the \PName{height} and the second one the \PName{width}. From version~3.01b
-until version~3.21, the first value was always the \PName{width} and the
+through version~3.21, the first value was always the \PName{width} and the
second one the \PName{height}. This is important if you use compatibility
-settings (see option
-\DescRef{\LabelBase.option.version}%
+settings (see option \DescRef{\LabelBase.option.version}%
\IndexOption{version}\important{\DescRef{\LabelBase.option.version}},
\autoref{sec:typearea.compatibilityOptions},
\DescPageRef{typearea.option.version}).
\begin{Example}
- Assume one wishes to print on ISO A8 file cards in landscape
- orientation. Margins should be very small, no header or footer
- will be used.
+ Suppose you want to print an ISO-A8 index card in landscape orientation. The
+ margins should be very small and no header or footer will be used.
\begin{lstcode}
\documentclass{article}
\usepackage[headinclude=false,footinclude=false,
@@ -1437,9 +1525,8 @@ settings (see option
b0, b1 \dots\ c0, c1 \dots\ d0, d1 \dots
\end{document}
\end{lstcode}
-If the file cards have the special format (height:width)
-5\Unit{cm}\,:\,3\Unit{cm}, this can be achieved using the following
-code.
+ If the file cards have the special format (height:width)
+ 5\Unit{cm}\,:\,3\Unit{cm}, this can be achieved using the following:
\begin{lstcode}
\documentclass{article}
\usepackage[headinclude=false,footinclude=false,%
@@ -1454,22 +1541,25 @@ code.
\end{lstcode}
\end{Example}
-As part of the predefined defaults, {\KOMAScript} uses A4 paper in
-portrait orientation. This is in contrast to the standard classes,
+By default, {\KOMAScript} uses A4 paper in portrait orientation. This is in
+contrast\textnote{\KOMAScript{} vs. standard classes} to the standard classes,
which by default use the American letter paper format.
-Please note that when using these options with one of the {\KOMAScript}
-classes, it must be used either as a class option, or passed via
-\DescRef{\LabelBase.cmd.KOMAoptions} or \DescRef{\LabelBase.cmd.KOMAoption}
-after loading the class. Changing of this option after loading the
-\Package{typearea} package does not result in an automatic recalculation of
-the type area. Instead, the changes only take effect at the next recalculation
-of the type area. For recalculation of the type area, refer to the
-\DescRef{\LabelBase.option.DIV} option with the values \PValue{last} or
-\PValue{current} (see \DescPageRef{typearea.option.DIV.last}) or the
+Please note\textnote{Attention!} that these options must be passed as class
+options when using one of the {\KOMAScript} classes, or after loading the
+class with \DescRef{\LabelBase.cmd.KOMAoptions} or
+\DescRef{\LabelBase.cmd.KOMAoption}. Changing the paper size or orientation
+with \DescRef{\LabelBase.cmd.KOMAoptions} or
+\DescRef{\LabelBase.cmd.KOMAoption} does not\textnote{no automatic
+recalculation} automatically recalculate the type area. Instead, the changes
+only take effect the next time the type area is recalculated. For
+recalculation of the type area, see the
+\hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}} option with the
+values \hyperref[desc:\LabelBase.option.DIV.last]{\PValue{last}} or
+\hyperref[desc:\LabelBase.option.DIV.current]{\PValue{current}} (see
+\DescPageRef{typearea.option.DIV.last}) or the
\DescRef{\LabelBase.cmd.recalctypearea} command (see
\DescPageRef{typearea.cmd.recalctypearea}).%
-%
\EndIndexGroup
@@ -1477,96 +1567,122 @@ of the type area. For recalculation of the type area, refer to the
\OptionVName{pagesize}{output driver}
\end{Declaration}%
\begin{Explain}%
- The above-mentioned mechanisms for choice of paper format only
- affect the output insofar as internal {\LaTeX} lengths are set. The
- \Package{typearea} package then uses them in the division of the
- page into type area and margins.
- The specification of the DVI
- formats\Index{DVI}, however, does not include any indications of paper
- format. If printing is done directly from DVI format to a low-level
- printer language such as PCL%
- \iffalse% Umbruchkorrektur
- \footnote{PCL is the printer language used by HP for its inkjet and
- laser printers.}%
- \fi \ or ESC/P2%
- \iffalse% Umbruchkorrektur
- \footnote{ESC/P2 is the printer language used by EPSON for its
- dot-matrix, inkjet and laser printers.}%
- \fi , this is usually not an issue since with this output also the
- zero-position is at the top left, identical to DVI. If, however,
- translation is made into a language such as
- PostScript\Index{PostScript} or PDF\Index{PDF}, in which the
- zero-position is at a different point, and in which also the paper
- format should be specified in the output data, then this information
- is missing. To solve this problem, the respective drivers use a
- predefined paper size, which the user can change either by means of
- an option or via a corresponding command in the {\TeX} source
- file. When using the DVI driver \File{dvips} the information can be
- given in the form of a \Macro{special} command. With {pdf\TeX} or
- {V\TeX} one sets instead two lengths.
+ The above-mentioned mechanisms for choosing the paper format only affect the
+ output insofar as internal {\LaTeX} lengths are set. The \Package{typearea}
+ package then uses them in dividing the page into type area and margins.
+ The specification of the DVI formats\Index{DVI}, however, does not include
+ any indication of paper size. %
+ \iffree{%
+ When outputting directly from the DVI format to a low-level printer
+ language such as PCL%
+ \iftrue% Umbruchkorrektur
+ \footnote{PCL is a family of printer languages that HP uses for its
+ inkjet and laser printers.}%
+ \fi \ or ESC/P2%
+ \iftrue% Umbruchkorrektur
+ \footnote{ESC/P2 is the printer language that EPSON uses for its
+ dot-matrix, and older inkjet or laser printers.}%
+ \fi \ or ESC/P-R%
+ \iftrue% Umbruchkorrektur
+ \footnote{ESC/P-R is the printer language that EPSON currently uses for
+ inkjet and laser printers.}%
+ \fi, this is usually not an issue%
+ }{%
+ In the past, when DVI was printed directly into a low-level printer
+ language, it did not matter%
+ }, since with these formats the reference zero-position is at the top left,
+ as in DVI. But nowadays, the output is normally translated into languages
+ such as PostScript\Index{PostScript} or PDF\Index{PDF}, in which the
+ zero-position is at a different point, and in which the paper format should
+ be specified in the output file, which is missing this information. To solve
+ this problem, the corresponding driver uses a default paper size, which the
+ user can change either by an option or by specifying it in the {\TeX} source
+ file. When using the DVI driver \File{dvips} or \File{dvipdfm}, the
+ information can be given in the form of a \Macro{special} command. When
+ using {pdf\TeX}, {lua\TeX}, {\XeTeX} or {V\TeX} their paper-size lengths are
+ set appropriately.
\end{Explain}
-With option \Option{pagesize} you may select an output driver for writing the
-paper size into the destination document. Supported output drivers are listed
-at \autoref{tab:typearea.outputdriver}. The
-default\ChangedAt{v3.17}{\Package{typearea}} is \Option{pagesize}. This usage
-without value is same like \OptionValue{pagesize}{auto}.
+With the \Option{pagesize} option, you can select an output driver for writing
+the paper size into the destination document. Supported output drivers are
+listed at \autoref{tab:typearea.outputdriver}\iffalse%
+, \autopageref{tab:typearea.outputdriver}\fi. The
+default\ChangedAt{v3.17}{\Package{typearea}} is \Option{pagesize}. Using this
+option without providing a value is equivalent to \OptionValue{pagesize}{auto}.
%
\begin{table}
\caption{Output driver for option \OptionVName{pagesize}{output driver}}
\begin{desctabular}
- \pventry{auto}{Uses output driver \PValue{pdftex} if pdf\TeX-specific
- registers \Macro{pdfpagewidth}\IndexLength{pdfpagewidth} and
- \Macro{pdfpageheight}\IndexLength{pdfpageheight} are defined. In
- addition, output driver \PValue{dvips} will be
- used.\IndexOption{pagesize~=\PValue{auto}}}%
+ \pventry{auto}{Uses output driver \PValue{pdftex} if the pdf\TeX-specific
+ lengths \Macro{pdfpagewidth}\IndexLength{pdfpagewidth} and
+ \Macro{pdfpageheight}\IndexLength{pdfpageheight} or the lua\TeX-specific
+ lengths \Macro{pagewidth}\IndexLength{pagewidth} and
+ \Macro{pageheight}\IndexLength{pageheight} are defined. In addition, the
+ output driver \PValue{dvips} will also be used. This setting is in
+ principle also suitable for \XeTeX{}.%
+ \IndexOption{pagesize~=\textKValue{auto}}}%
\pventry{automedia}{Almost the same as \PValue{auto} but if the
- \mbox{V\TeX}-specific registers
+ \mbox{V\TeX}-specific lengths
\Macro{mediawidth}\IndexLength{mediawidth} and
\Macro{mediaheight}\IndexLength{mediaheight} are defined, they will be
- set additionally.\IndexOption{pagesize~=\PValue{automedia}}}%
+ set as well.\IndexOption{pagesize~=\textKValue{automedia}}}%
\entry{\PValue{false}, \PValue{no}, \PValue{off}}{%
Does not set any output driver and does not send page size information to
- the output driver.\IndexOption{pagesize~=\PValue{false}}}%
- \pventry{dvipdfmx}{\ChangedAt{v3.05a}{\Package{typearea}}Writes paper size
- into DVI files using
+ the output driver.\IndexOption{pagesize~=\textKValue{false}}}%
+ \pventry{dvipdfmx}{\ChangedAt{v3.05a}{\Package{typearea}} Writes the paper
+ size into DVI files using
\Macro{special}\PParameter{pagesize=\PName{width},\PName{height}}. The
- name of the output driver is \PValue{dvipdfmx} because application
- \File{dvipdfmx} handles such specials not only at document preamble but
- at the document body too.\IndexOption{pagesize~=\PValue{dvipdfmx}}}%
- \pventry{dvips}{Using this option at the document preamble sets paper size
+ name of the output driver is \PValue{dvipdfmx} because the application
+ \File{dvipdfmx} handles such specials not just in the preamble but
+ in the document body too.\IndexOption{pagesize~=\textKValue{dvipdfmx}}}%
+ \pventry{dvips}{Using this option in the preamble sets the paper size
using
- \Macro{special}\PParameter{pagesize=\PName{width},\PName{height}}. While
- application \File{dvips} cannot handle changes of paper size at the
- inner document pages a hack is needed to achieve such changes. Use
- changes of paper size after \Macro{begin}\PParameter{document} on your
+ \Macro{special}\PParameter{pagesize=\PName{width},\PName{height}}. Since
+ the \File{dvips} driver cannot handle changes of paper size in the
+ inner document pages, a hack is required to achieve such changes. Use
+ changes of paper size after \Macro{begin}\PParameter{document} at your
own risk, if you are using
- \PValue{dvips}!\IndexOption{pagesize~=\PValue{dvips}}}%
- \pventry{pdftex}{Sets paper size using the pdf\TeX-specific registers
+ \PValue{dvips}!\IndexOption{pagesize~=\textKValue{dvips}}}%
+ \entry{\PValue{pdftex}, \PValue{luatex}}{%
+ \ChangedAt{v3.20}{\Package{typearea}}Sets paper size using the
+ pdf\TeX-specific lengths
\Macro{pdfpagewidth}\IndexLength{pdfpagewidth} and
- \Macro{pdfpageheight}\IndexLength{pdfpageheight}. You may do this at any
- time in your document.\IndexOption{pagesize~=\PValue{pdftex}}}%
+ \Macro{pdfpageheight}\IndexLength{pdfpageheight} or the
+ lua\TeX-specific lengths \Macro{pagewidth}\IndexLength{pagewidth}
+ and \Macro{pageheight}\IndexLength{pageheight}. You can do this at any
+ time in your document.%
+ \IndexOption{pagesize~=\textKValue{pdftex}}%
+ \IndexOption{pagesize~=\textKValue{luatex}}}%
\end{desctabular}
\label{tab:typearea.outputdriver}
\end{table}
\begin{Example}
- Assume that a document should be available both as a DVI data file
- and in PDF format for online viewing. Then the preamble might begin
+ Suppose a document should be available both as a DVI data file
+ and in PDF format for on-line viewing. The preamble might begin
as follows:
-\begin{lstcode}
+\begin{lstcode}[%
+ aboveskip=.5\baselineskip plus .1\baselineskip minus .1\baselineskip,%
+ belowskip=.4\baselineskip plus .1\baselineskip minus .1\baselineskip]
\documentclass{article}
\usepackage[paper=A4,pagesize]{typearea}
\end{lstcode}
-If the {pdf\TeX} engine is used \emph{and} PDF output is
-activated, then the two lengths \Macro{pdfpagewidth} and
-\Macro{pdfpageheight} are set appropriately. If, however, a DVI data
-file is created\,---\,regardless of whether by {\LaTeX} or by
-{pdf\LaTeX}\,---\,then a \Macro{special} is written at the start of
-this data file.
+ If the {pdf\TeX} engine is used \emph{and} PDF output is enabled, the
+ lengths \Macro{pdfpagewidth} and \Macro{pdfpageheight} are set
+ appropriately. If, however, a DVI data file is created\,---\, whether by
+ {\LaTeX} or by {pdf\LaTeX}\,---\,then a \Macro{special} is written at the
+ start of this data file.
\end{Example}%
-It is recommended always to specify this option. Generally the method
-without \PName{output driver}, or with \PValue{auto} or
-\PValue{automedia}, is useful.%
+\iffree{% The recommendation is actually outdated. Those who use such old
+ % versions of typearea are the ones at fault.
+ If you use an older version of \Package{typearea}, you
+ should\textnote{Attention!} always specify the \Option{pagesize} option,
+ because older versions of \Package{typearea} did not set them by default. As
+ a rule, the method without an \PName{output driver} or with \PValue{auto} or
+ \PValue{automedia} is convenient.%
+}{%
+ \vskip-1\ht\strutbox plus
+ .75\ht\strutbox% Wegen Beispiel am Ende der Erklaerung
+}%
\EndIndexGroup
%
\EndIndexGroup
@@ -1575,116 +1691,118 @@ without \PName{output driver}, or with \PValue{auto} or
\section{Tips}
\seclabel{tips}
-For theses many rules exist that violate even the most
-elementary rules of typography. The reasons for such rules include
-typographical incompetence of those making them, but also the fact
-that they were originally meant for mechanical typewriters. With a
-typewriter or a primitive text processor dating back to the early
-1980s, it was not possible to produce typographically correct output
-without extreme effort. Thus rules were created that appeared to be
-achievable and still allowed easy correction. To avoid short lines
-made worse by ragged margins, the margins were kept narrow and the
-line spacing was increased to 1.5 for corrections. Before the advent
-of modern text processing systems, single-spaced would have been the
-only alternative\,---\,other than with \TeX. In such a single-spaced
-document even correction signs would have been difficult to add. When
-computers became more widely available for text processing, some
-students tried to use a particularly ``nice'' font to make their work
-look better than it really was. They forgot however that such fonts
-are often more difficult to read and therefore unsuitable for this
-purpose. Thus two bread-and-butter fonts became widely used which
-neither fit together nor are particularly suitable for the job. In
-particular Times is a relatively narrow font which was developed at
-the beginning of the 20$^{th}$ century for the narrow columns of
-British newspapers. Modern versions usually are somewhat improved. But
-still the Times font required in many rules does not really fit to the
-margin sizes prescribed.
-
-{\LaTeX} already uses sufficient line spacing, and the margins are
-wide enough for corrections. Thus a page will look generous, even when
-quite full of text.
-
-To some extent, the questionable rules are difficult to implement in
-{\LaTeX}. A fixed number of characters per line can be kept only when
-a non-proportional font is used. There are very few good
-non-proportional fonts available. Hardly a text typeset in this way
-looks really good. In many cases font designers try to increase the
-serifs on the `i' or `l' to compensate for the different character
-width. This cannot work and results in a fragmented and
-agitated-looking text. If one uses {\LaTeX} for one's paper, some of
-these rules have to be either ignored or at least interpreted
-generously. For example one may interpret ``60 characters per line''
-not as a fixed, but as an average or maximal value.%
-
-As executed, record regulations are usually intended to obtain a usable result
-even if the author does not know what needs to be considered. \emph{Usable}
-frequently means readable and correctable. In the author's opinion the type
-area of a text set with {\LaTeX} and the \Package{typearea} package meets
-these criteria well right from the start. Thus if one is confronted with
-regulations which deviate obviously substantially from it, then the author
-recommends submitting an extract from the text to the responsible person and
-inquiring whether it is permitted to submit the work despite deviations in the
-format. If necessary the type area can be moderately adapted by modification
-of option \DescRef{\LabelBase.option.DIV}. The author advises against the use
-of \DescRef{\LabelBase.cmd.areaset} for this purpose however. In the worst
-case one may make use of the geometry package (see \cite{package:geometry}),
-which is not part of \KOMAScript, or change the type area parameters of
-\LaTeX. One may find the values determined by \Package{typearea} in the
-\File{log} file of one's document. Thus moderate adjustments should be
-possible. However, one should make absolutely sure that the proportions of
-the text area correspond approximately to those of the page including
-consideration of the binding correction.
-
-If it should prove absolutely necessary to set the text with a line
-spacing of 1.5, then one should not under any circumstances redefine
-\Macro{baselinestretch}. Although this procedure is recommended all
-too frequently, it has been obsolete since the introduction of
-{\LaTeXe} in 1994. In the worst case one may use the instruction
-\Macro{linespread}. The author recommends the package
-\Package{setspace}\IndexPackage{setspace} (see
-\cite{package:setspace}), which is not part of \KOMAScript. Also one
-should let \Package{typearea} recalculate a new type area after the
-conversion of the line spacing. However, one should switch back to
-the normal line spacing for the title, preferably also for the table
-contents and various listings\,---\,as well as the bibliography and
-the index. The \Package{setspace} package offers for this a special
-environment and its own instructions.
+For theses and dissertations, many rules exist that violate even the most
+elementary rules of typography.\textnote{formatting rules vs. good typography}
+The reasons for such rules include the typographical incompetence of those who
+issue them, but also the fact that they were originally meant for mechanical
+typewriters. With a typewriter or a primitive text processor from the early
+1980s, it was not possible to produce typographically correct output without
+extreme effort. So rules were created that appeared to be easy to follow and
+were still accommodating to a proofreader. These include margins that lead to
+usable line lengths for one-sided printing with a typewriter. To avoid
+extremely short lines, which are made worse by unjustified text, the margins
+were kept narrow and the leading was increased to 1.5 lines to allow space for
+corrections. Before the advent of modern text processing systems, single
+spacing would have been the only alternative\,---\,except with \TeX. In such a
+single-spaced document, even correction signs would have been difficult to
+add. When computers became more widely available for text processing, some
+students showed their playful side and tried to spice up their work by using
+an ornamental font to make their work look better than it really was. They did
+not consider that such fonts are often more difficult to read and therefore
+unsuitable for this purpose. Thus, two font families found their way
+into the regulations which are neither compatible nor particularly suitable
+for the job in the case of Times. Times is a relatively narrow typeface
+designed at the beginning of the 20th century for the narrow columns of
+British newspapers. Modern versions usually are somewhat improved. But still
+the Times font, which is often required, does not really fit the prescribed
+margins.
+
+{\LaTeX} already uses adequate line spacing, and the margins are wide enough
+for corrections. Thus a page will look spacious, even when quite full of text.
+
+Often these typographically questionable rules are difficult to implement in
+{\LaTeX}. A fixed number of characters per line can be achieved only when a
+non-proportional font is used. There are very few good non-proportional fonts
+available. Hardly any text typeset in this way looks really good. In many
+cases font designers try to increase the serifs on the `i' or `l' to
+compensate for the different character widths. This does not work and results
+in a fragmented and agitated-looking text. If you use {\LaTeX} for your
+thesis, some of these rules have to be either ignored or at least interpreted
+generously. For example, ``60 characters per line'' can be interpreted not as
+a fixed but as an average or maximum value.%
+
+As implemented, typesetting rules are usually intended to obtain a useful
+result even if the author does not know what needs to be considered.
+\emph{Useful} frequently means readable and correctable. In my opinion the
+type area of a text set with {\LaTeX} and the \Package{typearea} package meets
+these criteria well from the outset. So if you are confronted with regulations
+which deviate substantially from it, I recommend that you present a sample of
+the text to your advisor and ask whether you can submit the work despite
+deviations in the format. If necessary the type area can be adapted somewhat
+by changing the \DescRef{\LabelBase.option.DIV}%
+\important{\DescRef{\LabelBase.option.DIV}} option. I advise against
+using \DescRef{\LabelBase.cmd.areaset} for this purpose, however. In the
+worst case, use the \Package{geometry} package%
+\important{\Package{geometry}}\IndexPackage{geometry} (see
+\cite{package:geometry}), which is not part of \KOMAScript, or change the page
+layout parameters of \LaTeX{} yourself. You can find the values as determined
+by \Package{typearea} in the \File{log} file of your document. The
+\DescRef{typearea-experts.option.usegeometry}%
+\important{\DescRef{typearea-experts.option.usegeometry}} option, which you
+can find in \autoref{part:forExperts}, can also improve the interactions
+between \Package{typearea} and \Package{geometry}. This should allow modest
+adjustments. However, make sure that the proportions of the text area match
+those of the page, taking the binding correction into account.
+
+If it is absolutely necessary to set the text with a line spacing of 1.5, do
+not under any circumstances redefine \Macro{baselinestretch}. Although this
+procedure is recommended all too frequently, it has been obsolete since the
+introduction of {\LaTeXe} in 1994. In the worst case, use the
+\Macro{linespread} command. I recommend the package
+\Package{setspace}\important{\Package{setspace}}\IndexPackage{setspace} (see
+\cite{package:setspace}), which is not part of \KOMAScript. You should also
+let \Package{typearea} recalculate a new type area after changing the line
+spacing. However, you should switch back to the normal line spacing for the
+title, and preferably for the table of contents and various lists\,---\,as
+well as the bibliography and the index. For details, see the explanation of
+\OptionValueRef{\LabelBase}{DIV}{current}%
+\important{\OptionValueRef{\LabelBase}{DIV}{current}}.
The \Package{typearea} package, even with option
-\OptionValueRef{\LabelBase}{DIV}{calc}, calculates a very generous text area.
-Many conservative typographers will state that the resulting line length is
-still excessive. The calculated \Var{DIV} value may be found in the \File{log}
-file for the respective document. Thus one can select a smaller value easily
+\OptionValueRef{\LabelBase}{DIV}{calc}%
+\important{\OptionValueRef{\LabelBase}{DIV}{calc}}, calculates a very generous
+text area. Many conservative typographers will find that the resulting line
+length is still excessive. The calculated \Var{DIV} value may be found in the
+\File{log} file for each document. So you can easily choose a smaller value
after the first {\LaTeX} run.
-The question is not infrequently put to the author, why he spends an
-entire chapter discussing type area calculations, when it would be
-very much simpler to merely give the world a package with which anyone
-can adjust the margins like in a word processor. Often it is added
-that such a package would in any case be the better solution, since
-everyone can judge for themselves how good margins are to be chosen,
-and that the margins calculated by {\KOMAScript} are anyway not that
-great. The author takes the liberty of translating a suitable
-quotation from \cite{TYPO:ErsteHilfe}. One may find the original
-German words in the German scrguide.
-
+Not\textnote{What is better?} infrequently I am asked why I dwell on type area
+calculations for an entire chapter, when it would be much easier just to
+provide a package with which you can adjust the margins as in a word
+processor. Often it is said that such a package would be a better solution in
+any case, since everyone knows how to choose appropriate margins, and that the
+margins calculated by {\KOMAScript} are not that good anyway. I would like to
+quote Hans Peter Willberg and Friedrich Forssmann, two of the most respected
+contemporary typographers \cite{TYPO:ErsteHilfe}. (You can find the original
+German in the German guide.)
\begin{quote}
\phantomsection\seclabel{tips.cite}%
- \textit{The practice of doing things oneself is long-since
- widespread, but the results are often dubious because layman
- typographers do not see what is incorrect and cannot know what is
- important. Thus one becomes accustomed to incorrect and poor
- typography.} [\dots] \textit{Now the objection could be made that
- typography is dependent on taste. If it concerned decoration,
- perhaps one could let that argument slip by; however, since
- typography is primarily concerned with information, errors cannot
- only irritate, but may even cause damage.}
+ \textit{The\textnote{Quote!} practice of doing things oneself has long been
+ widespread, but the results are often dubious because amateur typographers
+ do not see what is wrong and cannot know what is important. This is how
+ you get used to to incorrect and poor typography.} [\dots] \textit{Now the
+ objection could be made that typography is a matter of taste. When it
+ comes to decoration, one could perhaps accept that argument, but since
+ typography is primarily about information, not only can mistakes irritate,
+ but they may even cause damage.}
\end{quote}
%
\EndIndexGroup
%%% Local Variables:
%%% mode: latex
+%%% mode: flyspell
%%% coding: us-ascii
+%%% ispell-local-dictionary: "en_GB"
%%% TeX-master: "../guide"
-%%% End:
+%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/guide.bib b/Master/texmf-dist/source/latex/koma-script/doc/guide.bib
index ce7c87cad37..03e8e4eec4a 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/guide.bib
+++ b/Master/texmf-dist/source/latex/koma-script/doc/guide.bib
@@ -1,6 +1,6 @@
% ======================================================================
% guide.bib
-% Copyright (c) Markus Kohm, 2002-2013
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% guide.bib
-% Copyright (c) Markus Kohm, 2002-2013
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -120,12 +120,27 @@
author = {Kohm, Markus},
title = {{\KOMAScript}},
subtitle= {Eine Sammlung von Klassen und Paketen für {\LaTeXe}},
- year = 2014,
- edition = 5,
+ year = 2018,
+ edition = 6,
+ publisher={Lehmanns Media},
+ address = {Berlin},
+ series = {Edition DANTE},
+ isbn = {978-3-86541-951-4},
+ note = {Print-Ausgabe}
+}
+
+@Book{ ebook:komascript,
+ language= {ngerman},
+ author = {Kohm, Markus},
+ title = {{\KOMAScript}},
+ subtitle= {Eine Sammlung von Klassen und Paketen für {\LaTeXe}},
+ year = 2018,
+ edition = 6,
publisher={Lehmanns Media},
address = {Berlin},
series = {Edition DANTE},
- isbn = {978-3-86541-613-1}
+ isbn = {978-3-86541-952-1},
+ note = {eBook-Ausgabe}
}
@Book{ latexbook,
@@ -498,8 +513,8 @@ Schlegl},
language= {english},
author = {David P. Carlisle},
title = {Packages in the `graphics' bundle},
- year = 2005,
- month = nov,
+ year = 2017,
+ month = jun,
url = {CTAN://macros/latex/required/graphics/}
}
@@ -513,6 +528,16 @@ Schlegl},
url = {CTAN://macros/latex/contrib/hyperref/}
}
+@Misc{ package:ifluatex,
+ language= {english},
+ author = {Heiko Oberdiek},
+ title = {The {\Package{ifluatex}} package},
+ year = 2016,
+ month = apr,
+ edition = {1.4},
+ url = {CTAN://macros/latex/contrib/oberdiek/}
+}
+
@Misc{ package:ifthen,
language= {english},
author = {David Carlisle},
@@ -523,6 +548,16 @@ Schlegl},
url = {CTAN://macros/latex/base/}
}
+@Misc{ package:imakeidx,
+ language= {english},
+ author = {Enrico Gregorio},
+ title = {The package {\Package{imakeidx}}},
+ year = 2016,
+ month = oct,
+ edition = {1.3e},
+ url = {CTAN://macros/latex/contrib/imakeidx}
+}
+
@Misc{ package:keyval,
language = {english},
author = {David Carlisle},
@@ -533,6 +568,15 @@ Schlegl},
url = {CTAN://macros/latex/required/graphics/}
}
+@Misc{ package:koma-script-obsolete,
+ language = {english},
+ author = {Markus Kohm},
+ title = {Deprecated Packages from {\KOMAScript}},
+ year = 2013,
+ month = dec,
+ url = {CTAN://obsolete/macros/latex/contrib/koma-script-obsolete}
+}
+
@Misc{ package:longtable,
language = {english},
author = {David Carlisle},
@@ -616,10 +660,10 @@ Schlegl},
language = {english},
author = {Heiko Oberdiek},
title = {The {\Package{picture}} package},
- year = 2009,
- month = oct,
- edition = {1.3},
- url = {CTAN://macros/latex/contrib/oberdiek/picture.dtx}
+ year = 2016,
+ month = may,
+ edition = {1.4},
+ url = {CTAN://macros/latex/contrib/oberdiek/}
}
@Misc{ package:ragged2e,
@@ -636,9 +680,9 @@ Schlegl},
language= {english},
author = {Heiko Oberdiek},
title = {The {\Package{selinput}} package},
- year = 2007,
- month = sep,
- edition = {1.2},
+ year = 2016,
+ month = may,
+ edition = {1.4},
url = {CTAN://macros/latex/contrib/oberdiek/}
}
@@ -654,12 +698,22 @@ Schlegl},
@Misc{ package:splitindex,
language= {english},
- author = {Markus Kohm},
- title = {Creating More Than One Index Using {\Package{splitidx}} And {\Package{SplitIndex}}},
- year = 2014,
- month = apr,
- edition = {1.2a},
- url = {CTAN://macros/latex/contrib/splitindex/}
+ author = {Markus Kohm},
+ title = {Creating More Than One Index Using {\Package{splitidx}} And {\Package{SplitIndex}}},
+ year = 2014,
+ month = apr,
+ edition = {1.2a},
+ url = {CTAN://macros/latex/contrib/splitindex/}
+}
+
+@Misc{ package:supertabular,
+ language= {english},
+ author = {Braams, Johannes L. and Jurriens, Theo},
+ title = {The {\Package{supertabular}} environment},
+ year = 2004,
+ month = feb,
+ edition = {4.1e},
+ url = {CTAN://macros/latex/contrib/supertabular}
}
@Misc{ package:tabu,
@@ -729,6 +783,24 @@ Schlegl},
url = {http://www.komascript.de}
}
+@Misc{ https://komascript.de/comment/5070,
+ language= {ngerman},
+ author= {Markus Kohm},
+ title= {{\OptionValue{chapteratlists}{entry}} automatisch nur für Kapitel mit Einträgen},
+ year= 2015,
+ month= jul,
+ url= {https://komascript.de/comment/5070#comment-5070},
+}
+
+@Misc{ https://komascript.de/node/2154,
+ language= {ngerman},
+ author = {Felix999},
+ title = {Paket {\Package{adrconf}} verlangt nicht vorhandene Datei {\File{scrpage.sty}}},
+ year = 2017,
+ month = dec,
+ url = {https://komascript.de/node/2154},
+}
+
@Misc{ www:NF.lco,
language = {english},
author = {Jean-Marie Pacquet},
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/guide.tex b/Master/texmf-dist/source/latex/koma-script/doc/guide.tex
index e22f7c8e590..7386ccba9c7 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/guide.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/guide.tex
@@ -1,6 +1,6 @@
% ======================================================================
% guide.tex
-% Copyright (c) Markus Kohm, 2002-2015
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% guide.tex
-% Copyright (c) Markus Kohm, 2002-2015
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -48,7 +48,7 @@
\documentclass[\languagename]{scrguide}
\KOMAProvidesFile{guide.tex}
- [$Date: 2015-04-21 10:08:26 +0200 (Tue, 21 Apr 2015) $
+ [$Date: 2018-02-07 13:47:54 +0100 (Wed, 07 Feb 2018) $
KOMA-Script (guide main file)]
\begin{document}
@@ -72,8 +72,8 @@
\dedication{\GuideDedication}
\pdfbookmark[-1]{\KOMAScript}{title}
-\bookmark[level=0,gotor=scrguide.pdf]{Deutsch}
-\bookmark[level=0,gotor=scrguien.pdf]{English}
+\iffree{\bookmark[level=0,gotor=scrguide.pdf]{Deutsch}
+\bookmark[level=0,gotor=scrguien.pdf]{English}}{}
\bookmarksetup{startatroot}
\maketitle
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/linkalias.tex b/Master/texmf-dist/source/latex/koma-script/doc/linkalias.tex
index 16dcdc1d4e8..3d4328a4891 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/linkalias.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/linkalias.tex
@@ -39,7 +39,7 @@
%
\KOMAProvidesFile{linkalias.tex}
- [$Date: 2016-11-20 17:40:30 +0100 (Sun, 20 Nov 2016) $
+ [$Date: 2017-12-03 22:49:27 +0100 (Sun, 03 Dec 2017) $
link aliases for the free version]
\makeatletter
@@ -67,3 +67,6 @@
\lalias{desc:maincls-experts.cmd.AfterBibliographyPreamble}{sec:maincls-experts.addInfos}
\lalias{desc:maincls-experts.option.fontsize}{sec:maincls-experts.addInfos}
\lalias{desc:maincls-experts.cmd.raggedsection}{sec:maincls-experts.coexistence}
+\lalias{desc:maincls-experts.cmd.thepage}{sec:maincls-experts.addInfos}
+\lalias{desc:maincls-experts.cmd.pagemark}{sec:maincls-experts.addInfos}
+\lalias{desc:maincls-experts.cmd.the/Zaehler/}{sec:maincls-experts.addInfos}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/adrconvnote.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/adrconvnote.tex
index eb97491e76d..ddec394b53e 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/adrconvnote.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/adrconvnote.tex
@@ -1,6 +1,6 @@
% ======================================================================
% adrconvnote.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% adrconvnote.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{adrconvnote.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-01-29 14:12:59 +0100 (Mon, 29 Jan 2018) $
KOMA-Script guide (chapter: adrconv)]
\chapter{Adressdateien aus Adressdatenbanken}%
@@ -59,7 +59,7 @@ In früheren Versionen von \KOMAScript{} war das Paket
\Package{addrconv} ein fester Bestandteil des
\KOMAScript{}-Systems.
Die hauptsächliche Verflechtung mit \KOMAScript{}
-bestand darin, dass mit Hilfe dieses Paketes aus
+bestand darin, dass mit Hilfe dieses Pakets aus
Adressdatenbanken im \BibTeX-Format Adressdateien
für die \KOMAScript-Briefklasse oder für das
\Package{scraddr}-Paket erstellt werden konnten.
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/authorpart.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/authorpart.tex
index 9cc3e39ed6a..c0207de5f9d 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/authorpart.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/authorpart.tex
@@ -1,6 +1,6 @@
% ======================================================================
% authorpart.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% authorpart.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -72,8 +72,7 @@
geschaffen wurden.
}
-\part{\KOMAScript{} für Autoren}
-\label{part:forAuthors}
+\part{\KOMAScript{} für Autoren\label{part:forAuthors}}
\endinput
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-compatibility.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-compatibility.tex
index 8c0c56ad339..f52b3e00e0c 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-compatibility.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-compatibility.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-compatibility.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-compatibility.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{common-compatibility.tex}
- [$Date: 2017-03-22 09:50:43 +0100 (Wed, 22 Mar 2017) $
+ [$Date: 2018-01-30 09:32:50 +0100 (Tue, 30 Jan 2018) $
KOMA-Script guide (common paragraphs)]
\section{Kompatibilität zu früheren Versionen von \KOMAScript}
@@ -58,34 +58,41 @@
Es gilt sinngemäß, was in
\autoref{sec:\ThisCommonFirstLabelBase.compatibilityOptions} geschrieben
wurde.\IfThisCommonLabelBase{scrlttr2}{ Allerdings existiert diese
- Möglichkeit bei \Class{scrlttr2} bereits seit Version~2.9t.}{} Falls Sie
- also \autoref{sec:\ThisCommonFirstLabelBase.compatibilityOptions}
- bereits gelesen und verstanden haben, können Sie in
+ Möglichkeit bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} bereits seit
+ Version~2.9t, während \Package{scrletter} sie nicht bietet, sondern
+ sozusagen immer von \OptionValue{version}{last} ausgeht.}{} Falls Sie also
+ \autoref{sec:\ThisCommonFirstLabelBase.compatibilityOptions} bereits gelesen
+ und verstanden haben, können Sie in
\autoref{sec:\ThisCommonLabelBase.compatibilityOptions.next} auf
\autopageref{sec:\ThisCommonLabelBase.compatibilityOptions.next}
fortfahren.%
}
-\IfThisCommonLabelBaseOneOf{typearea,maincls}{%
+\IfThisCommonLabelBaseOneOf{typearea,maincls,scrlttr2,scrextend}{%
Wer seine Dokumente im Quellcode archiviert, legt in der Regel allergrößten
Wert darauf, dass bei zukünftigen \LaTeX{}-Läufen immer wieder exakt
dasselbe Ergebnis erzielt wird. In einigen Fällen führen aber Verbesserungen
- und Korrekturen am Paket zu Änderungen im Verhalten, inbesondere beim
+ und Korrekturen \IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{an der
+ Klasse}{am Paket} zu Änderungen im Verhalten, inbesondere beim
Umbruch. Dies ist jedoch manchmal eher unerwünscht.%
}{%
- \IfThisCommonLabelBase{scrextend}{%
- Wer seine Dokumente im Quellcode archiviert, legt in der Regel
- allergrößten Wert darauf, dass bei zukünftigen \LaTeX{}-Läufen immer
- wieder exakt dasselbe Ergebnis erzielt wird. In einigen Fällen ist es aber
- so, dass Verbesserungen und Korrekturen an der Klasse zu Änderungen im
- Verhalten, inbesondere beim Umbruch, führen.%
- }{%
- \IfThisCommonLabelBase{scrlttr2}{%
- In einigen Fällen ist es so, dass Verbesserungen und Korrekturen an der
- Klasse zu Änderungen im Verhalten, inbesondere beim Umbruch,
- führen. Dies ist jedoch nicht immer erwünscht.%
- }{}%
- }%
+% \IfThisCommonLabelBase{scrextend}{%
+% In einigen Fällen ist es so, dass Verbesserungen und Korrekturen am Paket
+% zu Änderungen im Verhalten, inbesondere beim Umbruch, führen. Dies ist
+% jedoch nicht immer erwünscht.%
+% Wer seine Dokumente im Quellcode archiviert, legt in der Regel
+% allergrößten Wert darauf, dass bei zukünftigen \LaTeX{}-Läufen immer
+% wieder exakt dasselbe Ergebnis erzielt wird. In einigen Fällen ist es aber
+% so, dass Verbesserungen und Korrekturen an der Klasse zu Änderungen im
+% Verhalten, inbesondere beim Umbruch, führen.%
+% }{%
+ \ThisCommonLabelBaseFailure
+% \IfThisCommonLabelBase{scrlttr2}{%
+% In einigen Fällen ist es so, dass Verbesserungen und Korrekturen an der
+% Klasse zu Änderungen im Verhalten, inbesondere beim Umbruch,
+% führen. Dies ist jedoch nicht immer erwünscht.%
+% }{}%
+% }%
}%
@@ -103,14 +110,14 @@
\IfThisCommonLabelBase{maincls}{%
Version~2.96a besteht bei \KOMAScript{} }{%
\IfThisCommonLabelBase{scrlttr2}{%
- Version~2.9t besteht bei \Class{scrlttr2} }{%
+ Version~2.9t besteht bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} }{%
\IfThisCommonLabelBase{scrextend}{\Package{scrextend} besteht }{%
\InteralCommonFileUsageError }%
}%
}%
}%
-die Wahl, ob eine Quelldatei soweit irgend möglich auch zukünftig bei einem
-\LaTeX{}-Lauf zu exakt demselben Ergebnis führen soll oder ob jeweils
+die Wahl, ob eine Quelldatei, soweit irgend möglich, auch zukünftig bei einem
+\LaTeX{}-Lauf zu exakt demselben Ergebnis führen soll oder ob er jeweils
entsprechend der Anpassungen der neusten
Version\IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{ der Klasse}{} zu setzen
ist. Zu welcher Version Kompatibilität herzustellen ist, wird dabei über die
@@ -122,20 +129,24 @@ werden. Bei Angabe einer unbekannten Version als \PName{Wert} wird eine
Warnung ausgegeben und sicherheitshalber \OptionValue{version}{first}
angenommen.
-Mit \OptionValue{version}{last} kann die jeweils neuste Version ausgewählt
-werden. In diesem Fall wird also auf zukünftige Kompatibilität
+Mit \OptionValue{version}{last}\important{\OptionValue{version}{last}}%
+\textnote{Voreinstellung} kann die jeweils neuste Version ausgewählt
+werden. In diesem Fall wird also auf rückwirkende Kompatibilität
verzichtet. Wird die Option ohne Wertangabe verwendet, so wird ebenfalls
\PValue{last} angenommen. \ChangedAt{v3.01a}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}\and \Class{scrlttr2}\and
\Package{scrextend}}Dies entspricht auch der Voreinstellung, solange keine
obsolete Option verwendet wird.
-Bei\textnote{Achtung!} der Verwendung einer obsoleten Option von
-\KOMAScript~2 setzt \KOMAScript~3 automatisch \OptionValue{version}{first}. In
-der dabei ausgegebenen Warnung wird erklärt, wie man diese
-Kompatibilitätsumschaltung verhindern kann. Alternativ kann man auch nach der
-obsoleten Option selbst eine abweichende Einstellung für Option
-\Option{version} wählen.
+\IfThisCommonLabelBase{scrextend}{% scrextend kennt keine obsoleten Optionen
+}{%
+ Bei\textnote{Achtung!} der Verwendung einer obsoleten Option von
+ \KOMAScript~2 setzt \KOMAScript~3 automatisch
+ \OptionValue{version}{first}. In der dabei ausgegebenen Warnung wird
+ erklärt, wie man diese Kompatibilitätsumschaltung verhindern
+ kann. Alternativ kann man auch nach der obsoleten Option selbst eine
+ abweichende Einstellung für Option \Option{version} wählen.%
+}
Die Frage der Kompatibilität betrifft in erster Linie Fragen des
Umbruchs. Neue Möglichkeiten, die sich nicht auf den Umbruch auswirken, sind
@@ -159,11 +170,11 @@ auch die verwendete \KOMAScript-Version archivieren.
müssen, wurde hier die Möglichkeit des symbolischen Wertes \PValue{last}
gewählt.%
\fi
-\end{Example}}
+\end{Example}}{}
Es\textnote{Achtung!} ist zu beachten, dass die Option \Option{version} nach
dem Laden %
-\IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{der Klasse }{%
+\IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{der Klasse}{%
des Pakets \IfThisCommonLabelBase{typearea}{\Package{typearea}}{%
\IfThisCommonLabelBase{scrextend}{\Package{scrextend}}{%
\InternalCommonFileUsageError }%
@@ -172,7 +183,7 @@ dem Laden %
\DescRef{\ThisCommonLabelBase.cmd.KOMAoptions} oder
\DescRef{\ThisCommonLabelBase.cmd.KOMAoption} ist
% Umbruchkorrektur!!!!
-\IfThisCommonLabelBaseNotOneOf{scrlttr2,typearea}{für diese Option }{}%
+\IfThisCommonLabelBaseNotOneOf{maincls,scrlttr2,typearea}{für diese Option }{}%
daher nicht vorgesehen.%
%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-dictum.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-dictum.tex
index 8fc8edd2a01..22299b0e5de 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-dictum.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-dictum.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-dictum.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-dictum.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{common-dictum.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-01-29 14:12:59 +0100 (Mon, 29 Jan 2018) $
KOMA-Script guide (common paragraphs)]
@@ -65,9 +65,11 @@
\IfThisCommonLabelBase{scrextend}{%
Allerdings werden von \Package{scrextend} die Anweisungen
\DescRef{maincls.cmd.setchapterpreamble} und
- \DescRef{maincls.cmd.setpartpreamble} nicht definiert. Ob die verwendete
- Klasse eine entsprechende Anweisung bietet, ist der Anleitung zur
- jeweiligen Klasse zu entnehmen. %
+ \DescRef{maincls.cmd.setpartpreamble} nicht definiert. %
+ \iftrue% Umbruchvariante
+ Ob die verwendete Klasse eine entsprechende Anweisung bietet, ist der
+ Anleitung zur jeweiligen Klasse zu entnehmen. %
+ \fi%
}{}%
Falls Sie also \autoref{sec:\ThisCommonFirstLabelBase.dictum} bereits
gelesen und verstanden haben, können Sie nach dem Ende dieses Abschnitts auf
@@ -75,10 +77,15 @@
\autoref{sec:\ThisCommonLabelBase.dictum.next} fortfahren.%
}
-Ein häufiger anzutreffendes Element ist ein Zitat oder eine Redewendung, die
-rechtsbündig unter oder über einer Überschrift gesetzt wird. Dabei werden der
-Spruch selbst und der Quellennachweis in der Regel speziell formatiert.
-
+\IfThisCommonLabelBase{scrextend}{% Umbruchkorrekturvarianten
+ Ein häufiger anzutreffendes Element ist eine Redewendung oder Zitat, das
+ rechtsbündig unter oder über einer Überschrift gesetzt wird. Dabei werden
+ der Spruch selbst und der Quellennachweis in der Regel speziell formatiert.%
+}{%
+ Ein häufiger anzutreffendes Element sind Zitate oder eine Redewendungen, die
+ mit Quellenangabe und eigener Formatierung unter oder über einer Überschrift
+ gesetzt werden.%
+}
\begin{Declaration}
\Macro{dictum}\OParameter{Urheber}\Parameter{Spruch}
@@ -98,20 +105,24 @@ Ein solcher Spruch kann mit Hilfe der Anweisung \Macro{dictum} gesetzt werden.
\autoref{sec:maincls.structure},
\DescPageRef{maincls.cmd.setchapterpreamble}) zu verwenden. Dies ist jedoch
nicht zwingend.\par%
-}%
+}{}%
Der Spruch wird\IfThisCommonLabelBase{scrextend}{ hierzu}{} zusammen mit einem
optional anzugebenden \PName{Urheber} in einer \Macro{parbox}\IndexCmd{parbox}
-(siehe \cite{latex:usrguide}) der Breite \Macro{dictumwidth} gesetzt. Dabei
-ist \Macro{dictumwidth} keine Länge, die mit \Macro{setlength} gesetzt
-wird. Es handelt sich um ein Makro, das mit \Macro{renewcommand} umdefiniert
-werden kann. Vordefiniert ist \PValue{0.3333\Length{textwidth}}, also ein
-Drittel der jeweiligen Textbreite. Die Box selbst wird mit der Anweisung
-\Macro{raggeddictum} ausgerichtet. Voreingestellt ist dabei
+(siehe \cite{latex:usrguide}) der Breite
+\Macro{dictumwidth}\important{\Macro{dictumwidth}} gesetzt. Dabei ist
+\Macro{dictumwidth} keine Länge, die mit \Macro{setlength} gesetzt wird. Es
+handelt sich um ein Makro, das mit \Macro{renewcommand} umdefiniert werden
+kann. Vordefiniert ist \PValue{0.3333\Length{textwidth}}, also ein Drittel der
+jeweiligen Textbreite. Die Box selbst wird mit der Anweisung
+\Macro{raggeddictum}\important{\Macro{raggeddictum}}
+ausgerichtet. Voreingestellt ist dabei
\Macro{raggedleft}\IndexCmd{raggedleft}, also rechtsbündig.
-\Macro{raggeddictum} kann mit Hilfe von \Macro{renewcommand} umdefiniert
-werden.
+\Macro{raggeddictum} kann mit
+\IfThisCommonLabelBase{scrextend}{% Umbruchoptimierung
+}{Hilfe von }\Macro{renewcommand} umdefiniert werden.
-Innerhalb der Box wird der \PName{Spruch} mit \Macro{raggeddictumtext}
+Innerhalb der Box wird der \PName{Spruch} mit
+\Macro{raggeddictumtext}\important{\Macro{raggeddictumtext}}
angeordnet. Voreingestellt ist hier \Macro{raggedright}\IndexCmd{raggedright},
also linksbündig. Eine Umdefinierung ist auch hier mit \Macro{renewcommand}
möglich. %
@@ -166,19 +177,20 @@ gesamte Breite der \Macro{parbox} vom \PName{Spruch} abgetrennt. Diese%
\ChangedAt{v3.10}{\Package{scrextend}}%
}{\InternalCommonFileUsageError}%
} %
-Linie ist in \Macro{dictumrule} definiert. Es handelt sich dabei um ein
-vertikales Objekt, das mit
+Linie ist in \Macro{dictumrule}\important{\Macro{dictumrule}} definiert. Es
+handelt sich dabei um ein vertikales Objekt, das mit
\begin{lstcode}
\newcommand*{\dictumrule}{\vskip-1ex\hrulefill\par}
\end{lstcode}
vordefiniert ist.
-Mit \Macro{raggeddictumauthor} wird die Ausrichtung für die Linie und den
-Urheber vorgenommen. Voreingestellt ist \Macro{raggedleft}. Auch diese
-Anweisung kann mit \Macro{renewcommand} umdefiniert werden. Die Ausgabe
-erfolgt in der Form, die mit \Macro{dictumauthorformat} festgelegt ist. Das
-Makro erwartet schlicht den \PName{Urheber} als Argument. In der
-Voreinstellung ist \Macro{dictumauthorformat} als
+Mit \Macro{raggeddictumauthor}\important{\Macro{raggeddictumauthor}} wird die
+Ausrichtung für die Linie und den Urheber vorgenommen. Voreingestellt ist
+\Macro{raggedleft}. Auch diese Anweisung kann mit \Macro{renewcommand}
+umdefiniert werden. Die Ausgabe erfolgt in der Form, die mit
+\Macro{dictumauthorformat}\important{\Macro{dictumauthorformat}} festgelegt
+ist. Das Makro erwartet schlicht den \PName{Urheber} als Argument. In der
+Voreinstellung ist \Macro{dictumauthorformat} mit
\begin{lstcode}
\newcommand*{\dictumauthorformat}[1]{(#1)}
\end{lstcode}
@@ -188,9 +200,9 @@ definiert. Der \PName{Urheber} wird also in runde Klammern gesetzt. %
Für das Element
\FontElement{dictumauthor}\important{\FontElement{dictumauthor}} kann dabei
eine Abweichung der Schrift von der des Elementes
-\DescRef{\ThisCommonLabelBase.fontelement.dictum}%
+\FontElement{dictum}%
\IndexFontElement{dictum}%
-\important{\DescRef{\ThisCommonLabelBase.fontelement.dictum}} definiert
+\important{\FontElement{dictum}} definiert
werden. Die Voreinstellung entnehmen Sie bitte
\autoref{tab:maincls.dictumfont}. Eine Änderung ist mit Hilfe der Anweisungen
\DescRef{\ThisCommonLabelBase.cmd.setkomafont} und
@@ -227,7 +239,7 @@ werden. Die Voreinstellung entnehmen Sie bitte
}{\csname iffalse\endcsname}
\begin{Example}
- Sie schreiben ein Kapitel über die moderne Ehe. Dabei wollen sie in der
+ Sie schreiben ein Kapitel über die moderne Ehe. Dabei wollen Sie in der
Präambel zur Kapitelüberschrift einen schlauen Spruch setzen. Dieser soll
unter der Überschrift erscheinen. Also schreiben Sie:
\begin{lstcode}
@@ -252,10 +264,12 @@ werden. Die Voreinstellung entnehmen Sie bitte
\end{lstcode}
\end{Example}
+\IfThisCommonLabelBase{maincls}{}{% Umbruchkorrekturtext
An dieser Stelle sei noch auf das Paket~\Package{ragged2e}%
\important{\Package{ragged2e}}\IndexPackage{ragged2e} hingewiesen, mit dem
man Flattersatz mit Trennung erreichen kann (siehe
\cite{package:ragged2e}).%
+}%
\fi
%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-draftmode.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-draftmode.tex
index fd88d76a313..77287f36cff 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-draftmode.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-draftmode.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-draftmode.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-draftmode.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{common-draftmode.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-01-30 13:37:05 +0100 (Tue, 30 Jan 2018) $
KOMA-Script guide (common paragraphs: draft)]
\section{Entwurfsmodus}
@@ -55,25 +55,41 @@
\BeginIndex{}{Entwurf}%
\IfThisCommonFirstRun{}{%
- Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.draft}
- geschrieben wurde. Falls Sie also
- \autoref{sec:\ThisCommonFirstLabelBase.draft} bereits gelesen und
+ \IfThisCommonLabelBase{scrlttr2}{Für
+ \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}}}{Es} gilt sinngemäß, was in
+ \autoref{sec:\ThisCommonFirstLabelBase.draft} geschrieben wurde. Falls Sie
+ also \autoref{sec:\ThisCommonFirstLabelBase.draft} bereits gelesen und
verstanden haben, können Sie nach dem Ende dieses Abschnitts auf
\autopageref{sec:\ThisCommonLabelBase.draft.next} mit
- \autoref{sec:\ThisCommonLabelBase.draft.next} fortfahren.%
+ \autoref{sec:\ThisCommonLabelBase.draft.next}
+ fortfahren.\IfThisCommonLabelBase{scrlttr2}{ Das Paket \Package{scrletter}
+ bietet selbst keinen Entwurfsmodus, sondern verlässt sich diesbezüglich
+ auf die verwendete Klasse.}{}%
}
-Viele Klassen und viele Pakete kennen neben dem normalen Satzmodus auch einen
-Entwurfsmodus. Die Unterschiede zwischen diesen beiden sind so vielfältig wie
-die Klassen und Pakete, die diese Unterscheidung anbieten.
+Viele Klassen und viele Pakete kennen neben dem normalen Satzmodus auch
+einen Entwurfsmodus. Die Unterschiede zwischen diesen beiden sind so
+vielfältig wie die Klassen und Pakete, die diese Unterscheidung anbieten.%
+\IfThisCommonLabelBase{scrextend}{% Umbruchkorrekturtext
+ \ So führt der Entwurfsmodus einiger Pakete auch zu Änderungen der Ausgabe,
+ die sich auf den Umbruch des Dokuments auswirken. Das ist bei
+ \Package{scrextend} jedoch nicht der Fall.%
+}{}
\begin{Declaration}
\OptionVName{draft}{Ein-Aus-Wert}
+ \OptionVName{overfullrule}{Ein-Aus-Wert}
\end{Declaration}%
-Mit dieser Option\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}\and \Class{scrlttr2}} wird zwischen Dokumenten im
-Entwurfsstadium und fertigen Dokumenten\Index{Endfassung} unterschieden. Als
-\PName{Ein-Aus-Wert} kann einer der Standardwerte für einfache Schalter aus
+Mit Option \Option{draft}\IfThisCommonLabelBase{maincls}{%
+ \ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrartcl}\and
+ \Class{scrreprt}}%
+}{%
+ \IfThisCommonLabelBase{scrlttr2}{%
+ \ChangedAt{v3.00}{\Class{scrlttr2}}\OnlyAt{\Class{scrlttr2}}%
+ }{}%
+} wird zwischen Dokumenten im Entwurfsstadium und fertigen
+Dokumenten\Index{Endfassung} unterschieden. Als \PName{Ein-Aus-Wert} kann
+einer der Standardwerte für einfache Schalter aus
\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet
werden. Bei Aktivierung der Option\important{\OptionValue{draft}{true}} werden
im Falle überlanger Zeilen am Zeilenende kleine, schwarze Kästchen
@@ -83,7 +99,25 @@ der Standardeinstellung \OptionValue{draft}{false} keine solchen
Kästchen. Solche Zeilen verschwinden übrigens häufig durch Verwendung des
Pakets
\Package{microtype}\IndexPackage{microtype}\important{\Package{microtype}}
-\cite{package:microtype}.%
+\cite{package:microtype}.
+
+Da\IfThisCommonLabelBase{maincls}{%
+ \ChangedAt{v3.25}{\Class{scrbook}\and \Class{scrartcl}\and
+ \Class{scrreprt}}%
+}{%
+ \IfThisCommonLabelBase{scrlttr2}{%
+ \ChangedAt{v3.25}{\Class{scrlttr2}}%
+ }{%
+ \IfThisCommonLabelBase{scrextend}{%
+ \ChangedAt{v3.25}{\Package{scrextend}}%
+ }{}%
+ }%
+} Option \Option{draft} bei verschiedenen Paketen zu allerlei unerwünschten
+Effekten führen kann, bietet \KOMAScript{} die Möglichkeit, die Markierung für
+überlange Zeilen auch über Option
+\Option{overfullrule}\important{\OptionValue{overfullrule}{true}} zu
+steuern. Auch hier gilt, dass bei aktivierter Option die Markierung angezeigt
+wird.
%
\EndIndexGroup
%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-fontsize.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-fontsize.tex
index cecc7e5fcfa..325e6c4f0e8 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-fontsize.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-fontsize.tex
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{common-fontsize.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2017-12-13 10:05:13 +0100 (Wed, 13 Dec 2017) $
KOMA-Script guide (common paragraphs: fontsize)]
\section{Wahl der Schriftgröße für das Dokument}
@@ -54,33 +54,38 @@
\BeginIndexGroup
\BeginIndex{}{Schrift>Groesse=Größe}
-\IfThisCommonFirstRun{}{%
- Es gilt sinngemäß, was in
- \autoref{sec:\ThisCommonFirstLabelBase.fontOptions} geschrieben
- wurde. Falls Sie also
+\IfThisCommonFirstRun{%
+ Die Grundschrift und deren Größe sind zentrale Elemente der Gestaltung eines
+ Dokuments. Wie in \autoref{cha:typearea} ausgeführt wurde, hängt die
+ Auf"|teilung zwischen Satzspiegel und Rändern wesentlich davon ab. Die
+ Grundschrift ist dabei die Schrift, die für die Masse des Textes eines
+ Dokuments verwendet wird. Alle davon abweichenden Einstellungen, sei es in
+ der Form, der Dicke, der Neigung oder der Größe, stehen in einer Beziehung
+ zur Grundschrift.%
+}{%
+ \IfThisCommonLabelBase{scrlttr2}{Für \Class{scrlttr2}\OnlyAt{scrlttr2}}{Es}
+ gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.fontOptions}
+ geschrieben wurde. \IfThisCommonLabelBase{scrlttr2}{Paket
+ \Package{scrletter} bietet selbst hingegen keine Schriftgrößenauswahl,
+ sondern verlässt sich diesbezüglich vollständig auf die verwendete
+ Klasse.}{} Falls Sie also
\autoref{sec:\ThisCommonFirstLabelBase.fontOptions} bereits gelesen und
verstanden haben, können Sie \IfThisCommonLabelBase{scrlttr2}{beim Beispiel
- }{%
- \IfThisCommonLabelBase{letzten Absatz }{}%
- }%
- am Ende dieses Abschnitts auf
- \autopageref{sec:\ThisCommonLabelBase.fontOptions.end} fortfahren.%
+ am Ende dieses Abschnitts auf
+ \autopageref{sec:\ThisCommonLabelBase.fontOptions.end} fortfahren. Wenn
+ Sie dagegen \Package{scrletter} verwenden, können Sie auch }{}%
+ direkt zu \autoref{sec:\ThisCommonLabelBase.fontOptions.next} auf
+ \autopageref{sec:\ThisCommonLabelBase.fontOptions.next} springen.%
}
-Die Grundschrift und deren Größe sind zentrale Elemente der Gestaltung eines
-Dokuments. Wie in \autoref{cha:typearea} ausgeführt wurde, hängt die
-Auf"|teilung zwischen Satzspiegel und Rändern wesentlich davon ab. Die
-Grundschrift ist dabei die Schrift, die für die Masse des Textes eines
-Dokuments verwendet wird. Alle davon abweichenden Einstellungen, sei es in der
-Form, der Dicke, der Neigung oder der Größe, stehen in einer Beziehung zur
-Grundschrift.
-
-
\begin{Declaration}
\OptionVName{fontsize}{Größe}
\end{Declaration}
-Während von den Standardklassen und den meisten anderen Klassen nur eine sehr
-beschränkte Anzahl an Schriftgrößen unterstützt wird, bietet \KOMAScript{} die
+Während\IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{%
+ \textnote{\KOMAScript{} vs. Standardklassen}} von den Standardklassen und
+den meisten anderen Klassen nur eine sehr beschränkte Anzahl an Schriftgrößen
+unterstützt wird, bietet
+\IfThisCommonLabelBase{scrlttr2}{\Class{scrlttr2}}{\KOMAScript} die
Möglichkeit, jede beliebige \PName{Größe} für die Grundschrift
anzugeben. Dabei kann als Einheit für die \PName{Größe} auch jede bekannte
\TeX-Einheit verwendet werden. Wird die \PName{Größe} ohne Einheit angegeben,
@@ -90,16 +95,23 @@ so wird \PValue{pt} als Einheit angenommen. \iffree{}{Das genaue Verfahren,
\DescPageRef{maincls-experts.option.fontsize} dokumentiert.}
Wird die Option innerhalb des Dokuments gesetzt, so werden ab diesem Punkt die
-Grundschriftgröße und alle davon abhängigen Größen geändert. Das kann
-beispielsweise dann nützlich sein, wenn %
+Grundschriftgröße und die davon abhängigen Schriftgrößen der Befehle
+\Macro{tiny}, \Macro{scriptsize}, \Macro{footnotesize}, \Macro{small},
+\Macro{normalsize}, \Macro{large}, \Macro{Large}, \Macro{LARGE}, \Macro{huge}
+und \Macro{Huge} geändert. Das kann beispielsweise dann nützlich sein, wenn %
\IfThisCommonLabelBase{scrlttr2}{ein weiterer Brief }{der Anhang }%
-insgesamt in einer kleineren Schriftgröße gesetzt werden soll. Es wird darauf
-hingewiesen, dass bei Verwendung nach dem Laden der Klasse die Auf"|teilung
-zwischen Satzspiegel und Rändern nicht automatisch neu berechnet wird (siehe
+insgesamt in einer kleineren Schriftgröße gesetzt werden soll.
+
+Es wird darauf\textnote{Achtung!} hingewiesen, dass bei Verwendung nach
+\IfThisCommonLabelBase{scrextend}{einem eventuellen Laden von
+ \hyperref[cha:typearea]{\Package{typearea}}\IndexPackage{typearea}%
+ \important{\hyperref[cha:typearea]{\Package{typearea}}}}{dem Laden der
+ Klasse} die Auf"|teilung zwischen Satzspiegel und Rändern nicht automatisch
+neu berechnet wird (siehe
\DescRef{typearea.cmd.recalctypearea}\IndexCmd{recalctypearea},
\autoref{sec:typearea.typearea},
-\DescPageRef{typearea.cmd.recalctypearea}). Wird diese Neuberechnung
-jedoch vorgenommen, so erfolgt sie auf Basis der jeweils gültigen
+\DescPageRef{typearea.cmd.recalctypearea}). Wird diese Neuberechnung jedoch
+vorgenommen, so erfolgt sie auf Basis der jeweils gültigen
Grundschriftgröße. Die Auswirkungen des Wechsels der Grundschriftgröße auf
zusätzlich geladene Pakete oder die verwendete Klasse sind von diesen Paketen
und der Klasse abhängig. %
@@ -111,7 +123,7 @@ und der Klasse abhängig. %
}{%
\IfThisCommonLabelBase{scrlttr2}{%
Dabei sind Fehler möglich, die nicht als Fehler von \KOMAScript{}
- betrachtet werden und auch die Klasse \Class{scrlttr2} selbst passt nicht
+ betrachtet werden, und auch die Klasse \Class{scrlttr2} selbst passt nicht
alle Längen an eine nach dem Laden der Klasse vorgenommene Änderung der
Grundschriftgröße an.%
}{%
@@ -122,13 +134,13 @@ und der Klasse abhängig. %
Diese\textnote{Achtung!} Option sollte keinesfalls als Ersatz für
\Macro{fontsize} (siehe \cite{latex:fntguide}) missverstanden werden. Sie
-sollte auch nicht an Stelle einer der von der Grundschrift abhängigen
-Schriftgrößenanweisungen, \Macro{tiny} bis \Macro{Huge}, verwendet werden!%
-\phantomsection\label{sec:\ThisCommonLabelBase.fontOptions.end}%
+sollte auch nicht anstelle einer der von der Grundschrift abhängigen
+Schriftgrößenanweisungen, \Macro{tiny} bis \Macro{Huge}, verwendet werden!
\IfThisCommonLabelBase{scrlttr2}{%
- \ Bei \Class{scrlttr2} ist \OptionValue{fontsize}{12pt} voreingestellt.
+ Bei \Class{scrlttr2} ist \OptionValue{fontsize}{12pt} voreingestellt.
\begin{Example}
+ \phantomsection\label{sec:\ThisCommonLabelBase.fontOptions.end}%
Angenommen, bei dem Verein aus dem Beispielbrief handelt es sich um die
\emph{»Freunde ungesunder Schriftgrößen«}, weshalb er in 14\Unit{pt} statt
in 12\Unit{pt} gesetzt werden soll. Dies kann durch eine kleine Änderung
@@ -168,11 +180,15 @@ Schriftgrößenanweisungen, \Macro{tiny} bis \Macro{Huge}, verwendet werden!%
\end{Example}%
}{%
\IfThisCommonLabelBase{maincls}{%
+ \par
+ \phantomsection\label{sec:\ThisCommonLabelBase.fontOptions.end}%
Voreingestellt ist bei \Class{scrbook}, \Class{scrreprt} und
\Class{scrartcl} \OptionValue{fontsize}{11pt}.\textnote{\KOMAScript{}
vs. Standardklassen} Demgegenüber ist übrigens bei den Standardklassen
\Option{10pt} voreingestellt. Dies ist bei einem Wechsel von den
- Standardklassen zu den \KOMAScript-Klassen gegebenenfalls zu beachten.%
+ Standardklassen zu den \KOMAScript-Klassen\iffree{}{ oder bei Verwendung
+ von Option \DescRef{maincls-experts.option.emulatestandardclasses}%
+ \IndexOption{emulatestandardclasses}} gegebenenfalls zu beachten.%
}{}%
}%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-footnotes.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-footnotes.tex
index 47d30e59220..0b0335d39c7 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-footnotes.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-footnotes.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-footnotes.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-footnotes.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{common-footnotes.tex}%
- [$Date: 2017-04-13 09:48:05 +0200 (Thu, 13 Apr 2017) $
+ [$Date: 2018-01-29 14:12:59 +0100 (Mon, 29 Jan 2018) $
KOMA-Script guide (common paragraphs)]
\section{Fußnoten}
@@ -55,29 +55,48 @@
\BeginIndex{}{Fussnoten=Fußnoten}%
\IfThisCommonFirstRun{}{%
- Es gilt sinngemäß, was in
- \autoref{sec:\ThisCommonFirstLabelBase.footnotes} geschrieben wurde. Falls
- Sie also \autoref{sec:\ThisCommonFirstLabelBase.footnotes} bereits gelesen
- und verstanden haben, können Sie auf
+ Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.footnotes}
+ geschrieben wurde. Falls Sie also
+ \autoref{sec:\ThisCommonFirstLabelBase.footnotes} bereits gelesen und
+ verstanden haben, können Sie auf
\autopageref{sec:\ThisCommonLabelBase.footnotes.next} mit
\autopageref{sec:\ThisCommonLabelBase.footnotes.next} fortfahren.%
+ \IfThisCommonLabelBase{scrlttr2}{ %
+ Wird keine \KOMAScript-Klasse verwendet, stützt sich
+ \Package{scrletter}\OnlyAt{\Package{scrletter}} auf das Paket
+ \hyperref[cha:scrextend]{\Package{scrextend}}\IndexPackage{scrextend}%
+ \important{\hyperref[cha:scrextend]{\Package{scrextend}}}. Siehe daher bei
+ Verwendung von \Package{scrletter} ebenfalls
+ \autoref{sec:scrextend.footnotes} ab
+ \autopageref{sec:scrextend.footnotes}.%
+ \iffalse% Umbruchkorrekturtext
+ \ Beachten Sie insbesondere, dass in
+ diesem Fall einige \KOMAScript-typische Erweiterungen in der
+ Voreinstellung\textnote{Voreinstellung} nicht aktiv sind. Stattdessen
+ gelten in der Voreinstellung die Fußnotenmöglichkeiten der verwendeten
+ Klasse oder des \LaTeX-Kerns.%
+ \fi%
+ }{}%
}
\IfThisCommonLabelBase{maincls}{%
- Im Unterschied zu den Standardklassen bietet \KOMAScript{} die Möglichkeit,
- die Form von Fußnoten zu konfigurieren.%
+ Im\textnote{\KOMAScript{} vs. Standardklassen} Unterschied zu den
+ Standardklassen bietet \KOMAScript{} die Möglichkeit, die Form von Fußnoten
+ in vielfältiger Weise zu konfigurieren.%
}{%
\IfThisCommonLabelBase{scrlttr2}{%
Die Anweisungen zum Setzen von Fußnoten sind in jeder \LaTeX-Einführung,
- beispielsweise \cite{l2kurz}, zu finden. \KOMAScript{} bietet darüber
- hinaus aber auch noch die Möglichkeit, die Form der Fußnoten zu verändern.
- \iftrue % Umbruchoptimierung
+ beispielsweise \cite{l2kurz}, zu
+ finden. \KOMAScript{}\textnote{\KOMAScript{} vs. Standardklassen} bietet
+ darüber hinaus aber auch noch die Möglichkeit, die Form der Fußnoten zu
+ verändern. %
+ \iffalse % Umbruchoptimierung
Ob Fußnoten bei Briefen überhaupt zulässig sind, hängt sehr stark von
der Art des Briefs und dessen Layout ab. So sind beispielsweise optische
Kollisionen mit dem Fuß des Briefbogens oder Verwechslungen mit der
- Auflistung von Verteilern oder ähnlichen typischen Elementen von Briefen
- zu vermeiden. Dies liegt in der Verantwortung des Anwenders.%
+ Auf"|listung von Verteilern oder ähnlichen typischen Elementen von
+ Briefen zu vermeiden. Dies liegt in der Verantwortung des Anwenders.%
Da Fußnoten in Briefen eher selten verwendet werden, wurde auf Beispiele
in diesem Abschnitt verzichtet. Sollten Sie Beispiele benötigen, können
@@ -103,6 +122,7 @@
\begin{Declaration}
\OptionVName{footnotes}{Einstellung}
+ \Macro{multfootsep}
\end{Declaration}
\IfThisCommonLabelBase{scrextend}{Bei vielen Klassen werden Fußnoten }{%
Fußnoten %
@@ -116,20 +136,29 @@
} %
werden %
}%
-im Text in der Voreinstellung mit kleinen, hochgestellten Ziffern
-markiert. Werden zu einer Textstelle mehrere Fußnoten hintereinander gesetzt,
-so entsteht der Eindruck, dass es sich nicht um zwei einzelne Fußnoten,
-sondern um eine einzige Fußnote mit hoher Nummer handelt.
+im Text in der Voreinstellung\textnote{Voreinstellung} mit kleinen,
+hochgestellten Ziffern markiert. Werden in der
+Voreinstellung\important{\OptionValue{footnotes}{nomultiple}}
+\OptionValue{footnotes}{nomultiple} zu einer Textstelle mehrere Fußnoten
+hintereinander gesetzt, so entsteht der Eindruck, dass es sich nicht um zwei
+einzelne Fußnoten, sondern um eine einzige Fußnote mit hoher Nummer handele.
+
Mit\important{\OptionValue{footnotes}{multiple}}
\OptionValue{footnotes}{multiple}\IndexOption{footnotes=~multiple} werden
-Fußnoten, die unmittelbar aufeinander folgen, stattdessen mit Trennzeichen
-aneinander gereiht. Das in \DescRef{\ThisCommonLabelBase.cmd.multfootsep}%
-\IndexCmd{multfootsep}\important{\DescRef{\ThisCommonLabelBase.cmd.multfootsep}}
-definierte Trennzeichen ist mit einem Komma vorbelegt. Der gesamte Mechanismus
-ist kompatibel zu
+Fußnoten, die unmittelbar aufeinander folgen, stattdessen mit einem
+Trennzeichen aneinander gereiht. Das in
+\Macro{multfootsep}\important{\Macro{multfootsep}} definierte Trennzeichen ist
+als
+\begin{lstcode}
+ \newcommand*{\multfootsep}{,}
+\end{lstcode}
+definiert. Es ist also mit einem Komma vorbelegt. Dieses kann umdefiniert
+werden.
+
+Der gesamte Mechanismus ist kompatibel zu
\Package{footmisc}\IndexPackage{footmisc}\important{\Package{footmisc}},
-Version~5.3d (siehe \cite{package:footmisc}) implementiert. Er wirkt sich
-sowohl auf Fußnotenmarkierungen aus, die mit
+Version~5.3d bis 5.5b (siehe \cite{package:footmisc}) implementiert. Er wirkt
+sich sowohl auf Fußnotenmarkierungen aus, die mit
\DescRef{\ThisCommonLabelBase.cmd.footnote}\IndexCmd{footnote} gesetzt wurden,
als auch auf solche, die direkt mit
\DescRef{\ThisCommonLabelBase.cmd.footnotemark}\IndexCmd{footnotemark}
@@ -156,11 +185,11 @@ Eine Zusammenfassung möglicher Werte für die \PName{Einstellung} von
Unmittelbar aufeinander folgende Fußnotenmarkierungen werden durch
\DescRef{\ThisCommonLabelBase.cmd.multfootsep}\IndexCmd{multfootsep}
voneinander getrennt ausgegeben.%
- \IndexOption{footnotes~=\PValue{multiple}}}%
+ \IndexOption{footnotes~=\textKValue{multiple}}}%
\pventry{nomultiple}{%
Unmittelbar aufeinander folgende Fußnotenmarkierungen werden auch
unmittelbar aufeinander folgend ausgegeben.%
- \IndexOption{footnotes~=\PValue{nomultiple}}}%
+ \IndexOption{footnotes~=\textKValue{nomultiple}}}%
\end{desctabular}
\end{table}%
}{,
@@ -175,7 +204,6 @@ Eine Zusammenfassung möglicher Werte für die \PName{Einstellung} von
\Macro{footnotemark}\OParameter{Nummer}
\Macro{footnotetext}\OParameter{Nummer}\Parameter{Text}
\Macro{multiplefootnoteseparator}
- \Macro{multfootsep}
\end{Declaration}%
Fußnoten werden bei {\KOMAScript} genau wie bei den Standardklassen mit der
Anweisung \Macro{footnote} oder den paarweise zu verwendenden Anweisungen
@@ -184,7 +212,7 @@ Standardklassen ist es möglich, dass innerhalb einer Fußnote ein
Seiten"-umbruch erfolgt. Dies geschieht in der Regel dann, wenn die zugehörige
Fußnotenmarkierung so weit unten auf der Seite gesetzt wird, dass keine andere
Wahl bleibt, als die Fußnote auf die nächste Seite zu umbrechen. Im
-Unterschied%
+Unterschied\textnote{\KOMAScript{} vs. Standardklassen}%
\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
@@ -196,7 +224,7 @@ Unterschied%
zu den Standardklassen bietet \KOMAScript{} aber zusätzlich die Möglichkeit,
Fußnoten, die unmittelbar aufeinander folgen, automatisch zu erkennen und
durch ein Trennzeichen auseinander zu
-rücken. Siehe\important{\DescRef{\ThisCommonLabelBase.option.footnote}} hierzu
+rücken. Siehe\important{\DescRef{\ThisCommonLabelBase.option.footnotes}} hierzu
die zuvor dokumentierte Option
\DescRef{\ThisCommonLabelBase.option.footnotes}.
@@ -204,19 +232,17 @@ Will man dieses Trennzeichen stattdessen von Hand setzen, so erhält man es
durch Aufruf von \Macro{multiplefootnoteseparator}. Diese Anweisung sollten
Anwender jedoch nicht umdefinieren, da sie neben dem Trennzeichen auch die
Formatierung des Trennzeichen, beispielsweise die Wahl der Schriftgröße und
-das Hochstellen, enthält. Das Trennzeichen selbst ist in der Anweisung
-\Macro{multfootsep} gespeichert. In der Voreinstellung ist dieses als
-\begin{lstcode}
- \newcommand*{\multfootsep}{,}
-\end{lstcode}
-definiert. Dieses kann umdefiniert werden.
+das Hochstellen, enthält. Das Trennzeichen selbst ist in der zuvor erklärten
+Anweisung \DescRef{\ThisCommonLabelBase.cmd.multfootsep}%
+\important{\DescRef{\ThisCommonLabelBase.cmd.multfootsep}}%
+\IndexCmd{multfootsep} gespeichert.
-\IfThisCommonLabelBase{scrlttr2}{%
+\IfThisCommonFirstRun{\iftrue}{%
Beispiele und ergänzende Hinweise sind
\autoref{sec:\ThisCommonFirstLabelBase.footnotes} ab
\PageRefxmpl{\ThisCommonFirstLabelBase.cmd.footnote} zu entnehmen.%
- \iffalse%
-}{\csname iftrue\endcsname}%
+ \csname iffalse\endcsname
+}%
\begin{Example}
\phantomsection\xmpllabel{cmd.footnote}%
Angenommen, Sie wollen zu einem Wort zwei Fußnoten setzen. Im ersten
@@ -242,14 +268,14 @@ definiert. Dieses kann umdefiniert werden.
Erkennung aus irgendwelchen Gründen versagt oder nicht verwendet werden
kann.
- Nehmen wir nun an, dass Sie außerdem wollen, dass die Fußnotennummern
- nicht nur durch ein Komma, sondern durch ein Komma gefolgt von einem
+ Nehmen wir nun an, Sie wollen außerdem, dass die Fußnotennummern
+ nicht nur durch ein Komma, sondern durch ein Komma, gefolgt von einem
Leerzeichen getrennt werden sollen. In diesem Fall schreiben Sie
\begin{lstcode}
\renewcommand*{\multfootsep}{,\nobreakspace}
\end{lstcode}
in Ihre Dokumentpräambel. \Macro{nobreakspace}\IndexCmd{nobreakspace} wurde
- hier an Stelle eines normalen Leerzeichens gewählt, damit innerhalb der
+ hier anstelle eines normalen Leerzeichens gewählt, damit innerhalb der
Reihung der Fußnotenzeichen kein Absatz- oder Seitenumbruch erfolgen kann.
\end{Example}%
\fi%
@@ -279,7 +305,7 @@ Möglichkeit, den
Verweise auf Fußnoten zu verwenden. Man setzt dabei in der entsprechenden
Fußnote eine \Macro{label}-Anweisung und kann dann mit \Macro{footref} alle
weiteren Fußnotenmarken für diese Fußnote im Text setzen.
-\IfThisCommonLabelBase{scrlttr2}{\iffalse}{\csname iftrue\endcsname}%
+\IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}%
% Umbruchkorrektur über diverse Varianten!!!
\begin{Example}
\phantomsection
@@ -337,12 +363,18 @@ Da die Fußnotenmarken mit Hilfe des \Macro{label}-Mechanismus gesetzt werden,
werden nach Änderungen, die sich auf die Fußnotennummerierung auswirken,
gegebenenfalls zwei \LaTeX-Durchläufe benötigt, bis die mit \Macro{footref}
gesetzten Marken korrekt sind.%
-\IfThisCommonLabelBase{scrlttr2}{\par%
+\IfThisCommonLabelBaseOneOf{scrlttr2,scrextend}{\par%
Ein Beispiel zur Verwendung von \Macro{footref} finden Sie in
\autoref{sec:\ThisCommonFirstLabelBase.footnotes} auf
\PageRefxmpl{\ThisCommonFirstLabelBase.cmd.footref}.%
-}{}%
-%
+}{}
+\IfThisCommonLabelBase{scrlttr2}{}{%
+ \par
+ Es\textnote{Achtung!} sei darauf hingewiesen, dass die Anweisung genau wie
+ \Macro{ref}\IndexCmd{ref} oder \Macro{pageref}\IndexCmd{pageref} zerbrechlich
+ ist und deshalb in beweglichen Argumenten wie Überschriften
+ \Macro{protect}\IndexCmd{protect} davor gestellt werden sollte.%
+}%
\EndIndexGroup
\begin{Declaration}
@@ -352,7 +384,9 @@ gesetzten Marken korrekt sind.%
\Macro{deffootnotemark}\Parameter{Markendefinition}
\Macro{thefootnotemark}
\end{Declaration}%
-Die \KOMAScript-Klassen setzen Fußnoten etwas anders als die Standardklassen.
+\IfThisCommonLabelBase{maincls}{Die \KOMAScript-Klassen setzen}{\KOMAScript{}
+ setzt}\textnote{\KOMAScript{} vs. Standardklassen}
+Fußnoten etwas anders als die Standardklassen.
Die Fußnotenmarkierung im Text, also die Referenzierung der Fußnote, erfolgt
wie bei den Standardklassen durch kleine hochgestellte Zahlen. Genauso werden
die Markierungen auch in der Fußnote selbst wiedergegeben. Sie werden dabei
@@ -394,7 +428,7 @@ Fußnotenmarke ohne jegliche Formatierung.%
sollte daher noch zu keinerlei Änderungen bei der Formatierung der Fußnoten
oder der Fußnotenmarken führen. Zur Übernahme der Voreinstellungen der
\KOMAScript-Klassen muss man vielmehr obige Einstellung selbst
- vornehmen. Dazu kann obige Code-Zeile beispielsweise unmittelbar nach dem
+ vornehmen. Dazu können obige Code-Zeilen beispielsweise unmittelbar nach dem
Laden von \Package{scrextend} eingefügt werden.%
}{}%
@@ -464,7 +498,7 @@ Auf%
}{} die Fußnote einschließlich der Markierung findet außerdem die für das
Element \FontElement{footnote}\important{\FontElement{footnote}} eingestellte
Schriftart Anwendung. Die % Umbruchkorrekturvarianten
-\IfThisCommonLabelBase{maincls}{davon abweichende }{}%
+%\IfThisCommonLabelBase{maincls}{davon abweichende }{}%
Schriftart der Markierung kann %
\IfThisCommonLabelBase{maincls}{}{jedoch }%
mit Hilfe der Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und
@@ -510,7 +544,7 @@ Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und
\IfThisCommonLabelBase{scrextend}{, sobald die Anweisung
\DescRef{\ThisCommonLabelBase.cmd.deffootnotemark} verwendet wird}{}.
-\IfThisCommonLabelBase{scrlttr2}{\iffalse}{\csname iftrue\endcsname}%
+\IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}%
\begin{Example}
\phantomsection
\xmpllabel{cmd.deffootnote}%
@@ -552,7 +586,7 @@ Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und
Fußnotenformatierungen.%
}%
\fi%
-\IfThisCommonLabelBase{scrlttr2}{%
+\IfThisCommonFirstRun{}{%
Beispiele finden Sie in
\autoref{sec:\ThisCommonFirstLabelBase.footnotes},
\PageRefxmpl{\ThisCommonFirstLabelBase.cmd.deffootnote}.%
@@ -561,6 +595,7 @@ Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und
\EndIndexGroup
\EndIndexGroup
+\IfThisCommonLabelBase{scrextend}{\iffalse}{\csname iftrue\endcsname}
\begin{Declaration}
\Macro{setfootnoterule}\OParameter{Höhe}\Parameter{Länge}%
\end{Declaration}%
@@ -614,6 +649,7 @@ Farbe. Um die Farbe ändern zu können, muss außerdem ein Farbpaket wie
sein.%
\EndIndexGroup
\EndIndexGroup
+\fi
\begin{Declaration}
\Macro{raggedfootnote}
@@ -632,17 +668,24 @@ In%
}%
} %
der Voreinstellung werden die Fußnoten bei \KOMAScript{} genau wie bei den
-Standardklassen im Blocksatz gesetzt. Es ist aber auch möglich die
-Formatierung abweichend vom restlichen Dokument zu ändern. Dazu ist
-\Macro{raggedfootnote} umzudefinieren. Gültige Definitionen wären
+Standardklassen im Blocksatz gesetzt. Es\textnote{\KOMAScript{}
+ vs. Standardklassen} ist aber auch möglich die Formatierung abweichend vom
+restlichen Dokument zu ändern. Dazu ist \Macro{raggedfootnote}
+umzudefinieren. Gültige Definitionen wären
\Macro{raggedright}\IndexCmd{raggedright},
\Macro{raggedleft}\IndexCmd{raggedleft},
\Macro{centering}\IndexCmd{centering}, \Macro{relax}\IndexCmd{relax} oder
entsprechend der Voreinstellung eine leere Definition. Auch die
Ausrichtungsbefehle des Pakets \Package{ragged2e}\IndexPackage{ragged2e} sind
zulässig (siehe \cite{package:ragged2e}).
-
+\IfThisCommonLabelBase{scrextend}{%
+ Ein passendes Beispiel ist in
+ \autoref{sec:\ThisCommonFirstLabelBase.footnotes},
+ \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.raggedfootnote} zu finden.%
+ \iffalse
+}{\csname iftrue\endcsname}%
\begin{Example}
+ \phantomsection\xmpllabel{cmd.raggedfootnote}%
Angenommen Sie verwenden Fußnoten ausschließlich, um Hinweise auf sehr lange
Links anzugeben, deren Umbruch im Blocksatz zu schlechten Ergebnissen
führen. Dann könnten Sie in der Dokumentpräambel mit
@@ -651,6 +694,7 @@ zulässig (siehe \cite{package:ragged2e}).
\end{lstcode}
für die Fußnoten einfach auf linksbündigen Flattersatz umschalten.
\end{Example}%
+\fi
\EndIndexGroup
%
\EndIndexGroup
@@ -666,3 +710,4 @@ zulässig (siehe \cite{package:ragged2e}).
% LocalWords: Fußnotennummern Fußnotenmarkierung Satzspiegels
% LocalWords: Standardklassen Fußnotenformatierungen Dokumentpräambel
+% LocalWords: Fußnotenmöglichkeiten
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-headfootheight.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-headfootheight.tex
index 58a01bb033a..75c18a8250f 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-headfootheight.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-headfootheight.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-headfootheight.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-headfootheight.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ============================================================================
\KOMAProvidesFile{common-headfootheight.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-01-16 11:41:41 +0100 (Tue, 16 Jan 2018) $
KOMA-Script guide (common paragraph: Head and Foot Height)]
@@ -77,12 +77,12 @@
Höhe zur Bestimmung des Anfangs des Textbereichs benötigt wird.%
\end{Explain}%
}{%
- Der Kopf und der Fuß einer Seite sind zentrale Elemente nicht nur des
- Seitenstils. Auch eine Ebene kann bei der Definition über entsprechende
- Optionen genau darauf beschränkt werden (siehe
- \autoref{tab:scrlayer.layerkeys} ab
- \autopageref{tab:scrlayer.layerkeys}). Deshalb muss die Höhe beider Elemente
- bekannt sein.%
+ \iffree{Der }{}Kopf und \iffree{der }{}Fuß einer Seite sind zentrale
+ Elemente nicht nur des Seitenstils. \iffree{Auch eine Ebene kann bei der
+ Definition über entsprechende Optionen genau darauf beschränkt werden
+ (siehe \autoref{tab:scrlayer.layerkeys} ab
+ \autopageref{tab:scrlayer.layerkeys}). }{}Deshalb muss die Höhe beider
+ Elemente bekannt sein.%
}
\IfThisCommonFirstRun{}{%
@@ -98,6 +98,9 @@
\begin{Declaration}
\Length{footheight}
\Length{headheight}
+ \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \OptionVName{autoenlargeheadfoot}{Ein-Aus-Wert}%
+ }{}%
\end{Declaration}
Das Paket \Package{scrlayer} führt als neue Länge \Length{footheight} analog
zur Höhe \Length{headheight}\IfThisCommonLabelBase{scrlayer-scrpage}{}{ des
@@ -105,9 +108,10 @@ zur Höhe \Length{headheight}\IfThisCommonLabelBase{scrlayer-scrpage}{}{ des
\Package{scrlayer\IfThisCommonLabelBase{scrlayer-scrpage}{-scrpage}{}}
\Length{footskip} so, dass es den Abstand der letzten Grundlinie des
Textbereichs von der ersten Standard-Grundlinie des Fußes darstellt. Das Paket
-\Package{typearea}\IndexPackage{typearea} betrachtet dies in gleicher Weise,
-so dass die dortigen Optionen zum Setzen der Höhe des Fußes (siehe die
-Optionen \DescRef{typearea.option.footheight} und
+\hyperref[cha:typearea]{\Package{typearea}}\IndexPackage{typearea}%
+\important{\hyperref[cha:typearea]{\Package{typearea}}} betrachtet dies in
+gleicher Weise, so dass die dortigen Optionen zum Setzen der Höhe des Fußes
+(siehe die Optionen \DescRef{typearea.option.footheight} und
\DescRef{typearea.option.footlines} in \autoref{sec:typearea.typearea},
\DescPageRef{typearea.option.footheight}) und zur Berücksichtigung des Fußes
bei der Berechnung des Satzspiegels (siehe Option
@@ -116,18 +120,43 @@ bei der Berechnung des Satzspiegels (siehe Option
\Package{scrlayer} verwendet werden können und auch das gewünschte Ergebnis
liefern.
-Wird das Paket \Package{typearea} nicht verwendet, so sollte man
-gegebenenfalls die Höhe von Kopf und Fuß über entsprechende Werte für die
-Längen einstellen. Zumindest für den Kopf bietet aber beispielsweise auch das
-Paket \Package{geometry} entsprechende Einstellmöglichkeiten. Wurde der Kopf
-oder der Fuß für den tatsächlich verwendeten Inhalt zu klein gewählt, so
-versucht\IfThisCommonLabelBase{scrlayer-scrpage}{}{ beispielsweise}
-\Package{scrlayer-scrpage} die Längen selbst entsprechend
-anzupassen. Gleichzeitig wird eine entsprechende Warnung ausgegeben, die auch
-Ratschläge für passende Einstellungen enthält. Die automatischen Änderungen
-haben dann ab dem Zeitpunkt, an dem ihre Notwendigkeit erkannt wurde,
-Gültigkeit und werden nicht automatisch aufgehoben, wenn beispielsweise der
-Inhalt von Kopf oder Fuß wieder kleiner wird.%
+Wird das Paket \hyperref[cha:typearea]{\Package{typearea}}%
+\important{\hyperref[cha:typearea]{\Package{typearea}}} nicht verwendet, so
+sollte man gegebenenfalls die Höhe von Kopf und Fuß über entsprechende Werte
+für die Längen einstellen. Zumindest für den Kopf bietet aber beispielsweise
+auch das Paket \Package{geometry} Einstellmöglichkeiten.%
+\IfThisCommonLabelBase{scrlayer-scrpage}{\par%
+ Wurde der Kopf oder der Fuß für den tatsächlich verwendeten Inhalt zu klein
+ gewählt, so versucht \Package{scrlayer-scrpage} in der
+ Voreinstellung\textnote{Voreinstellung} die Längen selbst entsprechend
+ anzupassen. Gleichzeitig wird eine entsprechende Warnung ausgegeben, die
+ auch Ratschläge für passende Einstellungen enthält. Die automatischen
+ Änderungen haben dann ab dem Zeitpunkt, an dem ihre Notwendigkeit erkannt
+ wurde, Gültigkeit und werden nicht automatisch aufgehoben, wenn
+ beispielsweise der Inhalt von Kopf oder Fuß wieder kleiner wird. Über
+ Option\ChangedAt{v3.25}{\Package{scrlayer-scrpage}}
+ \Option{autoenlargeheadfoot} kann dieses Verhalten jedoch geändert
+ werden. Die Option versteht die Werte für einfache Schalter aus
+ \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. In der
+ Voreinstellung ist die Option aktiviert. Wird sie deaktiviert, so werden
+ Kopf und Fuß nicht mehr automatisch vergrößert, sondern nur noch eine
+ Warnung mit Hinweisen für passende Einstellungen ausgegeben.%
+}{%
+ \IfThisCommonLabelBase{scrlayer}{\par%
+ Wurde der Kopf oder Fuß für den tatsächlich verwendeten Inhalt zu klein
+ gewählt, so toleriert \Package{scrlayer} dies in der Regel ohne
+ Fehlermeldung oder Warnung. Der Kopf dehnt sich dann entsprechend seiner
+ Höhe in der Regel weiter nach oben, der Fuß entsprechend weiter nach unten
+ aus. Informationen darüber erhält man jedoch nicht automatisch. Pakete wie
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}%
+ \IndexPackage{scrlayer-scrpage}, die auf \Package{scrlayer} aufbauen,
+ enthalten dagegen gegebenenfalls eigene Tests, die auch zu eigenen
+ Aktionen führen können (siehe \DescRef{scrlayer-scrpage.length.headheight}
+ und \DescRef{scrlayer-scrpage.length.footheight} auf
+ \DescPageRef{scrlayer-scrpage.length.headheight}).%
+ }{}%
+}%
\EndIndexGroup
%
\EndIndexGroup
@@ -137,7 +166,7 @@ Inhalt von Kopf oder Fuß wieder kleiner wird.%
%%% mode: flyspell
%%% coding: iso-latin-1
%%% ispell-local-dictionary: "de_DE"
-%%% TeX-master: "scrlayer-de.tex"
+%%% TeX-master: "scrguide.tex"
%%% TeX-PDF-mode: t
%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-interleafpage.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-interleafpage.tex
index b426812b857..4e4803e9366 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-interleafpage.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-interleafpage.tex
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{common-interleafpage.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2017-12-07 11:43:47 +0100 (Thu, 07 Dec 2017) $
KOMA-Script guide (common paragraphs)]
\section{Vakatseiten}
@@ -82,8 +82,8 @@ Vakatseiten normalerweise nur im doppelseitigen Satz existieren.
\IfThisCommonLabelBase{scrlttr2}{%
Vakatseiten sind bei Briefen eher unüblich. Das liegt nicht zuletzt daran,
dass wahrhaft doppelseitige Briefe recht selten sind, da Briefe
- normalerweise nicht gebunden werden. Trotzdem unterstützt auch
- \Class{scrlttr2} für den Fall von doppelseitigen Briefen Einstellungen für
+ normalerweise nicht gebunden werden. Trotzdem unterstützt \KOMAScript{} auch
+ für den Fall von doppelseitigen Briefen Einstellungen für
Vakatseiten. Da die hier vorgestellten Anweisungen aber in Briefen kaum
Verwendung finden, finden Sie hier keine Beispiele. Bei Bedarf orientieren
Sie sich bitte an den Beispielen in \autoref{sec:maincls.emptypage} ab
@@ -123,36 +123,52 @@ wird, der beim Einfügen gerade aktuell ist. Ab Version~3.00%
\ChangedAt{v3.00}{\Class{scrlttr2}}%
}{}%
} %
-werden in der Voreinstellung entsprechend der typografischen Gepflogenheiten
-Vakatseiten mit dem Seitenstil \PageStyle{empty} erzeugt, wenn man nicht
-Kompatibilität zu früheren \KOMAScript-Versionen eingestellt hat (siehe Option
-\DescRef{\ThisCommonLabelBase.option.version},
+werden in der Voreinstellung\textnote{Voreinstellung} entsprechend der
+typografischen Gepflogenheiten Vakatseiten mit dem Seitenstil
+\IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{%
+ \DescRef{\ThisCommonLabelBase.pagestyle.empty}}\IndexPagestyle{empty}
+erzeugt, wenn man nicht Kompatibilität zu früheren \KOMAScript-Versionen
+eingestellt hat (siehe Option \DescRef{\ThisCommonLabelBase.option.version}%
+\important{\OptionValueRef{\LabelBase}{version}{2.98c}},
\autoref{sec:\ThisCommonLabelBase.compatibilityOptions},
\DescPageRef{\ThisCommonLabelBase.option.version}).
\IfThisCommonLabelBase{maincls}{\iftrue}{\csname iffalse\endcsname}
\begin{Example}
\phantomsection\xmpllabel{option.cleardoublepage}%
Angenommen, Sie wollen, dass die Vakatseiten bis auf die Paginierung leer
- sind\iffree{, also mit Seitenstil \PageStyle{plain} erzeugt
- werden}{}. Dies erreichen Sie \iffree{beispielsweise }{}mit:
+ sind\iffree{, also mit Seitenstil \IfThisCommonLabelBase{scrextend}{%
+ \DescRef{maincls.pagestyle.plain}}{\DescRef{\LabelBase.pagestyle.plain}}
+ erzeugt werden}{}. Dies erreichen Sie \iffree{beispielsweise }{}mit:
\begin{lstcode}
\KOMAoptions{cleardoublepage=plain}
\end{lstcode}
- Näheres zum Seitenstil \PageStyle{plain} ist in
- \autoref{sec:maincls.pagestyle},
- \DescPageRef{maincls.pagestyle.plain} zu finden.
+ Näheres zum Seitenstil \IfThisCommonLabelBase{scrextend}{%
+ \DescRef{maincls.pagestyle.plain}}{\DescRef{\LabelBase.pagestyle.plain}}
+ ist in
+ \IfThisCommonLabelBase{scrextend}{%
+ \autoref{sec:maincls.pagestyle}}{%
+ \autoref{sec:\LabelBase.pagestyle}},
+ \IfThisCommonLabelBase{scrextend}{%
+ \DescPageRef{maincls.pagestyle.plain}}{%
+ \DescPageRef{\LabelBase.pagestyle.plain}} zu finden.
\end{Example}
\else
- \IfThisCommonLabelBase{scrextend}{\iftrue}{\csname iffalse\endcsname}
+ \IfThisCommonLabelBase{scrextend}{%
+ Ein Beispiel für die Bestimmung des Seitenstils von Vakatseiten finden Sie
+ in \autoref{sec:\ThisCommonFirstLabelBase.emptypage},
+ \PageRefxmpl{\ThisCommonFirstLabelBase.option.cleardoublepage}.%
+ \iffalse% Umbruchvariante ohne Beispiel
+ }{\csname iffalse\endcsname}
\begin{Example}
\phantomsection\xmpllabel{option.cleardoublepage}%
Angenommen, Sie wollen, dass die Vakatseiten bis auf die Paginierung
- leer sind, also mit Seitenstil \PageStyle{plain} erzeugt werden. Dies
- erreichen Sie beispielsweise mit
+ leer sind, also mit Seitenstil \IfThisCommonLabelBase{scrextend}{%
+ \DescRef{maincls.pagestyle.plain}}{\DescRef{\LabelBase.pagestyle.plain}}
+ erzeugt werden. Dies erreichen Sie beispielsweise mit
\begin{lstcode}
\KOMAoptions{cleardoublepage=plain}
\end{lstcode}
- Näheres zum Seitenstil \PageStyle{plain} ist in
+ Näheres zum Seitenstil \DescRef{maincls.pagestyle.plain} ist in
\autoref{sec:maincls.pagestyle},
\DescPageRef{maincls.pagestyle.plain}
zu finden.
@@ -180,7 +196,7 @@ Kompatibilität zu früheren \KOMAScript-Versionen eingestellt hat (siehe Option
\Macro{cleardoubleevenplainpage}%
\Macro{cleardoubleevenstandardpage}
\end{Declaration}%
-Im \LaTeX-Kern existiert die Anweisung
+Im\textnote{Standardklassen} \LaTeX-Kern existiert die Anweisung
\Macro{clearpage}, die dafür sorgt, dass alle noch nicht ausgegebenen
Gleitumgebungen ausgegeben werden und anschließend eine neue Seite begonnen
wird. Außerdem existiert die Anweisung \Macro{cleardoublepage}, die wie
@@ -190,7 +206,8 @@ Option \DescRef{typearea.option.twoside} in \autoref{sec:typearea.typearea},
wird. Dazu wird gegebenenfalls eine linke Vakatseite im aktuellen Seitenstil
ausgegeben.
-Bei {\KOMAScript} arbeitet \Macro{cleardoubleoddstandardpage}%
+Bei {\KOMAScript}\textnote{\KOMAScript} arbeitet
+\Macro{cleardoubleoddstandardpage}%
\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
@@ -200,33 +217,42 @@ Bei {\KOMAScript} arbeitet \Macro{cleardoubleoddstandardpage}%
}{}%
} %
genau in der soeben für die Standardklassen beschriebenen Art und Weise. Die
-Anweisung \Macro{cleardoubleoddplainpage} ändert demgegenüber den Seitenstil
-der leeren linken Seite zusätzlich auf
-\PageStyle{plain}\IndexPagestyle{plain}, um den
+Anweisung \Macro{cleardoubleoddplainpage}%
+\important{\IfThisCommonLabelBase{scrextend}{%
+ \DescRef{maincls.pagestyle.plain}}{\DescRef{\LabelBase.pagestyle.plain}}}
+ändert demgegenüber den Seitenstil der leeren linken Seite zusätzlich auf
+\IfThisCommonLabelBase{scrextend}{%
+ \DescRef{maincls.pagestyle.plain}}{\DescRef{\LabelBase.pagestyle.plain}}%
+\IndexPagestyle{plain}, um den
\IfThisCommonLabelBase{scrlttr2}{Seitenkopf}{Kolumnentitel} zu
unterdrücken. Analog dazu wird bei der Anweisung
-\Macro{cleardoubleoddemptypage} der Seitenstil
-\PageStyle{empty}\IndexPagestyle{empty} verwendet, um sowohl
-\IfThisCommonLabelBase{scrlttr2}{Seitenkopf als auch Seitenfuß}{Kolumnentitel
- als auch Seitenzahl} auf der leeren linken Seite zu unterdrücken. Die Seite
-ist damit vollständig leer. Will man für die Vakatseite einen eigenen
-\PName{Seitenstil} vorgeben, so ist dieser als Argument von
-\Macro{cleardoubleoddpageusingstyle} anzugeben. Dabei kann jeder bereits
-definierte Seitenstil (siehe auch \autoref{cha:scrlayer-scrpage}) verwendet
-werden.
+\Macro{cleardoubleoddemptypage}%
+\important{%
+ \IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{%
+ \DescRef{\LabelBase.pagestyle.empty}}} der Seitenstil
+\IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{%
+ \DescRef{\LabelBase.pagestyle.empty}}\IndexPagestyle{empty} verwendet, um
+sowohl \IfThisCommonLabelBase{scrlttr2}{Seitenkopf als auch
+ Seitenfuß}{Kolumnentitel als auch Seitenzahl} auf der leeren linken Seite zu
+unterdrücken. Die Seite ist damit vollständig leer. Will man für die
+Vakatseite einen eigenen \PName{Seitenstil} vorgeben, so ist dieser als
+Argument von \Macro{cleardoubleoddpageusingstyle} anzugeben. Dabei kann jeder
+bereits definierte Seitenstil (siehe auch \autoref{cha:scrlayer-scrpage})
+verwendet werden.
\IfThisCommonLabelBase{scrlttr2}{}{%
- Manchmal möchte man nicht, dass Kapitel mit neuen rechten Seiten, sondern
- links auf einer Doppelseite beginnen. Dies widerspricht zwar dem klassischen
- Buchdruck, kann jedoch seine Berechtigung haben, wenn die Doppelseite am
- Kapitelanfang einen ganz speziellen Inhalt hat. Bei \KOMAScript{} ist
- deshalb die Anweisung \Macro{cleardoubleevenstandardpage} als Äquivalent zur
- Anweisung \Macro{cleardoubleoddstandardpage} definiert, jedoch mit dem
- Unterschied, dass die nächste Seite eine linke Seite ist. Entsprechendes
- gilt für die Anweisungen \Macro{cleardoubleevenplainpage},
- \Macro{cleardoubleevenemptypage} und %
+ Manchmal\textnote{ungerade Vakatseiten} möchte man nicht, dass Kapitel mit
+ neuen rechten Seiten, sondern links auf einer Doppelseite beginnen. Dies
+ widerspricht zwar dem klassischen Buchdruck, kann jedoch seine Berechtigung
+ haben, wenn die Doppelseite am Kapitelanfang einen ganz speziellen Inhalt
+ hat. Bei \KOMAScript{} ist deshalb die Anweisung
+ \Macro{cleardoubleevenstandardpage} als Äquivalent zur Anweisung
+ \Macro{cleardoubleoddstandardpage} definiert, jedoch mit dem Unterschied,
+ dass die nächste Seite eine linke Seite ist. Entsprechendes gilt für die
+ Anweisungen \Macro{cleardoubleevenplainpage},
+ \Macro{cleardoubleevenemptypage}%
\IfThisCommonLabelBase{maincls}{% Umbruchoptimierungsalternative
- für die ein Argument erwartende Anweisung }{}%
+ \ und für die ein Argument erwartende Anweisung}{,}
\Macro{cleardoubleevenpageusingstyle}.%
}
@@ -251,13 +277,14 @@ Argument erwartenden Anweisung \Macro{cleardoublepageusingstyle} %
\IfThisCommonLabelBase{scrlttr2}{. %
Die übrigen Anweisungen sind bei \Class{scrlttr2} nur aus Gründen der
Vollständigkeit definiert. Näheres zu diesen ist bei Bedarf
- \autoref{sec:maincls.emptypage},
- \DescPageRef{maincls.cmd.cleardoublepage} zu entnehmen%
+ \autoref{sec:maincls.emptypage}, \DescPageRef{maincls.cmd.cleardoublepage}
+ zu entnehmen%
}{%
- für den Umbruch zur nächsten ungeraden Seite%
+ \ für den Umbruch zur nächsten ungeraden Seite%
}.%
-}
-\IfThisCommonLabelBase{scrlttr2}{\iffalse}{\csname iftrue\endcsname}
+}%
+\IfThisCommonLabelBaseOneOf{scrlttr2,scrextend}{\iffalse}{\csname
+ iftrue\endcsname}
\begin{Example}
\phantomsection\xmpllabel{cmd.cleardoublepage}%
Angenommen, Sie wollen innerhalb eines Dokuments als nächstes eine
@@ -266,19 +293,24 @@ Argument erwartenden Anweisung \Macro{cleardoublepageusingstyle} %
beginnt. Falls das vorherige Kapitel mit einer linken Seite endet, muss
also eine Vakatseite eingefügt werden. Diese soll komplett leer
sein. Ebenso soll die linke Bildseite weder Kopf noch Fußzeile
- besitzen. Zunächst wird mit
+ besitzen.
+\iffalse% Umbruchkorrekturtext
+ Zunächst wird mit
\begin{lstcode}
\KOMAoptions{cleardoublepage=empty}
\end{lstcode}
- dafür gesorgt, dass Vakatseiten mit dem Seitenstil \PageStyle{empty}, also
- ohne Kopf- und Fußzeile gesetzt werden. Diese Einstellung können Sie
- bereits in der Dokumentpräambel vornehmen. Die Optionen können alternativ
- auch als optionale Argumente von
+ dafür gesorgt, dass Vakatseiten mit dem Seitenstil
+ \IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{%
+ \DescRef{\LabelBase.pagestyle.empty}}, also ohne Kopf- und Fußzeile
+ gesetzt
+ werden. Diese Einstellung können Sie bereits in der Dokumentpräambel
+ vornehmen. Die Optionen können alternativ auch als optionale Argumente von
\DescRef{\ThisCommonLabelBase.cmd.documentclass} angegeben werden.
-
+\fi
+
An der gewünschten Stelle
- \IfThisCommonLabelBase{scrextend}{}{im Dokument }% Umbruchoptimierung!!!
- schreiben Sie nun:
+% \IfThisCommonLabelBase{scrextend}{}{im Dokument }% Umbruchoptimierung!!!
+ schreiben Sie daher:% mit dem Umbruchkorrekturtext oben statt daher nun:
\begin{lstcode}
\cleardoubleevenemptypage
\thispagestyle{empty}
@@ -291,20 +323,26 @@ Argument erwartenden Anweisung \Macro{cleardoublepageusingstyle} %
Die erste Zeile wechselt auf die nächste linke Seite und fügt zu diesem
Zweck bei Bedarf eine komplett leere rechte Seite ein. Die zweite Zeile
sorgt dafür, dass diese linke Seite ebenfalls mit dem Seitenstil
- \PageStyle{empty} gesetzt wird. Die dritte bis sechste Zeile lädt die
- Bilddatei mit dem Namen \File{bild} und bringt sie auf die gewünschte
- Größe, ohne sie dabei zu verzerren. Hierfür wird das Paket
- \Package{graphicx}\IndexPackage{graphicx} benötigt (siehe
+ \IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{%
+ \DescRef{\LabelBase.pagestyle.empty}} gesetzt wird. Die dritte bis
+ sechste Zeile lädt die Bilddatei mit dem Namen \File{bild} und bringt sie
+ auf die gewünschte Größe, ohne sie dabei zu verzerren. Hierfür wird das
+ Paket \Package{graphicx}\IndexPackage{graphicx} benötigt (siehe
\cite{package:graphics}). Die letzte Zeile beginnt auf der nächsten --
dann rechten -- Seite ein neues Kapitel.
\end{Example}%
\fi
-Die Anweisungen \Macro{cleardoubleoddpage} und \Macro{cleardoubleevenpage}
-führen immer zur nächsten linken beziehungsweise rechten Seite. Dabei wird für
-eine gegebenenfalls einzufügende Vakatseite der Seitenstil entsprechend Option
-\DescRef{\LabelBase.option.cleardoublepage} gewählt.%
-%
+Im doppelseitigen Satz führt \Macro{cleardoubleoddpage} immer zur nächsten
+linken Seite, \Macro{cleardoubleevenpage} zur nächsten
+rechten Seite. Eine gegebenenfalls einzufügenden Vakatseite wird mit dem
+über Option \DescRef{\LabelBase.option.cleardoublepage} festgelegten
+Seitenstil ausgegeben.%
+\IfThisCommonLabelBase{scrextend}{\par%
+ Ein Beispiel für die Verwendung von \Macro{cleardoubleevenemptypage} finden
+ Sie in \autoref{sec:maincls.emptypage},
+ \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.cleardoublepage}.%
+}{}%
\EndIndexGroup
%
\EndIndexGroup
@@ -319,4 +357,5 @@ eine gegebenenfalls einzufügende Vakatseite der Seitenstil entsprechend Option
%%% End:
% LocalWords: Gleitumgebungen Seitenkopf Kolumnentitel Seitenfuß Bilddatei
-% LocalWords: Satzspiegels Bildseite
+% LocalWords: Satzspiegels Bildseite Dokumentpräambel Vakatseiten
+% LocalWords: Vakatseite
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-lists.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-lists.tex
index cf8e75daa4c..c907a664b78 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-lists.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-lists.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-lists.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-lists.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{common-lists.tex}%
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-02-06 09:20:05 +0100 (Tue, 06 Feb 2018) $
KOMA-Script guide (common paragraphs)]
\section{Listen}
@@ -60,24 +60,34 @@
\autoref{sec:\ThisCommonFirstLabelBase.lists} bereits gelesen und verstanden
haben, können Sie auf \autopageref{sec:\ThisCommonLabelBase.lists.next} mit
\autoref{sec:\ThisCommonLabelBase.lists.next} fortfahren.%
- \IfThisCommonLabelBase{scrextend}{ %
+ \IfThisCommonLabelBaseOneOf{scrextend,scrlttr2}{ %
+ \IfThisCommonLabelBase{scrlttr2}{%
+ Das Paket \Package{scrletter}\OnlyAt{\Package{scrletter}} definiert
+ selbst keine Listenumgebungen, sondern überlässt diese der verwendeten
+ Klasse. Ist dies keine \KOMAScript-Klasse, so lädt es
+ \hyperref[cha:scrextend]{\Package{scrextend}}\IndexPackage{scrextend}%
+ \important{\hyperref[cha:scrextend]{\Package{scrextend}}}.%
+ }{} %
Allerdings werden vom Paket \Package{scrextend} nur die Umgebungen
\DescRef{\ThisCommonLabelBase.env.labeling},
\DescRef{\ThisCommonLabelBase.env.addmargin} und
\DescRef{\ThisCommonLabelBase.env.addmargin*} definiert. Alle anderen
- Listenumgebungen bleiben der Verantwortung und Kontrolle der verwendeten
- Klasse überlassen.%
+ Listenumgebungen bleiben der Verantwortung % und Kontrolle
+ der verwendeten Klasse überlassen.%
}{}%
}
-{\LaTeX} und die Standardklassen bieten verschiedene Umgebungen für
-Listen. All diese Umgebungen bietet {\KOMAScript} selbstverständlich auch,
-teilweise jedoch mit leichten Abwandlungen oder Erweiterungen. Grundsätzlich
-gilt, dass Listen -- auch unterschiedlicher Art -- bis zu einer Tiefe von vier
-Listen geschachtelt werden können. Eine tiefere Schachtelung wäre auch aus
-typografischen Gründen kaum sinnvoll, da genau genommen schon mehr als drei
-Ebenen nicht mehr überblickt werden können. Ich empfehle\textnote{Tipp!} in
-solchen Fällen, die eine große Liste in mehrere kleinere Listen aufzuteilen.
+\IfThisCommonLabelBase{scrextend}{}{%
+ {\LaTeX} und die Standardklassen\textnote{\KOMAScript{} vs. Standardklassen}
+ bieten verschiedene Umgebungen für Listen. All diese Umgebungen bietet
+ {\KOMAScript} selbstverständlich auch, teilweise jedoch mit leichten
+ Abwandlungen oder Erweiterungen. Grundsätzlich gilt, dass Listen -- auch
+ unterschiedlicher Art -- bis zu einer Tiefe von vier Listen geschachtelt
+ werden können. Eine tiefere Schachtelung wäre auch aus typografischen
+ Gründen kaum sinnvoll, da genau genommen schon mehr als drei Ebenen nicht
+ mehr überblickt werden können. Ich empfehle\textnote{Tipp!} in solchen
+ Fällen, die eine große Liste in mehrere kleinere Listen aufzuteilen.%
+}
\IfThisCommonFirstRun{}{%
Da Listen zu den Standardelementen von \LaTeX{} gehören, wurde in diesem
@@ -101,13 +111,14 @@ solchen Fällen, die eine große Liste in mehrere kleinere Listen aufzuteilen.
\Macro{labelitemiii}
\Macro{labelitemiv}
\end{Declaration}%
- Die einfachste Form einer Liste ist die Stichpunkt- oder
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Die einfachste
+ Form einer Liste ist die Stichpunkt-\textnote{Stichpunktliste} oder
\Environment{itemize}-Liste. %
\iffalse % Umbruchoptimierungstext
- Die Benutzer einer unbeliebten Textverarbeitung nennen diese Form der
- Liste auch gerne \emph{Bulletpoints}. Vermutlich können sie sich nicht
- vorstellen, dass je nach Ebene auch ein anderes Zeichen als ein fetter
- Punkt zur Einleitung eines Stichpunkts verwendet werden kann. %
+ Die Benutzer einer unbeliebten Textverarbeitung nennen diese Form der Liste
+ auch gerne \emph{Bulletpoints}. Vermutlich können sie sich nicht vorstellen,
+ dass je nach Ebene auch ein anderes Zeichen als ein fetter Punkt zur
+ Einleitung eines Stichpunkts verwendet werden kann. %
\fi%
Bei den \KOMAScript-Klassen werden je nach Ebene folgende Aufzählungszeichen
zur Einleitung eines Listenelements verwendet: »{\labelitemi}«,
@@ -212,9 +223,10 @@ solchen Fällen, die eine große Liste in mehrere kleinere Listen aufzuteilen.
\Macro{labelenumiii}
\Macro{labelenumiv}
\end{Declaration}%
- Die nummerierte Liste ist ebenfalls sehr häufig zu finden und bereits vom
- {\LaTeX}-Kern vorgesehen. Die Nummerierung\Index{Nummerierung} erfolgt je
- nach Ebene in unterschiedlicher Art: mit arabischen Zahlen, mit
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Die nummerierte
+ Liste\textnote{nummerierte Liste} ist ebenfalls sehr häufig zu finden und
+ bereits vom {\LaTeX}-Kern vorgesehen. Die Nummerierung\Index{Nummerierung}
+ erfolgt je nach Ebene in unterschiedlicher Art: mit arabischen Zahlen, mit
Kleinbuchstaben, mit kleinen römischen Zahlen und mit Großbuchstaben. Die
Art der Nummerierung wird dabei über die Makros \Macro{theenumi} bis
\Macro{theenumiv} festgelegt. Das Format der Ausgabe wird von den Makros
@@ -284,9 +296,10 @@ solchen Fällen, die eine große Liste in mehrere kleinere Listen aufzuteilen.
\end{Body}
\end{Environment}
\end{Declaration}%
- Eine weitere Listenform ist die Stichwortliste. Sie dient in erster Linie
- der Beschreibung einzelner Begriffe. Diese werden als optionale Parameter
- bei \Macro{item} angegeben. %
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Eine weitere
+ Listenform ist die Stichwortliste\textnote{Stichwortliste}. Sie dient in
+ erster Linie der Beschreibung einzelner Begriffe. Diese werden als optionale
+ Parameter bei \Macro{item} angegeben. %
\BeginIndex{FontElement}{descriptionlabel}%
\LabelFontElement{descriptionlabel}%
Die Schriftart\Index{Schrift>Art}\ChangedAt{v2.8p}{\Class{scrbook}\and
@@ -296,8 +309,8 @@ solchen Fällen, die eine große Liste in mehrere kleinere Listen aufzuteilen.
\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (siehe
\autoref{sec:\ThisCommonLabelBase.textmarkup},
\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) für das Element
- \FontElement{descriptionlabel} (siehe
- \autoref{tab:\ThisCommonLabelBase.fontelements},
+ \FontElement{descriptionlabel}\important{\FontElement{descriptionlabel}}
+ (siehe \autoref{tab:\ThisCommonLabelBase.fontelements},
\autopageref{tab:\ThisCommonLabelBase.fontelements}) geändert werden. In der
Voreinstellung wird \Macro{sffamily}""\Macro{bfseries} verwendet.%
\IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}
@@ -359,10 +372,14 @@ Eine andere Form der %
in vielen Klassen als
\DescRef{\ThisCommonFirstLabelBase.env.description}-Umgebung vorhandenen %
}{}%
-Stichwortliste ist nur bei den {\KOMAScript}-Klassen %
-\IfThisCommonLabelBase{scrextend}{ und \Package{scrextend} }{}%
-vorhanden: die \Environment{labeling}-Umgebung. Im Unterschied zur zuvor
-vorgestellten Umgebung %
+Stichwortliste\textnote{alternative Stichwortliste} ist nur bei den
+{\KOMAScript}-Klassen %
+\IfThisCommonLabelBase{scrextend}{ und \Package{scrextend} }{%
+ \IfThisCommonLabelBase{scrlttr2}{ und
+ \hyperref[cha:scrextend]{\Package{scrextend}} }{}%
+}%
+vorhanden: die \Environment{labeling}-Umgebung. Im Unterschied
+\IfThisCommonLabelBase{scrextend}{zu}{zur zuvor vorgestellten Umgebung} %
\IfThisCommonLabelBase{scrextend}{%
\DescRef{\ThisCommonFirstLabelBase.env.description}%
}{%
@@ -460,11 +477,13 @@ Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.%
\begin{Declaration}
\begin{Environment}{verse}\end{Environment}
\end{Declaration}%
- Die \Environment{verse}-Umgebung wird normalerweise nicht als Listenumgebung
- wahrgenommen, da hier nicht mit \Macro{item} gearbeitet wird. Stattdessen
- wird wie innerhalb der \Environment{flushleft}-Umgebung mit festen
- Zeilenumbrüchen gearbeitet. Intern handelt es sich jedoch sowohl bei den
- Standardklassen als auch bei {\KOMAScript} durchaus um eine Listenumgebung.
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Die
+ \Environment{verse}-Umgebung\textnote{Versform} wird normalerweise nicht als
+ Listenumgebung wahrgenommen, da hier nicht mit \Macro{item} gearbeitet
+ wird. Stattdessen wird wie innerhalb der \Environment{flushleft}-Umgebung
+ mit festen Zeilenumbrüchen gearbeitet. Intern handelt es sich jedoch sowohl
+ bei den Standardklassen als auch bei {\KOMAScript} durchaus um eine
+ Listenumgebung.
Die \Environment{verse}-Umgebung findet hauptsächlich für
Gedichte\Index{Gedichte} Anwendung. Dabei werden die Zeilen links und rechts
@@ -473,8 +492,9 @@ Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.%
Absatz gesetzt, also durch eine Leerzeile getrennt. Häufig findet
stattdessen auch \Macro{medskip}\IndexCmd{medskip} oder
\Macro{bigskip}\IndexCmd{bigskip} Verwendung. Will man verhindern, dass am
- Ende eines Verses ein Seitenumbruch erfolgt, so verwendet man ganz normal
- \verb|\\*|\IndexCmd{\textbackslash*} an Stelle von \verb|\\|.%
+ Ende eines Verses ein Seitenumbruch\textnote{Seitenumbruch} erfolgt, so
+ verwendet man ganz normal \verb|\\*|\IndexCmd{\textbackslash*} anstelle von
+ \verb|\\|.%
\IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}
\begin{Example}
\phantomsection\xmpllabel{env.verse}%
@@ -562,38 +582,40 @@ Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.%
\EndIndexGroup
- \iffalse% Umbruchkorrekturvarianten
+ \iftrue% Umbruchkorrekturvarianten
\begin{Declaration}
\begin{Environment}{quote}\end{Environment}
\end{Declaration}%
- Dies ist intern ebenfalls eine Listenumgebung und sowohl bei den
- Standardklassen als auch bei {\KOMAScript} zu finden. Der Inhalt der
- Umgebung wird im Blocksatz mit beidseitigem Einzug gesetzt. Die Umgebung
- wird häufig verwendet, um längere Zitate\Index{Zitat} abzusetzen. Dabei
- werden Absätze innerhalb der Umgebung durch einen vertikalen Abstand
- gekennzeichnet.%
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Dies ist
+ intern ebenfalls eine Listenumgebung\textnote{Blockzitat mit
+ Absatzabstand} und sowohl bei den Standardklassen als auch bei
+ {\KOMAScript} zu finden. Der Inhalt der Umgebung wird im Blocksatz mit
+ beidseitigem Einzug gesetzt. Die Umgebung wird häufig verwendet, um
+ längere Zitate\Index{Zitat} abzusetzen. Dabei werden Absätze innerhalb der
+ Umgebung durch einen vertikalen Abstand gekennzeichnet.%
\EndIndexGroup
\begin{Declaration}
\begin{Environment}{quotation}\end{Environment}
\end{Declaration}%
- Diese Umgebung ist mit \DescRef{\ThisCommonLabelBase.env.quote}
- vergleichbar. Während bei \DescRef{\ThisCommonLabelBase.env.quote} Absätze
- durch vertikalen Abstand gekennzeichnet werden, wird bei
- \Environment{quotation} mit horizontalem Einzug der ersten Zeile eines
- Absatzes gearbeitet. Dies gilt auch für den ersten Absatz einer
- \Environment{quotation}-Umgebung. Wollen Sie dort den Einzug verhindern,
- müssen Sie die \Macro{noindent}-Anweisung\IndexCmd{noindent}
- voranstellen.%
- \EndIndexGroup
- \else
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Diese
+ Umgebung\textnote{Blockzitat mit Absatzeinzug} ist mit
+ \DescRef{\ThisCommonLabelBase.env.quote} vergleichbar. Während bei
+ \DescRef{\ThisCommonLabelBase.env.quote} Absätze durch vertikalen Abstand
+ gekennzeichnet werden, wird bei \Environment{quotation} mit horizontalem
+ Einzug der ersten Zeile eines Absatzes gearbeitet. Dies gilt auch für den
+ ersten Absatz einer \Environment{quotation}-Umgebung. Wollen Sie dort den
+ Einzug verhindern, müssen Sie die
+ \Macro{noindent}-Anweisung\IndexCmd{noindent} voranstellen.%
+ \else
\begin{Declaration}
\begin{Environment}{quote}\end{Environment}
\begin{Environment}{quotation}\end{Environment}
\end{Declaration}%
- Diese beiden Umgebungen sind intern ebenfalls Listenumgebungen und sowohl
- bei den Standardklassen als auch bei {\KOMAScript} zu finden. Beide
- Umgebungen setzen Blocksatz, der rechts und links eingezogen
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Diese beiden
+ Umgebungen\textnote{Blockzitate} sind intern ebenfalls Listenumgebungen
+ und sowohl bei den Standardklassen als auch bei {\KOMAScript} zu finden.
+ Beide Umgebungen setzen Blocksatz, der rechts und links eingezogen
ist. Verwendet werden die Umgebungen häufig, um längere
Zitate\Index{Zitat} abzusetzen. Der Unterschied zwischen beiden liegt in
der Art und Weise, wie Absätze abgesetzt werden. Während bei
@@ -609,11 +631,12 @@ Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.%
\Macro{noindent}-Anweisung\IndexCmd{noindent} voranstellen.%
}{\InternalCommonFileUsageError}%
}%
+ \fi % Umbruchkorrekturvarianten
\IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}
- \begin{Example}
- \phantomsection\xmpllabel{env.quote}%
- Sie wollen eine kleine Anekdote hervorheben. Also schreiben Sie
- unter Verwendung der Umgebung \Environment{quotation}:%
+ \begin{Example}
+ \phantomsection\xmpllabel{env.quote}%
+ Sie wollen eine kleine Anekdote hervorheben. Also schreiben Sie
+ unter Verwendung der Umgebung \Environment{quotation}:%
\begin{lstcode}
\documentclass[paper=a5,pagesize]{scrartcl}
\usepackage{selinput}
@@ -668,8 +691,9 @@ Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.%
"`Guda Moh, Sie missat sich halt zwinga!"'
\end{quotation}
\end{ShowOutput}%
- Zum Vergleich sei das Ganze an Stelle von \Environment{quotation} auch
- noch mit einer \Environment{quote}-Umgebung gezeigt:%
+ \iffree{}{\IfThisCommonLabelBase{maincls}{\clearpage}{}}% Umbruchkorrektur!!!!
+ Zum Vergleich sei das Ganze anstelle von \Environment{quotation} auch
+ noch mit einer \DescRef{\LabelBase.env.quote}-Umgebung gezeigt:%
\begin{ShowOutput}
\iftrue% Umbruchkorrekturtext
Ein kleines Beispiel für eine Anekdote, die sich einst
@@ -698,7 +722,6 @@ Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.%
\fi
%
\EndIndexGroup
- \fi % Umbruchkorrekturvarianten
\fi
\begin{Declaration}
@@ -716,25 +739,26 @@ Wie bei %
\DescRef{\ThisCommonLabelBase.env.quote} und
\DescRef{\ThisCommonLabelBase.env.quotation}%
} %
-handelt es sich bei \Environment{addmargin} um eine Umgebung, die den
-Rand\Index{Rand} verändert. Im Unterschied zu den beiden erstgenannten
-Umgebungen kann der Anwender jedoch bei \Environment{addmargin} wählen, um
-welchen Wert der Rand verändert werden kann. Des Weiteren verändert die
-Umgebung den Absatzeinzug und den Absatzabstand nicht. Es wird auch kein
-zusätzlicher vertikaler Abstand vor und nach der Umgebung eingefügt.
+handelt\textnote{allgemeine Einzugsumgebung} es sich bei
+\Environment{addmargin} um eine Umgebung, die den Rand\Index{Rand}
+verändert. Im Unterschied zu den beiden erstgenannten Umgebungen kann der
+Anwender jedoch bei \Environment{addmargin} wählen, um welchen Wert der Rand
+verändert werden soll. Des Weiteren verändert die Umgebung den Absatzeinzug
+und den Absatzabstand nicht. Es wird auch kein zusätzlicher vertikaler Abstand
+vor und nach der Umgebung eingefügt.
Ist nur das obligatorische Argument \PName{Einzug} angegeben, so wird der
Inhalt der Umgebung rechts und links um diesen Wert eingezogen. Ist das
optionale Argument \PName{linker Einzug} hingegen angegeben, so wird links
abweichend von \PName{Einzug} der Wert \PName{linker Einzug} zum Rand addiert.
-Die Sternvariante \Environment{addmargin*} unterscheidet sich nur im
-doppelseitigen Satz von der Variante ohne Stern, wobei der Unterschied auch
-nur dann auf"|tritt, wenn das optionale Argument \PName{innerer Einzug}
-verwendet wird. Dabei wird dann der Wert von \PName{innerer Einzug} zum
-inneren Randanteil der Seite addiert. Dies ist bei rechten Seiten der linke
-Rand der Seite, bei linken Seiten jedoch der rechte Rand der
-Seite. \PName{Einzug} gilt dann für den jeweils anderen Rand.
+Die Sternvariante \Environment{addmargin*}\important{\Environment{addmargin*}}
+unterscheidet sich nur im doppelseitigen Satz von der Variante ohne Stern,
+wobei der Unterschied auch nur dann auf"|tritt, wenn das optionale Argument
+\PName{innerer Einzug} verwendet wird. Dabei wird dann der Wert von
+\PName{innerer Einzug} zum inneren Randanteil der Seite addiert. Dies ist bei
+rechten Seiten der linke Rand der Seite, bei linken Seiten jedoch der rechte
+Rand der Seite. \PName{Einzug} gilt dann für den jeweils anderen Rand.
Bei beiden Varianten der Umgebung sind für alle Parameter auch negative Werte
erlaubt. % Umbruchkorrektur
@@ -804,12 +828,13 @@ Erklärungen zu den Anweisungen
(\autoref{sec:\ThisCommonLabelBase.oddOrEven},
\DescPageRef{\ThisCommonLabelBase.cmd.ifthispageodd}) und
\iffree{\Macro{ifthispagewasodd}}{%
- \DescRef{\ThisCommonLabelBase.cmd.ifthispagewasodd}}
+ \DescRef{maincls-experts.cmd.ifthispagewasodd}}
(\autoref{sec:maincls-experts.addInfos},
-\DescPageRef{maincls-experts.cmd.ifthispageodd}).
-
+\DescPageRef{maincls-experts.cmd.ifthispageodd}).%
+\IfThisCommonLabelBase{scrlttr2}{}{%
\begin{Explain}
- Im Zusammenspiel von Umgebungen wie Listen mit Absätzen ergeben sich für
+ Im Zusammenspiel von % Umgebungen wie
+ Listen mit Absätzen ergeben sich für
Laien häufiger Fragen. Daher widmet sich die weiterführende Erklärung zu
Option \DescRef{maincls-experts.option.parskip} in
\autoref{sec:maincls-experts.addInfos},
@@ -817,7 +842,7 @@ Erklärungen zu den Anweisungen
Thema. Ebenfalls im Expertenteil in \autoref{sec:maincls-experts.addInfos},
\DescPageRef{maincls-experts.env.addmargin*} wird die Problematik von
mehrseitigen \Environment{addmargin*}-Umgebungen behandelt.
-\end{Explain}%
+\end{Explain}}%
%
\EndIndexGroup
%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-marginpar.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-marginpar.tex
index 6486922a99c..ee806336932 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-marginpar.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-marginpar.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-marginpar.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-marginpar.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{common-marginpar.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-01-29 14:12:59 +0100 (Mon, 29 Jan 2018) $
KOMA-Script guide (common paragraphs)]
@@ -67,7 +67,7 @@
}
Außer dem eigentlichen Textbereich, der normalerweise den Satzspiegel
-ausfüllt, existiert in Dokumenten noch die so genannte Marginalienspalte. In
+ausfüllt, existiert in Dokumenten noch die sogenannte Marginalienspalte. In
dieser können Randnotizen gesetzt werden. %
\IfThisCommonLabelBase{scrlttr2}{%
Bei Briefen sind Randnotizen allerdings eher unüblich und sollten äußerst
@@ -108,7 +108,7 @@ die Anweisung \Macro{marginline}.
\marginline{\texttt{scrartcl}}
\end{lstcode}
erreicht werden.%
- \iffalse % Umbruchkorrekturtext
+ \iftrue % Umbruchkorrekturtext
\footnote{Tatsächlich wurde nicht \Macro{texttt},
sondern eine semantische Auszeichnung verwendet. Um nicht unnötig
zu verwirren, wurde diese im Beispiel ersetzt.}%
@@ -131,10 +131,11 @@ Für\textnote{Achtung!} Experten sind in
\Macro{marginpar} dokumentiert. Diese gelten ebenso für \Macro{marginline}.
Darüber hinaus wird in \autoref{cha:scrlayer-notecolumn} ein Paket
vorgestellt, mit dem sich auch Notizspalten mit eigenem Seitenumbruch
-realisieren lassen. %
-\iffalse% Umbruchkorrektur
- Allerdings ist das Paket
- \Package{scrlayer-notecolumn}\IndexPackage{scrlayer-notecolumn} eher als
+realisieren lassen.%
+\iftrue% Umbruchkorrektur
+ \ Allerdings ist das Paket
+ \hyperref[cha:scrlayer-notecolumn]{\Package{scrlayer-notecolumn}}%
+ \IndexPackage{scrlayer-notecolumn} eher als
eine Konzeptstudie und weniger als fertiges Paket zu verstehen.%
\fi%
%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-oddorevenpage.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-oddorevenpage.tex
index da0ef14d305..71dc74663e5 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-oddorevenpage.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-oddorevenpage.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-oddorevenpage.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-oddorevenpage.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{common-oddorevenpage.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-01-30 09:32:50 +0100 (Tue, 30 Jan 2018) $
KOMA-Script guide (common paragraphs)]
\section{Erkennung von rechten und linken Seiten}
@@ -83,7 +83,7 @@ rechte Seite immer eine ungerade Nummer. %
}{%
\IfThisCommonLabelBase{scrlttr2}{%
In der Regel werden Briefe einseitig gesetzt. Sollen Briefe mit
- einseitigem Layout jedoch auf Vorder- und Rückseite gedruckt, oder
+ einseitigem Layout jedoch auf Vorder- und Rückseite gedruckt oder
ausnahmsweise tatsächlich doppelseitige Briefe erstellt werden, kann unter
Umständen das Wissen, ob man sich auf einer Vorder- oder einer Rückseite
befindet, nützlich sein.%
@@ -96,7 +96,7 @@ rechte Seite immer eine ungerade Nummer. %
Will man bei \KOMAScript{} feststellen, ob ein Text auf einer geraden oder
einer ungeraden Seite ausgegeben wird, so verwendet man die Anweisung
\Macro{ifthispageodd}. Dabei wird das Argument \PName{Dann-Teil} nur dann
-ausgeführt, wenn man sich gerade auf einer ungeraden Seite
+ausgeführt, wenn man sich aktuell auf einer ungeraden Seite
befindet. Anderenfalls kommt das Argument \PName{Sonst-Teil} zur Anwendung.
\begin{Example}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-options.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-options.tex
index 090d4582a5b..0d12cde2e10 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-options.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-options.tex
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{common-options.tex}
- [$Date: 2017-06-23 09:22:23 +0200 (Fri, 23 Jun 2017) $
+ [$Date: 2017-12-08 08:10:55 +0100 (Fri, 08 Dec 2017) $
KOMA-Script guide (common paragraphs)]
\section{Frühe oder späte Optionenwahl}
@@ -54,54 +54,55 @@
\BeginIndexGroup
\BeginIndex{}{Optionen}%
-\IfThisCommonFirstRun{}{%
- Es gilt sinngemäß, was in
- \autoref{sec:\ThisCommonFirstLabelBase.options} geschrieben wurde. Falls
- Sie also \autoref{sec:\ThisCommonFirstLabelBase.options} bereits gelesen
- und verstanden haben, können Sie auf
+\IfThisCommonFirstRun{%
+ In diesem Abschnitt wird eine Besonderheit von \KOMAScript{} vorgestellt, die
+ neben %
+ \IfThisCommonLabelBase{typearea}{\Package{typearea} auch andere
+ \KOMAScript-Pakete und "~Klassen }{%
+ \IfThisCommonLabelBase{maincls}{den Klassen \Class{scrbook},
+ \Class{scrreprt} und \Class{scrartcl} auch andere \KOMAScript-Klassen und
+ "~Pakete }{%
+ \IfThisCommonLabelBase{scrlttr2}{der Klasse \Class{scrlttr2} auch andere
+ \KOMAScript-Klassen und "~Pakete }{%
+ \IfThisCommonLabelBase{scrextend}{den Klassen und \Package{scrextend}
+ auch einige andere \KOMAScript-Pakete }{%
+ \IfThisCommonLabelBase{scrhack}{\Package{scrhack} auch andere
+ \KOMAScript-Pakete und "~Klassen }{%
+ \IfThisCommonLabelBase{scrjura}{\Package{scrjura} auch andere
+ \KOMAScript-Pakete und "~Klassen }{%
+ \IfThisCommonLabelBase{scrlayer}{\Package{scrlayer} auch andere
+ \KOMAScript-Pakete und "-Klassen }{%
+ \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \Package{scrlayer-scrpage} auch andere \KOMAScript-Pakete und
+ "-Klassen }{%
+ \IfThisCommonLabelBase{scrlayer-notecolumn}{%
+ \Package{scrlayer-notecolumn} auch andere \KOMAScript-Pakete
+ und "-Klassen }{%
+ \InternalCommonFileUsageError}}}}}}}}}%%
+ betrifft. %
+ % Umbruchvarianten:
+ \IfThisCommonLabelBase{scrlttr2}{Im Sinne der Abgeschlossenheit der Kapitel
+ ist dieser Abschnitt nahezu identisch in mehreren Kapiteln zu finden,
+ braucht aber beim Studium des gesamten von \KOMAScript{} natürlich nur in
+ einem gelesen werden.%
+ }{Damit die Anwender alle Informationen zu einem Paket oder einer Klasse im
+ jeweiligen Kapitel finden, ist dieser Abschnitt nahezu gleichlautend in
+ mehreren Kapiteln zu finden. Anwender, die nicht nur an der Anleitung zu
+ einem Paket oder einer Klasse interessiert sind, sondern sich einen
+ Gesamtüberblick über \KOMAScript{} verschaffen wollen, brauchen diesen
+ Abschnitt nur in einem der Kapitel zu lesen und können ihn
+ \IfThisCommonLabelBase{maincls}{bei den weiteren Kapitel
+ überspringen.}{beim weiteren Studium der Anleitung dann überspringen.}%
+ }%
+}{%
+ Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.options}
+ geschrieben wurde. Falls Sie also
+ \autoref{sec:\ThisCommonFirstLabelBase.options} bereits gelesen und
+ verstanden haben, können Sie auf
\autopageref{sec:\ThisCommonLabelBase.options.next} mit
\autoref{sec:\ThisCommonLabelBase.options.next} fortfahren.%
}
-In diesem Abschnitt wird eine Besonderheit von \KOMAScript{} vorgestellt, die
-neben %
-\IfThisCommonLabelBase{typearea}{\Package{typearea} auch andere
- \KOMAScript-Pakete und "~Klassen }{%
- \IfThisCommonLabelBase{maincls}{den Klassen \Class{scrbook},
- \Class{scrreprt} und \Class{scrartcl} auch andere \KOMAScript-Klassen und
- "~Pakete }{%
- \IfThisCommonLabelBase{scrlttr2}{der Klasse \Class{scrlttr2} auch andere
- \KOMAScript-Klassen und "~Pakete }{%
- \IfThisCommonLabelBase{scrextend}{den Klassen und \Package{scrextend}
- auch einige andere \KOMAScript-Pakete }{%
- \IfThisCommonLabelBase{scrhack}{\Package{scrhack} auch andere
- \KOMAScript-Pakete und "~Klassen }{%
- \IfThisCommonLabelBase{scrjura}{\Package{scrjura} auch andere
- \KOMAScript-Pakete und "~Klassen }{%
- \IfThisCommonLabelBase{scrlayer}{\Package{scrlayer} auch andere
- \KOMAScript-Pakete und "-Klassen }{%
- \IfThisCommonLabelBase{scrlayer-scrpage}{%
- \Package{scrlayer-scrpage} auch andere \KOMAScript-Pakete und
- "-Klassen }{%
- \IfThisCommonLabelBase{scrlayer-notecolumn}{%
- \Package{scrlayer-notecolumn} auch andere \KOMAScript-Pakete
- und "-Klassen }{%
- \InternalCommonFileUsageError}}}}}}}}}%%
-betrifft. %
-% Umbruchvarianten:
-\IfThisCommonLabelBase{scrlttr2}{Im Sinne der Abgeschlossenheit der Kapitel
- ist dieser Abschnitt nahezu identisch in mehreren Kapiteln zu finden,
- braucht aber beim Studium des gesamten von \KOMAScript{} natürlich nur in
- einem gelesen werden.%
-}{Damit die Anwender alle Informationen zu einem Paket oder einer Klasse im
- jeweiligen Kapitel finden, ist dieser Abschnitt nahezu gleichlautend in
- mehreren Kapiteln zu finden. Anwender, die nicht nur an der Anleitung zu
- einem Paket oder einer Klasse interessiert sind, sondern sich einen
- Gesamtüberblick über \KOMAScript{} verschaffen wollen, brauchen diesen
- Abschnitt nur in einem der Kapitel zu lesen und können ihn
- \IfThisCommonLabelBase{maincls}{bei den weiteren Kapitel überspringen.}{beim
- weiteren Studium der Anleitung dann überspringen.}%
-} %
\begin{Declaration}
\Macro{documentclass}\OParameter{Optionenliste}%
@@ -109,22 +110,26 @@ betrifft. %
\Macro{usepackage}\OParameter{Optionenliste}%
\Parameter{Paket-Liste}
\end{Declaration}
-Bei \LaTeX{} ist vorgesehen, dass Anwender Klassenoptionen in Form einer durch
-Komma getrennten Liste einfacher Schlüsselwörter als optionales Argument von
+Bei \LaTeX{} ist vorgesehen, dass Anwender
+Klassenoptionen\textnote{Klassenoptionen} in Form einer durch Komma getrennten
+Liste einfacher Schlüsselwörter als optionales Argument von
\Macro{documentclass} angeben. Außer an die Klasse werden diese Optionen auch
-an alle Pakete weitergereicht, die diese Optionen verstehen. Ebenso ist
-vorgesehen, dass Anwender Paketoptionen in Form einer durch Komma getrennten
+an alle Pakete\textnote{globale Optionen} weitergereicht, die diese Optionen
+verstehen. Ebenso ist vorgesehen, dass Anwender
+Paketoptionen\textnote{Paketoptionen} in Form einer durch Komma getrennten
Liste einfacher Schlüsselwörter als optionales Argument von \Macro{usepackage}
angeben. \KOMAScript{} erweitert\ChangedAt{v3.00}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}\and \Package{typearea}} den
-Mechanismus der Optionen für die \KOMAScript-Klassen und einige Pakete um
-weitere Möglichkeiten. So haben die meisten Optionen bei \KOMAScript{}
-zusätzlich einen Wert. Eine Option hat also nicht unbedingt nur die Form
-\PName{Option}, sondern kann auch die Form
-\PName{Option}\texttt{=}\PName{Wert} haben. Bis auf diesen Unterschied
-arbeiten \Macro{documentclass} und \Macro{usepackage} bei \KOMAScript{} wie in
-\cite{latex:usrguide} oder jeder \LaTeX-Einführung, beispielsweise
-\cite{l2kurz}, beschrieben.%
+Mechanismus der Optionen für
+\IfThisCommonLabelBaseOneOf{scrextend,scrjura}{}{die \KOMAScript-Klassen und
+}einige Pakete um weitere Möglichkeiten. So haben die meisten Optionen bei
+\KOMAScript{} zusätzlich einen Wert. Eine Option hat also nicht unbedingt nur
+die Form \PName{Option}, sondern kann auch die Form
+\PName{Option}\texttt{=}\PName{Wert}%
+\important{\PName{Option}\texttt{=}\PName{Wert}} haben. Bis auf diesen
+Unterschied arbeiten \Macro{documentclass} und \Macro{usepackage} bei
+\KOMAScript{} wie in \cite{latex:usrguide} oder jeder \LaTeX-Einführung,
+beispielsweise \cite{l2kurz}, beschrieben.%
%
\iffree{}{\IfThisCommonLabelBase{scrlayer-scrpage}{\par
Das als veraltet zu betrachtende Paket
@@ -140,7 +145,7 @@ arbeiten \Macro{documentclass} und \Macro{usepackage} bei \KOMAScript{} wie in
keine Optionen angegeben werden. Das ist darin begründet, dass die Klasse
diese Pakete bereits ohne Optionen lädt und \LaTeX{} das mehrmalige Laden
eines Pakets mit unterschiedlicher Angabe von Optionen verweigert.%
- \IfThisCommonLabelBase{scrlttr2}{Überhaupt ist es bei Verwendung einer
+ \IfThisCommonLabelBase{scrlttr2}{ Überhaupt ist es bei Verwendung einer
\KOMAScript-Klasse nicht notwendig, eines dieser Pakete auch noch explizit
zu laden.}{}%
\par
@@ -173,12 +178,16 @@ nachfolgend dokumentierten Anweisungen \DescRef{\LabelBase.cmd.KOMAoptions} oder
\Macro{KOMAoption}\Parameter{Option}\Parameter{Werteliste}
\end{Declaration}
\KOMAScript{}\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}\and \Package{typearea}} bietet bei
-den meisten Klassen- und Paketoptionen auch die Möglichkeit, den Wert der
-Optionen noch nach dem Laden der Klasse beziehungsweise des Pakets zu
-ändern. Man kann dann wahlweise mit der Anweisung \Macro{KOMAoptions} die
-Werte einer Reihe von Optionen ändern. Jede Option der \PName{Optionenliste}
-hat dabei die Form \PName{Option}\texttt{=}\PName{Wert}.
+ \Class{scrartcl}\and \Package{typearea}} bietet bei den meisten
+\IfThisCommonLabelBaseOneOf{scrextend,scrjura}{}{Klassen- und }Paketoptionen
+auch die Möglichkeit, den Wert der Optionen noch nach dem Laden
+\IfThisCommonLabelBaseOneOf{scrextend,scrjura}{}{der Klasse beziehungsweise
+}des Pakets zu ändern. Mit der Anweisung \Macro{KOMAoptions} kann man wie bei
+\DescRef{\ThisCommonLabelBase.cmd.documentclass} oder
+\DescRef{\ThisCommonLabelBase.cmd.usepackage} die Werte einer Reihe von
+Optionen ändern. Jede Option der \PName{Optionenliste} hat dabei die Form
+\PName{Option}\texttt{=}\PName{Wert}%
+\important{\PName{Option}\texttt{=}\PName{Wert},\dots}.
Einige Optionen besitzen auch einen Säumniswert (engl. \emph{default
value}). Versäumt man die Angabe eines Wertes, verwendet man die Option also
@@ -188,7 +197,9 @@ angenommen.
Manche Optionen können gleichzeitig mehrere Werte besitzen. Für solche
Optionen besteht die Möglichkeit, mit \Macro{KOMAoption} der einen
\PName{Option} nacheinander eine Reihe von Werten zuzuweisen. Die einzelnen
-Werte sind dabei in der \PName{Werteliste} durch Komma voneinander getrennt.
+Werte sind dabei in der
+\PName{Werteliste}\important{\PName{Wert},\dots} durch Komma
+voneinander getrennt.
Soll\textnote{Achtung!} ein \PName{Wert} ein Gleichheitszeichen oder ein Komma
enthalten, so ist der \PName{Wert} in geschweifte Klammern zu setzen.
@@ -197,23 +208,32 @@ enthalten, so ist der \PName{Wert} in geschweifte Klammern zu setzen.
\KOMAScript{} bedient sich für die Realisierung dieser Möglichkeit der
Anweisungen \DescRef{scrbase.cmd.FamilyOptions} und
\DescRef{scrbase.cmd.FamilyOption} mit der Familie »\PValue{KOMA}«.
-\iffalse % Umbruchkorrektur
- Näheres zu diesen Anweisungen ist %
- \IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{für Experten }{}%
- in \autoref{sec:scrbase.keyvalue},
- \DescPageRef{scrbase.cmd.FamilyOptions} zu finden. \else
- %
- Siehe dazu \autoref{part:forExperts}, \autoref{sec:scrbase.keyvalue},
- \DescPageRef{scrbase.cmd.FamilyOptions}.
- %
-\fi
-\end{Explain}%
+ \IfThisCommonLabelBaseOneOf{typearea}{% Umbruchkorrektur
+ Näheres zu diesen Anweisungen finden fortgeschrittene Anwender in
+ \autoref{sec:scrbase.keyvalue} ab \DescPageRef{scrbase.cmd.FamilyOptions}.
+ }{%
+ Siehe dazu \autoref{part:forExperts}, \autoref{sec:scrbase.keyvalue},
+ ab \DescPageRef{scrbase.cmd.FamilyOptions}.
+ }%
+\end{Explain}
+
+Mit \Macro{KOMAoptions} oder \Macro{KOMAoption} gesetzte Optionen erreichen
+\IfThisCommonLabelBase{scrextend}{}{sowohl die \KOMAScript-Klasse als }auch
+alle bereits geladenen \KOMAScript-Pakete, die diese Optionen kennen. Ist eine
+Option oder ein Wert insgesamt unbekannt, so wird die Option einschließlich
+des Wertes von
+\hyperref[cha:scrbase]{\Package{scrbase}}\IndexPackage{scrbase}%
+\important{\hyperref[cha:scrbase]{\Package{scrbase}}} als fehlerhaft
+gemeldet.%
+%
+\iffalse% Umbruchkorrekturtext
\iffree{}{\IfThisCommonLabelBase{scrlayer-scrpage}{\par
Das als veraltet zu betrachtende Paket
\Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}
besitzt diese Erweiterung übrigens nicht. Optionen können daher nur über
die zuvor erklärte Möglichkeit während des Ladens des Pakets gesetzt
werden.}{}}%
+\fi%
\EndIndexGroup
%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-pagestylemanipulation.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-pagestylemanipulation.tex
index 577094beabc..f4814b72839 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-pagestylemanipulation.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-pagestylemanipulation.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-pagestylemanipulation.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-pagestylemanipulation.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,33 +46,41 @@
% ============================================================================
\KOMAProvidesFile{common-pagestylemanipulation.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-02-05 10:50:56 +0100 (Mon, 05 Feb 2018) $
KOMA-Script guide (common paragraph:
Setting up defined page styles)]
-\section{Beeinflussung von definierten Seitenstilen}
+\section{Beeinflussung von Seitenstilen}
\seclabel{pagestyle.content}
\BeginIndexGroup
\BeginIndex{}{Seiten>Stil}
\IfThisCommonLabelBase{scrlayer}{%
Obwohl \Package{scrlayer} selbst keine konkreten Seitenstile mit Inhalt
- definiert -- die erwähnten Seitenstile \PageStyle{@everystyle@} und
- \PageStyle{empty} werden ja zunächst ohne Ebenen, also leer definiert --,
- stellt es einige Optionen und Befehle zur Beeinflussung von Inhalten zur
- Verfügung.%
+ definiert -- die erwähnten Seitenstile
+ \DescRef{\LabelBase.pagestyle.@everystyle@} und \PageStyle{empty} werden ja
+ zunächst ohne Ebenen, also leer definiert --, stellt es einige Optionen und
+ Befehle zur Beeinflussung von Inhalten zur Verfügung.%
}{%
\IfThisCommonLabelBase{scrlayer-scrpage}{%
In \autoref{sec:scrlayer-scrpage.predefined.pagestyles} wurde erklärt, wie
- die Seitenstile \PageStyle{scrheadings} und \PageStyle{plain.scrheadings}
- grundlegend vordefiniert sind und wie diese Vorbelegung grundsätzlich
- geändert werden kann. Es fehlen jedoch noch Informationen, wie
- beispielsweise die Kolumnentitel zustande kommen, wie man die Breite des
- Kopfes und Fußes verändern kann und wie man Linien über oder unter Kopf
- oder Fuß setzen kann. Obwohl dies eigentlich Fähigkeiten des Pakets
- \Package{scrlayer} sind, werden sie nachfolgend erläutert, da diese
- grundlegenden Eigenschaften von \Package{scrlayer} einen wichtigen Teil
- der Möglichkeiten von \Package{scrlayer-scrpage} ausmachen.%
+ die Seitenstile \DescRef{\LabelBase.pagestyle.scrheadings} und
+ \DescRef{\LabelBase.pagestyle.plain.scrheadings} grundlegend vordefiniert
+ sind und wie diese Vorbelegung grundsätzlich geändert werden kann. Es
+ fehlen jedoch noch Informationen, wie beispielsweise die Kolumnentitel
+ zustande kommen, wie man die Breite des Kopfes und Fußes verändern kann
+ und wie man Linien über oder unter Kopf oder Fuß setzen kann. Obwohl dies
+ eigentlich Fähigkeiten des Pakets
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ \important{\hyperref[cha:scrlayer]{\Package{scrlayer}}}
+ sind, werden sie nachfolgend
+ erläutert, da diese grundlegenden Eigenschaften von
+ \hyperref[cha:scrlayer]{\Package{scrlayer}} einen wichtigen Teil der
+ Möglichkeiten von \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \Package{scrlayer-scrpage}%
+ }{%
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ } ausmachen.%
}{%
\IfThisCommonLabelBase{scrlayer-scrpage-experts}{%
Dieser Abschnitt ist als Ergänzung zu
@@ -86,13 +94,10 @@
\csname iftrue\endcsname}%
\begin{Declaration}
\Macro{automark}\OParameter{Gliederungsebene der rechten Marke}
- \Parameter{Gliederungsebene der linken Marke}
+ \Parameter{\mbox{Gliederungsebene der linken Marke}}
\Macro{automark*}\OParameter{Gliederungsebene der rechten Marke}
\Parameter{Gliederungsebene der linken Marke}
\Macro{manualmark}
- \Option{automark}
- \OptionVName{autooneside}{Ein-Aus-Wert}
- \Option{manualmark}
\end{Declaration}
\IfThisCommonLabelBase{scrlayer-scrpage}{%
\begin{Explain}
@@ -101,25 +106,26 @@
Kolumnentiteln\Index{Kolumnentitel>lebend}\Index{Kolumnentitel>statisch}
gearbeitet werden soll, über die Wahl des entsprechenden
Seitenstils. Wie bereits in \autoref{sec:maincls.pagestyle} erklärt,
- erhält man bei Wahl von \PageStyle{headings}\IndexPagestyle{headings}%
- \important{\PageStyle{headings}} lebende Kolumnentitel. Unter lebenden
- Kolumnentiteln versteht man die Wiederholung eines für die Seite oder
- die \emph{Kolumne} markanten Textes meist im Kopf, seltener im Fuß der
- Seite.
+ erhält man bei Wahl von
+ \DescRef{maincls.pagestyle.headings}\IndexPagestyle{headings}%
+ \important{\DescRef{maincls.pagestyle.headings}} lebende
+ Kolumnentitel. Unter lebenden Kolumnentiteln versteht man die
+ Wiederholung eines für die Seite oder die \emph{Kolumne} markanten
+ Textes meist im Kopf, seltener im Fuß der Seite.
Bei den Artikel-Klassen\OnlyAt{\Class{article}\and \Class{scrartcl}}
- \Class{article} oder \Class{scrartcl} wird für den lebenden
- Kolumnentitel\textnote{lebende Kolumnentitel} im einseitigen Modus die
- Abschnittsüberschrift, also das obligatorische oder das optionale
- Argument von \DescRef{maincls.cmd.section} verwendet. Diese wird als
- \emph{rechte Marke} behandelt. Im doppelseitigen Satz wird dieselbe
- Überschrift als \emph{linke Marke} verwendet und gleichzeitig die
- Unterabschnittsüberschrift als \emph{rechte Marke}. Ausgegeben wird die
- linke Marke wie der Name schon sagt auf der linken Seite, während die
- rechte Marke auf rechten Seiten -- im einseitigen Modus also auf allen
- Seiten -- ausgegeben wird. Beim Setzen der linken Marke für den
- Abschnitt werden von den Klassen in der Voreinstellung außerdem auch
- immer die rechten Marken gelöscht.
+ \Class{article} oder \hyperref[cha:maincls]{\Class{scrartcl}} wird für
+ den lebenden Kolumnentitel\textnote{lebende Kolumnentitel} im
+ einseitigen Modus die Abschnittsüberschrift, also das obligatorische
+ oder das optionale Argument von \DescRef{maincls.cmd.section}
+ verwendet. Diese wird als \emph{rechte Marke} behandelt. Im
+ doppelseitigen Satz wird dieselbe Überschrift als \emph{linke Marke}
+ verwendet und gleichzeitig die Unterabschnittsüberschrift als
+ \emph{rechte Marke}. Ausgegeben wird die linke Marke, wie der Name schon
+ sagt, auf der linken Seite, während die rechte Marke auf rechten Seiten
+ -- im einseitigen Modus also auf allen Seiten -- ausgegeben wird. Beim
+ Setzen der linken Marke für den Abschnitt werden von den Klassen in der
+ Voreinstellung außerdem auch immer die rechten Marken gelöscht.
Bei den Bericht- und Buch-Klassen\OnlyAt{\Class{report}\and
\Class{scrreprt}\and \Class{book}\and \Class{scrbook}} wird eine Ebene
@@ -129,14 +135,15 @@
rechte Marke gesetzt.
Verwendet man hingegen als Seitenstil
- \PageStyle{myheadings}\IndexPagestyle{myheadings}%
- \important{\PageStyle{myheadings}}\textnote{manuelle Kolumnentitel}, so
+ \DescRef{maincls.pagestyle.myheadings}\IndexPagestyle{myheadings}%
+ \important{\DescRef{maincls.pagestyle.myheadings}}%
+ \textnote{manuelle Kolumnentitel}, so
existieren zwar die Marken im Kopf genauso und auch die Seitenzahlen
werden gleich platziert, allerdings werden die Marken nicht automatisch
durch die Überschriften gesetzt. Man kann sie dann nur
manuell\important{%
\DescRef{\ThisCommonLabelBase.cmd.markright}\\
- \DescRef{\ThisCommonLabelBase.cmd.markboth}}%
+ \DescRef{\ThisCommonLabelBase.cmd.markboth}}
über die später in diesem Abschnitt dokumentierten Anweisungen
\DescRef{\ThisCommonLabelBase.cmd.markright} und
\DescRef{\ThisCommonLabelBase.cmd.markboth} befüllen.
@@ -148,8 +155,10 @@
Kolumnentitel automatisch oder manuell erzeugt werden. %
}{\InternalCommonFileUsageError}%
}%
- Genau diese Unterscheidung wurde bei \Package{scrpage2} und nun auch bei
- \Package{scrlayer} aufgehoben. Statt die Unterscheidung zwischen
+ Genau diese Unterscheidung wurde bei %
+ \iffalse \Package{scrpage2} und nun auch bei \fi%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}\IndexPackage{scrlayer}
+ aufgehoben. Statt die Unterscheidung zwischen
automatischen\textnote{lebende und manuelle Kolumnentitel} und manuellen
Kolumnentiteln über den Seitenstil vorzunehmen, gibt es die beiden
Anweisungen \Macro{automark} und \Macro{manualmark}.
@@ -171,7 +180,8 @@
Konvention ist jedoch keine Pflicht, sondern lediglich sinnvoll.
Es ist zu beachten\textnote{Achtung!}, dass nicht alle Klassen Kolumnentitel
- für alle Ebenen ermöglichen. So setzen die Standardklassen beispielsweise
+ für alle Ebenen ermöglichen. So setzen die
+ Standardklassen\textnote{\KOMAScript{} vs. Standardklassen} beispielsweise
nie Kolumnentitel für \DescRef{maincls.cmd.part}. Die \KOMAScript-Klassen
unterstützen hingegen alle Ebenen.
@@ -179,17 +189,20 @@
\Macro{automark*}\important{\Macro{automark*}} liegt darin, dass
\Macro{automark} alle vorherigen Befehle zum automatischen Setzen der Marken
aufhebt, während die Stern-Version \Macro{automark*} lediglich die Aktionen
- für die angegebenen Gliederungsebenen ändert. Man kann so auch relativ
- komplexe Fälle abdecken.%
+ für die angegebenen Gliederungsebenen ändert.%
+ \IfThisCommonLabelBase{scrlayer-scrpage}{}{ Man kann so auch relativ
+ komplexe Fälle abdecken.}% Umbruchoptimierung
\IfThisCommonLabelBase{scrlayer-scrpage}{\iftrue}{\csname
iffalse\endcsname}%
- \iffree{}{\par
- Das veraltete Paket
- \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}
- kennt sowohl \Macro{manualmark} als auch \Macro{automark}, jedoch nicht
- \Macro{automark*}. Daher sind die nachfolgenden Beispielen nicht
- vollständig auf die Verwendung von \Package{scrpage2} übertragbar.%
- }%
+ \iffalse% Umbruchkorrekturtext
+ \iffree{}{\par
+ Das veraltete Paket
+ \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}
+ kennt sowohl \Macro{manualmark} als auch \Macro{automark}, jedoch nicht
+ \Macro{automark*}. Daher sind die nachfolgenden Beispielen nicht
+ vollständig auf die Verwendung von \Package{scrpage2} übertragbar.%
+ }%
+ \fi
%
\begin{Example}
\phantomsection\xmpllabel{mark}%
@@ -198,9 +211,13 @@
werden und auf den rechten Seiten die
Abschnittsüberschriften. Allerdings soll auf rechte Seiten so lange
ebenfalls die Kapitelüberschrift verwendet werden, bis der erste
- Abschnitt auftaucht. Dazu wird zuerst \Package{scrlayer-scrpage} geladen
- und der Seitenstil \PageStyle{scrheadings} aktiviert. Das Dokument
- beginnt also mit:
+ Abschnitt auf"|taucht. Dazu wird zuerst
+ \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \Package{scrlayer-scrpage}%
+ }{%
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ } geladen und der Seitenstil \DescRef{\LabelBase.pagestyle.scrheadings}
+ aktiviert. Das Dokument beginnt also mit:
\begin{lstcode}
\documentclass{scrbook}
\usepackage{scrlayer-scrpage}
@@ -237,34 +254,54 @@
Wenn Sie dieses Beispiel einmal testen, werden Sie sehen, dass die
Kapitelanfangsseite wie üblich ohne Kolumnentitel ist, da sie
automatisch im \PageStyle{plain}-Seitenstil
- \PageStyle{plain.scrheadings} gesetzt wird. Seite~2 bis 4 tragen als
+ \DescRef{\LabelBase.pagestyle.plain.scrheadings} gesetzt wird (siehe
+ dazu Anweisung \DescRef{maincls.cmd.chapterpagestyle} auf
+ \DescPageRef{maincls.cmd.chapterpagestyle}). Seite~2 bis 4 tragen als
Kolumnentitel die Kapitelüberschrift. Nachdem auf Seite~4 eine
Abschnittsüberschrift ausgegeben wurde, ändert sich der Kolumnentitel
auf Seite~5 in die Abschnittsüberschrift. Ab dann werden die beiden
Überschriften im Kopf wechselweise ausgegeben, auf linken Seiten die
- Kapitelüberschrift, auf rechten Seiten die Abschnittsüberschrift.
+ Kapitelüberschrift, auf rechten Seiten die Abschnittsüberschrift.%
\end{Example}
\fi
- Außer mit den Befehlen kann auch direkt mit den beiden Optionen
+ \begin{Declaration}
+ \Option{automark}
+ \OptionVName{autooneside}{Ein-Aus-Wert}
+ \Option{manualmark}
+ \end{Declaration}
+ Außer mit den zuvor erklärten Befehlen kann auch direkt mit den beiden
+ Optionen
\Option{manualmark}\important{\Option{manualmark}\\\Option{automark}} und
\Option{automark} zwischen automatischen und manuellen Kolumnentiteln hin-
und hergeschaltet werden. Dabei verwendet \Option{automark} bei Klassen mit
- \DescRef{maincls.cmd.chapter}-Anweisung immer die Voreinstellung
+ \DescRef{maincls.cmd.chapter}-Anweisung immer die
+ Voreinstellung\textnote{Voreinstellung}
+ \IfThisCommonLabelBase{scrlayer-scrpage}{\iftrue}{\csname
+ iffalse\endcsname}%
+ \lstinline|\automark[section]{chapter}| und bei anderen Klassen
+ \lstinline|\automark[subsection]{section}|.
+ \else
\begin{lstcode}
\automark[section]{chapter}
\end{lstcode}
- und bei anderen Klassen
+ und bei anderen Klassen:
\begin{lstcode}
\automark[subsection]{section}
\end{lstcode}
+ \fi
- Im einseitigen Modus\textnote{einseitiger Satz} will man in der Regel nicht,
- dass die untergeordnete Ebene die rechte Marke beeinflusst. Stattdessen soll
- auch mit der Voreinstellung nur die höhere Ebene, die beispielsweise im
- doppelseitigen Modus in der Voreinstellung alleine die linke Marke
- beeinflusst, den Kolumnentitel aller Seiten vorgeben. Diese Voreinstellung
- entspricht einer aktiven Option
+ \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ Im einseitigen Modus\textnote{einseitiger Satz} will man in der Regel,
+ dass nur die höheren Ebenen den Kolumnentitel vorgeben.%
+ }{%
+ Im einseitigen Modus\textnote{einseitiger Satz} will man in der Regel
+ nicht, dass die untergeordnete Ebene die rechte Marke
+ beeinflusst. Stattdessen soll auch mit der Voreinstellung nur die höhere
+ Ebene, die beispielsweise im doppelseitigen Modus in der Voreinstellung
+ alleine die linke Marke beeinflusst, den Kolumnentitel aller Seiten
+ vorgeben.%
+ } Diese Voreinstellung entspricht einer aktiven Option
\Option{autooneside}\important{\Option{autooneside}}. Die Option versteht
die Werte für einfache Schalter, die in \autoref{tab:truefalseswitch} auf
\autopageref{tab:truefalseswitch} angegeben sind. Wird die Option
@@ -275,7 +312,7 @@
\begin{Example}
\phantomsection\xmpllabel{mark.oneside}%
Angenommen, Sie wollen im einseitigen Modus eines Berichts eine ganz
- ähnliche Verwendung des Kolumnentitels erreichen, wie im vorherigen
+ ähnliche Verwendung des Kolumnentitels erreichen wie im vorherigen
Beispiel. Konkret soll so lange die Kapitelüberschrift verwendet werden,
bis ein Abschnitt gesetzt wird. Ab dann soll nur noch die
Abschnittsüberschrift verwendet werden. Dazu wird das Beispiel wie folgt
@@ -294,26 +331,32 @@
\end{document}
\end{lstcode}
Wie zu sehen ist, wird in diesem Fall keine ergänzende
- \Macro{automark*}-Anweisung benötigt. Sie sollten zum Vergleich die
- Option \Option{autooneside} auch einmal auf \PValue{true} setzen oder
- sie entfernen. Ein Unterschied ist dann ab Seite~4 im Kolumnentitel im
- Kopf der Seiten zu sehen.
+ \DescRef{\LabelBase.cmd.automark*}-Anweisung benötigt. Sie sollten zum
+ Vergleich die Option \Option{autooneside} auch einmal auf \PValue{true}
+ setzen oder sie entfernen. Ein Unterschied ist dann ab Seite~4 im
+ Kolumnentitel im Kopf der Seiten zu sehen.
\end{Example}
\fi
Das\textnote{Achtung!} Laden des Pakets selbst hat übrigens noch keine
Auswirkung darauf, ob mit automatischen Kolumnentiteln gearbeitet wird oder
nicht. Erst die explizite Verwendung einer der Optionen \Option{automark}
- oder \Option{manualmark} oder einer der beiden Anweisungen \Macro{automark}
- oder \Macro{manualmark} schafft hier klare Verhältnisse.%
+ oder \Option{manualmark} oder einer der beiden Anweisungen
+ \DescRef{\LabelBase.cmd.automark} oder \DescRef{\LabelBase.cmd.manualmark}
+ schafft hier klare Verhältnisse.%
\IfThisCommonLabelBase{scrlayer-scrpage}{\par%
Bei Bedarf finden Sie weitere Hintergründe und Beispiele zur Verwendung
dieser Befehle und Optionen mit dem auf \Package{scrlayer} basierenden
- Paket \Package{scrlayer-scrpage} in
+ Paket \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \Package{scrlayer-scrpage}%
+ }{%
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ } in
\autoref{sec:scrlayer-scrpage.pagestyle.content}, ab
\DescPageRef{scrlayer-scrpage.cmd.manualmark}.%
}{}%
\EndIndexGroup
+ \EndIndexGroup
\begin{Declaration}
@@ -321,10 +364,13 @@
\end{Declaration}
Die \KOMAScript-Option versteht die Standardwerte für einfache Schalter, die
in \autoref{tab:truefalseswitch} auf \autopageref{tab:truefalseswitch}
- angegeben sind. Ist die Option aktiviert, so werden alle Elemente der
- Seitenstile zusätzlich mit Maßlinien versehen. Dies kann während der
- Entwurfsphase manchmal nützlich sein.%
- \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ angegeben sind. Ist die Option aktiviert, so werden
+ \IfThisCommonLabelBase{scrlayer}{für die Entwurfsphase}{\unskip} alle
+ Elemente der Seitenstile zusätzlich mit
+ Maßlinien\Index{Masslinien=Maßlinien}
+ versehen. \IfThisCommonLabelBase{scrlayer}{\unskip}{Dies kann während der
+ Entwurfsphase manchmal nützlich sein.}%
+ \IfThisCommonLabelBase{scrlayer-scrpage}{ %
Falls diese Option global gesetzt wurde, die Maßlinien aber nicht
gewünscht sind, kann die Option auch nur für das Paket deaktiviert werden,
indem man \OptionValue{draft}{false} als optionales Argument von
@@ -338,10 +384,14 @@
\end{Declaration}
Die automatischen, nicht jedoch die manuellen Kolumnentitel verwenden
\Macro{MakeMarkcase} für ihre Ausgabe. Ist die Anweisung beim Laden von
- \Package{scrlayer} nicht definiert, so wird sie in der Voreinstellung derart
- definiert, dass sie ihr Argument \PName{Text} unverändert ausgibt. Diese
- Voreinstellung kann jedoch entweder durch Umdefinierung von
- \Macro{MakeMarkcase} oder durch die nachfolgend
+ \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } nicht\textnote{bedingte Voreinstellung} definiert, so wird sie in der
+ Voreinstellung derart definiert, dass sie ihr Argument \PName{Text}
+ unverändert ausgibt. Diese Voreinstellung kann jedoch entweder durch
+ Umdefinierung von \Macro{MakeMarkcase} oder durch die nachfolgend
dokumentierte Option \DescRef{\LabelBase.option.markcase}%
\IndexOption{markcase}\important{\DescRef{\LabelBase.option.markcase}}
geändert werden. Je nach Einstellung wird das Argument dann beispielsweise
@@ -353,29 +403,45 @@
\begin{Declaration}
\OptionVName{markcase}{Wert}
\end{Declaration}
- Wie bereits früher erläutert, kann man bei \Package{scrlayer} zwischen
- manuellen und automatischen Kolumnentiteln wählen. Bei den automatischen
- Kolumnentiteln werden dabei die entsprechenden Marken über die
+ Wie bereits früher erläutert, kann man bei
+ \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } zwischen manuellen und automatischen Kolumnentiteln wählen. Bei den
+ automatischen Kolumnentiteln werden dabei die entsprechenden Marken über die
Gliederungsbefehle gesetzt. In manchen Kulturkreisen ist es im Gegensatz zur
Typografie des deutschsprachigen Raums üblich, die Kolumnentitel in
Großbuchstaben zu setzen. Die Standardklassen machen genau dies in der
- Voreinstellung. Das Paket \Package{scrlayer} unterstützt das optional
- ebenfalls. Hierzu gibt man als Option
+ Voreinstellung. Das Paket \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } unterstützt das optional ebenfalls. Hierzu gibt man als Option
\OptionValue{markcase}{upper}\important{\OptionValue{markcase}{upper}}%
\IndexOption[indexmain]{markcase~=upper} an. Im Endeffekt führt das zu einer
Umdefinierung von
- \DescRef{scrlayer.cmd.MakeMarkcase}\IndexCmd[indexmain]{MakeMarkcase}, einer
- Anweisung, die von \Package{scrlayer} beim Setzen von automatischen
- Kolumnentiteln verwendet wird.
-
- Leider führt die von \LaTeX{} für derartigen Versalsatz\Index{Versalsatz}
- vorgesehene Anweisung \Macro{MakeUppercase}\IndexCmd{MakeUppercase} zu einem
- sehr unzureichenden Satz, da weder gesperrt noch ausgeglichen wird. Dies
- liegt teilweise sicher daran, dass für typografisch korrekten Versalsatz
- eine Glyphenanalyse notwendig ist, um die konkrete Form der Buchstaben und
- ihrer Kombinationen in den Ausgleich der Sperrung einfließen zu lassen. Der
- \KOMAScript-Autor empfiehlt daher, auf Versalsatz für die Kolumnentitel zu
- verzichten. Dies ist normalerweise mit
+ \DescRef{\ThisCommonLabelBase.cmd.MakeMarkcase}%
+ \IndexCmd[indexmain]{MakeMarkcase}.
+
+ \IfThisCommonLabelBase{scrlayer}{%
+ Aufgrund der mangelnden typografischen Qualität der primitiven Umwandlung
+ in Großbuchstaben (siehe die Erklärung zu
+ \DescRef{scrlayer-scrpage.option.markcase} in
+ \autoref{sec:scrlayer-scrpage.pagestyle.content} auf
+ \autopageref{expl:scrlayer-scrpage.MakeUppercase}) empfiehlt der
+ \KOMAScript-Autor den Verzicht auf Versalsatz.%
+ }{%
+ Leider\phantomsection\label{expl:\ThisCommonLabelBase.MakeUppercase}
+ führt die von \LaTeX{} für Versalsatz\Index{Versalsatz} vorgesehene
+ Anweisung \Macro{MakeUppercase}\IndexCmd{MakeUppercase} zu keinem guten
+ Ergebnis, da weder gesperrt noch ausgeglichen wird. Dies liegt teilweise
+ sicher daran, dass für typografisch korrekten Versalsatz eine
+ Glyphenanalyse notwendig ist, um die konkrete Form der Buchstaben\iffree{
+ und ihrer Kombinationen}{} in den Ausgleich der Sperrung einfließen zu
+ lassen. Der \KOMAScript-Autor empfiehlt daher, auf Versalsatz für die
+ Kolumnentitel zu verzichten.%
+ } Dies ist normalerweise mit
\OptionValue{markcase}{used}\important{\OptionValue{markcase}{used}}%
\IndexOption[indexmain]{markcase~=used} möglich. Allerdings fügen einige
Klassen selbst beispielsweise bei den Kolumnentitel für Verzeichnisse ein
@@ -442,19 +508,23 @@
Dementsprechend kann man mit \Macro{rightmark}\important{\Macro{rightmark}}
die rechte Marke platzieren, die dann bei der Ausgabe der Seite durch den
- entsprechenden Inhalt ersetzt wird. Für einige Feinheiten dabei, sei auch
+ entsprechenden Inhalt ersetzt wird. Für einige Feinheiten dabei sei auch
auf die weiterführenden Erklärungen zu
\DescRef{maincls-experts.cmd.rightmark} in
\autoref{sec:maincls-experts.addInfos},
\DescPageRef{maincls-experts.cmd.rightmark} verwiesen.
Mit \Macro{headmark}\important{\Macro{headmark}} kann man sich das Leben
- erleichtern. Diese Erweiterung von \Package{scrlayer} entspricht je nachdem,
- ob die aktuelle Seite eine linke oder rechte ist, \Macro{leftmark} oder
- \Macro{rightmark}.
+ erleichtern. Diese Erweiterung von
+ \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } entspricht je nachdem, ob die aktuelle Seite eine linke oder rechte ist,
+ \Macro{leftmark} oder \Macro{rightmark}.
Die Anweisung \Macro{pagemark}\important{\Macro{pagemark}} hat genau
- genommen nichts mit den Marken von \TeX{} zu tun. Sie dient dazu eine
+ genommen nichts mit den Marken von \TeX{} zu tun. Sie dient dazu, eine
formatierte Seitenzahl zu platzieren.
\BeginIndex{FontElement}{pagenumber}\LabelFontElement{pagenumber}%
Bei ihrer Ausgabe wird dann auch die Schrifteinstellung für das Element
@@ -467,8 +537,16 @@
\IfThisCommonLabelBase{scrlayer-scrpage}{\iftrue}{%
\par%
Bei Bedarf finden Sie ein Beispiel zur Verwendung der Anweisungen
- \Macro{headmark} und \Macro{pagemark} mit dem auf \Package{scrlayer}
- basierenden Paket \Package{scrlayer-scrpage} in
+ \Macro{headmark} und \Macro{pagemark} mit dem auf
+ \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ }{%
+ \Package{scrlayer}%
+ } basierenden Paket \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \Package{scrlayer-scrpage}%
+ }{%
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ } in
\autoref{sec:scrlayer-scrpage.pagestyle.content}, ab
\PageRefxmpl{scrlayer-scrpage.headmark}.%
\csname iffalse\endcsname}%
@@ -484,7 +562,7 @@
\usepackage[automark]{scrlayer-scrpage}
\pagestyle{scrheadings}
\ihead{\headmark}
- \ohead[\pagemark]{\pagemark}
+ \ohead*{\pagemark}
\chead{}
\cfoot[]{}
\begin{document}
@@ -495,18 +573,23 @@
Anweisung \Macro{blinddocument}\IndexCmd{blinddocument} wird hier für
die komfortable Erzeugung eines Beispieldokumentinhalts verwendet.
- Mit den Anweisungen
- \DescRef{scrlayer-scrpage.cmd.ihead}\IndexCmd{ihead} und
- \DescRef{scrlayer-scrpage.cmd.ohead}\IndexCmd{ohead} werden die
- gewünschten Marken platziert. Dabei wird die Seitenzahl-Marke mit Hilfe
- des optionalen Argument von \DescRef{scrlayer-scrpage.cmd.ohead} nicht
- nur auf den mit \PageStyle{scrheadings}\IndexPagestyle{scrheadings}
- gesetzten Seiten, sondern auch für den auf der ersten Seite automatisch
- verwendeten \PageStyle{plain}-Seitenstil
- \PageStyle{plain.scrheadings}\IndexPagestyle{plain.scrheadings}
- konfiguriert.
-
- Da die beiden Seitenstile bereits mit Marken in der Mitte von Kopf und
+ Mit den Anweisungen \DescRef{scrlayer-scrpage.cmd.ihead}\IndexCmd{ihead}
+ und \DescRef{scrlayer-scrpage.cmd.ohead*}\IndexCmd{ohead*} werden die
+ gewünschten Marken platziert. Dabei wird die
+ Seitenzahl\iffalse-Marke\fi{} durch die Sternform
+ \DescRef{scrlayer-scrpage.cmd.ohead*} %
+ \iffalse% Umbruchvarianten
+ nicht nur auf den mit
+ \DescRef{\LabelBase.pagestyle.scrheadings}\IndexPagestyle{scrheadings}
+ gesetzten Seiten, sondern auch für den auf Kapitelanfangsseiten
+ automatisch verwendeten \PageStyle{plain}-Seitenstil %
+ \else%
+ auch für den auf Kapitelanfangsseiten verwendeten Seitenstil %
+ \fi%
+ \DescRef{\LabelBase.pagestyle.plain.scrheadings}%
+ \IndexPagestyle{plain.scrheadings} konfiguriert.%
+
+ Da die Seitenstile bereits mit Marken in der Mitte von Kopf oder
Fuß vordefiniert sind, werden diese beiden Elemente mit
\DescRef{scrlayer-scrpage.cmd.chead} und
\DescRef{scrlayer-scrpage.cmd.cfoot} gelöscht. Hierzu werden leere
@@ -526,15 +609,25 @@
selbst ausprobieren und dabei den Fuß der ersten Seite beobachten.%
\fi
- Sollten die hier vorgestellten Möglichkeiten für Marken einmal nicht
- ausreichen, so sind für fortgeschrittene Anwender ab
- \IfThisCommonLabelBase{scrlayer-scrpage}{%
- \DescPageRef{scrlayer-scrpage-experts.cmd.righttopmark}}{%
- \DescPageRef{\ThisCommonLabelBase.cmd.righttopmark}} weitere
- Anweisungen dokumentiert. Beispielsweise ist für lexikonartige Dokumente das
- dort erklärte \DescRef{scrlayer-scrpage-experts.cmd.leftfirstmark} und
+ \IfThisCommonLabelBase{scrlayer-scrpage}{% Umbruchvarianten
+ Fortgeschrittene Anwender finden ab
+ \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \DescPageRef{scrlayer-scrpage-experts.cmd.righttopmark}}{%
+ \DescPageRef{\ThisCommonLabelBase.cmd.righttopmark}} weitere
+ Marken-Anweisungen.%
+ }{%
+ Sollten die hier vorgestellten Möglichkeiten für Marken einmal nicht
+ ausreichen, so sind für fortgeschrittene Anwender ab
+ \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \DescPageRef{scrlayer-scrpage-experts.cmd.righttopmark}}{%
+ \DescPageRef{\ThisCommonLabelBase.cmd.righttopmark}} weitere Anweisungen
+ dokumentiert.%
+ }%
+ \iffalse% Umbruchkorrektur
+ \ Beispielsweise ist für lexikonartige Dokumente das dort erklärte
+ \DescRef{scrlayer-scrpage-experts.cmd.leftfirstmark} und
\DescRef{scrlayer-scrpage-experts.cmd.rightbotmark} recht nützlich.%
- \EndIndexGroup
+ \fi \EndIndexGroup
\begin{Declaration}
@@ -547,25 +640,35 @@
\Macro{subparagraphmarkformat}
\end{Declaration}
Diese Anweisungen werden von den \KOMAScript-Klassen und auch von
- \Package{scrlayer} intern üblicherweise verwendet, um die Gliederungsnummern
- der automatischen Kolumnentitel zu formatieren. Dabei wird auch der
+ \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } intern üblicherweise verwendet, um die Gliederungsnummern der
+ automatischen Kolumnentitel zu formatieren. Dabei wird auch der
\DescRef{maincls.cmd.autodot}-Mechanismus der \KOMAScript-Klassen
unterstützt. Bei Bedarf können diese Anweisungen umdefiniert werden, um eine
andere Formatierung der Nummern zu erreichen.%
\IfThisCommonLabelBase{scrlayer-scrpage}{\iftrue}{%
\ Siehe dazu gegebenenfalls das Beispiel in
- \autoref{sec:scrlayer-scrpage.pagestyle.content},
- auf \PageRefxmpl{scrlayer-scrpage.cmd.sectionmarkformat}.%
+ \autoref{sec:scrlayer-scrpage.pagestyle.content}, auf
+ \PageRefxmpl{scrlayer-scrpage.cmd.sectionmarkformat}.%
\csname iffalse\endcsname%
}%
\begin{Example}
\phantomsection\xmpllabel{cmd.sectionmarkformat}%
+ \iftrue
+ Wollen Sie auf Abschnittsebene Kolumnentitel ohne Gliederungsnummer,
+ geht das beispielsweise so:
+ \else
Angenommen, Sie wollen, dass Abschnittsüberschriften im Kolumnentitel
- ohne Gliederungsnummer gesetzt werden, so ist das ganz einfach mit:
-\begin{lstcode}
+ ohne Gliederungsnummer gesetzt werden, \iffree{so}{dann} ist das ganz
+ einfach \iffree{mit:}{so zu erreichen:}
+ \fi
+\begin{lstcode}[belowskip=-\dp\strutbox]
\renewcommand*{\sectionmarkformat}{}
\end{lstcode}
- zu erreichen.
+ \iffree{zu erreichen.}{}%
\end{Example}%
\fi
%
@@ -588,9 +691,16 @@
mit nummerierten Überschriften gearbeitet wird.
Allerdings\textnote{Achtung!} verwenden nicht alle Klassen in allen
- Gliederungsebenen eine solche Anweisung. So wird beispielsweise
- \Macro{partmark} von den Standardklassen nie aufgerufen, während die
- \KOMAScript-Klassen selbstverständlich auch \Macro{partmark} unterstützen.
+ Gliederungsebenen eine solche Anweisung. %
+ \IfThisCommonLabelBase{scrlayer-scrpage}{% Umbruchvarianten
+ Beispielsweise rufen die Standardklassen\textnote{\KOMAScript{}
+ vs. Standardklassen} \Macro{partmark} bei \Macro{part} nicht auf.%
+ }{%
+ So wird beispielsweise \Macro{partmark} von den
+ Standardklassen\textnote{\KOMAScript{} vs. Standardklassen} nie
+ aufgerufen, während die \KOMAScript-Klassen selbstverständlich auch
+ \Macro{partmark} unterstützen.%
+ }
Falls diese Anweisungen vom Anwender umdefiniert werden, sollte
er\textnote{Achtung!} unbedingt darauf achten, vor dem Setzen der Nummer
@@ -600,11 +710,14 @@
und Klassen sich eventuell auf die Wirkung von
\DescRef{maincls.counter.secnumdepth} verlassen!
- Das Paket \Package{scrlayer} definiert diese Anweisungen außerdem bei jedem
- Aufruf von \DescRef{scrlayer.cmd.automark} oder
- \DescRef{scrlayer.cmd.manualmark} oder den entsprechenden Optionen teilweise
- neu, um so die gewünschten automatischen oder manuellen Kolumnentitel zu
- erreichen.%
+ Das Paket \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } definiert diese Anweisungen außerdem bei jedem Aufruf von
+ \DescRef{scrlayer.cmd.automark} oder \DescRef{scrlayer.cmd.manualmark} oder
+ den entsprechenden Optionen teilweise neu, um so die gewünschten
+ automatischen oder manuellen Kolumnentitel zu erreichen.%
\EndIndexGroup
@@ -624,7 +737,10 @@
auf der entsprechenden Seite gesetzte Marke ausgibt. Näheres dazu ist den
weiterführenden Erklärungen zu \DescRef{maincls-experts.cmd.rightmark} in
\autoref{sec:maincls-experts.addInfos},
- \DescPageRef{maincls-experts.cmd.rightmark} zu entnehmen.
+ \DescPageRef{maincls-experts.cmd.rightmark} oder zu
+ \DescRef{scrlayer.cmd.rightfirstmark}\IfThisCommonLabelBase{scrlayer}{}{ in
+ \autoref{sec:scrlayer.pagestyle.content}},
+ \DescPageRef{scrlayer.cmd.rightfirstmark} zu entnehmen.
Wird mit manuellen Kolumnentiteln\Index{Kolumnentitel>manuell} gearbeitet,
so bleiben die Marken gültig, bis sie durch erneute Verwendung der
@@ -637,15 +753,22 @@
diese Anweisungen nützlich sein.%
\IfThisCommonLabelBase{scrlayer-scrpage}{\iftrue}{%
\ Ausführliche Beispiele für die Verwendung von \Macro{markboth} mit dem
- von \Package{scrlayer} abgeleiteten Paket \Package{scrlayer-scrpage} sind
- in \autoref{sec:scrlayer-scrpage.pagestyle.content}, ab
+ von \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ }{%
+ \Package{scrlayer}%
+ } abgeleiteten Paket \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \Package{scrlayer-scrpage}%
+ }{%
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ } sind in \autoref{sec:scrlayer-scrpage.pagestyle.content}, ab
\PageRefxmpl{scrlayer-scrpage.cmd.markboth} zu finden.%
\csname iffalse\endcsname%
}%
\begin{Example}
\phantomsection\xmpllabel{cmd.markboth}%
Angenommen, Sie schreiben noch vor dem Inhaltsverzeichnis ein Vorwort
- über mehrere Seiten, das jedoch im Inhaltsverzeichnis nicht auftauchen
+ über mehrere Seiten, das jedoch im Inhaltsverzeichnis nicht auf"|tauchen
soll. Da Sie aber Trennlinien im Kopf verwenden, soll der Kolumnentitel
das Vorwort dennoch zeigen:
\begin{lstcode}
@@ -744,14 +867,20 @@
\par %
Ein ausführliches Beispiel für das Zusammenspiel der Anweisung
\Macro{GenericMarkFormat} mit den auf
- \DescPageRef{\ThisCommonLabelBase.cmd.chaptermark} erklärten
- Anweisungen \DescRef{\ThisCommonLabelBase.cmd.sectionmarkformat} und
+ \DescPageRef{\ThisCommonLabelBase.cmd.chaptermark} erklärten Anweisungen
+ \DescRef{\ThisCommonLabelBase.cmd.sectionmarkformat} und
\DescRef{\ThisCommonLabelBase.cmd.subsectionmarkformat} beziehungsweise
\DescRef{\ThisCommonLabelBase.cmd.chaptermarkformat} bei Verwendung des
- von \Package{scrlayer} abgeleiteten Pakets \Package{scrlayer-scrpage} ist
- in \autoref{sec:scrlayer-scrpage-experts.pagestyle.content}, ab
- \PageRefxmpl{scrlayer-scrpage-experts.cmd.GenericMarkFormat} zu
- finden.%
+ von \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } abgeleiteten Pakets \IfThisCommonLabelBase{scrlayer-scrpage}{%
+ \Package{scrlayer-scrpage}%
+ }{%
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ } ist in \autoref{sec:scrlayer-scrpage-experts.pagestyle.content}, ab
+ \PageRefxmpl{scrlayer-scrpage-experts.cmd.GenericMarkFormat} zu finden.%
\csname iffalse\endcsname}%
\begin{Example}
\phantomsection
@@ -765,7 +894,11 @@
\DescRef{scrlayer.cmd.sectionmarkformat}\\
\DescRef{scrlayer.cmd.subsectionmarkformat}} und
\DescRef{scrlayer.cmd.subsectionmarkformat}%
- \IndexCmd{subsectionmarkformat} von \Package{scrlayer} mit Hilfe von
+ \IndexCmd{subsectionmarkformat} von \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } mit Hilfe von
\Macro{GenericMarkFormat} definiert werden, genügt dafür die
entsprechende Umdefinierung dieser einen Anweisung:
\begin{lstcode}[moretexcs={colorbox,textcolor}]
@@ -801,7 +934,7 @@
\Macro{MakeUppercase}\IndexCmd{MakeUppercase}%
\important{\Macro{MakeUppercase}} für den Versalsatz der Kolumnentitel
nicht mehr die Farben »\texttt{black}« und »\texttt{white}«, sondern die
- Farben »\texttt{BLACK}« und »\texttt{WHITE}« verlangt werden, die gar
+ Farben »\texttt{BLACK}« und »\texttt{WHITE}« verlangt würden, die gar
nicht definiert sind. Alternativ könnte man \Macro{numberbox} auch mit
Hilfe von \Macro{DeclareRobustCommand*} statt mit \Macro{newcommand*}
definieren (siehe \cite{latex:clsguide}).
@@ -871,33 +1004,42 @@
verwendet wird. Im einseitigen Layout setzen die Gliederungsbefehle der
Standardklassen den linken Teil der Marke hingegen gar nicht erst.
- \TeX{} selbst kennt drei Möglichkeiten auf eine Marke zuzugreifen. Die
- \Macro{botmark} ist die auf der zuletzt zusammengestellten Seite zuletzt
- gültige Marke. Das entspricht der zuletzt gesetzten Marke der Seite. Wurde
- auf der Seite keine Marke gesetzt, so entspricht es der zuletzt gesetzten
- Marke auf den bereits ausgegebenen Seiten. Die \LaTeX-Anweisung
- \DescRef{scrlayer.cmd.leftmark} verwendet genau diese Marke, gibt also den
- linken Teil der letzten Marke der Seite aus. Dies entspricht auch genau
- \Macro{leftbotmark}. Im Vergleich dazu gibt \Macro{rightbotmark} den rechten
- Teil dieser Marke aus.
-
- \Macro{firstmark} ist die erste Marke der zuletzt zusammengestellten
- Seite. Das entspricht der ersten Marke, die auf der Seite gesetzt
- wurde. Wurde auf der Seite keine Marke gesetzt, so entspricht es der zuletzt
- gesetzten Marke auf den bereits ausgegebenen Seiten. Die \LaTeX-Anweisung
- \DescRef{scrlayer.cmd.rightmark} verwendet genau diese Marke, gibt also den
- rechten Teil der ersten Marke der Seite aus. Dies entspricht auch genau
- \Macro{rightfirstmark}. Im Vergleich dazu gibt \Macro{leftfirstmark} den
- linken Teil dieser Marke aus.
-
- \Macro{topmark} ist der Inhalt den \Macro{botmark} hatte, bevor die aktuelle
- Seite zusammengestellt wurde. \LaTeX{} verwendet dies selbst nie. Trotzdem
- bietet \Package{scrlayer} die Möglichkeit mit \Macro{lefttopmark} auf den
- linken Teil dieser Marke und mit \Macro{righttopmark} auf den rechten Teil
+ \TeX{} selbst kennt drei Möglichkeiten, auf eine Marke zuzugreifen. Die
+ \Macro{botmark}\IndexCmd{botmark}\important{\Macro{botmark}} ist die auf der
+ zuletzt zusammengestellten Seite zuletzt gültige Marke. Das entspricht der
+ zuletzt gesetzten Marke der Seite. Wurde auf der Seite keine Marke gesetzt,
+ so entspricht es der zuletzt gesetzten Marke auf den bereits ausgegebenen
+ Seiten. Die \LaTeX-Anweisung \DescRef{scrlayer.cmd.leftmark} verwendet genau
+ diese Marke, gibt also den linken Teil der letzten Marke der Seite aus. Dies
+ entspricht auch genau \Macro{leftbotmark}\important{\Macro{leftbotmark}}. Im
+ Vergleich dazu gibt \Macro{rightbotmark}\important{\Macro{rightbotmark}} den
+ rechten Teil dieser Marke aus.
+
+ \Macro{firstmark}\IndexCmd{firstmark}\important{\Macro{firstmark}} ist die
+ erste Marke der zuletzt zusammengestellten Seite. Das entspricht der ersten
+ Marke, die auf der Seite gesetzt wurde. Wurde auf der Seite keine Marke
+ gesetzt, so entspricht es der zuletzt gesetzten Marke auf den bereits
+ ausgegebenen Seiten. Die \LaTeX-Anweisung \DescRef{scrlayer.cmd.rightmark}
+ verwendet genau diese Marke, gibt also den rechten Teil der ersten Marke der
+ Seite aus. Dies entspricht auch genau
+ \Macro{rightfirstmark}\important{\Macro{rightfirstmark}}. Im Vergleich dazu
+ gibt \Macro{leftfirstmark}\important{\Macro{leftfirstmark}} den linken Teil
+ dieser Marke aus.
+
+ \Macro{topmark}\IndexCmd{topmark}\important{\Macro{topmark}} ist der Inhalt,
+ den \Macro{botmark} hatte, bevor die aktuelle Seite zusammengestellt
+ wurde. \LaTeX{} verwendet dies selbst nie. Trotzdem bietet
+ \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } die Möglichkeit mit \Macro{lefttopmark}\important{\Macro{lefttopmark}} auf
+ den linken Teil dieser Marke und mit
+ \Macro{righttopmark}\important{\Macro{righttopmark}} auf den rechten Teil
zuzugreifen.
Es\textnote{Achtung!} ist zu beachten, dass der linke und rechte Teil der
- Marke immer nur gemeinsam gesetzt werden kann. Selbst, wenn man mit
+ Marke immer nur gemeinsam gesetzt werden kann. Selbst wenn man mit
\DescRef{scrlayer.cmd.markright}\IndexCmd{markright} nur den rechten Teil
verändert, wird der linke Teil (unverändert) mit gesetzt. Entsprechend
setzen im doppelseitigen Layout die höheren Gliederungsebenen beim
@@ -910,22 +1052,29 @@
\Macro{rightfirstmark} auf der Seite einer Kapitelüberschrift immer einen
leeren Wert zurück gibt, selbst wenn danach beispielsweise über
\DescRef{scrlayer.cmd.sectionmark} oder indirekt über
- \DescRef{maincls.cmd.section} ein neuer rechter Teil der Marke gesetzt
+ \DescRef{maincls.cmd.section} ein neuer rechter Teil
+ \IfThisCommonLabelBase{scrlayer-scrpage}{der Marke}{\unskip} gesetzt
wurde.
Bitte\textnote{Achtung!} beachten Sie, dass die Verwendung einer der hier
erklärten Anweisungen zur Ausgabe des linken oder rechten Teils der Marke
innerhalb einer Seite zu unerwarteten Ergebnissen führen kann. Sie sind
wirklich nur zur Verwendung im Kopf oder Fuß eines Seitenstils
- gedacht. Daher sollten sie bei \Package{scrlayer} immer Teil des Inhalts
+ gedacht. Daher sollten sie bei \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } immer Teil des Inhalts
einer Ebene sein. Dagegen spielt es keine Rolle, ob sie auf den Hintergrund
oder den Vordergrund beschränkt werden, da alle Ebenen erst nach der
Zusammenstellung der aktuellen Seite ausgegeben werden.
- Näheres zum Mark-Mechanismus von \TeX{} ist beispielsweise
+ Näheres zum Mark-Mechanismus \iffree{von \TeX{}}{\unskip} ist beispielsweise
\cite[Kapitel~23]{knuth:texbook} zu entnehmen. Das Thema ist dort als
- absolutes Expertenwissen markiert. Sollte Sie obige Erklärung also eher
- verwirrt haben, machen Sie sich bitte nichts daraus.%
+ absolutes Expertenwissen markiert.\IfThisCommonLabelBase{scrlayer}{
+ % Umbruchkorrektur
+ Sollte Sie obige Erklärung also eher
+ verwirrt haben, machen Sie sich bitte nichts daraus.}{}%
\EndIndexGroup
@@ -950,22 +1099,29 @@
Will man nun jedoch nur eine \PName{linke Marke} oder nur eine \PName{rechte
Marke} setzen, ohne die jeweils andere Marke zu verändern, so fehlen
- entsprechende Anweisungen. Das Paket \Package{scrlayer} selbst benötigt
- entsprechende Anweisungen beispielsweise im Rahmen der automatischen
- Kolumnentitel. Sind \Macro{@mkleft} zum Setzen nur der \PName{linken Marke},
- \Macro{@mkright} zum Setzen nur der \PName{rechten Marke} oder
- \Macro{@mkdouble} zum Setzen sowohl der rechten als auch der linken
- \PName{Marke} mit demselben Inhalt beim Laden von \Package{scrlayer} nicht
- definiert, so werden sie vom Paket selbst definiert. Dabei wird eine
+ entsprechende Anweisungen. Das Paket \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } selbst benötigt entsprechende Anweisungen beispielsweise im Rahmen der
+ automatischen Kolumnentitel. Sind \Macro{@mkleft} zum Setzen nur der
+ \PName{linken Marke}, \Macro{@mkright} zum Setzen nur der \PName{rechten
+ Marke} oder \Macro{@mkdouble} zum Setzen sowohl der rechten als auch der
+ linken \PName{Marke} mit demselben Inhalt beim Laden von
+ \IfThisCommonLabelBase{scrlayer}{%
+ \Package{scrlayer}%
+ }{%
+ \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ } nicht definiert, so werden sie vom Paket selbst definiert. Dabei wird eine
Definition gewählt, die am Zustand von \Macro{@mkboth} erkennt, ob mit
automatischen Kolumnentiteln gearbeitet wird. Nur in diesem Fall setzen die
Befehle auch eine entsprechende Marke.%
- Klassen- und Paketautoren können ebenfalls auf diese Anweisungen
- zurückgreifen, wenn sie nur linke oder nur rechte Marken setzen wollen und
- auch diese nur, wenn mit automatischen Kolumnentiteln gearbeitet wird.%
- \EndIndexGroup
-\fi
+ Klassen- und Paketautoren können ebenfalls auf die passende der vier
+ Anweisungen zurückgreifen, wenn sie linke oder rechte Marken setzen und
+ dies auf den Fall beschränken wollen, dass mit automatischen Kolumnentiteln
+ gearbeitet wird.%
+ \EndIndexGroup \fi
\IfThisCommonLabelBase{scrlayer}{%
Zu weiteren Möglichkeiten zur Beeinflussung der Inhalte von Seitenstilen
@@ -992,4 +1148,4 @@
% LocalWords: Hilfsanweisung content Expertenwissen Gliederungsebenen
% LocalWords: Gliederungsüberschriften Kapitelüberschriften Kolumnentitel
% LocalWords: Abschnittsüberschriften Gliederungsnummer Kapitelanfangsseite
-% LocalWords: Kolumnentiteln
+% LocalWords: Kolumnentiteln Abschnittsebene Paketautoren
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-parmarkup.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-parmarkup.tex
index f277d753405..951953fb826 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-parmarkup.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-parmarkup.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-parmarkup.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-parmarkup.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{common-parmarkup.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-01-31 13:56:21 +0100 (Wed, 31 Jan 2018) $
KOMA-Script guide (common paragraphs)]
\section{Absatzauszeichnung}
@@ -61,7 +61,7 @@
\Package{typearea} bietet, ist dies die vorteilhafteste
Absatzauszeichnung. Würde man ohne Einzug und Abstand arbeiten, hätte der
Leser als Anhaltspunkt nur die Länge der letzten Zeile. Im Extremfall kann
- es sehr schwer sein, zu erkennen, ob eine Zeile voll ist oder nicht. Des
+ es sehr schwer sein zu erkennen, ob eine Zeile voll ist oder nicht. Des
Weiteren stellt der Typograf fest, dass die Auszeichnung des Absatzendes am
Anfang der nächsten Zeile leicht vergessen ist. Demgegenüber ist eine
Auszeichnung am Absatzanfang einprägsamer. Der Absatzabstand hat den
@@ -101,6 +101,13 @@
gelesen und verstanden haben, können Sie nach dem Ende dieses Abschnitts auf
\autopageref{sec:\ThisCommonLabelBase.parmarkup.next} mit
\autoref{sec:\ThisCommonLabelBase.parmarkup.next} fortfahren.%
+ \IfThisCommonLabelBase{scrlttr2}{ %
+ Dies gilt ebenso, wenn Sie nicht mit Klasse
+ \Class{scrlttr2}\OnlyAt{scrlttr2}, sondern mit Paket \Package{scrletter}
+ arbeiten. Das Paket bietet keine eigenen Einstellungen für die
+ Absatzauszeichnung, sondern verlässt sich dabei ganz auf die verwendete
+ Klasse.%
+ }{}%
}
@@ -108,28 +115,34 @@
\OptionVName{parskip}{Methode}
\end{Declaration}
\IfThisCommonLabelBase{maincls}{%
- Hin und wieder wird ein Layout mit Absatzabstand an Stelle des
+ Hin und wieder wird ein Layout mit Absatzabstand anstelle des
voreingestellten Absatzeinzugs gefordert. Die \KOMAScript-Klassen bieten mit
der Option \Option{parskip}\ChangedAt{v3.00}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}} %
}{%
\IfThisCommonLabelBase{scrlttr2}{%
- Bei Briefen findet man häufiger ein Layout mit Absatzabstand an Stelle des
- voreingestellten Absatzeinzugs. Die \KOMAScript-Klasse \Class{scrlttr2}
+ Bei Briefen findet man häufiger ein Layout mit Absatzabstand anstelle des
+ voreingestellten Absatzeinzugs. Die \KOMAScript-Klasse
+ \Class{scrlttr2}\OnlyAt{scrlttr2}
bietet mit der Option \Option{parskip} %
}{\InternalCommonFileUsageError}%
}%
eine Reihe von Möglichkeiten, um dies zu erreichen. Die \PName{Methode} setzt
-sich dabei aus zwei Teilen zusammen. Der erste Teil ist entweder \PValue{full}
-oder \PValue{half}, wobei \PValue{full} für einen Absatzabstand von einer
-Zeile und \PValue{half} für einen Absatzabstand von einer halben Zeile
-steht. Der zweite Teil ist eines der Zeichen »\PValue{*}«, »\PValue{+}«,
-»\PValue{-}« und kann auch entfallen. Lässt man das Zeichen weg, so wird in
-der letzten Zeile des Absatzes am Ende mindestens ein Geviert, das ist
-1\Unit{em}, frei gelassen. Mit dem Pluszeichen wird am Zeilenende mindestens
-ein Drittel und mit dem Stern mindestens ein Viertel einer normalen Zeile frei
-gelassen. Mit der Minus-Variante werden keine Vorkehrungen für die letzte
-Zeile eines Absatzes getroffen.
+sich dabei aus zwei Teilen zusammen. Der erste Teil ist entweder
+\PValue{full}\important{\OptionValue{parskip}{full}\\
+ \OptionValue{parskip}{half}} oder \PValue{half}, wobei \PValue{full} für
+einen Absatzabstand von einer Zeile und \PValue{half} für einen Absatzabstand
+von einer halben Zeile steht. Der zweite Teil ist eines der Zeichen
+»\PValue{*}«, »\PValue{+}«, »\PValue{-}« und kann auch entfallen. Lässt man
+das Zeichen\important{\OptionVName{parskip}{Abstand}} weg, so wird in der
+letzten Zeile des Absatzes am Ende mindestens ein Geviert, das ist 1\Unit{em},
+frei gelassen. Mit dem
+Pluszeichen\important{\OptionValue{parskip}{\PName{Abstand}+}} wird am
+Zeilenende mindestens ein Drittel und mit dem
+Stern\important{\OptionValue{parskip}{\PName{Abstand}*}} mindestens ein
+Viertel einer normalen Zeile frei gelassen. Mit der
+Minus-Variante\important{\OptionValue{parskip}{\PName{Abstand}-}} werden keine
+Vorkehrungen für die letzte Zeile eines Absatzes getroffen.
Die Einstellung kann jederzeit geändert werden. Wird sie innerhalb des
Dokuments geändert, so wird implizit die Anweisung
@@ -145,17 +158,19 @@ Dokuments geändert, so wird implizit die Anweisung
}%
} %
ausgeführt. Änderungen der Absatzauszeichnung innerhalb eines Absatzes
-werden erst beim nächsten Absatz sichtbar.
+werden erst am Ende des Absatzes sichtbar.
Neben den sich so ergebenden acht Kombinationen ist es noch möglich, als
\PName{Methode} die Werte für einfache Schalter aus
\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} zu
-verwenden. Das Einschalten der Option entspricht dabei \PValue{full} ohne
-angehängtes Zeichen für den Freiraum der letzten Absatzzeile, also mit
-mindestens einem Geviert Freiraum am Ende des Absatzes. Das Ausschalten der
-Option schaltet hingegen wieder auf Absatzeinzug von einem Geviert um. Dabei
-darf die letzte Zeile eines Absatzes auch bis zum rechten Rand reichen. Einen
-Überblick über alle möglichen Werte für \PName{Methode} bietet
+verwenden. Das Einschalten der
+Option\important{\Option{parskip}\\\OptionValue{parskip}{true}} entspricht
+dabei \PValue{full} ohne angehängtes Zeichen für den Freiraum der letzten
+Absatzzeile, also mit mindestens einem Geviert Freiraum am Ende des
+Absatzes. Das Ausschalten\important{\OptionValue{parskip}{false}} der Option
+schaltet hingegen wieder auf Absatzeinzug von einem Geviert um. Dabei darf die
+letzte Zeile eines Absatzes auch bis zum rechten Rand reichen. Einen Überblick
+über alle möglichen Werte für \PName{Methode} bietet
\autoref{tab:\ThisCommonFirstLabelBase.parskip}%
\IfThisCommonFirstRun{.%
\begin{desclist}
@@ -174,12 +189,12 @@ darf die letzte Zeile eines Absatzes auch bis zum rechten Rand reichen. Einen
}%
% \begin{desctabular}
\entry{\PValue{false}, \PValue{off}, \PValue{no}%
- \IndexOption{parskip~=\PValue{false}}}{%
+ \IndexOption{parskip~=\textKValue{false}}}{%
Absätze werden durch einen Einzug der ersten Zeilen von einem Geviert
(1\Unit{em}) gekennzeichnet. Der erste Absatz eines Abschnitts wird nicht
eingezogen.}%
\entry{\PValue{full}, \PValue{true}, \PValue{on}, \PValue{yes}%
- \IndexOption{parskip~=\PValue{full}}%
+ \IndexOption{parskip~=\textKValue{full}}%
}{%
Absätze werden durch einen vertikalen Abstand von einer Zeile
gekennzeichnet, Absatzenden durch einen Leerraum von mind. einem Geviert
@@ -187,22 +202,22 @@ darf die letzte Zeile eines Absatzes auch bis zum rechten Rand reichen. Einen
\pventry{full-}{%
Absätze werden durch einen vertikalen Abstand von einer Zeile
gekennzeichnet. Absatzenden werden nicht
- gekennzeichnet.\IndexOption{parskip~=\PValue{full-}}}%
+ gekennzeichnet.\IndexOption{parskip~=\textKValue{full-}}}%
\pventry{full+}{%
\looseness=-1 Absätze werden durch einen vertikalen Abstand von einer
Zeile gekennzeichnet. Absatzenden werden durch einen Leerraum von
mind. einem Drittel einer normalen Zeile
- gekennzeichnet.\IndexOption{parskip~=\PValue{full+}}}%
+ gekennzeichnet.\IndexOption{parskip~=\textKValue{full+}}}%
\pventry{full*}{%
Absätze werden durch einen vertikalen Abstand von einer Zeile
gekennzeichnet. Absatzenden werden durch einen Leerraum von mind. einem
Viertel einer normalen Zeile
- gekennzeichnet.\IndexOption{parskip~=\PValue{full*}}}%
+ gekennzeichnet.\IndexOption{parskip~=\textKValue{full*}}}%
\pventry{half}{%
Absätze werden durch einen vertikalen Abstand von einer halben Zeile
gekennzeichnet. Absatzenden durch einen Leerraum von mind. einem Geviert
(1\Unit{em}) der normalen Schrift am Ende
- gekennzeichnet.\IndexOption{parskip~=\PValue{half}}}%
+ gekennzeichnet.\IndexOption{parskip~=\textKValue{half}}}%
\pventry{half-}{%
Absätze werden durch einen vertikalen Abstand von einer halben Zeile
gekennzeichnet. Absatzenden werden nicht
@@ -211,12 +226,12 @@ darf die letzte Zeile eines Absatzes auch bis zum rechten Rand reichen. Einen
Absätze werden durch einen vertikalen Abstand von einer halben Zeile
gekennzeichnet. Absatzenden werden durch einen Leerraum von mind. einem
Drittel einer normalen Zeile
- gekennzeichnet.\IndexOption{parskip~=\PValue{half+}}}%
+ gekennzeichnet.\IndexOption{parskip~=\textKValue{half+}}}%
\pventry{half*}{%
Absätze werden durch einen vertikalen Abstand von einer Zeile
gekennzeichnet. Absatzenden werden durch einen Leerraum von mind. einem
Viertel einer normalen Zeile
- gekennzeichnet.\IndexOption{parskip~=\PValue{half*}}}%
+ gekennzeichnet.\IndexOption{parskip~=\textKValue{half*}}}%
\pventry{never}{%
Es %
\IfThisCommonLabelBase{maincls}{%
@@ -229,7 +244,7 @@ darf die letzte Zeile eines Absatzes auch bis zum rechten Rand reichen. Einen
vertikalen Ausgleich der Einstellung
\DescRef{maincls.cmd.flushbottom}\IndexCmd{flushbottom} zusätzlicher
vertikaler Abstand verteilt werden
- muss.\IndexOption{parskip~=\PValue{never}}}%
+ muss.\IndexOption{parskip~=\textKValue{never}}}%
% \end{desctabular}
% \end{table}%
\end{desclist}%
@@ -250,8 +265,9 @@ voneinander.%
\fi%
}%
-Voreingestellt ist bei \KOMAScript{} \OptionValue{parskip}{false}. Hierbei
-gibt es keinen Absatzabstand, sondern einen Absatzeinzug von 1\Unit{em}.%
+Voreingestellt\textnote{Voreinstellung} ist bei \KOMAScript{}
+\OptionValue{parskip}{false}. Hierbei gibt es keinen Absatzabstand, sondern
+einen Absatzeinzug von 1\Unit{em}.%
%
\EndIndexGroup
%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-textmarkup.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-textmarkup.tex
index 833e1aa0970..61601ded308 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-textmarkup.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-textmarkup.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-textmarkup.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-textmarkup.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{common-textmarkup.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-02-06 10:26:38 +0100 (Tue, 06 Feb 2018) $
KOMA-Script guide (common paragraphs)]
\section{Textauszeichnungen}
@@ -66,17 +66,27 @@
ansonsten }%
auf \autopageref{sec:\ThisCommonLabelBase.textmarkup.next} mit
\autoref{sec:\ThisCommonLabelBase.textmarkup.next} fortfahren.%
+ \IfThisCommonLabelBase{scrextend}{\ Für diesen Fall sei jedoch darauf
+ hingewiesen\textnote{Einschränkung} dass von \Package{scrextend} aus
+ \autoref{tab:maincls.fontelements}, \autopageref{tab:maincls.fontelements}
+ nur die Elemente für den Dokumenttitel, den schlauen Spruch, die Fußnoten
+ und die \DescRef{maincls.env.labeling}-Umgebung unterstützt werden. Das
+ Element \DescRef{maincls.fontelement.disposition} ist zwar auch vorhanden,
+ wird jedoch von \Package{scrextend} ebenfalls nur für den Dokumenttitel
+ verwendet.%
+ }{}%
}
-
-\LaTeX{} verfügt über eine ganze Reihe von Anweisungen zur Textauszeichnung. %
% Umbruchkorrektur
-\IfThisCommonLabelBase{scrlttr2}{}{%
- Neben der Wahl der Schriftart gehören dazu auch Befehle
- zur Wahl einer Textgröße oder der Textausrichtung. %
-}%
+\IfThisCommonLabelBase{scrlayer-scrpage}{}{%
+ \LaTeX{} verfügt über eine ganze Reihe von Anweisungen zur
+ Textauszeichnung. %
+ \IfThisCommonLabelBaseOneOf{scrlttr2}{}{%
+ Neben der Wahl der Schriftart gehören dazu auch Befehle zur Wahl einer
+ Textgröße oder der Textausrichtung. %
+ }%
Näheres zu den normalerweise definierten Möglichkeiten ist \cite{l2kurz},
-\cite{latex:usrguide} und \cite{latex:fntguide} zu entnehmen.
+\cite{latex:usrguide} und \cite{latex:fntguide} zu entnehmen.}%
\IfThisCommonLabelBaseOneOf{scrlayer-scrpage,scrjura,scrlayer-notecolumn}{%
\iffalse%
@@ -90,7 +100,8 @@ Näheres zu den normalerweise definierten Möglichkeiten ist \cite{l2kurz},
\Macro{textsuperscript}\IndexCmd{textsuperscript} definiert, mit der
\PName{Text} höher gestellt werden kann. Eine
entsprechende Anweisung, um Text tief\Index{Tiefstellung} statt
- hoch\Index{Hochstellung} zu stellen, bietet \LaTeX{} erst seit Version
+ hoch\Index{Hochstellung} zu stellen, bietet
+ \LaTeX{}\textnote{\LaTeX~2015/01/01} erst seit Version
2015/01/01. Für ältere \LaTeX-Versionen definiert \KOMAScript{} daher
\Macro{textsubscript}. %
\ifthiscommonfirst
@@ -166,16 +177,16 @@ Mit%
\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v2.8p}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
-} Hilfe der Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} ist es
+}{} Hilfe der Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} ist es
möglich, die \PName{Befehle} festzulegen, mit denen die Schrift eines
bestimmten \PName{Element}s umgeschaltet wird. Theoretisch könnten als
\PName{Befehle} alle möglichen Anweisungen einschließlich Textausgaben
verwendet werden. Sie\textnote{Achtung!} sollten sich jedoch unbedingt auf
-solche Anweisungen beschränken, mit denen wirklich nur ein Schriftattribut
-umgeschaltet wird. In der Regel werden dies Befehle wie \Macro{normalfont},
-\Macro{rmfamily}, \Macro{sffamily}, \Macro{ttfamily}, \Macro{mdseries},
-\Macro{bfseries}, \Macro{upshape}, \Macro{itshape}, \Macro{slshape},
-\Macro{scshape} oder einer der Befehle \Macro{Huge}, \Macro{huge},
+solche Anweisungen beschränken, mit denen wirklich nur Schriftattribute
+umgeschaltet werden. In der Regel werden dies Befehle wie \Macro{rmfamily},
+\Macro{sffamily}, \Macro{ttfamily}, \Macro{upshape}, \Macro{itshape},
+\Macro{slshape}, \Macro{scshape}, \Macro{mdseries}, \Macro{bfseries},
+\Macro{normalfont} oder einer der Befehle \Macro{Huge}, \Macro{huge},
\Macro{LARGE}, \Macro{Large}, \Macro{large}, \Macro{normalsize},
\Macro{small}, \Macro{footnotesize}, \Macro{scriptsize} und \Macro{tiny}
sein. Die Erklärung zu diesen Befehlen entnehmen Sie bitte \cite{l2kurz},
@@ -183,13 +194,13 @@ sein. Die Erklärung zu diesen Befehlen entnehmen Sie bitte \cite{l2kurz},
\Macro{normalcolor} sind möglich (siehe \cite{package:graphics} und
\cite{package:xcolor}).%
\iffalse % Umbruchkorrekturtext
- \ Das Verhalten bei Verwendung anderer Anweisungen, inbesondere solcher, die
- zu Umdefinierungen führen oder Ausgaben tätigen, ist nicht
- definiert. Seltsames Verhalten ist möglich und stellt keinen Fehler dar.
- \else Die Verwendung anderer Anweisungen, inbesondere solcher, die
- Umdefinierungen vornehmen oder zu Ausgaben führen, ist nicht vorgesehen.
- Seltsames Verhalten ist in diesen Fällen möglich und stellt keinen Fehler
- dar.%
+\ Das Verhalten bei Verwendung anderer Anweisungen, inbesondere solcher, die
+zu Umdefinierungen führen oder Ausgaben tätigen, ist nicht
+definiert. Seltsames Verhalten ist möglich und stellt keinen Fehler dar.
+\else%
+\ Die Verwendung anderer Anweisungen, inbesondere solcher, die Umdefinierungen
+vornehmen oder zu Ausgaben führen, ist nicht vorgesehen. Seltsames Verhalten
+ist in diesen Fällen möglich und stellt keinen Fehler dar.%
\fi
Mit \Macro{setkomafont} wird die Schriftumschaltung eines Elements mit einer
@@ -198,9 +209,10 @@ die existierende Definition lediglich erweitert. Es wird empfohlen, beide
Anweisungen nicht innerhalb des Dokuments, sondern nur in der Dokumentpräambel
zu verwenden. Beispiele für die Verwendung entnehmen Sie bitte den Abschnitten
zu den jeweiligen Elementen.%
-\IfThisCommonLabelBaseOneOf{scrjura,scrlayer-notecolumn}{}{%
+\IfThisCommonLabelBase{scrlayer-notecolumn}{}{%
\ Namen und Bedeutung der einzelnen Elemente
- \IfThisCommonLabelBase{scrlayer-scrpage}{und deren Voreinstellungen }{}%
+ \IfThisCommonLabelBaseOneOf{scrlayer-scrpage,scrjura}{und deren
+ Voreinstellungen }{}%
sind in %
\IfThisCommonLabelBase{scrextend}{%
\autoref{tab:maincls.fontelements}, \autopageref{tab:maincls.fontelements}
@@ -209,28 +221,43 @@ zu den jeweiligen Elementen.%
}%
aufgelistet.%
\IfThisCommonLabelBase{scrextend}{ %
- Allerdings werden davon in \Package{scrextend} nur die Elemente für den
- Dokumenttitel, den schlauen Spruch, die Fußnoten und die
- \DescRef{maincls.env.labeling}-Umgebung behandelt. Das Element
+ Allerdings werden davon in \Package{scrextend} nur\textnote{Einschränkung}
+ die Elemente für den Dokumenttitel, den schlauen Spruch, die Fußnoten und
+ die \DescRef{maincls.env.labeling}-Umgebung behandelt. Das Element
\DescRef{maincls.fontelement.disposition} ist zwar auch verfügbar, wird
jedoch von \Package{scrextend} ebenfalls nur für den Dokumenttitel
verwendet.%
- }{}%
- \IfThisCommonLabelBase{scrlayer-scrpage}{}{ %
- Die Voreinstellungen sind den jeweiligen Abschnitten zu entnehmen.%
+ }{%
+ \IfThisCommonLabelBase{scrlayer-scrpage}{ %
+ Die angegebenen Voreinstellungen gelten nur, wenn das jeweilige Element
+ beim Laden von \Package{scrlayer-scrpage} nicht bereits definiert
+ ist. Beispielsweise definieren die \KOMAScript-Klassen
+ \DescRef{maincls.fontelement.pageheadfoot} und es gilt dann die von
+ \Package{scrlayer-scrpage} vorgefundene Einstellung.%
+ }{%
+ \IfThisCommonLabelBase{scrjura}{}{ %
+ Die Voreinstellungen sind den jeweiligen Abschnitten zu entnehmen.%
+ }%
+ }%
}%
}%
-Mit der Anweisung \Macro{usekomafont} kann die aktuelle Schriftart auf
-diejenige umgeschaltet werden, die für das angegebene \PName{Element}
-definiert ist.
+\IfThisCommonLabelBaseOneOf{scrlttr2,scrextend}{% Umbruchvarianten
+ Mit der Anweisung \Macro{usekomafont} kann die aktuelle Schriftart auf die
+ für das angegebene \PName{Element} umgeschaltet werden.%
+}{%
+ Mit der Anweisung \Macro{usekomafont} kann die aktuelle Schriftart auf
+ diejenige umgeschaltet werden, die für das angegebene \PName{Element}
+ definiert ist.%
+}
\IfThisCommonLabelBase{maincls}{\iftrue}{\csname iffalse\endcsname}
\begin{Example}
\phantomsection\xmpllabel{cmd.setkomafont}%
Angenommen, für das Element
- \DescRef{\ThisCommonLabelBase.fontelement.captionlabel} soll dieselbe Schriftart wie
- für \DescRef{\ThisCommonLabelBase.fontelement.descriptionlabel} verwenden. Das
- erreichen Sie einfach mit:
+ \DescRef{\ThisCommonLabelBase.fontelement.captionlabel} soll dieselbe
+ Schriftart wie für
+ \DescRef{\ThisCommonLabelBase.fontelement.descriptionlabel} verwendet
+ werden. Das erreichen Sie einfach mit:
\begin{lstcode}
\setkomafont{captionlabel}{%
\usekomafont{descriptionlabel}%
@@ -284,8 +311,8 @@ definiert ist.
\DescRef{\ThisCommonLabelBase.fontelement.chapterentry} (siehe
\autoref{sec:maincls.toc}, \DescPageRef{maincls.cmd.tableofcontents})}%
\feentry{chapterprefix}{%
- Kapitelnummernzeile bei Einstellung
- \OptionValueRef{maincls}{chapterprefix}{true} oder
+ Kapitelnummernzeile sowohl bei Einstellung
+ \OptionValueRef{maincls}{chapterprefix}{true} als auch
\OptionValueRef{maincls}{appendixprefix}{true} (siehe
\autoref{sec:maincls.structure},
\DescPageRef{maincls.option.chapterprefix})}%
@@ -316,7 +343,8 @@ definiert ist.
\DescRef{\ThisCommonLabelBase.fontelement.dictum} (siehe
\autoref{sec:maincls.dictum}, \DescPageRef{maincls.cmd.dictum})}%
\feentry{dictumtext}{%
- alternative Bezeichnung für \DescRef{\ThisCommonLabelBase.fontelement.dictum}}%
+ alternative Bezeichnung für
+ \DescRef{\ThisCommonLabelBase.fontelement.dictum}}%
\feentry{disposition}{%
alle Gliederungsüberschriften, also die Argumente von
\DescRef{\ThisCommonLabelBase.cmd.part} bis
@@ -351,7 +379,8 @@ definiert ist.
Trennzeichen, also das optionale Argument der
\DescRef{\ThisCommonLabelBase.env.labeling}-Umgebung, in einer
\DescRef{\ThisCommonLabelBase.env.labeling}-Umgebung; Anwendung erfolgt
- nach dem Element \DescRef{\ThisCommonLabelBase.fontelement.labelinglabel} (siehe
+ nach dem Element
+ \DescRef{\ThisCommonLabelBase.fontelement.labelinglabel} (siehe
\autoref{sec:maincls.lists}, \DescPageRef{maincls.env.labeling})}%
\feentry{minisec}{%
mit \DescRef{\ThisCommonLabelBase.cmd.minisec} gesetzte Überschrift
@@ -414,14 +443,14 @@ definiert ist.
\ChangedAt{v3.15}{\Class{scrartcl}}%
Optionale Verbindungspunkte in Inhaltsverzeichniseinträgen der Ebene
\DescRef{\ThisCommonLabelBase.cmd.section} abweichend vom Element
- \DescRef{\ThisCommonLabelBase.fontelement.sectionentrypagenumber} (nur bei
- \Class{scrartcl} verfügbar, siehe \autoref{sec:maincls.toc},
+ \DescRef{\ThisCommonLabelBase.fontelement.sectionentrypagenumber} (nur
+ bei \Class{scrartcl} verfügbar, siehe \autoref{sec:maincls.toc},
\DescPageRef{maincls.cmd.tableofcontents})}%
\feentry{sectionentrypagenumber}{%
Seitenzahl des Inhaltsverzeichniseintrags der Ebene
\DescRef{\ThisCommonLabelBase.cmd.section} abweichend vom Element
- \DescRef{\ThisCommonLabelBase.fontelement.sectionentry} (nur bei \Class{scrartcl}
- verfügbar, siehe \autoref{sec:maincls.toc},
+ \DescRef{\ThisCommonLabelBase.fontelement.sectionentry} (nur bei
+ \Class{scrartcl} verfügbar, siehe \autoref{sec:maincls.toc},
\DescPageRef{maincls.cmd.tableofcontents})}%
\feentry{sectioning}{%
alternative Bezeichnung für
@@ -483,14 +512,16 @@ definiert ist.
\end{Example}
\else
\IfThisCommonLabelBase{scrlttr2}{%
- Ein allgemeines Beispiel für die Anwendung von \Macro{setkomafont} und
+ Ein allgemeines Beispiel für die Anwendung sowohl von
+ \Macro{setkomafont} als auch
\Macro{usekomafont} finden Sie in \autoref{sec:maincls.textmarkup},
\PageRefxmpl{maincls.cmd.setkomafont}.
\begin{desclist}
\desccaption{%
- Elemente, deren Schrift bei der Klasse \Class{scrlttr2} mit
- \Macro{setkomafont} und \Macro{addtokomafont} verändert werden
+ Elemente, deren Schrift bei der Klasse \Class{scrlttr2} oder
+ dem Paket \Package{scrletter} mit \Macro{setkomafont} und
+ \Macro{addtokomafont} verändert werden
kann\label{tab:scrlttr2.fontelements}%
}{%
Elemente, deren Schrift verändert werden kann (\emph{Fortsetzung})%
@@ -549,7 +580,8 @@ definiert ist.
\DescRef{\ThisCommonLabelBase.fontelement.labelinglabel} (siehe
\autoref{sec:scrlttr2.lists}, \DescPageRef{scrlttr2.env.labeling})}%
\feentry{pagefoot}{%
- wird nach dem Element \DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}
+ wird nach dem Element
+ \DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}
für den mit Variable
\DescRef{scrlttr2.variable.nextfoot}\IndexVariable{nextfoot}
definierten Seitenfuß verwendet oder wenn das Paket
@@ -561,12 +593,12 @@ definiert ist.
\DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}}%
\feentry{pageheadfoot}{%
Seitenkopf und Seitenfuß bei allen von \KOMAScript{} definierten
- Seitenstilen (\autoref{sec:scrlttr2.pagestyle},
- \DescPageRef{scrlttr2.fontelement.pageheadfoot})}%
+ Seitenstilen (\autoref{sec:maincls.pagestyle},
+ \DescPageRef{\ThisCommonLabelBase.fontelement.pageheadfoot})}%
\feentry{pagenumber}{%
Seitenzahl im Kopf oder Fuß der Seite
- (\autoref{sec:scrlttr2.pagestyle},
- \DescPageRef{scrlttr2.fontelement.pagenumber})}%
+ (\autoref{sec:maincls.pagestyle},
+ \DescPageRef{\ThisCommonLabelBase.fontelement.pagenumber})}%
\feentry{pagination}{%
alternative Bezeichnung für
\DescRef{\ThisCommonLabelBase.fontelement.pagenumber}}%
@@ -595,13 +627,13 @@ definiert ist.
Titel in der Brieferöffnung (\autoref{sec:scrlttr2.firstpage},
\DescPageRef{scrlttr2.variable.title})}%
\feentry{toaddress}{Abweichung vom Element
- \DescRef{\ThisCommonLabelBase.fontelement.addressee} für die Anschrift (ohne
- Name) des Empfängers im Anschriftfeld
+ \DescRef{\ThisCommonLabelBase.fontelement.addressee} für die
+ Anschrift (ohne Name) des Empfängers im Anschriftfeld
(\autoref{sec:scrlttr2.firstpage},
\DescPageRef{scrlttr2.variable.toaddress})}%
\feentry{toname}{Abweichung vom Element
- \DescRef{\ThisCommonLabelBase.fontelement.addressee} für den Namen des
- Empfängers im Anschriftfeld (\autoref{sec:scrlttr2.firstpage},
+ \DescRef{\ThisCommonLabelBase.fontelement.addressee} für den Namen
+ des Empfängers im Anschriftfeld (\autoref{sec:scrlttr2.firstpage},
\DescPageRef{scrlttr2.variable.toname})}%
\end{desclist}
}{%
@@ -629,9 +661,10 @@ definiert ist.
\DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}%
\IndexFontElement{pageheadfoot} und
\DescRef{\ThisCommonLabelBase.fontelement.pagefoot}%
- \IndexFontElement{pagefoot} angewandt. Es wird empfohlen dieses
+ \IndexFontElement{pagefoot} angewandt. Es wird empfohlen, dieses
Element lediglich für Farbänderungen zu verwenden.\par
- Voreinstellung: \emph{leer} }%
+ \mbox{Voreinstellung: \emph{leer}}%
+ }%
\feentry{footsepline}{%
Linie über dem Fuß eines mit \Package{scrlayer-scrpage}
definierten Seitenstils (siehe
@@ -642,9 +675,9 @@ definiert ist.
\DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}%
\IndexFontElement{pageheadfoot} und
\DescRef{\ThisCommonLabelBase.fontelement.pagefoot}%
- \IndexFontElement{pagefoot} angewandt. Es wird empfohlen dieses
+ \IndexFontElement{pagefoot} angewandt. Es wird empfohlen, dieses
Element lediglich für Farbänderungen zu verwenden.\par
- Voreinstellung: \emph{leer}%
+ \mbox{Voreinstellung: \emph{leer}}%
}%
\feentry{headsepline}{%
Linie unter dem Kopf eines mit \Package{scrlayer-scrpage}
@@ -655,10 +688,10 @@ definiert ist.
den Elementen
\DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}%
\IndexFontElement{pageheadfoot} und
- \DescRef{\ThisCommonLabelBase.fontelement.pagehead}%
- \IndexFontElement{pagehead} angewandt. Es wird empfohlen dieses
+ \DescRef{scrlayer-scrpage.fontelement.pagehead}%
+ \IndexFontElement{pagehead} angewandt. Es wird empfohlen, dieses
Element lediglich für Farbänderungen zu verwenden.\par
- Voreinstellung: \emph{leer}%
+ \mbox{Voreinstellung: \emph{leer}}%
}%
\feentry{headtopline}{%
Linie über dem Kopf eines mit \Package{scrlayer-scrpage}
@@ -669,10 +702,10 @@ definiert ist.
den Elementen
\DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}%
\IndexFontElement{pageheadfoot} und
- \DescRef{\ThisCommonLabelBase.fontelement.pagehead}%
- \IndexFontElement{pagehead} angewandt. Es wird empfohlen dieses
+ \DescRef{scrlayer-scrpage.fontelement.pagehead}%
+ \IndexFontElement{pagehead} angewandt. Es wird empfohlen, dieses
Element lediglich für Farbänderungen zu verwenden.\par
- Voreinstellung: \emph{leer}%
+ \mbox{Voreinstellung: \emph{leer}}%
}%
\feentry{pagefoot}{%
Inhalt eines Fußes eines mit \Package{scrlayer-scrpage}
@@ -682,7 +715,7 @@ definiert ist.
wird nach \Macro{normalfont}\IndexCmd{normalfont} und nach dem
Element \DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}%
\IndexFontElement{pageheadfoot} angewandt.\par
- Voreinstellung: \emph{leer}%
+ \mbox{Voreinstellung: \emph{leer}}%
}%
\feentry{pagehead}{%
Inhalt eines Kopfes eines mit \Package{scrlayer-scrpage}
@@ -692,7 +725,7 @@ definiert ist.
wird nach \Macro{normalfont}\IndexCmd{normalfont} und nach Element
\DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}%
\IndexFontElement{pageheadfoot} angewandt.\par
- Voreinstellung: \emph{leer}%
+ \mbox{Voreinstellung: \emph{leer}}%
}%
\feentry{pageheadfoot}{%
Inhalt eines Kopfes oder Fußes eines mit
@@ -701,7 +734,8 @@ definiert ist.
\DescPageRef{scrlayer-scrpage.fontelement.pageheadfoot}). Das
Element wird nach \Macro{normalfont}\IndexCmd{normalfont}
angewandt.\par
- Voreinstellung: \Macro{normalcolor}\Macro{slshape}%
+ \mbox{Voreinstellung:
+ \Macro{normalcolor}\Macro{slshape}}%
}%
\feentry{pagenumber}{%
Die mit \DescRef{\ThisCommonLabelBase.cmd.pagemark} gesetzte
@@ -712,12 +746,59 @@ definiert ist.
\DescRef{\ThisCommonLabelBase.cmd.pagemark} ist dafür zu sorgen,
dass die Umdefinierung auch ein
\Macro{usekomafont}\PParameter{pagenumber} enthält!\par
- Voreinstellung: \Macro{normalfont}%
+ \mbox{Voreinstellung: \Macro{normalfont}}%
}%
\end{desclist}
}{%
- \IfThisCommonLabelBaseOneOf{scrjura,scrlayer-notecolumn}{}{%
- \InternalCommonFileUsageError%
+ \IfThisCommonLabelBase{scrjura}{%
+ \begin{table}
+ \caption{Elemente, deren Schrift bei \Package{scrjura} mit
+ \Macro{setkomafont} und \Macro{addtokomafont} verändert werden
+ kann, einschließlich der jeweiligen Voreinstellung}%
+ \label{tab:scrjura.fontelements}%
+ \begin{desctabular}
+ \feentry{Clause}{%
+ Alias für \FontElement{\PName{Umgebungsname}.Clause}
+ innerhalb einer Vertragsumgebung, beispielsweise
+ \FontElement{contract.Clause} innerhalb von
+ \DescRef{\ThisCommonLabelBase.env.contract}; ist kein
+ entsprechendes Element definiert, so wird auf
+ \FontElement{contract.Clause} zurückgegriffen%
+ }%
+ \feentry{contract.Clause}{%
+ Überschrift eines Paragraphen innerhalb von
+ \DescRef{\ThisCommonLabelBase.env.contract} (siehe
+ \autoref{sec:\ThisCommonLabelBase.contract},
+ \DescPageRef{\ThisCommonLabelBase.fontelement.contract.Clause});
+ \par
+ \mbox{Voreinstellung:
+ \Macro{sffamily}\Macro{bfseries}\Macro{large}}%
+ }%
+ \entry{\DescRef{\ThisCommonLabelBase.fontelement./Name/.Clause}}{%
+ \IndexFontElement[indexmain]{\PName{Name}.Clause}%
+ Überschrift eines Paragraphen innerhalb einer Umgebung
+ \PName{Name}, die mit
+ \DescRef{\ThisCommonLabelBase.cmd.DeclareNewJuraEnvironment}
+ definiert wurde, soweit bei der Definition mit
+ \Option{ClauseFont} eine Einstellung vorgenommen wurde oder
+ das Element nachträglich definiert wurde (siehe
+ \autoref{sec:\ThisCommonLabelBase.newenv},
+ \DescPageRef{\ThisCommonLabelBase.fontelement./Name/.Clause});
+ \par
+ \mbox{Voreinstellung: \emph{keine}}%
+ }%
+ \feentry{parnumber}{%
+ Absatznummern innerhalb einer
+ Vertragsumgebung (siehe \autoref{sec:\ThisCommonLabelBase.par},
+ \DescPageRef{\ThisCommonLabelBase.fontelement.parnumber});\par
+ \mbox{Voreinstellung: \emph{leer}}%
+ }%
+ \end{desctabular}
+ \end{table}
+ }{%
+ \IfThisCommonLabelBase{scrlayer-notecolumn}{}{%
+ \InternalCommonFileUsageError%
+ }%
}%
}%
}%
@@ -738,7 +819,7 @@ Manchmal\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}\and \Package{scrextend}} werden in der Schrifteinstellung
eines Elements auch Dinge vorgenommen, die mit der Schrift eigentlich gar
nichts zu tun haben, obwohl dies ausdrücklich nicht empfohlen wird. Soll dann
-nur die Schrifteinstellung aber keine dieser zusätzlichen Einstellungen
+nur die Schrifteinstellung, aber keine dieser zusätzlichen Einstellungen
ausgeführt werden, so kann statt
\DescRef{\ThisCommonLabelBase.cmd.usekomafont} die Anweisung
\Macro{usefontofkomafont} verwendet werden. Diese Anweisung übernimmt nur die
@@ -749,13 +830,24 @@ oder Ausprägung (engl. \emph{font series}) und die Form oder Ausrichtung
Mit den übrigen Anweisungen können auch einzelne Schriftattribute
übernommen werden. Dabei übernimmt \Macro{usesizeofkomafont} sowohl die
-Schriftgröße als auch den Grundlinienabstand.
-
-Diese Befehle sollten jedoch nicht als Legitimation dafür verstanden werden,
-in die Schrifteinstellungen der Elemente beliebige Anweisungen einzufügen. Das
-kann nämlich sehr schnell zu Fehlern führen (siehe
-\autoref{sec:maincls-experts.experts},
-\DescPageRef{maincls-experts.cmd.addtokomafontrelaxlist}).%
+Schriftgröße als auch den Grundlinienabstand.%
+%
+\IfThisCommonLabelBase{scrextend}{% Umbruchvariante!
+}{%
+ \IfThisCommonLabelBase{scrjura}{%
+ \par%
+ Vor dem Missbrauch der Schrifteinstellungen wird dennoch dringend gewarnt
+ (siehe \autoref{sec:maincls-experts.experts},
+ \DescPageRef{maincls-experts.cmd.addtokomafontrelaxlist})!%
+ }{%
+ \par%
+ Diese Befehle sollten jedoch nicht als Legitimation dafür verstanden
+ werden, in die Schrifteinstellungen der Elemente beliebige Anweisungen
+ einzufügen. Das kann nämlich sehr schnell zu Fehlern führen (siehe
+ \autoref{sec:maincls-experts.experts},
+ \DescPageRef{maincls-experts.cmd.addtokomafontrelaxlist}).%
+ }%
+}%
\EndIndexGroup
%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-titles.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-titles.tex
index 881333a2323..2086df85c44 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-titles.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-titles.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-titles.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-titles.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{common-titles.tex}
- [$Date: 2017-08-20 16:07:42 +0200 (Sun, 20 Aug 2017) $
+ [$Date: 2018-01-30 13:37:05 +0100 (Tue, 30 Jan 2018) $
KOMA-Script guide (common paragraphs)]
@@ -93,7 +93,7 @@ Bei Dokumenten wird zwischen zwei Arten von Titeln
\IfThisCommonLabelBase{scrextend}{}{für das gesamte Dokument
}unterschieden. Zum einen gibt es die Titelseiten. Hierbei steht der
Dokumenttitel zusammen mit einigen zusätzlichen Informationen wie dem Autor
-auf einer eigenen Seite. Neben der Haupttitelseite kann es dabei weitere
+auf einer eigenen Seite. Neben der Haupttitelseite kann es weitere
Titelseiten, etwa Schmutztitel, Verlagsinformationen, Widmung oder ähnliche,
geben. Zum anderen gibt es den Titelkopf. Dabei erscheint der Titel lediglich
am Anfang einer neuen \IfThisCommonLabelBase{scrextend}{}{-- in der Regel der
@@ -106,6 +106,10 @@ Zusammenfassung, einem Vorwort oder dem Inhaltsverzeichnis
\begin{Declaration}
\OptionVName{titlepage}{Ein-Aus-Wert}
\OptionValue{titlepage}{firstiscover}
+ \Macro{coverpagetopmargin}
+ \Macro{coverpageleftmargin}
+ \Macro{coverpagerightmargin}
+ \Macro{coverpagebottommargin}
\end{Declaration}%
Mit dieser Option%
\IfThisCommonLabelBase{maincls}{%
@@ -114,7 +118,7 @@ Mit dieser Option%
}{} wird ausgewählt, ob für die mit
\DescRef{\ThisCommonLabelBase.cmd.maketitle} (siehe
\DescPageRef{\ThisCommonLabelBase.cmd.maketitle}) gesetzte Titelei eigene
-Seiten\Index{Titel>Seite} verwendet werden, oder stattdessen die Titelei von
+Seiten\Index{Titel>Seite} verwendet werden oder stattdessen die Titelei von
\DescRef{\ThisCommonLabelBase.cmd.maketitle} als Titelkopf\Index{Titel>Kopf}
gesetzt wird. Als \PName{Ein-Aus-Wert} kann einer der Standardwerte für
einfache Schalter aus \autoref{tab:truefalseswitch},
@@ -127,14 +131,15 @@ in Form von Titelseiten ausgewählt. Die Anweisung
\IfThisCommonLabelBase{scrextend}{dabei
}{}\DescRef{\ThisCommonLabelBase.env.titlepage}-Umgebungen zum Setzen dieser
Seiten, die somit normalerweise weder Seitenkopf noch Seitenfuß erhalten. Bei
-{\KOMAScript} wurde die Titelei gegenüber den Standardklassen stark erweitert.
+{\KOMAScript} wurde die Titelei gegenüber den Standardklassen stark
+erweitert. Die zusätzlichen Elemente finden sie auf den nachfolgenden Seiten.
Demgegenüber wird mit
\important{\OptionValue{titlepage}{false}}\OptionValue{titlepage}{false}
erreicht, dass ein Titelkopf (engl.: \emph{in-page title}) gesetzt wird. Das
-heißt, die Titelei wird lediglich speziell hervorgehoben, auf der Seite mit
+heißt, die Titelei wird lediglich speziell hervorgehoben. Auf der Seite mit
dem Titel kann aber nachfolgend weiteres Material, beispielsweise eine
-Zusammenfassung oder ein Abschnitt gesetzt werden.
+Zusammenfassung oder ein Abschnitt, gesetzt werden.
Mit%
\IfThisCommonLabelBase{maincls}{%
@@ -147,22 +152,15 @@ Mit%
} der dritten Möglichkeit, \OptionValue{titlepage}{firstiscover}%
\important{\OptionValue{titlepage}{firstiscover}}, werden nicht nur
Titelseiten aktiviert. Es wird auch dafür gesorgt, dass die erste von
-\DescRef{\LabelBase.cmd.maketitle}\IndexCmd{maketitle} ausgegebene Titelseite, also entweder
-der Schmutztitel oder der Haupttitel, als Umschlagseite\Index{Umschlag}
-ausgegeben wird. Jede andere Einstellung für die Option \Option{titlepage}
-hebt diese Einstellung wieder auf. Die Ränder\important{%
- \Macro{coverpagetopmargin}\\
- \Macro{coverpageleftmargin}\\
- \Macro{coverpagerightmargin}\\
- \Macro{coverpagebottommargin}} dieser Umschlagseite werden über
-\Macro{coverpagetopmargin}\IndexCmd[indexmain]{coverpagetopmargin} (oberer
-Rand), \Macro{coverpageleftmargin}\IndexCmd[indexmain]{coverpageleftmargin}
-(linker Rand),
-\Macro{coverpagerightmargin}\IndexCmd[indexmain]{coverpagerightmargin}
-(rechter Rand) und natürlich
-\Macro{coverpagebottommargin}\IndexCmd[indexmain]{coverpagebottommargin}
-(unterer Rand) bestimmt. Die Voreinstellungen sind von den Längen
-\Length{topmargin}\IndexLength{topmargin} und
+\DescRef{\LabelBase.cmd.maketitle}\IndexCmd{maketitle} ausgegebene Titelseite,
+also entweder der Schmutztitel oder der Haupttitel, als
+Umschlagseite\Index{Umschlag} ausgegeben wird. Jede andere Einstellung für die
+Option \Option{titlepage} hebt diese Einstellung wieder auf. Die
+Ränder\important{\Macro{coverpage\dots margin}} dieser Umschlagseite werden
+über \Macro{coverpagetopmargin} (oberer Rand), \Macro{coverpageleftmargin}
+(linker Rand), \Macro{coverpagerightmargin} (rechter Rand) und natürlich
+\Macro{coverpagebottommargin} (unterer Rand) bestimmt. Die Voreinstellungen
+sind von den Längen \Length{topmargin}\IndexLength{topmargin} und
\Length{evensidemargin}\IndexLength{evensidemargin} abhängig und können mit
\Macro{renewcommand} geändert werden.
@@ -191,9 +189,10 @@ Titelseiten in einer speziellen Umgebung, der
\Environment{titlepage}-Umgebung, gesetzt. Diese Umgebung startet immer mit
einer neuen Seite -- im zweiseitigen Layout sogar mit einer neuen rechten
Seite~-- im einspaltigen Modus. Für eine Seite wird der Seitenstil mit
-\DescRef{maincls.cmd.thispagestyle}\PParameter{empty} geändert,
-so dass weder Seitenzahl noch Kolumnentitel ausgegeben werden. Am Ende der
-Umgebung wird die Seite automatisch beendet. Sollten Sie nicht das
+\DescRef{maincls.cmd.thispagestyle}%
+\PParameter{\DescRef{maincls.pagestyle.empty}}
+geändert, so dass weder Seitenzahl noch Kolumnentitel ausgegeben werden. Am
+Ende der Umgebung wird die Seite automatisch beendet. Sollten Sie nicht das
automatische Layout der Titelei, wie es das nachfolgend beschriebene
\DescRef{\ThisCommonLabelBase.cmd.maketitle} bietet, verwenden können, ist zu
empfehlen, eine eigene Titelei mit Hilfe dieser Umgebung zu entwerfen.
@@ -201,7 +200,7 @@ empfehlen, eine eigene Titelei mit Hilfe dieser Umgebung zu entwerfen.
\IfThisCommonFirstRun{\iftrue}{%
Ein Beispiel für eine einfache Titelseite mit \Environment{titlepage} finden
Sie in \autoref{sec:\ThisCommonFirstLabelBase.titlepage},
- \PageRefxmpl{\ThisCommonFirstLabelBase.env.titlepage}%
+ \PageRefxmpl{\ThisCommonFirstLabelBase.env.titlepage}.%
\csname iffalse\endcsname%
}%
\begin{Example}
@@ -225,23 +224,24 @@ empfehlen, eine eigene Titelei mit Hilfe dieser Umgebung zu entwerfen.
\begin{Declaration}
\Macro{maketitle}\OParameter{Seitenzahl}
\end{Declaration}%
-Während bei den Standardklassen nur maximal eine Titelseite mit den
-\IfThisCommonLabelBase{scrextend}{}{drei }Angaben Titel, Autor und Datum
-existiert, können bei {\KOMAScript} mit \Macro{maketitle} bis zu sechs
-Titelseiten gesetzt werden. Im Gegensatz zu den Standardklassen kennt
-\Macro{maketitle} bei {\KOMAScript} außerdem noch ein optionales nummerisches
-Argument. Findet es Verwendung, so wird die Nummer als Seitenzahl der ersten
-Titelseite benutzt. Diese Seitenzahl wird jedoch nicht ausgegeben, sondern
-beeinflusst lediglich die Zählung. Sie sollten hier unbedingt eine ungerade
-Zahl wählen, da sonst die gesamte Zählung durcheinander gerät. Meiner
-Auf"|fassung nach gibt es nur zwei sinnvolle Anwendungen für das optionale
-Argument. Zum einen könnte man dem Schmutztitel\Index[indexmain]{Schmutztitel}
-die logische Seitenzahl \(-\)1 geben, um so die Seitenzählung erst ab der
-Haupttitelseite mit 1 zu beginnen. Zum anderen könnte man mit einer höheren
-Seitenzahl beginnen, beispielsweise 3, 5 oder 7, um so weitere Titelseiten zu
-berücksichtigen, die erst vom Verlag hinzugefügt werden. Wird ein Titelkopf
-verwendet, wird das optionale Argument ignoriert. Dafür kann der Seitenstil
-einer solchen Titelei durch Umdefinierung des Makros
+Während\textnote{\KOMAScript{} vs. Standardklassen} bei den Standardklassen
+nur maximal eine Titelseite mit den \IfThisCommonLabelBase{scrextend}{}{drei
+}Angaben Titel, Autor und Datum existiert, können bei {\KOMAScript} mit
+\Macro{maketitle} bis zu sechs Titelseiten gesetzt werden. Im Gegensatz zu
+den Standardklassen kennt \Macro{maketitle} bei {\KOMAScript} außerdem noch
+ein optionales nummerisches Argument. Findet es Verwendung, so wird die
+Nummer als Seitenzahl der ersten Titelseite benutzt. Diese Seitenzahl wird
+jedoch nicht ausgegeben, sondern beeinflusst lediglich die Zählung. Sie
+sollten hier unbedingt eine ungerade Zahl wählen, da sonst die gesamte Zählung
+durcheinander gerät. Meiner Auf"|fassung nach gibt es nur zwei sinnvolle
+Anwendungen für das optionale Argument. Zum einen könnte man dem
+Schmutztitel\Index[indexmain]{Schmutztitel} die logische Seitenzahl -1
+geben, um so die Seitenzählung erst ab der Haupttitelseite mit 1 zu
+beginnen. Zum anderen könnte man mit einer höheren Seitenzahl beginnen,
+beispielsweise 3, 5 oder 7, um so weitere Titelseiten zu berücksichtigen, die
+erst vom Verlag hinzugefügt werden. Wird ein Titelkopf verwendet, wird das
+optionale Argument ignoriert. Dafür kann der Seitenstil einer solchen Titelei
+durch Umdefinierung des Makros
\DescRef{\ThisCommonLabelBase.cmd.titlepagestyle}%
\important{\DescRef{\ThisCommonLabelBase.cmd.titlepagestyle}} (siehe
\autoref{sec:maincls.pagestyle}, \DescPageRef{maincls.cmd.titlepagestyle})
@@ -261,16 +261,19 @@ verwendet werden. Es ist jedoch nicht notwendig und bei Verwendung des
\Package{babel}-Pakets\IndexPackage{babel} (siehe \cite{package:babel}) auch
nicht empfehlenswert, diese Anweisungen in der Dokumentpräambel vor
\Macro{begin}\PParameter{document} zu verwenden. Beispieldokumente finden Sie
-am Ende des Abschnitts.
+\IfThisCommonFirstRun{bei den weiteren Befehlen dieses Abschnitts}{in
+ \autoref{sec:\ThisCommonFirstLabelBase.titlepage} ab
+ \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.extratitle}}.
\begin{Declaration}
\Macro{extratitle}\Parameter{Schmutztitel}
+ \Macro{frontispiece}\Parameter{Frontispiz}
\end{Declaration}%
\begin{Explain}%
Früher war der Buchblock oftmals nicht durch einen Buchdeckel vor
Verschmutzung geschützt. Diese Aufgabe übernahm dann die erste Seite des
- Buches, die meist einen Kurztitel, eben den \emph{Schmutztitel} trug. Auch
+ Buches, die meist einen Kurztitel, eben den \emph{Schmutztitel}, trug. Auch
heute noch wird diese Extraseite vor dem eigentlichen Haupttitel gerne
verwendet und enthält dann Verlagsangaben, Buchreihennummer und ähnliche
Angaben.
@@ -280,7 +283,15 @@ Seite zu setzen. Als \PName{Schmutztitel}\Index{Schmutztitel} kann dabei
beliebiger Text -- auch mehrere Absätze -- gesetzt werden. Der Inhalt von
\PName{Schmutztitel} wird von {\KOMAScript} ohne zusätzliche Beeinflussung der
Formatierung ausgegeben. Dadurch ist dessen Gestaltung völlig dem Anwender
-überlassen. Die Rückseite des Schmutztitels bleibt leer. Der Schmutztitel
+überlassen. Die Rückseite%
+\IfThisCommonLabelBase{maincls}{%
+ \ChangedAt{v3.25}{\Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}}%
+}{%
+ \IfThisCommonLabelBase{scrextend}{%
+ \ChangedAt{v3.25}{\Package{scrextend}}%
+ }{\ThisCommonLabelBaseFailure}%
+}
+des Schmutztitels ist das \PName{Frontispiz}. Der Schmutztitel
ergibt auch dann eine eigene Titelseite, wenn mit Titelköpfen gearbeitet
wird. Die Ausgabe des mit \Macro{extratitle} definierten Schmutztitels erfolgt
als Bestandteil der Titelei mit \DescRef{\ThisCommonLabelBase.cmd.maketitle}.
@@ -288,7 +299,7 @@ als Bestandteil der Titelei mit \DescRef{\ThisCommonLabelBase.cmd.maketitle}.
\IfThisCommonFirstRun{\iftrue}{%
Ein Beispiel für eine einfache Titelseite mit Schmutztitel und Haupttitel
finden Sie in \autoref{sec:\ThisCommonFirstLabelBase.titlepage},
- \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.extratitle}%
+ \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.extratitle}.%
\csname iffalse\endcsname%
}%
\begin{Example}
@@ -346,7 +357,8 @@ Der\important{\Macro{titlehead}}
\PName{Kopf}\Index[indexmain]{Titel>Seitenkopf} des Haupttitels wird mit der
Anweisung \Macro{titlehead} definiert. Er wird über die gesamte Textbreite in
normalem Blocksatz am Anfang der Seite ausgegeben. Er kann vom Anwender frei
-gestaltet werden. Für die Ausgabe wird die Schrift des gleichnamigen Elements
+gestaltet werden. Für die Ausgabe wird die
+Schrift\important{\FontElement{titlehead}} des gleichnamigen Elements
verwendet (siehe \autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup
@@ -354,12 +366,13 @@ verwendet (siehe \autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
\BeginIndexGroup\BeginIndex{FontElement}{subject}\LabelFontElement{subject}%
Die\important{\Macro{subject}}
\PName{Typisierung}\Index[indexmain]{Typisierung} wird unmittelbar über dem
-\PName{Titel} in der Schrift des gleichnamigen Elements ausgegeben.%
+\PName{Titel} in der Schrift\important{\FontElement{subject}} des
+gleichnamigen Elements ausgegeben.%
\EndIndexGroup
\BeginIndexGroup\BeginIndex{FontElement}{title}\LabelFontElement{title}%
Der\important{\Macro{title}} \PName{Titel} wird in einer sehr großen Schrift
-ausgegeben. Dabei\IfThisCommonLabelBase{maincls}{%
+gesetzt. Dabei\IfThisCommonLabelBase{maincls}{%
\ChangedAt{v2.8p}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}}{} finden \IfThisCommonLabelBase{scrextend}{}{abgesehen
von der Größe }% Umbruchkorrektur
@@ -373,8 +386,8 @@ Schriftumschaltungen für das Element
\BeginIndexGroup\BeginIndex{FontElement}{subtitle}\LabelFontElement{subtitle}%
Der\important{\Macro{subtitle}}
\PName{Untertitel}\ChangedAt{v2.97c}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} wird knapp unter dem Titel in der Schrift des
-gleichnamigen Elements ausgegeben (siehe
+ \Class{scrartcl}} steht knapp unter dem Titel in der
+Schrift\important{\FontElement{subtitle}} des gleichnamigen Elements (siehe
\autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup
@@ -383,8 +396,9 @@ gleichnamigen Elements ausgegeben (siehe
Unter\important{\Macro{author}} dem \PName{Untertitel} folgt der
\PName{Autor}\Index[indexmain]{Autor}. Es kann auch durchaus mehr als ein
Autor innerhalb des Arguments von \Macro{author} angegeben werden. Die Autoren
-sind dann mit \Macro{and} voneinander zu
-trennen. Die Ausgabe erfolgt in der Schrift des gleichnamigen Elements (siehe
+sind dann mit \Macro{and}\important{\Macro{and}} voneinander zu trennen. Die
+Ausgabe erfolgt in der Schrift\important{\FontElement{author}} des
+gleichnamigen Elements (siehe
\autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup
@@ -394,8 +408,8 @@ Unter\important{\Macro{date}} dem Autor oder den Autoren folgt das
Datum\Index{Datum}. Dabei ist das aktuelle Datum,
\Macro{today}\IndexCmd{today}, voreingestellt. Es kann jedoch mit \Macro{date}
eine beliebige Angabe -- auch ein leere -- erreicht werden. Die Ausgabe
-erfolgt in der Schrift des gleichnamigen Elements (siehe
-\autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
+erfolgt in der Schrift\important{\FontElement{date}} des gleichnamigen
+Elements (siehe \autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup
@@ -408,8 +422,8 @@ werden. Notfalls kann durch Verwendung einer \Macro{parbox} über die gesamte
Seitenbreite auch erreicht werden, dass diese Angabe nicht zentriert, sondern
im Blocksatz gesetzt wird. Sie ist dann als Äquivalent zum Kopf zu
betrachten. Dabei ist jedoch zu beachten, dass sie oberhalb von eventuell
-vorhandenen Fußnoten ausgegeben wird. Die Ausgabe erfolgt in der Schrift des
-gleichnamigen Elements (siehe
+vorhandenen Fußnoten ausgegeben wird. Die Ausgabe erfolgt in der
+Schrift\important{\FontElement{publishers}} des gleichnamigen Elements (siehe
\autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup
@@ -441,15 +455,15 @@ Für%
\IfThisCommonLabelBase{scrextend}{%
\ChangedAt{v3.12}{\Package{scrextend}}%
}{\InternalCommonFileUsageError}%
-} die Ausgabe der Titelelemente kann die Schrift über gleichnamige Elemente
+} die Ausgabe der Titelelemente kann die Schrift\textnote{Schrift}
mit Hilfe der Befehle \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und
\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (siehe
\autoref{sec:\ThisCommonLabelBase.textmarkup},
\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) eingestellt werden. Die
-Voreinstellungen sind \autoref{tab:\ThisCommonFirstLabelBase.titlefonts}, %
+Voreinstellungen sind \autoref{tab:\ThisCommonFirstLabelBase.titlefonts}%
\IfThisCommonFirstRun{}{%
- \autopageref{tab:\ThisCommonFirstLabelBase.titlefonts}, %
-}%
+ , \autopageref{tab:\ThisCommonFirstLabelBase.titlefonts}%
+} %
zu entnehmen.%
\IfThisCommonFirstRun{%
\begin{table}
@@ -472,11 +486,14 @@ zu entnehmen.%
\FontElement{dedication} & \Macro{Large} \\
\FontElement{publishers} & \Macro{Large} \\
\FontElement{subject} &
- \Macro{normalfont}\Macro{normalcolor}\Macro{bfseries}\Macro{Large} \\
+ \Macro{normalfont}\Macro{normalcolor}%
+ \Macro{bfseries}\Macro{Large} \\
\FontElement{subtitle} &
- \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{title}\Macro{large} \\
+ \DescRef{\ThisCommonLabelBase.cmd.usekomafont}%
+ \PParameter{title}\Macro{large} \\
\FontElement{title} &
- \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{disposition} \\
+ \DescRef{\ThisCommonLabelBase.cmd.usekomafont}%
+ \PParameter{disposition} \\
\FontElement{titlehead} & \\
\bottomrule
\end{tabular}
@@ -485,10 +502,22 @@ zu entnehmen.%
}{}%
Bis auf den \PName{Kopf} und eventuelle Fußnoten werden alle Ausgaben
-horizontal zentriert. \IfThisCommonLabelBase{scrextend}{Die Formatierungen der
- einzelnen Elemente}{Diese Angaben} sind noch einmal kurz zusammengefasst in
-\autoref{tab:\ThisCommonFirstLabelBase.mainTitle}\IfThisCommonFirstRun{}{%
- , \autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}} zu finden.
+horizontal zentriert. %
+\iffree{%
+ \IfThisCommonLabelBase{scrextend}{Die Formatierungen der einzelnen
+ Elemente}{Diese Angaben} sind noch einmal kurz zusammengefasst in
+ \autoref{tab:\ThisCommonFirstLabelBase.mainTitle}\IfThisCommonFirstRun{}{%
+ , \autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}} zu finden.%
+}{%
+ \IfThisCommonLabelBase{scrextend}{%
+ Die Ausrichtungen der einzelnen Elemente sind ebenfalls in
+ \autoref{tab:\ThisCommonFirstLabelBase.mainTitle}\IfThisCommonFirstRun{}{%
+ , \autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}} zu finden.%
+ }{%
+ Eine Zusammenfassung dazu bietet
+ \autoref{tab:\ThisCommonFirstLabelBase.mainTitle}.%
+ }%
+}%
\IfThisCommonFirstRun{%
\begin{table}
% \centering
@@ -570,7 +599,7 @@ horizontal zentriert. \IfThisCommonLabelBase{scrextend}{Die Formatierungen der
doppelseitige Satzspiegel gehorcht, sondern rechts und links gleich große
Ränder besitzt. Nimmt man jedoch einmal ein Buch zur Hand und klappt es auf,
trifft man sehr schnell auf mindestens eine Titelseite\textnote{Titelseiten}
- unter dem Buchdeckel innerhalb des so genannten Buchblocks. Genau diese
+ unter dem Buchdeckel innerhalb des sogenannten Buchblocks. Genau diese
Titelseiten werden mit \DescRef{\ThisCommonLabelBase.cmd.maketitle} gesetzt.
Wie beim Schmutztitel handelt es sich also auch bei der Haupttitelseite um
@@ -588,7 +617,7 @@ horizontal zentriert. \IfThisCommonLabelBase{scrextend}{Die Formatierungen der
alternativ aber auch als Umschlagseite formatieren lassen. Dabei ändern sich
nur die für diese Seite verwendeten Ränder (siehe Option
\OptionValueRef{\ThisCommonLabelBase}{titlepage}{firstiscover}%
- \IndexOption{titlepage~=\PValue{firstiscover}} auf
+ \IndexOption{titlepage~=\textKValue{firstiscover}} auf
\DescPageRef{\ThisCommonLabelBase.option.titlepage}).
\end{Explain}
%
@@ -599,10 +628,11 @@ horizontal zentriert. \IfThisCommonLabelBase{scrextend}{Die Formatierungen der
\Macro{uppertitleback}\Parameter{Titelrückseitenkopf}
\Macro{lowertitleback}\Parameter{Titelrückseitenfuß}
\end{Declaration}%
-Im doppelseitigen Druck bleibt bei den Standardklassen die Rückseite des
-Blatts mit der Titelseite leer. Bei {\KOMAScript} lässt sich die Rückseite der
-Haupttitelseite hingegen für weitere Angaben nutzen. Dabei wird zwischen genau
-zwei Elementen unterschieden, die der Anwender frei gestalten kann: dem
+Im\textnote{\KOMAScript{} vs. Standardklassen} doppelseitigen Druck bleibt bei
+den Standardklassen die Rückseite des Blatts mit der Titelseite leer. Bei
+{\KOMAScript} lässt sich die Rückseite der Haupttitelseite hingegen für
+weitere Angaben nutzen. Dabei wird zwischen genau zwei Elementen
+unterschieden, die der Anwender frei gestalten kann: dem
\PName{Titelrückseitenkopf}\Index{Titel>Rueckseite=Rückseite} und dem
\PName{Titelrückseitenfuß}. Dabei kann der Kopf bis zum Fuß reichen und
umgekehrt. \iffree{Nimmt man diese Anleitung als Beispiel, so wurde der
@@ -618,8 +648,8 @@ umgekehrt. \iffree{Nimmt man diese Anleitung als Beispiel, so wurde der
\Macro{dedication}\Parameter{Widmung}
\end{Declaration}%
{\KOMAScript} bietet eine eigene Widmungsseite. Diese Widmung\Index{Widmung}
-wird zentriert und in der Voreinstellung mit etwas größerer Schrift
-gesetzt.
+wird zentriert und in der Voreinstellung mit etwas größerer
+Schrift\textnote{Schrift} gesetzt.
\BeginIndexGroup\BeginIndex{FontElement}{dedication}%
\LabelFontElement{dedication}
Die%
@@ -640,10 +670,9 @@ Element \FontElement{dedication}, die
\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) verändert werden.%
\EndIndexGroup
-Die Rückseite ist wie bei der Seite mit dem Schmutztitel grundsätzlich
-leer. Die Widmungsseite wird zusammen mit der restlichen Titelei mit
-\DescRef{\ThisCommonLabelBase.cmd.maketitle} ausgegeben und muss daher vor
-dieser Anweisung definiert sein.
+Die Rückseite ist grundsätzlich leer. Die Widmungsseite wird zusammen mit der
+restlichen Titelei mit \DescRef{\ThisCommonLabelBase.cmd.maketitle} ausgegeben
+und muss daher vor dieser Anweisung definiert sein.
\IfThisCommonFirstRun{\iftrue}{%
Ein Beispiel mit allen von \KOMAScript{} angebotenen Titelseiten finden Sie
@@ -654,7 +683,8 @@ dieser Anweisung definiert sein.
\begin{Example}
\phantomsection\xmpllabel{fulltitle}
Nehmen wir dieses Mal an, dass Sie einen Gedichtband schreiben, den
- Sie Ihrer Frau widmen wollen. Das könnte wie folgt aussehen:
+ Sie Ihrer Partnerin oder Ihrem Partner widmen wollen. Das könnte wie folgt
+ aussehen:
\begin{lstcode}
\documentclass{scrbook}
\usepackage[ngerman]{babel}
@@ -676,7 +706,8 @@ dieser Anweisung definiert sein.
\maketitle
\end{document}
\end{lstcode}
- Ich bitte, die Kosenamen nach eigenen Vorlieben zu ersetzen.
+ Ich bitte, die Kosenamen nach eigenen Vorlieben zu ersetzen und zu
+ personalisieren.
\end{Example}%
\fi%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-typearea.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-typearea.tex
index 40b11f1f21d..87b1c4e29ee 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-typearea.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-typearea.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-typearea.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-typearea.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{common-typearea.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-02-01 12:55:46 +0100 (Thu, 01 Feb 2018) $
KOMA-Script guide (common paragraphs: typearea)]
@@ -60,15 +60,17 @@ Kopf, dem Fuß, dem Textbereich, einer Marginalienspalte und den Abständen
zwischen diesen Elementen. \KOMAScript{} unterscheidet dabei auch noch
zwischen der Gesamtseite oder dem Papier und der sichtbaren Seite. Ohne
Zweifel gehört die Auf"|teilung der Seite in diese unterschiedlichen Teile zu
-den Grundfähigkeiten einer Klasse. Bei \KOMAScript{} wird diese Arbeit an das
-Paket \Package{typearea} delegiert. Dieses Paket kann auch zusammen mit
-anderen Klassen verwendet werden. Die \KOMAScript-Klassen laden
-\Package{typearea} jedoch selbständig. Es ist daher weder notwendig noch
-sinnvoll, das Paket bei Verwendung einer \KOMAScript-Klasse auch noch explizit
-per \Macro{usepackage} zu laden. Siehe hierzu auch
-\autoref{sec:\csname label@base\endcsname.options}.
+den Grundfähigkeiten einer
+Klasse\IfThisCommonLabelBase{scrlttr2}{\OnlyAt{scrlttr2}}{}. Bei \KOMAScript{}
+wird diese Arbeit an das Paket \Package{typearea} delegiert. Dieses Paket kann
+auch zusammen mit anderen Klassen verwendet werden. Die \KOMAScript-Klassen
+laden \Package{typearea} jedoch selbstständig. Es ist daher weder notwendig
+noch sinnvoll, das Paket bei Verwendung einer \KOMAScript-Klasse auch noch
+explizit per \Macro{usepackage} zu laden. Siehe hierzu auch
+\autoref{sec:\ThisCommonLabelBase.options}, ab
+\autopageref{sec:\ThisCommonLabelBase.options}.
-Einige Einstellungen der \KOMAScript{}-Klassen haben auch Auswirkungen auf die
+Einige Einstellungen der \KOMAScript{}-Klassen haben Auswirkungen auf die
Seitenauf"|teilung und umgekehrt. Diese Auswirkungen werden bei den
entsprechenden Einstellungen dokumentiert.
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/expertpart.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/expertpart.tex
index ab237414c08..30b3608c149 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/expertpart.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/expertpart.tex
@@ -1,6 +1,6 @@
% ======================================================================
% expertpart.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% expertpart.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -66,8 +66,7 @@
}
\part{\KOMAScript{} für fortgeschrittene Anwender
- und Experten}
-\label{part:forExperts}
+ und Experten\label{part:forExperts}}
\endinput
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide-ngerman.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide-ngerman.tex
index 635bee020d6..fd24e330f68 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide-ngerman.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide-ngerman.tex
@@ -1,6 +1,6 @@
% ======================================================================
% guide-ngerman.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% guide-ngerman.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
%
\KOMAProvidesFile{guide-ngerman.tex}
- [$Date: 2017-08-08 18:17:31 +0200 (Tue, 08 Aug 2017) $
+ [$Date: 2018-01-31 08:51:30 +0100 (Wed, 31 Jan 2018) $
KOMA-Script guide language dependencies]
%
% \section{Title}
@@ -427,7 +427,7 @@
die Version anzugeben, auf die im Text Bezug genommen wurde. Bei
einigen Paketen war es mehr ein Ratespiel, eine einheitliche
Versionsnummer und ein Erscheinungsdatum zu finden. Auch muss die
- angegebene Version nicht immer die neueste verf\"ugbare Version sein.
+ angegebene Version nicht immer die neuste verf\"ugbare Version sein.
Wenn Sie sich ein Paket neu besorgen und installieren, sollten Sie
jedoch zun\"achst immer die aktuelle Version ausprobieren. Bevor Sie
ein Dokument oder Paket von einem Server herunterladen, sollten Sie
@@ -521,16 +521,18 @@
Brief-um-ge-bung Brief-um-ge-bun-gen
Da-tei-na-me Da-tei-na-men Da-tei-na-mens
Da-tei-na-men-er-wei-te-rung Da-tei-na-men-er-wei-te-rung-en
- Ein-trags-ebe-ne
+ Ein-trags-ebe-ne Ein-trags-ebe-nen
Gleich-zei-tig
Hin-ter-grund-ebe-ne Hin-ter-grund-ebe-nen
Ka-pi-tel-ebe-ne Ka-pi-tel-ebe-nen
Pa-ket-au-to-ren
Pa-pier-rand Pa-pier-ran-des
Rand-ein-stel-lung Rand-ein-stel-lung-en
- Sei-ten-um-bruch
+ Schrift-ein-stel-lung Schrift-ein-stel-lung-en
+ Sei-ten-um-bruch Schrift-um-schal-tung Schrift-um-schal-tun-gen
Stan-dard-an-wei-sung Stan-dard-an-wei-sun-gen
Stan-dard-ein-stel-lung Stan-dard-ein-stel-lun-gen
+ Text-ebe-ne Text-ebe-nen
Unix
Zei-len-um-bruch Zei-len-um-bruchs Zei-len-um-brü-che Zei-len-um-brü-chen
}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide.tex
index e22f7c8e590..7386ccba9c7 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide.tex
@@ -1,6 +1,6 @@
% ======================================================================
% guide.tex
-% Copyright (c) Markus Kohm, 2002-2015
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% guide.tex
-% Copyright (c) Markus Kohm, 2002-2015
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -48,7 +48,7 @@
\documentclass[\languagename]{scrguide}
\KOMAProvidesFile{guide.tex}
- [$Date: 2015-04-21 10:08:26 +0200 (Tue, 21 Apr 2015) $
+ [$Date: 2018-02-07 13:47:54 +0100 (Wed, 07 Feb 2018) $
KOMA-Script (guide main file)]
\begin{document}
@@ -72,8 +72,8 @@
\dedication{\GuideDedication}
\pdfbookmark[-1]{\KOMAScript}{title}
-\bookmark[level=0,gotor=scrguide.pdf]{Deutsch}
-\bookmark[level=0,gotor=scrguien.pdf]{English}
+\iffree{\bookmark[level=0,gotor=scrguide.pdf]{Deutsch}
+\bookmark[level=0,gotor=scrguien.pdf]{English}}{}
\bookmarksetup{startatroot}
\maketitle
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/introduction.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/introduction.tex
index 25313d5e360..b5cd43b836a 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/introduction.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/introduction.tex
@@ -1,6 +1,6 @@
% ======================================================================
% introduction.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% introduction.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{introduction.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-02-05 10:50:56 +0100 (Mon, 05 Feb 2018) $
KOMA-Script guide introduction]
\chapter{Einleitung}
@@ -118,13 +118,13 @@ reinen Anwender zur Verdeutlichung der Erklärungen dienen sollen. Scheuen Sie
sich nicht, diese Beispiele selbst auszuprobieren und durch Abwandlung
herauszufinden, wie \KOMAScript{} funktioniert. Trotz allem ist diese
Anleitung jedoch keine Einführung in \LaTeX. \LaTeX-Neulingen seien daher
-Dokumente wie \cite{l2kurz} nahe gelegt. Wiedereinsteiger aus der Zeit von
+Dokumente wie \cite{l2kurz} nahegelegt. Wiedereinsteigern aus der Zeit von
\LaTeX~2.09 sei zumindest \cite{latex:usrguide} empfohlen. Auch das Studium des
einen oder anderen Buches zu \LaTeX{} wird empfohlen. Literaturempfehlungen
finden sich beispielsweise in \cite{DANTE:FAQ}. Der Umfang von
-\cite{DANTE:FAQ} ist ebenfalls erheblich. Dennoch wird darum gebeten, das
-Dokument nicht nur irgendwo vorliegen zu haben, sondern es mindestens einmal
-zu lesen und bei Problemen zu konsultieren.
+\cite{DANTE:FAQ} ist ebenfalls erheblich. Dennoch wird darum gebeten, sich
+einen groben Überblick darüber zu verschaffen und es bei Problemen ebenso wie
+\iffree{diese Anleitung}{dieses Buch} zu konsultieren.
\autoref{part:forExperts} richtet sich an fortgeschrittene
\KOMAScript-Anwender. Das sind all diejenigen, die sich bereits mit \LaTeX{}
@@ -147,7 +147,7 @@ fortgeschrittenen Anwender eine Grundlage für fundierte eigene Entscheidungen
vermittelt werden soll. Darüber hinaus sind dort Beispiele für angehende
Paketautoren zu finden. Diese Beispiele sind weniger dazu gedacht, einfach
übernommen zu werden. Vielmehr sollen sie Wissen um Planung und Durchführung
-von \LaTeX-Projekten sowie einiger grundlegender \LaTeX-Anweisungen für
+von \LaTeX-Projekten sowie einige grundlegende \LaTeX-Anweisungen für
Paketautoren vermitteln.
Die Kapitel-Einteilung der Anleitung soll ebenfalls dabei
@@ -189,7 +189,7 @@ auch zu lesen.
\seclabel{history}
%\begin{Explain}
- Anfang der 90er~Jahre wurde Frank Neukam damit beauf"|tragt, ein
+ Anfang der 1990er~Jahre wurde Frank Neukam damit beauf"|tragt, ein
Vorlesungsskript zu setzen. Damals war noch \LaTeX~2.09 aktuell und
es gab keine Unterscheidung nach Klassen und Paketen, sondern alles
waren Stile (engl. \emph{styles}). Die Standarddokumentstile
@@ -211,7 +211,7 @@ auch zu lesen.
Mitte 1994 erschien dann \LaTeXe. Die damit einhergehenden Änderungen waren
tiefgreifend. Daher blieb dem Anwender von {\ScriptII} nur die Entscheidung,
- sich entweder auf den Kompatibilitätsmodus von \LaTeX{} zu beschränken, oder
+ sich entweder auf den Kompatibilitätsmodus von \LaTeX{} zu beschränken oder
auf {\Script} zu verzichten. Wie viele andere wollte ich beides nicht. Also
machte der \KOMAScript-Autor sich daran, einen \Script-Nachfolger für
{\LaTeXe} zu entwickeln, der am 7.~Juli~1994 unter dem Namen {\KOMAScript}
@@ -232,7 +232,7 @@ auch zu lesen.
Schwerpunkt entstanden ist: Flexibilisierung durch Variabilisierung. Unter
diesem Schlagwort verstehe ich die Möglichkeit, in das Erscheinungsbild an
vielen Stellen eingreifen zu können. Dies führte zu vielen neuen Makros, die
- mehr schlecht als recht in die existierende Dokumentation integriert wurden.
+ mehr schlecht als recht in die ursprüngliche Dokumentation integriert wurden.
Irgendwann wurde es damit auch Zeit für eine komplett überarbeitete
Anleitung.
%\end{Explain}
@@ -286,7 +286,7 @@ anzuwenden ist.
\seclabel{installation}
Die drei wichtigsten \TeX-Distributionen, Mac\TeX, MiK\TeX{} und \TeX~Live,
-stellen \KOMAScript{} über Ihre jeweiligen Paketverwaltungen bereit. Es wird
+stellen \KOMAScript{} über ihre jeweiligen Paketverwaltungen bereit. Es wird
empfohlen, die Installation und Aktualisierung von \KOMAScript{} darüber
vorzunehmen. Die manuelle Installation von {\KOMAScript} ohne Verwendung der
jeweiligen Paketverwaltung wird in der Datei \File{INSTALLD.txt}, die
@@ -312,7 +312,7 @@ deren Installation ist die dortige Anleitung zu beachten.
Wenn es sich nicht um einen Fehler in der Dokumentation handelt und der
Fehler oder das Problem nach einem Update noch immer auf"|tritt, erstellen
- Sie bitte wie in \cite{DANTE:FAQ} angegeben ein minimales Beispiel. Gehen
+ Sie bitte, wie in \cite{DANTE:FAQ} angegeben, ein minimales Beispiel. Gehen
Sie dazu wie unten beschrieben vor.
% Ein solches Beispiel sollte nur einen minimalen Text und nur die Pakete
% und Definitionen enthalten, die für die Verdeutlichung des Fehlers
@@ -420,4 +420,5 @@ konzipiert. Für Anfänger sind sie wenig oder nicht geeignet.
%%% TeX-master: "../guide.tex"
%%% End:
-% LocalWords: Installationspakete Zwischenversionen
+% LocalWords: Installationspakete Zwischenversionen Wiedereinsteigern
+% LocalWords: Kompatibilitätsmodus
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/linkalias.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/linkalias.tex
index 16dcdc1d4e8..3d4328a4891 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/linkalias.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/linkalias.tex
@@ -39,7 +39,7 @@
%
\KOMAProvidesFile{linkalias.tex}
- [$Date: 2016-11-20 17:40:30 +0100 (Sun, 20 Nov 2016) $
+ [$Date: 2017-12-03 22:49:27 +0100 (Sun, 03 Dec 2017) $
link aliases for the free version]
\makeatletter
@@ -67,3 +67,6 @@
\lalias{desc:maincls-experts.cmd.AfterBibliographyPreamble}{sec:maincls-experts.addInfos}
\lalias{desc:maincls-experts.option.fontsize}{sec:maincls-experts.addInfos}
\lalias{desc:maincls-experts.cmd.raggedsection}{sec:maincls-experts.coexistence}
+\lalias{desc:maincls-experts.cmd.thepage}{sec:maincls-experts.addInfos}
+\lalias{desc:maincls-experts.cmd.pagemark}{sec:maincls-experts.addInfos}
+\lalias{desc:maincls-experts.cmd.the/Zaehler/}{sec:maincls-experts.addInfos}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/preface.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/preface.tex
index 54f302a3d36..8143c645f8c 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/preface.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/preface.tex
@@ -1,6 +1,6 @@
% ======================================================================
% preface.tex
-% Copyright (c) Markus Kohm, 2008-2017
+% Copyright (c) Markus Kohm, 2008-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% preface.tex
-% Copyright (c) Markus Kohm, 2008-2017
+% Copyright (c) Markus Kohm, 2008-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -36,31 +36,29 @@
% ======================================================================
\KOMAProvidesFile{typearea.tex}
- [$Date: 2017-01-16 09:00:06 +0100 (Mon, 16 Jan 2017) $
- Vorwort nach Version 3.22]
+ [$Date: 2018-03-12 09:45:33 +0100 (Mon, 12 Mar 2018) $
+ Vorwort zu Version 3.25]
-\addchap{Vorwort zu \KOMAScript~3.22a}
+\addchap{Vorwort zu \KOMAScript~3.25}
-Nachdem mit \KOMAScript~3 auch eine strukturell und inhaltlich komplett
-überarbeitete Anleitung erschienen ist, haben mich in den letzten Jahren nur
-noch wenige Kritiken daran erreicht. Offenbar hat es sich auch gelohnt, das
-Kapitel über Briefe um unzählige Beispiele zu erweitern und inhaltlich von dem
-der anderen Klassen weitgehend unabhängig zu machen. Obwohl dadurch diverse
-Abschnitte, wenn auch oftmals mit abgewandelten oder mit ausgelassenen
-Beispielen, mehrfach \iffree{in der Anleitung}{im Buch} enthalten sind, wurde
-dieses Vorgehen daher ab \iffree{\KOMAScript~3.22}{der sechsten Auflage} noch
-konsequenter angewandt und auch auf andere Kapitel übertragen.
+Die Anleitung zu \KOMAScript~3.25 profitiert wieder einmal davon, dass nahezu
+zeitgleich mit dieser Version auch eine überarbeitete Neuauflage der
+Print-Ausgabe \cite{book:komascript} und der eBook-Ausgabe
+\cite{ebook:komascript} erscheinen wird. Das führte zu vielen Verbesserungen,
+die sich auch auf die freie Anleitung auswirken.
-\iffree{Die freie \KOMAScript-Anleitung wurde darüber hinaus farblich neu
- gestaltet und mit unzähligen, neuen Links versehen. Außer in ihrer
- unmittelbaren Beschreibung führt ein Klick beispielsweise auf ein
- \KOMAScript-Makro nun daher auf die jeweils passende Erklärung. Querverweise
- mit der Nummer des passenden Abschnitts oder der Seitenzahl sind dennoch
- weiterhin vorhanden. Dies ist dem gedruckten Buch geschuldet und dient
- darüber hinaus der Orientierung.}{}
+Eine dieser Verbesserungen ist die Verlinkung von Befehlen, Umgebungen,
+Optionen etc. jeweils auf die entsprechende Erklärung innerhalb dieser
+Anleitung. Um innerhalb der Erklärung selbst nicht dazu verleitet zu werden,
+erneut an den Anfang der Erklärung zu springen, und so quasi Leserekursionen
+zu vermeiden, wurde die Verlinkung allerdings nur dann durchgeführt, wenn sie
+tatsächlich von der aktuellen Stelle weg führt.
+
+Viele der Verbesserungen gehen auch auf die fleißigen, freiwilligen
+Korrekturleser zurück. Ihnen sei an dieser Stelle ausdrücklich gedankt.
\iffree{Leser dieser freien Bildschirm-Version müssen allerdings weiterhin mit
- einigen Einschränkungen leben. So sind einige Informationen --
+ gewissen Einschränkungen leben. So sind einige Informationen --
hauptsächliche solche für fortgeschrittene Anwender oder die dazu geeignet
sind, aus einem Anwender einen fortgeschrittenen Anwender zu machen -- der
Buchfassung vorbehalten. Das führt auch dazu, dass weiterhin einige Links in
@@ -70,8 +68,8 @@ konsequenter angewandt und auch auf andere Kapitel übertragen.
Bildschirm parallel zur Arbeit an einem Dokument. Sie hat auch weiterhin
keinen optimierten Umbruch, sondern ist quasi ein erster Entwurf, bei dem
sowohl der Absatz- als auch der Seitenumbruch in einigen Fällen durchaus
- dürftig ist. Entsprechende Optimierungen sind der Buchausgabe
- \cite{book:komascript} vorbehalten.}{}
+ dürftig ist. Entsprechende Optimierungen sind den Buchausgaben
+ vorbehalten.}{}
Nicht nur zur Anleitung erfahre ich inzwischen eher wenig Kritik. Auch zu den
Klassen und Paketen gibt es kaum noch Nachfragen nach neuen Möglichkeiten. Für
@@ -115,7 +113,7 @@ wenn Sie es selbst melden. Näheres zu Fehlermeldungen ist im ersten Kapitel
\iffree{der Anleitung}{des Buches} zu finden.
\bigskip\noindent
-Markus Kohm, Neckarhausen bei eisigen Temperaturen im Januar 2017
+Markus Kohm, Neckarhausen bei Regen im März 2018
\endinput
%%% Local Variables:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scraddr.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scraddr.tex
index 0c64ff8a3d7..9b74b665e64 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scraddr.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scraddr.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scraddr.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scraddr.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{scraddr.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-02-05 10:50:56 +0100 (Mon, 05 Feb 2018) $
KOMA-Script guide (chapter: scraddr)]
\chapter{Adressdateien mit \Package{scraddr} erschließen}%
@@ -54,12 +54,16 @@
\BeginIndexGroup
\BeginIndex{Package}{scraddr}
-\section{Überblick}\seclabel{overview}
-Das Paket \Package{scraddr} ist eine kleine Beigabe zur
-Briefklasse von \KOMAScript. Ziel ist, die Benutzung von Adressdateien zu
-vereinfachen und ihre Anwendung flexibler zu gestalten. Im Grunde stellt das
-Paket nur einen Lademechanismus für Adressdateien bereit, die aus
-\DescRef{\LabelBase.cmd.adrentry}- und neueren \DescRef{\LabelBase.cmd.addrentry}-Einträgen bestehen, wie sie in
+Das Paket \Package{scraddr} ist eine kleine Beigabe zur Briefklasse und zum
+Briefpaket von \KOMAScript. Ziel ist, die Benutzung von Adressdateien zu
+vereinfachen und ihre Anwendung flexibler zu gestalten.
+
+\section{Befehle}
+\seclabel{overview}
+
+Im Grunde stellt das Paket nur einen Lademechanismus für Adressdateien bereit,
+die aus \DescRef{\LabelBase.cmd.adrentry}- und neueren
+\DescRef{\LabelBase.cmd.addrentry}-Einträgen bestehen, wie sie in
\autoref{cha:scrlttr2} ab \DescPageRef{scrlttr2.cmd.adrentry} beschrieben
sind.
@@ -96,11 +100,7 @@ Der Aufbau der Adresseinträge in der Adressdatei wurde in
\DescPageRef{scrlttr2.cmd.adrentry} ausführlich besprochen. Die
ebenfalls dort erwähnte Unterteilung der Adressdatei mit Hilfe von
\Macro{adrchar} oder \Macro{addrchar} hat für \Package{scraddr} keine
-Bedeutung und wird vom Paket ignoriert.
-
-Die Zugriffsbefehle sind mit englischen, den Argumenten entsprechenden
-Bezeichnungen versehen.
-%
+Bedeutung und wird vom Paket ignoriert.%
\EndIndexGroup
\begin{Declaration}
@@ -115,14 +115,15 @@ Bezeichnungen versehen.
\Macro{FreeIII}\Parameter{Kürzel}
\Macro{FreeIV}\Parameter{Kürzel}
\end{Declaration}%
-Der Zugriff erfolgt anhand des Kürzels im letzten Argument eines
-Eintrags, das heißt Argument Nummer 8
-für \DescRef{\LabelBase.cmd.adrentry}-Einträge beziehungsweise Argument Nummer 9
-für \DescRef{\LabelBase.cmd.addrentry}-Einträge. Das bedeutet auch, dass dieses Argument
-nicht leer sein darf.
-Um eine sichere Funktionsweise zu garantieren, empfiehlt es sich,
-das Kürzel nur als Folge von Buchstaben aufzubauen,
-wobei jedoch keine Umlaute benutzt werden dürfen.
+Die englischen Namen der Zugriffsbefehle folgen den Bezeichnungen der
+Argumente von \DescRef{\LabelBase.cmd.adrentry} und
+\DescRef{\LabelBase.cmd.addrentry}. Die Auswahl des Adresseintrags erfolgt
+anhand des Kürzels im letzten Argument eines Eintrags, das heißt Argument
+Nummer 8 für \DescRef{\LabelBase.cmd.adrentry}-Einträge beziehungsweise
+Argument Nummer 9 für \DescRef{\LabelBase.cmd.addrentry}-Einträge. Das
+bedeutet auch, dass dieses Argument nicht leer sein darf. Um eine sichere
+Funktionsweise zu garantieren, empfiehlt es sich, das Kürzel nur als Folge von
+Buchstaben aufzubauen, wobei jedoch keine Umlaute benutzt werden dürfen.
Weiterhin ist zu beachten, dass bei mehrmaligem Auf"|treten
eines Kürzels in den Einträgen die Angaben beim
@@ -131,7 +132,7 @@ letzten Auf"|treten die gültigen sind.%
\EndIndexGroup
-\section{Benutzung}\seclabel{usage}
+\section{Anwendung}\seclabel{usage}
\BeginIndexGroup
\BeginIndex[indexother]{Cmd}{addrentry}%
@@ -155,9 +156,10 @@ folgendermaßen aussehen:
{Meister von Wald, Wasser und Berg}{TOM}
\end{lstcode}
-Das vierte Argument, die Telefonnummer, wurde hier leer gelassen.
-Erstens hat es in dem Zusammenhang keinen Sinn und zweitens sollte
-dies ja auch möglich sein.
+Das vierte Argument, die Telefonnummer, wurde hier leer gelassen,
+da es in Auenland keine Telefone gibt. Wie zu sehen ist, sind also auch leere
+Angaben möglich. Dagegen ist es nicht erlaubt, ein Argument einfach komplett
+weg zu lassen.
\BeginIndexGroup
\BeginIndex[indexother]{Cmd}{InputAddressFile}
@@ -229,13 +231,14 @@ zulässig. Näheres hierzu findet sich im nächsten Abschnitt.
\section{Paketoptionen für Warnungen}
Wie im vorherigen Abschnitt erwähnt, ist die Benutzung des Zugriffsbefehls
-\Macro{FreeIV} bei \DescRef{\LabelBase.cmd.adrentry}-Einträgen nicht zulässig. Wie
-\Package{scraddr} darauf reagiert, ist allerdings durch Paketoptionen
-konfigurierbar. Bitte beachten Sie\textnote{Achtung!}, dass dieses Paket die
-erweiterte Optionenschnittstelle mit \DescRef{maincls.cmd.KOMAoptions} und
-\DescRef{maincls.cmd.KOMAoption} nicht unterstützt. Die Optionen sind also
-entweder als globale Optionen bei \DescRef{maincls.cmd.documentclass} oder als
-lokale Optionen bei \DescRef{maincls.cmd.usepackage} anzugeben.
+\Macro{FreeIV} bei \DescRef{\LabelBase.cmd.adrentry}-Einträgen nicht
+zulässig. Wie \Package{scraddr} darauf reagiert, ist allerdings durch
+Paketoptionen konfigurierbar. Bitte beachten Sie\textnote{Achtung!}, dass
+dieses Paket die erweiterte Optionenschnittstelle mit
+\DescRef{maincls.cmd.KOMAoptions} und \DescRef{maincls.cmd.KOMAoption} nicht
+unterstützt. Die Optionen sind also entweder als globale Optionen bei
+\DescRef{maincls.cmd.documentclass} oder als lokale Optionen bei
+\DescRef{maincls.cmd.usepackage} anzugeben.
\begin{Declaration}
@@ -274,3 +277,6 @@ voreingestellt.%
%%% ispell-local-dictionary: "de_DE"
%%% TeX-master: "../guide"
%%% End:
+
+% LocalWords: Zugriffsbefehle Briefpaket Briefklasse Adresseintrags
+% LocalWords: Ladebefehl Auenland
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbase.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbase.tex
index ea55f54c140..f7f3f533d33 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbase.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbase.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrbase.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrbase.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{scrbase.tex}
- [$Date: 2017-04-22 16:16:15 +0200 (Sat, 22 Apr 2017) $
+ [$Date: 2018-02-16 04:42:17 +0100 (Fri, 16 Feb 2018) $
KOMA-Script package scrbase]
\chapter{Grundlegende Funktionen im Paket \Package{scrbase}}
@@ -64,62 +64,25 @@ haben, können von der Funktionalität von \Package{scrbase} profitieren.
\seclabel{loadit}
Während Anwender ein Paket mit Hilfe von \Macro{usepackage} laden, verwenden
-Paket- und Klassenautoren \Macro{RequirePackage}. Autoren von Wrapper-Paketen
-nutzen auch \Macro{RequirePackageWithOptions}. Bei Verwendung von
-\Macro{RequirePackage} können wie bei \Macro{usepackage} Optionen angegeben
+Paket- und Klassenautoren
+\Macro{RequirePackage}\IndexCmd{RequirePackage}. Autoren von Wrapper-Paketen
+nutzen auch
+\Macro{RequirePackageWithOptions}\IndexCmd{RequirePackageWithOptions}. Bei
+Verwendung von \Macro{RequirePackage} können wie bei
+\Macro{usepackage}\IndexCmd{usepackage} Optionen angegeben
werden. Demgegenüber erhält das Paket bei \Macro{RequirePackageWithOptions}
alle Optionen, mit denen zuvor das Wrapper-Paket geladen wurde. Näheres zu
diesen Anweisungen ist \cite{latex:clsguide} zu entnehmen.
Das Paket \Package{scrbase} benötigt intern die Funktionalität des Pakets
-\Package{keyval}\IndexPackage{keyval}. Diese kann auch vom Paket
-\Package{xkeyval} zur Verfügung gestellt werden. Bei Bedarf lädt
-\Package{scrbase} selbst \Package{keyval}.
+\Package{keyval}\IndexPackage{keyval}\important{\Package{keyval}}. Diese kann
+auch vom Paket \Package{xkeyval} zur Verfügung gestellt werden. Bei Bedarf
+lädt \Package{scrbase} selbst \Package{keyval}.
Das Paket \Package{keyval} erlaubt es, Schlüssel zu definieren und diesen
Werten zuzuweisen. Auch die Optionen, die \Package{scrbase} bereitstellt,
-verwenden die \Package{keyval}-Syntax: \PName{Schlüssel}\texttt{=}\PName{Wert}.
-
-\begin{Declaration}
- \OptionVName{internalonly}{Wert}
-\end{Declaration}
-Von \Package{scrbase} werden einige Verzweigungsanweisungen
-bereitgestellt. Dabei verwendet es primär die Bezeichnungen
-\Macro{scr@\PName{Name}}. Es handelt sich somit um interne
-Anweisungen. Diese werden auch intern von \KOMAScript{} verwendet. Paket- und
-Klassenautoren können diese Anweisungen ebenfalls verwenden, sollten sie aber
-nicht umdefinieren. Da einige dieser Anweisungen auch für Benutzer nützlich
-sein können, werden die gleichen Anweisungen normalerweise auch als
-\Macro{\PName{Name}} bereitgestellt. Da eventuell andere Pakete
-gleichnamige Anweisungen mit anderer Syntax bereitstellen könnten und es so zu
-Konflikten kommen könnte, kann der Anwender die Definition von
-\Macro{\PName{Name}} verhindern. Dazu gibt er entweder die Option
-ohne Wertangabe an. In diesem Fall werden nur die internen
-Verzweigungsanweisungen definiert. Oder er gibt genau die Anweisungen, die
-nicht definiert werden sollen, als Wert an, wobei er »\Macro{}« durch
-»\texttt{/}« ersetzt.
-
-Paket- und Klassenautoren sollten diese Option normalerweise nicht verwenden.
-Anwender können sie mit oder ohne Wertangabe entweder als globale Option bei
-\Macro{documentclass} oder per \Macro{PassOptionsToPackage} angeben.
-\begin{Example}
- Der Anwender will nicht, dass die Anweisungen \Macro{ifVTeX} und
- \DescRef{\LabelBase.cmd.ifundefinedorrelax} von \Package{scrbase} definiert werden. Also
- verwendet er beim Laden der Klasse:
-\begin{lstcode}
- \documentclass%
- [internalonly=/ifVTeX/ifundefinedorrelax]%
- {foo}
-\end{lstcode}
- Der Klassenname \Class{foo} wird hier als Platzhalter für irgendeine Klasse
- verwendet. Die Bedeutungen der Anweisungen \Macro{ifVTeX} und
- \DescRef{\LabelBase.cmd.ifundefinedorrelax} sowie weitere Verzweigungsanweisungen sind
- \autoref{sec:scrbase.if}, %\DescPageRef{scrbase.cmd.ifVTeX} und
- %\DescPageRef{scrbase.cmd.ifundefinedorrelax}
- ab \autopageref{sec:scrbase.if} zu entnehmen.
-\end{Example}
-%
-\EndIndexGroup
+verwenden die \Package{keyval}-Syntax: \OptionVName{\PName{Schlüssel}}{Wert}%
+\important{\OptionVName{\PName{Schlüssel}}{Wert}}.
\section{Schlüssel als Eigenschaften von Familien und deren Mitgliedern}
@@ -155,20 +118,20 @@ des Ladens einer Klasse oder eines Pakets sind \Macro{@currname} und
Theoretisch wäre es möglich, mit einem leeren optionalen Argument
\PName{Mitglied} auch ein Mitglied ohne Name zu definieren. Dies würde jedoch
-der Familie selbst entsprechen. Es wird empfohlen als \PName{Familienname} nur
+der Familie selbst entsprechen. Es wird empfohlen, als \PName{Familienname} nur
Buchstaben und Ziffern zu verwenden und das \PName{Mitglied} immer mit einem
anderen Zeichen, vorzugsweise einem Punkt, zu beginnen. Anderenfalls könnte
es passieren, dass sich Mitglieder einer Familie mit Mitgliedern anderer
Familien überdecken.
\Package{scrbase} definiert selbst bereits die Familie »\PValue{KOMA}« und
-fügt ihr das Mitglied »\PValue{.scrbase.sty}« hinzu. Grundsätzlich ist die
-Familie »\PValue{KOMA}« \KOMAScript{} vorbehalten. Es wird empfohlen für
-eigene Pakete den Namen des Gesamtpakets als Familie und den Namen einzelner
-Pakete im Gesamtpaket als Mitglied zu verwenden.
+fügt ihr das Mitglied »\PValue{.scrbase.sty}« hinzu. Grundsätzlich sind die
+Familien »\PValue{KOMA}« und »\PValue{KOMAarg}« \KOMAScript{} vorbehalten. Es
+wird empfohlen, für eigene Pakete den Namen des Gesamtpakets als Familie und
+den Namen einzelner Pakete im Gesamtpaket als Mitglied zu verwenden.
%
\begin{Example}
- Angenommen Sie schreiben ein neues Gesamtpaket »Fleischermeister«. Darin
+ Angenommen, Sie schreiben ein neues Gesamtpaket »Fleischermeister«. Darin
befinden sich die Pakete \File{Salami.sty}, \File{Mettwurst.sty} und
\File{Krakauer.sty}. Daher entscheiden Sie sich für den Familienname
»\PValue{Fleischermeister}« und fügen in jedem der Pakete die Zeilen
@@ -199,17 +162,20 @@ Pakete im Gesamtpaket als Mitglied zu verwenden.
\end{Declaration}
Mit dieser Anweisung wird ein \PName{Schlüssel} definiert. Ist ein
\PName{Mitglied} angegeben, so ist der \PName{Schlüssel} eine Eigenschaft
-dieses Mitglieds der angegebenen \PName{Familie}. Ist kein Mitglied
-angegeben, so wird wieder das Mitglied
-»\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}« angenommen. Wird
-später dem \PName{Schlüssel} ein Wert zugewiesen, so wird \PName{Aktion}
+dieses Mitglieds der angegebenen \PName{Familie}. Ist\textnote{Hinweis}
+\OParameter{Mitglied} nicht angegeben, so wird wieder das Mitglied
+»\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}« angenommen. Ist das
+\PName{Mitglied} hingegen leer, so wird ein Familienschlüssel anstelle eines
+Mitgliederschlüssels definiert.
+
+Wird später dem \PName{Schlüssel} ein Wert zugewiesen, so wird \PName{Aktion}
ausgeführt, wobei der Wert als Parameter übergeben wird. Innerhalb von
\PName{Aktion} steht also »\lstinline{#1}« für den übergebenen Wert. Wurde
kein Wert übergeben, so wird stattdessen der \PName{Säumniswert}
eingesetzt. Falls kein \PName{Säumniswert} angegeben wird, kann später der
\PName{Schlüssel} nur mit Wertübergabe verwendet werden.
-\begin{Explain}
+%\begin{Explain}
\phantomsection\label{explain:scrbase.macro.DefineFamilyKey}%
Letztlich führt
\begin{lstcode}[escapeinside=»«]
@@ -225,18 +191,21 @@ eingesetzt. Falls kein \PName{Säumniswert} angegeben wird, kann später der
definiert ist (siehe \cite{package:keyval}). Allerdings kommen zu dem Aufruf
von \Macro{define@key} noch einige zusätzliche Vorkehrungen und auch die
\PName{Aktion} wird um zusätzliche Vorkehrungen erweitert.
-\end{Explain}
+%\end{Explain}
Erfolg\ChangedAt{v3.12}{\Package{scrbase}} oder Misserfolg der Ausführung der
\PName{Aktion} werden über
\Macro{FamilyKeyState} %\important{\Macro{FamilyKeyState}} % einige davon sind
% schlicht zu breit!
-an \Package{scrbase} zurück gemeldet, damit dieses je nach Bedarf und
-Verwendung des Schlüssels weitere Maßnahmen ergreifen kann. In der
-Voreinstellung ist \Macro{FamilyKeyState} identisch mit
-\Macro{FamilyKeyStateUnknown}. Das bedeutet, dass es nicht sicher ist, ob der
-Schlüssel korrekt verarbeitet werden konnte. Findet \Package{scrbase} nach
-Ausführung der \PName{Aktion} noch immer diesen Zustand vor, so wird ein
+an \Package{scrbase} zurückgemeldet, damit dieses je nach Bedarf und
+Verwendung des Schlüssels weitere Maßnahmen ergreifen kann. Dies kann
+beispielsweise eine Fehlermeldung aber auch nur die Signalisierung einer
+unbekannten Option sein.
+
+Der Zustand \Macro{FamilyKeyState} ist in der Voreinstellung identisch mit dem
+Zustand \Macro{FamilyKeyStateUnknown}. Das bedeutet, dass es nicht sicher ist,
+ob der Schlüssel korrekt verarbeitet werden konnte. Findet \Package{scrbase}
+nach Ausführung der \PName{Aktion} noch immer diesen Zustand vor, so wird ein
Hinweis in die \File{log}-Datei geschrieben und im weiteren der Zustand
\Macro{FamilyKeyStateProcessed} angenommen.
@@ -251,9 +220,9 @@ Der Zustand
\Macro{FamilyKeyStateUnknownValue} %\important{\Macro{FamilyKeyStateUnknownValue}}
signalisiert, dass der Schlüssel zwar verarbeitet wurde, ihm jedoch ein Wert
zugewiesen werden sollte, der nicht erlaubt ist. Diesen Zustand meldet
-beispielsweise \Package{typearea}, wenn versucht wird, an Option
-\Option{twoside} den Wert \PValue{unbekannt} zuzuweisen. Die Umschaltung auf
-den Zustand erfolgt einfach durch Aufruf von
+beispielsweise \hyperref[cha:typearea]{\Package{typearea}}, wenn versucht
+wird, an Option \DescRef{typearea.option.twoside} den Wert \PValue{unbekannt}
+zuzuweisen. Die Umschaltung auf den Zustand erfolgt einfach durch Aufruf von
\Macro{FamilyKeyStateUnknownValue} selbst.
Der Zustand
@@ -265,7 +234,7 @@ wurde. Dieser Zustand wird automatisch gesetzt, wenn ein Schlüssel, der keinen
wäre aber auch eine explizite Umschaltung darauf durch Aufruf von
\Macro{FamilyKeyStateNeedValue} selbst möglich.
-Desweiteren können zusätzliche Fehlerzustände definiert werden, indem man
+Des Weiteren können zusätzliche Fehlerzustände definiert werden, indem man
\Macro{FamilyKeyState} auf eine kurze Meldung umdefiniert. In der Regel
sollten jedoch die vier vordefinierten Zustände verwendet werden.
@@ -279,7 +248,8 @@ sollten jedoch die vier vordefinierten Zustände verwendet werden.
\newif\if@Salami@Aufschnitt
\DefineFamilyKey{Fleischermeister}%
{Aufschnitt}[true]{%
- \expandafter\let\expandafter\if@Salami@Aufschnitt
+ \expandafter\let
+ \expandafter\if@Salami@Aufschnitt
\csname if#1\endcsname
\FamilyKeyStateProcessed
}
@@ -289,8 +259,8 @@ sollten jedoch die vier vordefinierten Zustände verwendet werden.
nicht. Stattdessen wird immer zurückgemeldet, dass der Schlüssel vollständig
und korrekt verarbeitet wurde. Wird der Schlüssel später verwendet, so muss
entweder einer der erlaubten Werte zugewiesen oder ein Aufruf ohne
- Wertzuweisung verwendet werden. In letzterem Fall wird der Säumniswert
- \PName{true} zugewiesen.
+ Wertzuweisung verwendet werden. In letzterem Fall kommt der Säumniswert
+ \PName{true} zum Einsatz.
Für die anderen beiden Pakete kann das fast identisch definiert
werden. Lediglich die Zeichenfolge »\texttt{Salami}« ist jeweils zu
@@ -309,22 +279,31 @@ Wurde\ChangedAt{v3.15}{\Package{scrbase}} \PName{Schlüssel} zuvor als
quasi aufgehoben. Der \PName{Schlüssel} ist dann für dieses \PName{Mitglied}
der \PName{Familie} nicht mehr definiert. Die Verwendung für einen
\PName{Schlüssel}, der für dieses \PName{Mitglied} der \PName{Familie} gar
-nicht definiert ist, ist ebenfalls zulässig.%
+nicht definiert ist, ist ebenfalls zulässig.
+
+Ist kein \PName{Mitglied} angegeben, so wird genau wie bei Anweisung
+\DescRef{\LabelBase.cmd.DefineFamilyKey} wieder das Mitglied
+»\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}« angenommen. Allerdings
+wird \Macro{RelaxFamilyKey} selten während des Ladens eines Pakets,
+sondern häufiger zur Laufzeit verwendet. Daher ist \PName{Mitglied} in der
+Regel auch explizit anzugeben.%
\EndIndexGroup
\begin{Declaration}
\Macro{FamilyProcessOptions}\OParameter{Mitglied}\Parameter{Familie}
\end{Declaration}
-Grundsätzlich ist die Erweiterung der Schlüssel von Familien auf Familien
-und Familienmitglieder dazu gedacht, dass Schlüssel beziehungsweise die
+Grundsätzlich ist die Erweiterung der Schlüssel von Familien auf Familien und
+Familienmitglieder dazu gedacht, dass Schlüssel beziehungsweise die
Wertzuweisung an Schlüssel als ganz normale Klassen- oder Paketoptionen
verwendet werden können. Diese Anweisung stellt daher eine Erweiterung von
-\Macro{ProcessOptions*} aus dem \LaTeX-Kern dar (siehe
+\Macro{ProcessOptions*}\IndexCmd{ProcessOptions*}%
+\important{\Macro{ProcessOption*}} aus dem \LaTeX-Kern dar (siehe
\cite{latex:clsguide}). Dabei verarbeitet die Anweisung nicht nur Optionen,
-die mit \Macro{DeclareOption} definiert wurden. Es werden auch alle Schlüssel
-eines angegebenen Familienmitglieds abgearbeitet. Wird das optionale Argument
-\PName{Mitglied} nicht angegeben, so wird wieder das Mitglied
+die mit \Macro{DeclareOption}\IndexCmd{DeclareOption}%
+\important{\Macro{DeclareOption}} definiert wurden. Es werden auch alle
+Schlüssel eines angegebenen Familienmitglieds abgearbeitet. Wird das optionale
+Argument \PName{Mitglied} nicht angegeben, so wird wieder das Mitglied
»\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}« verwendet.
Eine Besonderheit sind Schlüssel, die nicht einem Familienmitglied, sondern
@@ -332,14 +311,16 @@ der Familie selbst zugeordnet sind, bei der also das Mitglied leer geblieben
ist. Diese werden ebenfalls gesetzt und zwar noch bevor der Schlüssel des
Mitglieds gesetzt wird.
\begin{Example}
- Wenn in den Paketen aus den zurückliegenden Beispielen die Zeile
+ Wenn in den Paketen aus den zurückliegenden Beispielen nach der Definition
+ der Schlüssel die Zeile
\begin{lstcode}
\FamilyProcessOptions{Fleischermeister}
\end{lstcode}
- ergänzt wird, so kann der Anwender bereits beim Laden der Pakete die
- Eigenschaft \Option{Aufschnitt} wählen. Wird die Option global, also bei
- \Macro{documentclass} angegeben, so wird die Eigenschaft automatisch bei
- allen drei Paketen gesetzt, wenn alle drei Pakete geladen werden.
+ ergänzt wird, so kann der Anwender bereits beim Laden der Pakete mit
+ \Macro{usepackage} die Eigenschaft \Option{Aufschnitt} als Option
+ angeben. Wird die Option global, also bei \Macro{documentclass}, angegeben,
+ so wird die Eigenschaft automatisch bei allen drei Paketen gesetzt, wenn
+ alle drei Pakete einzeln geladen werden.
\end{Example}
Es\textnote{Achtung!} wird darauf hingewiesen, dass bei Paketen globale
Optionen vor den lokal dem Paket zugewiesenen Optionen ausgeführt
@@ -370,39 +351,45 @@ Ausführung von Optionen Pakete zu laden.%, die selbst
Insbesondere\ChangedAt{v3.18}{\Package{scrbase}} Autoren von Wrapper-Klassen
wünschen manchmal, in ein Paket oder eine Klasse noch vor der Verarbeitung der
Optionen eines zukünftig geladenen Pakets oder einer zukünftig geladenen
-Klasse mit \DescRef{\LabelBase.cmd.FamilyProcessOptions} eingreifen zu können. Dies ist mit
-\Macro{BeforeFamilyProcessOptions} möglich. Das Paket \Package{scrbase} bietet
-dafür einen sogenannten Haken (engl. \emph{hook}). Diesem kann man mit
-\Macro{BeforeFamilyProcessOptions} neuen \PName{Code} hinzufügen. Die
-Parameter \PName{Mitglied} und \PName{Familie} entsprechen dabei denen von
+Klasse mit \DescRef{\LabelBase.cmd.FamilyProcessOptions} eingreifen zu
+können. Dies ist mit \Macro{BeforeFamilyProcessOptions} möglich. Das Paket
+\Package{scrbase} bietet dafür einen sogenannten Haken\Index{Haken}
+(engl. \emph{hook}). Diesem kann man mit \Macro{BeforeFamilyProcessOptions}
+neuen \PName{Code} hinzufügen. Die Parameter \PName{Mitglied} und
+\PName{Familie} entsprechen dabei denen von
\Macro{FammilyProcessOptions}. Allerdings kann man auch den Haken von
Familien-Mitgliedern \PName{Code} hinzufügen, wenn bisher die \PName{Familie}
oder das \PName{Mitglied} noch gar nicht definiert ist.
Der Haken eines Familien-Mitglieds wird übrigens nach dessen Ausführung
automatisch gelöscht. Verwendet man hingegen ein leeres \PName{Mitglied}, so
-wird dieser Haken für alle Mitglieder der \PName{Familie} ausgeführt und
-bleibt auch über die Ausführung hinaus erhalten.
+wird dieser Haken\Index{Haken} für alle Mitglieder der \PName{Familie}
+ausgeführt und bleibt auch über die Ausführung hinaus erhalten.
\begin{Example}
- Sie schreiben ein Paket, das selbst \Package{Mettwurst} lädt. Allerdings
- wollen Sie nicht, dass für dieses Paket die Option \Option{Aufschnitt}
- gesetzt werden kann. Daher deaktivieren sie die Option vor dem Laden des
- Pakets über \Macro{BeforeFamilyProcessOptions}.
+ Sie schreiben ein Paket \Package{Rauchwurst}, das selbst \Package{Mettwurst}
+ lädt. Allerdings wollen Sie nicht, dass für dieses Paket die Option
+ \Option{Aufschnitt} gesetzt werden kann. Daher deaktivieren sie die Option
+ vor dem Laden des Pakets über \Macro{BeforeFamilyProcessOptions}.
\begin{lstcode}
\RequirePackage{scrbase}
- \BeforeFamilyProcessOptions[.Mettwurst.sty]{Fleischermeister}{%
- \RelaxFamilyKey[.Mettwurst.sty]{Fleischermeister}{Aufschnitt}%
+ \BeforeFamilyProcessOptions[.Mettwurst.sty]%
+ {Fleischermeister}{%
+ \RelaxFamilyKey[.Mettwurst.sty]%
+ {Fleischermeister}{Aufschnitt}%
}
\RequirePackageWithOptions{Mettwurst}
\end{lstcode}
- Versucht nun jemand Ihr Paket mit Option \Option{Aufschnitt} zu laden, so
- meldet das Paket \Package{Mettwurst}, dass diese Option nicht bekannt
- ist. Wird die Option \Option{Aufschnitt} als globale Option angegeben, so
- ignoriert Paket \Package{Mettwurst} diese. Voreinstellungen innerhalb des
- Pakets beispielsweise mit \DescRef{\LabelBase.cmd.FamilyExecuteOptions} noch vor
- \DescRef{\LabelBase.cmd.FamilyProcessOptions} sind allerdings davon
- unabhängig.
+ Versucht nun jemand Ihr Paket mit Option
+ \Option{Aufschnitt} zu laden, so meldet das Paket \Package{Mettwurst}, dass
+ diese Option nicht bekannt ist. Wird die Option \Option{Aufschnitt} als
+ globale Option angegeben, so ignoriert Paket \Package{Mettwurst}
+ diese. Voreinstellungen innerhalb des Pakets \Package{Mettwurst}, die
+ beispielsweise mit \DescRef{\LabelBase.cmd.FamilyExecuteOptions} noch vor
+ \DescRef{\LabelBase.cmd.FamilyProcessOptions} erfolgen könnten, wären
+ allerdings davon unabhängig. Aber natürlich kann man eigene
+ Voreinstellungen von \Package{Rauchwurst} aus ebenfalls per
+ \Macro{BeforeFamilyProcessOptions} in \Package{Mettwurst} einschleusen.%
\end{Example}
\EndIndexGroup
@@ -421,14 +408,15 @@ eines angegebenen Familienmitglieds abgearbeitet. Wird das optionale Argument
Eine Besonderheit sind Schlüssel, die nicht einem Familienmitglied, sondern
der Familie selbst zugeordnet sind, bei der also das Mitglied leer geblieben
-ist. Diese werden ebenfalls gesetzt und zwar noch bevor der Schlüssel des
+ist. Diese werden ebenfalls gesetzt, und zwar noch bevor der Schlüssel des
Mitglieds gesetzt wird.
\begin{Example}
Angenommen, die Option \Option{Aufschnitt} soll in den zurückliegenden
Beispielen bereits als Voreinstellung gesetzt werden, so müssen die Pakete
- nur um die Zeile
+ nur um den Aufruf
\begin{lstcode}
- \FamilyExecuteOptions{Fleischermeister}{Aufschnitt}
+ \FamilyExecuteOptions{Fleischermeister}
+ {Aufschnitt}
\end{lstcode}
ergänzt werden.
\end{Example}
@@ -436,11 +424,12 @@ Mitglieds gesetzt wird.
Wird\ChangedAt{v3.20}{\Package{scrbase}} \Macro{FamilyExecuteOptions} mit
einer nicht definierten Option in der \PName{Optionenliste} aufgerufen, so
wird normalerweise ein Fehler ausgegeben. Eine Ausnahme von dieser Regel ist,
-wenn für das \PName{Mitglied} eine Option namens \Option{@else@} definiert
-wurde. In diesem Fall wird statt der unbekannten Option eben diese Option
-\Option{@else@} verwendet. Innerhalb von \KOMAScript{} wird das
-beispielsweise verwendet, um die Stil-Option bei der Definition von
-Gliederungsbefehlen vor allen anderen auszuwerten.
+wenn für das \PName{Mitglied} eine Option namens
+\Option{@else@}\important{\Option{@else@}} definiert wurde. In diesem Fall
+wird statt der unbekannten Option eben diese Option \Option{@else@}
+verwendet. Innerhalb von \KOMAScript{} wird das beispielsweise genutzt, um
+die Stil-Option bei der Definition von Gliederungsbefehlen vor allen anderen
+auszuwerten.
Diese Anweisung darf auch innerhalb der Ausführung von Optionen verwendet
werden.%
@@ -451,18 +440,18 @@ werden.%
\begin{Declaration}
\Macro{FamilyOptions}\Parameter{Familie}\Parameter{Optionenliste}%
\end{Declaration}
-Die \PName{Optionenliste} hat dabei die Form:
-\begin{flushleft}\begin{tabular}{l}
- \PName{Schlüssel}\texttt{=}\PName{Wert}\texttt{,}%
- \PName{Schlüssel}\texttt{=}\PName{Wert} \dots
-\end{tabular}\vskip\dp\strutbox\end{flushleft}
-wobei für \PName{Schlüssel}, für die ein Säumniswert definiert ist, die
-Wertzuweisung natürlich auch entfallen kann.
-
Im Gegensatz zu normalen Optionen, die mit \Macro{DeclareOption} definiert
wurden, können die \PName{Schlüssel} auch noch nach dem Laden der Klasse oder
des Pakets gesetzt werden. Dazu verwendet der Anwender
-\Macro{FamilyOptions}. Dabei werden die \PName{Schlüssel} aller Mitglieder der
+\Macro{FamilyOptions}. Die \PName{Optionenliste} hat dabei die Form:
+%\begin{flushleft}\begin{tabular}{l}
+ \PName{Schlüssel}\texttt{=}\PName{Wert}\texttt{,}\linebreak[1]%
+ \PName{Schlüssel}\texttt{=}\PName{Wert} \dots{}
+%\end{tabular}\vskip\dp\strutbox\end{flushleft}
+wobei für \PName{Schlüssel}, für die ein Säumniswert definiert ist, die
+Wertzuweisung natürlich auch entfallen kann.
+
+Durch die Anweisung werden die \PName{Schlüssel} aller Mitglieder der
angegebenen \PName{Familie} gesetzt. Existiert ein \PName{Schlüssel} auch als
Eigenschaft der Familie selbst, so wird dieser Familien-Schlüssel zuerst
gesetzt. Danach folgen die Mitglieder-Schlüssel in der Reihenfolge, in der die
@@ -470,7 +459,8 @@ Mitglieder definiert wurden. Existiert ein angegebener \PName{Schlüssel} weder
für die Familie noch für ein Mitglied der Familie, so wird von
\Macro{FamilyOptions} ein Fehler ausgegeben. Dies geschieht ebenfalls, wenn
zwar für einige Mitglieder ein Schlüssel existiert, jedoch jedes dieser
-Mitglieder über \DescRef{\LabelBase.cmd.FamilyKeyState} einen Fehler zurückmeldet.
+Mitglieder über \DescRef{\LabelBase.cmd.FamilyKeyState} einen Fehler
+zurückmeldet.
\begin{Example}
Sie ergänzen das Fleischermeister-Projekt um ein weiteres Paket
\Package{Wurstsalat}. Wird dieses Paket verwendet, so sollen alle
@@ -492,7 +482,7 @@ Mitglieder über \DescRef{\LabelBase.cmd.FamilyKeyState} einen Fehler zurückmelde
\DefineFamilyKey{Fleischermeister}%
{Aufschnitt}[true]{}%
\end{lstcode}
- Allerdings produzieren so Wurstpakete, die nach
+ Allerdings produzieren so Wurstpakete, die nach Paket
\Package{Wurstsalat} geladen werden, keinen Aufschnitt. Dies kann man
ebenfalls ändern:
\begin{lstcode}
@@ -503,21 +493,32 @@ Mitglieder über \DescRef{\LabelBase.cmd.FamilyKeyState} einen Fehler zurückmelde
}
\DefineFamilyKey{Fleischermeister}%
{Aufschnitt}[true]{%
- \AtBeginDocument{\FamilyOptions{Fleischermeister}%
- {Aufschnitt=#1}}%
+ \AtBeginDocument{%
+ \FamilyOptions{Fleischermeister}%
+ {Aufschnitt=#1}%
+ }%
}%
\end{lstcode}
Somit wird zunächst während \Macro{begin}\PParameter{document} die Option so
definiert, dass sie für das Paket \Package{Wurstsalat} keine Funktion mehr
- ausübt. Da zu diesem Zeitpunkt \Macro{@currname} und \Macro{@currext} nicht
- mehr gültig sind, muss dabei das optionale Argument von
- \DescRef{\LabelBase.cmd.DefineFamilyKey} verwendet werden. Bis zu dieser Umdefinierung der
- Option wird jedoch eine Definition verwendet, die während
- \Macro{begin}\PParameter{document} die Option erneut für die gesamte Familie
- ausführt und damit auch für andere Wurstpakete setzt.
-\end{Example}
+ ausübt. Da nach dem Laden von \Package{Wurstsalat}, innerhalb von
+ \Macro{begin}\PParameter{document} die beiden Anweisungen \Macro{@currname}
+ und \Macro{@currext} nicht mehr den Dateinamen des Pakets enthalten, muss
+ zwingend das optionale Argument von \DescRef{\LabelBase.cmd.DefineFamilyKey}
+ verwendet werden.
+
+ Bis zu dieser Umdefinierung der Option wird jedoch eine Definition
+ verwendet, die während \Macro{begin}\PParameter{document} die Option erneut
+ für die Familie und all ihre Mitglieder ausführt und damit auch für andere
+ Wurstpakete setzt. Die Verzögerung der Ausführung von \Macro{FamilyOptions}
+ ist hier entscheidend. Zum einen werden nur so später geladene Wurstpakete
+ erfasst. Zum anderen wird dadurch sichergestellt, dass die eigene Option
+ \Option{Aufschnitt} bereits umdefiniert wurde. Dadurch wird eine endlose
+ Rekursion vermieden.%
+\end{Example}%
%
\EndIndexGroup
+\vskip-\ht\strutbox% Umbruchkorrektur wegen Beispiel am Ende
\begin{Declaration}
@@ -526,14 +527,14 @@ Mitglieder über \DescRef{\LabelBase.cmd.FamilyKeyState} einen Fehler zurückmelde
\end{Declaration}
Neben Optionen, die sich gegenseitig ausschließende Werte besitzen, kann es
auch Optionen geben, die gleichzeitig mehrere Werte annehmen können. Für diese
-wäre es bei Verwendung von \DescRef{\LabelBase.cmd.FamilyOptions} notwendig, der Option mehrfach
-einen Wert zuzuweisen und dabei die Option selbst mehrfach
+wäre es bei Verwendung von \DescRef{\LabelBase.cmd.FamilyOptions} notwendig,
+der Option mehrfach einen Wert zuzuweisen und dabei die Option selbst mehrfach
anzugeben. Stattdessen kann man einfach mit \Macro{FamilyOption} einer
einzigen \PName{Option} eine ganze \PName{Werteliste} zuweisen. Die
\PName{Werteliste} ist dabei eine durch Komma separierte Liste von Werten:
-\begin{flushleft}\begin{tabular}{l}
- \PName{Wert}\texttt{,}\PName{Wert} \dots
-\end{tabular}\end{flushleft}
+%\begin{flushleft}\begin{tabular}{l}
+ \PName{Wert}\texttt{,}\PName{Wert} \dots{}
+%\end{tabular}\end{flushleft}
In diesem Zusammenhang sei darauf hingewiesen, dass die Verwendung eines
Kommas in einem Wert möglich ist, wenn man den Wert in geschweifte Klammern
setzt. Die weitere Funktionsweise ist der vorhergehenden Erklärung zu
@@ -554,7 +555,7 @@ setzt. Die weitere Funktionsweise ist der vorhergehenden Erklärung zu
definiert. Eine Fehlerbehandlung für den Fall, dass der Anwender unbekannte
Zutaten fordert, existiert nicht.
- Für einen Salat mit Zwiebeln und Gurken, kann der Anwender
+ Für einen Salat mit Zwiebeln und Gurken kann der Anwender
\begin{lstcode}
\FamilyOptions{Fleischermeister}{%
SalatZusatz=Zwiebeln,SalatZusatz=Gurken}
@@ -586,7 +587,7 @@ oder \DescRef{\LabelBase.cmd.FamilyOption}\IndexCmd{FamilyOptions}
abgeschlossen sind. Genau das ist mit Hilfe von \Macro{AtEndOfFamilyOptions}
und dessen Sternvariante\ChangedAt{v3.23}{\Package{scrbase}} möglich. Die
Rückmeldung von Fehlerzuständen ist über diese Anweisung jedoch ebenso wenig
-möglich, wie die Verwendung dieser Anweisung außerhalb der Ausführung von
+möglich wie die Verwendung dieser Anweisung außerhalb der Ausführung von
Optionen.
Die beiden Variante unterscheiden sich im Falle von verschachtelt definierten
@@ -595,8 +596,10 @@ anderen Option bedingt. In diesem Fall werden alle per
\Macro{AtEndOfFamilyOptions} festgelegten Aktionen ausgeführt, sobald der
innerste Optionenaufruf endet. Dagegen werden die per
\Macro{AtEndOfFamilyOptions*} festgelegten Aktionen erst mit dem Ende des
-äußersten Optionenaufrufs ausgeführt. Die Reihenfolge der Aktionen ist dabei
-jedoch ausdrücklich unbestimmt!%
+äußersten Optionenaufrufs ausgeführt. Die Reihenfolge\textnote{Achtung!} der
+Aktionen ist dabei jedoch ausdrücklich unbestimmt! Weder ist sichergestellt,
+dass zuerst angeforderte Aktionen auch zuerst ausgeführt werden, noch die
+umgekehrte Reihenfolge.%
\EndIndexGroup
@@ -615,13 +618,13 @@ solche booleschen Schalter ein häufiger Anwendungsfall sind, kann man sie bei
\Package{scrbase} einfach mit \Macro{FamilyBoolKey} definieren. Dabei sind die
Argumente \PName{Mitglied}, \PName{Familie} und \PName{Schlüssel} die gleichen
wie bei \DescRef{\LabelBase.cmd.DefineFamilyKey} (siehe
-\DescPageRef{scrbase.cmd.DefineFamilyKey}). Das Argument
-\PName{Schaltername} ist der Name eines Schalter ohne den Präfix
-\Macro{if}. Existiert dieser Schalter noch nicht, so wird er automatisch
-definiert und mit \PName{false} voreingestellt. Intern verwendet
-\Macro{FamilyBoolKey} dann \Macro{FamilySetBool} als \PName{Aktion} für
-\DescRef{\LabelBase.cmd.DefineFamilyKey}. Der Säumniswert für eine solche Option ist immer
-\PValue{true}.
+\DescPageRef{scrbase.cmd.DefineFamilyKey}). Das Argument \PName{Schaltername}
+ist der Name eines Schalter ohne den Präfix \Macro{if}. Existiert dieser
+Schalter noch nicht, so wird er automatisch definiert und mit \PName{false}
+voreingestellt. Intern verwendet \Macro{FamilyBoolKey} dann
+\Macro{FamilySetBool} als \PName{Aktion} für
+\DescRef{\LabelBase.cmd.DefineFamilyKey}. Der Säumniswert für eine solche
+Option ist immer \PValue{true}.
\Macro{FamilySetBool} wiederum versteht als \PName{Wert} neben \PValue{true}
auch die Werte \PValue{on} und \PValue{yes} zum Einschalten und neben
@@ -650,35 +653,41 @@ dann gegebenenfalls eine Meldung über eine unbekannte Wertzuweisung ausgegeben
...
\fi
\end{lstcode}
- Dies wäre dann in allen drei Wurstpaketen identisch. Damit könnte man
+ Dies wäre in allen drei Wurstpaketen identisch. Damit könnte man
prinzipiell die Eigenschaft »Aufschnitt« auch als Eigenschaft der Familie
definieren:
\begin{lstcode}[moretexcs={define@key}]
\@ifundefined{if@Aufschnitt}{%
- \expandafter\newif\csname if@Aufschnitt\endcsname
+ \expandafter\newif
+ \csname if@Aufschnitt\endcsname
}{}%
- \DefineFamilyKey[]{Fleischermeister}
+ \DefineFamilyKey[]{Fleischermeister}%
{Aufschnitt}[true]{%
- \FamilySetBool{Fleischermeister}{Aufschnitt}%
- {@Aufschnitt}%
- {#1}%
+ \FamilySetBool{Fleischermeister}%
+ {Aufschnitt}%
+ {@Aufschnitt}%
+ {#1}%
}
\end{lstcode}
oder einfacher
\begin{lstcode}
- \FamilyBoolKey[]{Fleischermeister}{Aufschnitt}%
- {@Aufschnitt}
+ \FamilyBoolKey[]{Fleischermeister}%
+ {Aufschnitt}%
+ {@Aufschnitt}
\end{lstcode}
- unter Ausnutzung des weiterführenden Hinweises auf
- \autopageref{explain:scrbase.macro.DefineFamilyKey}, der nicht nur für
- \DescRef{\LabelBase.cmd.DefineFamilyKey}, sondern entsprechend auch für \Macro{FamilyBoolKey}
- gilt.
-
- Da \DescRef{\LabelBase.cmd.FamilyKeyState} bereits von \Macro{FamilySetBool} gesetzt wird,
- kann innerhalb der Definition der Option mit Hilfe von
- \DescRef{\LabelBase.cmd.DefineFamilyKey} der Status gegebenenfalls auch abgefragt werden. So
- könnte man im ersten Fall beispielsweise nach \Macro{FamilySetBool} einen
- Test der Art:
+ unter Ausnutzung des Hinweises bezüglich leerer Mitglieder
+ \iftrue% Umbruchkorrekturtext
+ im Gegensatz zum Weglassen des optionalen Arguments
+ \fi%
+ auf \autopageref{explain:scrbase.macro.DefineFamilyKey}, der nicht nur für
+ \DescRef{\LabelBase.cmd.DefineFamilyKey}, sondern entsprechend auch für
+ \Macro{FamilyBoolKey} gilt.
+
+ Da \DescRef{\LabelBase.cmd.FamilyKeyState} bereits von \Macro{FamilySetBool}
+ gesetzt wird, kann innerhalb der Definition der Option mit Hilfe von
+ \DescRef{\LabelBase.cmd.DefineFamilyKey} der Status gegebenenfalls auch
+ abgefragt werden. So könnte man im ersten Fall beispielsweise nach
+ \Macro{FamilySetBool} einen Test der Art:
\begin{lstcode}
\ifx\FamilyKeyState\FamilyKeyStateProcessed
...
@@ -687,10 +696,12 @@ dann gegebenenfalls eine Meldung über eine unbekannte Wertzuweisung ausgegeben
\fi
\end{lstcode}
ergänzen, um zusätzliche Aktionen in Abhängigkeit davon, ob
- \Macro{FamilySetBool} erfolgreich war oder nicht, auszuführen. Es ist zu
- beachten, dass an dieser Stelle unbedingt ein Test mit Hilfe von \Macro{ifx}
- vorzunehmen ist. Expandierende Tests wie \Macro{ifstr} sind hier zu
- vermeiden.
+ \Macro{FamilySetBool} erfolgreich war oder nicht,
+ auszuführen. Es\textnote{Achtung!} ist zu beachten, dass an dieser Stelle
+ unbedingt ein Test mit Hilfe von \Macro{ifx} vorzunehmen ist. Expandierende
+ Tests wie \Macro{ifstr} sind hier zu vermeiden. Sie können abhängig vom
+ aktuellen Status und dem Vergleichszustand zu unterschiedlichen
+ Fehlermeldungen und auch zu falschen Ergebnissen führen.%
\end{Example}
%
\EndIndexGroup
@@ -706,24 +717,25 @@ dann gegebenenfalls eine Meldung über eine unbekannte Wertzuweisung ausgegeben
\Parameter{Wert}
\end{Declaration}
Während Schalter nur zwei Werte annehmen können, gibt es auch Schlüssel, die
-mehrere Werte kennen. So kann beispielsweise eine Ausrichtung nicht nur links
-oder nicht links, sondern beispielsweise links, mittig oder rechts
+mehrere Werte kennen. So kann beispielsweise eine Ausrichtung nicht nur
+entweder links oder nicht links, sondern auch links, mittig oder rechts
sein. Intern unterscheidet man solche Einstellungen dann gerne mit Hilfe von
-\Macro{ifcase}. Diese \TeX-Anweisung erwartet wiederum einen nummerischen
-Wert. Daher heißt bei \Package{scrbase} die Anweisung, mit der man via
-\PName{Schlüssel} einem Makro eine Definition zuweisen kann, entsprechend
-\Macro{FamilyNumericalKey}. Die \PName{Werteliste} hat dabei die Form
-\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
- \Parameter{Wert}\Parameter{Definition}\texttt{,}%
- \Parameter{Wert}\Parameter{Definition} %
- \dots
-\end{tabular}\vskip\dp\strutbox\end{flushleft}
+\Macro{ifcase}\IndexCmd{ifcase}. Diese \TeX-Anweisung erwartet wiederum einen
+nummerischen Wert. Daher heißt bei \Package{scrbase} die Anweisung, mit der
+man via \PName{Schlüssel} einem Makro eine Definition zuweisen kann,
+entsprechend \Macro{FamilyNumericalKey}.
+
+Die \PName{Werteliste} hat dabei die Form:
+%\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
+ \Parameter{Wert}\Parameter{Definition}\texttt{,}\linebreak[1]%
+ \Parameter{Wert}\Parameter{Definition}~\dots{}
+%\end{tabular}\vskip\dp\strutbox\end{flushleft}
Über diese \PName{Werteliste} werden so nicht nur die erlaubten Werte für den
-\PName{Schlüssels} angegeben. Für jeden erlaubten \PName{Wert} wird auch
+\PName{Schlüssel} angegeben. Für jeden erlaubten \PName{Wert} wird auch
gleich angegeben, wie bei Verwendung desselben das Makro
\Macro{\PName{Makroname}} definiert werden soll. Üblicherweise werden als
-\PName{Definition} schlicht Zahlenwerte angegeben. Es sind aber auch andere
-Angaben möglich. Derzeit gibt es aber die Einschränkung, dass
+\PName{Definition} schlicht Zahlenwerte angegeben. Es sind zwar auch andere
+Angaben möglich, derzeit gibt es aber die Einschränkung, dass
\PName{Definition} voll expandierbar sein muss und bei der Zuweisung auch
expandiert wird.
\begin{Example}
@@ -775,7 +787,7 @@ expandiert wird.
\end{lstcode}
unterschieden werden.
\end{Example}
-%
+
Intern wird von \Macro{FamilyNumericalKey} dann
\DescRef{\LabelBase.cmd.DefineFamilyKey} mit der Anweisung
\Macro{FamilySetNumerical} verwendet. Wird an einen solchen Schlüssel ein
@@ -802,9 +814,9 @@ Erfolg via \DescRef{\LabelBase.cmd.FamilyKeyStateProcessed} in
\end{Declaration}
Während\ChangedAt{v3.12}{\Package{scrbase}} bei
\DescRef{\LabelBase.cmd.FamilyNumericalKey} ein Makro aufgrund eines
-symbolischen \PName{Wert}s auf einen korrespondierenden nummerischen Wert
+symbolischen Wertes auf einen korrespondierenden nummerischen Wert
gesetzt wurde, gibt es natürlich auch Fälle, in denen ein \PName{Schlüssel}
-direkt einen \PName{\LaTeX-Zähler} rerpäsentiert, dem unmittelbar ein
+direkt einen \PName{\LaTeX-Zähler} repräsentiert, dem unmittelbar ein
nummerischer \PName{Wert} zugewiesen werden soll. Dazu dient die Anweisung
\Macro{FamilyCounterKey}, von der intern dann \Macro{FamilySetCounter}
aufgerufen wird. Dabei finden einige grundlegende Prüfungen des
@@ -819,6 +831,12 @@ Wurde\ChangedAt{v3.15}{\Package{scrbase}} kein Wert übergeben, so wird
stattdessen der \PName{Säumniswert} eingesetzt. Falls kein \PName{Säumniswert}
angegeben wird, kann später der \PName{Schlüssel} nur mit Wertübergabe
verwendet werden.%
+\iffalse% Umbruchkorrekturtext
+\ Anderenfalls wir mit
+\DescRef{\LabelBase.cmd.FamilyKeyStateNeedValue} ein entsprechender Fehler
+signalisiert und beispielsweise innerhalb \Macro{FamilyOptions} auch als
+solcher gemeldet.%
+\fi%
\EndIndexGroup
@@ -832,9 +850,11 @@ verwendet werden.%
\end{Declaration}
Diese\ChangedAt{v3.12}{\Package{scrbase}} beiden Anweisungen unterscheiden
sich von den zuvor erklärten \DescRef{\LabelBase.cmd.FamilyCounterKey} und
-\DescRef{\LabelBase.cmd.FamilySetCounter} nur dadurch, dass nicht ein \LaTeX-Zähler auf einen
-Wert gesetzt wird, sondern ein \PName{Makro} mit diesem Wert definiert
-wird.%
+\DescRef{\LabelBase.cmd.FamilySetCounter} nur dadurch, dass nicht ein
+\LaTeX-Zähler auf einen Wert gesetzt wird, sondern ein \PName{Makro} mit
+diesem Wert definiert wird. Auch dabei wird \PName{Wert} lokal einem Zähler
+zugewiesen und dann dessen expandierter Wert verwendet. Es gilt daher der Wert
+zum Zeitpunkt des Aufrufs der Option.%
\EndIndexGroup
@@ -862,8 +882,8 @@ festzustellen, ob dieses Argument für eine Zuweisung an eine \PName{Länge} in
Frage kommt. Die Zuweisung findet nur statt, wenn diese Prüfungen
gelingen. Allerdings können hier nicht alle Fehler erkannt werden, so dass
eine falsche Zuweisung auch zu einer Fehlermeldung von \TeX{} selbst führen
-kann. Erkannte Fehler werden hingegen über \DescRef{\LabelBase.cmd.FamilyKeyStateUnknownValue}
-signalisiert.
+kann. Erkannte Fehler werden hingegen über
+\DescRef{\LabelBase.cmd.FamilyKeyStateUnknownValue} signalisiert.
Wurde\ChangedAt{v3.15}{\Package{scrbase}} kein Wert übergeben, so wird
stattdessen der \PName{Säumniswert} eingesetzt. Falls kein \PName{Säumniswert}
@@ -871,9 +891,8 @@ angegeben wird, kann später der \PName{Schlüssel} nur mit Wertübergabe
verwendet werden.
Bei Verwendung der Anweisungen \Macro{FamilyLengthMacroKey} und
-\Macro{FamilySetLengthMacro} findet die Speicherung des Werts nicht in einer
-\Macro{Länge}, sondern in einem \Macro{Makro}
-statt.%
+\Macro{FamilySetLengthMacro} findet die Speicherung des Wertes nicht in einer
+\PName{Länge}, sondern in einem \PName{Makro} statt.%
\EndIndexGroup
@@ -881,11 +900,14 @@ statt.%
\Macro{FamilyStringKey}\OParameter{Mitglied}\Parameter{Familie}
\Parameter{Schlüssel}
\OParameter{Säumniswert}\Parameter{Makro}
+ \Macro{FamilyCSKey}\OParameter{Mitglied}\Parameter{Familie}
+ \Parameter{Schlüssel}
+ \OParameter{Säumniswert}\Parameter{Makronamen}
\end{Declaration}
Hier wird nun\ChangedAt{v3.08}{\Package{scrbase}} ein Schlüssel definiert, der
jeden beliebigen Wert annehmen kann. Der Wert wird in dem angegebenen
\PName{Makro} gespeichert. Wird das optionale Argument für den
-\PName{Säumniswert} weggelassen, so entspricht die Anweisung:
+\PName{Säumniswert} weggelassen, so entspricht \Macro{FamilyStringKey}:
\begin{lstcode}[escapeinside=»«]
\DefineFamilyKey[»\PName{Mitglied}«]{»\PName{Familie}«}{»\PName{Schlüssel}«}
{\def»\PName{Makro}«{#1}}
@@ -898,8 +920,6 @@ das optionale Argument für den \PName{Säumniswert} so entspricht die Anweisung:
{\def»\PName{Makro}«{#1}\FamilyKeyStateProcessed}
\end{lstcode}
-Ist
-\PName{Makro} noch nicht definiert, so wird es als leeres Makro definiert.
\begin{Example}
In der Voreinstellung sollen 250\,g Wurstsalat erzeugt werden. Die Menge
soll jedoch einfach per Option geändert werden können. Dazu wird die zu
@@ -909,9 +929,17 @@ Ist
\begin{lstcode}
\newcommand*{\Salatgewicht}{250g}
\FamilyStringKey{Fleischermeister}%
- {Salatgewicht}[250g]{\Salatgewicht}
+ {Salatgewicht}[250g]%
+ {\Salatgewicht}
+\end{lstcode}
+ Soll nach einer Änderung
+ \iffalse% Umbruchkorrekturtext
+ wie
+\begin{lstcode}
+ \FamilyOptions{Fleichermeister}{Salatgewicht=100g}
\end{lstcode}
- Soll nach einer vorherigen Änderung wieder die Standardmenge hergestellt
+ \fi%
+ wieder die Standardmenge hergestellt
werden, so kann der Anwender die Option einfach ohne Gewichtsangabe
aufrufen:
\begin{lstcode}
@@ -923,6 +951,11 @@ Ist
In diesem Fall existieren keine unbekannten Werte, da alle Werte schlicht für
eine Makrodefinition verwendet werden. Es ist jedoch zu beachten, dass in der
Wertzuweisung an den Schlüssel keine Absätze enthalten sein dürfen.
+
+Im\ChangedAt{v3.25}{\Package{scrbase}} Unterschied zu \Macro{FamilyStringKey}
+erwartet \Macro{FamilyCSKey} kein Makro als letztes Argument, sondern
+lediglich den Namen eines Makros, also beispielsweise nicht
+\PParameter{\Macro{Salatgewicht}}, sondern \PParameter{Salatgewicht}.%
%
\EndIndexGroup
@@ -932,14 +965,15 @@ Wertzuweisung an den Schlüssel keine Absätze enthalten sein dürfen.
\Parameter{Wert}\Parameter{Werteliste}
\end{Declaration}
Diese Anweisung signalisiert über \DescRef{\LabelBase.cmd.FamilyKeyState}
-einen Fehler aufgrund eines unbekannten oder unerlaubten Werts. Dabei wird als
-\PName{Werteliste} eine durch Komma separierte Liste von erlaubten Werten der
-Form
-\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
- `\PName{Wert}'\texttt{,} `\PName{Wert}' \dots
-\end{tabular}\vskip\dp\strutbox\end{flushleft}
+einen Fehler aufgrund eines unbekannten oder unerlaubten Wertes. Dabei wird
+als \PName{Werteliste} eine durch Komma separierte Liste von erlaubten Werten
+der Form:
+%\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
+ `\PName{Wert}'\texttt{,} `\PName{Wert}' \dots{}
+%\end{tabular}\vskip\dp\strutbox\end{flushleft}
erwartet. Allerdings\ChangedAt{v3.12}{\Package{scrbase}} wird die
\PName{Werteliste} derzeit nicht ausgewertet.
+
\begin{Example}
Für den Aufschnitt soll nun zusätzlich wählbar sein, ob er grob oder
fein geschnitten werden soll. Dabei ist grob die Voreinstellung, die auch
@@ -964,20 +998,36 @@ erwartet. Allerdings\ChangedAt{v3.12}{\Package{scrbase}} wird die
\@Aufschnitttrue
\@Feinschnittrue
\FamilyKeyStateProcessed
- }{}%
+ }{%
+ \FamilyUnknownKeyValue{Fleichermeister}%
+ {Aufschnitt}%
+ {#1}{%
+ `true', `on', `yes',
+ `false`, `off`, `no',
+ `fein'%
+ }%
+ }%
\fi
}%
\end{lstcode}
Zunächst wird versucht, den booleschen Schalter für Aufschnitt über
\DescRef{\LabelBase.cmd.FamilySetBool} zu setzen. Gelingt dies, wurde also
- \DescRef{\LabelBase.cmd.FamilyKeyState} zu \DescRef{\LabelBase.cmd.FamilyKeyStateProcessed} definiert, wird
- der Feinschnitt abgeschaltet. Anderenfalls wird überprüft, ob an
- Stelle eines gültigen Werts für einen booleschen Schalter %der Wert
+ \DescRef{\LabelBase.cmd.FamilyKeyState} zu
+ \DescRef{\LabelBase.cmd.FamilyKeyStateProcessed} definiert, wird
+ der Feinschnitt abgeschaltet. Anderenfalls wird überprüft, ob anstelle
+ eines gültigen Wertes für einen booleschen Schalter %der Wert
\PValue{fein} übergeben wurde. In diesem Fall wird sowohl der Feinschnitt,
als auch Aufschnitt aktiviert und mit Hilfe von
- \DescRef{\LabelBase.cmd.FamilyKeyStateProcessed} der Erfolgs-Status gesetzt. Ist auch das
- nicht der Fall, bleibt der von \DescRef{\LabelBase.cmd.FamilySetBool} signalisierte
- Fehler-Zustand bestehen.
+ \DescRef{\LabelBase.cmd.FamilyKeyStateProcessed} der Erfolgs-Status
+ gesetzt. Ist auch das nicht der Fall, wird der von
+ \DescRef{\LabelBase.cmd.FamilySetBool} signalisierte Fehler-Zustand
+ neu auf \DescRef{\LabelBase.cmd.FamilyKeyStateUnknownValue} gesetzt. Die
+ Liste der üblichen erlaubten Werte von
+ \DescRef{\LabelBase.cmd.FamilySetBool} wird dabei um \PValue{fein}
+ ergänzt. Da diese Liste jedoch inzwischen nicht mehr verwendet wird, hätte
+ man auf den Aufruf von \Macro{FamilyUnknownKeyValue} im Beispiel auch
+ einfach verzichten und damit den Fehlerstatus von
+ \DescRef{\LabelBase.cmd.FamilySetBool} übernehmen können.
Die bei den Tests verwendete Anweisung \Macro{ifstr}\IndexCmd{ifstr} ist auf
\DescPageRef{scrbase.cmd.ifstr} in \autoref{sec:scrbase.if} erklärt.
@@ -989,13 +1039,16 @@ erwartet. Allerdings\ChangedAt{v3.12}{\Package{scrbase}} wird die
\begin{Declaration}
\Macro{FamilyElseValues}
\end{Declaration}
-In\ChangedAt{v3.12}{\Package{scrbase}} früheren Versionen von
-\Package{scrbase} konnte man über die Anweisung \Macro{FamilyElseValues}
+In\ChangedAt{v3.12}{\Package{scrbase}} früheren\textnote{Veraltet!} Versionen
+von \Package{scrbase} konnte man über die Anweisung \Macro{FamilyElseValues}
weitere erlaubte Werte für die Bearbeitung durch
-\DescRef{\LabelBase.cmd.FamilyUnknownKeyValue} in der Form
+\DescRef{\LabelBase.cmd.FamilyUnknownKeyValue}
+\iffalse% Umbruchkorrekturtext
+in der Form
\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
\texttt{,} `\PName{Wert}'\texttt{,} `\PName{Wert}' \dots
\end{tabular}\vskip\dp\strutbox\end{flushleft}
+\fi%
ablegen, die dann ebenfalls in einer Fehlermeldung mit ausgegeben wurden. Seit
Version~3.12 gibt \DescRef{\LabelBase.cmd.FamilyUnknownKeyValue} keine
Fehlermeldungen mehr aus, sondern setzt nur noch
@@ -1011,7 +1064,7 @@ anzupassen.%
Das Paket \Package{scrbase} stellt eine ganze Reihe von
Verzweigungsanweisungen zur Verfügung. Dabei wird nicht auf die \TeX-Syntax
-von Verzweigungen, wie beispielsweise
+von Verzweigungen wie beispielsweise
\begin{lstcode}
\iftrue
...
@@ -1026,18 +1079,54 @@ kennt. Einige Paketautoren ziehen es allerdings vor, die \TeX-Syntax auch für
Anwender in die \LaTeX-Ebene zu bringen. Da es sich bei den Verzweigungen von
\Package{scrbase} um recht grundlegende Möglichkeiten handelt, ist die
Wahrscheinlichkeit gegeben, dass dabei gleichnamige Anwenderanweisungen
-verwendet würden. Dies würde selbst bei eigentlich gleicher Semantik
-zwangsläufig zu einem Problem aufgrund der unterschiedlichen Syntax
-führen. Deshalb definiert \Package{scrbase} einige dieser Anweisungen zunächst
-als interne Anweisungen mit dem Präfix \Macro{scr@}. Für den Anwender werden
-dann gleichbedeutende Anweisungen ohne diesen Präfix bereit
-gestellt. Letzteres kann jedoch mit Hilfe der Option
-\DescRef{\LabelBase.option.internalonly} (siehe \autoref{sec:scrbase.loadit},
-\DescPageRef{scrbase.option.internalonly}) verhindert werden.
+verwendet würden. Dies könnte selbst bei eigentlich gleicher Semantik
+zu einem Problem aufgrund unterschiedlichen Syntax
+führen. \Package{scrbase} geht daher auf Nummer sicher.
+
+\begin{Declaration}
+ \OptionVName{internalonly}{Wert}
+\end{Declaration}
+Von \Package{scrbase} werden einige Verzweigungsanweisungen
+bereitgestellt. Dabei verwendet es primär die Bezeichnungen
+\Macro{scr@\PName{Name}}\textnote{Paketautoren}. Es handelt sich somit
+um interne Anweisungen. Diese werden auch intern von \KOMAScript{}
+verwendet. Paket- und Klassenautoren können diese Anweisungen ebenfalls
+verwenden, sollten sie aber nicht umdefinieren. Da einige dieser Anweisungen
+auch für Benutzer nützlich sein können, werden die gleichen Anweisungen
+normalerweise auch als \Macro{\PName{Name}}\textnote{Anwender}
+bereitgestellt. Da eventuell andere Pakete gleichnamige Anweisungen mit
+anderer Syntax bereitstellen könnten und es so zu Konflikten kommen könnte,
+kann der Anwender die Definition von \Macro{\PName{Name}} verhindern. Dazu
+gibt er entweder die Option ohne Wertangabe an. In diesem Fall werden nur die
+internen Verzweigungsanweisungen definiert. Oder er gibt genau die
+Anweisungen, die nicht definiert werden sollen, als Wert an, wobei er
+»\Macro{}« durch »\texttt{/}« ersetzt.
+
+Paket- und Klassenautoren sollten diese Option normalerweise nicht verwenden.
+Anwender können sie mit oder ohne Wertangabe entweder als globale Option bei
+\DescRef{maincls.cmd.documentclass} oder per
+\Macro{PassOptionsToPackage}\IndexCmd{PassOptionsToPackage} angeben.
+\begin{Example}
+ Der Anwender will nicht, dass die Anweisungen
+ \DescRef{\LabelBase.cmd.ifVTeX} und
+ \DescRef{\LabelBase.cmd.ifundefinedorrelax} von \Package{scrbase} definiert
+ werden. Also verwendet er beim Laden der Klasse:
+\begin{lstcode}
+ \documentclass[%
+ internalonly=/ifVTeX/ifundefinedorrelax%
+ ]{foo}
+\end{lstcode}
+ Der Klassenname \Class{foo} wird hier als Platzhalter für irgendeine Klasse
+ verwendet. Die Anweisungen \DescRef{\LabelBase.cmd.ifVTeX}
+ und \DescRef{\LabelBase.cmd.ifundefinedorrelax} werden im weiteren Verlauf
+ dieses Abschnittes erklärt.%
+\end{Example}
Paket- und Klassenautoren sollten wie \KOMAScript{} selbst auch die internen
-Namen verwenden. Zur Vollständigkeit sind aber auch die Anwenderanweisungen
-angegeben.
+Namen verwenden. Zur Vollständigkeit sind in den nachfolgenden Erklärungen
+aber auch die Anwenderanweisungen angegeben.%
+\EndIndexGroup
+
\begin{Declaration}
\Macro{scr@ifundefinedorrelax}
@@ -1045,30 +1134,83 @@ angegeben.
\Macro{ifundefinedorrelax}
\Parameter{Name}\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
\end{Declaration}
-Diese Anweisung funktioniert prinzipiell wie
-\Macro{@ifundefined} aus dem \LaTeX-Kern (siehe \cite{latex:source2e}). Es
-wird also der \PName{Dann-Teil} ausgeführt, wenn \PName{Name} der
-Name einer undefinierten Anweisung oder \Macro{\PName{Name}} derzeit
-\Macro{relax} ist. Im Unterschied zu \Macro{@ifundefined} wird
-allerdings \Macro{\PName{Name}} nicht als \Macro{relax} definiert,
-wenn es zuvor undefiniert war. Unter Verwendung von \eTeX{} wird in diesem Fall
-noch nicht einmal Hash-Speicher belegt.
-%
+Diese Anweisung funktioniert prinzipiell wie \Macro{@ifundefined} aus dem
+\LaTeX-Kern (siehe \cite{latex:source2e}). Es wird also der \PName{Dann-Teil}
+ausgeführt, wenn \PName{Name} der Name einer undefinierten Anweisung oder
+\Macro{\PName{Name}} derzeit \Macro{relax} ist. Im Unterschied zu
+\Macro{@ifundefined} wird %
+\iftrue% Umbruchvarianten
+weder Hash-Speicher belegt noch \Macro{\PName{Name}} %
+\else%
+\Macro{\PName{Name}} nicht %
+\fi%
+zu \Macro{relax}, wenn \Macro{\PName{Name}} zuvor undefiniert war.%
\EndIndexGroup
\begin{Declaration}
+ \Macro{ifnotundefined}\Parameter{Name}%
+ \Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+\end{Declaration}
+Ist die Anweisung mit dem angegebenen Namen bereits definiert wird der
+\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Da es bei
+\eTeX{} bereits ein Primitiv \Macro{ifdefined} gibt, musste leider diese
+etwas unhandliche Bezeichnung gewählt werden. %
+\iftrue% Umbruchvaritanten
+Von dieser Anweisung gibt es keine interne Variante.%
+\else%
+Es gibt keine interne Variante.%
+\fi%
+\EndIndexGroup
+
+
+\begin{Declaration}
+ \Macro{scr@ifluatex}
+ \Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+\end{Declaration}
+Wird\ChangedAt{v3.21}{\Package{scrbase}} mit lua\TeX{} gearbeitet, wird der
+\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}.
+\iftrue% Umbruchkorrekturtext
+Diese Unterscheidung ist nur sehr selten wirklich von Nutzen. %
+\fi%
+In der Regel sollte man besser auf die gewünschte Anweisung
+testen. Von\textnote{Achtung!} dieser Anweisung gibt es kein
+Benutzeräquivalent. Verwenden Sie stattdessen bei Bedarf das Paket
+\Package{ifluatex}\important{\Package{ifluatex}} (siehe
+\cite{package:ifluatex}).%
+\EndIndexGroup
+
+
+\iffalse% Es ergibt keinen Sinn, diese Anweisung noch zu dokumentieren
+\begin{Declaration}
+ \Macro{scr@ifpdforluatex}
+ \Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+\end{Declaration}
+Bis lua\TeX~0.85 war es meist unerheblich, ob mit pdf\TeX{} oder lua\TeX{}
+gearbeitet wurde. Von daher stammt diese Anweisung, die in beiden Fällen den
+\PName{Dann-Teil} ausführt. Wird weder mit pdf\TeX{} noch mit lua\TeX{}
+gearbeitet, so wird der \PName{Sonst-Teil} ausgeführt.
+Seit Version 0.85 wurde bei lua\TeX{} die Kompatibilität bei vielen der
+zusätzlichen Befehle jedoch aufgegeben. Daher ist diese Unterscheidung in der
+Praxis nicht mehr von Nutzen und wird von \KOMAScript{} selbst auch nicht mehr
+verwendet. Von dieser Anweisung gibt es auch kein Benutzeräquivalent.%
+\EndIndexGroup
+\fi
+
+
+\begin{Declaration}
\Macro{scr@ifpdftex}
\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
\Macro{ifpdftex}
\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
\end{Declaration}
-Wird mit pdf\TeX{} gearbeitet, so wird der \PName{Dann-Teil} ausgeführt,
+Wird mit pdf\TeX{} gearbeitet, wird der \PName{Dann-Teil} ausgeführt,
anderenfalls der \PName{Sonst-Teil}. Dabei ist es unerheblich, ob tatsächlich
-eine PDF-Datei ausgegeben werden soll, oder nicht. Diese Unterscheidung ist
-nur sehr selten wirklich von Nutzen. In der Regel sollte man eher auf die
-gewünschte Anweisung testen.
-%
+eine PDF-Datei ausgegeben werden soll oder nicht.
+\iftrue% Umbruchkorrekturtext
+Diese Unterscheidung ist nur sehr selten wirklich von Nutzen. %
+\fi%
+In der Regel sollte man besser auf die gewünschte Anweisung testen.%
\EndIndexGroup
@@ -1078,11 +1220,12 @@ gewünschte Anweisung testen.
\Macro{ifVTeX}
\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
\end{Declaration}
-Wird mit V\TeX{} gearbeitet, so wird der \PName{Dann-Teil} ausgeführt,
-anderenfalls der \PName{Sonst-Teil}. Diese Unterscheidung ist nur sehr selten
-wirklich von Nutzen. In der Regel sollte man eher auf die gewünschte Anweisung
-testen.
-%
+Wird mit V\TeX{} gearbeitet, wird der \PName{Dann-Teil} ausgeführt,
+anderenfalls der \PName{Sonst-Teil}.
+\iftrue% Umbruchkorrekturtext
+Diese Unterscheidung ist nur sehr selten wirklich von Nutzen. %
+\fi%
+In der Regel sollte man besser auf die gewünschte Anweisung testen.%
\EndIndexGroup
@@ -1092,10 +1235,10 @@ testen.
\Macro{ifpdfoutput}
\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
\end{Declaration}
-Wird eine PDF-Datei erzeugt, so wird der \PName{Dann-Teil} ausgeführt,
+Wird eine PDF-Datei erzeugt, wird der \PName{Dann-Teil} ausgeführt,
anderenfalls der \PName{Sonst-Teil}. Dabei ist es unerheblich, ob die
-PDF-Datei mit Hilfe von pdf\TeX{} oder mit Hilfe von V\TeX{} erzeugt wird.
-%
+PDF-Datei mit Hilfe von lua\TeX{}, pdf\TeX{}, V\TeX{} oder \XeTeX{} erzeugt
+wird.%
\EndIndexGroup
@@ -1105,12 +1248,13 @@ PDF-Datei mit Hilfe von pdf\TeX{} oder mit Hilfe von V\TeX{} erzeugt wird.
\Macro{ifpsoutput}
\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
\end{Declaration}
-Wird eine PostScript-Datei erzeugt, so wird der \PName{Dann-Teil} ausgeführt,
+Wird eine PostScript-Datei erzeugt, wird der \PName{Dann-Teil} ausgeführt,
anderenfalls der \PName{Sonst-Teil}. V\TeX{} kann PostScript direkt erzeugen,
-was hier auch erkannt wird. Wird hingegen kein V\TeX{} verwendet, ist aber ein
+was hier erkannt wird. Wird hingegen kein V\TeX{} verwendet, ist aber ein
Schalter \Macro{if@dvips} definiert, so wird die Entscheidung darüber
-getroffen. \KOMAScript{} stellt \Macro{if@dvips} in \Package{typearea} bereit.
-%
+getroffen. \KOMAScript{} stellt \Macro{if@dvips} in
+\hyperref[cha:typearea]{\Package{typearea}}\IndexPackage{typearea}%
+\IndexCmd{if@dvips} bereit.%
\EndIndexGroup
@@ -1123,18 +1267,22 @@ getroffen. \KOMAScript{} stellt \Macro{if@dvips} in \Package{typearea} bereit.
Wird eine DVI-Datei erzeugt, so wird der \PName{Dann-Teil} ausgeführt,
anderenfalls der \PName{Sonst-Teil}. Es wird immer dann davon ausgegangen,
dass eine DVI-Datei erzeugt wird, wenn keine direkte Ausgabe einer PDF- oder
-Postscript-Datei erkannt werden kann.
-%
+Postscript-Datei erkannt werden kann.%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifnotundefined}\Parameter{Name}%
- \Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+ \Macro{if@atdocument}\ \PName{Dann-Teil}\ %
+ \textMacro{else}\ \PName{Sonst-Teil} \textMacro{fi}
\end{Declaration}
-Unter Verwendung von \eTeX{} wird hier tatsächlich getestet, ob die Anweisung
-mit dem angegebenen \PName{Name} noch undefiniert ist. Von dieser Anweisung
-gibt es keine interne Variante.
+Diese Verzweigung existiert ganz bewusst nur als interne Anweisung. Dabei
+entspricht \Macro{if@atdocument} in der Dokumentpräambel \Macro{iffalse}, nach
+\Macro{begin}\PParameter{document} entspricht \Macro{if@atdocument} hingegen
+\Macro{iftrue}. Klassen und Paketautoren können dieses Anweisung manchmal
+sinnvoll nutzen, wenn sich Anweisungen in der Dokumentpräambel anders
+verhalten sollen als innerhalb des Dokuments. Es\textnote{Achtung!} ist zu
+beachten, dass es sich bei dieser Anweisung um eine Verzweigung in \TeX-Syntax
+und nicht in \LaTeX-Syntax handelt!
%
\EndIndexGroup
@@ -1145,9 +1293,12 @@ gibt es keine interne Variante.
\end{Declaration}
Die beiden Argumente \PName{Zeichenfolge} werden expandiert und dann
verglichen. Sind sie dabei gleich, so wird der \PName{Dann-Teil} ausgeführt,
-anderenfalls der \PName{Sonst-Teil}. Von dieser Anweisung gibt es keine
-interne Variante.
-%
+anderenfalls der \PName{Sonst-Teil}. %
+\iftrue% Umbruchvaritanten
+Von dieser Anweisung gibt es keine interne Variante.%
+\else%
+Es gibt keine interne Variante.%
+\fi%
\EndIndexGroup
@@ -1156,11 +1307,14 @@ interne Variante.
\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
\end{Declaration}
Die\ChangedAt{v3.12}{\Package{scrbase}} beiden Argumente \PName{Zeichenfolge}
-werden expandiert und dann verglichen. Beginnt die erste Zeichenfolge von
-Leerzeichen abgesehen mit der zweiten Zeichenfolge, so wird der
-\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Von dieser
-Anweisung gibt es keine interne Variante.%
-%
+werden expandiert und dann verglichen. Beginnt die erste Zeichenfolge, von
+Leerzeichen abgesehen, mit der zweiten Zeichenfolge, so wird der
+\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. %
+\iftrue% Umbruchvaritanten
+Von dieser Anweisung gibt es keine interne Variante.%
+\else%
+Es gibt keine interne Variante.%
+\fi%
\EndIndexGroup
@@ -1170,8 +1324,12 @@ Anweisung gibt es keine interne Variante.%
Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
einem \Macro{dimen}, also einem \TeX-Längenregister, resultiert, wird der
\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Die
-Anweisung ist nicht voll expandierbar. Von dieser
-Anweisung gibt es keine interne Variante.%
+Anweisung ist nicht voll expandierbar. %
+\iftrue% Umbruchvaritanten
+Von dieser Anweisung gibt es keine interne Variante.%
+\else%
+Es gibt keine interne Variante.%
+\fi%
\EndIndexGroup
@@ -1183,8 +1341,28 @@ Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
etwas resultiert, das syntaktisch dem Wert einer Länge entspricht, wird der
\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Es ist zu
beachten,\textnote{Achtung!} dass derzeit unbekannte Einheiten zu einer
-Fehlermeldung führen. Die Anweisung ist nicht voll expandierbar. Von dieser
-Anweisung gibt es keine interne Variante.%
+Fehlermeldung führen. Die Anweisung ist nicht voll expandierbar. %
+\iftrue% Umbruchvaritanten
+Von dieser Anweisung gibt es keine interne Variante.%
+\else%
+Es gibt keine interne Variante.%
+\fi%
+\EndIndexGroup
+
+
+\begin{Declaration}
+ \Macro{ifdimen}\Parameter{Zeichenfolge}%
+ \Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+\end{Declaration}
+Der \PName{Dann-Teil} wird ausgeführt, wenn die einfache Expansion der
+\PName{Zeichenfolge} eine gültige Länge mit einer gültigen Längeneinheit
+ist. Anderenfalls wird der \PName{Sonst-Teil} verwendet. %
+\iftrue% Umbruchvaritanten
+Von dieser Anweisung gibt es keine interne Variante.%
+\else%
+Es gibt keine interne Variante.%
+\fi%
+%
\EndIndexGroup
@@ -1193,11 +1371,16 @@ Anweisung gibt es keine interne Variante.%
\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
\end{Declaration}
Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
-einer \Macro{dimexpr}, also einem \TeX-Längenausdruck resultiert, wird der
-\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Es ist zu
-beachten,\textnote{Achtung!} dass fehlerhafte Ausdrücke zu Fehlermeldungen
-führen! Die Anweisung ist nicht voll expandierbar. Von dieser
-Anweisung gibt es keine interne Variante.%
+einer \Macro{dimexpr}\IndexCmd{dimexpr}, also einem \eTeX-Längenausdruck
+resultiert, wird der \PName{Dann-Teil} ausgeführt, anderenfalls der
+\PName{Sonst-Teil}. Es ist zu beachten,\textnote{Achtung!} dass fehlerhafte
+Ausdrücke zu Fehlermeldungen führen! Die Anweisung ist nicht voll
+expandierbar. %
+\iftrue% Umbruchvaritanten
+Von dieser Anweisung gibt es keine interne Variante.%
+\else%
+Es gibt keine interne Variante.%
+\fi%
\EndIndexGroup
@@ -1207,8 +1390,12 @@ Anweisung gibt es keine interne Variante.%
Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
einem \Macro{skip}, also einem \TeX-Abstand, resultiert, wird der
\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Die
-Anweisung ist nicht voll expandierbar. Von dieser
-Anweisung gibt es keine interne Variante.%
+Anweisung ist nicht voll expandierbar. %
+\iftrue% Umbruchvaritanten
+Von dieser Anweisung gibt es keine interne Variante.%
+\else%
+Es gibt keine interne Variante.%
+\fi%
\EndIndexGroup
@@ -1220,8 +1407,12 @@ Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
etwas resultiert, das syntaktisch dem Wert eines Abstandes entspricht, wird der
\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Es ist zu
beachten,\textnote{Achtung!} dass derzeit unbekannte Einheiten zu einer
-Fehlermeldung führen. Die Anweisung ist nicht voll expandierbar. Von dieser
-Anweisung gibt es keine interne Variante.%
+Fehlermeldung führen. Die Anweisung ist nicht voll expandierbar. %
+\iffalse% Umbruchvaritanten
+Von dieser Anweisung gibt es keine interne Variante.%
+\else%
+Es gibt keine interne Variante.%
+\fi%
\EndIndexGroup
@@ -1230,11 +1421,31 @@ Anweisung gibt es keine interne Variante.%
\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
\end{Declaration}
Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
-einer \Macro{glueexpr}, also einem \TeX-Abstandsausdruck resultiert, wird der
-\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Es ist zu
+einer \Macro{glueexpr}\IndexCmd{glueexpr}, also einem
+\mbox{\eTeX}-Abstandsausdruck resultiert, wird der \PName{Dann-Teil}
+ausgeführt, anderenfalls der \PName{Sonst-Teil}. Es ist zu
beachten,\textnote{Achtung!} dass fehlerhafte Ausdrücke zu Fehlermeldungen
-führen! Die Anweisung ist nicht voll expandierbar. Von dieser
-Anweisung gibt es keine interne Variante.%
+führen! Die Anweisung ist nicht voll expandierbar. %
+\iftrue% Umbruchvaritanten
+Von dieser Anweisung gibt es keine interne Variante.%
+\else%
+Es gibt keine interne Variante.%
+\fi%
+\EndIndexGroup
+
+
+\begin{Declaration}
+ \Macro{ifiscounter}\Parameter{Zähler}%
+ \Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+\end{Declaration}
+Wenn\ChangedAt{v3.12}{\Package{scrbase}} \PName{Zähler} ein definierter
+\LaTeX-Zähler ist, wird der \PName{Dann-Teil} ausgeführt, anderenfalls der
+\PName{Sonst-Teil}. Die Anweisung ist nicht voll expandierbar. %
+\iftrue% Umbruchvaritanten
+Von dieser Anweisung gibt es keine interne Variante.%
+\else%
+Es gibt keine interne Variante.%
+\fi%
\EndIndexGroup
@@ -1245,8 +1456,12 @@ Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
einem \Macro{count}, also einem \TeX-Zähler, resultiert, wird der
\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Die
Anweisung ist nicht voll expandierbar. Für einen Test auf einen \LaTeX-Zähler
-siehe \DescRef{\LabelBase.cmd.ifiscounter}. Von dieser
-Anweisung gibt es keine interne Variante.%
+siehe \DescRef{\LabelBase.cmd.ifiscounter}. %
+\iftrue% Umbruchvaritanten
+Von dieser Anweisung gibt es keine interne Variante.%
+\else%
+Es gibt keine interne Variante.%
+\fi%
\EndIndexGroup
@@ -1258,31 +1473,12 @@ Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
etwas resultiert, das syntaktisch dem Wert eines Zählers entspricht, also eine
negative oder positive ganze Zahl ist, wird der \PName{Dann-Teil} ausgeführt,
anderenfalls der \PName{Sonst-Teil}. Die Anweisung ist nicht voll
-expandierbar. Von dieser Anweisung gibt es keine interne Variante.%
-\EndIndexGroup
-
-
-\begin{Declaration}
- \Macro{ifisnumexpr}\Parameter{Code}%
- \Parameter{Dann-Teil}\Parameter{Sonst-Teil}
-\end{Declaration}
-Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
-einer \Macro{numexpr}, also einem \TeX-Zahlenausdruck resultiert, wird der
-\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Es ist zu
-beachten,\textnote{Achtung!} dass fehlerhafte Ausdrücke zu Fehlermeldungen
-führen! Die Anweisung ist nicht voll expandierbar. Von dieser
-Anweisung gibt es keine interne Variante.%
-\EndIndexGroup
-
-
-\begin{Declaration}
- \Macro{ifiscounter}\Parameter{Zähler}%
- \Parameter{Dann-Teil}\Parameter{Sonst-Teil}
-\end{Declaration}
-Wenn\ChangedAt{v3.12}{\Package{scrbase}} \PName{Zähler} ein definierter
-\LaTeX-Zähler ist, wird der \PName{Dann-Teil} ausgeführt, anderenfalls der
-\PName{Sonst-Teil}. Die Anweisung ist nicht voll expandierbar. Von dieser
-Anweisung gibt es keine interne Variante.%
+expandierbar. %
+\iftrue% Umbruchvaritanten
+Von dieser Anweisung gibt es keine interne Variante.%
+\else%
+Es gibt keine interne Variante.%
+\fi%
\EndIndexGroup
@@ -1290,39 +1486,32 @@ Anweisung gibt es keine interne Variante.%
\Macro{ifnumber}\Parameter{Zeichenfolge}%
\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
\end{Declaration}
-Hier werden keine Zahlen verglichen. Der \PName{Dann-Teil} wird vielmehr
-ausgeführt, wenn die einfache Expansion der \PName{Zeichenfolge} nur aus
-Ziffern besteht. Anderenfalls wird der \PName{Sonst-Teil} verwendet. Von
-dieser Anweisung gibt es keine interne Variante.%
+Der \PName{Dann-Teil} wird ausgeführt, wenn die einfache Expansion der
+\PName{Zeichenfolge} nur aus Ziffern besteht. In allen anderen Fällen wird der
+\PName{Sonst-Teil} verwendet. %
+\iftrue% Umbruchvaritanten
+Von dieser Anweisung gibt es keine interne Variante.%
+\else%
+Es gibt keine interne Variante.%
+\fi%
\EndIndexGroup
\begin{Declaration}
- \Macro{ifdimen}\Parameter{Zeichenfolge}%
+ \Macro{ifisnumexpr}\Parameter{Code}%
\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
\end{Declaration}
-Hier werden keine Längen verglichen. Der \PName{Dann-Teil} wird vielmehr
-ausgeführt, wenn die einfache Expansion der \PName{Zeichenfolge} eine gültige
-Länge mit einer gültigen Längeneinheit ist. Anderenfalls wird der
-\PName{Sonst-Teil} verwendet. Von dieser Anweisung gibt es keine interne
-Variante.
-%
-\EndIndexGroup
-
-
-\begin{Declaration}
- \Macro{if@atdocument}\ \PName{Dann-Teil}\ %
- \textMacro{else}\ \PName{Sonst-Teil} \textMacro{fi}
-\end{Declaration}
-Diese Verzweigung existiert ganz bewusst nur als interne Anweisung. Dabei
-entspricht \Macro{if@atdocument} in der Dokumentpräambel \Macro{iffalse}, nach
-\Macro{begin}\PParameter{document} entspricht \Macro{if@atdocument} hingegen
-\Macro{iftrue}. Klassen und Paketautoren können dieses Anweisung manchmal
-sinnvoll nutzen, wenn sich Anweisungen in der Dokumentpräambel anders
-verhalten sollen als innerhalb des Dokuments. Es\textnote{Achtung!} ist zu
-beachten, dass es sich bei dieser Anweisung um eine Verzweigung in \TeX-Syntax
-und nicht in \LaTeX-Syntax handelt!
-%
+Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
+einer \Macro{numexpr}\IndexCmd{numexpr}, also einem \eTeX-Zahlenausdruck
+resultiert, wird der \PName{Dann-Teil} ausgeführt, anderenfalls der
+\PName{Sonst-Teil}. Es ist zu beachten,\textnote{Achtung!} dass fehlerhafte
+Ausdrücke zu Fehlermeldungen führen! Die Anweisung ist nicht voll
+expandierbar. %
+\iftrue% Umbruchvaritanten
+Von dieser Anweisung gibt es keine interne Variante.%
+\else%
+Es gibt keine interne Variante.%
+\fi%
\EndIndexGroup
@@ -1331,19 +1520,33 @@ und nicht in \LaTeX-Syntax handelt!
\BeginIndexGroup
\BeginIndex{}{Sprachdefinition}
+\iftrue
+Anfänger haben häufig Probleme damit, sprachabhängige Begriffe wie
+\Macro{listfigurename}\IndexCmd{listfigurename}, in der Voreinstellung meist
+»List of Figures« beziehungsweise in Deutsch: »Abbildungsverzeichnis«, zu
+ändern. Werden diese beispielsweise einfach mit \Macro{renewcommand} in der
+Dokumentpräambel umdefiniert, so überleben sie eine spätere Umschaltung der
+Sprache nicht. Bei Verwendung von \Package{babel}\IndexCmd{babel} wird die
+Umdefinierung in der Dokumentpräambel bereits von
+\Macro{begin}\PParameter{document} wieder überschrieben.
+\fi
+
Normalerweise muss man zur Definition oder zur Änderung sprachabhängiger
Begriffe Anweisungen wie \Macro{captionsngerman} so umdefinieren, dass
zusätzlich zu den bisherigen Begriffen auch die neuen oder geänderten
definiert werden. Erschwert wird dieses Vorhaben dadurch, dass beim Laden
-eines Paketes wie \Package{german}\IndexPackage{german} oder
+eines Pakets wie \Package{german}\IndexPackage{german} oder
\Package{ngerman}\IndexPackage{ngerman} diese Anweisungen von den Paketen
erneut definiert werden. Bei den genannten Paketen geschieht dies leider in
einer Form, die alle zuvor gemachten Änderungen zunichte macht. Aus diesem
-Grund ist es sinnvoll die Änderungen mit Hilfe von \Macro{AtBeginDocument} bis
+Grund ist es sinnvoll, die Änderungen mit Hilfe von \Macro{AtBeginDocument} bis
\Macro{begin}\PParameter{document}, also bis nach dem Laden aller Pakete, zu
-verzögern. Auch der Anwender muss entweder von \Macro{AtBeginDocument}
+verzögern.
+\iftrue
+Auch der Anwender muss entweder von \Macro{AtBeginDocument}
Gebrauch machen oder aber seine Änderungen nicht in die Dokumentpräambel,
sondern hinter \Macro{begin}\PParameter{document} einfügen.
+\fi
Darüber hinaus kommt erschwerend hinzu, dass einige Pakete zusätzliche,
sprachabhängige Begriffe in \Macro{captions\PName{Sprache}} definieren,
@@ -1351,9 +1554,11 @@ während andere dafür \Macro{extras\PName{Sprache}} verwenden. So muss der
Anwender sich schon sehr genau auskennen, um die richtige Anweisung auf die
richtige Weise zu ergänzen.
-Das Paket \Package{scrbase} bietet dem Anwender daher für die Definition
-selbst einige zusätzliche Anweisungen, die ihn von vielen dieser Überlegungen
-entlasten.
+Das Paket \Package{scrbase} bietet dem Anwender daher für die Definition und
+Änderung selbst einige zusätzliche Anweisungen, die ihn von vielen dieser
+Überlegungen entlasten. Gleichzeitig erlauben diese Befehle, die
+sprachabhängigen Begriffe mehrerer Dialekte oder Ausprägungen einer Sprache
+gleichzeitig zu definieren oder zu ändern.
\begin{Declaration}
\Macro{defcaptionname}
@@ -1380,18 +1585,18 @@ zuzuweisen. Mehrere Sprachen können durch Komma voneinander getrennt als
Der \PName{Begriff} ist immer ein Makro. Die Arbeitsweise der Anweisungen
unterscheidet sich je nachdem, ob eine Sprache und ein \PName{Begriff}
-innerhalb dieser Sprache zum Zeitpunkt des Aufrufs bereits definiert ist.
+innerhalb der Sprache zum Zeitpunkt des Aufrufs bereits definiert ist.
-Ist eine Sprache nicht definiert, so tut \Macro{providecaptionname}
-nichts weiter, als dies in der \File{log}-Datei zu vermerken. Dabei wird für
-jede Sprache nur einmal eine entsprechende Information in die \File{log}-Datei
+Ist eine Sprache nicht definiert, so tut \Macro{providecaptionname} nichts
+weiter, als dies in der \File{log}-Datei zu vermerken. Dabei wird für jede
+Sprache nur einmal eine entsprechende Information in die \File{log}-Datei
geschrieben. Ist die Sprache definiert, enthält aber bisher keinen
entsprechenden \PName{Begriff}, so wird er mit dem angegebenen \PName{Inhalt}
-definiert. Ist der \PName{Begriff} hingegen in der Sprache bereits
-definiert, so wird er nicht umdefiniert, sondern ein entsprechender Hinweis in
+definiert. Ist der \PName{Begriff} hingegen in der Sprache bereits definiert,
+so wird er nicht umdefiniert, sondern ebenfalls ein entsprechender Hinweis in
die \File{log}-Datei geschrieben.
-Die Anweisung \Macro{newcaptionname} verhält sich etwas anders. Ist bei ihr
+Ist dagegen bei \Macro{newcaptionname}
eine Sprache nicht definiert, dann wird diese neu definiert, indem eine
entsprechende Anweisung definiert wird. Für die Sprache
\PValue{ngerman} wäre das beispielsweise \Macro{captionsngerman}. Außerdem
@@ -1471,7 +1676,9 @@ wie \Package{hyperref}, die dafür \Macro{extras\PName{Sprache}} verwenden.
In \autoref{tab:scrbase.commonNames} ist ein Überblick über die üblicherweise
von Klassen und Sprachpaketen definierten Begriffe und deren Verwendung zu
-finden.
+finden.\iffree{}{ \KOMAScript{} selbst definiert noch einige weitere
+ Begriffe. Siehe dazu \autoref{sec:scrlttr2-experts.languages} ab
+ \DescPageRef{scrlttr2-experts.cmd.yourrefname}.}
\begin{desclist}
\renewcommand*{\abovecaptionskipcorrection}{-\normalbaselineskip}%
@@ -1578,10 +1785,11 @@ finden.
\section{Identifikation von \KOMAScript}
\seclabel{identify}
-Obwohl \Package{scrbase} unabhängig von \KOMAScript{} auch für andere
-Pakete und Klassen verwendet werden kann, so ist es dennoch ein
-\KOMAScript-Paket. Als solches enthält es auch Anweisungen, die es als
-\KOMAScript-Paket identifizieren.
+Obwohl -- oder gerade weil -- \Package{scrbase} ganz allgemein als Paket für
+Klassen- und Paketautoren konzipiert ist, wird es natürlich von den
+\KOMAScript-Klassen und den meisten \KOMAScript-Paketen verwendet. Es enthält
+daher auch zwei Anweisungen, die in allen \KOMAScript-Klassen und allen
+grundlegenden \KOMAScript-Paketen vorhanden sind.
\begin{Declaration}
@@ -1591,8 +1799,9 @@ Diese Anweisung setzt schlicht die Wortmarke »\KOMAScript« in serifenloser
Schrift und mit leichter Sperrung des in Versalien gesetzten
Teils. \Macro{KOMAScript} wird übrigens bei Bedarf von allen
\KOMAScript-Klassen und "~Paketen definiert. Die Definition erfolgt mit
-\Macro{DeclareRobustCommand}.
-%
+\Macro{DeclareRobustCommand}. Da auch Pakete, die nicht zu \KOMAScript{}
+gehören, diese Wortmarke definieren können, sollte man die Anweisung jedoch
+nicht als Indiz für die Verwendung eines \KOMAScript-Pakets verstehen.%
\EndIndexGroup
@@ -1605,8 +1814,8 @@ abgelegt. Diese Hauptversion ist für alle \KOMAScript-Klassen und alle
\KOMAScript-Pakete, die von den Klassen verwendet werden, gleich. Daher kann
sie auch nach dem Laden von \Package{scrbase} abgefragt werden. Diese
Anleitung wurde beispielsweise mit der \KOMAScript-Version
-»\KOMAScriptVersion« erstellt.
-%
+»\KOMAScriptVersion« erstellt. Das Vorhandensein dieser Anweisung ist ein
+starkes Indiz dafür, dass zumindest ein \KOMAScript-Paket verwendet wird.%
\EndIndexGroup
@@ -1628,7 +1837,7 @@ Zeilennummer in die Log-Datei zu schreiben. Er bietet neben
\Macro{PackageWarning} und \Macro{ClassWarning}, die Warnungen mit aktueller
Zeilennummer ausgeben, auch die beiden Anweisungen
\Macro{PackageWarningNoLine} und \Macro{ClassWarningNoLine}, um Warnungen ohne
-Zeilennummer auszugeben. Die nahe liegenden Anweisungen
+Zeilennummer auszugeben. Die naheliegenden Anweisungen
\Macro{ClassInfoNoLine} und \Macro{PackageInfoNoLine}, um auch Informationen
ohne Zeilennummer in die Log-Datei zu schreiben, fehlen jedoch. Diese werden
von \Package{scrbase} bereit gestellt.
@@ -1684,8 +1893,8 @@ Zahlen und \textit{Rest} außerdem größer oder gleich 0 und kleiner als
0).
Der Wert kann jeweils zur Zuweisung an einen Zähler oder direkt innerhalb
-eines Ausdrucks mit \Macro{numexpr} verwendet werden. Zur Ausgabe als
-arabische Zahl ist \Macro{the} voran zu stellen.%
+eines Ausdrucks mit \Macro{numexpr}\IndexCmd{numexpr} verwendet werden. Zur
+Ausgabe als arabische Zahl ist \Macro{the} voranzustellen.%
%
\EndIndexGroup
%
@@ -1710,5 +1919,6 @@ arabische Zahl ist \Macro{the} voran zu stellen.%
% LocalWords: AtEndOfFamilyOptions FamilyBoolKey FamilySetBool Schaltername
% LocalWords: FamilyLengthKey FamilySetLength FamilyLengthMacroKey
% LocalWords: FamilySetLengthMacro Wertübergabe Gliederungsbefehlen
-
-% LocalWords: Sternvariante
+% LocalWords: Sternvariante Anwenderanweisungen Signalisierung Paketautoren
+% LocalWords: Familienschlüssel Mitgliederschlüssels Vergleichszustand
+% LocalWords: Benutzeräquivalent Dokumentpräambel voranzustellen
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle-experts.tex
index eb0beb7881f..8fcb6c5a348 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle-experts.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle-experts.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrbookreportarticle-experts.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrbookreportarticle-experts.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -48,7 +48,7 @@
% ============================================================================
\KOMAProvidesFile{scrbookreportarticle-experts.tex}%
- [$Date: 2017-05-12 13:41:47 +0200 (Fri, 12 May 2017) $
+ [$Date: 2018-02-13 09:46:41 +0100 (Tue, 13 Feb 2018) $
KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl for
experts)]
@@ -60,31 +60,25 @@
Paket \Package{scrextend}}
\labelbase{maincls-experts}
-\BeginIndexGroup
-\BeginIndex{Class}{scrartcl}
-\BeginIndex{Class}{scrbook}
-\BeginIndex{Class}{scrreprt}
-\BeginIndex{Package}{scrextend}
-In diesem Kapitel finden Sie zusätzliche Informationen zu den
-\KOMAScript-Klassen \Class{scrbook}, \Class{scrreprt} und \Class{scrartcl} und
-einigen Anweisungen, die auch in \Package{scrextend} vorhanden sind.
-\iffree{Einige Teile des Kapitels sind dabei dem \KOMAScript-Buch
- \cite{book:komascript} vorbehalten. Dies sollte kein Problem sein, denn
- der}{Der} normale Anwender, der die Klassen einfach nur verwenden will, wird
-diese Informationen normalerweise nicht benötigen. Ein Teil der Informationen
-richtet sich an Anwender, die ausgefallene Aufgaben lösen oder eigene Klassen
-schreiben wollen, die auf einer der drei \KOMAScript-Klassen basieren. Ein
-weiterer Teil der Informationen behandelt Möglichkeiten der Klassen, die aus
-Gründen der Kompatibilität zu den Standardklassen oder früheren Versionen von
-\KOMAScript{} existieren. Die Teile, die nur aus Gründen der Kompatibilität zu
-früheren Versionen von \KOMAScript{} existieren, sind in serifenloser Schrift
-gesetzt und sollten nicht mehr verwendet werden.
+\BeginIndexGroup \BeginIndex{Class}{scrartcl} \BeginIndex{Class}{scrbook}
+\BeginIndex{Class}{scrreprt} \BeginIndex{Package}{scrextend} In diesem Kapitel
+finden Sie zusätzliche Informationen zu den \KOMAScript-Klassen
+\Class{scrbook}, \Class{scrreprt} und \Class{scrartcl} und einigen
+Anweisungen, die auch in \Package{scrextend} vorhanden sind. \iffree{Einige
+ Teile des Kapitels sind dabei dem \KOMAScript-Buch \cite{book:komascript}
+ vorbehalten. Dies sollte kein Problem sein, denn der}{Der} normale Anwender,
+der die Klassen einfach nur verwenden will, wird diese Informationen eher
+selten benötigen. Ein Teil der Informationen richtet sich an Anwender, die
+ausgefallene Aufgaben lösen oder eigene Klassen schreiben wollen, die auf
+einer \KOMAScript-Klasse basieren. Anderes existiert nur aus Gründen der
+Kompatibilität zu den Standardklassen\iffree{ oder früheren Versionen von
+ \KOMAScript}{}.\iffree{}{ Teile, die nur aus Gründen der
+ Kompatibilität zu früheren Versionen von \KOMAScript{} existieren, sind in
+ serifenloser Schrift gesetzt und sollten nicht mehr verwendet werden.}
\LoadNonFree{scrbookreportarticle-experts}{0}
-\iffree{}{\clearpage}% Umbruchoptimierung!!!
-
-\section{Ergänzende Hinweise zu Benutzeranweisungen}
+\section{Ergänzungen zu Benutzeranweisungen}
\seclabel{addInfos}
\LoadNonFree{scrbookreportarticle-experts}{1}
@@ -119,7 +113,7 @@ testen. Demgegenüber gibt \Macro{ClassName} Auskunft, welche Standardklasse
durch diese \KOMAScript-Klasse ersetzt wird.
Es\textnote{Achtung!} sei in diesem Zusammenhang darauf hingewiesen, dass
-demgegenüber die Existenz von
+dagegen die Existenz von
\DescRef{scrbase.cmd.KOMAScript}\IndexCmd{KOMAScript} nicht als Indiz für die
Verwendung einer \KOMAScript-Klasse dienen kann. Zum einen definieren alle
\KOMAScript-Pakete diese Anweisung, zum anderen können auch andere Pakete es
@@ -142,13 +136,13 @@ Die\ChangedAt{v3.08}{\Class{scrbook}\and \Class{scrreprt}\and
Inhaltsverzeichnis vorzunehmen. Stattdessen wird \Macro{addtocentrydefault}
mit ganz ähnlichen Argumenten aufgerufen. Die Anweisung kann sowohl für
nummerierte als auch für nicht nummerierte Einträge verwendet werden. Dabei
-gibt \PName{Ebene} die Gliederungsebene in Textform also \PValue{part},
+gibt \PName{Ebene} die Gliederungsebene in Textform an, also \PValue{part},
\PValue{chapter}, \PValue{section}, \PValue{subsection},
-\PValue{subsubsection}, \PValue{paragraph} oder \PValue{subparagraph} an. Die
+\PValue{subsubsection}, \PValue{paragraph} oder \PValue{subparagraph}. Die
formatierte Gliederungsnummer wird über das zweite Argument \PName{Nummer}
übergeben. Dieses Argument darf auch leer sein. Der Text des Eintrags wird mit
-\PName{Überschrift} angegeben. Es wird empfohlen zerbrechliche Befehle in
-diesem Argument mit
+\PName{Überschrift} angegeben. Zerbrechliche Befehle in
+diesem Argument sind mit
\Macro{protect}\IndexCmd{protect}\important{\Macro{protect}} zu schützen.
Für das Argument \PName{Nummer} gilt noch eine Besonderheit. Ist das Argument
@@ -163,7 +157,7 @@ soll. In der Voreinstellung wird dies mit
\end{quote}
erreicht. Ist das Argument jedoch nicht leer, so soll ein nummerierter Eintrag
erzeugt werden und \PName{Nummer} ist die vorformatierte Gliederungsnummer. In
-der Voreinstellung verwendet \KOMAScript{}
+der Voreinstellung verwendet \KOMAScript{} dann:
\begin{quote}\small\raggedright
\Macro{addcontentsline}\PParameter{toc}\Parameter{Ebene}%
\PParameter{\%\\
@@ -171,11 +165,11 @@ der Voreinstellung verwendet \KOMAScript{}
\PName{Überschrift}\%\\
}
\end{quote}
-zur Erzeugung dieses Eintrags.
+\iffalse zur Erzeugung dieses Eintrags.\fi
Paketautoren und Autoren von Wrapper-Klassen können diese Anweisung
umdefinieren, um Einfluss auf die Einträge zu nehmen. So\textnote{Beispiel}
-wäre beispielsweise denkbar mit
+wäre beispielsweise denkbar, mit
\begin{lstcode}
\renewcommand{\addtocentrydefault}[3]{%
\ifstr{#3}{}{%
@@ -216,7 +210,7 @@ Auch \ChangedAt{v3.08}{\Class{scrbook}\and \Class{scrreprt}\and
\Macro{relax}\IndexCmd{relax}\important{\Macro{relax}} ist. In der
Voreinstellung sind die angegebenen Anweisungen alle so definiert, dass sie
ihre \PName{Ebene} und die Argumente direkt an
-\DescRef{\LabelBase.cmd.addtocentrydefault} weiter geben.%
+\DescRef{\LabelBase.cmd.addtocentrydefault} weitergeben.%
%
\EndIndexGroup
@@ -225,26 +219,27 @@ ihre \PName{Ebene} und die Argumente direkt an
\Macro{raggedchapterentry}
\end{Declaration}
Bei früheren\ChangedAt{v3.21}{\Class{scrbook}\and \Class{scrreprt}} Version
-von \KOMAScript{} gab es die Möglichkeit das \Macro{raggedchapterentry} als
-\Macro{raggedright} zu definieren, um den Text der Kapiteleinträge ins
+von \KOMAScript{} gab es die Möglichkeit, das Makro \Macro{raggedchapterentry}
+als \Macro{raggedright} zu definieren, um den Text der Kapiteleinträge ins
Inhaltsverzeichnis im linksbündigen Flattersatz zu setzen. Offiziell existiert
diese Möglichkeit seit \KOMAScript-Version~3.21 nicht mehr.
-Tatsächlich ist aber in \Package{tocbasic}\IndexPackage{tocbasic} Eigenschaft
-\PValue{raggedentrytext} für den Stil \PValue{tocline} so definiert, dass sie
-das Makro \Macro{ragged\PName{Eintragsebene}entry} entweder auf
-\Macro{raggedright} oder auf \Macro{relax} setzt. Bei der Auswertung der
-Eigenschaft wird dann getestet, ob das entsprechende Makro entweder
-\Macro{raggedright} ist oder als \Macro{raggedright} definiert ist. In beiden
-Fällen wird Flattersatz verwendet. In allen anderen Fällen wird kein
-Flattersatz verwendet.
-
-Da auch früher schon dokumentiert war, dass \Macro{raggedchapterentry} nicht
+Tatsächlich ist aber die Eigenschaft \PValue{raggedentrytext} für den
+Eintrags-Stil \PValue{tocline} im Paket
+\hyperref[cha:tocbasic]{\Package{tocbasic}}\IndexPackage{tocbasic} so
+implementiert, dass sie das Makro \Macro{ragged\PName{Eintragsebene}entry}
+entweder auf \Macro{relax} oder auf \Macro{raggedright} setzt. Bei der
+Auswertung der Eigenschaft wird dann getestet, ob das entsprechende Makro
+entweder \Macro{raggedright} ist oder als \Macro{raggedright} definiert
+ist. In beiden Fällen wird Flattersatz verwendet. In allen anderen Fällen wird
+kein Flattersatz verwendet.
+
+Da schon früher dokumentiert war, dass \Macro{raggedchapterentry} nicht
als etwas anderes als \Macro{raggedright} definiert werden sollte, ist damit
Kompatibilität zum dokumentierten Verhalten früherer Versionen erreicht. Wie
in früheren Versionen gewarnt, führen andere Definitionen von
-\Macro{raggedchaperentry} -- nun aber auch von \Macro{raggedsectionentry} und
-entsprechend für die anderen Eintragsebenen -- eventuell zu unerwarteten
+\Macro{raggedchapterentry} -- nun aber auch von \Macro{raggedsectionentry} und
+entsprechend für die anderen Eintragsebenen -- möglicherweise zu unerwarteten
Ergebnissen.
Empfohlen wird, eventuell gewünschten Flattersatz für Verzeichniseinträge
@@ -261,17 +256,19 @@ stattdessen über die genannte Eigenschaft des Verzeichniseintragsstils
\Macro{changefontsizes}\Parameter{Schriftgröße}
\end{Declaration}
Der\iffree{ in \autoref{sec:maincls-experts.addInfos}}{} auf
-\DescPageRef{maincls-experts.option.fontsize} für die
-Schriftgrößendateien angegebene Präfix \File{scrsize}, ist lediglich die
-Voreinstellung für das interne Makro
-\Macro{@fontsizefilebase}\IndexCmd{@fontsizefilebase}, die verwendet wird,
-wenn das Makro beim Laden der Klasse oder des Pakets \Package{scrextend} noch
-nicht definiert ist. Autoren von Wrapper-Klassen können dieses Makro
-abweichend definieren, um andere Schriftgrößendateien zu
+\DescPageRef{maincls-experts.option.fontsize} für die Schriftgrößendateien
+angegebene Präfix \File{scrsize}, ist lediglich die Voreinstellung für das
+interne Makro \Macro{@fontsizefilebase}\IndexCmd{@fontsizefilebase}, die
+verwendet wird, wenn das Makro beim Laden der Klasse oder des Pakets
+\Package{scrextend} noch nicht definiert ist. Autoren von Wrapper-Klassen
+können dieses Makro abweichend definieren, um andere Schriftgrößendateien zu
verwenden. Ebenso\textnote{Tipp!} können Autoren von Wrapper-Klassen die
-\emph{fallback}-Lösung dadurch ändern oder abschalten, dass sie das Macro
+\emph{fallback}-Lösung der berechneten Schriftgrößen dadurch ändern oder
+abschalten, dass sie das Makro
\Macro{changefontsizes}\important{\Macro{changefontsizes}}, das als Argument
-die gewünschte \PName{Schriftgröße} erwartet, umdefinieren.%
+die gewünschte \PName{Schriftgröße} erwartet, umdefinieren. Das
+Makro\textnote{Achtung!} \Macro{changefontsizes} ist jedoch nicht als
+Anweisung für den Aufruf durch Anwender konzipiert.%
\EndIndexGroup
@@ -290,25 +287,27 @@ tragen, dass er an den entsprechenden Stellen die Anweisung
\DescRef{maincls.cmd.usekomafont}%
\important{\DescRef{maincls.cmd.usekomafont}}\IndexCmd{usekomafont} (siehe
\DescPageRef{maincls.cmd.usekomafont}) für dieses Element in seinen
-Definitionen einbaut.
+Definitionen einbaut. Der Aufruf von \Macro{newkomafont} für ein bereits
+existierendes Element führt zu Fehlermeldungen.
Das optionale Argument \PName{Warnung} definiert eine Warnmeldung. Diese wird
bei den \KOMAScript-Klassen per \Macro{ClassWarning} oder beim Paket
\Package{scrextend} per \Macro{PackageWarning} immer dann ausgegeben, wenn die
-Voreinstellung für das Element verändert wird. Dabei wird als Urheber der
-Warnung die verwendete \KOMAScript-Klasse oder das Paket \Package{scrextend}
-ausgegeben.
+Voreinstellung für das Element verändert wird. Als Urheber der
+Warnung wird das Paket
+\Package{scrkbase}\IndexPackage{scrkbase}\important{\Package{scrkbase}}
+angegeben.
Mit \Macro{aliaskomafont} kann für ein bereits existierendes \PName{Element}
ein \PName{Aliasname} definiert werden. \KOMAScript{} informiert den Benutzer
-automatisch über den Namen des tatsächlichen Elements, wenn dieser den
-\PName{Aliasname} verwendet. \PName{Aliasname}n\textnote{Tipp!} können
+in der \File{log}-Datei über den Namen des tatsächlichen Elements, wenn dieser
+den \PName{Aliasname} verwendet. \PName{Aliasname}n\textnote{Tipp!} können
beispielsweise dann eingesetzt werden, wenn der Entwickler sich später einen
besseren Namen für ein Element überlegt und der alte Name aus
Kompatibilitätsgründen weiter verwendbar bleiben soll. Außerdem kann damit die
Benutzerfreundlichkeit erhöht werden, indem einem Element all die Namen als
Alias zugeordnet werden, die unterschiedliche Benutzer intuitiv wählen
-würden. \KOMAScript{} selbst macht von dieser Möglichkeit reichen Gebrauch.
+würden. \KOMAScript{} selbst macht von dieser Möglichkeit regen Gebrauch.
%
\EndIndexGroup
@@ -332,7 +331,7 @@ Verwendung der Schrifteinstellungen wurde daher möglichst so vorgegangen, dass
viele dieser eigentlich verbotenen Einstellungen trotzdem keinen Schaden
anrichten und es meist sogar funktioniert, wenn der letzte Befehl in der
Schrifteinstellung ein Argument erwartet, also beispielsweise \Macro{textbf}
-an Stelle von \Macro{bfseries} verwendet wird. Eine Garantie gibt es dafür
+anstelle von \Macro{bfseries} verwendet wird. Eine Garantie gibt es dafür
jedoch nicht.
In Einzelfällen war es innerhalb von \KOMAScript{} notwendig, die Umschaltung
@@ -368,7 +367,7 @@ hinzuzufügen!
Für\ChangedAt{v3.24}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} Befehle, deren erstes Argument noch ohne zusätzliche
-Gruppe ausgeführt werden soll, gibt es hingegen
+Gruppe ausgeführt werden soll, gibt es
\Macro{addtokomafontonearglist}. Das angegebene \PName{Makro} wird dabei auf
\Macro{@firstofone} gesetzt. In der Voreinstellung wird dies für
\Macro{MakeUppercase} und \Macro{MakeLowercase} verwendet.
@@ -376,7 +375,7 @@ Gruppe ausgeführt werden soll, gibt es hingegen
Soll\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} hingegen ein \PName{Makro} innerhalb von
\DescRef{maincls.cmd.usefontofkomafont} und ihren Geschwistern zusammen mit
-seinem ersten Arguments ignoriert werden, so ist stattdessen
+seinem ersten Argument ignoriert werden, so ist stattdessen
\Macro{addtokomafontgobblelist} zu verwenden. Ein Beispiel dafür ist die
Anweisung \Macro{color}, die einschließlich des Namens der Farbe ignoriert
werden muss und deshalb bereits in der Voreinstellung Teil dieser Liste ist.
@@ -390,20 +389,32 @@ Liste zwingend benötigen, sollte Sie diese also selbst explizit hinzufügen.%
\begin{Declaration}
\Macro{IfExistskomafont}\Parameter{Element}\Parameter{Dann-Code}%
\Parameter{Sonst-Code}
+ \Macro{IfIsAliaskomafont}\Parameter{Element}\Parameter{Dann-Code}%
+ \Parameter{Sonst-Code}
\end{Declaration}
Da\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}\and \Class{scrlttr2}} die Schrift mancher Elemente erst ab
-bestimmten Versionen von \KOMAScript{} geändert werden können, ist es manchmal
+bestimmten Versionen von \KOMAScript{} geändert werden kann, ist es manchmal
sinnvoll, vorher testen zu können, ob ein \PName{Element} mit dieser
-Möglichkeit überhaupt existiert. Die Anweisung führt den \PName{Dann-Code}
-genau dann aus, wenn das \PName{Element} über
+Möglichkeit überhaupt existiert. Die Anweisung \Macro{IfExistskomafont} führt
+den \PName{Dann-Code} genau dann aus, wenn das \PName{Element} über
\DescRef{\LabelBase.cmd.newkomafont} oder
\DescRef{\LabelBase.cmd.aliaskomafont} definiert wurde und daher auch mit
\DescRef{maincls.cmd.setkomafont} oder \DescRef{maincls.cmd.addtokomafont}
geändert und mit den \Macro{use\dots komafont}-Anweisungen abgefragt werden
-kann. Anderenfalls wird der \PName{Sonst-Code} ausgeführt.%
+kann. Anderenfalls wird der \PName{Sonst-Code} ausgeführt.
+
+Im Unterschied dazu führt
+\Macro{IfIsAliaskomafont}\ChangedAt{v3.25}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}\and \Class{scrlttr2}} den
+\PName{Dann-Code} nur aus, wenn \PName{Element} über
+\DescRef{\LabelBase.cmd.aliaskomafont} als Alias für ein anderes Element
+definiert wurde. Sowohl für nicht definierte Elemente als auch für mit
+\DescRef{\LabelBase.cmd.newkomafont} definierte Elemente wird hingegen der
+\PName{Sonst-Code} ausgeführt.%
\EndIndexGroup
+
% \subsection{Absatzmarkierung}
% \seclabel{parskip}
@@ -412,10 +423,10 @@ kann. Anderenfalls wird der \PName{Sonst-Code} ausgeführt.%
\Parameter{Endzeilenleerraum}
\end{Declaration}
\KOMAScript{} bietet mit dieser Anweisung die Möglichkeit, sowohl den
-Absatzeinzug, als auch den Absatzabstand und den Freiraum am Ende der letzten
+Absatzeinzug als auch den Absatzabstand und den Freiraum am Ende der letzten
Zeile des Absatzes einzustellen. Diese Anweisung ist immer dann zu verwenden,
wenn die Änderungen auch bei Einstellung
-\OptionValueRef{maincls}{parskip}{relative} beachtet werden
+\OptionValueRef{\LabelBase}{parskip}{relative} beachtet werden
sollen. \KOMAScript{}\textnote{Beispiel} selbst verwendet sie beispielsweise
in der Form
\begin{lstcode}
@@ -462,22 +473,23 @@ deaktiviert.%
\Macro{RedeclareSectionCommand}\OParameter{Einstellungen}\Parameter{Name}
\Macro{ProvideSectionCommand}\OParameter{Einstellungen}\Parameter{Name}
\end{Declaration}
-Mit\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} diesen Anweisungen kann ein neuer Gliederungsbefehl
-\Macro{\PName{Name}} definiert oder der vorhandene Gliederungsbefehl
-\Macro{\PName{Name}} verändert werden. Dazu werden über das optionale Argument
-\PName{Einstellungen} vorgenommen. Die \PName{Einstellungen} sind dabei eine
-durch Komma separierte Liste von
+Diese\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} Anweisungen dienen dazu, einen neuen Gliederungsbefehl
+\Macro{\PName{Name}} zu definieren beziehungsweise einen vorhandenen
+Gliederungsbefehl \Macro{\PName{Name}} zu verändern. Dazu werden über das
+optionale Argument \PName{Einstellungen} vorgenommen. Die
+\PName{Einstellungen} sind dabei eine durch Komma separierte Liste von
\PName{Schlüssel}=\PName{Wert}-Zuweisungen. Neben den vom Stil der Überschrift
unabhängigen Eigenschaften, die
-\autoref{tab:maincls-experts.declaresection.keys} zu entnehmen sind, gibt es
-auch Eigenschaften, die vom jeweiligen Stil abhängig sind. Derzeit stehen die
-folgenden Stile zur Verfügung:
-\begin{labeling}{\PValue{chapter}:}
-\item[\PValue{chapter}:] \ChangedAt{v3.18}{\Class{scrbook}\and
- \Class{scrreprt}}Stil\textnote{Gliederungsstil
- \PValue{chapter}}\Index{Gliederung>Stil>~\PValue{chapter}} einer
- Kapitelüberschrift. Dieser Stil wird in der Voreinstellung für
+\autoref{tab:maincls-experts.declaresection.keys},
+\autopageref{tab:maincls-experts.declaresection.keys} zu entnehmen sind, gibt
+es auch Eigenschaften, die vom jeweiligen Stil abhängig sind. Derzeit stehen
+die folgenden Stile zur Verfügung:
+\begin{description}\setkomafont{descriptionlabel}{}
+\item[\PValue{chapter}] \ChangedAt{v3.18}{\Class{scrbook}\and
+ \Class{scrreprt}}ist der Stil\textnote{Gliederungsstil
+ \PValue{chapter}}\Index{Gliederung>Stil>~\PValue{chapter}} für
+ Kapitelüberschriften. Dieser Stil wird in der Voreinstellung für
\DescRef{maincls.cmd.chapter}\IndexCmd{chapter} und indirekt für
\DescRef{maincls.cmd.addchap}\IndexCmd{addchap} verwendet. Neue
Überschriften in diesem Stil können definiert werden, haben dann aber nicht
@@ -491,50 +503,52 @@ folgenden Stile zur Verfügung:
verändert werden. Es ist zu beachten, dass dieser Stil von
\Class{scrartcl}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} nicht
bereitgestellt wird.
-\item[\PValue{part}:] \ChangedAt{v3.18}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}}Stil\textnote{Gliederungsstil
- \PValue{part}}\Index{Gliederung>Stil>~\PValue{part}} einer
- Teileüberschrift. Dieser Stil wird in der Voreinstellung für
+\item[\PValue{part}] \ChangedAt{v3.18}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}}ist der
+ Stil\textnote{Gliederungsstil
+ \PValue{part}}\Index{Gliederung>Stil>~\PValue{part}} für
+ Teileüberschriften. Dieser Stil wird in der Voreinstellung für
\DescRef{maincls.cmd.part}\IndexCmd{part} und indirekt für
- \Macro{addpart}\IndexCmd{addpart} verwendet. Neue Überschriften in diesem
- Stil können definiert werden, haben dann aber nicht automatisch auch eine
- \Macro{add\dots}-Variante. Für die Konfiguration der vorhandenen oder neuer
- Überschriften stehen zusätzlich die Eigenschaften aus
+ \DescRef{maincls.cmd.addpart}\IndexCmd{addpart} verwendet. Neue
+ Überschriften in diesem Stil können definiert werden, haben dann aber nicht
+ automatisch auch eine \Macro{add\dots}-Variante. Für die Konfiguration der
+ vorhandenen oder neuer Überschriften stehen zusätzlich die Eigenschaften aus
\autoref{tab:maincls-experts.declarepartstyle.keys},
\autopageref{tab:maincls-experts.declarepartstyle.keys} zur
- Verfügung. Die\textnote{Achtung!} Anweisung \Macro{addpart} wird ebenso wie
- die Sternformen automatisch zusammen mit \DescRef{maincls.cmd.part}
- umkonfiguriert und kann nicht unabhängig davon verändert werden.
-\item[\PValue{section}:] Stil\textnote{Gliederungsstil
- \PValue{section}}\Index{Gliederung>Stil>~\PValue{section}} einer
- Abschnittsüberschrift. Dieser Stil wird derzeit für
- \DescRef{maincls.cmd.section}\IndexCmd{section},
+ Verfügung. Die\textnote{Achtung!} Anweisung \DescRef{maincls.cmd.addpart}
+ wird ebenso wie die Sternformen automatisch zusammen mit
+ \DescRef{maincls.cmd.part} umkonfiguriert und kann nicht unabhängig davon
+ verändert werden.
+\item[\PValue{section}] ist der Stil\textnote{Gliederungsstil
+ \PValue{section}}\Index{Gliederung>Stil>~\PValue{section}} für
+ Abschnittsüberschriften und tieferer Ebenen. Dieser Stil wird derzeit sowohl
+ für \DescRef{maincls.cmd.section}\IndexCmd{section},
\DescRef{maincls.cmd.subsection}\IndexCmd{subsection},
- \DescRef{maincls.cmd.subsubsection}\IndexCmd{subsubsection},
+ \DescRef{maincls.cmd.subsubsection}\IndexCmd{subsubsection} als auch
\DescRef{maincls.cmd.paragraph}\IndexCmd{paragraph} und
\DescRef{maincls.cmd.subparagraph}\IndexCmd{subparagraph} verwendet. Neue
- Überschriften in diesem Stil können definiert werden. Für die Konfigurierung
+ Überschriften in diesem Stil können definiert werden. Für die Konfiguration
der vorhandenen oder neuer Überschriften stehen zusätzlich die Eigenschaften
aus \autoref{tab:maincls-experts.declaresectionstyle.keys},
\autopageref{tab:maincls-experts.declaresectionstyle.keys} zur
Verfügung. Bei\ChangedAt{v3.24}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} der Neudefinition sind die \PName{Schlüssel}
\PValue{style}, \PValue{afterskip}, \PValue{beforeskip} und \PValue{level}
- zwingend. \PValue{font}, \PValue{indent} sind dringend empfohlen.
- \PValue{tocindent} und \PValue{tocnumwidth} können abhängig vom Namen der
- Gliederungsebene ebenfalls zwingend sein. Das gilt auch, falls ein Befehl,
- der bisher kein Gliederungsbefehl war, mit \Macro{RedeclareSectionCommand}
- zu einem Gliederungsbefehl umdefiniert wird. Die\textnote{Achtung!}
- Anweisung \Macro{addsec} wird ebenso wie die Sternformen automatisch
- zusammen mit \DescRef{maincls.cmd.section} umkonfiguriert und kann nicht
- unabhängig davon verändert werden. Bei der Definition eines
- Gliederungsbefehls in diesem Stil wird gleichzeitig ein gleichnamiges
- Element angelegt, dessen Schrifteinstellung mit
- \DescRef{maincls.cmd.setkomafont} und \DescRef{maincls.cmd.addtokomafont}
- (siehe \autoref{sec:maincls.textmarkup},
- \DescPageRef{maincls.cmd.setkomafont}) geändert werden kann, falls ein
- solches Element noch nicht existiert.
-\end{labeling}
+ zwingend. Die \PName{Schlüssel} \PValue{font} und \PValue{indent} sind
+ empfohlen. \PValue{tocindent} und \PValue{tocnumwidth} können abhängig vom
+ Namen der Gliederungsebene ebenfalls zwingend sein. Das gilt auch, falls ein
+ Befehl, der bisher kein Gliederungsbefehl war, mit
+ \Macro{RedeclareSectionCommand} zu einem Gliederungsbefehl umdefiniert
+ wird. Die\textnote{Achtung!} Anweisung \Macro{addsec} wird ebenso wie die
+ Sternformen zusammen mit \DescRef{maincls.cmd.section}
+ umkonfiguriert und kann nicht unabhängig davon verändert werden.
+\end{description}
+Bei der Definition eines Gliederungsbefehls wird ein gleichnamiges Element
+angelegt, falls es noch nicht existiert. Bei \PValue{chapter} und
+\PValue{part} werden ebenso Elemente für die Präfixzeile erzeugt. Die
+Schrifteinstellung der Elemente kann mit \DescRef{maincls.cmd.setkomafont} und
+\DescRef{maincls.cmd.addtokomafont} (siehe \autoref{sec:maincls.textmarkup},
+\DescPageRef{maincls.cmd.setkomafont}) geändert werden.
\begin{table}
\caption[{Stil unabhängige Eigenschaften bei der Deklaration von
@@ -552,12 +566,12 @@ folgenden Stile zur Verfügung:
abhängig sein. Wird
\PName{Zählername} über
\Macro{stepcounter} oder
- \Macro{refstepsounter}
+ \Macro{refstepcounter}
erhöht, so wird der zur
Gliederungsebene gehörende
Zähler auf 0 zurückgesetzt.
Darüber hinaus wird
- \Macro{the\PName{Zählername}}
+ \Macro{the\PName{Zählername}},
gefolgt von einem Punkt in
der Ausgabe des zur
Gliederungsebene gehörenden
@@ -581,7 +595,7 @@ folgenden Stile zur Verfügung:
Schalter nicht aktiv, so werden
alle nachfolgend angegebenen
Werte für Längen nur testweise
- expandiert und ausgewertet aber
+ expandiert und ausgewertet, aber
lediglich expandiert gespeichert.
Es werden die Werte für einfache
Schalter aus
@@ -595,17 +609,19 @@ folgenden Stile zur Verfügung:
\DescPageRef{maincls.counter.secnumdepth});
der Wert sollte eindeutig sein und ist
für neue Ebenen zwingend.\\
- \PValue{style} & \PName{Name} & Legt den Stil der Überschriften fest und
+ \PValue{style} & \PName{Name} & Legt den Stil der Überschrift fest und
ist für neue Ebenen zwingend.\\
\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
- \PValue{tocstyle} & \PName{Name} & Legt den Stil der Verzeichniseinträge
+ \PValue{tocstyle} & \PName{Name} & Legt den Stil des zur Überschrift
+ gehörenden Verzeichniseintrags
fest. Es können alle bisher definierten
Verzeichniseintragsstile (siehe
\autoref{sec:tocbasic.tocstyle})
verwendet werden. Ein leerer
- \PName{Name} verhindert die Definition
- des Befehls \Macro{l@\dots} für die
+ \PName{Name} verhindert die
+ Umdefinierung des Befehls
+ \Macro{l@\dots} für die
Verzeichniseinträge.\\
\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
@@ -617,7 +633,7 @@ folgenden Stile zur Verfügung:
\autoref{sec:tocbasic.tocstyle}
ab
\autopageref{sec:tocbasic.tocstyle}.
- Für die von \Package{tocbasic}
+ Für die von \hyperref[cha:tocbasic]{\Package{tocbasic}}
vordefinierten
Verzeichniseintragsstile
finden sich die als
@@ -852,20 +868,20 @@ von \TeX{} bereits belegter \PName{Name} sein.
Bei \Macro{DeclareSectionCommand} findet keinerlei Überprüfung statt, ob
\PName{Name} von \TeX{} bereits anderweitig belegt ist. Stattdessen wird der
-Gliederungsbefehl \Macro{\PName{Name}} unbedingt mit den angegebenen
+Gliederungsbefehl \Macro{\PName{Name}} unbedingt entsprechend der angegebenen
\PName{Eigenschaften} definiert.
-Zu jeder Gliederungsanweisung gehört außerdem ein Zähler mit demselben
-\PName{Name}, der bei Bedarf von allen vier Befehlen mit \Macro{newcounter}
-neu angelegt wird. Dasselbe gilt für die Ausgabe des Zählers,
-\Macro{the\PName{Name}}, die Formatierung des Zählers,
-\Macro{\PName{Name}format}, die Anweisung zur Erstellung eines Kolumnentitels,
-\Macro{\PName{Name}mark}, die dabei verwendete Formatierung des Zählers,
-\Macro{\PName{Name}markformat}, das Element \FontElement{\PName{Name}}, und
-die Gliederungsebene \Macro{\PName{Name}numdepth}. Die Anweisung zur
-Erstellung eines Kolumnentitels, \Macro{\PName{Name}mark} wird dabei
+Zu jeder Gliederungsanweisung gehört außerdem ein Zähler: \PName{Name}, der
+bei Bedarf von allen vier Befehlen mit \Macro{newcounter} neu angelegt
+wird. Dasselbe gilt für die Ausgabe des Zählers: \Macro{the\PName{Name}}, die
+Formatierung des Zählers: \Macro{\PName{Name}format}, die Anweisung zur
+Erstellung eines Kolumnentitels: \Macro{\PName{Name}mark}, die dabei
+verwendete Formatierung des Zählers: \Macro{\PName{Name}markformat}, die oben
+erwähnten Elemente: \FontElement{\PName{Name}} und gegebenenfalls
+\FontElement{\PName{Name}prefix}, die nummerische Gliederungsebene:
+\Macro{\PName{Name}numdepth}. Die Anweisung \Macro{\PName{Name}mark} wird
gegebenenfalls so vordefiniert, dass kein Kolumnentitel erzeugt wird. Die
-Ausgabe des Zählers, \Macro{the\PName{Name}} wird als arabische Zahl
+Ausgabe des Zählers, \Macro{\PName{the}mark}, wird als arabische Zahl
vordefiniert. Wird über den \PName{Schlüssel} \PValue{counterwithin} der
Zähler als von einem anderen Zähler abhängig definiert, so wird in der Ausgabe
dieser andere Zähler mit einem Punkt getrennt vorangestellt.
@@ -873,7 +889,8 @@ dieser andere Zähler mit einem Punkt getrennt vorangestellt.
Neben\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} dem Gliederungsbefehl selbst wird auch ein Befehl für
einen Eintrag ins Inhaltsverzeichnis definiert. Dafür wird auf das Paket
-\Package{tocbasic}\important{\Package{tocbasic}}\IndexPackage{tocbasic}
+\hyperref[cha:tocbasic]{\Package{tocbasic}}%
+\important{\hyperref[cha:tocbasic]{\Package{tocbasic}}}\IndexPackage{tocbasic}
zurückgegriffen. Der Stil des Verzeichniseintrags wird über die Eigenschaft
\PValue{tocstyle} festgelegt. Wird hier mit \OptionValue{tocstyle}{} oder
\OptionValue{tocstyle}{\{\}} ein leerer \PName{Name} angegeben, so erfolgt
@@ -884,15 +901,15 @@ so wird bei der Umdefinierung der bisherige Stil erneut verwendet.
Unterschiedliche\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}} Stile für Verzeichniseinträge haben
-unterschiedliche zusätzliche Eigenschaften. Diese können mit dem Präfix
-\PValue{toc} versehen direkt mit angegeben werden. So kann beispielsweise die
+unterschiedliche zusätzliche Eigenschaften. Diese können, mit dem Präfix
+\PValue{toc} versehen, direkt mit angegeben werden. So kann beispielsweise die
Ebene des Verzeichniseintrags, die bei allen von den \KOMAScript-Klassen und
-\Package{tocbasic} definierten Stilen als Eigenschaft \PValue{level} bekannt
-ist, mit \PValue{toclevel} gesetzt werden, der Einzug des Eintrags,
-\PValue{indent}, über \PValue{tocindent} und die für die Nummer reservierte
-Breite, \PValue{numwidth}, mit \PValue{tocnumwidth}. Für weitere Eigenschaften
-der Verzeichniseinträge siehe \autoref{sec:tocbasic.tocstyle} ab Seite
-\autopageref{sec:tocbasic.tocstyle}.
+\hyperref[cha:tocbasic]{\Package{tocbasic}} definierten Stilen als Eigenschaft
+\PValue{level} bekannt ist, mit \PValue{toclevel} gesetzt werden, der Einzug
+des Eintrags, \PValue{indent}, über \PValue{tocindent} und die für die Nummer
+reservierte Breite, \PValue{numwidth}, mit \PValue{tocnumwidth}. Für weitere
+Eigenschaften der Verzeichniseinträge siehe \autoref{sec:tocbasic.tocstyle} ab
+Seite \autopageref{sec:tocbasic.tocstyle}.
\begin{Example}
Aus unerfindlichen Gründen sollen die Überschriften von
@@ -933,9 +950,9 @@ der Verzeichniseinträge siehe \autoref{sec:tocbasic.tocstyle} ab Seite
gegebenenfalls tatsächlich bis auf 0 schrumpft.
\end{Example}
-Dass im Beispiel tatsächlich nur die Schlüssel \PValue{beforeskip} und
-\PValue{afterskip} verwendet werden mussten, liegt daran, dass seit
-\KOMAScript{} v3.15 \DescRef{maincls.cmd.paragraph} intern bereits mit
+Dass im Beispiel nur die Schlüssel \PValue{beforeskip} und \PValue{afterskip}
+verwendet werden mussten, liegt daran, dass seit \KOMAScript{} 3.15
+\DescRef{maincls.cmd.paragraph} intern bereits mit
\Macro{DeclareSectionCommand} definiert wird und daher die übrigen
Einstellungen unverändert übernommen werden können. Die Originaldefinition von
\DescRef{maincls.cmd.paragraph} entspricht bei \Class{scrartcl}:
@@ -965,22 +982,34 @@ voreingestellten Größe der Überschrift beziehungsweise des
Inhaltsverzeichniseintrags abhängig sind. Weitere
Voreinstellungen\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}} für die Stile der Verzeichniseinträge
-sind \autoref{sec:tocbasic.tocstyle}\important{\Package{tocbasic}} ab
+sind \autoref{sec:tocbasic.tocstyle}%
+\important{\hyperref[cha:tocbasic]{\Package{tocbasic}}} ab
\autopageref{sec:tocbasic.tocstyle} zu entnehmen.
\begin{table}
- \centering
- \caption{Voreinstellungen für die Kapitelüberschriften von \Class{scrbook}
- und \Class{scrreprt} in Abhängigkeit von Option \DescRef{maincls.option.headings}}
- \label{tab:maincls.chapter.skips}
- \begin{tabular}{ll}
+ %\centering
+ \KOMAoptions{captions=topbeside}%
+ \setcapindent{0pt}%
+ % \caption
+ \begin{captionbeside}
+ [{Voreinstellungen für die Kapitelüberschriften von \Class{scrbook}
+ und \Class{scrreprt} in Abhängigkeit von Option
+ \DescRef{maincls.option.headings}}]
+ {\hskip 0pt plus .5em
+ Voreinstellungen für die Kapitelüberschriften von \Class{scrbook}
+ und \Class{scrreprt} in Abhängigkeit von Option
+ \DescRef{maincls.option.headings}%
+ \label{tab:maincls.chapter.skips}}
+ [l]
+ \begin{tabular}[t]{ll}
\multicolumn{2}{@{}l}{\bfseries Mit \OptionValueRef{maincls}{headings}{big}:}\\
\toprule
Einstellung & voreingestellter Wert \\
\midrule
\PValue{afterskip}
- & \PValue{1.725\Length{baselineskip} plus .115\Length{baselineskip}
- minus .192\Length{baselineskip}} \\
+ & \PValue{1.725\Length{baselineskip} plus .115\Length{baselineskip}} \\
+ & \PValue{\phantom{1.725\Length{baselineskip}}
+ minus .192\Length{baselineskip}} \\
\PValue{beforeskip}
& \PValue{-3.3\Length{baselineskip}-\Length{parskip}} \\
\PValue{font} & \Macro{huge} \\
@@ -990,7 +1019,8 @@ sind \autoref{sec:tocbasic.tocstyle}\important{\Package{tocbasic}} ab
Einstellung & voreingestellter Wert \\
\midrule
\PValue{afterskip}
- & \PValue{1.5\Length{baselineskip} plus .1\Length{baselineskip}
+ & \PValue{1.5\Length{baselineskip} plus .1\Length{baselineskip}} \\
+ & \PValue{\phantom{1.5\Length{baselineskip}}
minus .167\Length{baselineskip}} \\
\PValue{beforeskip}
& \PValue{-3\Length{baselineskip}-\Length{parskip}} \\
@@ -1001,29 +1031,30 @@ sind \autoref{sec:tocbasic.tocstyle}\important{\Package{tocbasic}} ab
Einstellung & voreingestellter Wert \\
\midrule
\PValue{afterskip}
- & \PValue{1.35\Length{baselineskip} plus .09\Length{baselineskip}
+ & \PValue{1.35\Length{baselineskip} plus .09\Length{baselineskip}} \\
+ & \PValue{\phantom{1.35\Length{baselineskip}}
minus .15\Length{baselineskip}} \\
\PValue{beforeskip}
& \PValue{-2.8\Length{baselineskip}-\Length{parskip}} \\
\PValue{font} & \Macro{Large} \\
\bottomrule
\end{tabular}
+ \end{captionbeside}
\end{table}
%begin{table}
% \centering
\begin{longtable}{@{}p{\columnwidth}@{}}
- \caption{Voreinstellungen für die Überschriften von \Class{scrbook} und
- \Class{scrreprt}}%
+ \caption{Voreinstellungen für die Formatierung der Überschriften von
+ \Class{scrbook} und \Class{scrreprt}}%
\label{tab:maincls.section.defaults}\\
\endfirsthead
- \caption[]{Voreinstellungen für die Überschriften von \Class{scrbook} und
+ \caption[]{Voreinstellungen für die Formatierung der Überschriften von
+ \Class{scrbook} und
\Class{scrreprt} \emph{(Fortsetzung)}}\\
- \addlinespace[-\normalbaselineskip]
- \endhead
+ \addlinespace[-\normalbaselineskip] \endhead
\raggedleft\dots\\
- \endfoot
- \endlastfoot
+ \endfoot \endlastfoot
\DescRef{maincls.cmd.part}: \\*
\begin{tabularx}{\linewidth}{ll}
\toprule
@@ -1031,12 +1062,12 @@ sind \autoref{sec:tocbasic.tocstyle}\important{\Package{tocbasic}} ab
\midrule
\PValue{afterskip} & \PValue{0pt plus 1fil} \\
\PValue{beforeskip} & \PValue{0pt plus 1fil + \Length{baselineskip}} \\
- \PValue{font} & siehe Element \DescRef{maincls.fontelement.part},
+ \PValue{font} & siehe \DescRef{maincls.fontelement.part},
\autoref{tab:maincls.structureElementsFont},
\autopageref{tab:maincls.structureElementsFont} \\
\PValue{innerskip} & \PValue{20pt} \\
\PValue{level} & -1 \\
- \PValue{prefixfont} & siehe Element
+ \PValue{prefixfont} & siehe
\DescRef{maincls.fontelement.partnumber},
\autoref{tab:maincls.structureElementsFont},
\autopageref{tab:maincls.structureElementsFont} \\
@@ -1054,12 +1085,12 @@ sind \autoref{sec:tocbasic.tocstyle}\important{\Package{tocbasic}} ab
\midrule
\PValue{afterskip} & siehe \autoref{tab:maincls.chapter.skips} \\
\PValue{beforeskip} & siehe \autoref{tab:maincls.chapter.skips} \\
- \PValue{font} & siehe Element \DescRef{maincls.fontelement.chapter},
+ \PValue{font} & siehe \DescRef{maincls.fontelement.chapter},
\autoref{tab:maincls.structureElementsFont},
\autopageref{tab:maincls.structureElementsFont} \\
- \PValue{innerskip} & \PValue{0pt} \\
+ \PValue{innerskip} & \PValue{0.5\Length{baselineskip}} \\
\PValue{level} & 0 \\
- \PValue{prefixfont} & siehe Element
+ \PValue{prefixfont} & siehe
\DescRef{maincls.fontelement.chapterprefix},
\autoref{tab:maincls.structureElementsFont},
\autopageref{tab:maincls.structureElementsFont} \\
@@ -1077,7 +1108,7 @@ sind \autoref{sec:tocbasic.tocstyle}\important{\Package{tocbasic}} ab
\midrule
\PValue{afterskip} & \PValue{2.3ex plus .2ex} \\
\PValue{beforeskip} & \PValue{-3.5ex plus -1ex minus -.2ex} \\
- \PValue{font} & siehe Element \DescRef{maincls.fontelement.section},
+ \PValue{font} & siehe \DescRef{maincls.fontelement.section},
\autoref{tab:maincls.structureElementsFont},
\autopageref{tab:maincls.structureElementsFont} \\
\PValue{indent} & \PValue{0pt} \\
@@ -1096,7 +1127,7 @@ sind \autoref{sec:tocbasic.tocstyle}\important{\Package{tocbasic}} ab
\midrule\nopagebreak
\PValue{afterskip} & \PValue{1.5ex plus .2ex} \\
\PValue{beforeskip} & \PValue{-3.25ex plus -1ex minus -.2ex} \\
- \PValue{font} & siehe Element
+ \PValue{font} & siehe
\DescRef{maincls.fontelement.subsection},
\autoref{tab:maincls.structureElementsFont},
\autopageref{tab:maincls.structureElementsFont} \\
@@ -1116,7 +1147,7 @@ sind \autoref{sec:tocbasic.tocstyle}\important{\Package{tocbasic}} ab
\midrule\nopagebreak
\PValue{afterskip} & \PValue{1.5ex plus .2ex} \\
\PValue{beforeskip} & \PValue{-3.25ex plus -1ex minus -.2ex} \\
- \PValue{font} & siehe Element
+ \PValue{font} & siehe
\DescRef{maincls.fontelement.subsubsection},
\autoref{tab:maincls.structureElementsFont},
\autopageref{tab:maincls.structureElementsFont} \\
@@ -1136,7 +1167,7 @@ sind \autoref{sec:tocbasic.tocstyle}\important{\Package{tocbasic}} ab
\midrule\nopagebreak
\PValue{afterskip} & \PValue{-1em} \\
\PValue{beforeskip} & \PValue{3.25ex plus 1ex minus .2ex} \\
- \PValue{font} & siehe Element
+ \PValue{font} & siehe
\DescRef{maincls.fontelement.paragraph},
\autoref{tab:maincls.structureElementsFont},
\autopageref{tab:maincls.structureElementsFont} \\
@@ -1156,7 +1187,7 @@ sind \autoref{sec:tocbasic.tocstyle}\important{\Package{tocbasic}} ab
\midrule\nopagebreak
\PValue{afterskip} & \PValue{-1em} \\
\PValue{beforeskip} & \PValue{3.25ex plus 1ex minus .2ex} \\
- \PValue{font} & siehe Element
+ \PValue{font} & siehe
\DescRef{maincls.fontelement.subparagraph},
\autoref{tab:maincls.structureElementsFont},
\autopageref{tab:maincls.structureElementsFont} \\
@@ -1170,7 +1201,10 @@ sind \autoref{sec:tocbasic.tocstyle}\important{\Package{tocbasic}} ab
\end{tabularx}
\end{longtable}
%end{table}
-%
+Das in den Einstellungen für \DescRef{maincls.cmd.subparagraph} verwendete
+interne Makro \Macro{scr@parindent} ist übrigens, der per Option
+\DescRef{maincls.option.parskip} oder Befehl
+\DescRef{maincls-experts.cmd.setparsizes} eingestellte Absatzeinzug.
\EndIndexGroup
@@ -1184,11 +1218,10 @@ sind \autoref{sec:tocbasic.tocstyle}\important{\Package{tocbasic}} ab
\Macro{ProvideSectionCommands}\OParameter{Einstellungen}%
\Parameter{Namensliste}
\end{Declaration}
-Mit\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} diesen Anweisungen können gleich eine ganze Reihe von
-Gliederungsbefehlen definiert oder geändert werden. Dabei ist
-\PName{Namensliste} eine durch Komma separierte Liste von Namen der
-Gliederungsbefehle.
+Diese\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} Anweisungen können gleich eine ganze Reihe von
+Gliederungsbefehlen definieren oder ändern. Dabei ist \PName{Namensliste} eine
+durch Komma separierte Liste von Namen der Gliederungsbefehle.
Diese Anweisungen unterscheiden sich in zwei weiteren Punkten von den zuvor
erklärten Anweisungen zur Definition oder Änderung eines einzelnen
@@ -1198,15 +1231,15 @@ Gliederungsbefehls. Zum einen wird im Fehlerfall, also wenn eine Anweisung bei
vorgenommen. Ein entsprechender Fehler wird natürlich trotzdem gemeldet.
Zum anderen gibt es eine weitere Einstellung,
-\PValue{increaselevel}=\PValue{Ganzzahl}\important{\PValue{increaselevel}}.
+\important{\PValue{increaselevel}}\OptionVName{increaselevel}{Ganzzahl}.
Damit ändert sich die Bedeutung von \PValue{level} und \PValue{toclevel}
-(siehe \autoref{tab:maincls-experts.declaresection.keys}) dahingehend, dass
-deren Werte lediglich \PName{Einstellungen} des ersten Gliederungsbefehls aus
-der \PName{Namensliste} sind. Für alle weiteren Gliederungsbefehle werden die
+(siehe \autoref{tab:maincls-experts.declaresection.keys},
+\autopageref{tab:maincls-experts.declaresection.keys}) dahingehend, dass deren
+Werte lediglich als \PName{Einstellungen} des ersten Gliederungsbefehls aus
+der \PName{Namensliste} dienen. Für alle weiteren Gliederungsbefehle werden die
Werte von \PValue{level} und \PValue{toclevel} um den Wert von
\PValue{increaselevel} erhöht. Wurde die Einstellung \PValue{increaselevel}
-ohne Wertzuweisung verwendet, so wird der Wert 1 angenommen.
-%
+ohne Wertzuweisung verwendet, so wird der Wert 1 angenommen.%
\EndIndexGroup
@@ -1222,9 +1255,21 @@ ohne Wertzuweisung verwendet, so wird der Wert 1 angenommen.
Diese\important[i]{\DescRef{maincls.cmd.chapter}\\
\DescRef{maincls.cmd.part}\\
\DescRef{maincls.cmd.addchap}\\
- \Macro{addpart}} Anweisungen werden innerhalb der Definition der
-Überschriften \DescRef{maincls.cmd.chapter}\IndexCmd{chapter}, \DescRef{maincls.cmd.part},
-\DescRef{maincls.cmd.addchap}, \Macro{addpart} und deren Sternvarianten verwendet. Dabei ist
+ \DescRef{maincls.cmd.addpart}\\
+ \DescRef{maincls.cmd.chapter*}\\
+ \DescRef{maincls.cmd.part*}\\
+ \DescRef{maincls.cmd.addchap*}\\
+ \DescRef{maincls.cmd.addpart*}} Anweisungen werden innerhalb von
+Überschriften der zuvor erklärten Stile \PValue{chapter} und \PValue{part} und
+damit für die Definition der Überschriften
+\DescRef{maincls.cmd.chapter}\IndexCmd{chapter},
+\DescRef{maincls.cmd.part}\IndexCmd{part},
+\DescRef{maincls.cmd.addchap}\IndexCmd{addchap},
+\DescRef{maincls.cmd.addpart}\IndexCmd{addpart} und deren Sternvarianten
+\DescRef{maincls.cmd.chapter*}\IndexCmd{chapter*},
+\DescRef{maincls.cmd.part*}\IndexCmd{part*},
+\DescRef{maincls.cmd.addchap*}\IndexCmd{addchap*},
+\DescRef{maincls.cmd.addpart*}\IndexCmd{addpart*} verwendet. Dabei ist
\Macro{chapterheadstartvskip} eine Anweisung, die dafür vorgesehen ist, vor
der Kapitelüberschrift einen vertikalen Abstand einzufügen. Entsprechend ist
\Macro{chapterheadendvskip} eine Anweisung, die dafür vorgesehen ist, nach der
@@ -1232,54 +1277,52 @@ Kapitelüberschrift einen vertikalen Abstand
einzufügen. Bei\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}}
Kapitelüberschriften mit eigener Nummernzeile (siehe Option
\DescRef{maincls.option.chapterprefix} in \autoref{sec:maincls.structure},
-\DescPageRef{maincls.option.chapterprefix}) wird zwischen der
-Nummernzeile und der eigentlichen Überschrift außerdem
-\Macro{chapterheadmidvskip} ausgeführt.
+\DescPageRef{maincls.option.chapterprefix}) wird zwischen der Nummernzeile und
+der eigentlichen Überschrift außerdem \Macro{chapterheadmidvskip} ausgeführt.
Für das Einfügen der vertikalen Abstände über und unter Teile-Überschriften
sind die Anweisungen \Macro{partheadstartvskip} und \Macro{partheadendvskip}
vorgesehen. Dabei wird ein Seitenumbruch als Teil des vertikalen Abstandes
-interpretiert und ist bei \Class{scrbook}\OnlyAt{\Class{scrbook}\and
- \Class{scrreprt}} und \Class{scrreprt} in der Voreinstellung von
-\Macro{partheadendvskip} enthalten. Die Anweisung \Macro{partheadmidvskip} ist
-für den Abstand zwischen der Teile-Nummer und dem Text der Teile-Überschrift
-vorgesehen. Die Anweisung
+interpretiert. Ein solcher Seitenumbruch ist in der Voreinstellung sowohl bei
+\Class{scrbook}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} als auch
+\Class{scrreprt} in der Definition von \Macro{partheadendvskip} enthalten. Die
+Anweisung \Macro{partheadmidvskip} ist für den Abstand zwischen der
+Teile-Nummer und dem Text der Teile-Überschrift vorgesehen. Die Anweisung
\Macro{partheademptypage}\ChangedAt{v3.02}{\Class{scrbook}\and
\Class{scrreprt}} wird bei \Class{scrbook} und \Class{scrreprt}
gegebenenfalls für die leere Seite nach der Überschrift verwendet.
-Die Voreinstellungen für diese sieben Anweisungen sind seit
+Die Voreinstellungen der sieben Anweisungen sind seit
\KOMAScript~3.15\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} von der Einstellung von Option \DescRef{maincls.option.headings} (siehe
-\autoref{sec:maincls.structure}, \DescPageRef{maincls.option.headings})
-unabhängig. Die Original-Definitionen für die Kapitelüberschriften ab
+ \Class{scrartcl}} von der Einstellung von Option
+\DescRef{maincls.option.headings} (siehe \autoref{sec:maincls.structure},
+\DescPageRef{maincls.option.headings}) unabhängig. Die Original-Definitionen
+für die Kapitelüberschriften ab
\KOMAScript~3.17\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} entsprechen:\IndexLength{@tempskipa}
\begin{lstcode}
\newcommand*{\chapterheadstartvskip}{\vspace{\@tempskipa}}
- \newcommand*{\chapterheadmidvskip}{\par\nobreak\vskip\@tempskipa}
+ \newcommand*{\chapterheadmidvskip}{\par\nobreak
+ \vskip\@tempskipa}
\newcommand*{\chapterheadendvskip}{\vskip\@tempskipa}
\end{lstcode}
Diese werden auch bei jeder Verwendung von Option
\OptionValueRef{maincls}{headings}{big}\IndexOption{headings},
\OptionValueRef{maincls}{headings}{normal} oder
-\OptionValueRef{maincls}{headings}{small} reaktiviert.
+\OptionValueRef{maincls}{headings}{small} reaktiviert. Als Seiteneffekt haben
+diese Optionen also gegebenenfalls nicht nur Auswirkungen auf
+Kapitelüberschriften, sondern auf alle Überschriften im Stil \PValue{chapter}.
-Die Anweisung \DescRef{maincls.cmd.chapter} setzt die interne Länge
-\Length{@tempskipa} vor Aufruf von \Macro{chapterheadstartvskip} automatisch
-auf den Wert, der sich aus der
+Der Stil \PValue{chapter} setzt die interne Länge
+\Length{@tempskipa}\IndexLength{@tempskipa} vor Aufruf von
+\Macro{chapterheadstartvskip} automatisch auf den Wert, der sich aus der
\DescRef{\LabelBase.cmd.DeclareSectionCommand}-Einstellung%
-\IndexCmd{DeclareSectionCommand} \PValue{beforeskip} ergibt. Entsprechendes
-geschieht vor dem Aufruf von \Macro{chapterheadendvskip} mit dem Wert, der
-sich aus der \DescRef{\LabelBase.cmd.DeclareSectionCommand}-Einstellung
+\IndexCmd{DeclareSectionCommand} \PValue{beforeskip} ergibt. Vor dem Aufruf
+von \Macro{chapterheadendvskip} geschieht entsprechendes mit dem Wert, der
+sich aus der Einstellung
\PValue{afterskip} ergibt, und vor dem Aufruf von \Macro{chapterheadmidvskip}
-mit dem Wert, der sich aus
-\DescRef{\LabelBase.cmd.DeclareSectionCommand}-Einstellung \PValue{innerskip}
-ergibt. Werden \Macro{chapterheadstartvskip}, \Macro{chapterheadmidvskip} oder
-\Macro{chapterheadendvskip} umdefiniert und sollen die Abstände weiterhin
-beispielsweise mit \DescRef{\LabelBase.cmd.RedeclareSectionCommand}
-konfigurierbar sein, so sollte man in der neuen Definition ebenfalls
-\Length{@tempskipa} verwenden.
+mit dem Wert, der sich aus der Einstellung \PValue{innerskip}
+ergibt.
Da die Voreinstellungen für die Abstände von \DescRef{maincls.cmd.part} nicht
von Option \DescRef{maincls.option.headings} abhängen, werden auch die
@@ -1311,20 +1354,25 @@ und bei \Class{scrartcl}:
\vskip\@tempskipa
}
\end{lstcode}
-Auch hier wird \Length{@tempskipa}\IndexLength{@tempskipa} vor der Verwendung
-der Befehle innerhalb von \DescRef{maincls.cmd.part} entsprechend der
-Einstellungen von
+Auch hier wird vom Stil \PValue{part} die interne Länge
+\Length{@tempskipa}\IndexLength{@tempskipa}\IndexLength{@tempskipa} vor der
+Verwendung der Befehle entsprechend der Einstellungen von
\DescRef{\LabelBase.cmd.DeclareSectionCommand}\IndexCmd{DeclareSectionCommand}
gesetzt.
-Da\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}
-die Abstände über, innerhalb und unter den Überschriften wesentlich einfacher
-mit \DescRef{\LabelBase.cmd.RedeclareSectionCommand} eingestellt werden
-können, wird nicht empfohlen zu diesem Zweck stattdessen die hier
+Wird eine der Anweisungen, die im Original \Length{@tempskipa} für den
+vertikalen Abstand verwendet, umdefiniert und sollen die Abstände weiterhin
+beispielsweise mit \DescRef{\LabelBase.cmd.RedeclareSectionCommand}
+konfigurierbar sein, so sollte man in der neuen Definition ebenfalls
+\Length{@tempskipa} verwenden. Da\ChangedAt{v3.17}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}} die Abstände über, innerhalb und
+unter den Überschriften einfacher mit
+\DescRef{\LabelBase.cmd.RedeclareSectionCommand} eingestellt werden können,
+wird generell nicht empfohlen, zu diesem Zweck stattdessen die hier
beschriebenen Anweisungen umzudefinieren. Sie sollten für tiefgreifendere
Änderungen reserviert bleiben, die nicht über
\DescRef{\LabelBase.cmd.RedeclareSectionCommand} zu erreichen sind.
-Auf\textnote{Beispiel!} \cite{homepage} findet sich dazu es ein Beispiel, bei
+Auf\textnote{Beispiel!} \cite{homepage} findet sich dazu ein Beispiel, bei
dem durch Umdefinierung von \Macro{chapterheadstartvskip} und
\Macro{chapterheadendvskip} Linien über und unter der Kapitelüberschrift
gesetzt werden.%
@@ -1333,21 +1381,112 @@ gesetzt werden.%
\begin{Declaration}
+ \Macro{partlineswithprefixformat}%
+ \Parameter{Ebene}\Parameter{Nummer}\Parameter{Text}
+\end{Declaration}
+Diese\ChangedAt{v3.25}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} Anweisung wird von Überschriften des Stils
+\PValue{part}\textnote{Gliederungsstil
+ \PValue{part}}\Index{Gliederung>Stil>~\PValue{part}} verwendet. Die beiden
+Argumente \PName{Nummer} und \PName{Text} sind dabei einschließlich
+Einstellung der Fonts für sich bereits fertig formatiert. Letztlich regelt die
+Anweisung also die Anordnung der beiden Teile der Überschrift. Bei nicht
+nummerierten Überschriften ist \PName{Nummer} ein komplett leeres Argument,
+enthält also auch keine Formatierungsanweisungen.
+
+Vordefiniert ist die Anweisung mit:
+\begin{lstcode}
+ \newcommand{\partlineswithprefixformat}[3]{%
+ #2#3%
+ }
+\end{lstcode}
+bisher eher spartanisch.
+
+\begin{Example}
+ Sie wollen die Teile-Überschriften in eine hellblaue Box mit blauer
+ Umrandung stellen, die nur etwa drei Viertel der Breite des Textbereichs
+ einnimmt. Hierzu verwenden Sie
+\begin{lstcode}[moretexcs={fcolorbox}]
+ \documentclass{scrbook}
+ \usepackage{xcolor}
+ \renewcommand*{\partlineswithprefixformat}[3]{%
+ \fcolorbox{blue}{blue!25}{%
+ \parbox{.75\linewidth}{#2#3}%
+ }%
+ }
+ \begin{document}
+ \part{Umrahmte Teile}
+ \end{document}
+\end{lstcode}
+ Allerdings fällt Ihnen auf, dass die Überschrift dabei nicht wie sonst
+ für Teile üblich zentriert wird -- weder die Box selbst noch der Text
+ innerhalb der Box.
+
+ Die Ursache für die fehlende Zentrierung der Box liegt
+ darin, dass aufgrund der Änderung das in Argument 3 versteckte Absatzende
+ nur noch den Absatz innerhalb der Box beendet, aber nicht mehr den Absatz mit
+ der \Macro{parbox}. Also ergänzen Sie ein \Macro{par} am Ende der Definition.
+
+ Die Ursache der fehlenden Zentrierung innerhalb der Box ist, dass in der
+ \Macro{parbox}-Anweisung die Ausrichtung von
+ \DescRef{maincls.cmd.raggedpart} nicht automatisch gültig ist. Daher
+ ergänzen Sie diese Anweisung innerhalb der Box.
+
+ Mit
+\begin{lstcode}[moretexcs={fcolorbox}]
+ \documentclass{scrbook}
+ \usepackage{xcolor}
+ \renewcommand*{\partlineswithprefixformat}[3]{%
+ \fcolorbox{blue}{blue!25}{%
+ \parbox{.75\linewidth}{\raggedpart #2#3}%
+ }%
+ \par
+ }
+ \begin{document}
+ \part{Umrahmte Teile}
+ \end{document}
+\end{lstcode}
+ erhalten Sie die gewünschte Formatierung.
+\end{Example}
+
+Wie im Beispiel gezeigt, ist der Anwender bei der Umdefinierung der Anweisung
+für einige Dinge selbst verantwortlich. Dazu gehört neben dem Erhalt der
+voreingestellten Ausrichtung auch, dass innerhalb der Überschrift kein
+Seitenumbruch, beispielsweise an zusätzlich eingefügten Absätzen oder
+Abständen, erfolgen kann. Das gezeigte Beispiel ist diesbezüglich
+unproblematisch. Nicht nur, dass die beiden Boxen ohnehin keinen Seitenumbruch
+erlauben. \KOMAScript{} verändert außerdem \Macro{interlinepenalty} als Teil
+von \PName{Text} so, dass darin kein Seitenumbruch stattfinden
+darf. Gleichzeitig endet \PName{Text} immer mit einem internen Absatz,
+\Macro{@@par}.
+
+Das Argument \PName{Ebene} wird von
+\Macro{partlineswithprefixformat} in der Voreinstellung nicht verwendet und
+ist auch im Beispiel nicht erforderlich. Erst wenn der Anwender mehrere
+Anweisungen im Stil \PValue{part} definiert und man innerhalb der Definition
+nach den Anweisungen unterscheiden will, kann dies über \PName{Ebene}
+erfolgen. Dabei ist \PName{Ebene} der vom Namen der Anweisung abgeleitete Name
+der Gliederungsebene. Bei \DescRef{maincls.cmd.part},
+\DescRef{maincls.cmd.part*}, \DescRef{maincls.cmd.addpart} und
+\DescRef{maincls.cmd.addpart*} ist \PName{Ebene} daher einheitlich
+\PValue{part}.%
+\EndIndexGroup
+
+\begin{Declaration}
\Macro{chapterlineswithprefixformat}%
\Parameter{Ebene}\Parameter{Nummer}\Parameter{Text}
\Macro{chapterlinesformat}%
\Parameter{Ebene}\Parameter{Nummer}\Parameter{Text}
\end{Declaration}
-Diese\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}} beiden
-Anweisungen werden von Überschriften des Stils
-\PValue{chapter}\textnote{Gliederungsstil
+Diese\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}} Anweisungen
+werden von Überschriften des Stils \PValue{chapter}\textnote{Gliederungsstil
\PValue{chapter}}\Index{Gliederung>Stil>~\PValue{chapter}} in Abhängigkeit
von Option \DescRef{maincls.option.chapterprefix}\IndexOption{chapterprefix}%
-\textnote{\DescRef{maincls.option.chapterprefix}} (siehe \autoref{sec:maincls.structure},
-\DescPageRef{maincls.option.chapterprefix}) verwendet. Dabei gibt
-\Macro{chapterlineswithprefixformat} die Ausgabe bei aktivierter Option vor,
-während \Macro{chapterlinesformat} die Ausgabe bei deaktivierter Option
-bestimmt.
+\textnote{\DescRef{maincls.option.chapterprefix}} (siehe
+\autoref{sec:maincls.structure}, \DescPageRef{maincls.option.chapterprefix})
+verwendet. Dabei gibt \Macro{chapterlineswithprefixformat} die Ausgabe bei
+aktivierter Option vor. Bei deaktivierter Option
+bestimmt dagegen \Macro{chapterlinesformat} die Ausgabe.
Die beiden Argumente \PName{Nummer} und \PName{Text} sind dabei
einschließlich Einstellung der Fonts für sich bereits fertig
@@ -1356,8 +1495,9 @@ Teile der Überschrift. Bei nicht nummerierten Überschriften ist \PName{Nummer}
ein komplett leeres Argument, enthält also auch keine
Formatierungsanweisungen.
-Vordefiniert sind die beiden Anweisungen mit:
-\begin{lstcode}
+Vordefiniert\textnote{Voreinstellung} sind die beiden Anweisungen mit:
+% Umbruchkorrektur bei Aufeinanderfolgen von Code und Beispiel
+\begin{lstcode}[belowskip=-1\dp\strutbox plus \dp\strutbox]
\newcommand{\chapterlinesformat}[3]{%
\@hangfrom{#2}{#3}%
}
@@ -1365,17 +1505,18 @@ Vordefiniert sind die beiden Anweisungen mit:
#2#3%
}
\end{lstcode}
-bisher eher spartanisch.
+%bisher eher spartanisch.
\begin{Example}
Sie wollen Überschriften im Kapitelstil gelb hinterlegen. Für
Überschriften ohne Präfixzeile definieren Sie daher in der Präambel des
Dokument:
-\begin{lstcode}
+\begin{lstcode}[moretexcs={colorbox}]
\makeatletter
\renewcommand{\chapterlinesformat}[3]{%
\colorbox{yellow}{%
- \parbox{\dimexpr\linewidth-2\fboxrule-2\fboxsep}{%
+ \parbox{\dimexpr\linewidth
+ -2\fboxrule-2\fboxsep}{%
\@hangfrom{#2}#3%
}%
}%
@@ -1383,16 +1524,17 @@ bisher eher spartanisch.
\makeatother
\end{lstcode}
und für Überschriften mit Präfixzeile:
-\begin{lstcode}
+\begin{lstcode}[moretexcs={colorbox}]
\renewcommand{\chapterlineswithprefixformat}[3]{%
\colorbox{yellow}{%
- \parbox{\dimexpr\linewidth-2\fboxrule-2\fboxsep}{%
+ \parbox{\dimexpr\linewidth
+ -2\fboxrule-2\fboxsep}{%
#2#3%
}%
}%
}
\end{lstcode}
- Allerdings fällt Ihnen nach einiger Zeit auf, dass mit dieser Umdefinierung
+ Allerdings fällt Ihnen nach einiger Zeit auf, dass mit dieser Umdefinierung
die Überschriften wieder im Blocksatz gesetzt werden. Das liegt daran, dass
\Macro{parbox} sein Argument so setzt. Um dies zu korrigieren, fügen Sie die
Anweisung \DescRef{maincls.cmd.raggedchapter} (siehe
@@ -1400,11 +1542,12 @@ bisher eher spartanisch.
die automatisch bereits vor \Macro{chapterlinesformat} und
\Macro{chapterlineswithprefixformat} aufgerufen wird, in die Definitionen
ein:
-\begin{lstcode}
+\begin{lstcode}[moretexcs={colorbox}]
\makeatletter
\renewcommand{\chapterlinesformat}[3]{%
\colorbox{yellow}{%
- \parbox{\dimexpr\linewidth-2\fboxrule-2\fboxsep}{%
+ \parbox{\dimexpr\linewidth
+ -2\fboxrule-2\fboxsep}{%
\raggedchapter
\@hangfrom{#2}#3%
}%
@@ -1413,41 +1556,43 @@ bisher eher spartanisch.
\makeatother
\renewcommand{\chapterlineswithprefixformat}[3]{%
\colorbox{yellow}{%
- \parbox{\dimexpr\linewidth-2\fboxrule-2\fboxsep}{%
+ \parbox{\dimexpr\linewidth
+ -2\fboxrule-2\fboxsep}{%
\raggedchapter
#2#3%
}%
}%
}
\end{lstcode}
- Es sei daran erinnert, dass \Macro{makeatletter} und \Macro{makeatother} nur
- in der Dokumentpräambel zu verwenden sind. In einer eigenen Wrapper-Klasse
- oder einem Paket haben sie zu entfallen. Sie werden auch nur wegen
- \Macro{@hangfrom} in der Definition von \Macro{chapterlinesformat} benötigt.
+ Es sei daran erinnert, dass die Klammerung mit den Anweisungen
+ \Macro{makeatletter} und \Macro{makeatother} nur in der Dokumentpräambel zu
+ verwenden ist. In einer eigenen Wrapper-Klasse oder einem Paket haben sie zu
+ entfallen. Sie werden auch nur wegen \Macro{@hangfrom} in der Definition von
+ \Macro{chapterlinesformat} benötigt.%
\end{Example}
Wie im Beispiel gezeigt, ist der Anwender bei der Umdefinierung der
Anweisungen für einige Dinge selbst verantwortlich. Dazu gehört neben dem
Erhalt der voreingestellten Ausrichtung auch, dass innerhalb der Überschrift
-kein Seitenumbruch beispielsweise an zusätzlich eingefügten Absätzen oder
-Abständen erfolgen kann. Das gezeigte Beispiel ist diesbezüglich
+kein Seitenumbruch, beispielsweise an zusätzlich eingefügten Absätzen oder
+Abständen, erfolgen kann. Das gezeigte Beispiel ist diesbezüglich
unproblematisch. Nicht nur, dass die beiden Boxen ohnehin keinen Seitenumbruch
erlauben. \KOMAScript{} verändert außerdem \Macro{interlinepenalty} als Teil
von \PName{Text} so, dass darin kein Seitenumbruch stattfinden
darf. Gleichzeitig endet \PName{Text} immer mit einem internen Absatz,
-\Macro{@par}.
+\Macro{@@par}.
Die Anweisung \DescRef{maincls.cmd.raggedchapter} ist übrigens nicht
Bestandteil von \PName{Text}, weil anderenfalls beispielsweise die Verwendung
-von \Macro{MakeUppercase} innerhalb der Umdefinierung von
-\Macro{chapterlinesformat} oder \Macro{chapterlineswithprefixformat} erheblich
-erschwert wäre. Dennoch sei darauf hingewiesen, dass typografischen Regeln
-zufolge Versalsatz mit gängigen Fonts immer der Sperrung und des Ausgleichs
-bedarf. Die \LaTeX-Anweisung \Macro{MakeUppercase} leistet dies jedoch nicht.
+von \Macro{MakeUppercase} innerhalb der Umdefinierung der beiden Anweisungen
+erheblich erschwert wäre. Dennoch sei darauf hingewiesen, dass typografischen
+Regeln zufolge Versalsatz mit gängigen Fonts immer der Sperrung und des
+Ausgleichs bedarf. Die \LaTeX-Anweisung \Macro{MakeUppercase} leistet dies
+jedoch nicht.
Das erste Argument, \PName{Ebene}, wird von den Anweisungen in der
Voreinstellung nicht verwendet und ist auch im Beispiel nicht
-erforderlich. Erst, wenn der Anwender mehrere Anweisungen im Stil
+erforderlich. Erst wenn der Anwender mehrere Anweisungen im Stil
\PValue{chapter} definiert und man innerhalb der Definition nach den
Anweisungen unterscheiden will, kann dies über \PName{Ebene} erfolgen. Dabei
ist \PName{Ebene} der vom Namen der Anweisung abgeleitete Name der
@@ -1465,7 +1610,7 @@ Gliederungsebene. Bei \DescRef{maincls.cmd.chapter},
\Parameter{Ebene}\Parameter{Einzug}\Parameter{Nummer}\Parameter{Text}
\end{Declaration}
Diese\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} beiden Anweisungen werden von Überschriften des Stils
+ \Class{scrartcl}} Anweisungen werden von Überschriften des Stils
\PValue{section}\textnote{Gliederungsstil
\PValue{section}}\Index{Gliederung>Stil>~\PValue{section}} in Abhängigkeit
davon verwendet, ob die jeweilige Überschrift eine Spitzmarke erzeugt oder
@@ -1495,23 +1640,23 @@ Vordefiniert sind die beiden Anweisungen als:
\end{lstcode}
Bei Umdefinierung einer der beiden Anweisungen ist wiederum der Anwender
-selbst dafür verantwortlich Seitenumbrüche innerhalb der Ausgabe zu
-verhindern. \KOMAScript{} selbst setzt lediglich \Macro{interlinepenalty}
-entsprechend.
+selbst dafür verantwortlich, Seitenumbrüche innerhalb der Ausgabe zu
+verhindern. \KOMAScript{} hilft hier lediglich mit entsprechend gesetztem
+\Macro{interlinepenalty}.
\begin{Example}
Wie schon im Beispiel der Kapitelüberschriften sollen nun die frei stehenden
Überschriften der Ebenen \PValue{section} mit einer Farbe hinterlegt
werden. Die frei stehenden Überschriften tieferer Ebenen sollen nicht
verändert werden:
-\begin{lstcode}
+\begin{lstcode}[moretexcs={colorbox}]
\makeatletter
\renewcommand{\sectionlinesformat}[4]{%
- \@tempswafalse
\ifstr{#1}{section}{%
\hspace*{#2}%
\colorbox{yellow}{%
- \parbox{\dimexpr\linewidth-2\fboxrule-2\fboxsep-#2}{%
+ \parbox{\dimexpr\linewidth
+ -2\fboxrule-2\fboxsep-#2}{%
\raggedsection
\@hangfrom{#3}{#4}%
}%
@@ -1526,13 +1671,19 @@ entsprechend.
Bereich des Einzugs nicht mit gefärbt. Wird hingegen die Überschrift in den
linken Rand gestellt, so wird dieser Bereich des Randes ebenfalls farbig
hinterlegt. Durch Verschiebung der \Macro{hspace*}-Anweisung in die
- \Macro{colorbox} kann dieses Verhalten verändert werden.
-
+ \Macro{colorbox} kann dieses Verhalten verändert werden.%
+ \iffalse Umbruchkorrekturtext
+
Erneut sei daran erinnert, dass \Macro{makeatletter} und \Macro{makeatother}
nur in der Dokumentpräambel zu verwenden sind. In einer eigenen
Wrapper-Klasse oder einem Paket haben sie zu entfallen. Sie werden auch nur
wegen \Macro{@hangfrom} in der Definition von \Macro{sectionlinesformat}
- benötigt.
+ benötigt.%
+ \else%
+
+ \Macro{makeatletter} und \Macro{makeatother} werden in der Dokumentpräambel
+ erneut wegen \Macro{@hangfrom} benötigt.%
+ \fi%
\end{Example}
Das erste Argument, \PName{Ebene}, wird von den Anweisungen in der
@@ -1545,13 +1696,13 @@ Stil \PValue{section} zu unterscheiden.%
\begin{Declaration}
\Macro{SecDef}\Parameter{Sternanweisung}\Parameter{Normalanweisung}
\Macro{scr@startsection}\Parameter{Name}\Parameter{Ebene}%
- \Parameter{Einzug}\Parameter{Abstand davor}\Parameter{Abstand danach}
+ \Parameter{Einzug}\Parameter{Abstand~davor}\Parameter{Abstand~danach}
\Parameter{Stilanweisungen}%
\OParameter{Kurzform}\Parameter{Überschrift}
\labelsuffix[*]%
\Macro{scr@startsection}\Parameter{Name}\Parameter{Ebene}%
- \Parameter{Einzug}\Parameter{Abstand davor}
- \Parameter{Abstand danach}
+ \Parameter{Einzug}\Parameter{Abstand~davor}
+ \Parameter{Abstand~danach}
\Parameter{Stilanweisungen}%
\nobreak\texttt{*}\Parameter{Überschrift}
\labelsuffix
@@ -1564,7 +1715,7 @@ Wie\ChangedAt[2014/09]{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
Beschreibung zu den Gliederungsbefehlen ab
\DescPageRef{maincls.cmd.chapter} erklärt, verfügt \KOMAScript{}
bezüglich des optionalen Arguments der Gliederungsbefehle über erweiterte
-Möglichkeiten. Um dies möglich zu machen, war es notwendig, einige Anweisungen
+Möglichkeiten. Um dies zu erreichen, war es notwendig, einige Anweisungen
des \LaTeX-Kerns zu ersetzen. Dazu gehören auch die Anweisungen
\Macro{secdef}\IndexCmd{secdef}\important{\Macro{secdef}} und
\Macro{@startsection}\IndexCmd{@startsection}%
@@ -1575,7 +1726,7 @@ entnehmen.
Da diese Anweisungen jedoch auch häufig von Paketen komplett neu definiert
werden und dadurch die Funktion von \KOMAScript{} teilweise stark
beeinträchtigt werden kann, wurden die genannten \LaTeX-Kern-Anweisungen nicht
-einfach nur umdefiniert, sondern es wurden zusätzliche die alternativen
+einfach nur umdefiniert, sondern es wurden zusätzlich die alternativen
Anweisungen \Macro{SecDef} und \Macro{scr@startsection} definiert. Diese
können von Paketautoren genau wie die \LaTeX-Kern-Anweisungen verwendet
werden, bieten dann aber automatisch die erweiterte Funktionalität von
@@ -1584,36 +1735,45 @@ da sie sich jederzeit ändern können und dann die Funktionalität von
\KOMAScript{} durch diese Umdefinierung erneut beeinträchtigt werden
könnte.
-\KOMAScript{} selbst verwendet intern \Macro{SecDef} und
-\Macro{scr@startsection} an Stelle von \Macro{secdef} und
-\Macro{@startsection} beispielsweise bei den Gliederungsbefehlen, die mit
-\DescRef{\LabelBase.cmd.DeclareSectionCommand} definiert werden. Eine
-nachträgliche Umdefinierung von \Macro{secdef} und \Macro{@startsection} hat
-daher keine Auswirkungen auf diese Gliederungsbefehle.
+\KOMAScript{} selbst verwendet intern die Anweisungen
+\Macro{SecDef}\important{\Macro{SecDef}\\\Macro{scr@startsection}} und
+\Macro{scr@startsection} anstelle von \Macro{secdef} und \Macro{@startsection}
+beispielsweise bei den mit \DescRef{\LabelBase.cmd.DeclareSectionCommand}
+definierten Gliederungsbefehlen. Eine nachträgliche Umdefinierung von
+\Macro{secdef} und \Macro{@startsection} hat daher keine Auswirkungen auf
+diese Gliederungsbefehle.
Als Ersatz für die Umdefinierung der Anweisungen bietet \KOMAScript{} die
Möglichkeit, zusätzlichen \PName{Code} in die Ausführung der
\KOMAScript-eigenen Erweiterungen einzufügen. Der \PName{Code} aller Aufrufe
-der Anweisungen \Macro{At@startsection}, \Macro{Before@sect} und
+der Anweisungen \Macro{At@startsection}\important{\Macro{At@startsection}\\
+ \Macro{Before@sect}\\
+ \Macro{Before@@sect}}, \Macro{Before@sect} und
\Macro{Before@@sect} wird für die einzelnen Anweisungen getrennt aufgesammelt.
Es ist nicht vorgesehen, einmal eingefügten Code wieder zu entfernen.
-Der \PName{Code} von \Macro{At@startsection} wird dabei in
-\Macro{scr@startsection} unmittelbar nach der Auswertung von Parameter
-\PName{Abstand davor} und der zugehörigen Berechnung des resultierenden
-\Length{@tempskipa} aber noch vor Einfügen des Abstandes angewendet. Es ist
-damit also noch möglich, diesen Abstand über \Length{@tempskipa} zu verändern.
-
-Der \PName{Code} von \Macro{Before@sect} beziehungsweise
-\Macro{Before@ssect} wird unmittelbar vor dem Aufruf von \Macro{@sect}
-beziehungsweise \Macro{@ssect} innerhalb von \Macro{scr@startsection}
-ausgeführt. Zu diesem Zeitpunkt ist gegebenenfalls der vertikale Abstand vor
-der Überschrift bereits über \Macro{addvspace} eingefügt.
-
-Die Anweisungen \Macro{At@startsection}, \Macro{Before@sect},
-\Macro{Before@ssect} sind als Anweisungen für Paketautoren entworfen und für
-diese zur Verwendung freigegeben.%
-%
+Der \PName{Code} von Makro
+\Macro{At@startsection}\important{\Macro{At@startsection}\\
+ \Macro{scr@startsection}} wird dabei in Anweisung \Macro{scr@startsection}
+unmittelbar nach der Auswertung von Parameter \PName{Abstand davor} und der
+zugehörigen Berechnung des resultierenden \Length{@tempskipa} aber noch vor
+Einfügen des Abstandes angewendet. Es ist damit also noch möglich, diesen
+Abstand über \Length{@tempskipa} zu verändern.
+
+Der \PName{Code} von \Macro{Before@sect}\important{\Macro{Before@sect}\\
+ \Macro{@sect}} beziehungsweise
+\Macro{Before@ssect}\important{\Macro{Before@ssect}\\
+ \Macro{@ssect}} wird unmittelbar vor dem Aufruf von \Macro{@sect} respektive
+\Macro{@ssect} innerhalb von
+\Macro{scr@startsection}\important{\Macro{scr@startsection}} ausgeführt. Zu
+diesem Zeitpunkt ist gegebenenfalls der vertikale Abstand vor der Überschrift
+bereits über \Macro{addvspace} eingefügt.
+
+Die drei Anweisungen \Macro{At@startsection}\important{\Macro{At@startsection}\\
+ \Macro{Before@sect}\\
+ \Macro{Before@ssect}}, \Macro{Before@sect} und \Macro{Before@ssect} sind als
+Schnittstelle für Paketautoren entworfen und für diese zur Verwendung
+freigegeben.%
\EndIndexGroup
% \subsection{Anhang}
@@ -1625,18 +1785,18 @@ diese zur Verwendung freigegeben.%
Bei den {\KOMAScript}-Klassen gibt es innerhalb der Anweisung
\DescRef{maincls.cmd.appendix}%
\IndexCmd{appendix}\important{\DescRef{maincls.cmd.appendix}} eine
-Besonderheit. Ist nämlich \Macro{appendixmore} definiert, so wird diese
-Anweisung von \DescRef{maincls.cmd.appendix} ebenfalls ausgeführt. Intern wird
-dies von den {\KOMAScript}-Klassen \Class{scrbook}\OnlyAt{\Class{scrbook}\and
+Besonderheit. Ist \Macro{appendixmore} definiert, so wird diese Anweisung von
+\DescRef{maincls.cmd.appendix} ebenfalls ausgeführt. Intern wird das von den
+{\KOMAScript}-Klassen \Class{scrbook}\OnlyAt{\Class{scrbook}\and
\Class{scrreprt}} und \Class{scrreprt} für die Realisierung der Layoutoption
\DescRef{maincls.option.appendixprefix} genutzt (siehe
\autoref{sec:maincls.structure},
\DescPageRef{maincls.option.appendixprefix}). Dies\textnote{Achtung!} sollten
Sie unbedingt beachten, falls Sie selbst das Makro \Macro{appendixmore}
-definieren oder umdefinieren wollen. Ist diese Option verwendet, so erhalten
-Sie bei \verb|\newcommand{\appendixmore}{|\dots\verb|}| eine Fehlermeldung.
-Dadurch soll verhindert werden, dass Sie die Optionen außer Kraft setzen, ohne
-es zu merken.
+definieren oder umdefinieren wollen. Ist diese Option bereits verwendet, so
+erhalten Sie bei \verb|\newcommand{\appendixmore}{|\dots\verb|}| eine
+Fehlermeldung. Dadurch wird verhindert, dass Sie die Optionen außer
+Kraft setzen, ohne es zu merken.
\begin{Example}
Sie wollen nicht, dass bei Verwendung der Klasse \Class{scrbook} oder
@@ -1657,16 +1817,16 @@ es zu merken.
\renewcommand*{\chaptermarkformat}{%
\appendixname~\thechapter\autodot\enskip}}
\end{lstcode}
- Sollten Sie später dann doch noch entscheiden, dass Sie die Option
- \DescRef{maincls.option.appendixprefix} verwenden wollen, so erhalten Sie
- aufgrund der dann bereits definierten Anweisung \Macro{appendixmore} eine
- Fehlermeldung. Damit wird verhindert, dass obige Definition
- unbemerkt die Einstellungen überschreibt, die Sie per Option
- getroffen haben.
+ Sollten Sie doch noch entscheiden, dass Sie die Option
+ \DescRef{maincls.option.appendixprefix} bei
+ \DescRef{maincls.cmd.documentclass} setzen wollen, so erhalten Sie aufgrund
+ der dann bereits definierten Anweisung \Macro{appendixmore} eine
+ Fehlermeldung. Damit wird verhindert, dass obige Definition unbemerkt die
+ Einstellungen überschreibt, die Sie per Option getroffen haben.
Wenn Sie ein vergleichbares Verhalten des Anhangs für die Klasse
\Class{scrartcl} erreichen wollen, so ist dies ebenfalls möglich. Schreiben
- Sie dazu beispielsweise folgendes in die Präambel Ihres Dokuments:
+ Sie dazu beispielsweise Folgendes in die Präambel Ihres Dokuments:
\begin{lstcode}[moretexcs={ifthenelse,equal}]
\newcommand*{\appendixmore}{%
\renewcommand*{\sectionformat}{%
@@ -1697,13 +1857,14 @@ es zu merken.
Schon die Standardklassen\textnote{Standardklassen} kennen zur Unterteilung
der Einträge in das Literaturverzeichnis die Anweisung \Macro{newblock}. Was
diese Anweisung genau macht, hängt dabei von den Klassenoptionen ab. Wird die
-Option \Option{openbib}\important{\Option{openbib}} verwendet, so werden am Ende
-der Standardklasse die Anweisungen \Macro{@openbib@code} und \Macro{newblock}
-selbst umdefiniert. Von den Standardklassen wird die Anweisung
-\Macro{@openbib@code} beim Start der Liste für das Literaturverzeichnis --
-genauer: bei der Festlegung der Parameter für diese Liste -- ausgeführt. Es
-darf davon ausgegangen werden, dass auch viele Pakete, die das
-Literaturverzeichnis umdefinieren, diese Anweisung entsprechend abarbeiten.
+Option \Option{openbib}\important{\Option{openbib}} verwendet, so werden am
+Ende der Standardklasse die Anweisungen \Macro{@openbib@code} und
+\Macro{newblock} selbst umdefiniert. Von den Standardklassen wird die
+Anweisung \Macro{@openbib@code} beim Start der Liste für das
+Literaturverzeichnis --~genauer: bei der Festlegung der Parameter für diese
+Liste~-- ausgeführt. Es darf davon ausgegangen werden, dass auch viele Pakete,
+die das Literaturverzeichnis umdefinieren, diese Anweisung entsprechend
+abarbeiten.
Bei den \KOMAScript-Klassen\textnote{\KOMAScript} geschieht etwas
ähnliches. Allerdings wird \Macro{@openbib@code} nicht am Ende der Klasse
@@ -1713,7 +1874,7 @@ umdefiniert. Stattdessen wird mit \Macro{newbibstyle} der Stil
beinhalten die gewünschten Umdefinierung von \Macro{@openbib@code} und von
\Macro{newblock}. Wird nun mit Hilfe der Option
\OptionValueRef{maincls}{bibliography}{openstyle}%
-\IndexOption{bibliography~=\PValue{openstyle}}%
+\IndexOption{bibliography~=\textKValue{openstyle}}%
\important{\OptionValueRef{maincls}{bibliography}{openstyle}} dieser
Literaturverzeichnisstil gewählt, so werden die \PName{Anweisungen}
unmittelbar ausgeführt, also \Macro{@openbib@code} und \Macro{newblock}
@@ -1729,7 +1890,7 @@ ausgeführt. Im Falle eines mit \DescRef{maincls.cmd.BreakBibliography} (siehe
\autoref{sec:maincls.bibliography},
\DescPageRef{maincls.cmd.BreakBibliography}) unterbrochenen
Literaturverzeichnisses werden diese Anweisungen außerdem am Anfang und Ende
-jedes Teil, also unmittelbar vor und nach
+jedes Teils, also unmittelbar vor und nach
\DescRef{maincls.cmd.BreakBibliography} ausgeführt.
Die Anweisungen \Macro{newblock}, \Macro{@openbib@code},
@@ -1741,7 +1902,7 @@ Definition des neuen Stils angegeben wurden. Daraus ergibt sich auch, dass
jede der vier Anweisungen innerhalb von \PName{Anweisung} bei Bedarf
keinesfalls mit \Macro{newcommand}, sondern mit
\Macro{renewcommand}\IndexCmd{renewcommand}\important{\Macro{renewcommand}}
-definiert werden sollten.
+definiert werden sollte.
Setzt der Anwender mit den Anweisungen
\DescRef{maincls.cmd.AtEndBibliography}%\important[i]{\DescRef{maincls.cmd.AtEndBibliography}\\
@@ -1771,13 +1932,18 @@ Möglichkeiten der Vererbung verwenden und bei der Definition einen Elternstil
mit angeben:
% Umbruchkorrektur: listings korrigiert
\begin{lstcode}
- \newbibstyle{twocolumopenstyle}[openstyle]{%
+ \newbibstyle[openstyle]{twocolumopenstyle}{%
\renewcommand*{\bib@beginhook}{\begin{multicols}{2}}%
\renewcommand*{\bib@endhook}{\end{multicols}}}%
\end{lstcode}
Die Auswahl eines dieser neuen Stile erfolgt dann einfach wieder über die
Option \DescRef{maincls.option.bibliography}.
-%
+
+Wie\textnote{Achtung!} schon \DescRef{maincls.cmd.BreakBibliography} verlieren
+auch diese Anweisungen ganz oder teilweise ihre Wirkung, wenn
+\Environment{thebibliography} beispielsweise durch Verwendung von
+\Package{biblatex}\IndexPackage{biblatex}\important{\Package{biblatex}}
+umdefiniert wird.%
\EndIndexGroup
@@ -1810,4 +1976,4 @@ Option \DescRef{maincls.option.bibliography}.
% LocalWords: Kapitelüberschriften Gliederungsebenen Verzeichniseinträge
% LocalWords: Verzeichniseintragsstile Gliederungsbefehl Verzeichniseintrag
% LocalWords: Verzeichniseintrags Verzeichniseintragsstilen Gliederungsstil
-% LocalWords: Gliederungsebene
+% LocalWords: Gliederungsebene Eintragsebenen Absatzeinzug Dokumentpräambel
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex
index d4669fe403a..c008d6fa3a7 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrbookreportarticle.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrbookreportarticle.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ============================================================================
\KOMAProvidesFile{scrbookreportarticle.tex}
- [$Date: 2017-05-31 11:06:42 +0200 (Wed, 31 May 2017) $
+ [$Date: 2018-02-06 09:33:25 +0100 (Tue, 06 Feb 2018) $
KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl)]
\chapter{Die Hauptklassen \Class{scrbook}, \Class{scrreprt}, \Class{scrartcl}}
@@ -68,7 +68,7 @@ Der Briefklasse in {\KOMAScript} ist jedoch ein eigenes Kapitel gewidmet, da
sie sich von den drei Hauptklassen grundsätzlich unterscheidet (siehe
\autoref{cha:scrlttr2}).
-Die einfachste Möglichkeit, an Stelle einer Standardklasse eine
+Die einfachste Möglichkeit, anstelle einer Standardklasse eine
\KOMAScript-Klasse zu verwenden, ist das Ersetzen des Klassennamens in der
Anweisung \verb|\documentclass| entsprechend
\autoref{tab:maincls.overview}. Man tauscht
@@ -143,7 +143,7 @@ Tabellen.
abweicht, damit dieses Ziel nicht mehr erreicht werden kann. Es ist dann
notwendig, dass man zumindest einige der vertikalen Abstände etwas dehnt
oder staucht, um das Ziel wieder zu erreichen. \TeX{} kennt zu diesem Zweck
- dehn- und stauchbare Abstände und \LaTeX{} bietet dann die Möglichkeit,
+ dehn- und stauchbare Abstände und \LaTeX{} bietet die Möglichkeit,
diesen \emph{vertikalen Ausgleich}\Index{Ausgleich} automatisch
durchzuführen.
\end{Explain}
@@ -217,13 +217,17 @@ Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch},
\KOMAScript{} \PValue{false}.
Bei Büchern wird in der Regel eine andere Art der Zusammenfassung
-verwendet. Dort setzt man ein entsprechendes Kapitel an den Anfang oder Ende
-des Werks. Oft wird diese Zusammenfassung entweder mit der Einleitung oder
-einem weiteren Ausblick verknüpft. Daher gibt es bei \Class{scrbook} überhaupt
-keine \DescRef{\LabelBase.env.abstract}-Umgebung. Bei\textnote{Tipp!}
-Berichten im weiteren Sinne, etwa einer Studien- oder Diplomarbeit, ist
-ebenfalls eine Zusammenfassung in dieser Form zu empfehlen.%
-%
+verwendet. Dort setzt man ein entsprechendes Kapitel an den Anfang oder das
+Ende des Werks. Oft wird diese Zusammenfassung entweder mit der Einleitung
+oder einem weiteren Ausblick verknüpft. Daher gibt es bei \Class{scrbook}
+überhaupt keine \DescRef{\LabelBase.env.abstract}-Umgebung.
+Bei\textnote{Tipp!} Berichten im weiteren Sinne, etwa einer Studien- oder
+Diplomarbeit, ist ebenfalls eine Zusammenfassung in dieser Form zu
+empfehlen. Siehe dazu die in \autoref{sec:maincls.structure}, ab
+\DescPageRef{\LabelBase.cmd.chapter*} dokumentierten Befehle
+\DescRef{\LabelBase.cmd.chapter*}\IndexCmd{chapter*}.
+\DescRef{\LabelBase.cmd.addchap}\IndexCmd{addchap} und
+\DescRef{\LabelBase.cmd.addchap*}\IndexCmd{addchap*}.%
\EndIndexGroup
@@ -231,8 +235,8 @@ ebenfalls eine Zusammenfassung in dieser Form zu empfehlen.%
\begin{Environment}{abstract}\end{Environment}
\end{Declaration}%
\OnlyAt{\Class{scrartcl}\and \Class{scrreprt}}%
-Einige \LaTeX-Klassen bieten eine spezielle Umgebung für diese
-Zusammenfassung, die \Environment{abstract}-Umgebung. Diese wird unmittelbar
+Einige \LaTeX-Klassen bieten eine spezielle Umgebung für die
+Zusammenfassung: die \Environment{abstract}-Umgebung. Diese wird unmittelbar
ausgegeben, ist also nicht Bestandteil der mit
\DescRef{\LabelBase.cmd.maketitle} gesetzten Titelei. Bitte\textnote{Achtung!}
beachten Sie unbedingt, dass es sich bei \Environment{abstract} um eine
@@ -245,15 +249,16 @@ eines gesonderten Kapitels am Ende des Dokuments. Daher gibt es bei
\Class{scrbook} keine \Environment{abstract}-Umgebung. Bei Verwendung der
Klasse \Class{scrreprt} ist es sicher eine Überlegung wert, ob man nicht
genauso verfahren sollte. Siehe hierzu in \autoref{sec:\LabelBase.structure}
+ab \DescPageRef{\LabelBase.cmd.chapter*}
die Anweisungen \DescRef{\LabelBase.cmd.chapter*}\IndexCmd{chapter*} und
-\DescRef{\LabelBase.cmd.addchap}\IndexCmd{addchap} oder \DescRef{\LabelBase.cmd.addchap*}
-(\DescPageRef{\LabelBase.cmd.addchap}).
+\DescRef{\LabelBase.cmd.addchap}\IndexCmd{addchap} oder
+\DescRef{\LabelBase.cmd.addchap*}.% (\DescPageRef{\LabelBase.cmd.addchap}).
Wird ein Titelkopf\Index{Titel>Kopf} (siehe Option
\DescRef{\LabelBase.option.titlepage}, \autoref{sec:\LabelBase.titlepage},
\DescPageRef{\LabelBase.option.titlepage}) verwendet, so wird die
Zusammenfassung intern mit Hilfe einer
-\Environment{quotation}-Umgebung\IndexEnv{quotation} (siehe
+\DescRef{\LabelBase.env.quotation}-Umgebung\IndexEnv{quotation} (siehe
\autoref{sec:\LabelBase.lists}, \DescPageRef{\LabelBase.env.quotation})
gesetzt. Dabei werden Absatzanfänge normalerweise mit Einzug gesetzt. Soll der
erste Absatz nicht eingezogen werden, so kann dieser Einzug mit
@@ -277,6 +282,7 @@ man nach dem Inhaltsverzeichnis auch noch die Verzeichnisse der
Gleitumgebungen, beispielsweise von Tabellen und Abbildungen (siehe
\autoref{sec:\LabelBase.floats}).
+\iffalse%
Es ist zu beachten, dass neben den in diesem Abschnitt dokumentierten
Möglichkeiten auch noch die Anweisungen
\DescRef{maincls-experts.cmd.DeclareSectionCommand},
@@ -284,7 +290,31 @@ Möglichkeiten auch noch die Anweisungen
\DescRef{maincls-experts.cmd.RedeclareSectionCommand} und
\DescRef{maincls-experts.cmd.ProvideSectionCommand} Auswirkungen auf das
Inhaltsverzeichnis haben können. Siehe \autoref{sec:maincls-experts.experts},
-\DescPageRef{maincls-experts.cmd.DeclareSectionCommand}.
+\DescPageRef{maincls-experts.cmd.DeclareSectionCommand}.%
+\else%
+Neben den in diesem Abschnitt dokumentierten Möglichkeiten hat auch der mit
+\DescRef{tocbasic.cmd.DeclareTOCStyleEntry}\IndexCmd{DeclareTOCStyleEntry}%
+\important[O]{\DescRef{tocbasic.cmd.DeclareTOCStyleEntry}}
+gewählte und
+konfigurierte Eintragsstil des Pakets
+\hyperref[cha:tocbasic]{\Package{tocbasic}}%
+\important{\hyperref[cha:tocbasic]{\Package{tocbasic}}}%
+\IndexPackage{tocbasic} (siehe
+\DescPageRef{tocbasic.cmd.DeclareTOCStyleEntry}) maßgeblichen Einfluss auf die
+Darstellung des Inhaltsverzeichnisses. Entsprechend können sich auch die in
+\autoref{sec:maincls-experts.experts} ab
+\DescPageRef{maincls-experts.cmd.DeclareSectionCommand} dokumentierten
+Befehle
+\DescRef{maincls-experts.cmd.DeclareSectionCommand}%
+\important[O]{\DescRef{maincls-experts.cmd.DeclareSectionCommand}}%
+\IndexCmd{DeclareSectionCommand},
+\DescRef{maincls-experts.cmd.ProvideSectionCommand}%
+\IndexCmd{ProvideSectionCommand},
+\DescRef{maincls-experts.cmd.DeclareNewSectionCommand}%
+\IndexCmd{DeclareNewSectionCommand} und
+\DescRef{maincls-experts.cmd.RedeclareSectionCommand}%
+\IndexCmd{RedeclareSectionCommand} auf das Inhaltsverzeichnis auswirken.%
+\fi
\begin{Declaration}
@@ -300,7 +330,7 @@ skeptisch. Da\important{\OptionValue{toc}{listof}} es keinen Sinn hat, nur das
Tabellen- oder nur das Abbildungsverzeichnis ohne das jeweils andere ins
Inhaltsverzeichnis aufzunehmen, werden mit der
\PName{Einstellung}\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} \PValue{listof}\IndexOption{toc~=\PValue{listof}} beide
+ \Class{scrartcl}} \PValue{listof}\IndexOption{toc~=\textKValue{listof}} beide
Verzeichnisse gemeinsam ins Inhaltsverzeichnis aufgenommen. Dabei werden auch
Verzeichnisse berücksichtigt, die mit Hilfe des
\Package{float}-Pakets\IndexPackage{float} ab Version~1.2e (siehe
@@ -310,35 +340,28 @@ Verzeichnisse, die den Inhalt anderer Abschnitte des Werks auf"|führen,
erhalten Tabellen"~, Abbildungs- und die mit den genannten Paketen erzeugten
Verzeichnisse grundsätzlich keine Kapitelnummer. Wer diesen Grundsatz
ignorieren will, bedient sich der \PName{Einstellung}
-\PValue{listofnumbered}\IndexOption{toc~=\PValue{listofnumbered}}.
+\PValue{listofnumbered}\IndexOption{toc~=\textKValue{listofnumbered}}.
-\leavevmode\phantomsection\nobreak
-\label{desc:maincls.option.toc.index}\nobreak
+\leavevmode\LabelOptionValue{toc}{index}\nobreak
Das\important{\OptionValue{toc}{index}} Stichwortverzeichnis erhält mit
-\OptionValue{toc}{index}\IndexOption{toc~=\PValue{index}} einen Eintrag im
+\OptionValue{toc}{index}\IndexOption{toc~=\textKValue{index}} einen Eintrag im
Inhaltsverzeichnis. Da das Stichwortverzeichnis ebenfalls nur Verweise auf den
Inhalt anderer Abschnitte enthält, wird auch dieser Eintrag grundsätzlich
nicht nummeriert. Eine\ChangedAt{v3.18}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}}
Abweichung\important{\OptionValue{toc}{indexnumbered}} von diesem Grundsatz
wird von \KOMAScript{} trotz Bedenken des Autors mit
-\OptionValue{toc}{indexnumbered}\IndexOption{toc~=\PValue{indexnumbered}}
+\OptionValue{toc}{indexnumbered}\IndexOption{toc~=\textKValue{indexnumbered}}
ebenfalls unterstützt.
-\leavevmode\phantomsection\nobreak
-\label{desc:maincls.option.toc.bibliography}\nobreak
-Das Literaturverzeichnis stellt eine etwas andere Art von Verzeichnis
-dar. Hier wird nicht der Inhalt des vorliegenden Werks aufgelistet, sondern
-auf externe Inhalte
-verwiesen. Mit\important{%
- \begin{tabular}{@{}r@{}}
- \multicolumn{1}{@{}l@{}}{\Option{toc=}}\\
- ~\PValue{bibliographynumbered}\\
- \end{tabular}%
-} dieser Begründung könnte man argumentieren, dass das Literaturverzeichnis
-ein eigenes Kapitel bzw. einen eigenen Abschnitt darstelle und somit eine
-Nummer verdiene. Die Option \OptionValue{toc}{bibliographynumbered}%
-\IndexOption{toc~=\PValue{bibliographynumbered}} führt genau dazu,
+\leavevmode\LabelOptionValue{toc}{bibliography}\nobreak Das
+Literaturverzeichnis stellt eine etwas andere Art von Verzeichnis dar. Hier
+wird nicht der Inhalt des vorliegenden Werks aufgelistet, sondern auf externe
+Inhalte verwiesen. Mit\important{\OptionValue{toc}{bibliographynumbered}}
+dieser Begründung könnte man argumentieren, dass das Literaturverzeichnis ein
+eigenes Kapitel bzw. einen eigenen Abschnitt darstelle und somit eine Nummer
+verdiene. Die Option \OptionValue{toc}{bibliographynumbered}%
+\IndexOption{toc~=\textKValue{bibliographynumbered}} führt genau dazu,
einschließlich des dann fälligen Eintrags im Inhaltsverzeichnis. Ich selbst
bin allerdings der Meinung, dass bei dieser Argumentation auch ein
klassisches, kommentiertes Quellenverzeichnis ein eigenes Kapitel
@@ -346,11 +369,10 @@ wäre. Außerdem ist das Literaturverzeichnis letztlich nichts, was man selbst
geschrieben hat. Deshalb\important{\OptionValue{toc}{bibliography}} erscheint
mir allenfalls ein nicht nummerierter Eintrag im Inhaltsverzeichnis
angemessen, was mit der Einstellung
-\OptionValue{toc}{bibliography}\IndexOption{toc~=\PValue{bibliography}}
+\OptionValue{toc}{bibliography}\IndexOption{toc~=\textKValue{bibliography}}
erreicht wird.
-\leavevmode\phantomsection\nobreak
-\label{desc:maincls.option.toc.graduated}\nobreak
+\leavevmode\LabelOptionValue{toc}{graduated}\nobreak
Normalerweise\ChangedAt{v2.8q}{%
\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
\important{\OptionValue{toc}{graduated}} wird das Inhaltsverzeichnis so
@@ -359,17 +381,16 @@ werden. Dabei wird für die Gliederungsnummer jeder Ebene ein Raum fester
Breite vorgesehen, in dem die Nummer linksbündig gesetzt wird. Dies entspricht
der Einstellung\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}
-\OptionValue{toc}{graduated}\IndexOption{toc~=\PValue{graduated}}.
+\OptionValue{toc}{graduated}\IndexOption{toc~=\textKValue{graduated}}.
-\leavevmode\phantomsection\nobreak
-\label{desc:maincls.option.toc.flat}\nobreak
+\leavevmode\LabelOptionValue{toc}{flat}\nobreak
Werden sehr viele Gliederungspunkte verwendet, so werden die
Gliederungsnummern sehr breit. Damit reicht der vorgesehene Platz nicht
aus. In \cite{DANTE:FAQ} wird für solche Fälle vorgeschlagen, die Erzeugung
des Inhaltsverzeichnisses
umzudefinieren. \KOMAScript{}\important{\OptionValue{toc}{flat}} bietet jedoch
eine alternative Formatierung an, bei der das Problem nicht auf"|tritt. Bei
-Verwendung der Option \OptionValue{toc}{flat}\IndexOption{toc~=\PValue{flat}}
+Verwendung der Option \OptionValue{toc}{flat}\IndexOption{toc~=\textKValue{flat}}
werden die unterschiedlichen Gliederungsebenen nicht unterschiedlich weit
eingezogen. Stattdessen wird eine tabellenartige Form gewählt, in der alle
Gliederungsnummern und alle Gliederungstexte jeweils in einer Spalte
@@ -389,35 +410,36 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von
\entry{\PValue{bibliography}, \PValue{bib}}{%
Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis, ohne
dass es nummeriert wird.%
- \IndexOption{toc~=\PValue{bibliography}}}%
+ \IndexOption{toc~=\textKValue{bibliography}}}%
\entry{\PValue{bibliographynumbered}, \PValue{bibnumbered},
\PValue{numberedbibliography}, \PValue{numberedbib}}{%
Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis und
wird nummeriert.%
- \IndexOption{toc~=\PValue{bibliographynumbered}}}%
+ \IndexOption{toc~=\textKValue{bibliographynumbered}}}%
\entry{\PValue{chapterentrywithdots}, \PValue{chapterentrydotfill}}{%
\ChangedAt[2014/12]{v3.15}{\Class{scrbook}\and \Class{scrreprt}}%
Bei den Kapiteleinträgen der Klassen \Class{scrbook} und \Class{scrreprt}
werden Text und Seitenzahl ebenfalls durch eine punktierte Linie
miteinander verbunden.%
- \IndexOption{toc~=\PValue{chapterentrywithdots}}}%
+ \IndexOption{toc~=\textKValue{chapterentrywithdots}}}%
\entry{\PValue{chapterentrywithoutdots}, \PValue{chapterentryfill}}{%
\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}}%
Bei den Kapiteleinträgen der Klassen \Class{scrbook} und \Class{scrreprt}
werden Text und Seitenzahl nicht durch eine punktierte Linie miteinander
- verbunden.%
- \IndexOption{toc~=\PValue{chapterentrywithoutdots}}}%
+ verbunden. Dies entspricht der Voreinstellung.%
+ \IndexOption{toc~=\textKValue{chapterentrywithoutdots}}}%
\entry{\PValue{flat}, \PValue{left}}{%
Das Inhaltsverzeichnis erhält eine tabellarische Form. Die
Gliederungsnummern sind dabei die erste Spalte, die Überschriften die
zweite Spalte, die Seitenzahlen die dritte Spalte. Der Platz, der für die
Gliederungsnummern reserviert wird, richtet sich nach dem benötigten Platz
des vorherigen \LaTeX-Laufs.%
- \IndexOption{toc~=\PValue{flat}}}%
+ \IndexOption{toc~=\textKValue{flat}}}%
\entry{\PValue{graduated}, \PValue{indent}, \PValue{indented}}{%
Das Inhaltsverzeichnis erhält eine hierarchische Form. Es steht nur ein
- begrenzter Platz für die Gliederungsnummern zur Verfügung.%
- \IndexOption{toc~=\PValue{graduated}}}%
+ begrenzter Platz für die Gliederungsnummern zur Verfügung. Dies entspricht
+ der Voreinstellung.%
+ \IndexOption{toc~=\textKValue{graduated}}}%
\entry{\PValue{indenttextentries}, \PValue{indentunnumbered},
\PValue{numberline}}{%
\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
@@ -426,59 +448,61 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von
\DescPageRef{tocbasic.cmd.setuptoc}) wird für das Inhaltsverzeichnis
gesetzt. Dadurch werden nicht nummerierte Einträge linksbündig mit dem
Text von nummerierten Einträgen gleicher Ebene gesetzt.%
- \IndexOption{toc~=\PValue{numberline}}}%
+ \IndexOption{toc~=\textKValue{numberline}}}%
\entry{\PValue{index}, \PValue{idx}}{%
Das Stichwortverzeichnis erhält einen Eintrag im Inhaltsverzeichnis, ohne
dass es nummeriert wird.%
- \IndexOption{toc~=\PValue{index}}}%
+ \IndexOption{toc~=\textKValue{index}}}%
\entry{\PValue{indexnumbered}}{%
\ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
Das Stichwortverzeichnis erhält einen Eintrag im Inhaltsverzeichnis und
wird nummeriert.%
- \IndexOption{toc~=\PValue{index}}}%
+ \IndexOption{toc~=\textKValue{index}}}%
\entry{\PValue{leftaligntextentries}, \PValue{leftalignunnumbered},
\PValue{nonumberline}}{%
\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
Die Eigenschaft \PValue{numberline} (siehe \autoref{sec:tocbasic.toc},
\DescPageRef{tocbasic.cmd.setuptoc}) wird für das Inhaltsverzeichnis
- gelöscht. Dadurch werden nicht nummerierte Einträge linksbündig mit den
+ gelöscht. Dadurch werden nicht nummerierte Einträge linksbündig mit der
Nummer von nummerierten Einträgen gleicher Ebene gesetzt. Dies entspricht
der Voreinstellung.%
- \IndexOption{toc~=\PValue{numberline}}}%
+ \IndexOption{toc~=\textKValue{numberline}}}%
\pventry{listof}{%
Die Verzeichnisse der Gleitumgebungen, beispielsweise das Abbildungs"~ und
das Tabellenverzeichnis, erhalten einen Eintrag im Inhaltsverzeichnis,
ohne dass sie nummeriert werden.%
- \IndexOption{toc~=\PValue{listof}}}%
+ \IndexOption{toc~=\textKValue{listof}}}%
\entry{\PValue{listofnumbered}, \PValue{numberedlistof}}{%
Die Verzeichnisse der Gleitumgebungen, beispielsweise das Abbildungs"~ und
das Tabellenverzeichnis, erhalten einen Eintrag im Inhaltsverzeichnis und
werden nummeriert.%
- \IndexOption{toc~=\PValue{listofnumbered}}}%
+ \IndexOption{toc~=\textKValue{listofnumbered}}}%
\entry{\PValue{nobibliography}, \PValue{nobib}}{%
- Das Literaturverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis.%
- \IndexOption{toc~=\PValue{nobibliography}}}%
+ Das Literaturverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis. Dies
+ entspricht der Voreinstellung.%
+ \IndexOption{toc~=\textKValue{nobibliography}}}%
\entry{\PValue{noindex}, \PValue{noidx}}{%
- Das Stichwortverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis.%
- \IndexOption{toc~=\PValue{noindex}}}%
+ Das Stichwortverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis. Dies
+ entspricht der Voreinstellung.%
+ \IndexOption{toc~=\textKValue{noindex}}}%
\pventry{nolistof}{%
Die Verzeichnisse der Gleitumgebungen, beispielsweise das Abbildungs"~ und
- das Tabellenverzeichnis, erhalten keinen Eintrag im Inhaltsverzeichnis.%
- \IndexOption{toc~=\PValue{nolistof}}}%
+ das Tabellenverzeichnis, erhalten keinen Eintrag im
+ Inhaltsverzeichnis. Dies entspricht der Voreinstellung.%
+ \IndexOption{toc~=\textKValue{nolistof}}}%
\entry{\PValue{sectionentrywithdots}, \PValue{sectionentrydotfill}}{%
\ChangedAt[2014/12]{v3.15}{\Class{scrartcl}}%
- Bei den Abschnittseinträgen der Klasse \Class{scrartcl}
- werden Text und Seitenzahl ebenfalls durch eine punktierte Linie
- miteinander verbunden.%
- \IndexOption{toc~=\PValue{sectionentrywithdots}}}%
+ Bei den Abschnittseinträgen der Klasse \Class{scrartcl} werden Text und
+ Seitenzahl ebenfalls durch eine punktierte Linie miteinander verbunden.%
+ \IndexOption{toc~=\textKValue{sectionentrywithdots}}}%
\entry{\PValue{sectionentrywithoutdots}, \PValue{sectionentryfill}}{%
\ChangedAt{v3.15}{\Class{scrartcl}}%
- Bei den Abschnittseinträgen der Klasse \Class{scrartcl}
- werden Text und Seitenzahl nicht durch eine punktierte Linie miteinander
- verbunden.%
- \IndexOption{toc~=\PValue{sectionentrywithoutdots}}}%
+ Bei den Abschnittseinträgen der Klasse \Class{scrartcl} werden Text und
+ Seitenzahl nicht durch eine punktierte Linie miteinander verbunden. Dies
+ entspricht der Voreinstellung.%
+ \IndexOption{toc~=\textKValue{sectionentrywithoutdots}}}%
\end{desclist}
%
\EndIndexGroup
@@ -504,15 +528,16 @@ einer punktierten Linie lediglich ein Abstand verwendet wird.
\BeginIndex{FontElement}{sectionentrydots}\LabelFontElement{sectionentrydots}%
Wird die punktierte Linie verwendet, so kann deren Schrift über die Elemente
\FontElement{chapterentrydots}%
-\important[i]{\FontElement{chapterentrydots}\\
- \FontElement{sectionentrydots}} und
-\FontElement{sectionentrydots} gegenüber
+\important{\FontElement{chapterentrydots}\\
+ \FontElement{sectionentrydots}} und \FontElement{sectionentrydots} gegenüber
den Einstellungen für die Seitenzahlen in den Einträgen verändert werden
-(siehe auch \autoref{sec:\LabelBase.textmarkup},
+(siehe auch \DescRef{\LabelBase.cmd.setkomafont} und
+\DescRef{\LabelBase.cmd.addtokomafont}, \autoref{sec:\LabelBase.textmarkup},
\DescPageRef{\LabelBase.cmd.setkomafont}, sowie
\autoref{tab:maincls.fontelements},
-\autopageref{tab:maincls.fontelements}). Die Voreinstellungen der
-Elemente sind \autoref{tab:maincls.tocelements} zu entnehmen. Es ist zu
+\autopageref{tab:maincls.fontelements}). Die Voreinstellungen der Elemente
+sind \autoref{tab:maincls.tocelements} auf
+\autopageref{tab:maincls.tocelements} zu entnehmen. Es ist zu
beachten\textnote{Achtung!}, dass die Pünktchen nur sauber untereinander
stehen, wenn die Schrift aller Pünktchen identisch ist.%
\EndIndexGroup
@@ -528,28 +553,28 @@ Option \DescRef{\LabelBase.option.toc} kann der Umfang und die Form des
Inhaltsverzeichnisses beeinflusst werden. Nach einer Umschaltung der Option
sind ebenfalls mindestens zwei weitere \LaTeX-Läufe notwendig.
-Der Eintrag für die oberste Gliederungsebene unter \DescRef{\LabelBase.cmd.part}, also
-\DescRef{\LabelBase.cmd.chapter} bei \Class{scrbook}\IndexClass{scrbook} und
-\Class{scrreprt}\IndexClass{scrreprt} beziehungsweise \DescRef{\LabelBase.cmd.section} bei
-\Class{scrartcl}\IndexClass{scrartcl}, sowie der Gliederungsebene \DescRef{\LabelBase.cmd.part}
-selbst wird nicht eingerückt. Gleichzeitig befinden sich zwischen dem Text der
-Gliederungsebene und der Seitenzahl keine Pünktchen. Die typografischen Gründe
-dafür liegen in der normalerweise anderen Schriftart sowie der erwünschten
-Hervorhebung. Dies\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} kann jedoch beispielsweise mit Option
-\DescRef{\LabelBase.option.toc} geändert werden (siehe
-\DescPageRef{\LabelBase.option.toc} und \autoref{tab:maincls.toc} ab
-\autopageref{tab:maincls.toc}). Das Inhaltsverzeichnis dieser Anleitung ist
-mit den Voreinstellungen gesetzt und dient als Beispiel.
+Der Eintrag für \DescRef{\LabelBase.cmd.chapter}\IndexCmd{chapter} bei
+\Class{scrbook}\IndexClass{scrbook} und \Class{scrreprt}\IndexClass{scrreprt}
+beziehungsweise \DescRef{\LabelBase.cmd.section}\IndexCmd{section} bei
+\Class{scrartcl}\IndexClass{scrartcl} sowie der Gliederungsebene
+\DescRef{\LabelBase.cmd.part}\IndexCmd{part} wird nicht
+eingerückt. Gleichzeitig befinden sich zwischen dem Text der Gliederungsebene
+und der Seitenzahl in der Voreinstellung keine Pünktchen. Die typografischen
+Gründe dafür liegen in der normalerweise anderen Schriftart sowie der
+erwünschten Hervorhebung. Dies\ChangedAt{v3.15}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}} kann jedoch mit den zuvor
+dokumentierten Optionen geändert werden. Das Inhaltsverzeichnis \iffree{dieser
+ Anleitung}{dieses Buches} ist mit den Voreinstellungen gesetzt und dient als
+Beispiel.
\BeginIndex{FontElement}{partentry}\LabelFontElement{partentry}%
\BeginIndex{FontElement}{chapterentry}\LabelFontElement{chapterentry}%
\BeginIndex{FontElement}{sectionentry}\LabelFontElement{sectionentry}%
Die\ChangedAt{v2.97c}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}}\important[i]{\FontElement{partentry}\\
+ \Class{scrartcl}}\important{\FontElement{partentry}\\
\FontElement{chapterentry}\\
- \FontElement{sectionentry}} Schrift der beiden oberen
-Inhaltsverzeichniseinträge ist außerdem über die Elemente
+ \FontElement{sectionentry}} Schrift der oberen
+Inhaltsverzeichniseinträge ist über die Elemente
\FontElement{partentry} und für \Class{scrbook}
und \Class{scrreprt} über
\FontElement{chapterentry} beziehungsweise
@@ -557,6 +582,7 @@ und \Class{scrreprt} über
einstellbar.
\BeginIndex{FontElement}{partentrypagenumber}%
\LabelFontElement{partentrypagenumber}%
+\LabelFontElement{pagination}%
\BeginIndex{FontElement}{chapterentrypagenumber}%
\LabelFontElement{chapterentrypagenumber}%
\BeginIndex{FontElement}{sectionentrypagenumber}%
@@ -565,25 +591,26 @@ Die Schrift der Seitenzahlen kann jeweils davon abweichend über die Elemente
\FontElement{partentrypagenumber}%
\important{\FontElement{partentrypagenumber}} und
\FontElement{chapterentrypagenumber}%
-\important[i]{\FontElement{chapterentrypagenumber}\\
+\important{\FontElement{chapterentrypagenumber}\\
\FontElement{sectionentrypagenumber}} (\Class{scrbook} und \Class{scrreprt})
beziehungsweise \FontElement{sectionentrypagenumber} (\Class{scrartcl})
-eingestellt werden (siehe auch \autoref{sec:\LabelBase.textmarkup},
+eingestellt werden (siehe auch \DescRef{\LabelBase.cmd.setkomafont} und
+\DescRef{\LabelBase.cmd.addtokomafont} in \autoref{sec:\LabelBase.textmarkup},
\DescPageRef{\LabelBase.cmd.setkomafont}, sowie
\autoref{tab:maincls.fontelements}, \autopageref{tab:maincls.fontelements}).
Werden\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} für die Kapitel- beziehungsweise Abschnittseinträge
-ebenfalls punktierte Verbindungslinien zu den Seitenzahlen über Option
-\DescRef{\LabelBase.option.toc}%
-\IndexOption{toc~=\PValue{chapterentrywithdots}}%
-\IndexOption{toc~=\PValue{sectionentrywithdots}},
-\Option{chapterentrydots}\IndexOption{chapterentrydots~=\PName{Ein-Aus-Wert}}
-oder
-\Option{sectionentrydots}\IndexOption{sectionentrydots~=\PName{Ein-Aus-Wert}}
-verwendet, so kann deren Schrift über die Elemente
-\DescRef{\LabelBase.fontelement.chapterentrydots}%
+ \Class{scrartcl}} je nach Klasse für die Kapitel- beziehungsweise
+Abschnittseinträge ebenfalls punktierte Verbindungslinien zu den Seitenzahlen
+über Option \DescRef{\LabelBase.option.toc}%
+\IndexOption{toc~=\textKValue{chapterentrywithdots}}%
+\IndexOption{toc~=\textKValue{sectionentrywithdots}},
+\DescRef{\LabelBase.option.chapterentrydots}%
+\IndexOption{chapterentrydots~=\PName{Ein-Aus-Wert}} oder
+\DescRef{\LabelBase.option.sectionentrydots}%
+\IndexOption{sectionentrydots~=\PName{Ein-Aus-Wert}} verwendet, so kann deren
+Schrift über die Elemente \DescRef{\LabelBase.fontelement.chapterentrydots}%
\IndexFontElement{chapterentrydots}%
-\important[i]{\DescRef{\LabelBase.fontelement.chapterentrydots}\\
+\important{\DescRef{\LabelBase.fontelement.chapterentrydots}\\
\DescRef{\LabelBase.fontelement.sectionentrydots}} und
\DescRef{\LabelBase.fontelement.sectionentrydots}%
\IndexFontElement{sectionentrydots} gegenüber den Einstellungen für die
@@ -625,16 +652,30 @@ Seitenzahlen verändert werden. Die Voreinstellungen der Elemente sind
\begin{Declaration}
\Counter{tocdepth}
+ \Macro{parttocdepth}
+ \Macro{sectiontocdepth}
+ \Macro{subsectiontocdepth}
+ \Macro{subsubsectiontocdepth}
+ \Macro{paragraphtocdepth}
+ \Macro{subparagraphtocdepth}
\end{Declaration}%
Normalerweise werden bei den Klassen \Class{scrbook} und \Class{scrreprt} die
-Gliederungsebenen \DescRef{\LabelBase.cmd.part} bis \DescRef{\LabelBase.cmd.subsection} und bei der Klasse
-\Class{scrartcl} die Ebenen \DescRef{\LabelBase.cmd.part} bis \DescRef{\LabelBase.cmd.subsubsection} in das
-Inhaltsverzeichnis aufgenommen. Dies wird über den Zähler \Counter{tocdepth}
-gesteuert. Dabei steht der Wert \(-\)1 für \DescRef{\LabelBase.cmd.part}, 0 für
-\DescRef{\LabelBase.cmd.chapter} und so weiter. Durch Setzen oder Erhöhen oder Verringern des
-Zählers kann bestimmt werden, bis zu welcher Gliederungsebene Einträge in das
-Inhaltsverzeichnis erfolgen sollen. Dies ist übrigens bei den Standardklassen
-ganz genauso.
+Gliederungsebenen \DescRef{\LabelBase.cmd.part} bis
+\DescRef{\LabelBase.cmd.subsection} und bei der Klasse \Class{scrartcl} die
+Ebenen \DescRef{\LabelBase.cmd.part} bis
+\DescRef{\LabelBase.cmd.subsubsection} in das Inhaltsverzeichnis
+aufgenommen. Dies wird über den Zähler \Counter{tocdepth} gesteuert. Dabei
+steht der Wert -1 für \DescRef{\LabelBase.cmd.part}, 0 für
+\DescRef{\LabelBase.cmd.chapter} und so weiter. Durch Setzen oder Erhöhen
+oder Verringern des Zählers kann bestimmt werden, bis zu welcher
+Gliederungsebene Einträge in das Inhaltsverzeichnis erfolgen sollen. Dies ist
+übrigens bei den Standardklassen ganz
+genauso. Im\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} Unterschied\textnote{\KOMAScript{} vs. Standardklassen} zu
+den Standardklassen muss sich bei \KOMAScript{} aber niemand diese Zuordnung
+merken. \KOMAScript{} definiert für jede Gliederungsebene eine Anweisung
+\Macro{\PName{Ebene}tocdepth} mit dem entsprechenden Wert, die für Zuweisungen
+an \Counter{tocdepth} verwendet werden kann.
Bitten beachten Sie\textnote{Achtung!}, dass die Werte für \Counter{tocdepth}
und \DescRef{\LabelBase.counter.secnumdepth}\IndexCounter{secnumdepth} (siehe
@@ -642,48 +683,35 @@ und \DescRef{\LabelBase.counter.secnumdepth}\IndexCounter{secnumdepth} (siehe
\DescPageRef{\LabelBase.counter.secnumdepth}) bei
\Class{scrartcl}\OnlyAt{\Class{scrartcl}} für \DescRef{\LabelBase.cmd.part}
nicht übereinstimmen. Dies wurde aus Gründen der Kompatibilität von der
-Standardklasse \Class{article} übernommen. Daher sollte die Anweisung
-\DescRef{\LabelBase.cmd.partnumdepth}\IndexCmd{partnumdepth} nicht zum Setzen
-von \Counter{tocdepth} verwendet werden.%
+Standardklasse \Class{article} übernommen. Daher sollte beispielsweise die
+Anweisung \DescRef{\LabelBase.cmd.partnumdepth}\IndexCmd{partnumdepth} auch
+nicht zum Setzen von \Counter{tocdepth} verwendet werden.%
\begin{Example}
Angenommen, Sie setzen einen Artikel, bei dem die Gliederungsebene
- \DescRef{\LabelBase.cmd.subsubsection} verwendet wird. Gehen wir weiter davon aus,
- dass Sie diese Gliederungsebene aber nicht im Inhaltsverzeichnis
+ \DescRef{\LabelBase.cmd.subsubsection} verwendet wird. Gehen wir weiter
+ davon aus, dass Sie diese Gliederungsebene aber nicht im Inhaltsverzeichnis
haben wollen. Dann könnte die Präambel Ihres Dokuments wie folgt
aussehen:
\begin{lstcode}
\documentclass{scrartcl}
- \setcounter{tocdepth}{2}
+ \setcounter{tocdepth}{\subsectiontocdepth}
\end{lstcode}
- Sie setzen den Zähler \Counter{tocdepth} also auf 2, weil Sie
- wissen, dass dies der Wert für \DescRef{\LabelBase.cmd.subsection} ist. Wissen Sie
- stattdessen nur, dass normalerweise bei \Class{scrartcl} Einträge in
- das Inhaltsverzeichnis bis zur Ebene \DescRef{\LabelBase.cmd.subsubsection} erfolgen,
- können Sie auch einfach vom voreingestellten Wert des Zählers
- \Counter{tocdepth} eins abziehen:
+ Sie setzen den Zähler \Counter{tocdepth} daher auf den in Anweisung
+ \Macro{subsectiontocdepth} gespeicherten Wert. Dass dies normalerweise der
+ Wert 2 ist, müssen Sie sich also gar nicht merken.
+
+ Wollen Sie stattdessen nur, dass eine Ebene weniger in das
+ Inhaltsverzeichnis eingetragen wird als normalerweise, können Sie auch
+ einfach vom voreingestellten Wert des Zählers \Counter{tocdepth} eins
+ abziehen:
\begin{lstcode}
\documentclass{scrartcl}
\addtocounter{tocdepth}{-1}
\end{lstcode}
Den\textnote{Tipp!} Wert, den Sie zu \Counter{tocdepth} addieren oder davon
- subtrahieren müssen, können Sie nach mindestens zwei \LaTeX-Läufen einfach im
- Inhaltsverzeichnis abzählen.
-\end{Example}
-\iffalse % Umbruchausgleichstext
-Falls\textnote{Tipp!} Sie sich nicht merken wollen, welche Nummer zu welcher
-Gliederungsebene gehört: Einfach im Inhaltsverzeichnis abzählen, wie viele
-Ebenen mehr oder weniger Sie benötigen, und dann wie in obigem Beispiel mit
-\Macro{addtocounter} zu \Counter{tocdepth} addieren oder davon subtrahieren.%
-\fi%
-\iffalse % Umbruchausgleichstext
-Ein kleiner Tip am Rande: In obigem Beispiel benötigen Sie immer irgendein
-Vorwissen. Es geht aber auch ohne indem Sie zunächst zwei \LaTeX-Läufe
-durchführen. Dann zählen Sie am Inhaltsverzeichnis ab, wieviele Ebenen Sie zu
-\Counter{tocdepth} hinzuaddieren oder davon abziehen müssen. Dies erledigen
-Sie dann wie eben mit Hilfe von \Macro{addtocounter} in der Präambel Ihres
-Dokuments.%
-\fi
-%
+ subtrahieren müssen, können Sie nach mindestens zwei \LaTeX-Läufen einfach
+ im Inhaltsverzeichnis abzählen.
+\end{Example}%
\EndIndexGroup
%
\EndIndexGroup
@@ -720,36 +748,40 @@ ein. Ein Aktivieren der Option \Option{footsepline} oder die Verwendung der
Option ohne Wertübergabe schaltet die Linie über der Fußzeile ein. Die
Deaktivierung der Optionen schaltet die jeweilige Linie aus.
-Bei\textnote{Achtung!} den weiter unten erklärten Seitenstilen \PValue{empty}
-und \PValue{plain} hat die Option \Option{headsepline} selbstverständlich
-keine Auswirkung, da hier auf einen Seitenkopf\Index{Seiten>Kopf} ausdrücklich
-verzichtet werden soll. Typografisch betrachtet hat eine solche Linie immer
-die Auswirkung, dass der Kopf optisch näher an den Text heranrückt. Dies
-bedeutet nun nicht, dass der Kopf räumlich weiter vom
-Textkörper\Index{Text>Bereich} weggerückt werden müsste. Stattdessen sollte
-der Kopf dann bei der Berechnung des Satzspiegels als zum Textkörper gehörend
-betrachtet werden. Dies wird bei {\KOMAScript} dadurch erreicht, dass bei
-Verwendung der Klassenoption \Option{headsepline} automatisch die Paketoption
+Bei\textnote{Achtung!} den weiter unten erklärten Seitenstilen
+\DescRef{\LabelBase.pagestyle.empty} und \DescRef{\LabelBase.pagestyle.plain}
+hat die Option \Option{headsepline} selbstverständlich keine Auswirkung, da
+hier auf einen Seitenkopf\Index{Seiten>Kopf} ausdrücklich verzichtet werden
+soll. Typografisch betrachtet, hat eine solche Linie immer die Auswirkung,
+dass der Kopf optisch näher an den Text heranrückt. Dies bedeutet nun nicht,
+dass der Kopf räumlich weiter vom Textkörper\Index{Text>Bereich} weggerückt
+werden müsste. Stattdessen sollte der Kopf dann bei der Berechnung des
+Satzspiegels als zum Textkörper gehörend betrachtet werden. Dies wird bei
+\KOMAScript{} dadurch erreicht, dass Paket
+\hyperref[cha:typearea]{\Package{typearea}}%
+\important{\hyperref[cha:typearea]{\Package{typearea}}}\IndexPackage{typearea}
+ebenfalls auf \Option{headsepline} reagiert und automatisch die Paketoption
\DescRef{typearea.option.headinclude}%
\IndexOption{headinclude}\important{\DescRef{typearea.option.headinclude}} mit
-gleichem Wert an das \Package{typearea}-Paket weitergereicht
-wird. Entsprechendes gilt bei \Option{footsepline} für
-\DescRef{typearea.option.footinclude}%
-\IndexOption{footinclude}\important{\DescRef{typearea.option.footinclude}}.
-Im Gegensatz zu \Option{headsepline} wirkt sich die Option
-\Option{footsepline} auch beim Seitenstil \PValue{plain} aus, da
-\PValue{plain} eine Seitenzahl im Fuß ausgibt.
+gleichem Wert ausführt. Entsprechendes gilt auch für die Fußlinie. Im
+Gegensatz zu \Option{headsepline} wirkt sich die Option \Option{footsepline}
+auch beim Seitenstil \PValue{plain} aus, da \PValue{plain} eine Seitenzahl im
+Fuß ausgibt.
Die Optionen führen selbst keine automatische Neuberechnung des Satzspiegels
aus. Zur Neuberechnung des Satzspiegels siehe Option
-\DescRef{typearea.option.DIV} mit den Werten \PValue{last} oder
-\PValue{current} (siehe \DescPageRef{typearea.option.DIV.last}) oder die
-Anweisung \DescRef{typearea.cmd.recalctypearea} (siehe
+\DescRef{typearea.option.DIV} mit den Werten
+\hyperref[desc:typearea.option.DIV.last]{\PValue{last}} oder
+\hyperref[desc:typearea.option.DIV.current]{\PValue{current}} (siehe
+\DescPageRef{typearea.option.DIV.last}) oder die Anweisung
+\DescRef{typearea.cmd.recalctypearea} (siehe
\DescPageRef{typearea.cmd.recalctypearea}) in \autoref{cha:typearea}.
-Das Paket \Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage}%
-\important{\Package{scrlayer-scrpage}} (siehe \autoref{cha:scrlayer-scrpage})
-bietet weitere Einflussmöglichkeiten für Linien im Kopf und Fuß.%
+Das Paket \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} (siehe
+\autoref{cha:scrlayer-scrpage}) bietet weitere Einflussmöglichkeiten für
+Linien im Kopf und Fuß.%
%
\EndIndexGroup
@@ -804,7 +836,7 @@ bietet weitere Einflussmöglichkeiten für Linien im Kopf und Fuß.%
die Kolumnentitel nicht automatisch\Index[indexmain]{Kolumnentitel>manuell}
erzeugt, sondern liegen in der Verantwortung des Anwenders. Er verwendet
dazu die Anweisungen \DescRef{\LabelBase.cmd.markboth}\IndexCmd{markboth}
- und \DescRef{\LabelBase.cmd.markright}\IndexCmd{markright}\important[i]{%
+ und \DescRef{\LabelBase.cmd.markright}\IndexCmd{markright}\important{%
\DescRef{\LabelBase.cmd.markboth}\\
\DescRef{\LabelBase.cmd.markright}} (siehe
\DescPageRef{\LabelBase.cmd.markright}).
@@ -847,14 +879,15 @@ ausgeführt.
Bitte\textnote{Achtung!} beachten Sie, dass die Umschaltung zwischen
automatischen und manuellen Kolumnentiteln bei Verwendung von
-\Package{scrlayer-scrpage}\important{\Package{scrlayer-scrpage}} nicht mehr
-über den Seitenstil, sondern mit speziellen Anweisungen erfolgt. Die beiden
-Seitenstile \PageStyle{headings} und \PageStyle{myheadings} sollten nicht
-zusammen mit diesem Paket verwendet werden.
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} nicht
+mehr über den Seitenstil, sondern mit speziellen Anweisungen erfolgt. Die
+beiden Seitenstile \PageStyle{headings} und \PageStyle{myheadings} sollten
+nicht zusammen mit diesem Paket verwendet werden.
-\BeginIndexGroup
-\BeginIndex[indexother]{}{Schrift>Art}%
+\BeginIndexGroup \BeginIndex[indexother]{}{Schrift>Art}%
\BeginIndex{FontElement}{pageheadfoot}\LabelFontElement{pageheadfoot}%
+\LabelFontElement{pagehead}%
\BeginIndex{FontElement}{pagefoot}\LabelFontElement{pagefoot}%
\BeginIndex{FontElement}{pagenumber}\LabelFontElement{pagenumber}%
Um die Schriftarten von Kopf und Fuß der Seite oder der Seitenzahl zu
@@ -871,8 +904,8 @@ Seitenzahl innerhalb des Kopfes oder Fußes heißt
\important{\FontElement{pagenumber}}. Das ebenfalls in den \KOMAScript-Klassen
bereitgestellte Element \FontElement{pagefoot}\IndexFontElement{pagefoot}%
\important{\FontElement{pagefoot}} wird nur verwendet, wenn man mit dem Paket
-\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} (siehe
-\autoref{cha:scrlayer-scrpage},
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage} (siehe \autoref{cha:scrlayer-scrpage},
\DescPageRef{scrlayer-scrpage.fontelement.pagefoot}) einen Seitenstil
definiert, bei dem auch der Fuß Text enthält.
@@ -930,10 +963,11 @@ finden.
\autopageref{tab:maincls.fontelements}).
\end{Example}
Es ist an dieser Stelle nicht möglich, Versalien für die automatischen
-Kolumnentitel zu erzwingen. Wenn Sie dies wünschen, müssen Sie entweder
+Kolumnentitel zu erzwingen. Wenn Sie dies wünschen, müssen Sie beispielsweise
\DescRef{tocbasic.cmd.MakeMarkcase}\IndexCmd{MakeMarkcase} entsprechend
umdefinieren. Es wird jedoch empfohlen, in solchen Fällen das Paket
-\Package{scrlayer-scrpage} zu verwenden (siehe \autoref{cha:scrlayer-scrpage},
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} zu verwenden
+(siehe \autoref{cha:scrlayer-scrpage},
\DescPageRef{scrlayer-scrpage.option.markcase}).
Werden\textnote{Tipp!} eigene Seitenstile definiert, sind eventuell die
@@ -941,16 +975,21 @@ Befehle \DescRef{\LabelBase.cmd.usekomafont}\PParameter{pageheadfoot},
\DescRef{\LabelBase.cmd.usekomafont}\PParameter{pagenumber} sowie
\DescRef{\LabelBase.cmd.usekomafont}\PParameter{pagefoot}
nützlich. Insbesondere falls Sie dafür nicht das \KOMAScript-Paket
-\Package{scrlayer-scrpage} (siehe \autoref{cha:scrlayer-scrpage}), sondern
-beispielsweise das Paket
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} (siehe
+\autoref{cha:scrlayer-scrpage}), sondern beispielsweise das Paket
\Package{fancyhdr}\IndexPackage{fancyhdr}\important{\Package{fancyhdr}} (siehe
\cite{package:fancyhdr}) einsetzen, können Sie diese Befehle in Ihren
Definitionen verwenden. Dadurch bleiben Sie zu \KOMAScript{} möglichst
kompatibel. Verwenden Sie diese Befehle in Ihren eigenen Definitionen nicht,
so bleiben Schriftänderungen wie in den vorangehenden Beispielen
unbeachtet. Das Paket
-\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} sorgt selbst für
-maximale Kompatibilität.%
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage} sorgt selbst für maximale
+Kompatibilität. Solange beispielsweise für die Seitenzahl nicht direkt
+\DescRef{\LabelBase-experts.cmd.thepage}\IndexCmd{thepage}, sondern
+das dafür vorgesehene
+\DescRef{\LabelBase-experts.cmd.pagemark}\IndexCmd{pagemark} verwendet
+wird.%
\EndIndexGroup
%
\EndIndexGroup
@@ -960,22 +999,25 @@ maximale Kompatibilität.%
\Macro{markboth}\Parameter{linke Marke}\Parameter{rechte Marke}
\Macro{markright}\Parameter{rechte Marke}
\end{Declaration}
-Beim Seitenstil \PageStyle{myheadings}\important{\PageStyle{myheadings}}%
+Beim Seitenstil \DescRef{\LabelBase.pagestyle.myheadings}%
+\important{\DescRef{\LabelBase.pagestyle.myheadings}}%
\IndexPagestyle{myheadings} wird der Kolumnentitel nicht automatisch
gesetzt. Stattdessen setzt man ihn mit Hilfe der Anweisungen \Macro{markboth}
und \Macro{markright}. Dabei wird die \PName{linke Marke} normalerweise im
Kopf linker Seiten und die \PName{rechte Marke} im Kopf rechter Seiten
verwendet. Im einseitigen Satz existiert nur die rechte Marke. Bei Verwendung
-des Paketes \Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage}%
-\important{\Package{scrlayer-scrpage}} steht außerdem die Anweisung
-\DescRef{scrlayer-scrpage.cmd.markleft}%
+des Pakets \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} steht
+außerdem die Anweisung \DescRef{scrlayer-scrpage.cmd.markleft}%
\IndexCmd{markleft}\important{\DescRef{scrlayer-scrpage.cmd.markleft}} zur
Verfügung.
Die Anweisungen können auch zusammen mit anderen Seitenstilen verwendet
werden. Bei Kombination mit automatischen Kolumnentiteln, etwa dem Seitenstil
-\PageStyle{headings}, ist der Wirkungsbereich allerdings bis zum nächsten
-automatischen Setzen der entsprechenden Marke begrenzt.%
+\DescRef{\LabelBase.pagestyle.headings}\IndexPagestyle{headings}, ist der
+Wirkungsbereich allerdings bis zum nächsten automatischen Setzen der
+entsprechenden Marke begrenzt.%
%
\EndIndexGroup
@@ -995,8 +1037,9 @@ diesen vier Makros entnommen, wobei \Macro{partpagestyle} und
\Macro{chapterpagestyle}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} nur bei
den Klassen \Class{scrbook} und \Class{scrreprt} nicht jedoch bei
\Class{scrartcl} existieren. In der Voreinstellung ist der Seitenstil in allen
-vier Fällen \PValue{plain}. Die Bedeutung der einzelnen Makros entnehmen Sie
-bitte \autoref{tab:specialpagestyles}.
+vier Fällen \DescRef{\LabelBase.pagestyle.plain}\IndexPagestyle{plain}. Die
+Bedeutung der einzelnen Makros entnehmen Sie bitte
+\autoref{tab:specialpagestyles}.
%
\begin{table}
\centering
@@ -1018,22 +1061,24 @@ Die Seitenstile können mit Hilfe von \Macro{renewcommand} umdefiniert
werden.
\begin{Example}
Angenommen, Sie wollen nicht, dass die Seiten mit der
- \DescRef{\LabelBase.cmd.part}-Überschrift mit einer Nummer versehen werden. Dann setzen Sie
- folgende Anweisung beispielsweise in der Präambel Ihres Dokuments:
+ \DescRef{\LabelBase.cmd.part}-Überschrift mit einer Nummer versehen
+ werden. Dann setzen Sie folgende Anweisung beispielsweise in der Präambel
+ Ihres Dokuments:
\begin{lstcode}
\renewcommand*{\partpagestyle}{empty}
\end{lstcode}
Wie Sie auf \DescPageRef{\LabelBase.pagestyle.empty} erfahren haben, ist
- der Seitenstil \PValue{empty} genau das, was in diesem Beispiel verlangt
- wird. Natürlich können Sie auch einen selbst definierten Seitenstil
- verwenden.
+ der Seitenstil \DescRef{\LabelBase.pagestyle.empty}\IndexPagestyle{empty}
+ genau das, was in diesem Beispiel verlangt wird. Natürlich können Sie auch
+ einen selbst definierten Seitenstil verwenden.
- Angenommen, Sie haben mit dem Paket \Package{scrlayer-scrpage} (siehe
+ Angenommen, Sie haben mit dem Paket
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} (siehe
\autoref{cha:scrlayer-scrpage}) einen eigenen Seitenstil für
Kapitelanfangsseiten\Index{Kapitel>Seitenstil}%
\textnote{Kapitel\-anfangs\-seiten}
definiert. Diesem Seitenstil haben Sie den passenden Namen \PValue{chapter}
- gegeben. Um diesen auch tatsächlich zu verwenden, definieren Sie
+ gegeben. Um ihn auch tatsächlich zu verwenden, definieren Sie
\Macro{chapterpagestyle} entsprechend um:
\begin{lstcode}
\renewcommand*{\chapterpagestyle}{chapter}
@@ -1042,7 +1087,7 @@ werden.
Angenommen, Sie wollen das
Inhaltsverzeichnis\Index{Inhaltsverzeichnis}\textnote{Inhaltsverzeichnis}
eines Buches insgesamt nicht mit Seitenzahlen versehen. Danach soll aber
- wieder mit dem Seitenstil \PageStyle{headings} gearbeitet werden, sowie mit
+ wieder mit dem Seitenstil \PageStyle{headings} gearbeitet werden sowie mit
\PageStyle{plain} auf den Kapitelanfangsseiten. Dann verwenden Sie
beispielsweise:
\begin{lstcode}
@@ -1071,6 +1116,19 @@ werden.
Gliederungsüberschrift in eine Gruppe packen sollten. Anderenfalls können
Anweisungen wie \Macro{label} rasch zu unvorhergesehenen Ergebnissen
führen.
+
+ Auf \DescPageRef{tocbasic.cmd.AfterTOCHead} in \autoref{sec:tocbasic.toc}
+ werden Sie die Anweisung \DescRef{tocbasic.cmd.AfterTOCHead} kennenlernen,
+ mit der eine Lösung noch einfacher ist:
+\begin{lstcode}
+ \AfterTOCHead[toc]{%
+ \thispagestyle{empty}%
+ \pagestyle{empty}%
+ }
+\end{lstcode}%
+ Hierbei wird die Tatsache ausgenutzt. dass bei mehreren
+ \DescRef{\LabelBase.cmd.thispagestyle}-Anweisungen auf derselben Seite immer
+ die letzte gewinnt.
\end{Example}
\begin{Explain}
@@ -1079,9 +1137,13 @@ werden.
\begin{lstcode}
\renewcommand*{\chapterpagestyle}{headings}
\end{lstcode}
- verwendet, sollte in \autoref{sec:maincls-experts.addInfos},
+ verwendet, sollte in \autoref{sec:maincls-experts.addInfos} auf
\DescPageRef{maincls-experts.cmd.rightmark} Näheres über die
- Hintergründe zu \Macro{rightmark} nachlesen.
+ Hintergründe zu \DescRef{maincls-experts.cmd.rightmark} nachlesen. Auch die
+ Ausführungen zu \DescRef{scrlayer-scrpage-experts.cmd.rightfirstmark} ab
+ Seite \DescPageRef{scrlayer-scrpage-experts.cmd.rightfirstmark} in
+ \autoref{cha:scrlayer-scrpage-experts}, \autoref{part:forExperts} können
+ hierzu wichtige Informationen liefern.%
\end{Explain}
%
\EndIndexGroup
@@ -1098,14 +1160,12 @@ Anweisung des \LaTeX-Kerns. Sie wird verwendet, um den
Die Umschaltung gilt ab sofort, also ab der Seite, auf der diese Anweisung
aufgerufen wird. Gegebenenfalls sollte also zuvor mit
-\DescRef{\LabelBase.cmd.clearpage} oder
-\DescRef{\LabelBase.cmd.cleardoublepage} diese Seite erst beendet
-werden. Mögliche Angaben für den \PName{Nummerierungsstil} sind
-\autoref{tab:numberKind} zu entnehmen.
-
-Der\textnote{Achtung!} Aufruf von \Macro{pagenumbering} setzt immer die
-Seitenzahl\Index{Seiten>Zahl} zurück. Die aktuelle Seite bekommt also die
-Nummer 1 im gewählten \PName{Nummerierungsstil}.
+\DescRef{\LabelBase.cmd.clearpage} oder besser
+\DescRef{\LabelBase.cmd.cleardoubleoddpage}%
+\important{\DescRef{\LabelBase.cmd.cleardoubleoddpage}}%
+\IndexCmd{cleardoubleoddpage} diese Seite erst beendet werden. Mögliche
+Angaben für den \PName{Nummerierungsstil} sind \autoref{tab:numberKind} zu
+entnehmen.
%
\begin{table}
% \centering
@@ -1130,7 +1190,98 @@ Nummer 1 im gewählten \PName{Nummerierungsstil}.
\end{tabular}
\end{captionbeside}
\end{table}
-%
+
+Der\textnote{Achtung!} Aufruf von \Macro{pagenumbering} setzt immer die
+Seitenzahl\Index{Seiten>Zahl} zurück. Die aktuelle Seite bekommt also die
+Nummer 1 im gewählten \PName{Nummerierungsstil}. Damit bei doppelseitigen
+Dokumenten diese neue Seite auch wirklich auf eine gerade Seite folgt, die
+linke Seite also nicht etwa fehlt, sollte man daher vor \Macro{pagenumbering}
+immer \DescRef{\LabelBase.cmd.cleardoubleoddpage}%
+\important{\DescRef{\LabelBase.cmd.cleardoubleoddpage}}%
+\IndexCmd{cleardoubleoddpage} einfügen. Näheres zu einer dabei gegebenenfalls
+eingefügten Vakatseite erfahren Sie im nächsten Abschnitt.
+
+\begin{Explain}
+ Lassen Sie mich noch ein Wort zu einem häufigen Fehler verlieren, den man in
+ diversen Vorlagen findet, die im Internet kursieren. Wenn Sie -- natürlich
+ ohne den Eingangskommentar -- auf Zeilen wie:
+\begin{lstcode}
+ % Achtung dieses Beispiel enthält Fehler!
+ % Beachten Sie bitte die Erklärungen im Text!
+ \tableofcontents
+ \pagenumbering{arabic}
+ \setcounter{page}{1}
+\end{lstcode}
+ stoßen, so ist das ein untrügliches Zeichen dafür, dass der Ersteller dieser
+ Vorlage obige Ausführungen nicht gelesen oder nicht verstanden hat. Da
+ \DescRef{\LabelBase.cmd.tableofcontents} das Inhaltsverzeichnis zwar
+ ausgibt, aber die letzte Seite nicht automatisch beendet, wird bereits für
+ diese letzte Seite des Inhaltsverzeichnisses die Seitennummerierung
+ umgeschaltet. Sie erhält damit die arabische Seitenzahl 1. Es fehlt also
+ \DescRef{\LabelBase.cmd.cleardoubleoddpage} vor
+ \Macro{pagenumbering}. Ebenso ist die letzte Zeile mit dem Setzen der
+ Seitennummerierung auf 1 überflüssig, da dies bereits von
+ \Macro{pagenumbering} erledigt wird.
+
+ Teilweise findet man -- natürlich ohne den Eingangskommentar -- auch:
+\begin{lstcode}
+ % Achtung dieses Beispiel enthält Fehler!
+ % Beachten Sie bitte die Erklärungen im Text!
+ \tableofcontents
+ \pagebreak
+ \pagenumbering{arabic}
+ \setcounter{page}{1}
+\end{lstcode}
+ Hier hat der Ersteller versucht, das Problem mit der letzten Seite des
+ Inhaltsverzeichnisses mit Hilfe von \Macro{pagebreak}\IndexCmd{pagebreak} zu
+ lösen.
+
+ Diese Lösung ist aber leider auch nicht viel besser. Hier wird die letzte
+ Seite des Inhaltsverzeichnisses auf die nächste Seite umbrochen. Damit
+ werden bei einem doppelseitigen Dokument unter Umständen die Einträge auf
+ der letzten Seite mit einem erhöhten vertikalen Abstand gesetzt (siehe
+ \DescRef{\LabelBase.cmd.flushbottom} auf
+ \DescPageRef{\LabelBase.cmd.flushbottom}). \Macro{pagebreak} ist hier
+ eindeutig die falsche Anweisung.
+
+ Aber auch \Macro{newpage}\IndexCmd{newpage} oder
+ \DescRef{\LabelBase.cmd.clearpage} würden bei einem doppelseitigen Dokument
+ nicht genügen. Hätte die letzte Seite des Inhaltsverzeichnisses
+ beispielsweise die römische Nummer vii, so würde auf die römisch nummerierte
+ rechte Seite nun unmittelbar die arabisch nummerierte rechte Seite 1
+ folgen. Eine linke Seite zwischen diesen beiden Seiten würde im Dokument
+ fehlen, was beim späteren Druck erhebliche Probleme bereiten könnte.
+
+ Mein Rat: Vermeiden Sie die Verwendung von Vorlagen, die bereits in solch
+ einfachen Dingen Fehler enthalten. Korrekt wäre übrigens:
+\begin{lstcode}
+ \tableofcontents
+ \cleardoubleoddpage
+ \pagenumbering{arabic}
+\end{lstcode}
+ Das gilt auch, wenn mit \Class{scrartcl}\OnlyAt{\Class{scrartcl}} eine
+ Klasse verwendet wird, bei der üblicherweise nach dem Inhaltsverzeichnis
+ keine neue Seite begonnen wird. Schaltet man die Seitennummerierung um, so
+ muss eine neue rechte Seite begonnen werden. Wollen Sie eine solche
+ Umschaltung nicht, so sollten Sie den Nummerierungsstil der Seiten über das
+ gesamte Dokument konsequent durchhalten, ohne ihn zwischendurch zu
+ ändern.
+\iffalse% Umbruchkorrekturtext
+ Bei Artikeln oder anderen kurzen Dokumenten ist das generell zu
+ empfehlen.
+\fi
+
+ Einfacher wird die Änderung des Nummerierungsstils bei Verwendung von
+ \Class{scrbook}\OnlyAt{\Class{scrbook}}. Dort werden Sie durch
+ die beiden Anweisungen \DescRef{\LabelBase.cmd.frontmatter}%
+ \important{\DescRef{\LabelBase.cmd.frontmatter}\\
+ \DescRef{\LabelBase.cmd.mainmatter}}%
+ \IndexCmd{fontmatter} und \DescRef{\LabelBase.cmd.mainmatter}%
+ \IndexCmd{mainmatter} bei der am häufigsten verwendeten Umschaltung
+ unterstützt. Nähere Informationen entnehmen Sie bitte
+ \autoref{sec:maincls.separation}, ab
+ \DescPageRef{\LabelBase.cmd.mainmatter}.%
+\end{Explain}%
\EndIndexGroup
\EndIndexGroup
@@ -1204,7 +1355,8 @@ nur das Stichwortverzeichnis\Index{Stichwortverzeichnis} gesetzt. Manchmal
erscheint der gesamte Anhang im Nachspann. Der Nachspann gleicht bezüglich der
Gliederungsüberschriften dem Vorspann. Eine getrennte Seitennummerierung ist
jedoch nicht vorgesehen. Falls Sie dies ebenfalls benötigen, bedienen Sie sich
-bitte der Anweisung \DescRef{\LabelBase.cmd.pagenumbering} aus
+bitte der Anweisung \DescRef{\LabelBase.cmd.pagenumbering}%
+\important{\DescRef{\LabelBase.cmd.pagenumbering}} aus
\autoref{sec:\LabelBase.pagestyle},
\DescPageRef{\LabelBase.cmd.pagenumbering}.%
%
@@ -1232,14 +1384,15 @@ bei \Class{scrbook} neue Kapitel auf der nächsten rechten Seite. Dies
entspricht der \PName{Methode} \PValue{right} und ist bei den meisten Büchern
üblich. In einigen Fällen sollen neue Kapitel jedoch auf der linken Seite
einer kompletten Doppelseite beginnen. Dies entspricht der \PName{Methode}
-\PValue{left}\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}}. Eine
-Zusammenfassung der möglichen Werte findet sich noch einmal in
-\autoref{tab:maincls.open}. Dabei sind auch die Auswirkungen auf die
-Anweisungen \DescRef{\LabelBase.cmd.cleardoublepage},
+\PValue{left}\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}}.
+Eine Zusammenfassung der möglichen Werte findet sich in
+\autoref{tab:maincls.open}. Dabei sind auch die Auswirkungen auf
+\DescRef{\LabelBase.cmd.cleardoublepage} sowie
+% die vier \KOMAScript"=Anweisungen
\DescRef{\LabelBase.cmd.cleardoublepageusingstyle},
\DescRef{\LabelBase.cmd.cleardoublestandardpage},
-\DescRef{\LabelBase.cmd.cleardoubleplainpage} und
-\DescRef{\LabelBase.cmd.cleardoubleemptypage} (siehe
+\DescRef{\LabelBase.cmd.cleardoubleplainpage} und die letzte der betroffenen
+Anweisungen, \DescRef{\LabelBase.cmd.cleardoubleemptypage}, (siehe
\autoref{sec:\LabelBase.emptypage},
\DescPageRef{\LabelBase.cmd.cleardoublepage}) angegeben.
@@ -1251,7 +1404,7 @@ Anweisungen \DescRef{\LabelBase.cmd.cleardoublepage},
\pventry{any}{%
Teile, Kapitel, Index und Nachspann verwenden
\DescRef{\LabelBase.cmd.clearpage}, aber nicht
- \DescRef{\LabelBase.cmd.cleardoublepage}; %
+ \DescRef{\LabelBase.cmd.cleardoublepage};\newline die Anweisungen
\DescRef{\LabelBase.cmd.cleardoublepageusingstyle},
\DescRef{\LabelBase.cmd.cleardoublestandardpage},
\DescRef{\LabelBase.cmd.cleardoubleplainpage},
@@ -1261,26 +1414,26 @@ Anweisungen \DescRef{\LabelBase.cmd.cleardoublepage},
}%
\pventry{left}{%
Teile, Kapitel, Index und Nachspann verwenden
- \DescRef{\LabelBase.cmd.cleardoublepage}; %
+ \DescRef{\LabelBase.cmd.cleardoublepage};\newline die Anweisungen
\DescRef{\LabelBase.cmd.cleardoublepageusingstyle},
\DescRef{\LabelBase.cmd.cleardoublestandardpage},
\DescRef{\LabelBase.cmd.cleardoubleplainpage},
\DescRef{\LabelBase.cmd.cleardoubleemptypage} und
\DescRef{\LabelBase.cmd.cleardoublepage} erzeugen einen Seitenumbruch
- und fügen ggf. eine Vakatseite\Index{Vakatseite} ein, um im
+ und fügen gegebenenfalls eine Vakatseite\Index{Vakatseite} ein, um im
doppelseitigen Satz auf die nächste linke Seite zu gelangen.%
- \IndexOption{open~=\PValue{left}}}%
+ \IndexOption{open~=\textKValue{left}}}%
\pventry{right}{%
Teile, Kapitel, Index und Nachspann verwenden
- \DescRef{\LabelBase.cmd.cleardoublepage}; %
+ \DescRef{\LabelBase.cmd.cleardoublepage};\newline die Anweisungen
\DescRef{\LabelBase.cmd.cleardoublepageusingstyle},
\DescRef{\LabelBase.cmd.cleardoublestandardpage},
\DescRef{\LabelBase.cmd.cleardoubleplainpage},
\DescRef{\LabelBase.cmd.cleardoubleemptypage} und
\DescRef{\LabelBase.cmd.cleardoublepage} erzeugen einen Seitenumbruch
- und fügen ggf. eine Vakatseite ein, um im doppelseitigen Satz auf die
- nächste rechte Seite zu gelangen.%
- \IndexOption{open~=\PValue{right}}}%
+ und fügen gegebenenfalls eine Vakatseite ein, um im doppelseitigen Satz
+ auf die nächste rechte Seite zu gelangen.%
+ \IndexOption{open~=\textKValue{right}}}%
\end{desctabular}
\label{tab:maincls.open}
\end{table}
@@ -1305,13 +1458,14 @@ Bei\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} den Standardklassen
in einer Zeile »Kapitel«\iffree{\footnote{Bei Verwendung einer anderen Sprache
als Deutsch wird »Kapitel« selbstverständlich in der jeweiligen Sprache
gesetzt.}}{\footnote{Die Ausgabe erfolgt tatsächlich in der aktuell
- aktiven Sprache.}} %
+ aktiven Sprache.}}, %
gefolgt von der Kapitelnummer steht. Erst ab der nächsten Zeile wird dann die
Überschrift in linksbündigem Flattersatz ausgegeben. Bei {\KOMAScript} kann
dieses Verhalten mit der Klassenoption \Option{chapterprefix} ebenfalls
erreicht werden. Als \PName{Ein-Aus-Wert} kann einer der Standardwerte für
einfache Schalter aus \autoref{tab:truefalseswitch},
-\autopageref{tab:truefalseswitch} verwendet werden. Voreingestellt ist
+\autopageref{tab:truefalseswitch} verwendet werden.
+Voreingestellt\textnote{\KOMAScript{} vs. Standardklassen} ist
\OptionValue{chapterprefix}{false}, während das
Verhalten\important{\Option{chapterprefix}} der Standardklassen
\OptionValue{chapterprefix}{true} entspricht. Die Optionen wirken sich
@@ -1323,7 +1477,7 @@ Zuweilen kommt es vor, dass man die Kapitelüberschriften im Hauptteil durchaus
in der einfachen Form von \OptionValue{chapterprefix}{false} setzen
möchte. Gleichzeitig\important{\Option{appendixprefix}} sollen die
Überschriften im Anhang\Index{Anhang} jedoch davon abweichend mit einer
-Präfixzeile, »Anhang« gefolgt vom Buchstaben des Anhangs, versehen
+Präfixzeile --~»Anhang«, gefolgt vom Buchstaben des Anhangs~-- versehen
werden. Dies ist mit der Einstellung \OptionValue{appendixprefix}{true}
möglich. Da sich jedoch dadurch ein inkonsistentes Layout ergibt, rate ich von
der Verwendung ab. Letztlich führt die Option dazu, dass
@@ -1335,7 +1489,7 @@ Mit der Anweisung
für die Präfixzeile ausführen. Ist \Option{chapterprefix} aktiv, so wird der
\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}.
-\BeginIndex{FontElement}{chapterprefix}\LabelFontElement{chapterprefix}%
+\BeginIndex{FontElement}{chapterprefix}%
Die Schriftart der Kapitelnummernzeile bei \OptionValue{chapterprefix}{true}
oder \OptionValue{appendixprefix}{true} kann mit den beiden Anweisungen
\DescRef{\LabelBase.cmd.setkomafont} und
@@ -1347,8 +1501,13 @@ werden. Voreingestellt ist die Verwendung des Elements
\DescRef{\LabelBase.fontelement.chapter}\IndexFontElement{chapter} (siehe
\DescPageRef{\LabelBase.cmd.chapter}, sowie
\autoref{tab:maincls.structureElementsFont},
-\autopageref{tab:maincls.structureElementsFont}).%
-%
+\autopageref{tab:maincls.structureElementsFont}).
+
+Weitere Einstellmöglichkeiten für Kapitelüberschriften sind den Erklärungen
+zu \DescRef{maincls-experts.cmd.RedeclareSectionCommand} sowie den Anweisungen
+\DescRef{maincls-experts.cmd.chapterlineswithprefixformat} und
+\DescRef{maincls-experts.cmd.chapterlinesformat} in
+\autoref{sec:maincls-experts.experts}, \autoref{part:forExperts} zu entnehmen.%
\EndIndexGroup
@@ -1359,14 +1518,14 @@ Die Überschriften\index{Ueberschriften=Überschriften} werden sowohl bei den
Standardklassen als auch bei {\KOMAScript} normalerweise recht groß
gesetzt. Dies gefällt nicht jedem und wirkt insbesondere bei kleinen
Papiergrößen oft störend. Daher stehen bei {\KOMAScript} neben den mit der
-Option \OptionValue{headings}{big}\IndexOption{headings~=\PValue{big}}%
+Option \OptionValue{headings}{big}\IndexOption{headings~=\textKValue{big}}%
\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
-\important[i]{\OptionValue{headings}{big}\\
+\important{\OptionValue{headings}{big}\\
\OptionValue{headings}{normal}\\
\OptionValue{headings}{small}} sehr groß voreingestellten Überschriften die
beiden Möglichkeiten
-\OptionValue{headings}{normal}\IndexOption{headings~=\PValue{normal}} und
-\OptionValue{headings}{small}\IndexOption{headings~=\PValue{small}} zur
+\OptionValue{headings}{normal}\IndexOption{headings~=\textKValue{normal}} und
+\OptionValue{headings}{small}\IndexOption{headings~=\textKValue{small}} zur
Verfügung, mit denen man insgesamt kleinere Überschriften erhält. Die aus den
Optionen resultierenden Schriftgrößen sind für die Überschriften der Klassen
\Class{scrbook} und \Class{scrreprt}
@@ -1384,42 +1543,57 @@ generell etwas kleinere Überschriften verwendet. \OnlyAt{\Class{scrbook}\and
\Class{scrreprt}}Die Abstände vor und nach Kapitelüberschriften werden von
diesen Optionen ebenfalls neu definiert.
-\iffalse
-Auf Kapitelüberschriften wirkt sich außerdem die Option
-\Option{headings} mit den Einstellungen \PValue{twolinechapter} oder
-\PValue{onelinechapter} aus, die den oben erklärten Optionen
+\iffalse%
+Auf Kapitelüberschriften wirkt sich außerdem die Option \Option{headings} mit
+den Einstellungen \PValue{twolinechapter} oder \PValue{onelinechapter} aus,
+die den oben erklärten Optionen
\OptionValueRef{\LabelBase}{chapterprefix}{true} und
-\OptionValueRef{\LabelBase}{chapterprefix}{false}
-entsprechen. Im Anhang gibt es zusätzlich Auswirkungen durch die
-Einstellungen \PValue{onelineappendix} und \PValue{twolineappendix} für Option
-\Option{headings}, was dann \OptionValueRef{\LabelBase}{appendixprefix}{false}
-und \OptionValueRef{\LabelBase}{appendixprefix}{true} entspricht (siehe
-ebenfalls oben).
-\else
-Auf\important[i]{\begin{tabular}[t]{@{}l@{}}
- \Option{headings=}\\ \quad\PValue{twolinechapter}\end{tabular}\\
- \begin{tabular}[t]{@{}l@{}}
- \Option{headings=}\\ \quad\PValue{onelinechapter}\end{tabular}\\
- \begin{tabular}[t]{@{}l@{}}
- \Option{headings=}\\ \quad\PValue{twolineappendix}\end{tabular}}
-Kapitelüberschriften wirken sich außerdem die Optionen
-\OptionValue{headings}{twolinechapter} und
-\OptionValue{headings}{onelinechapter}, was
+\OptionValueRef{\LabelBase}{chapterprefix}{false} entsprechen. Im Anhang gibt
+es zusätzlich Auswirkungen durch die Einstellungen \PValue{onelineappendix}
+und \PValue{twolineappendix} für Option \Option{headings}, was dann
+\OptionValueRef{\LabelBase}{appendixprefix}{false} und
+\OptionValueRef{\LabelBase}{appendixprefix}{true} entspricht (siehe ebenfalls
+oben). \else%
+Auf Kapitelüberschriften\OnlyAt{\Class{scrbook}\and\Class{scrreprt}} wirken
+sich\important{%
+ \OptionValue{headings}{twolinechapter}\\
+ \OptionValue{headings}{onelinechapter}\\
+ \OptionValue{headings}{twolineappendix}\\
+ \OptionValue{headings}{onelineappendix}%
+} außerdem die beiden Optionen \OptionValue{headings}{twolinechapter} und
+\OptionValue{headings}{onelinechapter}, die den oben erklärten
\OptionValueRef{\LabelBase}{chapterprefix}{true} und
-\OptionValueRef{\LabelBase}{chapterprefix}{false}
-entspricht (siehe oben) aus. Für den Anhang stehen
+\OptionValueRef{\LabelBase}{chapterprefix}{false} entsprechen, aus. Für den
+Anhang stehen als Alternativen zu
+\OptionValueRef{\LabelBase}{appendixprefix}{true} und
+\OptionValueRef{\LabelBase}{appendixprefix}{false} die Optionen
\OptionValue{headings}{twolineappendix} und
-\OptionValue{headings}{onelineappendix}\important[i]{%
- \begin{tabular}[b]{@{}l@{}}
- \Option{headings=}\\ \quad\PValue{onelineappendix}
- \end{tabular}} zur Verfügung, die den Optionen
+\OptionValue{headings}{onelineappendix} zur Verfügung. \iffalse Für den
+Anhang stehen \OptionValue{headings}{twolineappendix} und
+\OptionValue{headings}{onelineappendix} zur Verfügung, die den Optionen
\OptionValueRef{\LabelBase}{appendixprefix}{true} und
-\OptionValueRef{\LabelBase}{appendixprefix}{false}
-entspricht (siehe ebenfalls oben).
+\OptionValueRef{\LabelBase}{appendixprefix}{false} entsprechen (siehe
+ebenfalls oben). \fi Diese existieren natürlich nicht bei \Class{scrartcl}%
+\iffree{}{% Umbruchkorrekturtext
+ , da diese Klasse nicht über Kapitel verfügt}%
+.%
\fi
+Option\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} \OptionValue{headings}{standardclasses}%
+\important{\OptionValue{headings}{standardclasses}} passt zum Einen die
+Schriftgrößen der Überschriften an die der Standardklassen an. Des Weiteren
+wird die Schrift für Element
+\DescRef{\LabelBase.fontelement.disposition}\IndexFontElement{disposition} auf
+\Macro{bfseries} gesetzt. Es wird also für Überschriften nicht mehr auf einen
+serifenlosen Font umgeschaltet. Bei Verwendung von
+\Class{scrbook}\OnlyAt{\Class{scrbook}\and\Class{scrreprt}} oder
+\Class{scrreprt} wird außerdem \OptionValue{headings}{twolinechapter} gesetzt
+und die Abstände bei den Kapitelüberschriften werden denen der Standardklassen
+angepasst.
+
Für\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} Kapitel kann mit
-\OptionValue{headings}{openany}\important[i]{%
+\OptionValue{headings}{openany}\important{%
\OptionValue{headings}{openany}\\
\OptionValue{headings}{openright}\\
\OptionValue{headings}{openleft}}, \OptionValue{headings}{openright} und
@@ -1432,17 +1606,15 @@ Eine\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
Behandlung des optionalen
Arguments der Gliederungsbefehle. Sowohl dessen
Funktion%
-\important[i]{\begin{tabular}[t]{@{}l@{}}
- \Option{headings=}\\\quad\PValue{optiontohead}\end{tabular}\\
+\important{\OptionValue{headings}{optiontohead}\\
\OptionValue{headings}{optiontotoc}\\
- \begin{tabular}[t]{@{}l@{}}
- \Option{headings=}\\\quad\PValue{optiontoheadandtoc}\end{tabular}} als
+ \OptionValue{headings}{optiontoheadandtoc}} als
auch dessen Bedeutung kann durch die Einstellungen
\OptionValue{headings}{optiontohead}%
-\IndexOption{headings~=\PValue{optiontohead}},
-\OptionValue{headings}{optiontotoc}\IndexOption{headings~=\PValue{optiontotoc}}
+\IndexOption{headings~=\textKValue{optiontohead}},
+\OptionValue{headings}{optiontotoc}\IndexOption{headings~=\textKValue{optiontotoc}}
und \OptionValue{headings}{optiontoheadandtoc}%
-\IndexOption{headings~=\PValue{optiontoheadandtoc}}
+\IndexOption{headings~=\textKValue{optiontoheadandtoc}}
beeinflusst werden.
Eine Zusammenfassung der möglichen Einstellungen für Option \Option{headings}
@@ -1461,60 +1633,62 @@ der Gliederungsbefehle enthalten.
Setzt die Schrifteinstellung für die einzelnen Standard-Gliederungsebenen
zurück und verwendet große Überschriften mit großen Abständen darüber und
darunter.%
- \IndexOption{headings~=\PValue{big}}}%
+ \IndexOption{headings~=\textKValue{big}}}%
\pventry{normal}{%
Setzt die Schrifteinstellung für die einzelnen Standard-Gliederungsebenen
zurück und verwendet mittelgroße Überschriften mit mittelgroßen Abständen
darüber und darunter.%
- \IndexOption{headings~=\PValue{normal}}}%
+ \IndexOption{headings~=\textKValue{normal}}}%
\entry{\PValue{onelineappendix}, \PValue{noappendixprefix},
\PValue{appendixwithoutprefix}, \PValue{appendixwithoutprefixline}%
- \IndexOption{headings~=\PValue{onelineappendix}}}{%
+ \IndexOption{headings~=\textKValue{onelineappendix}}}{%
Kapitelüberschriften im Anhang werden wie andere Überschriften auch
gesetzt.}%
\entry{\PValue{onelinechapter}, \PValue{nochapterprefix},
\PValue{chapterwithoutprefix}, \PValue{chapterwithoutprefixline}%
- \IndexOption{headings~=\PValue{onelinechapter}}}{%
+ \IndexOption{headings~=\textKValue{onelinechapter}}}{%
Kapitelüberschriften werden wie andere Überschriften auch gesetzt.}%
\pventry{openany}{%
- Für die Anweisungen \DescRef{\LabelBase.cmd.cleardoublepageusingstyle},
+ Die Anweisungen \DescRef{\LabelBase.cmd.cleardoublepageusingstyle},
\DescRef{\LabelBase.cmd.cleardoublestandardpage},
\DescRef{\LabelBase.cmd.cleardoubleplainpage},
\DescRef{\LabelBase.cmd.cleardoubleemptypage} und
- \DescRef{\LabelBase.cmd.cleardoublepage} entspricht dies
- \OptionValue{headings}{openright}. Teile, Kapitel, Index und Nachspann
+ \DescRef{\LabelBase.cmd.cleardoublepage} erzeugen einen Seitenumbruch und
+ fügen gegebenenfalls eine Vakatseite\Index{Vakatseite} ein, um im
+ doppelseitigen Satz wie bei \OptionValue{headings}{openright} auf die
+ nächste rechte Seite zu gelangen. Teile, Kapitel, Index und Nachspann
verwenden \DescRef{\LabelBase.cmd.clearpage}, aber nicht
\DescRef{\LabelBase.cmd.cleardoublepage}.%
- \IndexOption{headings~=\PValue{openany}}}%
+ \IndexOption{headings~=\textKValue{openany}}}%
\pventry{openleft}{%
Die Anweisungen \DescRef{\LabelBase.cmd.cleardoublepageusingstyle},
\DescRef{\LabelBase.cmd.cleardoublestandardpage},
\DescRef{\LabelBase.cmd.cleardoubleplainpage},
\DescRef{\LabelBase.cmd.cleardoubleemptypage} und
\DescRef{\LabelBase.cmd.cleardoublepage} erzeugen einen Seitenumbruch und
- fügen ggf. eine Vakatseite\Index{Vakatseite} ein, um im doppelseitigen
+ fügen gegebenenfalls eine Vakatseite\Index{Vakatseite} ein, um im doppelseitigen
Satz auf die nächste linke Seite zu gelangen. Teile, Kapitel, Index und
Nachspann verwenden \DescRef{\LabelBase.cmd.cleardoublepage}.%
- \IndexOption{headings~=\PValue{openleft}}}%
+ \IndexOption{headings~=\textKValue{openleft}}}%
\pventry{openright}{%
Die Anweisungen \DescRef{\LabelBase.cmd.cleardoublepageusingstyle},
\DescRef{\LabelBase.cmd.cleardoublestandardpage},
\DescRef{\LabelBase.cmd.cleardoubleplainpage},
\DescRef{\LabelBase.cmd.cleardoubleemptypage} und
\DescRef{\LabelBase.cmd.cleardoublepage} erzeugen einen Seitenumbruch und
- fügen ggf. eine Vakatseite\Index{Vakatseite} ein, um im doppelseitigen
+ fügen gegebenenfalls eine Vakatseite\Index{Vakatseite} ein, um im doppelseitigen
Satz auf die nächste rechte Seite zu gelangen. Teile, Kapitel, Index und
Nachspann verwenden \DescRef{\LabelBase.cmd.cleardoublepage}.%
- \IndexOption{headings~=\PValue{openright}}}%
+ \IndexOption{headings~=\textKValue{openright}}}%
\pventry{optiontohead}{%
Die\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} erweiterte Funktion des optionalen Arguments der
Gliederungsbefehle wird aktiviert. In der Voreinstellung wird das
optionale Argument ausschließlich für den Kolumnentitel verwendet.%
- \IndexOption{headings~=\PValue{optiontohead}}%
+ \IndexOption{headings~=\textKValue{optiontohead}}%
}%
\entry{\PValue{optiontoheadandtoc}, \PValue{optiontotocandhead}%
- \IndexOption{headings~=\PValue{optiontoheadandtoc}}}{%
+ \IndexOption{headings~=\textKValue{optiontoheadandtoc}}}{%
Die\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} erweiterte Funktion des optionalen Arguments der
Gliederungsbefehle wird aktiviert. In der Voreinstellung wird das
@@ -1527,24 +1701,33 @@ der Gliederungsbefehle enthalten.
Gliederungsbefehle wird aktiviert. In der Voreinstellung wird das
optionale Argument ausschließlich für den Eintrag ins Inhaltsverzeichnis
verwendet.%
- \IndexOption{headings~=\PValue{optiontohead}}%
+ \IndexOption{headings~=\textKValue{optiontohead}}%
}%
\pventry{small}{%
Setzt die Schrifteinstellung für die einzelnen Standard-Gliederungsebenen
zurück und verwendet kleine Überschriften mit kleinen Abständen darüber
und darunter.%
- \IndexOption{headings~=\PValue{small}}}%
+ \IndexOption{headings~=\textKValue{small}}}%
+ \pventry{standardclasses}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}}%
+ Setzt die Schrifteinstellung für die einzelnen Standard-Gliederungsebenen
+ zurück und verwendet Überschriften in den Größen der Standardklassen. Für
+ Kapitelüberschriften wird bei \Class{scrbook} und \Class{scrreprt}
+ \OptionValue{headings}{twolinechapter} gesetzt.%
+ }%
\entry{\PValue{twolineappendix}, \PValue{appendixprefix},
\PValue{appendixwithprefix}, \PValue{appendixwithprefixline}%
- \IndexOption{headings~=\PValue{twolineappendix}}}{%
+ \IndexOption{headings~=\textKValue{twolineappendix}}}{%
Kapitelüberschriften im Anhang werden mit einer Vorsatzzeile gesetzt,
- deren Inhalt von \DescRef{\LabelBase.cmd.chapterformat}\IndexCmd{chapterformat} bestimmt
+ deren Inhalt von
+ \DescRef{\LabelBase.cmd.chapterformat}\IndexCmd{chapterformat} bestimmt
wird.}%
\entry{\PValue{twolinechapter}, \PValue{chapterprefix},
\PValue{chapterwithprefix}, \PValue{chapterwithprefixline}%
- \IndexOption{headings~=\PValue{twolinechapter}}}{%
+ \IndexOption{headings~=\textKValue{twolinechapter}}}{%
Kapitelüberschriften werden mit einer Vorsatzzeile gesetzt, deren Inhalt
- von \DescRef{\LabelBase.cmd.chapterformat}\IndexCmd{chapterformat} bestimmt wird.}%
+ von \DescRef{\LabelBase.cmd.chapterformat}\IndexCmd{chapterformat}
+ bestimmt wird.}%
\end{desclist}
%
\EndIndexGroup
@@ -1568,12 +1751,12 @@ gespeichert und wirkt sich dann beim nächsten \LaTeX-Lauf auf das gesamte
Dokument aus.
Manchmal versagt der mit \OptionValue{numbers}{autoendperiod}%
-\IndexOption{numbers~=\PValue{autoendperiod}} voreingestellte Automatismus zum
+\IndexOption{numbers~=\textKValue{autoendperiod}} voreingestellte Automatismus zum
Setzen oder Weglassen des abschließenden Punktes in der
Gliederungsnummer. Teilweise sehen andere Sprachen auch andere Regeln
vor. Deshalb ist es beispielsweise mit der Einstellung
-\OptionValue{numbers}{endperiod}\IndexOption{numbers~=\PValue{endperiod}}%
-\important[i]{\OptionValue{numbers}{endperiod}\\
+\OptionValue{numbers}{endperiod}\IndexOption{numbers~=\textKValue{endperiod}}%
+\important{\OptionValue{numbers}{endperiod}\\
\OptionValue{numbers}{noendperiod}} möglich, den Punkt manuell
vorzuschreiben oder mit \OptionValue{numbers}{noendperiod} zu verbieten.
@@ -1602,17 +1785,17 @@ also vor \Macro{begin}\PParameter{document} vorgenommen werden.
ein Buchstabe oder eine römische Zahl entdeckt, so wird der Punkt bei
allen Nummern gesetzt. Referenzen auf diese Nummern werden jedoch ohne
abschließenden Punkt gesetzt.%
- \IndexOption{numbers~=\PValue{autoendperiod}}}%
+ \IndexOption{numbers~=\textKValue{autoendperiod}}}%
\entry{\PValue{endperiod}, \PValue{withendperiod}, \PValue{periodatend},
\PValue{enddot}, \PValue{withenddot}, \PValue{dotatend}}{%
Bei sämtlichen Gliederungsnummern und davon abhängigen Nummern wird am
Ende ein Punkt gesetzt, der bei der Referenzierung entfällt.%
- \IndexOption{numbers~=\PValue{endperiod}}}%
+ \IndexOption{numbers~=\textKValue{endperiod}}}%
\entry{\PValue{noendperiod}, \PValue{noperiodatend},
\PValue{noenddot}, \PValue{nodotatend}}{%
Gliederungsnummern und davon abhängige Nummern werden ohne
abschließenden Punkt gesetzt.%
- \IndexOption{numbers~=\PValue{noendperiod}}}%
+ \IndexOption{numbers~=\textKValue{noendperiod}}}%
\end{desctabular}
\end{table}
%
@@ -1627,25 +1810,31 @@ Wie\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} auch bei der Option
\DescRef{\LabelBase.option.listof} in \autoref{sec:\LabelBase.floats},
\DescPageRef{\LabelBase.option.listof} erwähnt wird, fügt
normalerweise\ChangedAt{v2.96a}{\Class{scrbook}\and \Class{scrreprt}} jeder
-mit \DescRef{\LabelBase.cmd.chapter} erzeugte Kapiteleintrag einen vertikalen Abstand in die
-Verzeichnisse der Gleitumgebungen ein. Seit Version~2.96a gilt dies auch für
-die Anweisung \DescRef{\LabelBase.cmd.addchap}, wenn nicht eine Kompatibilitätseinstellung zu
-einer früheren Version gewählt wurde (siehe Option
-\DescRef{\LabelBase.option.version} in
+mit \DescRef{\LabelBase.cmd.chapter} erzeugte Kapiteleintrag einen vertikalen
+Abstand in die Verzeichnisse der Gleitumgebungen ein. Seit
+Version~2.96a\important{\OptionValueRef{\LabelBase}{version}{2.96a}} gilt dies
+auch für die Anweisung \DescRef{\LabelBase.cmd.addchap}, wenn nicht eine
+Kompatibilitätseinstellung zu einer früheren Version gewählt wurde (siehe
+Option \DescRef{\LabelBase.option.version} in
\autoref{sec:\LabelBase.compatibilityOptions},
\DescPageRef{\LabelBase.option.version}).
Außerdem kann mit der Option \Option{chapteratlists} der Abstand verändert
werden. Dazu gibt man als \PName{Wert} den gewünschten Abstand an. Bei der
Voreinstellung \OptionValueRef{\LabelBase}{listof}{chaptergapsmall}%
-\IndexOption{listof~=\PValue{chaptergapsmall}} sind dies 10\Unit{pt}. Mit der
-Einstellung
-\OptionValue{chapteratlists}{entry}\IndexOption{chapteratlists~=\PValue{entry}}%
+\IndexOption{listof~=\textKValue{chaptergapsmall}} (siehe
+\DescPageRef{\LabelBase.option.listof.chaptergapsmall}) sind dies
+10\Unit{pt}.
+
+Mit der Einstellung \OptionValue{chapteratlists}{entry}%
+\IndexOption{chapteratlists~=\textKValue{entry}}%
\important{\OptionValue{chapteratlists}{entry}} oder bei Verwendung der Form
\Option{chapteratlists} ohne Angabe eines Wertes wird statt des Abstandes der
Kapiteleintrag selbst in die Verzeichnisse eingetragen. Es wird darauf
hingewiesen, dass ein solcher Eintrag auch dann erfolgt, wenn das Kapitel
-keine Gleitumgebung enthält.
+keine Gleitumgebung enthält. Eine Lösung, bei der nur Kapitel mit
+Gleitumgebungen im jeweiligen Verzeichnis angezeigt werden, finden Sie unter
+\cite{https://komascript.de/comment/5070}.
Es ist zu beachten\textnote{Achtung!}, dass sich eine Änderung der
Einstellung je nach Art der Änderung erst nach zwei weiteren \LaTeX-Läufen im
@@ -1674,24 +1863,26 @@ Inhaltsverzeichnis vorgegeben werden.
Mit\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}\textnote{\KOMAScript{} vs. Standardklassen} der
Einstellung\important{\DescRef{\LabelBase.option.headings}}
-\OptionValueRef{\LabelBase}{headings}{optiontohead}\IndexOption[indexmain]{headings~=\PValue{optiontohead}}
-wird das optionale Argument bei \KOMAScript{} hingegen nur noch für den
-Kolumnentitel verwendet. Ein konkreter Eintrag in den Kolumnentitel erfolgt
-natürlich nur, wenn ein Seitenstil\Index{Seiten>Stil} gewählt wird, bei dem
-die entsprechende Gliederungsebene überhaupt für den Kolumnentitel verwendet
-wird. Siehe hierzu \autoref{sec:\LabelBase.pagestyle} sowie
-\autoref{cha:scrlayer-scrpage}. Mit der Einstellung
-\OptionValueRef{\LabelBase}{headings}{optiontotoc}\IndexOption[indexmain]{headings~=\PValue{optiontotoc}}
-wird das optionale Argument hingegen ausschließlich für den Eintrag ins
-Inhaltsverzeichnis verwendet. Auch dies selbstverständlich nur, wenn die
-Einstellung für den Zähler \DescRef{\LabelBase.counter.tocdepth} (siehe
+\OptionValueRef{\LabelBase}{headings}{optiontohead}%
+\IndexOption[indexmain]{headings~=\textKValue{optiontohead}} wird das
+optionale Argument bei \KOMAScript{} hingegen nur noch für den Kolumnentitel
+verwendet. Ein konkreter Eintrag in den Kolumnentitel erfolgt natürlich nur,
+wenn ein Seitenstil\Index{Seiten>Stil} gewählt wird, bei dem die entsprechende
+Gliederungsebene überhaupt für den Kolumnentitel verwendet wird. Siehe hierzu
+\autoref{sec:\LabelBase.pagestyle} sowie \autoref{cha:scrlayer-scrpage}. Mit
+der Einstellung \OptionValueRef{\LabelBase}{headings}{optiontotoc}%
+\IndexOption[indexmain]{headings~=\textKValue{optiontotoc}} wird das optionale
+Argument hingegen ausschließlich für den Eintrag ins Inhaltsverzeichnis
+verwendet. Auch dies selbstverständlich nur, wenn die Einstellung für den
+Zähler \DescRef{\LabelBase.counter.tocdepth} (siehe
\autoref{sec:\LabelBase.toc}, \DescPageRef{\LabelBase.counter.tocdepth}) einen
Eintrag der entsprechenden Ebene überhaupt vorsieht. Mit der Einstellung
-\OptionValueRef{\LabelBase}{headings}{optiontoheadandtoc}\IndexOption[indexmain]{headings~=\PValue{optiontoheadandtoc}}
-findet schließlich das optionale Argument wieder sowohl für den Kolumnentitel
-als auch den Eintrag ins Inhaltsverzeichnis Verwendung. Allen drei
-Einstellungen ist gemeinsam, dass sie im Gegensatz zur Voreinstellung die
-erweiterte Interpretation des optionalen Arguments aktivieren.
+\OptionValueRef{\LabelBase}{headings}{optiontoheadandtoc}%
+\IndexOption[indexmain]{headings~=\textKValue{optiontoheadandtoc}} findet
+schließlich das optionale Argument wieder sowohl für den Kolumnentitel als
+auch den Eintrag ins Inhaltsverzeichnis Verwendung. Allen drei Einstellungen
+ist gemeinsam, dass sie im Gegensatz zur Voreinstellung die erweiterte
+Interpretation des optionalen Arguments aktivieren.
Bei\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} der erweiterten Interpretation des optionalen Arguments
@@ -1699,12 +1890,13 @@ wird geprüft, ob sich ein Gleichheitszeichen in \PName{Kurzform} befindet. Ist
dies der Fall, so wird das optionale Argument der Gliederungsbefehle selbst
statt als \PName{Kurzform} als \PName{Optionenliste} interpretiert. Dabei
werden die drei Optionen
-\OptionVName{head}{Kolumnentitel}\important{\Option{head}},
-\OptionVName{tocentry}{Inhaltsverzeichniseintrag}\important{\Option{tocentry}}
-und \OptionVName{reference}{Querverweistitel}\important{\Option{reference}}%
+\OptionVName{head}{Kolumnentitel}\important{\Option{head}\\
+ \Option{tocentry}\\
+ \Option{reference}} \OptionVName{tocentry}{Inhaltsverzeichniseintrag} und
+\OptionVName{reference}{Querverweistitel}%
\ChangedAt{v3.22}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}
akzeptiert. Um ein Gleichheitszeichen oder ein Komma in einem der beiden Werte
-dieser Optionen unter zu bringen, muss dieses in zusätzliche geschweifte
+dieser Optionen unterzubringen, muss dieses in zusätzliche geschweifte
Klammern gesetzt werden.
Bitte\textnote{Achtung!} beachten Sie, dass dieser Mechanismus nur
@@ -1712,7 +1904,8 @@ funktioniert, solange \KOMAScript{} die Kontrolle über die Gliederungsbefehle
besitzt. Wird hingegen ein Paket verwendet, dass die Gliederungsbefehle oder
die internen \LaTeX-Kern-Anweisungen für Gliederungsbefehle umdefiniert, so
kann \KOMAScript{} diese erweiterte Funktionalität nicht mehr zur Verfügung
-stellen. Dies gilt auch für die immer aktive Erweiterung, dass leere
+stellen. Dies gilt auch für die immer aktive Erweiterung, dass
+leere\textnote{leere Inhalts\-verzeichnis\-einträge}
Inhaltsverzeichniseinträge nicht zu einem Eintrag ohne Text führen, sondern
gänzlich unterbleiben. Soll tatsächlich einmal ein leerer Eintrag ins
Inhaltsverzeichnis erfolgen, so kann dies mit einem unsichtbaren Eintrag
@@ -1765,7 +1958,7 @@ wie \lstinline|\mbox{}| erreicht werden.
beliebig sein kann.
Die Notwendigkeit der geschweiften Klammern im vorherigen Beispiel lässt
- sich am besten an einem weiteren Beispiel verdeutlichen. Angenommen, sie
+ sich am besten an einem weiteren Beispiel verdeutlichen. Angenommen, Sie
haben als Option \OptionValueRef{\LabelBase}{headings}{optiontotoc} gewählt
und setzen nun die Überschrift:
\begin{lstcode}
@@ -1796,20 +1989,25 @@ wie \lstinline|\mbox{}| erreicht werden.
\section[head={0, 1, 2, 3, \dots}]
{Die natürlichen Zahlen mit der Null}
\end{lstcode}
- So ist »\lstinline|0, 1, 2, 3, \dots|« das Argument der Option \Option{head}.
+ so ist »\lstinline|0, 1, 2, 3, \dots|« das Argument der Option
+ \Option{head}.
\end{Example}
So\ChangedAt{v3.22}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}
wie im Beispiel Option \Option{head} den Titel für den lebenden Kolumnentitel
und Option \Option{tocentry} den Titel für den Verzeichniseintrag bestimmt,
-kann mit \Option{reference} der Titel für einen Querverweise durch die Pakete
-\Package{nameref}\IndexPackage{nameref},
-\Package{titleref}\IndexPackage{titleref} oder das
+kann mit \Option{reference}\important{\Option{reference}} der Titel für einen
+Querverweise durch die Pakete
+\Package{nameref}\IndexPackage{nameref}\important{\Package{nameref}\\
+ \Package{titleref}\\
+ \Package{zref-titleref}}, \Package{titleref}\IndexPackage{titleref} oder das
\Package{titleref}\IndexPackage{zref-titleref}-Modul von
\Package{zref}\IndexPackage{zref} explizit vorgegeben werden. Die
Unterstützung für \Package{titleref} ist dabei eher rudimentär, da das Paket
mit der Leistungsfähigkeit der anderen beiden nur schlecht mithalten kann und
-auch nicht mit \Package{hyperref}\IndexPackage{hyperref} kompatibel ist.
+auch nicht mit
+\Package{hyperref}\IndexPackage{hyperref}\important{\Package{hyperref}}
+kompatibel ist.
Die\important{\Macro{part}} Überschrift der Teile-Ebene (\Macro{part})
unterscheidet sich von den anderen Gliederungsebenen dadurch, dass sie
@@ -1819,8 +2017,8 @@ Abschnitt-Ebene (bei \Class{scrartcl}) über alle Teile hinweg durchgehend
nummeriert wird. Darüber hinaus steht bei den Klassen \Class{scrbook} und
\Class{scrreprt}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} die Überschrift
dieser Ebene zusammen mit ihrer Präambel (siehe Anweisung
-\Macro{setpartpreamble}, \DescPageRef{\LabelBase.cmd.setpartpreamble})
-alleine auf einer Seite.
+\DescRef{\LabelBase.cmd.setpartpreamble},
+\DescPageRef{\LabelBase.cmd.setpartpreamble}) alleine auf einer Seite.
\Macro{chapter}\important{\Macro{chapter}}\OnlyAt{\Class{scrbook}\and
\Class{scrreprt}} existiert nur bei Buch- und Berichtklassen, also bei
@@ -1831,7 +2029,7 @@ jedoch bei den Artikelklassen \Class{article} und
gravierend von der Version der Standardklassen. Bei den Standardklassen wird
die Kapitelnummer mit dem Präfix »Kapitel« beziehungsweise dem Kapitelnamen in
der gewählten Sprache in einer Zeile vor dem eigentlichen Text der Überschrift
-ausgegeben. Diese\important[i]{\DescRef{\LabelBase.option.chapterprefix}\\
+ausgegeben. Diese\important{\DescRef{\LabelBase.option.chapterprefix}\\
\DescRef{\LabelBase.option.appendixprefix}} sehr mächtige Form
wird bei {\KOMAScript} durch eine einfache Nummer vor dem Text abgelöst, lässt
sich aber durch die Optionen \DescRef{\LabelBase.option.chapterprefix} und
@@ -1840,7 +2038,7 @@ sich aber durch die Optionen \DescRef{\LabelBase.option.chapterprefix} und
Bitte beachten\textnote{Achtung!} Sie, dass \Macro{part} und \Macro{chapter}
bei \Class{scrbook} und \Class{scrreprt}\OnlyAt{\Class{scrbook}\and
- \Class{scrreprt}} den Seitenstil für eine Seite umschaltet. Der jeweilige
+ \Class{scrreprt}} den Seitenstil für eine Seite umschalten. Der jeweilige
Seitenstil ist bei \KOMAScript{} in den Makros
\DescRef{\LabelBase.cmd.partpagestyle} und
\DescRef{\LabelBase.cmd.chapterpagestyle} abgelegt (siehe
@@ -1853,6 +2051,7 @@ Seitenstil ist bei \KOMAScript{} in den Makros
\BeginIndex{FontElement}{part}\LabelFontElement{part}%
\BeginIndex{FontElement}{parnumber}\LabelFontElement{partnumber}%
\BeginIndex{FontElement}{chapter}\LabelFontElement{chapter}%
+\BeginIndex{FontElement}{chapterprefix}\LabelFontElement{chapterprefix}%
\BeginIndex{FontElement}{section}\LabelFontElement{section}%
\BeginIndex{FontElement}{subsection}\LabelFontElement{subsection}%
\BeginIndex{FontElement}{subsubsection}\LabelFontElement{subsubsection}%
@@ -1867,10 +2066,11 @@ sieben Gliederungsebenen kann mit den Anweisungen
bestimmt werden. Dabei wird zunächst generell das Element
\FontElement{disposition}\important{\FontElement{disposition}} und
anschließend zusätzlich je Gliederungsebene ein spezifisches
-Element\important[s]{%
+Element\important{%
\FontElement{part}\\
\FontElement{partnumber}\\
\FontElement{chapter}\\
+ \FontElement{chapterprefix}\\
\FontElement{section}\\
\FontElement{subsection}\\
\FontElement{paragraph}\\
@@ -1878,7 +2078,9 @@ Element\important[s]{%
\autoref{tab:maincls.fontelements},
\autopageref{tab:maincls.fontelements}). Für den Nummernteil der
Teile-Überschrift wird zusätzlich das Element \FontElement{partnumber}
-verwendet. Die Schriftart für das Element \FontElement{disposition} ist als
+verwendet, für die optionale Präfixzeile der Kapitelüberschriften das Element
+\FontElement{chapterprefix}. Die Schriftart für das Element
+\FontElement{disposition} ist als
\Macro{normalcolor}""\Macro{sffamily}""\Macro{bfseries} vordefiniert. Die
Voreinstellungen für die spezifischen Elemente sind mit einer Schriftgröße
vorbelegt und daher von den Einstellungen \PValue{big}, \PValue{normal} und
@@ -1895,7 +2097,7 @@ vorbelegt und daher von den Einstellungen \PValue{big}, \PValue{normal} und
\begin{captionbeside}[{Schriftvoreinstellungen für die Elemente der Gliederung
bei\newline \Class{scrbook} und \Class{scrreprt}}]{%
\label{tab:maincls.structureElementsFont}%
- Voreinstellungen der Schrift
+ \hspace{0pt plus .5em}Voreinstellungen der Schrift
für die Elemente der Gliederung bei \Class{scrbook} und \Class{scrreprt}}
[l]
\begin{tabular}[t]{lll}
@@ -1909,6 +2111,8 @@ vorbelegt und daher von den Einstellungen \PValue{big}, \PValue{normal} und
& \Macro{huge} \\
& \FontElement{chapter}\IndexFontElement{chapter}
& \Macro{huge} \\
+ & \FontElement{chapterprefix}\IndexFontElement{chapterprefix}
+ & \DescRef{\LabelBase.cmd.usekomafont}\PParameter{chapter} \\
& \FontElement{section}\IndexFontElement{section}
& \Macro{Large} \\
& \FontElement{subsection}\IndexFontElement{subsection}
@@ -1923,6 +2127,8 @@ vorbelegt und daher von den Einstellungen \PValue{big}, \PValue{normal} und
& \FontElement{part} & \Macro{huge} \\
& \FontElement{partnumber} & \Macro{huge} \\
& \FontElement{chapter} & \Macro{LARGE} \\
+ & \FontElement{chapterprefix}\IndexFontElement{chapterprefix}
+ & \DescRef{\LabelBase.cmd.usekomafont}\PParameter{chapter} \\
& \FontElement{section} & \Macro{Large} \\
& \FontElement{subsection} & \Macro{large} \\
& \FontElement{subsubsection} & \Macro{normalsize} \\
@@ -1932,6 +2138,8 @@ vorbelegt und daher von den Einstellungen \PValue{big}, \PValue{normal} und
& \FontElement{part} & \Macro{LARGE} \\
& \FontElement{partnumber} & \Macro{LARGE} \\
& \FontElement{chapter} & \Macro{Large} \\
+ & \FontElement{chapterprefix}\IndexFontElement{chapterprefix}
+ & \DescRef{\LabelBase.cmd.usekomafont}\PParameter{chapter} \\
& \FontElement{section} & \Macro{large} \\
& \FontElement{subsection} & \Macro{normalsize} \\
& \FontElement{subsubsection} & \Macro{normalsize} \\
@@ -2047,24 +2255,25 @@ selbstverständlich nur bei Buch- und Berichtklassen, also bei \Class{book},
\Class{scrbook}, \Class{report} und \Class{scrreprt}, nicht jedoch bei den
Artikelklassen \Class{article} und \Class{scrartcl}.
-Bitte\textnote{Achtung!} beachten Sie, dass \Macro{part*} und
-\Macro{chapter*} den Seitenstil für eine Seite umschalten. Während die
+Bitte\textnote{Achtung!} beachten Sie, dass \Macro{part*} und \Macro{chapter*}
+den Seitenstil für eine Seite umschalten. Während die
Standardklassen\textnote{\KOMAScript{} vs. Standardklassen} dabei den
Seitenstil \PageStyle{plain} verwenden, ist bei \KOMAScript{} der zu
-verwendende Seitenstil in den Makros \DescRef{\LabelBase.cmd.partpagestyle} und
-\DescRef{\LabelBase.cmd.chapterpagestyle} abgelegt (siehe \autoref{sec:\LabelBase.pagestyle},
+verwendende Seitenstil in den Makros \DescRef{\LabelBase.cmd.partpagestyle}
+und \DescRef{\LabelBase.cmd.chapterpagestyle} abgelegt (siehe
+\autoref{sec:\LabelBase.pagestyle},
\DescPageRef{\LabelBase.cmd.titlepagestyle}).
Bezüglich der Möglichkeiten der Schriftumschaltung\ChangedAt{v2.8p}{%
\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} %
-gilt das Gleiche wie zuvor in der Erklärung zu den sternlosen
+gilt das Gleiche, wie zuvor in der Erklärung zu den sternlosen
Varianten geschrieben. Die Elemente tragen die gleichen Namen, da sie
nicht Varianten, sondern Gliederungsebenen bezeichnen.%
%
\EndIndexGroup
-\iftrue% Umbruchkorrekturtext
+\iffalse% Umbruchkorrekturtext
Bei den Standardklassen\textnote{\KOMAScript{} vs. Standardklassen} gibt
es keine weiteren Gliederungsbefehle. Es existieren also insbesondere keine
Anweisungen, mit denen man nicht nummerierte Kapitel oder nicht nummerierte
@@ -2085,11 +2294,15 @@ bei denen ein automatischer Kolumnentitel erzeugt wird.
{\KOMAScript} bietet über die Gliederungsbefehle der Standardklassen hinaus
die Anweisungen \Macro{addpart}, \Macro{addchap} und \Macro{addsec}. Diese
ähneln bis auf die fehlende Nummerierung sehr den Standardanweisungen
-\DescRef{\LabelBase.cmd.part}, \DescRef{\LabelBase.cmd.chapter} und
-\DescRef{\LabelBase.cmd.section}. Sie erzeugen also sowohl einen automatischen
-Kolumnentitel als auch einen Eintrag im Inhaltsverzeichnis, wobei auch die
-Einstellungen von Option \DescRef{\LabelBase.option.headings}%
-\important{\DescRef{\LabelBase.option.headings}} beachtet werden, also
+\DescRef{\LabelBase.cmd.part}\IndexCmd{part}%
+\important{\DescRef{\LabelBase.cmd.part}, \DescRef{\LabelBase.cmd.chapter},
+ \DescRef{\LabelBase.cmd.section}},
+\DescRef{\LabelBase.cmd.chapter}\IndexCmd{chapter} und
+\DescRef{\LabelBase.cmd.section}\IndexCmd{section}. Sie erzeugen sowohl
+einen automatischen Kolumnentitel als auch einen Eintrag im
+Inhaltsverzeichnis, wobei auch die Einstellungen von Option
+\DescRef{\LabelBase.option.headings}%
+\important{\DescRef{\LabelBase.option.headings}} beachtet werden,
insbesondere auch die entsprechende Erweiterung des optionalen Arguments
verfügbar ist.
@@ -2100,8 +2313,14 @@ Unterschied: Die Kolumnentitel werden gelöscht. Dadurch wird der oben erwähnte
Effekt veralteter Kolumnentitel ausgeschlossen. Stattdessen bleibt der
Kolumnentitel auf Folgeseiten leer. \OnlyAt{\Class{scrbook}\and
\Class{scrreprt}}\Macro{addchap} und \Macro{addchap*} existieren
-selbstverständlich nur bei Buch- und Berichtklassen, also bei \Class{scrbook}
-und \Class{scrreprt}, nicht jedoch bei der Artikelklasse \Class{scrartcl}.
+\iffree{%
+ selbstverständlich nur bei Buch- und Berichtklassen, also bei
+ \Class{scrbook} und \Class{scrreprt}, nicht jedoch bei der Artikelklasse
+ \Class{scrartcl}.%
+}{%
+ nur bei \Class{scrbook} und \Class{scrreprt}, nicht jedoch bei
+ \Class{scrartcl}.%
+}
Die Anweisung \Macro{addpart} erstellt entsprechend einen nicht nummerierten
Dokumentteil mit einem Eintrag im Inhaltsverzeichnis. Da bereits
@@ -2118,10 +2337,80 @@ umschalten. Der jeweilige Seitenstil ist in den Makros
\DescRef{\LabelBase.cmd.chapterpagestyle} abgelegt (siehe
\autoref{sec:\LabelBase.pagestyle},
\DescPageRef{\LabelBase.cmd.titlepagestyle}).
+\iffree{\iffalse}{\csname iftrue\endcsname}% Umbruchkorrekturbeispiel
+\begin{Example}
+ Sie schreiben ein Buch mit einem ausladenden Nachwort über mehrere
+ Seiten. Dieses soll weder einen Kolumnentitel noch einen Eintrag ins
+ Inhaltsverzeichnis erhalten. Daher verwenden Sie zunächst
+ \DescRef{\LabelBase.cmd.chapter*}:
+\begin{lstcode}
+ \documentclass{scrbook}
+ \usepackage[ngerman]{babel}
+ \usepackage{blindtext}
+ \begin{document}
+ \tableofcontents
+ \blinddocument
+ \chapter*{Nachwort}
+ \Blindtext[10]
+ \end{document}
+\end{lstcode}
+ Allerdings entdecken Sie, dass auf der zweiten und dritten Seite des
+ Nachworts der Kolumnentitel des vorherigen Kapitels wieder auftaucht. Das
+ wollen Sie natürlich nicht. Deshalb verwenden Sie nun \Macro{addchap*}:
+\begin{lstcode}
+ \documentclass{scrbook}
+ \usepackage[ngerman]{babel}
+ \usepackage{blindtext}
+ \begin{document}
+ \tableofcontents
+ \blinddocument
+ \addchap*{Nachwort}
+ \Blindtext[10]
+ \end{document}
+\end{lstcode}
+ Wunschgemäß ist das komplette Nachwort nun ohne Kolumnentitel. Doch auch das
+ entspricht nicht ganz Ihren Vorstellungen. Ein Kolumnentitel wäre doch
+ schön. Mit
+\begin{lstcode}
+ \documentclass{scrbook}
+ \usepackage[ngerman]{babel}
+ \usepackage{blindtext}
+ \begin{document}
+ \tableofcontents
+ \blinddocument
+ \addchap{Nachwort}
+ \Blindtext[10]
+ \end{document}
+\end{lstcode}
+ erhalten Sie nun sowohl »Nachwort« als Kolumnentitel der geraden Seiten, als
+ auch einen Inhaltsverzeichniseintrag. Genau an diesem Eintrag stört sich
+ dann aber der Verlag. Er besteht darauf, dass das Nachwort keinen Eintrag
+ ins Inhaltsverzeichnis zu erhalten hat. Auch wenn Ihnen das seltsam
+ erscheint, wollen Sie den Verlag zufriedenstellen. Also aktivieren Sie mit
+ \OptionValueRef{\LabelBase}{headings}{optiontotocandhead} zunächst die
+ erweiterte Funktion für das optionale Argument und setzen dann für das
+ Inhaltsverzeichnis explizit ein leeres Argument:
+\begin{lstcode}
+ \documentclass[headings=optiontotocandhead]
+ {scrbook}
+ \usepackage[ngerman]{babel}
+ \usepackage{blindtext}
+ \begin{document}
+ \tableofcontents
+ \blinddocument
+ \addchap[tocentry={}]{Nachwort}
+ \Blindtext[10]
+ \end{document}
+\end{lstcode}
+ Der Kolumnentitel wird von \OptionValue{tocentry}{\{\}} nicht verändert.
+ Da \Class{scrbook} leere Einträge ins Inhaltsverzeichnis automatisch
+ unterdrückt, ist nun auch der Verlag zufriedengestellt.
+\end{Example}%
+\fi
Bezüglich der Möglichkeiten der Schriftumschaltung\ChangedAt{v2.8p}{%
\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} %
-gilt das gleiche wie zuvor in der Erklärung zu \DescRef{\LabelBase.cmd.part*},
+gilt das Gleiche, wie zuvor in der Erklärung zu \DescRef{\LabelBase.cmd.part*},
\DescRef{\LabelBase.cmd.chapter*} und \DescRef{\LabelBase.cmd.section*}
geschrieben. Die Elemente tragen die gleichen Namen, da sie nicht Varianten,
sondern Gliederungsebenen bezeichnen.%
@@ -2138,15 +2427,15 @@ nachfolgenden Text zusammenhängt. Eine solche Überschrift soll dann ohne große
Abstände gesetzt werden.
Der Befehl \Macro{minisec} bewirkt genau eine derartige Überschrift. Diese
-Überschrift ist keiner Gliederungsebene zugeordnet. Eine solche
-\emph{Mini-Section} wird nicht in das Inhaltsverzeichnis aufgenommen und
-erhält auch keine Nummerierung.
+Überschrift ist keiner Gliederungsebene\textnote{ohne Gliederungsebene}
+zugeordnet. Eine solche \emph{Mini-Section} wird nicht in das
+Inhaltsverzeichnis aufgenommen und erhält auch keine Nummerierung.
\BeginIndexGroup
\BeginIndex{FontElement}{minisec}\LabelFontElement{minisec}%
Die Schriftart des Gliederungsbefehls \Macro{minisec} kann über die Elemente
\DescRef{\LabelBase.fontelement.disposition}%
-\important[i]{\DescRef{\LabelBase.fontelement.disposition}\\
+\important{\DescRef{\LabelBase.fontelement.disposition}\\
\FontElement{minisec}} und \FontElement{minisec}\ChangedAt{v2.96a}{%
\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} beeinflusst
werden (siehe \autoref{tab:maincls.fontelements},
@@ -2194,19 +2483,19 @@ werden (siehe \autoref{tab:maincls.fontelements},
\minisec{Montage}
- Zunächst suche man das Mauseloch. Dann lege man die
- Reißzwecke innen unmittelbar hinter das Loch, damit
- bei den folgenden Aktionen die Maus nicht
+ Zunächst suche man das Mauseloch. Dann lege man
+ die Reißzwecke innen unmittelbar hinter das Loch,
+ damit bei den folgenden Aktionen die Maus nicht
entschlüpfen kann.
Anschließend klopfe man mit dem Hammer den
Bierflaschenschnappverschluss in das Mauseloch.
- Sollte der Verschluss nicht groß genug sein, um das
- Loch vollständig und dauerhaft zu verschließen,
- nehme man stattdessen das Brett und schraube es
- unter Zuhilfenahme der beiden Schrauben und des
- Messers vor das Loch. Statt des Messers kann
- selbstverständlich auch ein Schraubendreher
- verwendet werden.
+ Sollte der Verschluss nicht groß genug sein, um
+ das Loch vollständig und dauerhaft zu
+ verschließen, nehme man stattdessen das Brett
+ und schraube es unter Zuhilfenahme der beiden
+ Schrauben und des Messers vor das Loch. Statt
+ des Messers kann selbstverständlich auch ein
+ Schraubendreher verwendet werden.
Die Kugelschreiberfeder ist dem Tierschutz zum
Opfer gefallen.
\end{document}
@@ -2313,8 +2602,9 @@ ist die Anweisung \Macro{raggedpart} verantwortlich, die als:
vordefiniert ist. Auch diese Anweisung kann mit \Macro{renewcommand}
umdefiniert werden.
\begin{Example}
- Sie wollen, dass Überschriften mit \DescRef{\LabelBase.cmd.part} in der gleichen Weise
- formatiert werden, wie alle anderen Ebenen. Dazu schreiben Sie
+ Sie wollen, dass Überschriften mit \DescRef{\LabelBase.cmd.part} in der
+ gleichen Weise formatiert werden wie alle anderen Ebenen. Dazu schreiben
+ Sie
\begin{lstcode}
\renewcommand*{\raggedpart}{\raggedsection}
\end{lstcode}
@@ -2340,20 +2630,21 @@ umdefiniert werden.
\Macro{subsubsectionformat}
\Macro{paragraphformat}
\Macro{subparagraphformat}
- \Macro{othersectionlevelsformat}\Parameter{Gliederungsname}\Parameter{}\Parameter{Zählerausgabe}
+ \Macro{othersectionlevelsformat}\Parameter{Gliederungsname}\Parameter{}
+ \Parameter{Zählerausgabe}
\Macro{IfUsePrefixLine}\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
\Macro{autodot}
\end{Declaration}%
\KOMAScript{} fügt der Ausgabe der Gliederungsnummern oberhalb von
\Macro{the\PName{Gliederungsname}} (siehe \Macro{the\PName{Zähler}},
-\DescPageRef{maincls-experts.cmd.the}) eine weitere logische Ebene
+\DescPageRef{maincls-experts.cmd.the/Zaehler/}) eine weitere logische Ebene
hinzu. Die Zähler werden für die jeweilige Überschrift nicht einfach nur
ausgegeben. Sie werden mit Hilfe der parameterlosen Anweisungen
\Macro{partformat}, \Macro{chapterformat} bis
\Macro{subparagraphformat}\ChangedAt{v3.17}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}} formatiert.
\OnlyAt{\Class{scrbook}\and \Class{scrreprt}}Die Anweisung
-\Macro{chapterformat} existiert wie bereits \Macro{thechapter}
+\Macro{chapterformat} existiert, wie bereits \Macro{thechapter},
selbstverständlich nicht in der Klasse \Class{scrartcl}, sondern nur in den
Klassen \Class{scrbook} und \Class{scrreprt}.
@@ -2364,8 +2655,8 @@ Wie bereits bei Option \DescRef{\LabelBase.option.numbers}%
Punkt versehen werden oder dieser hat zu entfallen. Die Anweisung
\Macro{autodot} ist bei {\KOMAScript} für die Einhaltung dieser Regel
verantwortlich. Auf den Punkt folgt bei allen Gliederungsebenen außer
-\DescRef{\LabelBase.cmd.part} noch ein \Macro{enskip}. Dies entspricht einem Leerraum von
-0,5\Unit{em}, also einem Halbgeviert.
+\DescRef{\LabelBase.cmd.part} noch ein \Macro{enskip}. Dies entspricht einem
+Leerraum von 0,5\Unit{em}, also einem Halbgeviert.
Die Anweisung
\Macro{othersectionlevelsformat}\ChangedAt{v3.17}{\Class{scrbook}\and
@@ -2374,7 +2665,8 @@ in Ausnahmefällen verwendet, wenn für eine Gliederungsebene keine
Format-Anweisung definiert oder diese \Macro{relax} ist, was jedoch in der
Voreinstellung für die Gliederungsebenen von KOMA-Script nicht zutrifft. Daher
wird sie auch nicht mehr offiziell dokumentiert. Bei einer
-Kompatibilitätseinstellung zu Versionen vor 3.17 (siehe Option
+Kompatibilitätseinstellung zu Versionen vor
+3.17\important{\OptionValueRef{\LabelBase}{version}{3.17}} (siehe Option
\DescRef{\LabelBase.option.version},
\autoref{sec:\LabelBase.compatibilityOptions},
\DescPageRef{\LabelBase.option.version}) haben hingegen die Anweisungen
@@ -2392,35 +2684,42 @@ anzupassen. Nachfolgend finden Sie einige Definitionen, die denen aus den
\mbox{\chapappifchapterprefix{\nobreakspace}\thechapter
\autodot\IfUsePrefixLine{}{\enskip}}}
\newcommand*{\sectionformat}{\thesection\autodot\enskip}
+ \newcommand*{\subsectionformat}{%
+ \thesubsection\autodot\enskip}
+ \newcommand*{\subsubsectionformat}{%
+ \thesubsubsection\autodot\enskip}
+ \newcommand*{\paragraphformat}{\theparagraph\autodot\enskip}
+ \newcommand*{\subparagraphformat}{%
+ \thesubparagraph\autodot\enskip}
\newcommand*{\othersectionlevelsformat}[3]{%
#3\autodot\enskip}
\end{lstcode}
-Die Definitionen der tieferen Ebenen entsprechen der von
-\Macro{sectionformat}.
Wegen\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}} der Verwendung
-von \Macro{IfUsePrefixLine} sollte \Macro{chapterformat} nicht außerhalb von
-\DescRef{\LabelBase.cmd.chapter} verwendet werden. Diese Anweisung ist nur innerhalb der
-Gliederungsbefehle von \KOMAScript{} wohldefiniert. In diesem Fall wird im
-Falle der Verwendung einer Präfixzeile für die Nummer der Überschrift der
-\PName{Dann-Teil} ausgeführt, während im anderen Fall der \PName{Sonst-Teil}
-verwendet wird.
-
-Bitte\textnote{Achtung!} beachten Sie außerdem, dass bei der
-Umdefinierung \Macro{newcommand} durch \Macro{renewcommand} zu ersetzen ist.
+von \Macro{IfUsePrefixLine} sollte die Anweisung \Macro{chapterformat} nicht
+außerhalb von \DescRef{\LabelBase.cmd.chapter} verwendet
+werden. \Macro{IfUsePrefixLine} ist nur innerhalb der Gliederungsbefehle von
+\KOMAScript{} wohldefiniert. Dort wird dann im Falle der Verwendung einer
+Präfixzeile für die Nummer der Überschrift der \PName{Dann-Teil} ausgeführt,
+während im anderen Fall der \PName{Sonst-Teil} zur Ausführung kommt.
+
+Bitte\textnote{Achtung!} beachten Sie außerdem, dass bei der Umdefinierung
+selbstverständlich \Macro{newcommand} durch \Macro{renewcommand} zu ersetzen
+ist.
\begin{Example}
- Angenommen, Sie wollen, dass bei \DescRef{\LabelBase.cmd.part} das Wort »Teil« vor
- der Nummer nicht ausgegeben wird. Dann können Sie beispielsweise
+ Angenommen, Sie wollen, dass bei \DescRef{\LabelBase.cmd.part} das Wort
+ »Teil« vor der Nummer nicht ausgegeben wird. Dann können Sie beispielsweise
folgende Anweisung in die Präambel Ihres Dokuments schreiben:
\begin{lstcode}
\renewcommand*{\partformat}{\thepart\autodot}
\end{lstcode}
Genau genommen könnten Sie an dieser Stelle auch auf \Macro{autodot}
- verzichten und stattdessen einen festen Punkt setzen. Da \DescRef{\LabelBase.cmd.part} mit
- römischen Zahlen nummeriert wird, muss der Punkt laut \cite{DUDEN} folgen.
- Allerdings bringen Sie sich dann um die Möglichkeit, die Option
- \DescRef{\LabelBase.option.numbers}\important{\DescRef{\LabelBase.option.numbers}} einzusetzen und so von der
+ verzichten und stattdessen einen festen Punkt setzen. Da
+ \DescRef{\LabelBase.cmd.part} mit römischen Zahlen nummeriert wird, muss der
+ Punkt laut \cite{DUDEN} folgen. Allerdings bringen Sie sich dann um die
+ Möglichkeit, die Option \DescRef{\LabelBase.option.numbers}%
+ \important{\DescRef{\LabelBase.option.numbers}} einzusetzen und so von der
Regel abzuweichen. Näheres zu der Option siehe
\DescPageRef{\LabelBase.option.numbers}.
@@ -2434,24 +2733,37 @@ Umdefinierung \Macro{newcommand} durch \Macro{renewcommand} zu ersetzen ist.
\renewcommand*{\subsectionformat}{%
\makebox[0pt][r]{\thesubsection\autodot\enskip}}
\renewcommand*{\subsubsectionformat}{%
- \makebox[0pt][r]{\thesubsubsection\autodot\enskip}}
+ \makebox[0pt][r]{%
+ \thesubsubsection\autodot\enskip}}
\renewcommand*{\paragraphformat}{%
\makebox[0pt][r]{\theparagraph\autodot\enskip}}
\renewcommand*{\paragraphformat}{%
- \makebox[0pt][r]{\thesubparagraph\autodot\enskip}}
+ \makebox[0pt][r]{%
+ \thesubparagraph\autodot\enskip}}
\end{lstcode}
+ Die optionalen Argumente der \Macro{makebox}-Anweisungen fordern von
+ \LaTeX{} dabei eine Box der Breite Null, deren Inhalt rechtsbündig
+ angeordnet ist. Im Ergebnis wird der Inhalt der Box links von der aktuellen
+ Position ausgegeben.\iffree{}{ %Umbruchkorrekturtext
+ Mit diesem beliebten Trick wird vermieden, dass zunächst die Breite von
+ Nummer und Abstand ausgemessen werden muss, um dann die aktuelle Position
+ entsprechend mit \Macro{hspace} zu verändern.}
Näheres zu den optionalen Argumenten von \Macro{makebox} ist
\cite{latex:usrguide} zu entnehmen.
\end{Example}
-Für Formatierungsänderungen bei den Überschriften, die über die Ausgabe der
-Nummer hinaus gehen, sie ausdrücklich auf
-\DescRef{maincls-experts.cmd.chapterlineswithprefixformat},
-\DescRef{maincls-experts.cmd.chapterlinesformat},
-\DescRef{maincls-experts.cmd.sectionlinesformat} und
-\DescRef{maincls-experts.cmd.sectioncatchphraseformat} in
-\autoref{sec:maincls-experts.experts}, ab
-\DescPageRef{maincls-experts.cmd.chapterlineswithprefixformat} verwiesen.%
+Für Formatierungsänderungen bei den Überschriften, die über die reine Ausgabe
+der Nummer hinaus gehen, sei ausdrücklich auf
+\DescRef{maincls-experts.cmd.partlineswithprefixformat}%
+\IndexCmd{partlineswithprefixformat},
+\DescRef{maincls-experts.cmd.chapterlineswithprefixformat}%
+\IndexCmd{chapterlineswithprefixformat} und
+\DescRef{maincls-experts.cmd.chapterlinesformat}\IndexCmd{chapterlinesformat}
+sowie
+\DescRef{maincls-experts.cmd.sectionlinesformat}\IndexCmd{sectionlinesformat}
+und das zugehörige \DescRef{maincls-experts.cmd.sectioncatchphraseformat}%
+\IndexCmd{sectioncatchphraseformat} in \autoref{sec:maincls-experts.experts},
+ab \DescPageRef{maincls-experts.cmd.partlineswithprefixformat} verwiesen.%
\EndIndexGroup
@@ -2469,7 +2781,7 @@ Bei Verwendung von Option \OptionValueRef{\LabelBase}{chapterprefix}{true}%
\important{\DescRef{\LabelBase.option.chapterprefix}} (siehe
\DescPageRef{\LabelBase.option.chapterprefix}) setzt
\Macro{chapappifchapterprefix} im Hauptteil des Dokuments das Wort
-»Kapitel«\Index{Kapitel>Ueberschrift=Überschrift} in der aktuellen Sprache
+»Kapitel«\Index{Kapitel>Ueberschrift=Überschrift} in der aktuellen Sprache,
gefolgt vom \PName{Zusatztext}. Im Anhang\Index{Anhang} wird stattdessen das
Wort »Anhang« in der aktuellen Sprache, ebenfalls gefolgt vom
\PName{Zusatztext}, ausgegeben. Bei der Einstellung
@@ -2498,19 +2810,20 @@ gibt, existieren die beiden Anweisungen auch nur bei diesen Klassen.%
\end{Declaration}%
\begin{Explain}
Wie bereits in \autoref{sec:\LabelBase.pagestyle} erwähnt, arbeitet der
- Seitenstil \PValue{headings} mit automatischen
+ Seitenstil \DescRef{\LabelBase.pagestyle.headings}\IndexPagestyle{headings}%
+ \important{\DescRef{\LabelBase.pagestyle.headings}} mit automatischen
Kolumnentiteln\Index{Kolumnentitel>automatisch}. Dazu werden die
Anweisungen \Macro{chaptermark} und \Macro{sectionmark} beziehungsweise
\Macro{sectionmark} und \Macro{subsectionmark} entsprechend definiert.
Gliederungsbefehle (\DescRef{\LabelBase.cmd.chapter},
\DescRef{\LabelBase.cmd.section}~\dots) führen automatisch eine
- entsprechende \Macro{\dots mark}-Anweisung aus. Der übergebene Parameter
- beinhaltet dabei den Text der
+ entsprechende \Macro{\dots mark}-Anweisung aus. Der dabei übergebene
+ Parameter beinhaltet den Text der
Gliederungsüberschrift\Index{Ueberschriften=Überschriften}. Die zugehörige
Gliederungsnummer wird automatisch in der \Macro{\dots mark}-Anweisung
- hinzugefügt. Die Formatierung erfolgt dabei je nach Gliederungsebene mit
- einer der drei Anweisungen \Macro{chaptermarkformat},
- \Macro{sectionmarkformat} und \Macro{subsectionmarkformat}.
+ hinzugefügt. Die Formatierung erfolgt je nach Gliederungsebene mit einer der
+ drei Anweisungen \Macro{chaptermarkformat}, \Macro{sectionmarkformat} und
+ \Macro{subsectionmarkformat}.
Es ist zu beachten\textnote{Achtung!}, dass die Kolumnentitel von
\DescRef{\LabelBase.cmd.addchap}\IndexCmd{addchap} und
@@ -2531,13 +2844,14 @@ gibt, existieren die beiden Anweisungen auch nur bei diesen Klassen.%
\Macro{chaptermarkformat} existieren, gibt es die beiden Anweisungen
\OnlyAt{\Class{scrartcl}}\Macro{subsectionmark} und
\Macro{subsectionmarkformat} nur bei \Class{scrartcl}. Bei Verwendung des
- Pakets \Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} ändert sich
- dies jedoch (siehe \autoref{cha:scrlayer-scrpage}).
+ Pakets \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ \IndexPackage{scrlayer-scrpage} ändert sich dies jedoch (siehe
+ \autoref{cha:scrlayer-scrpage}).
\end{Explain}
So wie mit \DescRef{\LabelBase.cmd.partformat} bis
\DescRef{\LabelBase.cmd.subparagraphformat} die Nummern der
-Gliederungsüberschriften formatiert ausgegeben werden, werden mit den
-Anweisungen \Macro{chaptermarkformat}, \Macro{sectionmarkformat} und
+Gliederungsüberschriften formatiert ausgegeben werden, werden entsprechend mit
+\Macro{chaptermarkformat}, \Macro{sectionmarkformat} und
\Macro{subsectionmarkformat} die Nummern der Gliederungsebenen in den
automatischen Kolumnentiteln formatiert ausgegeben. Mit \Macro{renewcommand}
können sie eigenen Anforderungen angepasst werden. Die Originaldefinitionen
@@ -2579,11 +2893,11 @@ erklärt wurden.%
\BeginIndex{}{Nummerierung}%
Normalerweise werden bei den Klassen \Class{scrbook}\IndexClass{scrbook} und
\Class{scrreprt}\IndexClass{scrreprt} die Gliederungsebenen
-\DescRef{\LabelBase.cmd.part}\IndexCmd{part}\IndexCmd{chapter}\IndexCmd{section}
-bis \DescRef{\LabelBase.cmd.subsection}\IndexCmd{subsection} und bei der
-Klasse \Class{scrartcl}\IndexClass{scrartcl} die Ebenen
-\DescRef{\LabelBase.cmd.part} bis
-\DescRef{\LabelBase.cmd.subsubsection}\IndexCmd{subsubsection}
+\DescRef{\LabelBase.cmd.part}\IndexCmd{part}\IndexCmd{chapter}%
+\IndexCmd{section} bis
+\DescRef{\LabelBase.cmd.subsection}\IndexCmd{subsection} und bei der Klasse
+\Class{scrartcl}\IndexClass{scrartcl} die Ebenen \DescRef{\LabelBase.cmd.part}
+bis \DescRef{\LabelBase.cmd.subsubsection}\IndexCmd{subsubsection}
nummeriert. Gesteuert wird dies über den \LaTeX-Zähler \Counter{secnumdepth}.
Damit\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
@@ -2606,10 +2920,10 @@ Eine Umdefinierung der Anweisungen ist nicht vorgesehen und wird ausdrücklich
nicht empfohlen, da dies zu unvorhergesehenen Ergebnissen sowohl mit
\KOMAScript{} als auch bei Verwendung von Drittpaketen führen kann.
-Der Zähler \Counter{secnumdepth} ist nicht zu verwechseln mit dem Zähler
-\DescRef{\LabelBase.counter.tocdepth} (siehe \autoref{sec:\LabelBase.toc},
-\DescPageRef{\LabelBase.counter.tocdepth}). Auch sind die Werte je nach
-Klasse nicht eins zu eins übertragbar.%
+Der\textnote{Achtung!} Zähler \Counter{secnumdepth} ist nicht zu verwechseln
+mit dem Zähler \DescRef{\LabelBase.counter.tocdepth} (siehe
+\autoref{sec:\LabelBase.toc}, \DescPageRef{\LabelBase.counter.tocdepth}). Auch
+sind die Werte je nach Klasse nicht eins zu eins übertragbar.%
%
\EndIndexGroup
@@ -2635,10 +2949,10 @@ wohingegen \Macro{ifunnumbered} den \PName{Dann-Teil} ausführt. Als
\KOMAScript{} selbst verwendet diesen Test beispielsweise in der Definition
von \DescRef{\LabelBase.cmd.chaptermark}\IndexCmd{chaptermark} beim Seitenstil
-\PageStyle{headings}\IndexPagestyle{headings}. Dadurch wird indirekt auch
-sichergestellt, dass Überschriften mit \DescRef{\LabelBase.cmd.addchap} den
-Kolumnentitel nicht mit einer Nummer versehen (siehe auch
-\DescRef{\LabelBase.cmd.addchapmark},
+\DescRef{\LabelBase.pagestyle.headings}\IndexPagestyle{headings}. Dadurch wird
+indirekt auch sichergestellt, dass Überschriften mit
+\DescRef{\LabelBase.cmd.addchap} den Kolumnentitel nicht mit einer Nummer
+versehen (siehe auch \DescRef{\LabelBase.cmd.addchapmark},
\DescPageRef{\LabelBase.cmd.addchapmark}).%
\EndIndexGroup
@@ -2733,9 +3047,11 @@ Platzierung über der Überschrift in den dort vorhandenen freien Platz gesetzt
wird. Die Überschrift wird dabei nicht nach unten verschoben. Der Anwender ist
also selbst dafür verantwortlich dass \PName{Präambel} nicht zu groß ist und
der vorhandene freie Platz über der Überschrift genügt. Siehe dazu auch
-\DescRef{maincls-experts.cmd.chapterheadstartvskip} in
-\autoref{sec:maincls-experts.experts} auf
-\DescPageRef{maincls-experts.cmd.chapterheadstartvskip}.
+Einstellung \Option{beforeskip} für
+\DescRef{maincls-experts.cmd.RedeclareSectionCommand} in
+\autoref{sec:maincls-experts.experts},
+\autoref{tab:maincls-experts.declarechapterstyle.keys},
+\autopageref{tab:maincls-experts.declarechapterstyle.keys}.
%
%
\EndIndexGroup
@@ -2758,7 +3074,8 @@ Die \KOMAScript-Klassen stellen keine eigenen Umgebungen für mathematische
Formeln, Gleichungssysteme oder ähnliche Elemente der Mathematik
bereit. Stattdessen stützt sich \KOMAScript{} im Bereich der Mathematik voll
und ganz auf den \LaTeX-Kern. Dies gilt auch für die Realisierung der beiden
-Optionen \DescRef{\LabelBase.option.leqno} und \DescRef{\LabelBase.option.fleqn}.
+Optionen \DescRef{\LabelBase.option.leqno} und
+\DescRef{\LabelBase.option.fleqn}.
Auf eine Beschreibung der Mathematikumgebungen des \LaTeX-Kerns, also
\Environment{displaymath}\IndexEnv{displaymath},
@@ -2851,66 +3168,64 @@ selbstverständlich sein, wird aber leider häufig nicht bedacht.
\OptionVName{captions}{Einstellung}
\end{Declaration}
Bei den Standardklassen werden die Titel von Gleitumgebungen, die mit der
-Anweisung \DescRef{\LabelBase.cmd.caption}\IndexCmd{caption} (siehe unten) gesetzt werden, als
-Unterschrift formatiert. Darüber hinaus wird zwischen ein"~ und mehrzeiligen
-Unterschriften unterschieden, wobei einzeilige Unterschriften horizontal
-zentriert werden.
-
-\leavevmode\phantomsection\nobreak%
-\label{desc:maincls.option.captions.tableheading}\nobreak%
-Tabellen werden jedoch häufig mit Überschriften statt mit Unterschriften
-versehen. Das liegt daran, dass es auch Tabellen geben kann, die sich über
-mehrere Seiten erstrecken. Bei solchen Tabellen möchte man natürlich bereits
-auf der ersten Seite wissen, worum es sich handelt. Darüber hinaus werden
-Tabellen zeilenweise von oben nach unten gelesen. Damit gibt es mindestens
-zwei gute Gründe, in der Regel alle Tabellen mit Überschriften zu
-versehen. \KOMAScript{}\important{\OptionValue{captions}{tableheading}} bietet
-daher mit der Einstellung \OptionValue{captions}{tableheading}%
-\IndexOption{captions~=\PValue{tableheading}} die Möglichkeit, bei Tabellen
-die Formatierung auf Überschriften zu ändern.
+Anweisung \DescRef{\LabelBase.cmd.caption}\IndexCmd{caption} (siehe unten)
+gesetzt werden, als Unterschrift formatiert. Darüber hinaus wird zwischen
+ein"~ und mehrzeiligen Unterschriften unterschieden, wobei einzeilige
+Unterschriften horizontal zentriert werden.
+
+\leavevmode\LabelOptionValue{captions}{tableheading}\nobreak%
+Tabellen werden jedoch häufig mit
+Überschriften\important{\OptionValue{captions}{tableheading}} statt mit
+Unterschriften versehen. Das liegt daran, dass es auch Tabellen geben kann,
+die sich über mehrere Seiten erstrecken. Bei solchen Tabellen möchte man
+natürlich bereits auf der ersten Seite wissen, worum es sich handelt. Darüber
+hinaus werden Tabellen zeilenweise von oben nach unten gelesen. Damit gibt es
+mindestens zwei gute Gründe, in der Regel alle Tabellen mit Überschriften zu
+versehen. \KOMAScript{} bietet daher mit der Einstellung
+\OptionValue{captions}{tableheading}%
+\IndexOption{captions~=\textKValue{tableheading}} die Möglichkeit, bei
+Tabellen die Formatierung auf Überschriften zu ändern.
Es\textnote{Achtung!} sei an dieser Stelle darauf hingewiesen, dass
mehrseitige Tabellen nicht als Gleitumgebungen gesetzt werden können. Für den
automatischen Seitenumbruch von Tabellen werden außerdem Zusatzpakete wie
\Package{longtable}\IndexPackage{longtable} (siehe \cite{package:longtable})
-oder \Package{tabu}\IndexPackage{tabu} (siehe \cite{package:tabu}) benötigt.
+oder \Package{supertabular}\IndexPackage{supertabular} (siehe
+\cite{package:supertabular}) benötigt.
-Mit\important[i]{\begin{tabular}[t]{@{}l@{}}
- \Option{captions=}\\
- \quad\PValue{tablesignature}
- \end{tabular}} der Einstellung
+Mit\important{\OptionValue{captions}{tablesignature}}
+der Einstellung
\OptionValue{captions}{tablesignature}%
-\IndexOption{captions~=\PValue{tablesignature}}
+\IndexOption{captions~=\textKValue{tablesignature}}
wird wieder die Voreinstellung der Formatierung als Tabellenunterschrift
gewählt. Es\textnote{Achtung!} sei an dieser Stelle darauf hingewiesen, dass
die beiden Werte lediglich die Formatierung ändern. Der Ort, an dem die Über"~
oder Unterschrift gesetzt wird, hängt bei den Gleitumgebungen von
-\KOMAScript{} allein vom Ort ab, an dem die Anweisung \DescRef{\LabelBase.cmd.caption}
-verwendet wird. Dies ändert sich jedoch bei Verwendung des Pakets
-\Package{float}\IndexPackage{float} mit der Anweisung
+\KOMAScript{} allein vom Ort ab, an dem die Anweisung
+\DescRef{\LabelBase.cmd.caption} verwendet wird. Dies ändert sich jedoch bei
+Verwendung des Pakets \Package{float}\IndexPackage{float} mit der Anweisung
\Macro{restylefloat}\IndexCmd{restylefloat}\important{\Macro{restylefloat}}
(siehe \cite{package:float}).
-Natürlich existiert\ChangedAt{v3.09}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} mit den Optionen
-\OptionValue{captions}{figureheading}%
-\IndexOption{captions~=\PValue{figureheading}} und
+Natürlich\important{\OptionValue{captions}{figureheading}\\
+ \OptionValue{captions}{figuresignature}}
+existiert\ChangedAt{v3.09}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} mit den Optionen \OptionValue{captions}{figureheading}%
+\IndexOption{captions~=\textKValue{figureheading}} und
\OptionValue{captions}{figuresignature}%
-\IndexOption{captions~=\PValue{figuresignature}}
-auch die entsprechende Funktion für Abbildungen. Allerdings werden Abbildungen
-in der Regel wie im Falle von Fotos eher als Ganzes und im Falle von
-Diagrammen oder Graphen eher von unten links her betrachtet. In den wenigsten
-Fällen dürfte es daher sinnvoll sein, nur bei Abbildungen die Formatierung von
-Unterschriften in Überschriften zu ändern.
+\IndexOption{captions~=\textKValue{figuresignature}} auch die entsprechende
+Funktion für Abbildungen. Allerdings werden Abbildungen in der Regel wie im
+Falle von Fotos eher als Ganzes und im Falle von Diagrammen oder Graphen eher
+von unten links her betrachtet. In den wenigsten Fällen dürfte es daher
+sinnvoll sein, nur bei Abbildungen die Formatierung von Unterschriften in
+Überschriften zu ändern.
Manchmal wird jedoch gewünscht, alle Gleitumgebungen mit Überschriften zu
-versehen. Daher gibt es bei \KOMAScript{} die Einstellung
-\important[i]{\OptionValue{captions}{heading}\\
- \OptionValue{captions}{signature}} Optionen
-\OptionValue{captions}{heading}%
-\IndexOption{captions~=\PValue{heading}} und die
-umgekehrte Einstellung
-\OptionValue{captions}{signature}\IndexOption{captions~=\PValue{signature}},
+versehen. Daher gibt es bei \KOMAScript{} die Einstellungen\important{%
+ \OptionValue{captions}{heading}\\
+ \OptionValue{captions}{signature}} \OptionValue{captions}{heading}%
+\IndexOption{captions~=\textKValue{heading}} und
+\OptionValue{captions}{signature}\IndexOption{captions~=\textKValue{signature}},
mit der man die Formatierungen aller Gleitumgebungen entsprechend ändern
kann. Diese entfalten ihre Wirkung auch noch, wenn sie innerhalb einer
Gleitumgebung verwendet werden.
@@ -2920,28 +3235,40 @@ Sie, dass bei Verwendung des \Package{float}-Pakets die Einstellungen von
Unterschriften oder Überschriften nicht mehr funktionieren, sobald Sie
\Macro{restylefloat} auf Tabellen oder Abbildungen anwenden. Näheres zum
\Package{float}-Paket und \Macro{restylefloat} entnehmen Sie bitte
-\cite{package:float}. Die zusätzliche Unterstützung, die \KOMAScript{} bei
-Verwendung des \Package{float}-Pakets bietet, finden Sie bei der Erklärung zu
-\PValue{komaabove} (siehe \DescPageRef{\LabelBase.floatstyle.komaabove}).
-
-\leavevmode\phantomsection\nobreak
-\label{desc:maincls.option.captions.nooneline}\nobreak
-\label{desc:maincls.option.captions.oneline}\nobreak
-Bei \KOMAScript{} besteht darüber hinaus auch die Möglichkeit, mit der
-Einstellung
-\OptionValue{captions}{nooneline}\IndexOption{captions~=\PValue{nooneline}}%
-\important{\OptionValue{captions}{nooneline}} die Unterscheidung zwischen ein"~
-und mehrzeiligen Über"~ bzw. Unterschriften abzuschalten. Dies ist
-beispielsweise dann wichtig, wenn man keine Zentrierung wünscht. Die
-Voreinstellung, bei der einzeilige Über"~ und Unterschriften automatisch
-horizontal zentriert werden, entspricht der Einstellung
-\OptionValue{captions}{oneline}.
+\cite{package:float}. Dies gilt ebenso für \DescRef{\LabelBase.cmd.caption}
+innerhalb von neuen Gleitumgebungen, die mit \Package{float} definiert
+wurden. Zusätzliche Unterstützung, die \KOMAScript{} bei Verwendung des
+\Package{float}-Pakets bietet, finden Sie bei der Erklärung zu
+\PValue{komaabove} (siehe \DescPageRef{\LabelBase.floatstyle.komaabove}). Als
+Alternative zu \Package{float} sei auch die Verwendung von
+\DescRef{\LabelBase.cmd.captionof} (siehe
+\DescPageRef{\LabelBase.cmd.captionof}) und
+\DescRef{tocbasic.cmd.DeclareNewTOC} (siehe
+\DescPageRef{tocbasic.cmd.DeclareNewTOC}) erwähnt. Darüber hinaus sei bei
+Verwendung von \Package{float} ausdrücklich Paket
+\hyperref[cha:scrhack]{\Package{scrhack}}\IndexPackage{scrhack}%
+\important{\hyperref[cha:scrhack]{\Package{scrhack}}} (siehe
+\autoref{cha:scrhack} ab \autopageref{cha:scrhack} in
+\autoref{part:forExperts}) empfohlen.
+
+\leavevmode\LabelOptionValue{captions}{nooneline}\nobreak
+Bei\important{\OptionValue{captions}{nooneline}} \KOMAScript{} besteht darüber
+hinaus auch die Möglichkeit, mit der Einstellung
+\OptionValue{captions}{nooneline}\IndexOption{captions~=\textKValue{nooneline}}
+die Unterscheidung zwischen ein"~ und mehrzeiligen Über"~ bzw. Unterschriften
+abzuschalten. Dies ist beispielsweise dann wichtig, wenn man keine Zentrierung
+wünscht. Die\important{\OptionValue{captions}{oneline}}%
+\LabelOptionValue{captions}{oneline}
+Voreinstellung\textnote{Voreinstellung}, bei der einzeilige Über"~ und
+Unterschriften automatisch horizontal zentriert werden, entspricht der
+Einstellung \OptionValue{captions}{oneline}.
Als Besonderheit bietet \KOMAScript{} innerhalb von Gleitumgebungen die
Möglichkeit, den Titel statt als Über"~ oder Unterschrift neben den
-eigentlichen Inhalt zu setzen. Die\important{\DescRef{\LabelBase.env.captionbeside}} dazu
-notwendige Umgebung \DescRef{\LabelBase.env.captionbeside}\IndexEnv{captionbeside} ist
-ab \DescPageRef{\LabelBase.env.captionbeside} erklärt. Die Einstellungen für
+eigentlichen Inhalt zu
+setzen. Die\important{\DescRef{\LabelBase.env.captionbeside}} dazu notwendige
+Umgebung \DescRef{\LabelBase.env.captionbeside}\IndexEnv{captionbeside} ist ab
+\DescPageRef{\LabelBase.env.captionbeside} erklärt. Die Einstellungen für
diese Umgebung können ebenfalls mit der Option \Option{captions} geändert
werden. Die dabei möglichen Werte für die jeweilige \PName{Einstellung} sind
\autoref{tab:maincls.captions} zu entnehmen.
@@ -2962,31 +3289,32 @@ werden. Die dabei möglichen Werte für die jeweilige \PName{Einstellung} sind
\DescPageRef{\LabelBase.env.captionbeside}) werden mit der untersten
Grundlinie auf Höhe der untersten Grundlinie des Inhalts der Gleitumgebung
ausgerichtet.%
- \IndexOption{captions~=\PValue{bottombeside}}}%
+ \IndexOption{captions~=\textKValue{bottombeside}}}%
\entry{\PValue{centeredbeside}, \PValue{besidecentered},
\PValue{middlebeside}, \PValue{besidemiddle}}{%
Gleitumgebungstitel der Umgebung \DescRef{\LabelBase.env.captionbeside}
(siehe \autoref{sec:\LabelBase.floats},
\DescPageRef{\LabelBase.env.captionbeside}) werden zum Inhalt der
Gleitumgebung vertikal zentriert ausgerichtet.%
- \IndexOption{captions~=\PValue{centeredbeside}}}%
+ \IndexOption{captions~=\textKValue{centeredbeside}}}%
\entry{\PValue{figureheading}, \PValue{figureabove}, \PValue{abovefigure},
\PValue{topatfigure}%
- \IndexOption{captions~=\PValue{figureheading}}}{%
+ \IndexOption{captions~=\textKValue{figureheading}}}{%
\ChangedAt{v3.09}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
- Bei Abbildungen wird (ggf. abweichend von
+ Bei Abbildungen wird (gegebenenfalls abweichend von
\OptionValue{captions}{signature}) die Formatierung als Überschrift
gewählt.}%
\entry{\PValue{figuresignature}, \PValue{figurebelow}, \PValue{belowfigure},
\PValue{bottomatfigure}%
- \IndexOption{captions~=\PValue{figuresignature}}}{%
+ \IndexOption{captions~=\textKValue{figuresignature}}}{%
\ChangedAt{v3.09}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
- Bei Abbildungen wird (ggf. abweichend von \OptionValue{captions}{heading})
- die Formatierung als Unterschrift gewählt.}%
+ Bei Abbildungen wird (gegebenenfalls abweichend von
+ \OptionValue{captions}{heading}) die Formatierung als Unterschrift
+ gewählt.}%
\entry{\PValue{heading}, \PValue{above}, \PValue{top}%
- \IndexOption{captions~=\PValue{heading}}}{%
+ \IndexOption{captions~=\textKValue{heading}}}{%
Gleitumgebungstitel\ChangedAt{v3.09}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}} werden als Überschriften
formatiert. Dies hat jedoch keinen Einfluss darauf, ob sie über oder unter
@@ -2994,7 +3322,7 @@ werden. Die dabei möglichen Werte für die jeweilige \PName{Einstellung} sind
\OptionValue{captions}{tableheading} und
\OptionValue{captions}{figureheading}.}%
\entry{\PValue{innerbeside},
- \PValue{besideinner}\IndexOption{captions~=\PValue{innerbeside}}}{%
+ \PValue{besideinner}\IndexOption{captions~=\textKValue{innerbeside}}}{%
Gleitumgebungstitel der Umgebung \DescRef{\LabelBase.env.captionbeside}
(siehe \autoref{sec:\LabelBase.floats},
\DescPageRef{\LabelBase.env.captionbeside}) werden bei doppelseitigem Satz
@@ -3002,7 +3330,7 @@ werden. Die dabei möglichen Werte für die jeweilige \PName{Einstellung} sind
gesetzt. Dies entspricht im einseitigen Satz
\OptionValue{captions}{leftbeside}.}%
\entry{\PValue{leftbeside},
- \PValue{besideleft}\IndexOption{captions~=\PValue{leftbeside}}}{%
+ \PValue{besideleft}\IndexOption{captions~=\textKValue{leftbeside}}}{%
Gleitumgebungstitel der Umgebung \DescRef{\LabelBase.env.captionbeside}
(siehe \autoref{sec:\LabelBase.floats},
\DescPageRef{\LabelBase.env.captionbeside}) werden in der Voreinstellung
@@ -3010,13 +3338,13 @@ werden. Die dabei möglichen Werte für die jeweilige \PName{Einstellung} sind
\pventry{nooneline}{%
Einzeilige Über"~ und Unterschriften von Gleitumgebungen werden nicht
gesondert, sondern genau wie mehrzeilige behandelt.%
- \IndexOption{captions~=\PValue{nooneline}}}%
+ \IndexOption{captions~=\textKValue{nooneline}}}%
\pventry{oneline}{%
Einzeilige Über"~ und Unterschriften von Gleitumgebungen werden gesondert
behandelt, um sie horizontal zu zentrieren.%
- \IndexOption{captions~=\PValue{oneline}}}%
+ \IndexOption{captions~=\textKValue{oneline}}}%
\entry{\PValue{outerbeside}, \PValue{besideouter}%
- \IndexOption{captions~=\PValue{outerbeside}}}{%
+ \IndexOption{captions~=\textKValue{outerbeside}}}{%
Gleitumgebungstitel der Umgebung \DescRef{\LabelBase.env.captionbeside}
(siehe \autoref{sec:\LabelBase.floats},
\DescPageRef{\LabelBase.env.captionbeside}) werden bei doppelseitigem Satz
@@ -3024,13 +3352,13 @@ werden. Die dabei möglichen Werte für die jeweilige \PName{Einstellung} sind
gesetzt. Dies entspricht im einseitigen Satz
\OptionValue{captions}{rightbeside}.}%
\entry{\PValue{rightbeside}, \PValue{besideright}%
- \IndexOption{captions~=\PValue{rightbeside}}}{%
+ \IndexOption{captions~=\textKValue{rightbeside}}}{%
Gleitumgebungstitel der Umgebung \DescRef{\LabelBase.env.captionbeside}
(siehe \autoref{sec:\LabelBase.floats},
\DescPageRef{\LabelBase.env.captionbeside}) werden in der Voreinstellung
rechts neben dem Inhalt der Gleitumgebung gesetzt.}%
\entry{\PValue{signature}, \PValue{below}, \PValue{bot}, \PValue{bottom}%
- \IndexOption{captions~=\PValue{signature}}}{%
+ \IndexOption{captions~=\textKValue{signature}}}{%
\ChangedAt{v3.09}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
Gleitumgebungstitel werden als Unterschriften formatiert. Dies hat jedoch
@@ -3039,21 +3367,23 @@ werden. Die dabei möglichen Werte für die jeweilige \PName{Einstellung} sind
und \OptionValue{captions}{figuresignature}.}%
\entry{\PValue{tableheading}, \PValue{tableabove}, \PValue{abovetable},
\PValue{abovetabular}, \PValue{topattable}%
- \IndexOption{captions~=\PValue{tableheading}}}{%
- Bei Tabellen wird (ggf. abweichend von \OptionValue{captions}{signature})
- die Formatierung als Überschrift gewählt.}%
+ \IndexOption{captions~=\textKValue{tableheading}}}{%
+ Bei Tabellen wird (gegebenenfalls abweichend von
+ \OptionValue{captions}{signature}) die Formatierung als Überschrift
+ gewählt.}%
\entry{\PValue{tablesignature}, \PValue{belowtable}, \PValue{belowtabular},
\PValue{bottomattable}%
- \IndexOption{captions~=\PValue{tablesignature}}}{%
- Bei Tabellen wird (ggf. abweichend von \OptionValue{captions}{heading})
- die Formatierung als Unterschrift gewählt.}%
+ \IndexOption{captions~=\textKValue{tablesignature}}}{%
+ Bei Tabellen wird (gegebenenfalls abweichend von
+ \OptionValue{captions}{heading}) die Formatierung als Unterschrift
+ gewählt.}%
\entry{\PValue{topbeside}, \PValue{besidetop}}{%
Gleitumgebungstitel der Umgebung \DescRef{\LabelBase.env.captionbeside}
(siehe \autoref{sec:\LabelBase.floats},
\DescPageRef{\LabelBase.env.captionbeside}) werden mit der obersten
Grundlinie auf Höhe der obersten Grundlinie des Inhalts der Gleitumgebung
ausgerichtet.%
- \IndexOption{captions~=\PValue{topbeside}}}%
+ \IndexOption{captions~=\textKValue{topbeside}}}%
\end{desclist}%
%
\EndIndexGroup
@@ -3082,8 +3412,8 @@ Anfang dieses Abschnitts zu finden ist. Aus Gründen der Kompatibilität ist
voreingestellt, dass sich \Macro{caption} bei allen Gleitumgebungen wie
\Macro{captionbelow} verhält. Es wird jedoch empfohlen\textnote{Tipp!},
Tabellenüberschriften zu verwenden und auf die Formatierung mit
-\OptionValueRef{\LabelBase}{captions}{tableheading} entsprechend umzustellen oder bei
-Tabellen auf \Macro{captionabove} zurück zu greifen.
+\OptionValueRef{\LabelBase}{captions}{tableheading} entsprechend umzustellen
+oder bei Tabellen auf \Macro{captionabove} zurück zu greifen.
%
\begin{Example}
Sie wollen mit
@@ -3147,12 +3477,13 @@ Tabellen auf \Macro{captionabove} zurück zu greifen.
\BeginIndex{FontElement}{captionlabel}\LabelFontElement{captionlabel}%
Die Schriftart\ChangedAt{v2.8p}{%
\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} für die
-Beschreibung und das Label~-- »Abbildung« oder »Tabelle« gefolgt von der
+Beschreibung und das Label~-- »Abbildung« oder »Tabelle«, gefolgt von der
Nummer und einem Trennzeichen -- kann über die Anweisungen
\DescRef{\LabelBase.cmd.setkomafont} und
\DescRef{\LabelBase.cmd.addtokomafont} (siehe
\autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont})
-verändert werden. Zuständig sind hier die Elemente \FontElement{caption} und
+verändert werden. Zuständig sind hier die Elemente \FontElement{caption}%
+\important[i]{\FontElement{caption}\\\FontElement{captionlabel}} und
\FontElement{captionlabel} (siehe \autoref{tab:maincls.fontelements},
\autopageref{tab:maincls.fontelements}). Dabei wird die Schriftart für das
Element \FontElement{caption} zunächst auch auf das Element
@@ -3216,21 +3547,24 @@ Anweisung \Macro{captionof}\ChangedAt{v3.05}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}} mit der man auch außerhalb einer
Gleitumgebung oder in einer fremden Gleitumgebung einen entsprechenden Titel
mit Eintrag in das jeweilige Verzeichnis setzen kann. Dabei muss im Gegensatz
-zu \DescRef{\LabelBase.cmd.caption} die Art des Gleitobjekts als zusätzliches erstes Argument
-angegeben werden.
+zu \DescRef{\LabelBase.cmd.caption} die Art des Gleitobjekts als zusätzliches
+erstes Argument angegeben werden.
-Darüber hinaus bietet \KOMAScript{} zusätzlich auch die
-Anweisungen \Macro{captionaboveof}\ChangedAt{v3.09}{\Class{scrbook}\and
+Darüber hinaus bietet \KOMAScript{} zusätzlich auch die Anweisungen
+\Macro{captionaboveof}\ChangedAt{v3.09}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}} und \Macro{captionbelowof}. Diese
-dienen als Gegenstücke zu \Macro{captionabove} und \Macro{captionbelow}.
+dienen als Gegenstücke zu \DescRef{\LabelBase.cmd.captionabove} und
+\DescRef{\LabelBase.cmd.captionbelow}.
Selbstverständlich berücksichtigt\ChangedAt{v3.09a}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}} \Macro{captionof} auch die
-Einstellungen von Option \DescRef{\LabelBase.option.captions} bezüglich der Formatierung des
-Titels als Über- oder Unterschrift. Diese Fähigkeit geht jedoch eventuell
-durch das Laden von Paketen wie \Package{capt-of} oder \Package{caption}
-verloren. Bei Verwendung von \Package{caption} ist die Anleitung zu diesem
-Paket zu beachten!%
+Einstellungen von Option \DescRef{\LabelBase.option.captions} bezüglich der
+Formatierung des Titels als Über- oder Unterschrift. Diese Fähigkeit geht
+jedoch eventuell durch das Laden von Paketen wie
+\Package{capt-of}\IndexPackage{capt-of} oder
+\Package{caption}\IndexPackage{caption} verloren. Bei Verwendung von
+\Package{caption} ist die Anleitung zu diesem Paket zu beachten (siehe
+\cite{package:caption})!%
\begin{Example}
Angenommen, Sie wollen ein Gleitobjekt erstellen, bei dem eine Tabelle und
eine Abbildung nebeneinander stehen. Da es keine gemischten Gleitobjekte gibt,
@@ -3239,7 +3573,7 @@ Paket zu beachten!%
\begin{figure}
\begin{minipage}{.5\linewidth}
\centering
- \rule{4cm}{3cm}
+ \rule{4cm}{5cm}
\caption{Ein Rechteck}\label{fig:rechteck}
\end{minipage}%
\begin{minipage}{.5\linewidth}
@@ -3251,7 +3585,7 @@ Paket zu beachten!%
\label{tab:rechteck}
\begin{tabular}{ll}
Breite: & 4\,cm\\
- Höhe: & 3\,cm
+ Höhe: & 5\,cm
\end{tabular}
\end{minipage}
\end{figure}
@@ -3292,7 +3626,7 @@ Paket zu beachten!%
\raisebox{\depth}{\fbox{\KOMAoptions{captions=oneline}%
\begin{minipage}{.5\dimexpr\linewidth-2\fboxsep-2\fboxrule\relax}
\centering
- \rule{4cm}{3cm}
+ \rule{4cm}{5cm}
\caption[Beispiel: Ein Rechteck]{Ein Rechteck}\label{fig:maincls.rechteck}
\end{minipage}%
\begin{minipage}{.5\dimexpr\linewidth-2\fboxsep-2\fboxrule\relax}
@@ -3302,7 +3636,7 @@ Paket zu beachten!%
\label{tab:maincls.rechteck}
\begin{tabular}{ll}
Breite: & 4\,cm\\
- Höhe: & 3\,cm
+ Höhe: & 5\,cm
\end{tabular}
\end{minipage}}}%
\end{minipage}%
@@ -3316,7 +3650,7 @@ sollte in der Regel eine \Environment{minipage} verwendet werden, um zu
verhindern, dass zwischen Überschrift und Tabelle ein Seitenumbruch erfolgen
kann. Zusätzlich sollte man die \Environment{minipage} dann noch in eine
\Environment{flushleft}-Umgebung einbetten, um einerseits einen gefälligen
-Abstand zum Text davor und dahinter zu erreichen, und andererseits den
+Abstand zum Text davor und dahinter zu erreichen und andererseits den
Absatzeinzug vor der \Environment{minipage} zu verhindern.%
\EndIndexGroup
@@ -3342,24 +3676,24 @@ Absatzeinzug vor der \Environment{minipage} zu verhindern.%
\end{Declaration}
Neben \ChangedAt{v2.8q}{%
\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
-den Unter- und Überschriften findet man insbesondere bei kleineren
-Abbildungen häufiger Beschreibungen, die neben der Abbildung gesetzt
-werden. Dabei schließt normalerweise die Unterkante der Beschreibung
-mit der Unterkante der Abbildung ab. Natürlich kann man mit etwas
-Geschick und beispielsweise zwei \Macro{parbox}-Anweisungen
-dergleichen auch in den Standardklassen erreichen. \KOMAScript{}
-bietet jedoch eine spezielle Umgebung. Diese Umgebung kann innerhalb
-der Gleitumgebungen verwendet werden. Der erste optionale Parameter
-\PName{Verzeichnistitel} und der obligatorische Parameter
-\PName{Titel} entsprechen dabei genau den gleichnamigen Parametern von
-\DescRef{\LabelBase.cmd.caption}, \DescRef{\LabelBase.cmd.captionabove} oder \DescRef{\LabelBase.cmd.captionbelow}. Der
-\PName{Titel} wird dabei neben den Inhalt der Umgebung gesetzt.
-
-Ob der \PName{Titel} rechts oder links daneben gesetzt wird, kann mit
-dem optionalen Parameter \PName{Anordnung} bestimmt werden. Es darf
-genau einer der folgenden Buchstaben angegeben werden:
-\iffree{}{\enlargethispage*{\dp\strutbox}}% Umbruchkorrektur
-\begin{labeling}[~--]{\quad\PValue{o}}\setlength{\itemsep}{-\parsep}%
+den Unter- und Überschriften findet man insbesondere bei kleineren Abbildungen
+häufiger Beschreibungen, die neben der Abbildung gesetzt werden. Dabei
+schließt normalerweise die Unterkante der Beschreibung mit der Unterkante der
+Abbildung ab. Natürlich kann man mit etwas Geschick und beispielsweise zwei
+\Macro{parbox}-Anweisungen dergleichen auch in den Standardklassen
+erreichen. \KOMAScript{} bietet jedoch eine spezielle Umgebung. Diese Umgebung
+kann innerhalb der Gleitumgebungen verwendet werden. Der erste optionale
+Parameter \PName{Verzeichnistitel}%
+\important{\PName{Verzeichnistitel}\\\PName{Titel}} und der obligatorische
+Parameter \PName{Titel} entsprechen genau den gleichnamigen Parametern von
+\DescRef{\LabelBase.cmd.caption}, \DescRef{\LabelBase.cmd.captionabove} oder
+\DescRef{\LabelBase.cmd.captionbelow}. Der \PName{Titel} wird neben den Inhalt
+der Umgebung gesetzt.
+
+Ob\important{\PName{Anordnung}} der \PName{Titel} rechts oder links daneben
+gesetzt wird, kann mit dem optionalen Parameter \PName{Anordnung} bestimmt
+werden. Es darf genau einer der folgenden Buchstaben angegeben werden:
+\begin{labeling}[~--]{\quad\PValue{o}}\setlength{\itemsep}{-1\parsep plus 1ex}%
\item[\quad\PValue{l}] links
\item[\quad\PValue{r}] rechts
\item[\quad\PValue{i}] innen: auf rechten Seiten links, auf
@@ -3370,50 +3704,50 @@ genau einer der folgenden Buchstaben angegeben werden:
Voreingestellt ist rechts neben dem Inhalt der Umgebung. Diese
Voreinstellung\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} kann jedoch mit der Option
-\DescRef{\LabelBase.option.captions}\IndexOption{captions}\important{\DescRef{\LabelBase.option.captions}} (siehe
+\DescRef{\LabelBase.option.captions}\IndexOption{captions}%
+\important{\DescRef{\LabelBase.option.captions}} (siehe
\DescPageRef{\LabelBase.option.captions}) und deren Werte
-\PValue{innerbeside}\IndexOption[indexmain]{captions~=\PValue{innerbeside}},
-\PValue{leftbeside}\IndexOption[indexmain]{captions~=\PValue{leftbeside}},
-\PValue{outerbeside}\IndexOption[indexmain]{captions~=\PValue{outerbeside}}
+\PValue{innerbeside}\IndexOption[indexmain]{captions~=\textKValue{innerbeside}},
+\PValue{leftbeside}\IndexOption[indexmain]{captions~=\textKValue{leftbeside}},
+\PValue{outerbeside}\IndexOption[indexmain]{captions~=\textKValue{outerbeside}}
und
-\PValue{rightbeside}\IndexOption[indexmain]{captions~=\PValue{rightbeside}}
+\PValue{rightbeside}\IndexOption[indexmain]{captions~=\textKValue{rightbeside}}
verändert werden. Bei Verwendung der Anordnung außen oder innen werden unter
Umständen zwei \LaTeX-Läufe benötigt, um die korrekte Anordnung zu erreichen.
-Normalerweise nehmen der Inhalt der Umgebung und der \PName{Titel} die
-gesamte verfügbare Breite ein. Es besteht jedoch die Möglichkeit, mit
-dem optionalen Parameter \PName{Breite} eine andere Breite
-anzugeben. Diese kann auch größer als die Breite des Textkörpers
-sein.
+Normalerweise\important{\PName{Breite}} nehmen der Inhalt der Umgebung und der
+\PName{Titel} die gesamte verfügbare Breite ein. Es besteht jedoch die
+Möglichkeit, mit dem optionalen Parameter \PName{Breite} eine andere Breite
+anzugeben. Diese kann auch größer als die Breite des Textkörpers sein.
-Bei Angabe einer \PName{Breite} wird die genutzte Breite
-normalerweise bezüglich der Breite des Textkörpers zentriert. Mit dem
-optionalen Argument \PName{Offset} kann stattdessen eine Verschiebung
-relativ zum linken Rand angegeben werden. Ein positiver Wert
+Bei Angabe einer \PName{Breite}\important{\PName{Breite}\\\PName{Offset}} wird
+die genutzte Breite normalerweise bezüglich der Breite des Textkörpers
+zentriert. Mit dem optionalen Argument \PName{Offset} kann stattdessen eine
+Verschiebung relativ zum linken Rand angegeben werden. Ein positiver Wert
entspricht einer Verschiebung nach rechts, ein negativer Wert einer
-Verschiebung nach links. Mit einem \PName{Offset} von 0\Unit{pt}
-erfolgt die Ausgabe linksbündig.
-
-Wird hinter den optionalen Parameter \PName{Offset} noch ein Stern
-gesetzt, so stellt der \PName{Offset} im doppelseitigen Druck auf
-linken Seiten eine Verschiebung relativ zum rechten Rand dar. Ein
-positiver Wert entspricht dann einer Verschiebung nach außen, während
-ein negativer Wert für eine Verschiebung nach innen steht. Ein
-\PName{Offset} von 0\Unit{pt} wäre dann also bündig zum inneren
-Rand. Diese Variante benötigt unter Umständen zwei \LaTeX-Durchläufe,
-um die korrekte Verschiebung zu erreichen.
+Verschiebung nach links. Mit einem \PName{Offset} von 0\Unit{pt} erfolgt die
+Ausgabe linksbündig.
+
+Wird\important{\PValue{*}} hinter den optionalen Parameter \PName{Offset} noch
+ein Stern gesetzt, so stellt der \PName{Offset} im doppelseitigen Druck auf
+linken Seiten eine Verschiebung relativ zum rechten Rand dar. Ein positiver
+Wert entspricht dann einer Verschiebung nach außen, während ein negativer Wert
+für eine Verschiebung nach innen steht. Ein \PName{Offset} von 0\Unit{pt} wäre
+dann also bündig zum inneren Rand. Diese Variante benötigt unter Umständen
+zwei \LaTeX-Durchläufe, um die korrekte Verschiebung zu erreichen.
Vertikal erfolgt die Ausrichtung in der Voreinstellung unten. Das bedeutet,
dass die untere Grundlinie des Inhalts des Gleitobjekts und die untere
Grundlinie von \PName{Titel} auf einer Höhe liegen. Diese
Einstellung\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} kann mit der Option
-\DescRef{\LabelBase.option.captions}\IndexOption{captions} (siehe
+\DescRef{\LabelBase.option.captions}\IndexOption{captions}%
+\important{\DescRef{\LabelBase.option.captions}} (siehe
\DescPageRef{\LabelBase.option.captions}) und deren Werte
-\PValue{topbeside}\IndexOption[indexmain]{captions~=\PValue{topbeside}},
-\PValue{centeredbeside}\IndexOption[indexmain]{captions~=\PValue{centeredbeside}}
-und
-\PValue{bottombeside}\IndexOption[indexmain]{captions~=\PValue{bottombeside}}
+\PValue{topbeside}\IndexOption[indexmain]{captions~=\textKValue{topbeside}},
+\PValue{centeredbeside}%
+\IndexOption[indexmain]{captions~=\textKValue{centeredbeside}} und
+\PValue{bottombeside}\IndexOption[indexmain]{captions~=\textKValue{bottombeside}}
verändert werden. Bei der Einstellung \PValue{topbeside} werden die oberen
Grundlinien von Gleitobjektinhalt und \PName{Titel} auf einer Höhe
ausgerichtet, während bei \PValue{centeredbeside} eine Zentrierung
@@ -3612,7 +3946,7 @@ Originaldefinition lautet:
Auch diese kann mit \Macro{renewcommand} geändert werden.
\begin{Example}
Aus mir unerfindlichen Gründen wollen Sie als Trennzeichen
- keinen Doppelpunkt gefolgt von einem Leerzeichen, sondern einen
+ keinen Doppelpunkt, gefolgt von einem Leerzeichen, sondern einen
Gedankenstrich einschließlich der notwendigen Leerzeichen.
Daher definieren Sie:
\begin{lstcode}
@@ -3787,7 +4121,9 @@ die maximale für die Beschreibung verwendete \PName{Breite} an. Als optionales
Argument kann genau ein Buchstabe übergeben werden, der die horizontale
Ausrichtung der Beschreibung angibt. Die möglichen Ausrichtungen finden Sie in
der folgenden Liste.
-\begin{labeling}[~--]{\quad\PValue{o}}\rightskip=1em
+\begin{labeling}[~--]{\quad\PValue{o}}%
+ \itemsep=.5\topsep plus .5\topsep minus .5\topsep
+ \rightskip=1em
\item[\quad\PValue{l}] linksbündig
\item[\quad\PValue{c}] zentriert
\item[\quad\PValue{r}] rechtsbündig
@@ -3802,17 +4138,18 @@ rechtsbündig. Innerhalb\textnote{Achtung!} von
\important{\Package{longtable}} funktioniert die Ausrichtung innen und außen
nicht korrekt. Insbesondere werden Beschreibungen von Folgeseiten bei diesen
Tabellen immer nach den Beschreibungen der ersten Teiltabelle
-ausgerichtet. Dies ist ein konzeptionelles Problem des Paketes
+ausgerichtet. Dies ist ein konzeptionelles Problem des Pakets
\Package{longtable}.
Zu\ChangedAt{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}\textnote{Achtung!} beachten ist, dass die an
\Macro{setcapwidth} übergebene \PName{Breite} wie bei \Macro{setlength} zum
-Zeitpunkt der Zuweisung ausgewertet wird. Will man hingegen, dass
-\PName{Breite} erst bei der Verwendung ausgewertet wird, dann sollte man
-stattdessen \Macro{setcapdynwidth} verwenden. Entscheidende Unterschiede gibt
-es beispielsweise, wenn Längen wie \Length{linewidth} oder andere Anweisungen
-als Argument verwendet werden.
+Zeitpunkt der Zuweisung ausgewertet
+wird. Will\important{\Macro{setcapdynwidth}} man hingegen, dass \PName{Breite}
+erst bei der Verwendung ausgewertet wird, dann sollte man stattdessen
+\Macro{setcapdynwidth} verwenden. Entscheidende Unterschiede gibt es
+beispielsweise, wenn Längen wie \Length{linewidth} oder andere Anweisungen als
+Argument verwendet werden.
Mit\important{\Macro{setcapmargin}} der Anweisung \Macro{setcapmargin} kann
statt der Breite der Beschreibung ein \PName{Rand} angegeben werden, der neben
@@ -3835,13 +4172,130 @@ die mit dieser Randeinstellung gesetzt werden.
Man\textnote{Tipp!} kann übrigens auch negative Werte für \PName{Rand} und
\PName{Rand \kern-.25em rechts} oder \PName{Rand \kern-.25em außen}
angeben. Dadurch erreicht man, dass die Beschreibung in den entsprechenden
-Rand hineinragt.
-
+Rand hineinragt.%
+\iffalse\par% Anhang wurde entfernt.
Für\textnote{Tipp!} Experten und versierte Anwender ist eine etwas
trickreiche Anwendung für \Macro{setcapwidth} in
\iffree{\cite{book:komascript}}{\autoref{cha:floattricks},
\autopageref{cha:floattricks}} zu finden.%
+\fi%
+%
+\EndIndexGroup
+
+\begin{Declaration}
+ \Macro{setcaptionalignment}\OParameter{Gleitumgebung}\Parameter{Ausrichtung}
+\end{Declaration}
+Normalerweise\ChangedAt{v3.25}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} werden mehrzeilige\textnote{Ausrichtung mehrzeiliger
+ Beschreibungen} Beschreibungen im Blocksatz gesetzt. Dies entspricht
+\Macro{setcaptionalignment}\PParameter{j}. Manchmal wird allerdings eine davon
+abweichende Ausrichtung gewünscht, beispielsweise linksbündiger
+Flattersatz. Eine entsprechende Änderung ist mit \Macro{setcaptionalignment}
+jederzeit möglich. Für \PName{Ausrichtung} kann dabei genau einer der
+Buchstaben aus \autoref{tab:maincls.captionalignment} angegeben werden. Wird
+eine unbekannte \PName{Ausrichtung} angegeben, so resultiert dies in einer
+Fehlermeldung.
+%
+\begin{table}
+% \centering
+ \KOMAoptions{captions=topbeside}%
+ \setcapindent{0pt}%
+ \begin{captionbeside}
+ [{Ausrichtungen für mehrzeilige Beschreibungen von Gleitumgebungen}]
+ {\label{tab:maincls.captionalignment}%
+ Ausrichtungen für mehrzeilige Beschreibungen von Gleitumgebungen}
+ [l]
+ \begin{tabular}[t]{ll}
+ \toprule
+ c & zentriert \\
+ j & Blocksatz \\
+ l & linksbündig \\
+ r & rechtsbündig \\
+ C & zentriert mit \Package{ragged2e} \\
+ J & Blocksatz mit \Package{ragged2e} \\
+ L & linksbündig mit \Package{ragged2e} \\
+ R & rechtsbündig mit \Package{ragged2e} \\
+ \bottomrule
+ \end{tabular}
+ \end{captionbeside}
+\end{table}
+
+Die vier Möglichkeiten mit Paket
+\Package{ragged2e}\important{\Package{ragged2e}}\IndexPackage{ragged2e} stehen
+nur zur Verfügung, wenn das Paket vor Verwendung von
+\Macro{setcaptionalignment} geladen wurde. Anderenfalls werden sie auf die
+entsprechenden Möglichkeiten ohne \Package{ragged2e} abgebildet. Zur
+Sicherheit wird in diesem Fall eine Warnung ausgegeben.
+
+Verwendet man den Befehl ohne\textnote{kein optionaler Parameter} den
+optionalen Parameter, so hängt das Ergebnis davon ab, ob der Aufruf innerhalb
+oder außerhalb einer Gleitumgebung stattfindet. Innerhalb einer Gleitumgebung
+wird dann die Ausrichtung für diese Gleitumgebung gesetzt. Außerhalb wird
+hingegen ein leerer optionaler Parameter angenommen.
+
+Beim Aufruf mit einem leeren\textnote{leerer optionaler Parameter} optionalen
+Parameter oder außerhalb einer Gleitumgebung auch komplett ohne optionalen
+Parameter wird die allgemeine Ausrichtung festgelegt. Diese wird immer dann
+verwendet, wenn keine Ausrichtung für den aktuellen Gleitumgebungstyp
+definiert ist.
+
+Will man nur die Ausrichtung eines bestimmen Typs\textnote{mit
+ \PName{Gleitumgebung}} von Gleitumgebungen festlegen, ohne
+\PName{Ausrichtung} auch für andere Arten von Gleitumgebungen zu verändern, so
+gibt man den Typ der Gleitumgebung, beispielsweise \PValue{figure} oder
+\PValue{table}, als optionalen Parameter \PName{Gleitumgebung} an.
%
+\begin{Example}
+ Sie wollen, dass Bildunterschriften auch dann vollständig zentriert unter
+ den Bildern stehen, wenn sie mehrzeilig sind. Um das zunächst einmal nur für
+ eine einzige Abbildung zu testen, verwenden Sie\textnote{in der
+ Gleitumgebung}:
+\begin{lstcode}
+ \begin{figure}
+ \centering
+ \setcaptionalignment{c}
+ \includegraphics{example-image}
+ \caption{\blindtext}
+ \end{figure}
+\end{lstcode}
+ Da Sie mit dem Ergebnis zufrieden sind, verschieben Sie die
+ Anweisung\textnote{in der Dokumentpräambel}
+\begin{lstcode}
+ \setcaptionalignment{c}
+\end{lstcode}
+ in die Dokumentpräambel. Daraufhin bemerken Sie allerdings, dass Ihnen
+ diese Änderung für Tabellenüberschriften überhaupt nicht gefällt. Daher
+ beschränken Sie mit\textnote{nur für Abbildungen}
+\begin{lstcode}
+ \setcaptionalignment[figure]{c}
+\end{lstcode}
+ die Zentrierung auf Abbildungen.
+
+ Etwas später stellen Sie fest, dass die Zentrierung doch nicht so günstig
+ ist. Stattdessen wollen Sie nun lieber eine linksbündige Ausrichtung im
+ Flattersatz haben. Also ändern Sie die Anweisung erneut zu:
+\begin{lstcode}
+ \setcaptionalignment[figure]{l}
+\end{lstcode}
+ Allerdings gefällt Ihnen nun nicht, dass die Zeilen sehr unterschiedlich
+ lang werden. Als Ursache machen Sie die fehlende Trennung aus, wodurch lange
+ Wörter komplett in die nächste Zeile rutschen und so große Lücken
+ hinterlassen. Also wollen Sie zusätzlich Trennung nach Bedarf
+ ermöglichen. Dies ist mit Hilfe des Pakets
+ \Package{ragged2e}\important{\Package{ragged2e}}\IndexPackage{ragged2e}
+ leicht möglich. Dabei genügt es allerdings nicht, das Paket mit
+\begin{lstcode}
+ \usepackage{ragged2e}
+\end{lstcode}
+ zu laden. Auch Option \Option{newcommands} beim Laden des Pakets bringt
+ keine Abhilfe. Stattdessen muss zusätzlich die \PName{Ausrichtung} geändert
+ werden:
+\begin{lstcode}
+ \usepackage{ragged2e}
+ \setcaptionalignment[figure]{L}
+\end{lstcode}
+ Beachten\textnote{Achtung!} Sie den Großbuchstabe für \PName{Ausrichtung}.
+\end{Example}
\EndIndexGroup
@@ -3866,16 +4320,16 @@ wird nicht unterstützt.
\OptionVName{listof}{Einstellung}
\end{Declaration}
Normalerweise\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} werden die Verzeichnisse der Gleitumgebungen -- wie das
+ \Class{scrartcl}} werden Verzeichnisse von Gleitumgebungen --~wie das
Tabellen"~\Index{Tabellen>Verzeichnis} und das
-Abbildungsverzeichnis\Index{Abbildungen>Verzeichnis} -- nicht nummeriert oder
+Abbildungsverzeichnis\Index{Abbildungen>Verzeichnis}~-- nicht nummeriert oder
in das Inhaltsverzeichnis aufgenommen. In \autoref{sec:\LabelBase.toc} wurde
dies bereits näher ausgeführt. Alternativ zu den dort erwähnten Einstellungen
\OptionValueRef{\LabelBase}{toc}{nolistof}%
-\IndexOption{toc~=\PValue{nolistof}},
-\OptionValueRef{\LabelBase}{toc}{listof}\IndexOption{toc~=\PValue{listof}} und
-\OptionValueRef{\LabelBase}{toc}{listofnumbered}%
-\IndexOption{toc~=\PValue{listofnumbered}}, kann dieses Verhalten auch aus
+\IndexOption{toc~=\textKValue{nolistof}},
+\OptionValueRef{\LabelBase}{toc}{listof}\IndexOption{toc~=\textKValue{listof}}
+und \OptionValueRef{\LabelBase}{toc}{listofnumbered}%
+\IndexOption{toc~=\textKValue{listofnumbered}}, kann dieses Verhalten auch aus
Sicht der Verzeichnisse selbst gesehen werden. Daher kann man die gleichen
Ergebnisse auch mit den Einstellungen \OptionValue{listof}{notoc},
\OptionValue{listof}{totoc} und \OptionValue{listof}{numbered} erreichen.
@@ -3887,7 +4341,11 @@ oberste verfügbare Gliederungsebene unterhalb von
Abschnittsebene. Mit\important{\OptionValue{listof}{leveldown}}%
\ChangedAt{v3.06}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}
Hilfe der Einstellung \OptionValue{listof}{leveldown} kann hingegen die nächst
-tiefere Gliederungsebene verwendet werden.
+tiefere Gliederungsebene verwendet
+werden. \important{\OptionValue{listof}{standardlevel}}%
+\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
+\OptionValue{listof}{standardlevel} schaltet bei Bedarf wieder zurück auf die
+voreingestellte Gliederungsebene.
\begin{Example}
Sie wollen in einem Buch das Abbildungs- und das Tabellenverzeichnis als
Unterverzeichnisse eines gemeinsamen Verzeichnisses »Abbildungen und
@@ -3912,14 +4370,14 @@ Verzeichnisse\Index{Abbildungen>Verzeichnis}\Index{Tabellen>Verzeichnis}
der Gleitumgebungen so formatiert, dass für die Nummer ein Raum fester Breite
verwendet wird. Gleichzeitig werden alle Einträge leicht eingezogen. Dies
entspricht der Verwendung der Einstellung
-\OptionValue{listof}{graduated}\IndexOption{listof~=\PValue{graduated}}.
+\OptionValue{listof}{graduated}\IndexOption{listof~=\textKValue{graduated}}.
Werden die Nummern sehr breit, weil beispielsweise sehr viele Tabellen
verwendet werden, so reicht der vorgesehene Platz irgendwann nicht mehr aus.
Vergleichbar\important{\OptionValue{listof}{flat}} zur Einstellung
-\OptionValueRef{\LabelBase}{toc}{flat}\IndexOption{toc~=\PValue{flat}} für das
+\OptionValueRef{\LabelBase}{toc}{flat}\IndexOption{toc~=\textKValue{flat}} für das
Inhaltsverzeichnis bietet \KOMAScript{} daher die Einstellung
-\OptionValue{listof}{flat}\IndexOption{listof~=\PValue{flat}} für die
+\OptionValue{listof}{flat}\IndexOption{listof~=\textKValue{flat}} für die
Verzeichnisse der Gleitumgebungen. Dabei wird die Breite der Nummern
automatisch ermittelt und der Platz entsprechend angepasst. Bezüglich der
Nebenwirkungen und Funktionsweise gilt, was in \autoref{sec:\LabelBase.toc},
@@ -3955,26 +4413,30 @@ auch bei den Standardklassen gibt, dient dazu, diese Verzeichnisse nach
Kapiteln zu gruppieren. Es entspricht bei \KOMAScript{} der
Einstellung\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} \OptionValue{listof}{chaptergapsmall}%
-\IndexOption{listof~=\PValue{chaptergapsmall}}. Dabei wird ein fester
+\LabelOptionValue{listof}{chaptergapsmall}%
+\important{\OptionValue{listof}{chaptergapsmall}}%
+\IndexOption{listof~=\textKValue{chaptergapsmall}}. Dabei wird ein fester
vertikaler Abstand von 10\Unit{pt}
verwendet. Mit\important{\OptionValue{listof}{chaptergapline}} der Einstellung
\OptionValue{listof}{chaptergapline}%
-\IndexOption{listof~=\PValue{chaptergapline}} kann man stattdessen einen
+\IndexOption{listof~=\textKValue{chaptergapline}} kann man stattdessen einen
vertikalen Abstand von einer Zeile
erreichen. Mit\important{\OptionValue{listof}{nochaptergap}}
-\OptionValue{listof}{nochaptergap}\IndexOption{listof~=\PValue{nochaptergap}}
+\OptionValue{listof}{nochaptergap}\IndexOption{listof~=\textKValue{nochaptergap}}
kann man den vertikalen Abstand komplett
abschalten. Eine\important{\OptionValue{listof}{chapterentry}} Besonderheit
stellt die Einstellung
-\OptionValue{listof}{chapterentry}\IndexOption{listof~=\PValue{chapterentry}}
+\OptionValue{listof}{chapterentry}\IndexOption{listof~=\textKValue{chapterentry}}
dar. Dabei wird statt des Abstandes der Inhaltsverzeichniseintrag für das
Kapitel in das Verzeichnis der Gleitumgebungen
eingefügt. Es\textnote{Achtung!} wird darauf hingewiesen, dass ein solcher
Eintrag auch dann erfolgt, wenn das Kapitel keine Gleitumgebung enthält. Eine
-noch direktere Beeinflussung, was in den Verzeichnissen der Gleitumgebungen
-bei neuen Kapiteln geschehen soll, ist mit der Option
-\DescRef{\LabelBase.option.chapteratlists} zu erreichen, die in
-\autoref{sec:\LabelBase.structure} auf
+Lösung, bei der nur Kapitel mit Gleitumgebungen im jeweiligen Verzeichnis
+angezeigt werden, finden Sie unter
+\cite{https://komascript.de/comment/5070}. Eine noch direktere Beeinflussung,
+was in den Verzeichnissen der Gleitumgebungen bei neuen Kapiteln geschehen
+soll, ist mit der Option \DescRef{\LabelBase.option.chapteratlists} zu
+erreichen, die in \autoref{sec:\LabelBase.structure} auf
\DescPageRef{\LabelBase.option.chapteratlists} erläutert wird.
Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von
@@ -3990,36 +4452,36 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von
\entry{\PValue{chapterentry}, \PValue{withchapterentry}}{%
Kapitelanfänge werden in den Verzeichnissen der Gleitumgebungen durch
einen Inhaltsverzeichniseintrag des Kapitels markiert.%
- \IndexOption{listof~=\PValue{chapterentry}}}%
+ \IndexOption{listof~=\textKValue{chapterentry}}}%
\entry{\PValue{chaptergapline}, \PValue{onelinechaptergap}}{%
Kapitelanfänge werden in den Verzeichnissen der Gleitumgebungen durch
einen Abstand von einer Zeile markiert.%
- \IndexOption{listof~=\PValue{chaptergapline}}}%
+ \IndexOption{listof~=\textKValue{chaptergapline}}}%
\entry{\PValue{chaptergapsmall}, \PValue{smallchaptergap}}{%
Kapitelanfänge werden in den Verzeichnissen der Gleitumgebungen durch
einen kleinen Abstand markiert.%
- \IndexOption{listof~=\PValue{chaptergapsmall}}}%
+ \IndexOption{listof~=\textKValue{chaptergapsmall}}}%
\entry{\PValue{entryprefix}}{%
\ChangedAt{v3.06}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
Jeder Verzeichniseintrag wird mit einem vom Verzeichnis abhängenden Präfix
vor der Nummer versehen. Der Präfix ist normalerweise sprachabhängig,
beispielsweise bei deutschen Spracheinstellungen »Abbildung« für das
- Abbildungsverzeichnis und »Tabelle« für das Tabellenverzeichnis jeweils
+ Abbildungsverzeichnis und »Tabelle« für das Tabellenverzeichnis, jeweils
gefolgt von einem Leerzeichen.%
- \IndexOption{listof~=\PValue{entryprefix}}}%
+ \IndexOption{listof~=\textKValue{entryprefix}}}%
\entry{\PValue{flat}, \PValue{left}}{%
Die Verzeichnisse der Gleitumgebungen erhalten eine tabellarische
Form. Die Gleitumgebungsnummern sind dabei die erste Spalte, der Titel die
zweite Spalte, die Seitenzahlen die dritte Spalte. Der Platz, der für die
Gleitumgebungsnummern reserviert wird, richtet sich nach dem benötigten
Platz des vorherigen \LaTeX-Laufs.%
- \IndexOption{listof~=\PValue{flat}}}%
+ \IndexOption{listof~=\textKValue{flat}}}%
\entry{\PValue{graduated}, \PValue{indent}, \PValue{indented}}{%
Die Verzeichnisse der Gleitumgebungen erhalten eine hierarchische Form. Es
steht nur ein begrenzter Platz für die Gleitumgebungsnummern zur
Verfügung.%
- \IndexOption{listof~=\PValue{graduated}}}%
+ \IndexOption{listof~=\textKValue{graduated}}}%
\entry{\PValue{indenttextentries}, \PValue{indentunnumbered},
\PValue{numberline}}{%
\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
@@ -4035,7 +4497,7 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von
aber dennoch mit Hilfe von \DescRef{tocbasic.cmd.addxcontentsline} (siehe
\autoref{sec:tocbasic.toc}, \DescPageRef{tocbasic.cmd.addxcontentsline})
erzeugt werden.%
- \IndexOption{toc~=\PValue{numberline}}}%
+ \IndexOption{toc~=\textKValue{numberline}}}%
\entry{\PValue{leftaligntextentries}, \PValue{leftalignunnumbered},
\PValue{nonumberline}}{%
\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
@@ -4043,7 +4505,7 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von
Die Eigenschaft \PValue{numberline} (siehe \autoref{sec:tocbasic.toc},
\DescPageRef{tocbasic.cmd.setuptoc}) wird für die Verzeichnisse der
Gleitumgebungen, beispielsweise das Abbildungs"~ und das
- Tabellenverzeichnis, gesetzt. Dadurch werden nicht nummerierte Einträge
+ Tabellenverzeichnis, gelöscht. Dadurch werden nicht nummerierte Einträge
linksbündig mit der Nummer von nummerierten Einträgen gleicher Ebene
gesetzt. Allerdings bieten die \KOMAScript-Klassen selbst keine nicht
nummerierten Einträge in diese Verzeichnisse. Dies hat daher nur
@@ -4051,29 +4513,32 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von
aber dennoch mit Hilfe von \DescRef{tocbasic.cmd.addxcontentsline} (siehe
\autoref{sec:tocbasic.toc}, \DescPageRef{tocbasic.cmd.addxcontentsline})
erzeugt werden.%
- \IndexOption{toc~=\PValue{numberline}}}%
+ \IndexOption{toc~=\textKValue{numberline}}}%
\entry{\PValue{leveldown}}{%
Die Verzeichnisse werden um eine Gliederungsebene nach unten verschoben.%
- \IndexOption{listof~=\PValue{leveldown}}}%
+ \IndexOption{listof~=\textKValue{leveldown}}}%
\entry{\PValue{nochaptergap}, \PValue{ignorechapter}}{%
Kapitelanfänge werden in den Verzeichnissen der Gleitumgebungen nicht
markiert.%
- \IndexOption{listof~=\PValue{nochaptergap}}}%
- \entry{\PValue{notoc}, \PValue{plainheading}}{%
+ \IndexOption{listof~=\textKValue{nochaptergap}}}%
+ \entry{\PValue{notoc}, \PValue{nottotoc}, \PValue{plainheading}}{%
Die Verzeichnisse der Gleitumgebungen, beispielsweise das Abbildungs"~ und
das Tabellenverzeichnis, erhalten keinen Eintrag im Inhaltsverzeichnis.%
- \IndexOption{listof~=\PValue{notoc}}}%
+ \IndexOption{listof~=\textKValue{nottotoc}}}%
\entry{\PValue{numbered}, \PValue{totocnumbered}, \PValue{tocnumbered},
- \PValue{numberedtotoc}}{%
+ \PValue{numberedtoc}, \PValue{numberedtotoc}}{%
Die Verzeichnisse der Gleitumgebungen, beispielsweise das Abbildungs"~ und
das Tabellenverzeichnis, erhalten einen Eintrag im Inhaltsverzeichnis und
werden nummeriert.%
- \IndexOption{listof~=\PValue{numbered}}}%
- \entry{\PValue{totoc}, \PValue{toc}, \PValue{notnumbered}}{%
+ \IndexOption{listof~=\textKValue{numbered}}}%
+ \entry{\PValue{standardlevel}}{%
+ Die Verzeichnisse liegen auf der üblichen Gliederungsebene.%
+ \IndexOption{listof~=\textKValue{standardlevel}}}%
+ \entry{\PValue{toc}, \PValue{totoc}, \PValue{notnumbered}}{%
Die Verzeichnisse der Gleitumgebungen, beispielsweise das Abbildungs"~ und
das Tabellenverzeichnis, erhalten einen Eintrag im Inhaltsverzeichnis,
ohne dass sie nummeriert werden.%
- \IndexOption{listof~=\PValue{totoc}}}%
+ \IndexOption{listof~=\textKValue{totoc}}}%
\end{desclist}
%
\EndIndexGroup
@@ -4093,7 +4558,7 @@ mit den Werten \PValue{graduated} und \PValue{flat} beeinflusst werden (siehe
die Werte \PValue{listof} und \PValue{listofnumbered} für die Option
\DescRef{\LabelBase.option.toc}\important{\DescRef{\LabelBase.option.toc}}
(siehe \autoref{sec:\LabelBase.toc}, \DescPageRef{\LabelBase.option.toc}),
-sowie die Werte \PValue{totoc} und \PValue{totocnumbered} der oben erläuterten
+sowie die Werte \PValue{totoc} und \PValue{numbered} der oben erläuterten
Option \DescRef{\LabelBase.option.listof} auf die Verzeichnisse aus.
In\textnote{Tipp!} der Regel findet man die Verzeichnisse der
@@ -4137,8 +4602,10 @@ eingehalten werden. Diese Regeln sind in der Beschreibung der Option
\DescPageRef{\LabelBase.option.numbers} näher erläutert.
Die Form der Kapitelüberschriften\OnlyAt{\Class{scrbook}\and \Class{scrreprt}}
-im Anhang wird durch die Optionen \DescRef{\LabelBase.option.chapterprefix}
-und \DescRef{\LabelBase.option.appendixprefix} bestimmt. Näheres dazu ist
+im Anhang wird durch die Optionen \DescRef{\LabelBase.option.chapterprefix}%
+\important{\DescRef{\LabelBase.option.chapterprefix}\\
+ \DescRef{\LabelBase.option.appendixprefix}} und
+\DescRef{\LabelBase.option.appendixprefix} bestimmt. Näheres dazu ist
\autoref{sec:\LabelBase.structure},
\DescPageRef{\LabelBase.option.appendixprefix} zu entnehmen.
@@ -4187,63 +4654,58 @@ einige wenige Eigenschaften der Formatierung der Einträge beeinflusst werden.
Mit\important{\OptionValue{bibliography}{oldstyle}}
\OptionValue{bibliography}{oldstyle}%
-\IndexOption{bibliography~=\PValue{oldstyle}} wird
-die kompakte Formatierung gewählt. Dabei führt die Anweisung
-\DescRef{maincls-experts.cmd.newblock}\IndexCmd{newblock} in den einzelnen Einträgen lediglich zu
-einem dehnbaren horizontalen Abstand. Der Name kommt daher, dass dies die
-häufigste klassische Form eines Literaturverzeichnisses
-ist. Demgegenüber\important[i]{\begin{tabular}[t]{@{}l@{}}
- \Option{bibliography=}\\
- \quad\PValue{openstyle}\end{tabular}} erreicht
+\IndexOption{bibliography~=\textKValue{oldstyle}} wird die kompakte Formatierung
+gewählt. Dabei führt die Anweisung
+\DescRef{maincls-experts.cmd.newblock}\IndexCmd{newblock} in den einzelnen
+Einträgen lediglich zu einem dehnbaren horizontalen Abstand. Der Name kommt
+daher, dass dies die häufigste klassische Form eines Literaturverzeichnisses
+ist. Demgegenüber\important{\OptionValue{bibliography}{openstyle}} erreicht
man die etwas modernere, offene Form mit der Einstellung
\OptionValue{bibliography}{openstyle}%
-\IndexOption{bibliography~=\PValue{openstyle}}. Der
-Name kommt daher, dass hier die Anweisung \DescRef{maincls-experts.cmd.newblock} einen Absatz
+\IndexOption{bibliography~=\textKValue{openstyle}}. Der Name kommt daher, dass
+hier die Anweisung \DescRef{maincls-experts.cmd.newblock} einen Absatz
einfügt. Die Einträge im Literaturverzeichnis werden so stärker
gegliedert. Sie sind weniger kompakt und deutlich aufgelockerter oder
geöffnet. Bezüglich der Möglichkeit, neue Formatierungsstile zu definieren,
-sei auf \DescRef{maincls-experts.cmd.newbibstyle}, \autoref{sec:maincls-experts.experts},
+sei auf \DescRef{maincls-experts.cmd.newbibstyle},
+\autoref{sec:maincls-experts.experts},
\DescPageRef{maincls-experts.cmd.newbibstyle} verwiesen.
Neben dem Formatierungsstil gibt es eine weitere Eigenschaft, die über
\PName{Einstellung} verändert werden kann. Das Literaturverzeichnis stellt
eine Art von Verzeichnis dar, bei der nicht der Inhalt des vorliegenden Werks
-aufgelistet, sondern auf externe Inhalte verwiesen
-wird. Mit dieser Begründung
+aufgelistet, sondern auf externe Inhalte verwiesen wird. Mit dieser Begründung
könnte man argumentieren, dass das Literaturverzeichnis ein eigenes Kapitel
-bzw. einen eigenen Abschnitt darstellt und somit eine
-Nummer verdiene. Die
-Einstellung \OptionValue{bibliography}{totocnumbered}%
-\important[i]{\begin{tabular}[t]{@{}l@{}}
- \Option{bibliography=}\\
- \quad\PValue{totocnumbered}
- \end{tabular}}\IndexOption{bibliography~=\PValue{totocnumbered}} führt genau
-dazu, einschließlich des dann fälligen Eintrags im Inhaltsverzeichnis. Ich
-selbst bin der Meinung, dass bei dieser Argumentation auch ein klassisches,
+bzw. einen eigenen Abschnitt darstellt und somit eine Nummer verdiene. Die
+Einstellung \OptionValue{bibliography}{numbered}%
+\important{\OptionValue{bibliography}{numbered}}%
+\IndexOption{bibliography~=\textKValue{numbered}} führt genau dazu,
+einschließlich des dann fälligen Eintrags im Inhaltsverzeichnis. Ich selbst
+bin der Meinung, dass bei dieser Argumentation auch ein klassisches,
kommentiertes Quellenverzeichnis ein eigenes Kapitel wäre. Außerdem ist das
Literaturverzeichnis letztlich nichts, was man selbst geschrieben
-hat. Deshalb\important{\OptionValue{bibliography}{totoc}}
-verdient es allenfalls einen nicht nummerierten Eintrag im
-Inhaltsverzeichnis, was mit der Einstellung
-\OptionValue{bibliography}{totoc}\IndexOption{bibliography~=\PValue{totoc}}
+hat. Deshalb\important{\OptionValue{bibliography}{totoc}} verdient es
+allenfalls einen nicht nummerierten Eintrag im Inhaltsverzeichnis, was mit der
+Einstellung
+\OptionValue{bibliography}{totoc}\IndexOption{bibliography~=\textKValue{totoc}}
erreicht wird. Die Voreinstellung, bei der das Literaturverzeichnis als nicht
nummeriertes Kapitel ohne eigenen Inhaltsverzeichniseintrag gesetzt wird,
entspricht \OptionValue{bibliography}{nottotoc}%
-\IndexOption{bibliography~=\PValue{nottotoc}}. Siehe
-hierzu auch Option \DescRef{\LabelBase.option.toc} in \autoref{sec:\LabelBase.toc},
-insbesondere die Werte \PValue{bibliographynumbered}, \PValue{bibliography}
-und \PValue{nobibliography} ab
-\DescPageRef{\LabelBase.option.toc.bibliography}.
+\important{\OptionValue{bibliography}{nottotoc}}%
+\IndexOption{bibliography~=\textKValue{nottotoc}}. Siehe hierzu auch Option
+\DescRef{\LabelBase.option.toc} in \autoref{sec:\LabelBase.toc}, insbesondere
+die Werte \PValue{bibliographynumbered}, \PValue{bibliography} und
+\PValue{nobibliography} ab \DescPageRef{\LabelBase.option.toc.bibliography}.
In\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}
-einigen Fällen wird nicht das gesamte Dokumente mit einem einzigen
+einigen Fällen wird nicht das gesamte Dokument mit einem einzigen
Literaturverzeichnis versehen, sondern jedes Kapitel eines mit \Class{scrbook}
oder \Class{scrreprt} gesetzten Dokuments erhält sein eigenes
Literaturverzeichnis. In diesem Fall ist es sinnvoll,
wenn\important{\OptionValue{bibliography}{leveldown}} das Literaturverzeichnis
selbst nicht auf Kapitel, sondern etwas tiefer auf Abschnittsebene angesiedelt
wird. Dies ist mit Option \OptionValue{bibliography}{leveldown}%
-\IndexOption{bibliography~=\PValue{leveldown}} zu erreichen. Diese kann
+\IndexOption{bibliography~=\textKValue{leveldown}} zu erreichen. Diese kann
beispielsweise auch verwendet werden, wenn das Literaturverzeichnis zusammen
mit anderen Verzeichnissen unter einer gemeinsamen Überschrift erscheinen
soll. Daher ist diese Option auch in \Class{scrartcl} verfügbar.
@@ -4264,29 +4726,35 @@ weitere Werte definiert werden können.
\Class{scrartcl}}%
Das Literaturverzeichnis wird um eine Gliederungsebene nach unten
verschoben.%
- \IndexOption{bibliography~=\PValue{leveldown}}}%
- \pventry{nottotoc}{%
+ \IndexOption{bibliography~=\textKValue{leveldown}}}%
+ \entry{\PValue{notoc}, \PValue{nottotoc}, \PValue{plainheading}}{%
Das Literaturverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis und
wird auch nicht nummeriert.%
- \IndexOption{bibliography~=\PValue{nottotoc}}}%
+ \IndexOption{bibliography~=\textKValue{nottotoc}}}%
+ \entry{\PValue{numbered}, \PValue{tocnumbered}, \PValue{totocnumbered},
+ \PValue{numberedtoc}, \PValue{numberedtotoc}}{%
+ Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis und
+ wird nummeriert.%
+ \IndexOption{bibliography~=\textKValue{numbered}}}%
\pventry{oldstyle}{%
Es wird die klassische, kompakte Formatierung gewählt, bei der
\DescRef{maincls-experts.cmd.newblock}\IndexCmd{newblock} nur einen
dehnbaren horizontalen Abstand darstellt.%
- \IndexOption{bibliography~=\PValue{oldstyle}}}%
+ \IndexOption{bibliography~=\textKValue{oldstyle}}}%
\pventry{openstyle}{%
Es wird eine untergliederte, offene Formatierung gewählt, bei der
\DescRef{maincls-experts.cmd.newblock}\IndexCmd{newblock} einen Absatz
darstellt.%
- \IndexOption{bibliography~=\PValue{openstyle}}}%
- \pventry{totoc}{%
+ \IndexOption{bibliography~=\textKValue{openstyle}}}%
+ \pventry{standardlevel}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ Das Literaturverzeichnis liegt auf der üblichen Gliederungsebene.%
+ \IndexOption{bibliography~=\textKValue{standardlevel}}}%
+ \entry{\PValue{toc}, \PValue{totoc}, \PValue{notnumbered}}{%
Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis,
ohne dass es nummeriert wird.%
- \IndexOption{bibliography~=\PValue{totoc}}}%
- \pventry{totocnumbered}{%
- Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis und
- wird nummeriert.%
- \IndexOption{bibliography~=\PValue{totocnumbered}}}%
+ \IndexOption{bibliography~=\textKValue{totoc}}}%
\end{desctabular}
\end{table}
%
@@ -4301,8 +4769,8 @@ Literaturverzeichnis gesetzt werden. Bedingung dafür ist, dass die Präambel
vor der Anweisung zum Setzen des Literaturverzeichnisses gesetzt wird. Dies
muss nicht unmittelbar davor sein. Es kann also beispielsweise am Anfang des
Dokuments erfolgen. Ebenso\textnote{Achtung!} wie Option
-\OptionValue{bibliography}{totoc} oder
-\OptionValue{bibliography}{totocnumbered} kann die Anweisung aber nur
+\OptionValueRef{\LabelBase}{bibliography}{totoc} oder
+\OptionValueRef{\LabelBase}{bibliography}{numbered} kann die Anweisung aber nur
erfolgreich sein, wenn nicht ein Paket geladen wird, das dies durch
Umdefinierung der \Environment{thebibliography}-Umgebung verhindert. Obwohl
das \Package{natbib}-Paket\IndexPackage{natbib} nicht freigegebene interne
@@ -4397,7 +4865,7 @@ nicht jedoch bei Verwendung von
\end{Declaration}
\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
In der Voreinstellung
-\OptionValue{index}{default}\IndexOption{index~=\PValue{default}} ist das
+\OptionValue{index}{nottotoc}\IndexOption{index~=\textKValue{nottotoc}} ist das
Stichwortverzeichnis ein nicht nummeriertes Kapitel ohne Eintrag im
Inhaltsverzeichnis. Da\important{\OptionValue{index}{totoc}} das
Stichwortverzeichnis normalerweise in einem Buch oder ähnlichen Dokument
@@ -4405,14 +4873,30 @@ zuletzt steht, benötigt es eigentlich auch keinen
Inhaltsverzeichniseintrag. Wird dieser dennoch gewünscht, beispielsweise weil
wie in \iffree{dieser Anleitung}{diesem Buch} mit einem mehrgliedrigen
Stichwortverzeichnis gearbeitet wird, so kann dies mit der Einstellung
-\OptionValue{index}{totoc}\IndexOption{index~=\PValue{totoc}} erreicht
+\OptionValue{index}{totoc}\IndexOption{index~=\textKValue{totoc}} erreicht
werden. Soll\ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} der Index entgegen aller Gepflogenheiten sogar nummeriert
-werden, so verwendet man Option \OptionValue{index}{numbered}. Siehe hierzu
-auch Option \DescRef{\LabelBase.option.toc} mit dem Wert \PValue{index} oder
+ \Class{scrartcl}}\important{\OptionValue{index}{numbered}} der Index
+entgegen aller Gepflogenheiten sogar nummeriert werden, so verwendet man
+Option \OptionValue{index}{numbered}. Siehe hierzu auch Option
+\DescRef{\LabelBase.option.toc} mit dem Wert \PValue{index} oder
\PValue{indexnumbered} in \autoref{sec:\LabelBase.toc} ab
\DescPageRef{\LabelBase.option.toc.index}.
+Werden beispielsweise mit Hilfe von \Package{splitidx}\IndexPackage{splitidx}
+(siehe \cite{package:splitindex}) mehrere Stichwortverzeichnisse erstellt, so
+kann es sinnvoll sein, diese unter einer gemeinsamen Überschrift zusammen zu
+fassen. Um dies zu ermöglichen, kann mit \OptionValue{index}{leveldown}%
+\ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}\important{\OptionValue{index}{leveldown}} das Verzeichnis
+eine Gliederungsebene tiefer als üblich angesiedelt werden. Bei
+\Class{scrbook} und \Class{scrreprt} ist es dann also kein Kapitel mehr,
+sondern ein Abschnitt, bei \Class{scrartcl} entsprechend ein
+Unterabschnitt. Option \OptionValue{index}{standardlevel}%
+\ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}\important{\OptionValue{index}{standardlevel}} ist das
+Gegenstück dazu und hebt ein eventuell zuvor verwendetes
+\OptionValue{index}{leveldown} wieder auf.
+
Eine Zusammenfassung der möglichen Werte für die \PName{Einstellung} von
\Option{index} ist in \autoref{tab:maincls.index} zu finden.
@@ -4421,19 +4905,32 @@ Eine Zusammenfassung der möglichen Werte für die \PName{Einstellung} von
Option \Option{index} zur Einstellung des Stich\-wort\-verzeichnisses}
\label{tab:maincls.index}
\begin{desctabular}
- \entry{\PValue{default}, \PValue{nottotoc}, \PValue{plainheading}}{%
+ \pventry{leveldown}{%
+ \ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ Der Index wird um eine Gliederungsebene nach unten verschoben.%
+ \IndexOption{index~=\textKValue{leveldown}}%
+ }%
+ \entry{\PValue{notoc}, \PValue{nottotoc}, \PValue{plainheading}}{%
Das Stichwortverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis.%
- \IndexOption{index~=\PValue{default}}}%
- \entry{\PValue{numbered}, \PValue{totocnumbered}}{%
+ \IndexOption{index~=\textKValue{nottotoc}}}%
+ \entry{\PValue{numbered}, \PValue{tocnumbered}, \PValue{totocnumbered},
+ \PValue{numberedtoc}, \PValue{numberedtotoc}}{%
\ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
Das Stichwortverzeichnis erhält einen Eintrag im Inhaltsverzeichnis und
wird nummeriert.%
- \IndexOption{index~=\PValue{numbered}}}%
- \entry{\PValue{totoc}, \PValue{toc}, \PValue{notnumbered}}{%
+ \IndexOption{index~=\textKValue{numbered}}}%
+ \pventry{standardlevel}{%
+ \ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ Der Index liegt auf der üblichen Gliederungsebene.%
+ \IndexOption{index~=\textKValue{standardlevel}}%
+ }%
+ \entry{\PValue{toc}, \PValue{totoc}, \PValue{notnumbered}}{%
Das Stichwortverzeichnis erhält einen Eintrag im Inhaltsverzeichnis,
ohne dass er nummeriert wird.%
- \IndexOption{index~=\PValue{totoc}}}%
+ \IndexOption{index~=\textKValue{totoc}}}%
\end{desctabular}
\end{table}
%
@@ -4473,8 +4970,15 @@ ist im Makro \DescRef{\LabelBase.cmd.indexpagestyle} abgelegt (siehe
Für die Erstellung, Sortierung und Ausgabe des Stichwortverzeichnisses
sind die üblichen Standard-\LaTeX-Pakete und Zusatzprogramme
zuständig.%
-\iffalse % Umbruchoptimierung
- \ Von {\KOMAScript} werden genau wie von den Standardklassen
+\iftrue % Umbruchoptimierung
+ \iffree{}{ %
+ Besonders empfehlenswert ist beispielsweise das Paket
+ \Package{imakeidx}\IndexPackage{imakeidx} (siehe \cite{package:imakeidx}),
+ das unter anderem den Aufruf des Programms \File{makeindex} oder
+ \File{xindy} automatisiert. Damit entfällt eine häufige Fehlerquelle
+ insbesondere für \LaTeX-Anfänger.%
+ }
+ Von {\KOMAScript} werden genau wie von den Standardklassen
lediglich die grundlegenden Makros und Umgebungen dafür zur Verfügung
gestellt.%
\fi
@@ -4496,9 +5000,16 @@ zuständig.%
%%% End:
% LocalWords: Teildokumenten Klassenoption Tabellenunterschrift float
-% LocalWords: Satzspiegels Schrifteinstellung Abschnittseinträgen
+% LocalWords: Satzspiegels Schrifteinstellung Abschnittseinträgen Nachspann
% LocalWords: Vakatseiten Kolumnentitel Sternformen Teiltabelle Seitenstil
+% LocalWords: Bildunterschriften Dokumentpräambel Tabellenüberschriften
+% LocalWords: Gleitumgebungstyp Kapitelüberschriften Standardklassen
+% LocalWords: serifenlosen Abschnittseinträge Gliederungsebenen Paketoption
+% LocalWords: Nummerierungsstilen Seitenstilen Seitenankern Vakatseite
+% LocalWords: Nummerierungsstil Eingangskommentar Nummerierungsstils
+% LocalWords: Standardanweisung Einstellmöglichkeiten Umbruchkorrekturtext
+% LocalWords: Inhaltsverzeichniseintrag Formatierungsänderungen Präfixzeile
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrdatetime.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrdatetime.tex
index e0f282efa17..0a39c2767b1 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrdatetime.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrdatetime.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrdatetime.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrdatetime.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{scrdatetime.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-02-05 09:57:42 +0100 (Mon, 05 Feb 2018) $
KOMA-Script guide (chapter: scrdate, scrtime)]
\chapter{Der Wochentag mit \Package{scrdate}}
@@ -54,9 +54,9 @@
\BeginIndexGroup
\BeginIndex{Package}{scrdate}
-Mit Version~3.05a wurde der Funktionsumfang dieses Pakets erheblich
-erweitert. Neben dem aktuellen Wochentag\Index{Wochentag} kann es nun auch den
-Wochentag jedes beliebigen Datums nach dem Gregorianischen Kalender bestimmen.
+Ursprünglich sollte das Paket \Package{scrdate} lediglich den Wochentag zum
+aktuellen Datum liefern. Inzwischen bietet es dies und etwas mehr für jedes
+beliebige Datum im Gregorianischen Kalender.
\begin{Declaration}
\Macro{CenturyPart}\Parameter{Jahr}
@@ -89,7 +89,9 @@ voran zu stellen.
Bitte\textnote{Achtung!} beachten Sie, dass hier die Zählweise verwendet
wird, bei der das Jahr 2000 das Jahr~0 -- also das erste Jahr -- des
-21.~Jahrhunderts ist.%
+21.~Jahrhunderts ist. Bei Bedarf kann aber, wie im Beispiel für die
+Ordnungszahl gezeigt, mit \Macro{numexpr} eine Korrektur herbeigeführt
+werden.%
\EndIndexGroup
@@ -160,9 +162,10 @@ Samstag\,=\,6.%
Nummer eines Wochentags als dem Namen des Wochentags interessiert. Daher
liefert die Anweisung \Macro{DayNameByNumber} den Namen des Wochentags zu
einer Wochentagsnummer zurück, die man beispielsweise mit einer der beiden
-zuvor erklärten Anweisungen \Macro{DayNumber} oder \Macro{ISODayNumber}
-bestimmt hat. Die beiden Anweisungen \Macro{DayName} und \Macro{ISODayName}
-liefern entsprechend den Wochentag zu einem bestimmten Datum.
+zuvor erklärten Anweisungen \DescRef{\LabelBase.cmd.DayNumber} oder
+\DescRef{\LabelBase.cmd.ISODayNumber} bestimmt hat. Die beiden Anweisungen
+\Macro{DayName} und \Macro{ISODayName} liefern entsprechend den Wochentag zu
+einem bestimmten Datum.
\begin{Example}
Sie wollen den Wochentag des 24.~Dezembers~2027 wissen.
@@ -297,7 +300,8 @@ Das \Package{scrdate}-Paket beherrscht derzeit die folgenden Sprachen:
\PValue{swissgerman}\ChangedAt{v3.13}{\Package{scrdate}}),
\item Englisch (\PValue{american}\ChangedAt{v3.13}{\Package{scrdate}},
\PValue{australian}, \PValue{british}, \PValue{canadian}, \PValue{english},
- \PValue{UKenglish}, \PValue{USenglish}),
+ \PValue{newzealand}, \PValue{UKenglish}, \PValue{ukenglish},
+ \PValue{USenglish}, \PValue{usenglish}),
\item Finnisch (\PValue{finnish}),
\item Französisch (\PValue{acadian}, \PValue{canadien},
\PValue{francais}\ChangedAt{v3.13}{\Package{scrdate}}, \PValue{french}),
@@ -380,7 +384,7 @@ erweitert wird.
Beim nächsten Ton ist es \thistime*[\ Uhr,\ ]
Minuten und 42 Sekunden.
\end{lstcode}
- als mögliches Ergebnis etwas wie:
+ als mögliches Ergebnis etwas wie
\begin{quote}
Beim nächsten Ton ist es 8\ Uhr,\ 41 Minuten und 42 Sekunden.
\end{quote}
@@ -418,7 +422,7 @@ dabei einer der Standardwerte für einfache Schalter aus
\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet
werden. Wird die Option ohne Wert-Angabe verwendet, so wird der Wert
\PValue{true} angenommen, also auf das 12-Stunden-Format geschaltet.
-Voreingestellt ist hingegen das 24-Stunden-Format.%
+Voreingestellt\textnote{Voreinstellung} ist hingegen das 24-Stunden-Format.%
%\footnote{Leider beherrscht das \Package{scrtime}-Paket noch nicht die
% Sternzeit nach \textsc{StarTrek}\Index{StarTrek}, ein echter
% Mangel!}
@@ -452,4 +456,4 @@ jedoch nicht mehr empfohlen.%
%%% TeX-PDF-mode: t
%%% End:
-% LocalWords: Gregorianischen
+% LocalWords: Gregorianischen Zählweise Ordnungszahl
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrextend.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrextend.tex
index b1fea3c20ba..c124db974c3 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrextend.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrextend.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrextend.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrextend.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{scrextend.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-01-24 11:44:29 +0100 (Wed, 24 Jan 2018) $
KOMA-Script package scrextend]
\chapter[tocentry={Grundlegende Fähigkeiten der
@@ -66,11 +66,20 @@ sind. Dies betrifft in der Regel nicht nur die Klassen \Class{scrbook},
Artikel gedacht sind, sondern in weiten Teilen auch die \KOMAScript-Klasse
\Class{scrlttr2}, die als Nachfolger von \Class{scrlettr} für Briefe gedacht
ist. Diese grundlegenden Möglichkeiten, die in den genannten Klassen zu finden
-sind, werden von \KOMAScript{} ab Version~3.00 auch von dem Paket
-\Package{scrextend} bereitgestellt. Dieses Paket kann nicht mit
-\KOMAScript-Klassen, wohl aber mit vielen anderen Klassen verwendet
-werden. Der Versuch, das Paket mit einer \KOMAScript-Klasse zu laden, wird von
-\Package{scrextend} erkannt und mit einer Warnung abgelehnt.
+sind, werden von \KOMAScript{} ab Version~3.00 auch vom Paket
+\Package{scrextend} bereitgestellt. Dieses Paket sollte
+nicht\textnote{Achtung!} mit \KOMAScript-Klassen verwendet werden. Es ist
+ausschließlich zur Verwendung mit anderen Klassen gedacht. Der Versuch, das
+Paket mit einer \KOMAScript-Klasse zu laden, wird von \Package{scrextend}
+erkannt und mit einer Warnung abgelehnt.
+
+Dass \hyperref[cha:scrlttr2]{\Package{scrletter}}\IndexPackage{scrletter}
+nicht nur mit \KOMAScript-Klassen, sondern auch mit den Standardklassen
+verwendet werden kann, liegt übrigens teilweise an \Package{scrextend}. Stellt
+\hyperref[cha:scrlttr2]{\Package{scrletter}} nämlich fest, dass es nicht mit
+einer \KOMAScript-Klasse verwendet wird, so lädt es automatisch
+\Package{scrextend}. Damit stehen dann alle unbedingt benötigten Möglichkeiten
+der \KOMAScript-Klassen zur Verfügung.
Es gibt natürlich keine Garantie, dass \Package{scrextend} mit jeder
beliebigen Klasse zusammenarbeitet. Es ist primär für die Erweiterung der
@@ -78,27 +87,31 @@ Standardklassen und davon abgeleiteten Klassen gedacht. In jedem Fall sollten
Benutzer zunächst prüfen, ob die verwendete Klasse nicht selbst entsprechende
Möglichkeiten bereitstellt.
-Neben den in diesem Kapitel beschriebenen Möglichkeiten gibt es einige weitere
-Möglichkeiten, die jedoch hauptsächlich für Klassen- und Paketautoren gedacht
+Neben den in diesem Kapitel beschriebenen Möglichkeiten gibt es einige
+weitere, die jedoch hauptsächlich für Klassen- und Paketautoren gedacht
sind. Diese sind in \autoref{cha:scrbase}, ab \autopageref{cha:scrbase} zu
finden. Das dort dokumentierte Paket
-\Package{scrbase}\important{\Package{scrbase}} wird von allen
-\KOMAScript-Klassen und dem Paket \Package{scrextend} verwendet.
-
-Auch das Paket \Package{scrlfile}\important{\Package{scrlfile}} aus
-\autoref{cha:scrlfile} ab \autopageref{cha:scrlfile} wird von allen
+\hyperref[cha:scrbase]{\Package{scrbase}}%
+\important{\hyperref[cha:scrbase]{\Package{scrbase}}}\IndexPackage{scrbase}
+wird von allen \KOMAScript-Klassen und dem Paket \Package{scrextend}
+verwendet.
+
+Auch das Paket \hyperref[cha:scrlfile]{\Package{scrlfile}}%
+\important{\hyperref[cha:scrlfile]{\Package{scrlfile}}}\IndexPackage{scrlfile}
+aus \autoref{cha:scrlfile} ab \autopageref{cha:scrlfile} wird von allen
\KOMAScript-Klassen und dem Paket \Package{scrextend} geladen. Daher stehen
auch dessen Möglichkeiten bei Verwendung von \Package{scrextend} zur
Verfügung.
\iftrue % Umbruchkorrekturtext
Im Unterschied dazu wird das ebenfalls für Klassen- und Paketautoren gedachte
-Paket \Package{tocbasic} (siehe \autoref{cha:tocbasic} ab
-\autopageref{cha:tocbasic}) nur von den Klassen \Class{scrbook},
-\Class{scrreprt} und \Class{scrartcl} geladen, so dass die dort definierten
-Möglichkeiten auch nur in diesen Klassen und nicht in \Package{scrextend} zu
-finden sind. Natürlich kann \Package{tocbasic} aber auch zusammen mit
-\Package{scrextend} verwendet werden.
+Paket \hyperref[cha:tocbasic]{\Package{tocbasic}} (siehe
+\autoref{cha:tocbasic} ab \autopageref{cha:tocbasic}) nur von den Klassen
+\Class{scrbook}, \Class{scrreprt} und \Class{scrartcl} geladen, so dass die
+dort definierten Möglichkeiten auch nur in diesen Klassen und nicht in
+\Package{scrextend} zu finden sind. Natürlich kann
+\hyperref[cha:tocbasic]{\Package{tocbasic}} aber auch zusammen mit
+\Package{scrextend} verwendet werden.%
\fi
\LoadCommonFile{options}% \section{Frühe oder späte Optionenwahl bei \KOMAScript}
@@ -111,8 +124,8 @@ finden sind. Natürlich kann \Package{tocbasic} aber auch zusammen mit
Das Paket \Package{scrextend} kennt optional verfügbare, erweiterte
Möglichkeiten. Das sind Möglichkeiten, die in der Grundeinstellung nicht
-vorhanden sind, aber zusätzlich ausgewählt werden können. Diese Möglichkeiten
-sind beispielsweise deshalb optional, weil sie in Konflikt mit den
+vorhanden sind, aber zusätzlich ausgewählt werden können. Diese
+sind beispielsweise deshalb optional, weil sie potentiell in Konflikt mit den
Möglichkeiten der Standardklassen oder häufig benutzter Pakete stehen.
\begin{Declaration}
@@ -145,9 +158,8 @@ optionales Argument von
}{%
\par%
Die derzeit einzige optionale Möglichkeit ist
- \PValue{title}\IndexOption[indexmain]{extendedfeature~=\PValue{title}}%
- \important[i]{\begin{tabular}[t]{@{}r@{}}
- \KOption{extendedfeature}\hspace*{1em}\\\PValue{title}\end{tabular}}.
+ \PValue{title}\IndexOption[indexmain]{extendedfeature~=\textKValue{title}}%
+ \important{\OptionValue{extendedfeature}{title}}.
Damit werden die Titelseiten auf die Möglichkeiten der \KOMAScript-Klassen
erweitert, wie sie in \autoref{sec:scrextend.titlepage} ab
\autopageref{sec:scrextend.titlepage} beschrieben sind.%
@@ -181,15 +193,20 @@ Seitenstile des \LaTeX-Kerns.
\Macro{titlepagestyle}
\end{Declaration}%
\BeginIndex{}{Titel>Seitenstil}%
-Auf einigen Seiten wird mit Hilfe von \DescRef{maincls.cmd.thispagestyle}
-automatisch ein anderer Seitenstil gewählt. Bei \Package{scrextend} betrifft
-dies bisher nur die Titelseiten und auch dies nur, wenn mit
+Auf einigen Seiten wird mit Hilfe von
+\DescRef{maincls.cmd.thispagestyle}\IndexCmd{thispagestyle} automatisch ein
+anderer Seitenstil gewählt. Bei \Package{scrextend} betrifft dies bisher nur
+die Titelseiten und auch dies nur, wenn mit
\OptionValueRef{\LabelBase}{extendedfeature}{title} gearbeitet wird (siehe
\autoref{sec:scrextend.optionalFeatures},
-\DescPageRef{scrextend.option.extendedfeature}). Welcher Seitenstil dies ist,
-wird dem Makro \Macro{titlepagestyle} entnommen. In der Voreinstellung ist der
-Seitenstil \PValue{plain}\IndexPagestyle{plain}. Dieser Seitenstil wird
-bereits im \LaTeX-Kern vordefiniert und sollte daher immer verfügbar sein.%
+\DescPageRef{scrextend.option.extendedfeature}). Welcher Seitenstil in diesem
+Fall für einen
+Titelkopf\important{\OptionValueRef{\LabelBase}{titlepage}{false}}%
+\IndexOption{titlepage~=\textKValue{false}}\Index{Titel>Kopf} verwendet wird,
+ist im Makro \Macro{titlepagestyle} festgelegt. In der Voreinstellung ist das
+der Seitenstil \DescRef{maincls.pagestyle.plain}\IndexPagestyle{plain}. Dieser
+Seitenstil wird bereits im \LaTeX-Kern vordefiniert und sollte daher immer
+verfügbar sein.%
\EndIndexGroup
\LoadCommonFile{interleafpage}% \section{Vakatseiten}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrhack.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrhack.tex
index d6614e2c972..9d9b3faed2b 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrhack.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrhack.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrhack.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrhack.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ============================================================================
\KOMAProvidesFile{scrhack.tex}
- [$Date: 2017-03-31 12:00:24 +0200 (Fri, 31 Mar 2017) $
+ [$Date: 2018-02-05 10:50:56 +0100 (Mon, 05 Feb 2018) $
KOMA-Script guide (chapter: scrhack)]
\chapter{Fremdpakete verbessern mit \Package{scrhack}}
@@ -60,13 +60,14 @@ mühsam, die Autoren der jeweiligen Pakete von einer Verbesserung zu
überzeugen. Das betrifft auch Pakete, deren Entwicklung eingestellt
wurde. Deshalb wurde das Paket \Package{scrhack} begonnen. Dieses Paket ändert
Anweisungen und Definitionen anderer Pakete, damit sie besser mit
-\KOMAScript{} zusammenarbeiten.
+\KOMAScript{} zusammenarbeiten. Einige Änderungen sind auch bei
+Verwendung anderer Klassen nützlich.
\section{Entwicklungsstand}
\seclabel{draft}
Obwohl das Paket bereits seit längerer Zeit Teil von \KOMAScript{} ist und
-auch bereits von vielen Anwendern genutzt wird, hat es auch ein Problem. Bei
+von vielen Anwendern genutzt wird, hat es auch ein Problem: Bei
der Umdefinierung von Makros fremder Pakete ist es von der genauen Definition
und Verwendung dieser Makros abhängig. Damit ist es gleichzeitig auch von
bestimmten Versionen dieser Pakete abhängig. Wird eine unbekannte Version
@@ -88,7 +89,7 @@ nicht dauerhaft garantiert werden.
In den Anfängen von \KOMAScript{} gab es von Anwenderseite den Wunsch, dass
Verzeichnisse von Gleitumgebungen, die mit dem Paket
\Package{float}\IndexPackage{float}\important{\Package{float}} erzeugt werden,
-genauso behandelt werden, wie das Abbildungsverzeichnis oder das
+genauso behandelt werden wie das Abbildungsverzeichnis oder das
Tabellenverzeichnis, das von den \KOMAScript-Klassen selbst angelegt
wird. Damals setzte sich der \KOMAScript-Autor mit dem Autor von
\Package{float} in Verbindung, um diesem eine Schnittstelle für entsprechende
@@ -135,10 +136,10 @@ stehen, ist \autoref{sec:tocbasic.toc} zu entnehmen.
Sollte diese Änderung für eines der Pakete nicht erwünscht sein oder zu
Problemen führen, so kann sie selektiv mit den Einstellungen
-\OptionValue{float}{false}\IndexOption[indexmain]{float~=\PValue{false}},
-\OptionValue{floatrow}{false}\IndexOption[indexmain]{floatrow~=\PValue{false}}
+\OptionValue{float}{false}\IndexOption[indexmain]{float~=\textKValue{false}},
+\OptionValue{floatrow}{false}\IndexOption[indexmain]{floatrow~=\textKValue{false}}
und
-\OptionValue{listings}{false}\IndexOption[indexmain]{listings~=\PValue{false}}
+\OptionValue{listings}{false}\IndexOption[indexmain]{listings~=\textKValue{false}}
abgeschaltet werden. Wichtig\textnote{Achtung!} dabei ist, dass eine Änderung
der Optionen nach dem Laden des zugehörigen Pakets keinen Einfluss mehr hat!
@@ -155,17 +156,17 @@ Schriftgrößen erlaubt, kann dabei \Macro{@ptsize} natürlich auch zu einem
Dezimalbruch expandieren.
Eines\ChangedAt{v3.17}{\Package{scrhack}} der Pakete, die damit nicht zurecht
-kommen, ist das Paket
-\Package{setspace}\IndexPackage[indexmain]{setspace}. Darüber hinaus sind die
-von diesem Paket eingestellten Werte immer von der Grundschriftgröße abhängig,
-auch wenn die Einstellung im Kontext einer anderen Schriftgröße erfolgt. Paket
+kommen, ist das Paket \Package{setspace}\IndexPackage[indexmain]{setspace}%
+\important{\Package{setspace}}. Darüber hinaus sind die von diesem Paket
+eingestellten Werte immer von der Grundschriftgröße abhängig, auch wenn die
+Einstellung im Kontext einer anderen Schriftgröße erfolgt. Paket
\Package{scrhack} löst beide Probleme, indem es die Einstellungen von
\Macro{onehalfspacing} und \Macro{doublespacing} immer relativ zur aktuellen,
tatsächlichen Schriftgröße vornimmt.
Sollte diese Änderung nicht erwünscht sein oder zu Problemen führen, so kann
sie selektiv mit der Einstellung
-\OptionValue{setspace}{false}\IndexOption[indexmain]{setspace~=\PValue{false}}
+\OptionValue{setspace}{false}\IndexOption[indexmain]{setspace~=\textKValue{false}}
abgeschaltet werden. Wichtig\textnote{Achtung!} dabei ist, dass eine Änderung
der Option nach dem Laden von \Package{setspace} keinen Einfluss mehr hat!
Ebenso muss \Package{scrhack} vor \Package{setspace} geladen werden, falls
@@ -182,7 +183,7 @@ auswirken soll.
6.79h haben bei den Sternformen der Gliederungsbefehle hinter statt vor oder
auf die Gliederungsüberschriften verlinkt. Inzwischen ist dieses Problem auf
Vorschlag des \KOMAScript-Autors beseitigt. Da die entsprechende Änderung aber
-über ein Jahr auf sich warten lies, wurde in \Package{scrhack} ein
+über ein Jahr auf sich warten ließ, wurde in \Package{scrhack} ein
entsprechender Patch aufgenommen. Zwar kann dieser ebenfalls durch
\OptionValue{hyperref}{false} deaktiviert werden, empfohlen wird jedoch
stattdessen die aktuelle Version von \Package{hyperref} zu verwenden. In
@@ -193,7 +194,8 @@ diesem Fall wird die Änderung durch \Package{scrhack} automatisch verhindert.
\seclabel{lscape}
Das\ChangedAt{v3.18}{\Package{scrhack}} Paket
-\Package{lscape}\IndexPackage[indexmain]{lscape} definiert eine Umgebung
+\Package{lscape}\IndexPackage[indexmain]{lscape}%
+\important{\Package{lscape}} definiert eine Umgebung
\Environment{landscape}\IndexEnv{landscape}, um den Inhalt einer Seite aber
nicht deren Kopf und Fuß quer zu setzen. Innerhalb dieser Umgebung wird
\Length{textheight}\IndexLength{textheight} auf den Wert von
@@ -206,12 +208,12 @@ und in der Tat beschädigt sie die Funktion beispielsweise der Pakete
\Package{showframe}\IndexPackage{showframe} und
\Package{scrlayer}\IndexPackage{scrlayer}. Daher wäre es am besten, wenn
\Length{textheight} ebenfalls unverändert bliebe. \Package{scrhack} verwendet
-Paket \Package{xpatch} (siehe \cite{package:xpatch}) um die Startanweisung
+Paket \Package{xpatch} (siehe \cite{package:xpatch}), um die Startanweisung
\Macro{landscape} der gleichnamigen Umgebung entsprechend zu ändern.
Falls diese Änderung nicht gewünscht wird oder Probleme verursacht, kann sie
mit Option
-\OptionValue{lscape}{false}\IndexOption[indexmain]{lscape~=\PValue{false}}
+\OptionValue{lscape}{false}\IndexOption[indexmain]{lscape~=\textKValue{false}}
deaktiviert werden. Es ist zu beachten\textnote{Achtung!}, dass eine
nachträgliche Zuweisung an Option \Option{lscape} mit
\DescRef{\LabelBase.cmd.KOMAoption}\IndexCmd{KOMAoption} oder
@@ -219,33 +221,54 @@ nachträgliche Zuweisung an Option \Option{lscape} mit
hat, wenn sie während des Ladens von \Package{lscape} nicht \PValue{false}
war.
-Im übrigens\textnote{Achtung!} wird \Package{lscape} auch von dem Paket
-\Package{pdflscape}\IndexPackage[indexmain]{pdflscape} verwendet, so dass
-\Package{scrhack} sich auch auf die Funktion dieses Pakets auswirkt.%
+Im übrigens wird \Package{lscape} auch von dem Paket
+\Package{pdflscape}\IndexPackage[indexmain]{pdflscape}%
+\important{\Package{pdflscape}} verwendet, so dass \Package{scrhack} sich auch
+auf die Funktion dieses Pakets auswirkt.%
\section{Sonderfall \Package{nomencl}}
\seclabel{nomencl}
Eine\ChangedAt{v3.23}{\Package{scrhack}} Besonderheit stellt der Hack für das
-Paket \Package{nomencl}\IndexPackage[indexmain]{nomencl} dar. Dieser rüstet
-einerseits nach, dass der optionale Inhaltsverzeichniseintrag für die
-Nomenklatur Option \OptionValueRef{maincls}{toc}{indentunnumbered}
-beachtet. Quasi nebenbei werden aber auch gleich die Endungen \File{nlo} und
-\File{nls} über das Paket \Package{tocbasic} reserviert (siehe
+Paket
+\Package{nomencl}\IndexPackage[indexmain]{nomencl}\important{\Package{nomencl}}
+dar. Dieser rüstet einerseits nach, dass der optionale
+Inhaltsverzeichniseintrag für die Nomenklatur Option
+\OptionValueRef{maincls}{toc}{indentunnumbered} beachtet. Quasi nebenbei
+werden über das Paket \Package{tocbasic} auch gleich die Endungen \File{nlo}
+und \File{nls} für den Besitzer \PValue{nomencl} reserviert (siehe
\DescRef{tocbasic.cmd.addtotoclist}, \autoref{sec:tocbasic.basics},
-\DescPageRef{tocbasic.cmd.addtotoclist}). Darüber hinaus können mit dem Hack
+\DescPageRef{tocbasic.cmd.addtotoclist}).
+
+Außerdem wird die Umgebung
+\Environment{thenomenclature}\IndexEnv{thenomenclature} so geändert,
+dass \DescRef{tocbasic.cmd.tocbasic@listhead}\IndexCmd{tocbasic@listhead} für
+die Überschrift verwendet wird (siehe \autoref{sec:tocbasic.internals},
+\DescPageRef{tocbasic.cmd.tocbasic@listhead}). Dadurch können mit dem Hack
diverse Attribute für die Endung \File{nls} über
-\DescRef{tocbasic.cmd.setuptoc} gesetzt werden. So ist es beispielsweise
-möglich, mit
+\DescRef{tocbasic.cmd.setuptoc}\IndexCmd{setuptoc}%
+\important{\DescRef{tocbasic.cmd.setuptoc}} gesetzt werden. So ist es
+beispielsweise möglich, mit
\DescRef{tocbasic.cmd.setuptoc}\PParameter{nls}\PParameter{numbered} die
Nomenklatur nicht nur ins Inhaltsverzeichnis einzutragen sondern auch gleich
-zu nummerieren. Als weiterer Nebeneffekt erhält die Nomenklatur mit diesem
-Hack außerdem einen passenden Kolumnentitel, falls lebende Kolumnentitel
-beispielsweise durch Verwendung von Seitenstil
-\DescRef{maincls.pagestyle.headings} aktiviert wurden. All dies wird mit einem
-kleinen Patch der Umgebung \Environment{thenomenclature} erreicht.%
-%
+zu nummerieren. Näheres zu \DescRef{tocbasic.cmd.setuptoc} und den damit
+möglichen Einstellungen ist in \autoref{sec:tocbasic.toc}, ab
+\DescPageRef{tocbasic.cmd.setuptoc} zu finden. Als kleiner aber wichtiger
+Nebeneffekt erhält die Nomenklatur mit diesem Patch außerdem einen passenden
+Kolumnentitel, falls lebende Kolumnentitel beispielsweise durch Verwendung von
+Seitenstil \DescRef{maincls.pagestyle.headings} aktiviert wurden.
+
+Dieser eher simple Patch ist damit ein Beispiel dafür, wie auch Pakete, die
+keine Gleitumgebungen definieren, Nutzen aus der Verwendung von
+\Package{tocbasic} ziehen könnten. Falls diese Änderung jedoch nicht
+gewünscht wird oder Probleme verursacht, kann sie mit Option
+\OptionValue{nomencl}{false}\IndexOption[indexmain]{nomencl~=\textKValue{false}}
+deaktiviert werden. Entscheidend\textnote{Achtung!} ist dabei die Einstellung
+der Option zum Zeitpunkt, zu dem \Package{nomencl} geladen wird! Spätere
+Änderungen der Option mit \DescRef{\LabelBase.cmd.KOMAoption} oder
+\DescRef{\LabelBase.cmd.KOMAoptions} haben also keinen Einfluss und führen zu
+einer entsprechenen Warnung.%
\EndIndexGroup
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrjura.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrjura.tex
index 59dfdc147fb..5fc9c5850d8 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrjura.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrjura.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrjura.tex
-% Copyright (c) Markus Kohm, 2011-2017
+% Copyright (c) Markus Kohm, 2011-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrjura.tex
-% Copyright (c) Markus Kohm, 2011-2017
+% Copyright (c) Markus Kohm, 2011-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{scrjura.tex}%
- [$Date: 2017-05-08 11:47:04 +0200 (Mon, 08 May 2017) $
+ [$Date: 2018-02-06 10:26:38 +0100 (Tue, 06 Feb 2018) $
KOMA-Script guide (chapter: scrjura)]
\chapter{Unterstützung für die Anwaltspraxis durch \Package{scrjura}}
@@ -67,12 +67,13 @@ nummerierten Sätzen, Einträgen in das Inhaltsverzeichnis und Querverweisen in
den deutschen Gepflogenheiten entsprechenden Formen.
Das Paket ist in Zusammenarbeit mit Rechtsanwalt Dr.\,Alexander Willand,
-Karlsruhe, entstanden. Die folgenden Ausführungen erklären das Paket aus einem
-etwas anderen Blickwinkel als die dem Paket beiliegenden Anleitung.
+Karlsruhe, entstanden. Viele der Möglichkeiten gehen außerdem auf konstruktive
+Nachfragen von Prof.\,Heiner Richter von der Hochschule Stalsund zurück.
Es ist zu beachten\textnote{Achtung!}, dass das Paket mit
-\Package{hyperref}\IndexPackage{hyperref} zusammenarbeitet, aber wie üblich
-\Package{hyperref} nach \Package{scrjura} geladen werden muss!
+\Package{hyperref}\IndexPackage{hyperref} zusammenarbeitet. Es ist dabei
+jedoch wichtig, dass \Package{hyperref} wie üblich nach \Package{scrjura}
+geladen wird!
\LoadCommonFile{options}% \section{Frühe oder späte Optionenwahl}
@@ -81,8 +82,8 @@ Es ist zu beachten\textnote{Achtung!}, dass das Paket mit
\section{Verzeichnisse}
\label{sec:scrjura.toc}
-Das Paket \Package{scrjura} sieht auch Einträge in das
-Inhaltsverzeichnis\Index{Inhaltsverzeichnis} vor.
+Die Überschriften juristischer Paragraphen können auf Wunsch auch automatisch
+ins Inhaltsverzeichnis eingetragen werden.
\begin{Declaration}
\OptionVName{juratotoc}{Ein-Aus-Wert}
@@ -93,10 +94,11 @@ Paragraphen\Index{Paragraphen>juristische} nur, wenn ihre \PName{Ebenennummer}
kleiner oder gleich dem Zähler \DescRef{maincls.counter.tocdepth}%
\important{\DescRef{maincls.counter.tocdepth}}\IndexCounter{tocdepth} ist
(siehe \autoref{sec:maincls.toc},
-\DescPageRef{maincls.counter.tocdepth}). Voreingestellt ist für
-\PName{Ebenennummer} der Wert 10000, der auch verwendet wird, wenn die Option
-über einen \PName{Ein-Aus-Wert}\important{\OptionValue{juratotoc}{false}}
-(siehe \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch})
+\DescPageRef{maincls.counter.tocdepth}). Voreingestellt\textnote{Voreinstellung}
+ist für \PName{Ebenennummer} der Wert 10000, der auch verwendet wird, wenn die
+Option über einen
+\PName{Ein-Aus-Wert}\important{\OptionValue{juratotoc}{false}} (siehe
+\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch})
ausgeschaltet wird. Da der Zähler \DescRef{maincls.counter.tocdepth}
üblicherweise einen kleinen, einstelligen Wert besitzt, werden die
Paragraphen-Einträge im Inhaltsverzeichnis daher normalerweise nicht
@@ -106,9 +108,10 @@ Wird die Option hingegen über einen
\PName{Ein-Aus-Wert}\important{\OptionValue{juratotoc}{true}} eingeschaltet,
so wird als \PName{Ebenennummer} 2 voreingestellt. Damit werden sie in
Inhaltsverzeichnissen bei allen \KOMAScript-Klassen auf derselben Ebene wie
-\DescRef{maincls.cmd.subsection} eingeordnet. In der Voreinstellung von
-\DescRef{maincls.counter.tocdepth} werden sie dann auch bei allen
-\KOMAScript-Klassen im Inhaltsverzeichnis angezeigt.%
+\DescRef{maincls.cmd.subsection}\IndexCmd{subsection}%
+\important{\DescRef{maincls.cmd.subsection}} eingeordnet. In der
+Voreinstellung von \DescRef{maincls.counter.tocdepth} werden sie dann auch bei
+allen \KOMAScript-Klassen im Inhaltsverzeichnis angezeigt.%
\EndIndexGroup
@@ -118,8 +121,10 @@ Inhaltsverzeichnissen bei allen \KOMAScript-Klassen auf derselben Ebene wie
\end{Declaration}
Mit diesen beiden Optionen kann für die Einträge der Paragraphen ins
Inhaltsverzeichnis sowohl der Einzug als auch die Breite, die für Nummern
-reserviert wird, festgelegt werden. Voreingestellt sind dieselben Werte wie
-für \DescRef{maincls.cmd.subsection}-Einträge bei \Class{scrartcl}.
+reserviert wird, festgelegt werden. Voreingestellt\textnote{Voreinstellung}
+sind dieselben Werte wie für
+\DescRef{maincls.cmd.subsection}-Einträge\IndexCmd{subsection}%
+\important{\DescRef{maincls.cmd.subsection}} bei \Class{scrartcl}.
%
\EndIndexGroup
@@ -136,7 +141,7 @@ innerhalb von Verträgen der zugehörigen Umgebung zur Verfügung.
\begin{Environment}{contract}\end{Environment}
\end{Declaration}
Dies ist die erste und bisher einzige Umgebung für Juristen, die
-\Package{scrjura} bereit stellt. Durch ihre Verwendung wird die automatische
+\Package{scrjura} bereitstellt. Durch ihre Verwendung wird die automatische
Absatznummerierung aktiviert und die Anweisungen
\DescRef{\LabelBase.cmd.Clause} und \DescRef{\LabelBase.cmd.SubClause} mit
einer konkreten Form versehen, die später näher dokumentiert wird.
@@ -145,7 +150,7 @@ Die\textnote{Achtung!} Umgebung \Environment{contract} darf nicht in sich
selbst geschachtelt werden. Innerhalb eines Dokuments dürfen jedoch mehrere
dieser Umgebungen verwendet werden. Dabei werden die Paragraphen innerhalb
dieser Umgebungen so behandelt, als stünden sie innerhalb einer einzigen
-Umgebung. Durch das Beenden der Umgebung wird diese also quasi lediglich
+Umgebung. Durch das Beenden der Umgebung wird diese also quasi
unterbrochen und durch den Beginn einer neuen Umgebung wird sozusagen die alte
Umgebung fortgesetzt. Dabei sind allerdings keine Unterbrechungen innerhalb
eines Paragraphen möglich.%
@@ -163,7 +168,7 @@ zu einem Vertrag. Das Dokument verhält sich dann also genauso, als würde es
genau eine \DescRef{\LabelBase.env.contract}-Umgebung enthalten.
Es\textnote{Achtung!} wird darauf hingewiesen, dass Option \Option{contract}
-weder mit \DescRef{\LabelBase.cmd.KOMAoption} oder
+weder mit \DescRef{\LabelBase.cmd.KOMAoption} noch
\DescRef{\LabelBase.cmd.KOMAoptions} gesetzt werden kann! Damit ist es auch
nicht möglich die Option wieder abzuschalten. Verwenden Sie in einem solchen
Fall stattdessen direkt eine \DescRef{\LabelBase.env.contract}-Umgebung.
@@ -180,19 +185,23 @@ Paragraphen\footnote{Obwohl der korrekte Begriff für juristische Paragraphen
im Englischen »\emph{section}« wäre, sind die Bezeichnungen in
\Package{scrjura} von »\emph{clause}« abgeleitet. Dadurch sollen
Verwechslungen sowohl mit \DescRef{maincls.cmd.section} als auch mit
- \DescRef{maincls.cmd.paragraph} vermieden werden.} im juristischen Sinn,
+ \DescRef{maincls.cmd.paragraph} vermieden werden.} im juristischen Sinn
sind bei \Package{scrjura} nur innerhalb von Verträgen, also innerhalb der
-Umgebung \DescRef{\LabelBase.env.contract} definiert.
+Umgebung \DescRef{\LabelBase.env.contract} oder weiteren mit
+\DescRef{\LabelBase.cmd.DeclareNewJuraEnvironment} (siehe
+\autoref{sec:\LabelBase.newenv},
+\DescPageRef{\LabelBase.cmd.DeclareNewJuraEnvironment}) erstellten Umgebungen,
+definiert.
\begin{Declaration}
\phantomsection\label{desc:scrjura.contract.macro.Clause}%
- \Macro{Clause}\OParameter{Einstellungen}
+ \Macro{Clause}\Parameter{Einstellungen}
\phantomsection\label{desc:scrjura.contract.macro.SubClause}%
- \Macro{SubClause}\OParameter{Einstellungen}
+ \Macro{SubClause}\Parameter{Einstellungen}
\end{Declaration}
Dies sind die wichtigsten Anweisungen innerhalb eines Vertrags. Ohne
zusätzliche \PName{Einstellungen} erzeugt \Macro{Clause} eine
-Paragraphenüberschrift, die nur aus dem Paragraphenzeichen gefolgt von einer
+Paragraphenüberschrift, die nur aus dem Paragraphenzeichen, gefolgt von einer
fortlaufenden Nummer besteht. Dagegen erzeugt \Macro{SubClause} eine
Paragraphenüberschrift, bei der an die zuletzt mit \Macro{Clause} gesetzte
Nummer noch ein fortlaufender Kleinbuchstabe angehängt wird. Gedacht ist
@@ -212,10 +221,10 @@ wichtigsten soll noch näher eingegangen werden.
\label{tab:scrjura.Clause.options}
\begin{desctabular}
\entry{\Option{dummy}}{%
- Die Überschrift wird nicht gesetzt aber gezählt.%
+ Die Überschrift wird nicht gesetzt, aber gezählt.%
}%
\entry{\OptionVName{head}{Kolumnentitel}}{%
- Sind Kolumnentitel aktiviert wird unabhängig von einem Titel für den
+ Sind Kolumnentitel aktiviert, wird unabhängig von einem Titel für den
Paragraphen dieser Kolumnentitel verwendet.%
}%
\entry{\Option{nohead}}{%
@@ -245,13 +254,14 @@ wichtigsten soll noch näher eingegangen werden.
\end{desctabular}
\end{table}
-In der Voreinstellung wird vor der Überschrift ein Abstand von zwei Zeilen und
-danach ein Abstand von einer Zeile eingefügt. Über die Eigenschaften
-\Option{preskip}\important[i]{\Option{preskip}, \Option{postskip}} und
-\Option{postskip} kann dieser Abstand verändert werden. Diese neue Einstellung
-gilt dann aber nicht nur für den aktuellen Paragraphen, sondern ab dem
-aktuellen Paragraphen bis zum Ende der aktuellen Umgebung. Es ist auch
-möglich, die entsprechende Einstellung bereits vorab mit Hilfe von
+In der Voreinstellung\textnote{Voreinstellung} wird vor der Überschrift ein
+Abstand von zwei Zeilen und danach ein Abstand von einer Zeile eingefügt. Über
+die Eigenschaften \Option{preskip}\important[i]{\Option{preskip},
+ \Option{postskip}} und \Option{postskip} kann dieser Abstand verändert
+werden. Die neue Einstellung gilt dann aber nicht nur für den aktuellen
+Paragraphen, sondern ab dem aktuellen Paragraphen bis zum Ende der aktuellen
+Umgebung. Es ist auch möglich, die entsprechende Einstellung bereits vorab mit
+Hilfe von
\begin{flushleft}\quad\small
\textbf{\Macro{setkeys}}\PParameter{contract}%
\PParameter{preskip=\PName{Abstand},\\
@@ -265,17 +275,18 @@ möglich. Dagegen ist es nicht möglich, diese beiden Optionen bereits beim
Laden des Pakets anzugeben oder sie per \DescRef{\LabelBase.cmd.KOMAoptions}
oder \DescRef{\LabelBase.cmd.KOMAoption} zu setzen.
-\BeginIndex{FontElement}{contract.Clause}%
+\BeginIndex{FontElement}{contract.Clause}\LabelFontElement{contract.Clause}%
\BeginIndex{FontElement}{Clause}\LabelFontElement{Clause}%
-In der Voreinstellung wird für die Überschrift des Paragraphen als Schrift
-\Macro{sffamily}\Macro{bfseries}\Macro{large} verwendet. Über das Element
+In der Voreinstellung\textnote{Voreinstellung} wird für die Überschrift des
+Paragraphen als Schrift \Macro{sffamily}\Macro{bfseries}\Macro{large}
+verwendet. Über das Element
\FontElement{contract.Clause}\important{\FontElement{contract.Clause}} kann
diese Schrift jederzeit mit Hilfe der Anweisungen
\DescRef{\LabelBase.cmd.setkomafont}%
\important[i]{\DescRef{\LabelBase.cmd.setkomafont},
\DescRef{\LabelBase.cmd.addtokomafont}} und
\DescRef{\LabelBase.cmd.addtokomafont} (siehe
-\autoref{sec:maincls.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont})
+\autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont})
geändert werden. Innerhalb der \DescRef{\LabelBase.env.contract}-Umgebung kann
statt \FontElement{contract.Clause} auch
\FontElement{Clause}\important{\FontElement{Clause}} verwendet werden.%
@@ -293,7 +304,7 @@ unterschiedlichen Eigenschaften. Leere Werte für \Option{head} und
vornehmen, so sind \Option{nohead}\important[i]{\Option{nohead},
\Option{notocentry}} und \Option{notocentry} zu verwenden.
-Statt der fortlaufenden Nummer, kann mit Hilfe der Eigenschaft
+Statt der fortlaufenden Nummer kann mit Hilfe der Eigenschaft
\Option{number}\important{\Option{number}} auch manuell eine Nummer vergeben
werden. Dies hat jedoch keinen Einfluss auf die Nummern der nachfolgenden
Paragraphen. Die Angabe einer leeren Nummer ist nicht
@@ -324,14 +335,16 @@ einer Fehlermeldung führen.%
\end{Declaration}
Wie bereits in der vorausgehenden Erklärung erwähnt, werden juristische
Paragraphen und Unterparagraphen normalerweise nummeriert. Die Formatierung
-der Nummer erfolgt dabei mit Hilfe der Anweisung \Macro{Clauseformat}, die
-als einziges Argument die Nummer erwartet. Bei der Vordefinierung als
+der Nummer erfolgt dabei mit Hilfe der Anweisung \Macro{Clauseformat}, die als
+einziges Argument die Nummer erwartet. Bei der
+Vordefinierung\textnote{Voreinstellung} als
\begin{lstcode}
\newcommand*{\Clauseformat}[1]{\S~#1}
\end{lstcode}
-wird der Nummer mit \Macro{S}\IndexCmd{S} lediglich das Paragraphensymbol
-gefolgt von einem nicht trennbaren Leerzeichen vorangestellt. Bei
-Umdefinierungen ist auf die Expandierbarkeit zu achten!%
+wird der Nummer mit \Macro{S}\IndexCmd{S} lediglich das Paragraphensymbol,
+gefolgt von einem nicht trennbaren Leerzeichen
+vorangestellt. Bei\textnote{Achtung!} Umdefinierungen ist auf die
+Expandierbarkeit zu achten!%
\EndIndexGroup
@@ -352,9 +365,10 @@ entnehmen.%
\OptionVName{clausemark}{Einstellung}
\end{Declaration}%
Da Paragraphen eine untergeordnete Gliederung mit unabhängiger Nummerierung
-sind, erzeugen sie in der Voreinstellung keine Kolumnentitel. Über alternative
-Einstellungen können jedoch auch Kolumnentitel erzeugt werden. Die möglichen
-Werte und ihre Bedeutung sind \autoref{tab:scrjura.clausemark} zu entnehmen.%
+sind, erzeugen sie in der Voreinstellung\textnote{Voreinstellung} keine
+Kolumnentitel. Über alternative Einstellungen können jedoch auch Kolumnentitel
+erzeugt werden. Die möglichen Werte und ihre Bedeutung sind
+\autoref{tab:scrjura.clausemark} zu entnehmen.%
%
\begin{table}
\caption{Mögliche Werte für Option \Option{clausemark} zur Erzeugung von
@@ -364,29 +378,29 @@ Werte und ihre Bedeutung sind \autoref{tab:scrjura.clausemark} zu entnehmen.%
\entry{\PValue{both}}{%
Paragraphen erzeugen linke und rechte Marken für Kolumnentitel, wenn das
Dokument die Verwendung von lebenden Kolumnentiteln vorsieht.%
- \IndexOption{clausemark~=\PValue{both}}%
+ \IndexOption{clausemark~=\textKValue{both}}%
}%
\entry{\PValue{false}, \PValue{off}, \PValue{no}}{%
Paragraphen erzeugen keine Kolumnentitel.%
- \IndexOption{clausemark~=\PValue{false}}%
+ \IndexOption{clausemark~=\textKValue{false}}%
}%
\entry{\PValue{forceboth}}{%
Paragraphen erzeugen mit \DescRef{maincls.cmd.markboth} linke und rechte
Marken für Kolumnentitel unabhängig davon, ob das Dokument
beispielsweise über den Seitenstil überhaupt lebende Kolumnentitel
verwendet.%
- \IndexOption{clausemark~=\PValue{forceboth}}%
+ \IndexOption{clausemark~=\textKValue{forceboth}}%
}%
\entry{\PValue{forceright}}{%
Paragraphen erzeugen mit \DescRef{maincls.cmd.markright} rechte Marken
für Kolumnentitel unabhängig davon, ob das Dokument beispielsweise über
den Seitenstil überhaupt lebende Kolumnentitel verwendet.%
- \IndexOption{clausemark~=\PValue{forceright}}%
+ \IndexOption{clausemark~=\textKValue{forceright}}%
}%
\entry{\PValue{right}}{%
Paragraphen erzeugen rechte Marken für Kolumnentitel, wenn das Dokument
die Verwendung von lebenden Kolumnentiteln vorsieht.%
- \IndexOption{clausemark~=\PValue{right}}%
+ \IndexOption{clausemark~=\textKValue{right}}%
}%
\end{desctabular}
\end{table}
@@ -412,12 +426,12 @@ keinen eigenen Mechanismus hierfür. Stattdessen sei auf die Option
\begin{Declaration}
\OptionVName{parnumber}{Einstellung}
\end{Declaration}
-Die automatische Nummerierung der Absätze entspricht den beiden Einstellungen
-\OptionValue{parnumber}{auto} und \OptionValue{parnumber}{true}. Manchmal ist
-es notwendig, die automatische Nummerierung abzuschalten. Das ist mit
-\OptionValue{parnumber}{false}%
+Die automatische\textnote{Voreinstellung} Nummerierung der Absätze entspricht
+den beiden Einstellungen \OptionValue{parnumber}{auto} und
+\OptionValue{parnumber}{true}. Manchmal ist es notwendig, die automatische
+Nummerierung abzuschalten. Das ist mit \OptionValue{parnumber}{false}%
\important{\OptionValue{parnumber}{false}}%
-\IndexOption{parnumber~=\PValue{false}} möglich. In diesem Fall wird nur die
+\IndexOption{parnumber~=\textKValue{false}} möglich. In diesem Fall wird nur die
Satznummer automatisch zurück gesetzt.
Zur Realisierung dieser Option war es notwendig, in den Absatzmechanismus von
@@ -425,18 +439,23 @@ Zur Realisierung dieser Option war es notwendig, in den Absatzmechanismus von
auswirken. Dann bleibt nur, diese Änderung mit
\OptionValue{parnumber}{manual}%
\important{\OptionValue{parnumber}{manual}}%
-\IndexOption{parnumber~=\PValue{manual}} zurück zu nehmen. Umgekehrt hebt
+\IndexOption{parnumber~=\textKValue{manual}} zurück zu nehmen. Umgekehrt hebt
\LaTeX{} selbst den Eingriff manchmal auf. In diesem Fällen kann er mit
\OptionValue{parnumber}{auto}%
\important{\OptionValue{parnumber}{auto}}%
-\IndexOption{parnumber~=\PValue{auto}} erneut aktiviert werden.
+\IndexOption{parnumber~=\textKValue{auto}} erneut aktiviert werden.
Paragraphen, die nur aus einem einzigen Absatz bestehen, werden normalerweise
nicht automatisch nummeriert. Damit dies funktioniert, dürfen sich keine zwei
-Paragraphen mit identischer Nummer in einem Dokument
-befinden. Da\textnote{Achtung!} die Information erst am Ende eines Paragraphen
-zur Verfügung steht, werden in der Regel zwei \LaTeX-Läufe benötigt, bis die
-automatische Absatznummerierung korrekt erfolgt.%
+Paragraphen mit identischer Nummer in einem Dokument befinden. Sollten Sie
+dies dennoch einmal benötigen, weichen Sie bitte auf eine weitere
+Vertragsumgebung aus (siehe
+\DescRef{\LabelBase.cmd.DeclareNewJuraEnvironment},
+\autoref{sec:\LabelBase.newenv},
+\DescPageRef{\LabelBase.cmd.DeclareNewJuraEnvironment}). Da\textnote{Achtung!}
+die Information erst am Ende eines Paragraphen zur Verfügung steht, werden in
+der Regel zwei \LaTeX-Läufe benötigt, bis die automatische Absatznummerierung
+korrekt erfolgt.%
\EndIndexGroup
\begin{Declaration}
@@ -447,19 +466,32 @@ automatische Absatznummerierung korrekt erfolgt.%
\end{Declaration}%
Für die Nummerierung der Absätze wird der Zähler \Counter{par}
verwendet. Seine Darstellung, \Macro{thepar} ist mit
-\Macro{arabic}\PParameter{par} als arabische Zahl voreingestellt. Die Ausgabe
-als automatische Absatznummer erfolgt mit \Macro{parformat}. Dabei wird
-\Macro{thepar} in runde Klammern gesetzt. Will man einem Absatz manuell eine
-Absatznummer voranstellen, so sollte das ebenfalls mit \Macro{parformat}
-geschehen. Dabei ist es sinnvoll, auf \Macro{parformat} noch ein nicht
-trennbares Leerzeichen mit \Macro{nobreakspace} oder der Tilde folgen zu
-lassen.
-
-Bei\ChangedAt{v0.7}{\Package{scrjura}} der Ausgabe der Nummer wird
-\Macro{parformat} außerdem noch ein oder mehrere Trennzeichen angehängt. Diese
-sind durch \Macro{parformatseparation} vorgegeben und derzeit mit
-\Macro{nonbreakspace}, also einem nicht umbrechbaren Wortabstand,
-voreingestellt.
+\Macro{arabic}\PParameter{par} als arabische Zahl
+voreingestellt. Die\textnote{Voreinstellung} Ausgabe als automatische
+Absatznummer erfolgt mit \Macro{parformat}. Dabei wird \Macro{thepar} in runde
+Klammern gesetzt. Will man einem Absatz manuell eine Absatznummer
+voranstellen, so sollte das ebenfalls mit \Macro{parformat} geschehen. Dabei
+ist es sinnvoll, auf \Macro{parformat} noch \Macro{parformatseparation} oder
+zumindest ein nicht trennbares Leerzeichen mit
+\Macro{nobreakspace}\IndexCmd{nobreakspace} oder der Tilde folgen zu lassen.
+
+Bei\ChangedAt{v0.7}{\Package{scrjura}} der automatischen Nummerierung wird
+\Macro{parformat} ebenfalls noch \Macro{parformatseparation} als Trennzeichen
+angehängt. Voreinstellt\textnote{Voreinstellung} ist derzeit mit
+\Macro{nobreakspace}\IndexCmd{nobreakspace} ein nicht umbrechbarer
+Wortabstand.
+
+\BeginIndex{FontElement}{parnumber}\LabelFontElement{parnumber}%
+Die Absatznummer wird normalerweise\textnote{Voreinstellung} in der
+aktuellen Schrift gesetzt. Diese Voreinstellung für das Element
+\FontElement{parnumber} kann jederzeit mit Hilfe der Anweisungen
+\DescRef{\LabelBase.cmd.setkomafont}%
+\important[i]{\DescRef{\LabelBase.cmd.setkomafont},
+ \DescRef{\LabelBase.cmd.addtokomafont}} und
+\DescRef{\LabelBase.cmd.addtokomafont} (siehe
+\autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont})
+geändert werden.%
+\EndIndex{FontElement}{parnumber}%
Es\textnote{Achtung!} wird darauf hingewiesen, dass \Package{scrjura} intern
davon ausgeht, dass \Macro{thepar} eine arabische Zahl ist. Daher sollte
@@ -468,6 +500,17 @@ diese Anweisung keinesfalls umdefiniert werden!%
\begin{Declaration}
+ \Macro{withoutparnumber}
+\end{Declaration}
+Wird keine Absatznummer ausgegeben, wird am Anfang des Absatzes ersatzweise
+die Anweisung \Macro{withoutparnumber} lokal
+ausgeführt. Diese\textnote{Voreinstellung} ist in der Voreinstellung leer, tut
+also weiter nichts. Sie wurde auf speziellen Wunsch in \Package{scrjura}
+eingebaut, ist für den normalen Anwender aber ohne Belang.%
+\EndIndexGroup
+
+
+\begin{Declaration}
\Macro{ellipsispar}\OParameter{Anzahl}
\Macro{parellipsis}
\end{Declaration}
@@ -478,14 +521,14 @@ Absätze sollen dann auch in der Zählung der übrigen Absätze berücksichtigt
werden. Das Paket \Package{scrjura} stellt dafür die Anweisung
\Macro{ellipsispar} bereit.
-In der Voreinstellung lässt \Macro{ellipsispar} genau einen Absatz aus. Über
-das optionale Argument \PName{Anzahl} können jedoch auch mehrere Absätze
-ausgelassen werden. In jedem Fall erscheint in der Ausgabe stattdessen genau
-ein nicht nummerierter Absatz, der nur die Auslassungszeichen
-\Macro{parellipsis} enthält. Bei der Entscheidung für eine automatische
-Nummerierung der übrigen Absätze eines juristischen Paragraphen werden die
-ausgelassenen Absätze jedoch mit gezählt. Dies gilt ebenso für die Nummern
-etwaiger nachfolgender Absätze.
+In der Voreinstellung\textnote{Voreinstellung} lässt \Macro{ellipsispar} genau
+einen Absatz aus. Über das optionale Argument \PName{Anzahl} können jedoch
+auch mehrere Absätze ausgelassen werden. In jedem Fall erscheint in der
+Ausgabe stattdessen genau ein nicht nummerierter Absatz, der nur die
+Auslassungszeichen \Macro{parellipsis} enthält. Bei der Entscheidung für eine
+automatische Nummerierung der übrigen Absätze eines juristischen Paragraphen
+werden die ausgelassenen Absätze jedoch mit gezählt. Dies gilt ebenso für die
+Nummern etwaiger nachfolgender Absätze.
\begin{Example}
Angenommen, Sie kommentieren das Strafgesetzbuch, wollen aber in \S~2 nur
Absatz~3 kommentieren. Dennoch soll auf die übrigen Absätze indirekt
@@ -513,11 +556,11 @@ etwaiger nachfolgender Absätze.
Um das Ergebnis zu sehen, sollten Sie das einfach einmal ausprobieren.
\end{Example}
-Die Auslassungszeichen sind so vordefiniert, dass
+Die Auslassungszeichen sind so vordefiniert\textnote{Voreinstellung}, dass
\Macro{textellipsis}\IndexCmd{textellipsis} verwendet wird, falls eine solche
-Anweisung definiert ist. Anderenfalls wird \Macro{dots} verwendet. Eine
-Umdefinierung von \Macro{parellipsis} ist mit \Macro{renewcommand} jederzeit
-möglich.%
+Anweisung definiert ist. Anderenfalls wird \Macro{dots}\IndexCmd{dots}
+verwendet. Eine Umdefinierung von \Macro{parellipsis} ist mit
+\Macro{renewcommand} jederzeit möglich.%
\EndIndexGroup
@@ -526,10 +569,10 @@ möglich.%
\BeginIndexGroup
\BeginIndex{}{Satz>Nummerierung}%
-Absätze in Verträge bestehen aus einem oder mehreren Sätzen, die teilweise
+Absätze in Verträgen bestehen aus einem oder mehreren Sätzen, die teilweise
ebenfalls nummeriert werden. Da eine automatische Nummerierung jedoch
problematisch und fehleranfällig ist, wurde eine solche bisher nicht
-implementiert.
+implementiert. Eine halbautomatische Nummerierung wird jedoch unterstützt.
\begin{Declaration}
\Counter{sentence}
@@ -541,24 +584,25 @@ Die Nummerierung von Sätzen erfolgt manuell mit der Anweisung
und in der Voreinstellung von \Macro{thesentence} als arabische Zahl
ausgegeben.
-Bei\textnote{Tipp!} Verwendung von \Package{babel}\IndexPackage{babel} ist es
-einfach möglich, eine Abkürzung für \Macro{Sentence} zu definieren:%
+Bei\textnote{Tipp!} Verwendung von
+\Package{babel}\IndexPackage{babel}\important{\Package{babel}} ist es einfach
+möglich, eine Abkürzung für \Macro{Sentence} zu definieren:%
\phantomsection\label{sec:scrjura.shorthandexample}%
\begin{lstcode}[moretexcs={useshorthands,defineshorthand}]
\useshorthands{'}
\defineshorthand{'S}{\Sentence\ignorespaces}
\end{lstcode}
-Bei dieser Definition wurde dafür gesorgt, dass Leerzeichen nach
-\lstinline|'S| ignoriert werden. Es ist sogar möglich zusätzlich eine
-Abkürzung für einen Punkt gefolgt von einer neuen Satznummer zu definieren:
+Dabei werden Leerzeichen nach
+\lstinline|'S| ignoriert. Auch eine
+Abkürzung für einen Punkt, gefolgt von einer neuen Satznummer ist möglich:
\begin{lstcode}[moretexcs={useshorthands,defineshorthand}]
\defineshorthand{'.}{. \Sentence\ignorespaces}
\end{lstcode}
-Diese beiden Abkürzungen haben sich in der Praxis sehr bewährt. Näheres zur
-Verwendung von
-\Macro{useshorthands} und \Macro{defineshorthand} ist der Anleitung zum Paket
-\Package{babel} zu entnehmen (siehe \cite{package:babel}).%
-\EndIndexGroup
+Näheres zu \Macro{useshorthands}\IndexCmd{useshorthands} und
+\Macro{defineshorthand}\IndexCmd{defineshorthands} ist der Anleitung zum Paket
+\Package{babel} zu entnehmen (siehe \cite{package:babel}). Ein
+Anwendungsbeispiel finden Sie in \autoref{sec:scrjura.example} ab
+\autopageref{sec:scrjura.example}. \EndIndexGroup
%
\EndIndexGroup
%
@@ -662,12 +706,12 @@ Voreinstellung entsprechen diese \DescRef{\LabelBase.cmd.refL},
\entry{\PValue{long}}{%
Die Einstellungen \PValue{parlong} und \PValue{sentencelong} werden
kombiniert.%
- \IndexOption{ref~=\PValue{long}}%
+ \IndexOption{ref~=\textKValue{long}}%
}%
\entry{\PValue{numeric}}{%
Die Einstellungen \PValue{parnumeric} und \PValue{sentencenumeric}
werden kombiniert.%
- \IndexOption{ref~=\PValue{numeric}}%
+ \IndexOption{ref~=\textKValue{numeric}}%
}%
\entry{\PValue{clauseonly}, \PValue{onlyclause}, \PValue{ClauseOnly},
\PValue{OnlyClause}}{%
@@ -675,58 +719,58 @@ Voreinstellung entsprechen diese \DescRef{\LabelBase.cmd.refL},
kombiniert. Es ist zu beachten, dass dadurch sowohl
\DescRef{\LabelBase.cmd.refPar} als auch
\DescRef{\LabelBase.cmd.refSentence} ein leeres Ergebnis erzeugen!%
- \IndexOption{ref~=\PValue{long}}%
+ \IndexOption{ref~=\textKValue{long}}%
}%
\entry{\PValue{parlong}, \PValue{longpar}, \PValue{ParL}}{%
Der Absatz wird in der textuellen Langform referenziert.%
- \IndexOption{ref~=\PValue{parlong}}%
+ \IndexOption{ref~=\textKValue{parlong}}%
}%
\entry{\PValue{parnumeric}, \PValue{numericpar}, \PValue{ParN}}{%
Der Absatz wird in der rein nummerischen Form referenziert.%
- \IndexOption{ref~=\PValue{parnumeric}}%
+ \IndexOption{ref~=\textKValue{parnumeric}}%
}%
\entry{\PValue{paroff}, \PValue{nopar}}{%
Der Absatz wird nicht mit referenziert. Es ist zu beachten, dass dadurch
\DescRef{\LabelBase.cmd.refPar} ein leeres Ergebnis erzeugt!%
- \IndexOption{ref~=\PValue{paroff}}%
+ \IndexOption{ref~=\textKValue{paroff}}%
}%
\entry{\PValue{parshort}, \PValue{shortpar}, \PValue{ParS}}{%
Der Absatz wird in der textuellen Kurzform referenziert.%
- \IndexOption{ref~=\PValue{parshort}}%
+ \IndexOption{ref~=\textKValue{parshort}}%
}%
\entry{\PValue{sentencelong}, \PValue{longsentence}, \PValue{SentenceL}}{%
Der Satz wird in der textuellen Langform referenziert.%
- \IndexOption{ref~=\PValue{parlong}}%
+ \IndexOption{ref~=\textKValue{parlong}}%
}%
\entry{\PValue{sentencenumeric}, \PValue{numericsentence},
\PValue{SentenceN}}{%
Der Satz wird in der rein nummerischen Form referenziert.%
- \IndexOption{ref~=\PValue{sentencenumeric}}%
+ \IndexOption{ref~=\textKValue{sentencenumeric}}%
}%
\entry{\PValue{sentenceoff}, \PValue{nosentence}}{%
Der Satz wird nicht mit referenziert. Es ist zu beachten, dass dadurch
von \DescRef{\LabelBase.cmd.refSentence} ein leeres Ergebnis erzeugt
wird!%
- \IndexOption{ref~=\PValue{sentenceoff}}%
+ \IndexOption{ref~=\textKValue{sentenceoff}}%
}%
\entry{\PValue{sentenceshort}, \PValue{shortsentence},
\PValue{SentenceS}}{%
Der Satz wird in der textuellen Kurzform referenziert.%
- \IndexOption{ref~=\PValue{sentenceshort}}%
+ \IndexOption{ref~=\textKValue{sentenceshort}}%
}%
\entry{\PValue{short}}{%
Die Einstellungen \PValue{parshort} und \PValue{sentenceshort} werden
kombiniert.%
- \IndexOption{ref~=\PValue{short}}%
+ \IndexOption{ref~=\textKValue{short}}%
}%
\end{desctabular}
\end{table}
\begin{Example}
- Angenommen Sie wollen, dass auf Absätze immer in der Form »Absatz 1 in
+ Angenommen, Sie wollen, dass auf Absätze immer in der Form »Absatz 1 in
Paragraph 1« verwiesen wird. Da es hierfür keine vordefinierte Anweisung
gibt, müssen Sie sich Ihre eigene Definition aus den vorhanden Möglichkeiten
- zusammen bauen. Dies können Sie mit%
+ zusammenbauen. Dies können Sie mit%
\begin{lstcode}
\newcommand*{\refParM}[1]{%
Absatz~\refParN[arabic]{#1}
@@ -773,11 +817,11 @@ Anweisungen finden sich in \autoref{tab:scrjura.refexamples}.
\section{Zusätzliche Vertragsumgebungen}
\label{sec:scrjura.newenv}
-Einer der Anwender setzt mit \Package{scrjura} keine Verträge oder Kommentare
+Einige Anwender setzen mit \Package{scrjura} keine Verträge oder Kommentare
zu einzelnen Gesetzen, sondern Werke, in denen unterschiedliche Arten von
-Gesetzen behandelt werden. Es ist daher erforderliche, dass ein Paragraph
+Gesetzen behandelt werden. Es ist daher erforderlich, dass ein Paragraph
nicht immer mit demselben Präfix »\S« versehen wird, sondern beispielsweise
-als »Art.« oder »GG« oder was auch immer bezeichnet wird. Darüber hinaus wird
+als »Art.« oder »IAS« oder was auch immer bezeichnet wird. Darüber hinaus wird
eine unabhängige Zählung der unterschiedlichen Paragraphen benötigt.
\begin{Declaration}
@@ -791,55 +835,103 @@ werden. Das Argument \PName{Name} ist dabei der Name der neuen
Umgebung. \PName{Start-Anweisungen} sind Anweisungen, die immer am Anfang der
Umgebung ausgeführt werden, ganz als ob man sie jedes Mal unmittelbar hinter
\Macro{begin}\Parameter{Name} einfügen würde. Entsprechend werden
-\PName{End-Anwesiungen} immer am Ende der Umgebung ausgeführt, ganz als ob man
+\PName{End-Anweisungen} immer am Ende der Umgebung ausgeführt, ganz als ob man
sie jedes Mal unmittelbar vor \Macro{end}\Parameter{Name} einfügen würde. Ohne
\PName{Optionen} entspricht die neue Umgebung \PName{Name} einer
\DescRef{\LabelBase.env.contract}-Umgebung mit eigenen Zählern. Es besteht
jedoch die Möglichkeit über eine mit Komma separierte Liste an
-\PName{Optionen} darauf Einfluss zu nehmen. Derzeit werden folgende
-\PName{Optionen} unterstützt:
-\begin{description}
-\item[\OptionVName{Clause}{Anweisung}:] Legt fest, auf welche
- \PName{Anweisung} innerhalb der Umgebung die Anweisung
- \DescRef{\LabelBase.cmd.Clause} abgebildet werden soll. Die
- \PName{Anweisung} sollte wie die für \DescRef{\LabelBase.env.contract}
- dokumentierte Anweisung genau ein Argument erwarten. Für eine korrekte
- Anwendung dieser Option sind erweiterte Kenntnisse über die interne Funktion
- von \Package{scrjura} notwendig. Außerdem können sich die Anforderungen an
- die \PName{Anweisung} von Version zu Version noch ändern. Daher wird derzeit
- empfohlen, die Option nicht zu verwenden!
-\item[\OptionVName{SubClause}{Anweisung}:] Siehe Option \Option{Clause},
- allerdings für \DescRef{\LabelBase.cmd.SubClause} statt
- \DescRef{\LabelBase.cmd.Clause}.
-\item[\OptionVName{Sentence}{Anweisung}:] Legt fest, auf welche
- \PName{Anweisung} innerhalb der Umgebung die Anweisung
- \DescRef{\LabelBase.cmd.Sentence} abgebildet werden soll. Die
- \Macro{Anweisung} sollte kein Argument besitzen. Normalerweise sollte sie
- den Zähler \Counter{sentence}\IndexCounter{sentence} mit
- \Macro{refstepcounter}\IndexCmd{refstepcounter} erhöhen und dann in
- geeigneter Form ausgeben. Dabei ist besonders darauf zu achten, dass keine
- unerwünschten Leerzeichen eingebaut werden!
-\item[\OptionVName{ClauseNumberFormat}{Anweisung}:] Legt fest, auf welche
- Weise die Paragraphen"=Nummern dieser Umgebung bei der Ausgabe formatiert
- werden. Es wird eine Anweisung mit genau einem Argument erwartet, der Nummer
- des Paragraphen. Falls diese Nummer das letzte Argument einer Kette von
- Anweisungen ist, so kann diese Kette an Anweisungen auch direkt angegeben
- werden.
-\end{description}
+\PName{Optionen} darauf Einfluss zu
+nehmen. \autoref{tab:\LabelBase.DeclareNewJuraEnvironment} führt die derzeit
+unterstützen \PName{Optionen} auf.
+
+\begin{desclist}
+ \desccaption{Von \Macro{DeclareNewJuraEnvironment} unterstützte Optionen zur
+ Konfigurierung neuer
+ Vertragsumgebungen\label{tab:\LabelBase.DeclareNewJuraEnvironment}}%
+ {Optionen für \Macro{DeclareNewJuraEnvironment} (\emph{Fortsetzung})}%
+ \entry{\OptionVName{Clause}{Anweisung}}{%
+ \DescRef{\LabelBase.cmd.Clause} wird innerhalb der neuen Umgebung auf
+ \PName{Anweisung} abgebildet. Die \PName{Anweisung} sollte wie die für
+ \DescRef{\LabelBase.env.contract} dokumentierte Anweisung genau ein
+ Argument erwarten. Für eine korrekte Anwendung dieser Option sind
+ erweiterte Kenntnisse über die interne Funktion von \Package{scrjura}
+ notwendig. Außerdem können sich die Anforderungen an die \PName{Anweisung}
+ von Version zu Version noch ändern. Daher wird derzeit empfohlen, die
+ Option nicht zu verwenden!%
+ }%
+ \entry{\OptionVName{ClauseFont}{Anweisungen}}{%
+ \leavevmode\BeginIndex{FontElement}{\PName{Name}.Clause}%
+ \LabelFontElement{\PName{Name}.Clause}%
+ Ist diese Option angegeben, so wird eine neues Element
+ \FontElement{\PName{Name}.Clause}\IndexFontElement{\PName{Name}.Clause}
+ mit \DescRef{maincls-experts.cmd.newkomafont} definiert und
+ \PName{Anweisungen} für dessen Voreinstellung verwendet. Sollte das
+ Element bisher als Alias definiert gewesen sein (siehe
+ \DescRef{maincls-experts.cmd.aliaskomafont} in
+ \autoref{sec:maincls-experts.experts},
+ \DescPageRef{maincls-experts.cmd.aliaskomafont}) so wird es stattdessen zu
+ einem selbstständigen Element. Sollte das Element bereits definiert
+ gewesen sein, so werden lediglich die \PName{Anweisungen} mit
+ \DescRef{\LabelBase.cmd.setkomafont} als neue Einstellung gesetzt. Bitte
+ beachten Sie die in \autoref{sec:\LabelBase.textmarkup},
+ \DescPageRef{\LabelBase.cmd.setkomafont} erklärten Einschränkungen
+ bezüglich der erlaubten \PName{Anweisungen}!%
+ \EndIndex{FontElement}{\PName{Name}.Clause}%
+ }%
+ \entry{\OptionVName{SubClause}{Anweisung}}{%
+ \DescRef{\LabelBase.cmd.SubClause} wird innerhalb der Umgebung auf
+ \PName{Anweisung} abgebildet. Die \PName{Anweisung} sollte wie die für
+ \DescRef{\LabelBase.env.contract} dokumentierte Anweisung genau ein
+ Argument erwarten. Für eine korrekte Anwendung dieser Option sind
+ erweiterte Kenntnisse über die interne Funktion von \Package{scrjura}
+ notwendig. Außerdem können sich die Anforderungen an die \PName{Anweisung}
+ von Version zu Version noch ändern. Daher wird derzeit empfohlen, die
+ Option nicht zu verwenden!%
+ }%
+ \entry{\OptionVName{Sentence}{Anweisung}}{%
+ \DescRef{\LabelBase.cmd.Sentence} wird innerhalb der Umgebung auf
+ \PName{Anweisung} abgebildet. Die \Macro{Anweisung} sollte kein Argument
+ besitzen. Normalerweise sollte sie den Zähler
+ \Counter{sentence}\IndexCounter{sentence} mit
+ \Macro{refstepcounter}\IndexCmd{refstepcounter} erhöhen und dann in
+ geeigneter Form ausgeben. Dabei ist besonders darauf zu achten, dass keine
+ unerwünschten Leerzeichen eingebaut werden!%
+ }%
+ \entry{\OptionVName{ClauseNumberFormat}{Anweisung}}{%
+ \PName{Anweisung} legt die Formatierung für Paragraphen-Nummern innerhalb
+ der Umgebung fest. Es wird eine \PName{Anweisung} mit genau einem Argument
+ erwartet, der Nummer des Paragraphen. Falls diese Nummer das letzte
+ Argument einer Kette von Anweisungen ist, so kann diese Kette an
+ Anweisungen auch direkt angegeben werden.%
+ }%
+\end{desclist}
\begin{Example}
Um beispielsweise die in der Einleitung zu diesem Abschnitt erwähnte
Umgebung für Artikel zu definieren, genügt:
\begin{lstcode}
- \DeclareNewJuraEnvironment{Artikel}[ClauseNumberFormat=Art.]{}{}
+ \DeclareNewJuraEnvironment{Artikel}
+ [ClauseNumberFormat=Art.]{}{}
\end{lstcode}
Sollen die Artikel unter Verwendung einer \KOMAScript-Klasse mit
Absatzabstand statt Absatzeinzug gesetzt werden, kann
\begin{lstcode}
- \DeclareNewJuraEnvironment{Artikel}[ClauseNumberFormat=Art.~]
- {\KOMAoptions{parskip}}{}
+ \DeclareNewJuraEnvironment{Artikel}
+ [ClauseNumberFormat=Art.~]
+ {\KOMAoptions{parskip}}{}
\end{lstcode}
verwendet werden. Natürlich wird dann auch bei der Referenzierung
- automatisch »Art.« an Stelle von »\S« vorangestellt.%
+ automatisch »Art.« anstelle von »\S« vorangestellt.%
+
+ Angewendet wird die neue Umgebung wie
+ \DescRef{\LabelBase.env.contract}:
+\begin{lstcode}
+ \begin{Artikel}
+ \Clause
+ Die Würde des Menschen ist unantastbar. Sie zu
+ achten und zu schützen ist Verpflichtung aller
+ staatlichen Gewalt.
+ \end{Artikel}
+\end{lstcode}
\end{Example}%
\EndIndexGroup
@@ -848,7 +940,7 @@ jedoch die Möglichkeit über eine mit Komma separierte Liste an
\label{sec:scrjura.babel}
Das Paket \Package{scrjura} wurde in Zusammenarbeit mit einem Anwalt für
-Deutsches Recht entwickelt. Daher unterstützte zunächst auch nur die Sprachen
+Deutsches Recht entwickelt. Daher unterstützte es zunächst auch nur die Sprachen
\PValue{german}, \PValue{ngerman}, \PValue{austrian} und
\PValue{naustrian}. Das Paket wurde aber so entworfen, dass es mit üblichen
Sprachpaketen wie
@@ -930,7 +1022,7 @@ Die Satzung soll in Deutsch verfasst werden. Daher wird das Paket
linerange={6-7,9-9}}]{scrjuraexample.tex}%
Es werden einige Standardeinstellungen für die Schrift vorgenommen. Dazu kommt
das Paket \Package{textcomp}, das neben einem brauchbaren Euro-Zeichen für
-einige Schriften auch ein verbessertes Paragraphenzeichen bereit stellt.
+einige Schriften auch ein verbessertes Paragraphenzeichen bereitstellt.
\lstinputcode[{moretexcs=SelectInputMappings,xleftmargin=2em,%
linerange=11-15}]{scrjuraexample.tex}%
@@ -1147,7 +1239,8 @@ ausführliche Rückmeldungen durch die Anwender angewiesen.%
%%% TeX-master: "guide.tex"
%%% End:
-% LocalWords: Seitenstil bedarfsweise Ebenennummer Absatznummerierung
-% LocalWords: Paragraphenüberschrift Präambeln renewcommand Gesetzestexte
-% LocalWords: Grundgesetzartikel Absatzabstand umbrechbaren Wortabstand
-% LocalWords: Beispielsatzung
+% LocalWords: Seitenstil bedarfsweise Ebenennummer Absatznummerierung
+% LocalWords: Paragraphenüberschrift Präambeln renewcommand Gesetzestexte
+% LocalWords: Grundgesetzartikel Absatzabstand umbrechbaren Wortabstand
+% LocalWords: Beispielsatzung Paragraphensymbol Vordefinierung Absatznummer
+% LocalWords: Expandierbarkeit umbrechbarer Satznummer Paragraphenzeichen
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrjuraexample.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrjuraexample.tex
index b9d700eaef5..c144117cf61 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrjuraexample.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrjuraexample.tex
@@ -142,7 +142,7 @@ Diese Satzung tritt am 11.\,11.\,2011 um 11:11~Uhr
in Kraft.
'S Sollten irgendwelche Bestimmungen dieser Satzung im
-Widerspruch zu einander stehen, tritt die Satzung am
+Widerspruch zueinander stehen, tritt die Satzung am
11.\,11.\,2011 um 11:11~Uhr und 11~Sekunden wieder
außer Kraft'. Der Verein ist in diesem Fall als
aufgelöst zu betrachten.
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-notecolumn.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-notecolumn.tex
index cf98998e1cf..36ecd1a7e37 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-notecolumn.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-notecolumn.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlayer-notecolumn.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer-notecolumn.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,13 +46,14 @@
% ============================================================================
\KOMAProvidesFile{scrlayer-notecolumn.tex}
- [$Date: 2017-02-08 20:39:06 +0100 (Wed, 08 Feb 2017) $
+ [$Date: 2018-02-05 10:50:56 +0100 (Mon, 05 Feb 2018) $
KOMA-Script guide (chapter:scrlayer-notecolumn)]
\chapter{Notizspalten mit \Package{scrlayer-notecolumn}}
\labelbase{scrlayer-notecolumn}
\BeginIndexGroup
+\BeginIndex{Package}{scrlayer-notecolumn}%
Bis einschließlich Version~3.11b unterstützte \KOMAScript{} Notizspalten nur
in Form der Marginalienspalte, die mit \DescRef{maincls.cmd.marginpar} und
\DescRef{maincls.cmd.marginline} (siehe \autoref{sec:maincls.marginNotes},
@@ -69,7 +70,8 @@ können. Jene Art der Randnotizen hat allerdings einige Nachteile:
ausgegeben werden. Dieses Problem ist mit dem Zusatzpaket
\Package{mparhack}\IndexPackage{mparhack} oder durch Verwendung von
\Macro{marginnote} aus dem Paket
- \Package{marginnote}\IndexPackage{marginnote} lösbar.
+ \Package{marginnote}\IndexPackage{marginnote} (siehe
+ \cite{package:marginnote}) lösbar.
\item Randnotizen innerhalb von Gleitumgebungen\textnote{Gleitumgebungen} oder
Fußnoten\textnote{Fußnoten} sind nicht möglich. Auch dieses Problem ist mit
\Package{marginnote} lösbar.
@@ -87,29 +89,33 @@ Veränderungen beim Zeilenabstand des normalen Textes.
Das Paket \Package{scrlayer-notecolumn} tritt an, all diese Probleme zu
lösen. Dazu stützt es sich auf die Grundfunktionalität von
-\Package{scrlayer}\IndexPackage{scrlayer}. Damit einher geht jedoch auch ein
-Nachteil:\textnote{Achtung!} Notizen können nur auf den Seiten ausgegeben
-werden, die einen auf \Package{scrlayer} basierenden Seitenstil
-besitzen. Dieser Nachteil lässt sich mit Hilfe von
-\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} jedoch leicht
-auflösen oder sogar in einen Vorteil verwandeln.
+\hyperref[cha:scrlayer]{\Package{scrlayer}}\IndexPackage{scrlayer}%
+\important{\hyperref[cha:scrlayer]{\Package{scrlayer}}}. Damit einher geht
+jedoch auch ein Nachteil:\textnote{Achtung!} Notizen können nur auf den Seiten
+ausgegeben werden, die einen auf \hyperref[cha:scrlayer]{\Package{scrlayer}}
+basierenden Seitenstil besitzen. Dieser Nachteil lässt sich mit Hilfe von
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}%
+\IndexPackage{scrlayer-scrpage} jedoch leicht
+auf"|lösen oder sogar in einen Vorteil verwandeln.
\section{Hinweise zum Entwicklungsstand}
\seclabel{draft}
Das Paket wurde ursprünglich zur Demonstration des Potentials von
-\Package{scrlayer} als sogenannter\textnote{Proof of concept} \emph{proof of
- concept} entwickelt. Obwohl es sich derzeit noch in einem recht frühen
+\hyperref[cha:scrlayer]{\Package{scrlayer}}\important{\hyperref[cha:scrlayer]{\Package{scrlayer}}}
+als sogenannter\textnote{Proof of Concept} \emph{Proof of Concept}
+entwickelt. Obwohl es sich derzeit noch in einem recht frühen
Entwicklungsstadium befindet, ist die Stabilität von weiten Teilen weniger
eine Frage von \Package{scrlayer-notecolumn} als von
-\Package{scrlayer}. Dennoch ist davon auszugehen, dass sich auch in
-\Package{scrlayer-notecolumn} noch Fehler befinden. Es wird darum gebeten,
-diese bei Auffinden zu melden. Einige \emph{Unzulänglichkeiten} des Pakets
-sind jedoch auch der Minimierung des Aufwands geschuldet. So können
-Notizspalten zwar über Seiten hinweg umbrochen werden, allerdings findet dabei
-kein neuerlicher Absatzumbruch statt. Dies ist bei \TeX{} schlicht nicht
-vorgesehen.
+\hyperref[cha:scrlayer]{\Package{scrlayer}}. Dennoch ist davon auszugehen,
+dass sich auch in \Package{scrlayer-notecolumn} noch Fehler befinden. Es wird
+darum gebeten, diese bei Auf"|finden zu melden. Einige
+\emph{Unzulänglichkeiten} des Pakets sind jedoch auch der Minimierung des
+Aufwands geschuldet. So können Notizspalten zwar über Seiten hinweg umbrochen
+werden, allerdings findet dabei kein neuerlicher Absatzumbruch statt. Dies ist
+bei \TeX{} schlicht nicht vorgesehen.
Da das Paket eher als experimentell\textnote{experimentell} gilt, findet sich
die Anleitung hier im zweiten Teil \iffree{der \KOMAScript-Anleitung}{dieses
@@ -139,14 +145,14 @@ Demonstrationszwecken geschrieben wurde.%
Beim Laden des Pakets wird bereits automatisch eine Notizspalte namens
\PValue{marginpar} deklariert. Wie der Name andeutet, liegt diese Notizspalte
-im Bereich der normalen Marginalienspalte von \DescRef{maincls.cmd.marginpar} und
-\DescRef{maincls.cmd.marginline}. Dabei werden auch die Einstellungen
+im Bereich der normalen Marginalienspalte von \DescRef{maincls.cmd.marginpar}
+und \DescRef{maincls.cmd.marginline}. Dabei werden auch die Einstellungen
\Macro{reversemarginpar} und \Macro{normalmarginpar} beachtet, allerdings
nicht für die einzelnen Notizen, sondern nur für die gesamten Notizen einer
Seite. Maßgeblich ist dabei die Einstellung, die am Ende der Seite, nämlich
-bei der Ausgabe der Notizspalte, gilt. Will man hingegen innerhalb einer
-Seite sowohl Notizen links als auch rechts neben dem Haupttext haben, so
-sollte man sich eine zweite Notizspalte definieren.
+bei der Ausgabe der Notizspalte, gilt. Will man hingegen innerhalb einer Seite
+sowohl Notizen links als auch rechts neben dem Haupttext haben, so sollte man
+sich eine zweite Notizspalte definieren.
Die Voreinstellungen für alle neu deklarierten Notizspalten entsprechen im
Übrigen den erwähnten Einstellungen für die vordefinierte
@@ -157,28 +163,33 @@ Diese können bei der Deklaration jedoch leicht geändert werden.%
Es ist zu beachten\textnote{Achtung!}, dass Notizspalten nur auf Seiten
ausgegeben werden, deren Seitenstil auf dem Paket
-\Package{scrlayer}\IndexPackage{scrlayer} basiert. Das Paket
-\Package{scrlayer} wird von \Package{scrlayer-notecolumn} automatisch geladen
-und stellt in der Voreinstellung lediglich den Seitenstil
+\hyperref[cha:scrlayer]{\Package{scrlayer}}\IndexPackage{scrlayer}%
+\important{\hyperref[cha:scrlayer]{\Package{scrlayer}}} basiert. Das Paket
+\hyperref[cha:scrlayer]{\Package{scrlayer}} wird von
+\Package{scrlayer-notecolumn} automatisch geladen und stellt in der
+Voreinstellung lediglich den Seitenstil
\PageStyle{empty}\IndexPagestyle{empty} bereit. Werden weitere Seitenstile
benötigt, wird zusätzlich das Paket
-\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} empfohlen.
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}
+empfohlen.
\begin{Declaration}
- \Macro{DeclareNoteColumn}\OParameter{Liste der Einstellungen}
- \Parameter{Name der Notizspalte}
- \Macro{DeclareNewNoteColumn}\OParameter{Liste der Einstellungen}
- \Parameter{Name der Notizspalte}
- \Macro{ProvideNoteColumn}\OParameter{Liste der Einstellungen}
- \Parameter{Name der Notizspalte}
- \Macro{RedeclareNoteColumn}\OParameter{Liste der Einstellungen}
- \Parameter{Name der Notizspalte}%
+ \Macro{DeclareNoteColumn}\OParameter{Liste~der~Einstellungen}
+ \Parameter{Name~der~Notizspalte}
+ \Macro{DeclareNewNoteColumn}\OParameter{Liste~der~Einstellungen}
+ \Parameter{Name~der~Notizspalte}
+ \Macro{ProvideNoteColumn}\OParameter{Liste~der~Einstellungen}
+ \Parameter{Name~der~Notizspalte}
+ \Macro{RedeclareNoteColumn}\OParameter{Liste~der~Einstellungen}
+ \Parameter{Name~der~Notizspalte}%
\end{Declaration}
Mit Hilfe dieser Anweisungen können Notizspalten angelegt werden. Dabei
erzeugt \Macro{DeclareNoteColumn} die Notizspalte ungeachtet der Tatsache, ob
sie bereits existiert, während \Macro{DeclareNewNoteColumn} einen
Fehler ausgibt, falls der \PName{Name der Notizspalte} bereits für eine andere
-Notizspalte vergeben ist, und \Macro{ProvideNoteColumn} in eben diesem Fall
+Notizspalte vergeben ist und \Macro{ProvideNoteColumn} in eben diesem Fall
schlicht nichts tut. Mit \Macro{RedeclareNoteColumn} wiederum kann nur eine
bereits existierende Notiz-Spalte neu konfiguriert werden.
@@ -203,75 +214,14 @@ angegeben werden.%
Die \PName{Liste der Einstellungen} ist eine durch Komma separierte Liste von
Einstellungen oder Optionen. Die verfügbaren Optionen sind in
-\autoref{tab:scrlayer-notecolumn.note.column.options} zu
-finden. Als\textnote{Voreinstellung: Option \Option{marginpar}}
-Voreinstellung ist \Option{marginpar} immer gesetzt, kann aber durch
-individuelle Einstellungen überschrieben werden.
-
-\begin{table}
-%\begin{desclist}
-% \desccaption{%
- \caption[Mögliche Einstellungen für die Deklaration von Notizspalten]%
- {%
- Mögliche Einstellungen für die Deklaration von Notizspalten%
- }%
- \label{tab:scrlayer-notecolumn.note.column.options}%
-% }{%
-% Mögliche Einstellungen für die Deklaration von Notizspalten
-% (\emph{Fortsetzung})%
-% }%
- \begin{desctabular}
- \entry{\OptionVName{font}{Schriftattribute}}{%
- Einstellung der \PName{Schriftattribute} der Notizspalte mit Hilfe von
- \DescRef{\LabelBase.cmd.setkomafont}. Für erlaubte Werte sei auf
- \autoref{sec:maincls.textmarkup}, \DescPageRef{maincls.cmd.setkomafont}
- verwiesen.\par%
- Voreinstellung: \emph{leer}%
- }%
- \entry{\Option{marginpar}}{%
- Position und Breite der Notizspalte werden so eingestellt, dass sie der
- Marginalienspalte von \DescRef{maincls.cmd.marginpar} entsprechen. Eine
- Umschaltung zwischen \Macro{reversemarginpar}\IndexCmd{reversemarginpar}
- und \Macro{normalmarginpar}\IndexCmd{normalmarginpar} wird immer nur am
- Ende der Seite bei der Ausgabe der Notizspalte beachtet. Es wird darauf
- hingewiesen, dass diese Option kein Argument erwartet oder erlaubt.\par%
- Voreinstellung: \emph{ja} }%
- \entry{\Option{normalmarginpar}}{%
- Position und Breite der Notizspalte werden so eingestellt, dass sie der
- Marginalienspalte von \DescRef{maincls.cmd.marginpar} bei Einstellung
- \Macro{normalmarginpar} entsprechen. Es wird darauf hingewiesen, dass
- diese Option kein Argument erwartet oder erlaubt.\par%
- Voreinstellung: \emph{nein} }%
- \entry{\OptionVName{position}{Abstand}}{%
- Die Notizspalte wird mit \PName{Abstand} vom linken Rand des Papiers
- gesetzt. Dabei sind für \PName{Abstand} auch komplexe Ausdrücke
- gestattet, solange diese voll expandierbar sind und zum Zeitpunkt der
- Ausgabe der Notizspalte zu einer Länge oder zu einem Längenwert oder
- einem Längenausdruck expandieren. Siehe
- \cite[Abschnitt~3.5]{manual:eTeX} für weitere Informationen zu
- Längenausdrücken.\par%
- Voreinstellung: \emph{durch Option \Option{marginpar}}%
- }%
- \entry{\Option{reversemarginpar}}{%
- Position und Breite der Notizspalte werden so eingestellt, dass sie der
- Marginalienspalte von \DescRef{maincls.cmd.marginpar} bei Einstellung
- \Macro{reversemarginpar} entsprechen. Es wird darauf hingewiesen, dass
- diese Option kein Argument erwartet oder erlaubt.\par%
- Voreinstellung: \emph{nein} }%
- \entry{\OptionVName{width}{Breite}}{%
- Die Notizspalte wird mit der angegebenen Breite gesetzt. Dabei sind für
- \PName{Breite} auch komplexe Ausdrücke gestattet, solange diese voll
- expandierbar sind und zum Zeitpunkt der Ausgabe der Notizspalte zu einer
- Länge oder einem Längenwert oder einem Längenausdruck expandieren. Siehe
- \cite[Abschnitt~3.5]{manual:eTeX} für weitere Informationen zu
- Längenausdrücken.\par%
- Voreinstellung: \emph{durch Option \Option{marginpar}}%
- }%
- \end{desctabular}
-\end{table}
-%\end{desclist}
-
-Da die Notizspalten mit Hilfe von \Package{scrlayer} definiert werden, wird
+\autoref{tab:scrlayer-notecolumn.note.column.options},
+\autopageref{tab:scrlayer-notecolumn.note.column.options} zu
+finden. Als\textnote{Voreinstellung: Option \Option{marginpar}} Voreinstellung
+ist \Option{marginpar} immer gesetzt, kann aber durch individuelle
+Einstellungen überschrieben werden.
+
+Da die Notizspalten mit Hilfe von \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+\important{\hyperref[cha:scrlayer]{\Package{scrlayer}}} definiert werden, wird
auch für jede Notizspalte eine Ebene\Index{Ebenen} angelegt. Als
Name\textnote{Name der Ebene} für diese Ebene wird ebenfalls
\PValue{notecolumn.}\PName{Name der Notizspalte} verwendet. Näheres zu Ebenen
@@ -279,7 +229,7 @@ ist \autoref{sec:scrlayer.layers}, ab \autopageref{sec:scrlayer.layers} zu
entnehmen.
%
\begin{Example}
- Angenommen Sie sind Professor für ulkiges Recht und wollen eine Abhandlung
+ Angenommen, Sie sind Professor für ulkiges Recht und wollen eine Abhandlung
über das neue »Gesetz über die ausgelassene Verbreitung allgemeiner Späße«,
kurz GüdaVaS, schreiben. Der Hauptaugenmerk soll dabei jeweils auf dem
Kommentar zu einzelnen Paragraphen liegen. Sie entscheiden sich für ein
@@ -332,12 +282,16 @@ entnehmen.
genutzt.}{}
Bezüglich des Setzens von Gesetzestexten\textnote{Gesetz mit
- \Package{scrjura}} mit \Package{scrjura}\IndexPackage{scrjura} sei auf
+ \hyperref[cha:scrjura]{\Package{scrjura}}} mit
+ \hyperref[cha:scrjura]{\Package{scrjura}}\IndexPackage{scrjura} sei auf
\iffree{dessen Anleitung}{\autoref{cha:scrjura}} verwiesen.
- Da ein Seitenstil\textnote{Seitenstil mit \Package{scrlayer-scrpage}} mit
- Seitenzahl verwendet werden soll, wird das Paket \Package{scrlayer-scrpage}
- geladen. Somit können Notizspalten auf allen Seiten ausgegeben werden.
+ Da ein Seitenstil\textnote{Seitenstil mit
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} mit
+ Seitenzahl verwendet werden soll, wird das Paket
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ \IndexPackage{scrlayer-scrpage} geladen. Somit können Notizspalten auf allen
+ Seiten ausgegeben werden.
Dann wird das Paket \Package{scrlayer-notecolumn}\textnote{Notizspalte mit
\Package{scrlayer-notecolumn}} für die Notizspalten geladen. Die
@@ -345,9 +299,11 @@ entnehmen.
\DescRef{typearea-experts.cmd.AfterCalculatingTypearea}%
\IndexPackage{typearea}%
\IndexCmd{AfterCalculatingTypearea} nach jeder etwaigen Neuberechnung des
- Satzspiegels\textnote{Satzspiegel mit \Package{typearea}} neu berechnet. Sie
- soll jeweils ein Drittel der Satzspiegelbreite betragen, wobei der Abstand
- zwischen Text und Notizspalte zu Lasten der Notizspalte geht. %
+ Satzspiegels\textnote{Satzspiegel mit
+ \hyperref[cha:typearea]{\Package{typearea}}}%
+ \IndexPackage{typearea} neu berechnet. Sie soll jeweils ein Drittel der
+ Satzspiegelbreite betragen, wobei der Abstand zwischen Text und Notizspalte
+ zu Lasten der Notizspalte geht. %
\iftrue% Umbruchoptimierung
Diese ist also effektiv um \Length{marginparsep}\IndexLength{marginparsep}
schmaler.%
@@ -396,6 +352,71 @@ testen, können Sie vorübergehend
Offen blieb in dem Beispiel die Frage, wie der Text für den Kommentar schmaler
gesetzt werden kann. Dies werden Sie bei der Fortsetzung des Beispiels
erfahren.%
+%
+%\begin{table}% Umbruchoptimierung: Tabelle hinter das Beispiel verschoben
+\begin{desclist}
+ \desccaption{%
+% \caption[Mögliche Einstellungen für die Deklaration von Notizspalten]{%
+ Mögliche Einstellungen für die Deklaration von Notizspalten%
+% }%
+ \label{tab:scrlayer-notecolumn.note.column.options}%
+ }{%
+ Mögliche Einstellungen für die Deklaration von Notizspalten
+ (\emph{Fortsetzung})%
+ }%
+% \begin{desctabular}
+ \entry{\OptionVName{font}{Schriftattribute}}{%
+ Einstellung der \PName{Schriftattribute} der Notizspalte mit Hilfe von
+ \DescRef{\LabelBase.cmd.setkomafont}. Für erlaubte Werte sei auf
+ \autoref{sec:\LabelBase.textmarkup},
+ \DescPageRef{\LabelBase.cmd.setkomafont} verwiesen.\par%
+ Voreinstellung: \emph{leer}%
+ }%
+ \entry{\Option{marginpar}}{%
+ Position und Breite der Notizspalte werden so eingestellt, dass sie der
+ Marginalienspalte von \DescRef{maincls.cmd.marginpar} entsprechen. Eine
+ Umschaltung zwischen \Macro{reversemarginpar}\IndexCmd{reversemarginpar}
+ und \Macro{normalmarginpar}\IndexCmd{normalmarginpar} wird immer nur am
+ Ende der Seite bei der Ausgabe der Notizspalte beachtet. Es wird darauf
+ hingewiesen, dass diese Option kein Argument erwartet oder erlaubt.\par%
+ Voreinstellung: \emph{ja}%
+ }%
+ \entry{\Option{normalmarginpar}}{%
+ Position und Breite der Notizspalte werden so eingestellt, dass sie der
+ Marginalienspalte von \DescRef{maincls.cmd.marginpar} bei Einstellung
+ \Macro{normalmarginpar} entsprechen. Es wird darauf hingewiesen, dass
+ diese Option kein Argument erwartet oder erlaubt.\par%
+ Voreinstellung: \emph{nein}%
+ }%
+ \entry{\OptionVName{position}{Abstand}}{%
+ Die Notizspalte wird mit \PName{Abstand} vom linken Rand des Papiers
+ gesetzt. Dabei sind für \PName{Abstand} auch komplexe Ausdrücke
+ gestattet, solange diese voll expandierbar sind und zum Zeitpunkt der
+ Ausgabe der Notizspalte zu einer Länge oder zu einem Längenwert oder
+ einem Längenausdruck expandieren. Siehe
+ \cite[Abschnitt~3.5]{manual:eTeX} für weitere Informationen zu
+ Längenausdrücken.\par%
+ Voreinstellung: \emph{durch Option \Option{marginpar}}%
+ }%
+ \entry{\Option{reversemarginpar}}{%
+ Position und Breite der Notizspalte werden so eingestellt, dass sie der
+ Marginalienspalte von \DescRef{maincls.cmd.marginpar} bei Einstellung
+ \Macro{reversemarginpar} entsprechen. Es wird darauf hingewiesen, dass
+ diese Option kein Argument erwartet oder erlaubt.\par%
+ Voreinstellung: \emph{nein}%
+ }%
+ \entry{\OptionVName{width}{Breite}}{%
+ Die Notizspalte wird mit der angegebenen Breite gesetzt. Dabei sind für
+ \PName{Breite} auch komplexe Ausdrücke gestattet, solange diese voll
+ expandierbar sind und zum Zeitpunkt der Ausgabe der Notizspalte zu einer
+ Länge oder einem Längenwert oder einem Längenausdruck expandieren. Siehe
+ \cite[Abschnitt~3.5]{manual:eTeX} für weitere Informationen zu
+ Längenausdrücken.\par%
+ Voreinstellung: \emph{durch Option \Option{marginpar}}%
+ }%
+% \end{desctabular}
+%\end{table}
+\end{desclist}
\EndIndexGroup
@@ -414,33 +435,40 @@ diese Hilfsdatei dann Stück für Stück je nach Fortschritt des Dokuments wieder
eingelesen und am Ende der Seite werden die Notizen für die jeweilige Seite
ausgegeben.
+\iffree{}{\pagebreak}% Umbruchoptimierung
Es ist jedoch zu beachten\textnote{Achtung!}, dass Notizspalten nur auf Seiten
ausgegeben werden, deren Seitenstil auf dem Paket
-\Package{scrlayer}\IndexPackage{scrlayer} basiert. Das Paket
-\Package{scrlayer} wird von \Package{scrlayer-notecolumn} automatisch geladen
-und stellt in der Voreinstellung lediglich den Seitenstil
+\hyperref[cha:scrlayer]{\Package{scrlayer}}\IndexPackage{scrlayer}%
+\important{\hyperref[cha:scrlayer]{\Package{scrlayer}}} basiert. Das Paket
+\hyperref[cha:scrlayer]{\Package{scrlayer}} wird von
+\Package{scrlayer-notecolumn} automatisch geladen und stellt in der
+Voreinstellung lediglich den Seitenstil
\PageStyle{empty}\IndexPagestyle{empty} bereit. Werden weitere Seitenstile
benötigt, wird zusätzlich das Paket
-\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} empfohlen.
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}
+empfohlen.
\begin{Declaration}
\Macro{makenote}\OParameter{Name der Notizspalte}\Parameter{Notiz}\\
\Macro{makenote*}\OParameter{Name der Notizspalte}\Parameter{Notiz}
\end{Declaration}
-Mit Hilfe dieser Anweisung kann eine \PName{Notiz} erstellt werden. Dabei wird
-die aktuelle vertikale Position als vertikale Position für den Anfang der
+Mit Hilfe dieser Anweisungen kann eine \PName{Notiz} erstellt werden. Dabei
+wird die aktuelle vertikale Position als vertikale Position für den Anfang der
\PName{Notiz} verwendet. Die horizontale Position für die Notiz ergibt sich
aus der definierten Position der Notizspalte. Für die korrekte Funktion ist
das Paket dabei auf \Macro{pdfsavepos}\IndexCmd{pdfsavepos},
\Macro{pdflastypos}\IndexCmd{pdflastypos} und
-\Macro{pdfpageheight}\IndexLength{pdfpageheight} angewiesen. Ohne diese
-Befehle funktioniert \Package{scrlayer-notecolumn} nicht. Dabei wird außerdem
-davon ausgegangen, dass die genannten Primitiven exakt die Ergebnisse von
-PDF\TeX{} liefern.
+\Macro{pdfpageheight}\IndexLength{pdfpageheight} beziehungsweise deren
+Entsprechungen bei neueren Lua\TeX-Versionen angewiesen. Ohne diese Befehle
+funktioniert \Package{scrlayer-notecolumn} nicht. Dabei wird außerdem davon
+ausgegangen, dass die genannten Primitiven exakt die Ergebnisse von PDF\TeX{}
+liefern.
Wird allerdings bei der Ausgabe der \PName{Notiz} eine
-Kollision\textnote{Kollisionsauflösung} mit einer früheren Notiz in derselben
+Kollision\textnote{Kollisionsauf"|lösung} mit einer früheren Notiz in derselben
Notizspalte erkannt, so wird die \PName{Notiz} bis unter diese frühere Notiz
verschoben. Passt die \PName{Notiz} nicht mehr auf die
Seite\textnote{Seitenumbruch}\Index{Seiten>Umbruch}, so wird sie ganz oder
@@ -501,11 +529,11 @@ Kommentar fortgesetzt wird. Eine Lösung für dieses Problem, werden Sie gleich
kennenlernen.
Das\ChangedAt{v0.1.2583}{\Package{scrlayer-notecolumn}} im Beispiel erwähnte
-Problem mit dem Zerbrechen von Befehlen tritt bei der Sternvariante
-normalerweise nicht auf. Diese verwendet \Macro{detokenize}, um die Expansion
-zu verhindern. Das bedeutet aber auch, dass man in der \PName{Notiz} keine
-Befehle verwenden sollte, die ihre Bedeutung innerhalb des Dokuments
-verändern.%
+Problem mit dem Zerbrechen von Befehlen tritt bei der
+Sternvariante\important{\Macro{makenote*}} normalerweise nicht auf. Diese
+verwendet \Macro{detokenize}, um die Expansion zu verhindern. Das bedeutet
+aber auch, dass man in der \PName{Notiz} keine Befehle verwenden sollte, die
+ihre Bedeutung innerhalb des Dokuments verändern.%
\EndIndexGroup
@@ -545,15 +573,16 @@ right.« Aber auch Meldungen über undefinierte \emph{Labels} können auf die
Notwendigkeit eines weiteren \LaTeX-Laufs hinweisen.
Wird das optionale Argument nicht angegeben, so wird an seiner Stelle
-\PValue{marginpar}, also die vordefinierte Notizspalte verwendet. Es sei an
-dieser Stelle darauf hingewiesen, dass ein leeres optionales Argument nicht
-gleichbedeutend mit dem Weglassen eines optionalen Arguments ist!
+\PValue{marginpar}, also die vordefinierte Notizspalte
+verwendet. Es\textnote{Achtung!} sei an dieser Stelle darauf hingewiesen, dass
+ein leeres optionales Argument nicht gleichbedeutend mit dem Weglassen eines
+optionalen Arguments ist!
Es ist nicht\textnote{Achtung!} erlaubt, \Macro{syncwithnotecolumn} innerhalb
einer Notiz selbst, also im obligatorischen Argument von
\Macro{makenote}\IndexCmd{makenote} zu verwenden! Dieser Fehler kann derzeit
nicht abgefangen werden und führt dazu, dass mit jedem \LaTeX-Lauf neue
-Verschiebungen auftreten, so dass nie ein endgültiger Zustand erreicht
+Verschiebungen auf"|treten, so dass nie ein endgültiger Zustand erreicht
wird. Um zwei oder mehrere Notizspalten miteinander zu synchronisieren, sind
diese stattdessen mit dem Haupttext zu synchronisieren, da dabei auch die
Spalten miteinander synchronisiert werden. Die hierzu empfohlene Anweisung
@@ -617,12 +646,12 @@ Frage wird im nächsten Abschnitt beantwortet werden.
\begin{Declaration}
- \Macro{syncwithnotecolumns}\OParameter{Liste von Notizspalte-Namen}
+ \Macro{syncwithnotecolumns}\OParameter{Liste von Notizspalte}
\end{Declaration}
Diese Anweisung führt eine Synchronisierung des Haupttextes mit allen in der
-mit Komma separierten \PName{Liste von Notizspalten-Namen} durch. Dabei wird
-der Haupttext mit der Notizspalte synchronisiert, deren Marke am weitesten
-hinten im Dokument steht. Somit werden als Nebeneffekt auch die Notizspalten
+mit Komma separierten \PName{Liste von Notizspalten} durch. Dabei wird der
+Haupttext mit der Notizspalte synchronisiert, deren Marke am weitesten hinten
+im Dokument steht. Somit werden als Nebeneffekt auch die Notizspalten
untereinander synchronisiert.
Wird das optionale Argument nicht angegeben oder ist es leer (oder beginnt es
@@ -635,7 +664,7 @@ synchronisiert.%
\seclabel{clearnotes}
Neben der normalen Ausgabe der Notizspalten, wie sie im vorherigen Abschnitt
-beschrieben ist, ist es manchmal auch erforderlich alle aufgesammelten
+beschrieben ist, ist es manchmal auch erforderlich, alle aufgesammelten
Notizen, die noch nicht ausgegeben wurden, auszugeben. Das ist insbesondere
dann sinnvoll, wenn längere Notizen dazu führen, dass immer mehr Notizen nach
unten und auf neue Seiten verschoben werden. Ein guter Zeitpunkt für eine
@@ -693,7 +722,7 @@ anhängigen Notizen aller Notizspalten ausgegeben.%
\begin{Declaration}
- \OptionVName{autoclearnotecolumns}{Ein-Aus-Schalter}
+ \OptionVName{autoclearnotecolumns}{Ein-Aus-Wert}
\end{Declaration}
In der Regel wird man anhängige Notizen immer dann ausgeben lassen, wenn im
Dokument explizit oder implizit -- beispielsweise in Folge von
@@ -711,9 +740,9 @@ entsprechenden Werte für einfache Schalter (siehe
\autoref{tab:truefalseswitch} auf \autopageref{tab:truefalseswitch}) jederzeit
aus- und auch wieder einschalten.
-Es ist zu beachten, dass im Falle der Deaktivierung der automatischen Ausgabe
-anhängiger Notizen am Ende des Dokument Notizen ganz oder teilweise verloren
-gehen können. Daher sollte man in diesem Fall vor
+Es ist zu beachten\textnote{Achtung!}, dass im Falle der Deaktivierung der
+automatischen Ausgabe anhängiger Notizen am Ende des Dokument Notizen ganz
+oder teilweise verloren gehen können. Daher sollte man in diesem Fall vor
\Macro{end}\PParameter{document} sicherheitshalber ein
\DescRef{\LabelBase.cmd.clearnotecolumns} einfügen.
@@ -737,7 +766,7 @@ Das Ergebnis des Beispiels ist übrigens in
\begin{captionbeside}[{Eine Ergebnisseite zu dem Beispiel in
\autoref{cha:scrlayer-notecolumn}}]{Eine Ergebnisseite zu dem Beispiel
aus diesem Kapitel\label{fig:scrlayer-notecolumn.example}}[l]
- \frame{\includegraphics[width=.5\textwidth,keepaspectratio]%
+ \frame{\includegraphics[width=.667\textwidth,keepaspectratio]%
{scrlayer-notecolumn-example}}
\end{captionbeside}
\end{figure}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage-experts.tex
index 331a92a911a..1c01b4598e4 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage-experts.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage-experts.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlayer-scrpage-experts.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer-scrpage-experts.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -44,7 +44,7 @@
% ============================================================================
\KOMAProvidesFile{scrlayer-scrpage-experts.tex}%
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-01-31 09:21:42 +0100 (Wed, 31 Jan 2018) $
KOMA-Script guide (chapter: scrlayer-scrpage for experts)]
\chapter[{Zusätzliche Möglichkeiten von \Package{scrlayer-scrpage}}]
@@ -58,11 +58,11 @@
Über die Erklärungen in \autoref{cha:scrlayer-scrpage} von
\autoref{part:forAuthors} diese\iffree{r Anleitung}{s Buches} hinaus bietet
das Paket \Package{scrlayer-scrpage} viele weitere Möglichkeiten. Diese
-stellen jedoch entweder Erweiterungen dar, die der durchschnittliche Anwender
+stellen jedoch Erweiterungen dar, die der durchschnittliche Anwender
nicht zwingend benötigt oder die nur aus Gründen der Kompatibilität zu
-\Package{scrpage2} existieren, so dass die meisten Anwender sie nicht zu
-wissen brauchen. All diese Dinge werden daher hier in
-\autoref{part:forExperts} dokumentiert.
+\Package{scrpage2} existieren. Ihre Dokumentation hier in
+\autoref{part:forExperts} dient der Vertiefung und der Erweiterung des
+Wissens. Ihre Beherrschung geht über grundlegende Fähigkeiten hinaus.
\LoadCommonFile{pagestylemanipulation}% \section{Beeinflussung von definierten Seitenstilen}
@@ -75,20 +75,20 @@ vorgestellt. Diese bilden quasi ein Paar, bei dem \PageStyle{scrheadings} als
Haupt-Seitenstil mit Kolumnentitel vorgesehen ist, während
\PageStyle{plain.scrheadings} ein dazu passender \PageStyle{plain}-Seitenstil
ohne Kolumnentitel aber üblicherweise mit Paginierung, also mit Seitenzahl
-ist. Neben der Konfiguration dieses vordefinierten Paars bietet
+ist. Neben der Konfiguration dieses vordefinierten Paares bietet
\Package{scrlayer-scrpage} auch die Möglichkeit, zusätzliche Paare zu
-definieren. Der Name des Haupt-Seitenstils \PageStyle{scrheadings} dient dabei
-quasi auch als Name des Seitenstil-Paars.
-
-Die allermeisten Anwender werden in der Regel mit dem einen vordefinierten
-Seitenstil-Paar \PageStyle{scrheadings} auskommen. Die in diesem Abschnitt
-dokumentierten Anweisungen sind daher eher Ergänzungen für besondere Fälle. Da
-mir während des Abfassens dieser Anleitung keine handlichen
-Anwendungsbeispiele eingefallen sind, gibt es auch keine ausführlichen
-Beispiele. Sollte mir im Support einmal eine besonders schöne Anwendung
-begegnen, werde ich solche aber in zukünftigen Fassungen gerne aufgreifen. Ich
-bin jedoch gleichzeitig sicher, dass sich all diese Fälle auch mit dem einen
-Paar \PageStyle{scrheadings} lösen lassen.
+definieren. Der Name des Haupt-Seitenstils, beispielsweise
+\PageStyle{scrheadings}, dient dabei quasi auch als Name des Seitenstil-Paares.
+
+\iffree{Die allermeisten Anwender werden in der Regel mit dem einen
+ vordefinierten Seitenstil-Paar \PageStyle{scrheadings} auskommen. Die in
+ diesem Abschnitt dokumentierten Anweisungen sind daher eher Ergänzungen für
+ besondere Fälle. Da mir während des Abfassens dieser Anleitung keine
+ handlichen Anwendungsbeispiele eingefallen sind, gibt es auch keine
+ ausführlichen Beispiele. Sollte mir im Support einmal eine besonders schöne
+ Anwendung begegnen, werde ich solche aber in zukünftigen Fassungen gerne
+ aufgreifen. Ich bin jedoch gleichzeitig sicher, dass sich all diese Fälle
+ auch mit dem einen Paar \PageStyle{scrheadings} lösen lassen.}{}
\begin{Declaration}
\Macro{defpairofpagestyles}\OParameter{Eltern-Paar}
@@ -111,16 +111,16 @@ gleichzeitig der Name des Paares und des Hauptseitenstils dieses Paares, während
Paares ist.
Ist das optionale Argument \PName{Eltern-Paar} angegeben, so ist dies der Name
-eines Seitenstil-Paars, mit dessen Einstellungen das neue Paar initialisiert
+eines Seitenstil-Paares, mit dessen Einstellungen das neue Paar initialisiert
werden soll. Das neue Paar erbt also quasi die Konfiguration des
\PName{Eltern-Paar}s.
+{\setlength{\emergencystretch}{1em}%
Während in \autoref{sec:scrlayer-scrpage.predefined.pagestyles} der Eindruck
entstanden sein mag, dass sich die dort erläuterten Anweisungen nur auf
\PageStyle{scrheadings} und \PageStyle{plain.scrheadings} beziehen, gilt das
tatsächlich nur, solange diese beiden Seitenstile das einzige Seitenstil-Paar
-darstellen. Sobald es mehrere Seitenstil-Paare gibt, beziehen sich die
-Anweisungen auf das zuletzt aktive Paar. Dies gilt für
+darstellen. Sobald es mehrere Seitenstil-Paare gibt, beziehen sich
\DescRef{scrlayer-scrpage.cmd.lehead}, \DescRef{scrlayer-scrpage.cmd.cehead},
\DescRef{scrlayer-scrpage.cmd.rehead}, \DescRef{scrlayer-scrpage.cmd.lohead},
\DescRef{scrlayer-scrpage.cmd.cohead}, \DescRef{scrlayer-scrpage.cmd.rohead},
@@ -129,8 +129,8 @@ Anweisungen auf das zuletzt aktive Paar. Dies gilt für
\DescRef{scrlayer-scrpage.cmd.cofoot}, \DescRef{scrlayer-scrpage.cmd.rofoot},
\DescRef{scrlayer-scrpage.cmd.ihead}, \DescRef{scrlayer-scrpage.cmd.chead},
\DescRef{scrlayer-scrpage.cmd.ohead}, \DescRef{scrlayer-scrpage.cmd.ifoot},
-\DescRef{scrlayer-scrpage.cmd.cfoot}, \DescRef{scrlayer-scrpage.cmd.ofoot} aus
-\autoref{sec:scrlayer-scrpage.predefined.pagestyles}.
+\DescRef{scrlayer-scrpage.cmd.cfoot} und \DescRef{scrlayer-scrpage.cmd.ofoot}
+auf das zuletzt aktive Paar.\par}
{\setlength{\emergencystretch}{1em}%
Neben den achtzehn vorgenannten sind auch die drei nachfolgend
@@ -139,7 +139,7 @@ Anweisungen auf das zuletzt aktive Paar. Dies gilt für
\DescRef{scrlayer-scrpage-experts.cmd.clearplainofpairofpagestyles} und
\DescRef{scrlayer-scrpage-experts.cmd.clearpairofpagestyles} für die
Verwendung im letzten Parameter, \PName{Definition}, gedacht. In diesem Fall
- stellen sie eine Art Grundkonfiguration des Seitenstil-Paars dar, die immer
+ stellen sie eine Art Grundkonfiguration des Seitenstil-Paares dar, die immer
dann ausgeführt wird, wenn das Seitenstil-Paar aktiviert wird. Ein
Seitenstil-Paar wird aktiviert, indem einer der beiden Seitenstile des
Paares aktiviert wird. Dies geschieht in der Regel mit Hilfe von
@@ -151,10 +151,10 @@ Es sei darauf hingewiesen, dass die Anweisungen aus
sind und für alle mit \PageStyle{scrlayer-scrpage} definierten Seitenstile
gelten.
-Während \Macro{defpairofpagestyles} das Seitenstil-Paar unabhängig davon, ob
-entsprechende Seitenstile bereits existieren, definiert, tun
-\Macro{newpairofpagestyles} und \Macro{providepairofpagestyles} dies
-nur, wenn die Seitenstile noch nicht definiert sind. Ist mindestens einer der
+Während\textnote{Unterschiede} \Macro{defpairofpagestyles} das Seitenstil-Paar
+unabhängig davon, ob entsprechende Seitenstile bereits existieren, definiert,
+tun \Macro{newpairofpagestyles} und \Macro{providepairofpagestyles} dies nur,
+wenn die Seitenstile noch nicht definiert sind. Ist mindestens einer der
beiden Seitenstile des Paares bereits definiert, so wird die neuerliche
Definition bei \Macro{providepairofpagestyles} ignoriert, wohingegen sie bei
\Macro{newpairofpagestyles} zu einem Fehler führt. Für die Umdefinierung
@@ -186,303 +186,21 @@ Die Anweisungen können ebenfalls innerhalb von \PName{Definition} bei der
zuvor erklärten Definition eines Seitenstil-Paares verwendet werden. Sie
können aber auch jederzeit außerhalb der Definition eines Seitenstil-Paares
verwendet werden. In diesem Fall beziehen sie sich auf das zuletzt aktivierte
-Paar.
-
-\BeginIndex{Cmd}{clearscrheadings}%
-\BeginIndex{Cmd}{clearscrplain}%
-\BeginIndex{Cmd}{clearscrheadfoot}%
-Die drei Anweisungen \Macro{clearscrheadings}, \Macro{clearscrplain} und
-\Macro{clearscrheadfoot} sind Aliase für diese Anweisungen, die nur aus
-Gründen der Kompatibilität mit \Package{scrpage2} existieren. Sie sollten
-nicht mehr verwendet werden.%
-\EndIndexGroup
-
-
-\section{Definition einfacher Seitenstile mit dreigeteiltem Kopf und Fuß}
-\seclabel{pagestyle.triple}
-
-Neben den vordefinierten Seitenstilen und der Definition eigener
-Seitenstil-Paare bietet \Package{scrlayer-scrpage} auch noch die Möglichkeit
-der Definition von Seitenstilen, bei denen sowohl der Kopf als auch der Fuß fest
-in drei Elemente aufgeteilt ist. Diese Schnittstelle existiert jedoch nur aus
-Gründen der Kompatibilität mit \Package{scrpage2}. Zum
-Zwecke eines konsistenteren Befehlssatzes wurde sie sogar noch
-erweitert. Dennoch wird empfohlen, für neue Dokumente nicht mehr auf diese
-Möglichkeit zurück zu greifen, sondern die deutlich überlegenen Möglichkeiten
-der vorherigen Abschnitte oder des nachfolgenden Abschnitts zu nutzen.
-
-\begin{Declaration}
- \Macro{deftriplepagestyle}\Parameter{Name des Seitenstils}
- \OParameter{Dicke der äußeren Linie}
- \OParameter{Dicke der inneren Linie}
- \Parameter{inneres Kopfelement}
- \Parameter{mittleres Kopfelement}
- \Parameter{äußeres Kopfelement}
- \Parameter{inneres Fußelement}
- \Parameter{mittleres Fußelement}
- \Parameter{äußeres Fußelement}
- \Macro{newtriplepagestyle}\Parameter{Name des Seitenstils}
- \OParameter{Dicke der äußeren Linien}
- \OParameter{Dicke der inneren Linien}
- \Parameter{inneres Kopfelement}
- \Parameter{mittleres Kopfelement}
- \Parameter{äußeres Kopfelement}
- \Parameter{inneres Fußelement}
- \Parameter{mittleres Fußelement}
- \Parameter{äußeres Fußelement}
- \Macro{renewtriplepagestyle}\Parameter{Name des Seitenstils}
- \OParameter{Dicke der äußeren Linie}
- \OParameter{Dicke der inneren Linie}
- \Parameter{inneres Kopfelement}
- \Parameter{mittleres Kopfelement}
- \Parameter{äußeres Kopfelement}
- \Parameter{inneres Fußelement}
- \Parameter{mittleres Fußelement}
- \Parameter{äußeres Fußelement}
- \Macro{providetriplepagestyle}\Parameter{Name des Seitenstils}
- \OParameter{Dicke der äußeren Linie}
- \OParameter{Dicke der inneren Linie}
- \Parameter{inneres Kopfelement}
- \Parameter{mittleres Kopfelement}
- \Parameter{äußeres Kopfelement}
- \Parameter{inneres Fußelement}
- \Parameter{mittleres Fußelement}
- \Parameter{äußeres Fußelement}
-\end{Declaration}
-Mit diesen Anweisungen kann ein einzelner Seitenstil definiert werden, bei dem
-Kopf und Fuß in drei Elemente aufgeteilt sind: ein inneres Element, ein
-mittleres Element und ein äußeres Element. Diese werden über jeweils drei
-obligatorische Argumente angegeben.
-
-Das jeweilige innere Element wird auf linken Seiten rechtsbündig im Kopf
-respektive im Fuß platziert. Auf rechten Seiten wird es hingegen linksbündig
-platziert. Entsprechend wird das mittlere Element sowohl auf linken als auch
-auf rechten Seiten im Kopf respektive Fuß zentriert. Das äußere Element wird
-schließlich auf linken Seiten linksbündig und auf rechten Seiten rechtsbündig
-im Kopf respektive Fuß platziert.
-
-An\textnote{Achtung!} dieser Stelle sei noch einmal daran erinnert, dass im
-einseitigen Satz nur rechte Seiten existieren!
-
-Mit den beiden optionalen Argumenten können Linien in Kopf und Fuß aktiviert
-werden. Dazu gibt man die gewünschte Dicke der Linien als Argument an. Das
-erste optionale Argument betrifft die \PName{Dicke der äußeren Linien}. Diese
-Linien werden über dem Kopf und unter dem Fuß gezeichnet. Das zweite optionale
-Argument betrifft die \PName{Dicke der inneren Linien}. Diese beiden Linien
-werden unterhalb des Kopfes und oberhalb des Fußes gezeichnet. Ist nur ein
-optionales Argument angegeben, so ist dies die \PName{Dicke der inneren
- Linien}. Die \PName{Dicke der äußeren Linien} ist dann Null, womit nur noch
-die beiden inneren Linien gezeichnet werden. Ist keines der optionalen
-Argumente angegeben, so entfallen alle Linien.
-
-Es ist zu beachten\textnote{Achtung!}, dass leere optionale Argumente nicht
-gleichbedeutend mit dem Weglassen der optionalen Argumente sind! Leere
-optionale Argumente sind in diesem Fall nicht erlaubt. Dagegen sind einfache
-Längenausdrücke, wie sie bereits bei Option
-\DescRef{scrlayer-scrpage.option.headwidth} (siehe
-\autoref{sec:scrlayer-scrpage.pagestyle.content},
-\DescPageRef{scrlayer-scrpage.option.headwidth}) erklärt wurden, erlaubt.
-
-Die Bedeutung der einzelnen Argumente ist in
-\autoref{fig:scrlayer-scrpage-experts.triplepagestyle} noch einmal an einer
-schematischen Doppelseite veranschaulicht. Dabei dienen »\textsl{außen}«,
-»\textsl{innen}«, »\textsl{mittig}« als beispielhafte Inhalte. Die zugehörigen
-Pfeile verdeutlichen die Ausbreitung dieser Inhalte. Die \iffree{farbigen
-}{}Texte im Inneren der Seite sind die Namen der Argumente der Befehle. Die
-zugehörigen Pfeile \iffree{in gleicher Farbe }{}weisen auf die entsprechenden
-Elemente der Seite.
-
-\begin{figure}
- \centering
- \begin{picture}(\textwidth,80mm)
- \put(0,50mm){%
- %\
- \begin{picture}(\textwidth,30mm)(0,-10mm)
- \thinlines
- \small
- % linke Seite
- \put(0,20mm){\line(1,0){.49\textwidth}}%
- \put(0,0){\line(0,1){20mm}}%
- \multiput(0,0)(0,-1mm){10}{\line(0,-1){.5mm}}%
- \put(.49\textwidth,5mm){\line(0,1){15mm}}%
- \put(.05\textwidth,15mm){\thicklines\line(1,0){.415\textwidth}}%
- \put(.05\textwidth,10mm){\makebox(0em,5mm)[l]{\slshape außen\strut$\longrightarrow$}}%
- \put(.465\textwidth,10mm){\makebox(0em,5mm)[r]{\slshape $\longleftarrow$innen\strut}}%
- \put(.2575\textwidth,10mm){\makebox(0em,5mm)[c]{\slshape $\longleftarrow$mittig\strut$\longrightarrow$}}%
- \put(.05\textwidth,10mm){\thicklines\line(1,0){.415\textwidth}}%
- % rechte Seite
- \put(0.51\textwidth,20mm){\line(1,0){.49\textwidth}}%
- \put(0.51\textwidth,5mm){\line(0,1){15mm}}%
- \multiput(\textwidth,0)(0,-1mm){10}{\line(0,-1){.5mm}}%
- \put(\textwidth,0mm){\line(0,1){20mm}}%
- \put(.535\textwidth,15mm){\thicklines\line(1,0){.415\textwidth}}%
- \put(.535\textwidth,10mm){\makebox(0em,5mm)[l]{\slshape innen\strut$\longrightarrow$}}%
- \put(.95\textwidth,10mm){\makebox(0em,5mm)[r]{\slshape $\longleftarrow$außen\strut}}%
- \put(.7425\textwidth,10mm){\makebox(0em,5mm)[c]{\slshape $\longleftarrow$mittig\strut$\longrightarrow$}}%
- \put(.535\textwidth,10mm){\thicklines\line(1,0){.415\textwidth}}%
- % Befehle für beide Seiten
- \iffree{\color{red}}{}%
- \put(.5\textwidth,0){\makebox(0,\baselineskip)[c]{\PName{inneres Kopfelement}}}%
- \put(.5\textwidth,-5mm){\makebox(0,\baselineskip)[c]{\PName{mittleres Kopfelement}}}%
- \put(.5\textwidth,-10mm){\makebox(0,\baselineskip)[c]{\PName{äußeres Kopfelement}}}%
- \put(\dimexpr.5\textwidth-2em,.5\baselineskip){%
- \put(-1.5em,.5\baselineskip){\vector(0,1){7mm}}%
- \put(-4em,-1\baselineskip){\line(-1,0){\dimexpr .25\textwidth-7em\relax}}%
- \put(-\dimexpr
- .25\textwidth-3em\relax,-1\baselineskip){\vector(0,1){\dimexpr
- 7mm+1.5\baselineskip\relax}}
- \put(-3.25em,-2.25\baselineskip){\line(-1,0){\dimexpr .45\textwidth-8em\relax}}%
- \put(-\dimexpr
- .45\textwidth-4.75em\relax,-2.25\baselineskip){\vector(0,1){\dimexpr
- 7mm+2.75\baselineskip\relax}}
- }%
- \put(\dimexpr.5\textwidth+2em,.5\baselineskip){%
- \put(1.5em,.5\baselineskip){\vector(0,1){7mm}}%
- \put(4em,-1\baselineskip){\line(1,0){\dimexpr .25\textwidth-7em\relax}}
- \put(\dimexpr
- .25\textwidth-3em\relax,-1\baselineskip){\vector(0,1){\dimexpr
- 7mm+1.5\baselineskip\relax}}
- \put(3.25em,-2.25\baselineskip){\line(1,0){\dimexpr .45\textwidth-8em\relax}}
- \put(\dimexpr
- .45\textwidth-4.75em\relax,-2.25\baselineskip){\vector(0,1){\dimexpr
- 7mm+2.75\baselineskip\relax}}
- }%
- \end{picture}
- %
- }%
- \put(0,0){%
- \begin{picture}(\textwidth,30mm)
- \thinlines
- \small
- % linke Seite
- \put(0,0){\line(1,0){.49\textwidth}}%
- \put(0,0){\line(0,1){20mm}}%
- \multiput(0,20mm)(0,1mm){10}{\line(0,1){.5mm}}%
- \put(.49\textwidth,0){\line(0,1){15mm}}%
- \put(.05\textwidth,15mm){\thicklines\line(1,0){.415\textwidth}}%
- \put(.05\textwidth,10mm){\makebox(0em,5mm)[l]{\slshape außen\strut$\longrightarrow$}}%
- \put(.465\textwidth,10mm){\makebox(0em,5mm)[r]{\slshape $\longleftarrow$innen\strut}}%
- \put(.2575\textwidth,10mm){\makebox(0em,5mm)[c]{\slshape $\longleftarrow$mittig\strut$\longrightarrow$}}%
- \put(.05\textwidth,10mm){\thicklines\line(1,0){.415\textwidth}}%
- % rechte Seite
- \put(.51\textwidth,0){\line(1,0){.49\textwidth}}%
- \put(.51\textwidth,0){\line(0,1){15mm}}%
- \put(\textwidth,0){\line(0,1){20mm}}%
- \multiput(\textwidth,20mm)(0,1mm){10}{\line(0,1){.5mm}}%
- \put(.535\textwidth,15mm){\thicklines\line(1,0){.415\textwidth}}%
- \put(.535\textwidth,10mm){\makebox(0em,5mm)[l]{\slshape innen\strut$\longrightarrow$}}%
- \put(.95\textwidth,10mm){\makebox(0em,5mm)[r]{\slshape $\longleftarrow$außen\strut}}%
- \put(.7425\textwidth,10mm){\makebox(0em,5mm)[c]{\slshape $\longleftarrow$mittig\strut$\longrightarrow$}}%
- \put(.535\textwidth,10mm){\thicklines\line(1,0){.415\textwidth}}%
- % Befehle für beide Seiten
- \iffree{\color{red}}{}%
- \put(.5\textwidth,20mm){\makebox(0,\baselineskip)[c]{\PName{inneres Fußelement}}}%
- \put(.5\textwidth,25mm){\makebox(0,\baselineskip)[c]{\PName{mittleres Fußelement}}}%
- \put(.5\textwidth,30mm){\makebox(0,\baselineskip)[c]{\PName{äußeres Fußelement}}}%
- \put(\dimexpr.5\textwidth-2em,.5\baselineskip){%
- \put(-1.5em,\dimexpr 20mm-.5\baselineskip\relax){\vector(0,-1){6mm}}%
- \put(-3.5em,25mm){\line(-1,0){\dimexpr .25\textwidth-6.5em\relax}}%
- \put(-\dimexpr .25\textwidth-3em\relax,25mm){\vector(0,-1){\dimexpr
- .5\baselineskip + 11mm\relax}}%
- \put(-3em,30mm){\line(-1,0){\dimexpr .45\textwidth-7.5em\relax}}%
- \put(-\dimexpr .45\textwidth-4.5em\relax,30mm){\vector(0,-1){\dimexpr
- .5\baselineskip + 16mm\relax}}%
- }%
- \put(\dimexpr.5\textwidth+2em,.5\baselineskip){%
- \put(1.5em,\dimexpr 20mm-.5\baselineskip\relax){\vector(0,-1){6mm}}%
- \put(3.5em,25mm){\line(1,0){\dimexpr .25\textwidth-6.5em\relax}}%
- \put(\dimexpr .25\textwidth-3em\relax,25mm){\vector(0,-1){\dimexpr
- .5\baselineskip + 11mm\relax}}%
- \put(3em,30mm){\line(1,0){\dimexpr .45\textwidth-7.5em\relax}}%
- \put(\dimexpr .45\textwidth-4.5em\relax,30mm){\vector(0,-1){\dimexpr
- .5\baselineskip + 16mm\relax}}%
- }%
- \end{picture}
- }%
- \thinlines\small\iffree{\color{blue}}{}%
- \put(0.055\textwidth,45mm){\vector(0,1){25mm}}%
- \put(0.945\textwidth,45mm){\vector(0,1){25mm}}%
- \put(0.055\textwidth,45mm){\vector(0,-1){30mm}}%
- \put(0.945\textwidth,45mm){\vector(0,-1){30mm}}%
- \put(0.055\textwidth,45mm){\line(1,0){\dimexpr
- .445\textwidth-6.5em\relax}}%
- \put(0.945\textwidth,45mm){\line(-1,0){\dimexpr
- .445\textwidth-6.5em\relax}}%
- \put(0.5\textwidth,45mm){\makebox(0,0)[c]{\PName{Dicke der inneren
- Linien}}}%
- \iffree{\color{green}}{}%
- \put(0.025\textwidth,40mm){\line(0,1){35mm}}%
- \put(0.025\textwidth,75mm){\vector(1,0){3.75mm}}%
- \put(0.975\textwidth,40mm){\line(0,1){35mm}}%
- \put(0.975\textwidth,40mm){\line(0,1){35mm}}%
- \put(0.975\textwidth,75mm){\vector(-1,0){3.75mm}}%
- \put(0.025\textwidth,40mm){\line(0,-1){30mm}}%
- \put(0.025\textwidth,10mm){\vector(1,0){3.75mm}}%
- \put(0.975\textwidth,40mm){\line(0,-1){30mm}}%
- \put(0.975\textwidth,40mm){\line(0,-1){30mm}}%
- \put(0.975\textwidth,10mm){\vector(-1,0){3.75mm}}%
- \put(0.025\textwidth,40mm){\line(1,0){\dimexpr
- .475\textwidth-6.5em\relax}}%
- \put(0.975\textwidth,40mm){\line(-1,0){\dimexpr
- .475\textwidth-6.5em\relax}}%
- \put(0.5\textwidth,40mm){\makebox(0,0)[c]{\PName{Dicke der äußeren Linien}}}%
- \end{picture}
- \caption[{Elemente dreigeteilter Seitenstile}]{Elemente einer Doppelseite
- der dreigeteilten Seitenstile mit den Anweisungen
- \Macro{deftriplepagestyle}, \Macro{newtriplepagestyle},
- \Macro{providetriplepagestyle} und \Macro{renewtriplepagestyle}}
- \label{fig:scrlayer-scrpage-experts.triplepagestyle}
-\end{figure}
-
-
-Mit den hier dokumentierten Anweisungen ist es nicht möglich, einzelne Linien
-zu aktivieren, beispielsweise nur eine Linie unter dem Seitenkopf, aber keine
-Linie über dem Seitenfuß zu haben. Verwenden Sie dafür stattdessen die
-Anweisungen aus einem der vorherigen oder aus dem nachfolgenden Abschnitt.
-
-Die\textnote{Achtung!} Länge der einzelnen Elemente ist nicht durch das
-Vorhandensein eines Nachbarelements beschränkt. Dadurch kann es bei
-ungünstiger Verwendung passieren, dass ein Element eines oder beide
-Nachbarelemente überschreibt. Der Anwender ist selbst für die Vermeidung
-dieses ungünstigen Falles verantwortlich. Bei lebenden Kolumnentiteln ist dies
-beispielsweise durch Verwendung des optionalen Arguments der
-Gliederungsbefehle möglich. Siehe dazu die Anleitung zu den
-Gliederungsbefehlen der jeweiligen Klasse.
-
-Während \Macro{deftriplepagestyle} einen Seitenstil unabhängig davon, ob er
-bereits früher definiert wurde, immer definiert, werden mit
-\Macro{newtriplepagestyle} und \Macro{providetriplepagestyle} nur Seitenstile
-definiert, die derzeit noch nicht definiert sind. Ist ein Seitenstil
-bereits definiert, so erhält man mit \Macro{newtriplepagestyle} eine
-Fehlermeldung, während \Macro{providetriplepagestyle} die neue Definition
-einfach verwirft. Ein vorhandener Seitenstil kann auch mit
-\Macro{renewtriplepagestyle} umdefiniert werden. Diese Anweisung meldet einen
-Fehler, falls ein Seitenstil dieses Namens noch nicht definiert war.%
-
-\BeginIndex{Cmd}{deftripstyle}%
-Die vom Paket \Package{scrpage2} bekannte Anweisung \Macro{deftripstyle}
-entspricht damit der neuen Anweisung \Macro{deftriplepagestyle}. Sie wurde aus
-Gründen der Vereinheitlichung der Namen der Anweisungen jedoch umbenannt und
-sollte nicht mehr verwendet werden. Wird sie dennoch verwendet, resultiert
-daraus eine Warnung.%
+Paar.%
\EndIndexGroup
\section{Definition komplexer Seitenstile}
\seclabel{pagestyle.experts}
-Neben den vordefinierten Seitenstilen und der Definition eigener
-Seitenstil-Paare, sowie der nicht mehr empfohlenen Möglichkeit der Definition
-von Seitenstilen, bei denen sowohl der Kopf als auch der Fuß fest in drei
-Elemente aufgeteilt ist, bietet \Package{scrlayer-scrpage} auch noch eine eher
-grundlegende Möglichkeit der Definition von Seitenstilen. Die in den
-vorherigen Abschnitten erläuterten Konzepte greifen bei der Implementierung
-alle auf diese Möglichkeit zurück. Aufgrund ihrer Komplexität wird diese
-Schnittstelle jedoch nur erfahrenen Anwendern empfohlen. Weniger erfahrene
-Anwender können mit den vorgenannten Möglichkeiten bereits nahezu alles
-erreichen, was auch mit dieser grundlegenden Schnittstelle möglich
-ist. Weniger erfahrene Anwender dürfen den Rest dieses Kapitels daher gerne
-überspringen.
+Neben den vordefinierten Seitenstilen bietet \Package{scrlayer-scrpage} auch
+noch eine eher grundlegende Schnittstelle zur Definition von Seitenstilen. Die
+bisher erläuterten Konzepte greifen bei der Implementierung ebenso wie die von
+\autoref{sec:\LabelBase.pagestyle.triple} auf diese Möglichkeit
+zurück. Aufgrund ihrer hohen Komplexität wird sie jedoch nur erfahrenen
+Anwendern empfohlen. Weniger erfahrene Anwender können mit den vorgenannten
+Möglichkeiten bereits nahezu alles erreichen, was auch mit dieser
+grundlegenden Schnittstelle möglich ist.
\begin{Declaration}
\Macro{defpagestyle}\Parameter{Name}
@@ -537,24 +255,25 @@ wählbar. Für Seitenstile mit Kolumnentitel wird jedoch die Verwendung von
empfohlen. Keinesfalls sollte man hier direkt eine Gliederungsnummer oder
einen Überschriftentext als Kolumnentitel angeben. Aufgrund des asynchronen
Seitenaufbaus von \LaTeX{} kann sonst die falsche Nummer oder der falsche Text
-im Seitenkopf erscheinen.
+im Seitenkopf oder Seitenfuß erscheinen.
-Bei \Macro{defpagestyle} wird der Seitenstil unabhängig davon, ob er bereits
-existiert oder nicht, neu definiert. Demgegenüber meldet \Macro{newpagestyle}
-einen Fehler, wenn bereits ein Seitenstil gleichen Namens existiert. Im
-Unterschied dazu wird die Definition bei \Macro{providepagestyle} ignoriert,
-falls der \PName{Name} bereits für einen Seitenstil verwendet wurde. Umgekehrt
-kann mit \Macro{renewpagestyle} nur ein bereits vorhandener Seitenstil
-umdefiniert werden. Für einen neuen Namen meldet diese Anweisung dagegen einen
-Fehler.
+Bei\textnote{Unterschiede} \Macro{defpagestyle} wird der Seitenstil unabhängig
+davon, ob er bereits existiert oder nicht, neu definiert. Demgegenüber meldet
+\Macro{newpagestyle} einen Fehler, wenn bereits ein Seitenstil gleichen Namens
+existiert. Im Unterschied dazu wird die Definition bei
+\Macro{providepagestyle} ignoriert, falls der \PName{Name} bereits für einen
+Seitenstil verwendet wurde. Umgekehrt kann mit \Macro{renewpagestyle} nur ein
+bereits vorhandener Seitenstil umdefiniert werden. Für einen neuen Namen
+meldet diese Anweisung dagegen einen Fehler.
Alle vier Anweisungen basieren auf
\DescRef{scrlayer.cmd.DeclarePageStyleByLayers}%
-\IndexCmd{DeclarePageStyleByLayers} des Pakets \Package{scrlayer}. Die dabei
+\IndexCmd{DeclarePageStyleByLayers} des Pakets
+\hyperref[cha:scrlayer]{\Package{scrlayer}}\IndexPackage{scrlayer}. Die dabei
für einen Seitenstil \PName{Name} definierten Ebenen sind in
\autoref{tab:scrlayer-scrpage-experts.layersperstyle} aufgeführt. Näheres zu
Ebenen und Ebenen-Seitenstilen ist \autoref{cha:scrlayer} ab
-\autopageref{cha:scrlayer} in \autoref{part:forExperts} zu entnehmen.%
+\autopageref{cha:scrlayer} zu entnehmen.%
\begin{table}
% \KOMAoptions{captions=topbeside}
@@ -657,12 +376,27 @@ Statt wie im Beispiel für die Hintergrundfarbe neue Ebenen hinzuzufügen, hätte
man das Problem übrigens auch mit \Macro{colorbox} und
\DescRef{scrlayer-scrpage.cmd.chead} lösen können. Es wird empfohlen, eine
entsprechende Lösung als Übung zu erarbeiten. Ebenso
-\iffree{}{\pagebreak}% Umbruchkorrektur
hätte man die Hintergrundebenen auch einzeln und jeweils unmittelbar vor der
-entsprechenden Inhaltsebene einfügen können. Auch dies sei als Übung
-empfohlen.%
+entsprechenden Inhaltsebene einfügen können. Eine entsprechende Umsetzung
+bietet sich als weitere Übung an.%
\EndIndexGroup
+\section{Definition einfacher Seitenstile mit dreigeteiltem Kopf und Fuß}
+\seclabel{pagestyle.triple}
+
+\LoadNonFree{scrlayer-scrpage-experts}{1}
+
+\section{Das obsolete Erbe von \Package{scrpage2}}
+\seclabel{obsolete}
+
+\begin{Explain}
+ Das Paket \Package{scrlayer-scrpage} enthält auch noch einige Altlasten, die
+ von \Package{scrpage2} stammen und nur existieren, um möglichst kompatibel
+ mit jenem Paket zu sein. Kenntnisse dazu benötigen Anwender nur, wenn sie
+ ein altes Dokument, das noch auf \Package{scrpage2} basiert, bearbeiten
+ wollen. Für\textnote{Achtung!} neue Dokumente sollten die hier dokumentieren
+ Dinge dagegen nicht verwendet werden!
+\end{Explain}
\begin{Declaration}
\OptionVName{hmode}{Ein-Aus-Wert}
@@ -681,6 +415,8 @@ Die Option versteht die Standardwerte für einfache Schalter, die in
\autoref{tab:truefalseswitch} auf \autopageref{tab:truefalseswitch} angegeben
sind. In der Voreinstellung ist der Schalter deaktiviert.%
\EndIndexGroup
+
+\LoadNonFree{scrlayer-scrpage-experts}{0}
%
\EndIndexGroup
@@ -693,5 +429,5 @@ sind. In der Voreinstellung ist der Schalter deaktiviert.%
%%% End:
-% LocalWords: Hintergrundebene Seitenkopf Seitenstils Kopfelement
-% LocalWords: Seitenstile
+% LocalWords: Hintergrundebene Seitenkopf Seitenstils Kopfelement Seitenfuß
+% LocalWords: Seitenstile Seitenstilen
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage.tex
index 7f22dda1bc9..2a2adf3ad8c 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlayer-scrpage.tex
-% Copyright (c) Markus Kohm, 2014-2017
+% Copyright (c) Markus Kohm, 2014-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer-scrpage.tex
-% Copyright (c) Markus Kohm, 2014-2017
+% Copyright (c) Markus Kohm, 2014-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -44,7 +44,7 @@
% ============================================================================
\KOMAProvidesFile{scrlayer-scrpage.tex}%
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-02-13 09:46:41 +0100 (Tue, 13 Feb 2018) $
KOMA-Script guide (chapter:scrlayer-scrpage)]
\chapter[{Kopf- und Fußzeilen mit \Package{scrlayer-scrpage}}]
@@ -56,25 +56,29 @@
\BeginIndex{Package}{scrlayer-scrpage}%
\begin{Explain}
Bis \KOMAScript~3.11b war das Paket
- \Package{scrpage2}\IndexPackage{scrpage2} das Mittel der Wahl, wenn es darum
- ging, den Kopf und den Fuß der Seite über das hinaus zu verändern, was die
+ \Package{scrpage2}\IndexPackage[indexmain]{scrpage2}%
+ \important{\Package{scrpage2}} das Mittel der Wahl, wenn es darum ging, den
+ Kopf und den Fuß der Seite über das hinaus zu verändern, was die
\KOMAScript-Klassen mit den Seitenstilen \PageStyle{headings},
- \PageStyle{myheadings}, \PageStyle{plain} und \PageStyle{empty} boten. Bis
- 2001 gab es dafür auch noch das Paket
+ \PageStyle{myheadings}, \PageStyle{plain} und \PageStyle{empty} boten.
+ \iffalse%
+ Bis 2001 gab es dafür auch noch das Paket
\Package{scrpage}\IndexPackage{scrpage}, das aber seit 2013 nicht mehr mit
- \KOMAScript{} zusammen verteilt wird.
-
- Seit 2013 ist das Paket \Package{scrlayer}\IndexPackage{scrlayer} als neuer,
- grundlegender Baustein in \KOMAScript{} enthalten. Dieses Paket bietet ein
- Ebenenmodell sowie ein darauf basierendes Seitenstil-Modell an. Für die
- direkte Verwendung durch den durchschnittlichen Anwender ist die
- Schnittstelle dieses Pakets jedoch fast schon zu flexibel und damit
- einhergehend auch nicht leicht zu durchschauen. Näheres zu dieser
- Schnittstelle ist \autoref{cha:scrlayer} in \autoref{part:forExperts} zu
- entnehmen. Einige wenige Möglichkeiten, die eigentlich zu \Package{scrlayer}
- gehören und deshalb in jenem Kapitel noch einmal aufgegriffen werden, sind
- jedoch auch in diesem Kapitel dokumentiert, da sie für die Verwendung von
- \Package{scrlayer-scrpage} ebenfalls benötigt werden.
+ \KOMAScript{} zusammen verteilt wird.\par
+ \fi%
+ Seit 2013 ist das Paket \hyperref[cha:scrlayer]{\Package{scrlayer}}%
+ \important{\hyperref[cha:scrlayer]{\Package{scrlayer}}}%
+ \IndexPackage{scrlayer} als neuer, grundlegender Baustein in \KOMAScript{}
+ enthalten. Dieses Paket bietet ein Ebenenmodell sowie ein darauf basierendes
+ Seitenstil-Modell an. Für die direkte Verwendung durch den
+ durchschnittlichen Anwender ist die Schnittstelle dieses Pakets jedoch fast
+ schon zu flexibel und damit einhergehend auch nicht leicht zu
+ durchschauen. Näheres zu dieser Schnittstelle ist \autoref{cha:scrlayer} in
+ \autoref{part:forExperts} zu entnehmen. Einige wenige Möglichkeiten, die
+ eigentlich zu \Package{scrlayer} gehören und deshalb in jenem Kapitel noch
+ einmal aufgegriffen werden, sind jedoch auch in diesem Kapitel dokumentiert,
+ da sie für die Verwendung von \Package{scrlayer-scrpage} ebenfalls benötigt
+ werden.
Viele Anwender sind bereits mit den Anweisungen aus \Package{scrpage2}
vertraut. Deshalb wurde mit \Package{scrlayer-scrpage} ein Paket geschaffen,
@@ -84,9 +88,9 @@
unsauberen Rückgriffe auf interne Anweisungen getätigt hat, kann daher in
der Regel \Package{scrpage2} recht einfach durch \Package{scrlayer-scrpage}
ersetzen. Das gilt mit der genannten Einschränkung auch für die meisten
- Beispiele in \LaTeX-Büchern oder im Internet.
-
-\iffree{}{Mit Erscheinen dieses Buches wird \Package{scrlayer-scrpage} für
+ Beispiele in \LaTeX-Büchern oder im Internet.%
+\iffalse
+\iffree{}{\par Mit Erscheinen dieses Buches wird \Package{scrlayer-scrpage} für
\KOMAScript{} das empfohlene Mittel der Wahl, wenn es um Änderungen der
vordefinierten Seitenstile geht. Die Verwendung des als veraltet
anzusehenden Pakets \Package{scrpage2}\IndexPackage[indexmain]{scrpage2}%
@@ -96,6 +100,7 @@
verwenden, sollten Sie eine Umstellung auf \Package{scrlayer-scrpage}
erwägen. Für alle Fälle finden Sie in diesem Kapitel auch einige Hinweise
zur Verwendung von \Package{scrpage2}.}
+\fi
\end{Explain}
Neben \Package{scrlayer-scrpage}\iffree{ oder \Package{scrpage2}}{} wäre auch
@@ -124,7 +129,7 @@ Anwender von Interesse sein dürfte und daher in
\autoref{cha:scrlayer-scrpage-experts} von \autoref{part:forExperts} ab
\autopageref{cha:scrlayer-scrpage-experts} ausgeführt wird. Dennoch: Falls die
hier in \autoref{part:forAuthors} dokumentierten Möglichkeiten für Sie nicht
-ausreichen, sei Ihnen auch jenes Kapitel nahe gelegt.
+ausreichen, sei Ihnen auch jenes Kapitel nahegelegt.
\LoadCommonFile{options} % \section{Frühe oder späte Optionenwahl}
@@ -187,16 +192,7 @@ Klassen sind nicht erforderlich. Die beiden Seitenstile stellen also quasi ein
Paar dar, das als Ersatz für \PageStyle{headings} und \PageStyle{plain}
verwendet werden kann. Sollten weitere solche Paare benötigt werden, so sei
auf \autoref{sec:scrlayer-scrpage-experts.pagestyle.pairs} in
-\autoref{part:forExperts} verwiesen.
-
-Für\important{\Package{scrpage2}} frühere Benutzer des alten
-\KOMAScript-Pakets \Package{scrpage2} sei ausdrücklich noch darauf
-hingewiesen, dass \PageStyle{plain.scrheadings} aus Gründen der Kompatibilität
-mit jenem Paket auch unter dem Alias-Namen
-\PageStyle{scrplain}\IndexPagestyle[indexmain]{scrplain} angesprochen werden
-kann.\iffree{}{ Bei Verwendung von \Package{scrpage2}\IndexPackage{scrpage2}
- existiert hingegen \PageStyle{plain.scrheadings} nicht. Dessen Funktion wird
- dann vollständig vom Seitenstil \PageStyle{scrplain} übernommen.}
+\autoref{part:forExperts} verwiesen.%
\EndIndexGroup
@@ -214,15 +210,21 @@ kann.\iffree{}{ Bei Verwendung von \Package{scrpage2}\IndexPackage{scrpage2}
\Macro{rohead}\OParameter{Inhalt plain.scrheadings}%
\Parameter{Inhalt scrheadings}
\end{Declaration}
-Was in den Kopf der Seitenstile \PageStyle{plain.scrheadings}\iffree{}{ --
- beim veralteten Paket
- \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}
- entsprechend in den Kopf von \PageStyle{scrplain} --} und
-\PageStyle{scrheadings} geschrieben wird, ist mit Hilfe dieser Befehle
-einstellbar. Dabei setzt das optionale Argument jeweils den Inhalt eines
-Elements in \PageStyle{plain.scrheadings}\iffree{}{ beziehungsweise
- \PageStyle{scrplain}}, während das obligatorische Argument jeweils einen
-Inhalt in \PageStyle{scrheadings} setzt.
+\iffalse% Umbruchvarianten
+Was in den Kopf der Seitenstile
+\DescRef{\LabelBase.pagestyle.plain.scrheadings} und
+\DescRef{\LabelBase.pagestyle.scrheadings} %
+\else%
+Was bei \DescRef{\LabelBase.pagestyle.scrheadings} und
+\DescRef{\LabelBase.pagestyle.plain.scrheadings} in den Kopf der Seite %
+\fi%
+geschrieben wird, ist mit Hilfe dieser Befehle einstellbar. Dabei setzt das
+optionale Argument jeweils den Inhalt eines Elements in
+\DescRef{\LabelBase.pagestyle.plain.scrheadings}%
+\iffalse% Umbruchvarianten
+\iffree{}{ beziehungsweise \PageStyle{scrplain}} \fi , während das
+obligatorische Argument jeweils einen Inhalt in
+\DescRef{\LabelBase.pagestyle.scrheadings} setzt.
Die Inhalte für gerade, also linke Seiten\textnote{linke Seite} werden mit den
Befehlen \Macro{lehead}, \Macro{cehead} und \Macro{rehead} gesetzt. Das
@@ -283,7 +285,7 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.%
\multiput(0,0)(0,-1mm){10}{\line(0,-1){.5mm}}%
\put(.49\textwidth,5mm){\line(0,1){15mm}}%
\put(.05\textwidth,10mm){%
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(-.5em,0){\line(1,0){4em}}%
\multiput(3.5em,0)(.25em,0){5}{\line(1,0){.125em}}%
\put(-.5em,0){\line(0,1){\baselineskip}}%
@@ -292,7 +294,7 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.%
\makebox(4em,5mm)[l]{\Macro{lehead}}%
}%
\put(.465\textwidth,10mm){%
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(-4em,0){\line(1,0){4em}}%
\multiput(-4em,0)(-.25em,0){5}{\line(1,0){.125em}}%
\put(0,0){\line(0,1){\baselineskip}}%
@@ -301,7 +303,7 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.%
\put(-4.5em,0){\makebox(4em,5mm)[r]{\Macro{rehead}}}%
}%
\put(.2525\textwidth,10mm){%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(-2em,0){\line(1,0){4em}}%
\multiput(2em,0)(.25em,0){5}{\line(1,0){.125em}}%
\multiput(-2em,0)(-.25em,0){5}{\line(1,0){.125em}}%
@@ -316,7 +318,7 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.%
\put(\textwidth,0){\line(0,1){20mm}}%
\multiput(\textwidth,0)(0,-1mm){10}{\line(0,-1){.5mm}}%
\put(.5325\textwidth,10mm){%
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(0,0){\line(1,0){4em}}%
\multiput(4em,0)(.25em,0){5}{\line(1,0){.125em}}%
\put(0,0){\line(0,1){\baselineskip}}%
@@ -325,7 +327,7 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.%
\put(.5em,0){\makebox(4em,5mm)[l]{\Macro{lohead}}}%
}%
\put(.965\textwidth,10mm){%
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(-4em,0){\line(1,0){4em}}%
\multiput(-4em,0)(-.25em,0){5}{\line(1,0){.125em}}%
\put(0,0){\line(0,1){\baselineskip}}%
@@ -334,7 +336,7 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.%
\put(-4.5em,0){\makebox(4em,5mm)[r]{\Macro{rohead}}}%
}%
\put(.75\textwidth,10mm){%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(-2em,0){\line(1,0){4em}}%
\multiput(2em,0)(.25em,0){5}{\line(1,0){.125em}}%
\multiput(-2em,0)(-.25em,0){5}{\line(1,0){.125em}}%
@@ -344,37 +346,37 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.%
\put(-2em,0){\makebox(4em,5mm)[c]{\Macro{cohead}}}%
}%
% Befehle für beide Seiten
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(.5\textwidth,0){\makebox(0,\baselineskip)[c]{\Macro{ihead}}}%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(.5\textwidth,-5mm){\makebox(0,\baselineskip)[c]{\Macro{chead}}}
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(.5\textwidth,-10mm){\makebox(0,\baselineskip)[c]{\Macro{ohead}}}
\put(\dimexpr.5\textwidth-2em,.5\baselineskip){%
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(0,0){\line(-1,0){1.5em}}%
\put(-1.5em,0){\vector(0,1){5mm}}%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(0,-1.25\baselineskip){\line(-1,0){\dimexpr .25\textwidth-2em\relax}}%
\put(-\dimexpr
.25\textwidth-2em\relax,-1.25\baselineskip){\vector(0,1){\dimexpr
5mm+1.25\baselineskip\relax}}
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(0,-2.5\baselineskip){\line(-1,0){\dimexpr .45\textwidth-4em\relax}}%
\put(-\dimexpr
.45\textwidth-4em\relax,-2.5\baselineskip){\vector(0,1){\dimexpr
5mm+2.5\baselineskip\relax}}
}%
\put(\dimexpr.5\textwidth+2em,.5\baselineskip){%
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(0,0){\line(1,0){1.5em}}%
\put(1.5em,0){\vector(0,1){5mm}}%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(0,-1.25\baselineskip){\line(1,0){\dimexpr .25\textwidth-2em\relax}}
\put(\dimexpr
.25\textwidth-2em\relax,-1.25\baselineskip){\vector(0,1){\dimexpr
5mm+1.25\baselineskip\relax}}
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(0,-2.5\baselineskip){\line(1,0){\dimexpr .45\textwidth-4em\relax}}
\put(\dimexpr
.45\textwidth-4em\relax,-2.5\baselineskip){\vector(0,1){\dimexpr
@@ -382,7 +384,7 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.%
}%
\end{picture}
\caption[Befehle zum Setzen des Seitenkopfes]%
- {Die Bedeutung der Befehle zum Setzen der Inhalte des Kopfs eines
+ {Die Bedeutung der Befehle zum Setzen der Inhalte des Kopfes eines
Seitenstils für die Seitenköpfe einer schematischen Doppelseite}
\label{fig:scrlayer-scrpage.head}
\end{figure}
@@ -411,12 +413,12 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.%
der Voreinstellung auf den Seitenstil \PageStyle{plain}. Nach der Anweisung
\DescRef{maincls.cmd.pagestyle}\PParameter{scrheadings} in der Präambel
unseres Beispiels führt dies tatsächlich zur Verwendung des Seitenstils
- \PageStyle{plain.scrheadings} für die Seite mit dem Titelkopf. Dieser
- Seitenstil ist bei Verwendung einer \KOMAScript-Klasse mit leerem Kopf und
- Seitenzahl im Fuß vorkonfiguriert. Da im Beispiel das optionale Argument von
- \Macro{lohead} und \Macro{rohead} gar nicht verwendet wird, bleibt der
- Seitenstil \PageStyle{plain.scrheadings} unverändert. Das Ergebnis ist für
- die erste Seite also tatsächlich korrekt.
+ \DescRef{\LabelBase.pagestyle.plain.scrheadings} für die Seite mit dem
+ Titelkopf. Dieser Seitenstil ist bei Verwendung einer \KOMAScript-Klasse mit
+ leerem Kopf und Seitenzahl im Fuß vorkonfiguriert. Da im Beispiel das
+ optionale Argument von \Macro{lohead} und \Macro{rohead} gar nicht verwendet
+ wird, bleibt der Seitenstil \DescRef{\LabelBase.pagestyle.plain.scrheadings}
+ unverändert. Das Ergebnis ist für die erste Seite also tatsächlich korrekt.
Fügen Sie jetzt im Beispiel nach \DescRef{maincls.cmd.maketitle} so viel
Text ein, dass eine zweite Seite ausgegeben wird. Sie können dazu auch
@@ -445,34 +447,40 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.%
\lipsum
\end{document}
\end{lstcode}
- Jetzt haben Sie den Kopf auch auf der ersten Seite direkt über dem Titelkopf
- selbst. Das kommt daher, dass Sie mit den beiden optionalen Argumenten den
- Seitenstil \PageStyle{plain.scrheadings} nun ebenfalls entsprechend
- konfiguriert haben. Wie Sie am Ergebnis vermutlich auch erkennen, ist es
- jedoch besser, diesen Seitenstil unverändert zu lassen, da der Kolumnentitel
- über dem Titelkopf doch eher störend ist.
-
- Alternativ zur Konfigurierung von \PageStyle{plain.scrheadings} hätte man
- bei Verwendung einer \KOMAScript-Klasse übrigens auch den Seitenstil für
- Seiten mit Titelkopf ändern können. Siehe dazu
- \DescRef{maincls.cmd.titlepagestyle}%
+ Jetzt haben Sie den Kopf auch auf der ersten Seite \iffree{direkt}{\unskip}
+ über dem Titelkopf\iffree{ selbst}{}. Das kommt daher, dass Sie mit den
+ beiden optionalen Argumenten \iffree{den Seitenstil}{\unskip}
+ \DescRef{\LabelBase.pagestyle.plain.scrheadings} nun ebenfalls
+ entsprechend konfiguriert haben. Wie Sie am Ergebnis vermutlich auch
+ erkennen, ist es jedoch besser, diesen Seitenstil unverändert zu lassen, da
+ der Kolumnentitel über dem Titelkopf doch eher störend ist.
+
+ Alternativ zur Konfigurierung von
+ \DescRef{\LabelBase.pagestyle.plain.scrheadings} hätte man bei Verwendung
+ einer \KOMAScript-Klasse übrigens auch den Seitenstil für Seiten mit
+ Titelkopf ändern können. Siehe dazu \DescRef{maincls.cmd.titlepagestyle}%
\important{\DescRef{maincls.cmd.titlepagestyle}}%
\IndexCmd{titlepagestyle} in \autoref{sec:maincls.pagestyle},
\DescPageRef{maincls.cmd.titlepagestyle}.
\end{Example}
-%
-\iffree{}{Der Code aus dem Beispiel funktioniert übrigens unverändert auch
- mit dem veralteten Paket
- \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}.}%
-
-Erlauben Sie mir einen wichtigen Hinweis:\textnote{Achtung!} Sie sollten
-niemals die Überschrift oder die Nummer einer Gliederungsebene mit Hilfe einer
-dieser Anweisungen als Kolumnentitel in den Kopf der Seite setzen. Aufgrund
-der Asynchronizität von Seitenaufbau und Seitenausgabe kann es sonst leicht
-geschehen, dass die falsche Nummer oder die falsche Überschrift im
-Kolumnentitel ausgegeben wird. Stattdessen ist der Mark-Mechanismus idealer
-Weise in Verbindung mit den Automatismen, die im nächsten Abschnitt erklärt
-werden, zu verwenden.%
+
+\iftrue% Umbruchoptimierung
+\leavevmode\textnote{Achtung!}%
+\else Erlauben Sie mir einen wichtigen Hinweis:\textnote{Achtung!} %
+\fi%
+Sie sollten niemals die Überschrift oder die Nummer einer
+Gliederungsebene mit Hilfe einer dieser Anweisungen als Kolumnentitel in den
+Kopf der Seite setzen. Aufgrund der Asynchronizität von Seitenaufbau und
+Seitenausgabe kann %
+\iffalse% Umbruchoptimierung
+es sonst leicht geschehen, dass die falsche Nummer oder die falsche
+Überschrift im Kolumnentitel ausgegeben wird%
+\else%
+sonst die falsche Nummer oder die falsche Überschrift im Kolumnentitel
+ausgegeben werden%
+\fi%
+. Stattdessen ist der Mark-Mechanismus, idealer Weise in Verbindung mit den
+Automatismen aus dem nächsten Abschnitt, zu verwenden.%
\EndIndexGroup
@@ -491,18 +499,21 @@ werden, zu verwenden.%
\Parameter{Inhalt scrheadings}
\end{Declaration}
Die Sternvarianten\ChangedAt{v3.14}{\Package{scrlayer-scrpage}} der zuvor
-erklärten Befehle unterscheiden sich lediglich bei Weglassen des optionalen
-Arguments \PName{Inhalt plain.scrheadings} von der Form ohne Stern. Während
-die Form ohne Stern in diesem Fall den Inhalt von
-\PageStyle{plain.scrheadings} unangetastet lässt, wird bei der Sternvariante
-dann das obligatorische Argument \PName{Inhalt scrheadings} auch für
-\PageStyle{plain.scrheadings} verwendet. Sollen also beide Argumente gleich
-sein, so kann man einfach die Sternvariante mit nur einem Argument verwenden.%
+erklärten Befehle unterscheiden sich von der Form ohne Stern lediglich bei
+Weglassen des optionalen Arguments \OParameter{Inhalt
+ plain.scrheadings}. Während die Form ohne Stern in diesem Fall den Inhalt
+von \DescRef{\LabelBase.pagestyle.plain.scrheadings} unangetastet lässt, wird
+bei der Sternvariante dann das obligatorische Argument \PName{Inhalt
+ scrheadings} auch für \DescRef{\LabelBase.pagestyle.plain.scrheadings}
+verwendet. Sollen also beide Argumente gleich sein, so kann man einfach die
+Sternvariante mit nur einem Argument verwenden.%
%
\begin{Example}
- Mit der Sternform von \DescRef{\LabelBase.cmd.lohead} und \DescRef{\LabelBase.cmd.rohead} lässt sich das
+ Mit der Sternform von \DescRef{\LabelBase.cmd.lohead} und
+ \DescRef{\LabelBase.cmd.rohead} lässt sich das
Beispiel aus der vorherigen Erklärung etwas verkürzen:
-\begin{lstcode}
+ % Umbruchoptimierung durch Abstandsänderung
+\begin{lstcode}[belowskip=-\dp\strutbox]
\documentclass{scrartcl}
\usepackage{scrlayer-scrpage}
\lohead*{Peter Musterheinzel}
@@ -515,12 +526,8 @@ sein, so kann man einfach die Sternvariante mit nur einem Argument verwenden.%
\maketitle
\lipsum
\end{document}
-\end{lstcode}
-\end{Example}
-
-Das veraltete Paket \Package{scrpage2}\important{\Package{scrpage2}} verfügt
-nicht über diese Möglichkeit.%
-%
+\end{lstcode}%
+\end{Example}%
\EndIndexGroup
@@ -538,14 +545,13 @@ nicht über diese Möglichkeit.%
\Macro{rofoot}\OParameter{Inhalt plain.scrheadings}
\Parameter{Inhalt scrheadings}
\end{Declaration}
-Was in den Fuß der Seitenstile \PageStyle{plain.scrheadings}\iffree{}{ --
- beim veralteten Paket
- \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}
- entsprechend in den Fuß von \PageStyle{scrplain} --} und
-\PageStyle{scrheadings} geschrieben wird, ist mit Hilfe dieser Befehle
-einstellbar. Dabei setzt das optionale Argument jeweils den Inhalt eines
-Elements in \PageStyle{plain.scrheadings}, während das obligatorische Argument
-jeweils einen Inhalt in \PageStyle{scrheadings} setzt.
+Was bei \DescRef{\LabelBase.pagestyle.scrheadings} und
+\DescRef{\LabelBase.pagestyle.plain.scrheadings} in den Fuß der Seite
+geschrieben wird, ist mit Hilfe dieser Befehle einstellbar. Dabei setzt das
+optionale Argument jeweils den Inhalt eines Elements in
+\DescRef{\LabelBase.pagestyle.plain.scrheadings}, während das obligatorische
+Argument jeweils einen Inhalt in \DescRef{\LabelBase.pagestyle.scrheadings}
+setzt.
Die Inhalte für gerade, also linke Seiten\textnote{linke Seite} werden mit den
Befehlen \Macro{lefoot}, \Macro{cefoot} und \Macro{refoot} gesetzt. Das
@@ -581,11 +587,12 @@ Befehlsnamens steht hier für »\emph{right aligned}« (engl. für
\BeginIndex{FontElement}{pagefoot}\LabelFontElement{pagefoot}%
\BeginIndex{FontElement}{pageheadfoot}\LabelFontElement[.foot]{pageheadfoot}%
Diese Elemente besitzen jedoch nicht jedes für sich eine Schriftzuordnung mit
-Hilfe der Befehle \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe
+Hilfe der Befehle \DescRef{\LabelBase.cmd.setkomafont} und
+\DescRef{\LabelBase.cmd.addtokomafont} (siehe
\autoref{sec:scrlayer-scrpage.textmarkup},
-\DescPageRef{\LabelBase.cmd.setkomafont}), sondern alle zusammen
-über das Element \FontElement{pagefoot}\important{\FontElement{pagefoot}}. Vor
-diesem wird außerdem noch das Element
+\DescPageRef{\LabelBase.cmd.setkomafont}), sondern alle zusammen über das
+Element \FontElement{pagefoot}\important{\FontElement{pagefoot}}. Vor diesem
+wird außerdem noch das Element
\FontElement{pageheadfoot}\important{\FontElement{pageheadfoot}}
angewandt. Die Voreinstellungen für diese beiden Elemente sind
\autoref{tab:scrlayer-scrpage.fontelements},
@@ -606,7 +613,7 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert.
\multiput(0,20mm)(0,1mm){10}{\line(0,1){.5mm}}%
\put(.49\textwidth,0){\line(0,1){15mm}}%
\put(.05\textwidth,5mm){%
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(-.5em,0){\line(1,0){4em}}%
\multiput(3.5em,0)(.25em,0){5}{\line(1,0){.125em}}%
\put(-.5em,0){\line(0,1){\baselineskip}}%
@@ -615,7 +622,7 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert.
\makebox(4em,5mm)[l]{\Macro{lefoot}}%
}%
\put(.465\textwidth,5mm){%
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(-4em,0){\line(1,0){4em}}%
\multiput(-4em,0)(-.25em,0){5}{\line(1,0){.125em}}%
\put(0,0){\line(0,1){\baselineskip}}%
@@ -624,7 +631,7 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert.
\put(-4.5em,0){\makebox(4em,5mm)[r]{\Macro{refoot}}}%
}%
\put(.2525\textwidth,5mm){%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(-2em,0){\line(1,0){4em}}%
\multiput(2em,0)(.25em,0){5}{\line(1,0){.125em}}%
\multiput(-2em,0)(-.25em,0){5}{\line(1,0){.125em}}%
@@ -639,7 +646,7 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert.
\put(\textwidth,0){\line(0,1){20mm}}%
\multiput(\textwidth,20mm)(0,1mm){10}{\line(0,1){.5mm}}%
\put(.5325\textwidth,5mm){%
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(0,0){\line(1,0){4em}}%
\multiput(4em,0)(.25em,0){5}{\line(1,0){.125em}}%
\put(0,0){\line(0,1){\baselineskip}}%
@@ -648,7 +655,7 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert.
\put(.5em,0){\makebox(4em,5mm)[l]{\Macro{lofoot}}}%
}%
\put(.965\textwidth,5mm){%
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(-4em,0){\line(1,0){4em}}%
\multiput(-4em,0)(-.25em,0){5}{\line(1,0){.125em}}%
\put(0,0){\line(0,1){\baselineskip}}%
@@ -657,7 +664,7 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert.
\put(-4.5em,0){\makebox(4em,5mm)[r]{\Macro{rofoot}}}%
}%
\put(.75\textwidth,5mm){%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(-2em,0){\line(1,0){4em}}%
\multiput(2em,0)(.25em,0){5}{\line(1,0){.125em}}%
\multiput(-2em,0)(-.25em,0){5}{\line(1,0){.125em}}%
@@ -667,31 +674,31 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert.
\put(-2em,0){\makebox(4em,5mm)[c]{\Macro{cofoot}}}%
}%
% Befehle für beide Seiten
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(.5\textwidth,15mm){\makebox(0,\baselineskip)[c]{\Macro{ifoot}}}%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(.5\textwidth,20mm){\makebox(0,\baselineskip)[c]{\Macro{cfoot}}}
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(.5\textwidth,25mm){\makebox(0,\baselineskip)[c]{\Macro{ofoot}}}
\put(\dimexpr.5\textwidth-2em,.5\baselineskip){%
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(0,15mm){\line(-1,0){1.5em}}%
\put(-1.5em,15mm){\vector(0,-1){5mm}}%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(0,20mm){\line(-1,0){\dimexpr .25\textwidth-2em\relax}}%
\put(-\dimexpr .25\textwidth-2em\relax,20mm){\vector(0,-1){10mm}}%
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(0,25mm){\line(-1,0){\dimexpr .45\textwidth-4em\relax}}%
\put(-\dimexpr .45\textwidth-4em\relax,25mm){\vector(0,-1){15mm}}%
}%
\put(\dimexpr.5\textwidth+2em,.5\baselineskip){%
- \iffree{\color{blue}}{}%
+ \color{ImageBlue}%
\put(0,15mm){\line(1,0){1.5em}}%
\put(1.5em,15mm){\vector(0,-1){5mm}}%
- \iffree{\color{green}}{}%
+ \color{ImageGreen}%
\put(0,20mm){\line(1,0){\dimexpr .25\textwidth-2em\relax}}%
\put(\dimexpr .25\textwidth-2em\relax,20mm){\vector(0,-1){10mm}}%
- \iffree{\color{red}}{}%
+ \color{ImageRed}%
\put(0,25mm){\line(1,0){\dimexpr .45\textwidth-4em\relax}}%
\put(\dimexpr .45\textwidth-4em\relax,25mm){\vector(0,-1){15mm}}%
}%
@@ -704,8 +711,8 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert.
%
\begin{Example}
Kommen wir zu dem Beispiel des kurzen Artikels zurück. Angenommen Sie wollen
- nun links im Fuß zusätzlich den Verlag angegeben haben. Daher ergänzen Sie
- das Beispiel zu
+ nun links im Fuß \iffree{zusätzlich}{\unskip} den Verlag angegeben
+ haben. Daher ergänzen Sie das Beispiel zu:
\begin{lstcode}
\documentclass{scrartcl}
\usepackage{scrlayer-scrpage}
@@ -721,46 +728,69 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert.
\lipsum
\end{document}
\end{lstcode}
- Der Verlag wird Ihnen nun aber wiederum nicht auf der Seite mit dem
+ Der Verlag wird Ihnen aber nicht auf der Seite mit dem
Titelkopf ausgegeben. Die Begründung ist dieselbe wie beim Beispiel zu
- \DescRef{\LabelBase.cmd.lohead}. Ebenso ist die Lösung, um den Verlag auch auf diese Seite
- zu bekommen, entsprechend:
+ \DescRef{\LabelBase.cmd.lohead}. Ebenso ist die Lösung, um den Verlag auch
+ auf diese Seite zu bekommen, entsprechend:
\begin{lstcode}
\lofoot[Verlag Naseblau, Irgendwo]
{Verlag Naseblau, Irgendwo}
\end{lstcode}
+ \iffalse% Umbruchvarianten
Nun entscheiden Sie noch, dass
statt\textnote{Fontänderung}\important{\FontElement{pageheadfoot}}%
\IndexFontElement{pageheadfoot} der schrägen Schrift in Kopf und Fuß eine
aufrechte, aber kleinere Schrift verwendet werden soll%
+ \else%
+ Jetzt soll
+ statt\textnote{Fontänderung}\important{\FontElement{pageheadfoot}}%
+ \IndexFontElement{pageheadfoot} der schrägen Schrift in Kopf und Fuß eine
+ aufrechte, aber kleinere Schrift verwendet werden%
+ \fi%
% Umbruchoptimierung:
+ \iffalse%
\iffree{}{. Dies erreichen
- Sie, indem Sie in der Dokumentpräambel die folgende Codezeile ergänzen}%
+ Sie, indem Sie in der Dokumentpräambel die folgende Codezeile ergänzen}%
+ \fi%
+ \iftrue%
+ \iffree{}{. Dies erreichen Sie mit folgender Ergänzung:}%
+ \fi
:
\begin{lstcode}
\setkomafont{pageheadfoot}{\small}
\end{lstcode}
- Darüber hinaus, soll der
- Kopf\important{\FontElement{pagehead}}\IndexFontElement{pagefoot}, nicht
- jedoch der Fuß fett gesetzt werden:
+ Darüber hinaus, soll
+ \iftrue% Umbruchvarianten
+ der Kopf\important{\FontElement{pagehead}}\IndexFontElement{pagehead}, nicht
+ jedoch der Fuß
+ \else%
+ nur der Kopf\important{\FontElement{pagehead}}\IndexFontElement{pagehead}
+ \fi%
+ fett gesetzt werden:
\begin{lstcode}
\setkomafont{pagehead}{\bfseries}
\end{lstcode}
- Bei dieser Anweisung ist es wichtig, dass sie erst nach dem Laden von
- \Package{scrpage-scrlayer} erfolgt, weil davor zwar bereits sowohl
- \FontElement{pagehead} als auch \FontElement{pageheadfoot} vorhanden sind,
- aber dasselbe Element, nämlich \FontElement{pageheadfoot}, bezeichnen. Erst
- durch Laden von \Package{scrpage-scrlayer} werden daraus zwei unabhängige
- Elemente.
+ Bei dieser Anweisung ist wichtig\textnote{Achtung!}, dass sie nach
+ dem Laden von \Package{scrpage-scrlayer} erfolgt, weil davor
+ \FontElement{pagehead} und \FontElement{pageheadfoot}
+ \iffalse% Umbruchvarianten
+ zwar vorhanden sind, aber dasselbe Element, nämlich
+ \FontElement{pageheadfoot}, %
+ \else%
+ dasselbe Element %
+ \fi
+ bezeichnen. Erst durch \iffree{Laden von }{}\Package{scrpage-scrlayer}
+ werden daraus \iffree{zwei }{}unabhängige Elemente.
Ergänzen Sie nun das Beispiel einmal durch ein weiteres \Macro{lipsum} und
fügen Sie gleichzeitig Option
\Option{twoside}\IndexOption{twoside}\important{\Option{twoside}} beim Laden
von \Class{scrartcl} hinzu. Zum einen wandert die Seitenzahl im Fuß nun von
der Mitte nach außen. Das liegt an der geänderten Voreinstellung für
- \PageStyle{scrheadings} und \PageStyle{plain.scrheadings} für doppelseitige
- Dokumente mit einer \KOMAScript-Klasse.
+ \DescRef{\LabelBase.pagestyle.scrheadings} und
+ \DescRef{\LabelBase.pagestyle.plain.scrheadings} für doppelseitige Dokumente
+ mit einer \KOMAScript-Klasse.
Gleichzeitig verschwinden aber auch Autor, Dokumenttitel und Verlag von
Seite~2. Diese finden sich erst auf Seite~3 wieder. Das liegt daran, dass
@@ -798,25 +828,28 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert.
\end{document}
\end{lstcode}
\end{Example}%
-\iffree{}{Der Code dieses Beispiels funktioniert ebenfalls mit dem veralteten
- Paket
- \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}. Wegen
- der Verwendung von \DescRef{\LabelBase.cmd.setkomafont} gilt das aber nur, solange eine
- \KOMAScript-Klasse wie \Class{scrartcl} verwendet wird.}%
Da es etwas umständlich ist, die Angaben bei doppelseitigen Dokumenten wie im
letzten Beispiel immer getrennt für linke und rechte Seiten zu machen, wird
nachfolgend eine schönere Lösung für diesen Standardfall eingeführt.
-Erlauben Sie mir zuvor noch einen wichtigen Hinweis:\textnote{Achtung!} Sie
-sollten niemals die Überschrift oder die Nummer einer Gliederungsebene mit
-Hilfe einer dieser Anweisungen als Kolumnentitel in den Fuß der
-Seite setzen. Aufgrund der Asynchronizität von Seitenaufbau und Seitenausgabe
-kann es sonst leicht geschehen, dass die falsche Nummer oder die falsche
-Überschrift im Kolumnentitel ausgegeben wird. Stattdessen ist der
-Mark-Mechanismus idealer Weise in Verbindung mit den Automatismen, die im
-nächsten Abschnitt erklärt werden, zu verwenden.%
-%
+\iftrue% Umbruchoptimierung
+\leavevmode\textnote{Achtung!}%
+\else Erlauben Sie mir erneut einen wichtigen Hinweis:\textnote{Achtung!} %
+\fi%
+Sie sollten niemals die Überschrift oder die Nummer einer
+Gliederungsebene mit Hilfe einer dieser Anweisungen als Kolumnentitel in den
+Fuß der Seite setzen. Aufgrund der Asynchronizität von Seitenaufbau und
+Seitenausgabe kann %
+\iffalse% Umbruchoptimierung
+es sonst leicht geschehen, dass die falsche Nummer oder die falsche
+Überschrift im Kolumnentitel ausgegeben wird%
+\else%
+sonst die falsche Nummer oder die falsche Überschrift im Kolumnentitel
+ausgegeben werden%
+\fi%
+. Stattdessen ist der Mark-Mechanismus, idealer Weise in Verbindung mit den
+Automatismen aus dem nächsten Abschnitt, zu verwenden.%
\EndIndexGroup
@@ -835,19 +868,21 @@ nächsten Abschnitt erklärt werden, zu verwenden.%
\Parameter{Inhalt scrheadings}
\end{Declaration}
Die Sternvarianten\ChangedAt{v3.14}{\Package{scrlayer-scrpage}} der zuvor
-erklärten Befehle unterscheiden sich lediglich bei Weglassen des optionalen
-Arguments \PName{Inhalt plain.scrheadings} von der Form ohne Stern. Während
-die Form ohne Stern in diesem Fall den Inhalt von
-\PageStyle{plain.scrheadings} unangetastet lässt, wird bei der Sternvariante
-dann das obligatorische Argument \PName{Inhalt scrheadings} auch für
-\PageStyle{plain.scrheadings} verwendet. Sollen also beide Argumente gleich
-sein, so kann man einfach die Sternvariante mit nur einem Argument verwenden.%
+erklärten Befehle unterscheiden sich von der Form ohne Stern lediglich bei
+Weglassen des optionalen Arguments \OParameter{Inhalt
+ plain.scrheadings}. Während die Form ohne Stern in diesem Fall den Inhalt
+von \DescRef{\LabelBase.pagestyle.plain.scrheadings} unangetastet lässt, wird
+bei der Sternvariante dann das obligatorische Argument \PName{Inhalt
+ scrheadings} auch für \DescRef{\LabelBase.pagestyle.plain.scrheadings}
+verwendet. Sollen also beide Argumente gleich sein, so kann man einfach die
+Sternvariante mit nur einem Argument verwenden.%
%
\begin{Example}
- Mit der Sternform von \DescRef{\LabelBase.cmd.lofoot} und \DescRef{\LabelBase.cmd.rofoot} lässt sich das
+ Mit der Sternform von \DescRef{\LabelBase.cmd.lofoot} und
+ \DescRef{\LabelBase.cmd.rofoot} lässt sich das
Beispiel aus der vorherigen Erklärung etwas verkürzen:
-%
-\begin{lstcode}
+% Umbruchoptimierung durch Abstandsänderung
+\begin{lstcode}[belowskip=-\dp\strutbox]
\documentclass[twoside]{scrartcl}
\usepackage{scrlayer-scrpage}
\lohead{Peter Musterheinzel}
@@ -868,9 +903,6 @@ sein, so kann man einfach die Sternvariante mit nur einem Argument verwenden.%
\end{document}
\end{lstcode}
\end{Example}%
-
-Das veraltete Paket \Package{scrpage2}\important{\Package{scrpage2}} verfügt
-nicht über diese Möglichkeit.%
%
\EndIndexGroup
@@ -893,25 +925,36 @@ Um Kopf und Fuß im doppelseitigen Layout zu konfigurieren, müsste man mit den
zuvor erklärten Befehlen die linken und die rechten Seiten getrennt
voneinander konfigurieren. Meist ist es jedoch so, dass linke und rechte Seite
mehr oder weniger symmetrisch zueinander sind. Ein Element das auf linken
-Seiten links steht, steht auf rechten Seiten rechts. Ein Element, das auf
-linken Seiten rechts steht, steht auf rechten Seiten links. Mittig angeordnete
-Elemente sind normalerweise auf beiden Seiten mittig angeordnet.
+Seiten links steht, steht auf rechten Seiten rechts%
+\iffalse% Umbruchvarianten
+. Ein Element, das auf linken Seiten rechts steht, steht auf rechten Seiten
+links.
+Mittig angeordnete Elemente sind normalerweise auf beiden Seiten mittig
+angeordnet.%
+\else%
+\ und umgekehrt. Mittig bleibt mittig.%
+\fi%
Zur Vereinfachung der Einstellungen für diesen Standardfall gibt es bei
\Package{scrlayer-scrpage} sozusagen Abkürzungen. Der Befehl \Macro{ohead}
-entspricht einem Aufruf sowohl von \DescRef{\LabelBase.cmd.lehead} als auch \DescRef{\LabelBase.cmd.rohead}. Der
-Befehl \Macro{chead} entspricht sowohl \DescRef{\LabelBase.cmd.cehead} als auch
-\DescRef{\LabelBase.cmd.cohead}. Und Befehl \Macro{ihead} entspricht \DescRef{\LabelBase.cmd.rehead} und
-\DescRef{\LabelBase.cmd.lohead}. Entsprechendes gilt für die Anweisungen des Fußes. In
-\autoref{fig:scrlayer-scrpage.head} auf
+entspricht einem Aufruf sowohl von \DescRef{\LabelBase.cmd.lehead} als auch
+\DescRef{\LabelBase.cmd.rohead}. Der Befehl \Macro{chead} entspricht sowohl
+\DescRef{\LabelBase.cmd.cehead} als auch \DescRef{\LabelBase.cmd.cohead}. Und
+Befehl \Macro{ihead} entspricht \DescRef{\LabelBase.cmd.rehead} und
+\DescRef{\LabelBase.cmd.lohead}. Gleiches gilt für die Anweisungen des
+Fußes. In \autoref{fig:scrlayer-scrpage.head} auf
\autopageref{fig:scrlayer-scrpage.head} und
\autoref{fig:scrlayer-scrpage.foot} auf
\autopageref{fig:scrlayer-scrpage.foot} werden auch diese Beziehungen
skizziert.
%
\begin{Example}
+ \iftrue% Umbruchvarianten
+ Das letzte Beispiel lässt sich so vereinfachen:
+ \else
Mit Hilfe der neuen Befehle, lässt sich das letzte Beispiel wie folgt
vereinfachen:
+ \fi
\begin{lstcode}
\documentclass[twoside]{scrartcl}
\usepackage{scrlayer-scrpage}
@@ -930,28 +973,42 @@ skizziert.
\lipsum\lipsum
\end{document}
\end{lstcode}
+\iffalse% Umbruchkorrekturtext
Wie zusehen ist, konnte die Hälfte der Befehle eingespart und trotzdem
dasselbe Ergebnis erzielt werden.
+\fi
\end{Example}%
-\iffree{}{Der Code dieses Beispiels funktioniert wiederum ohne Änderung auch
- mit dem veralteten Paket
- \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}},
- solange eine \KOMAScript-Klasse wie \Class{scrartcl} verwendet wird.}%
+\iffalse% Umbruchoptimierung
Da im einseitigen Layout alle Seiten als ungerade oder rechte Seiten behandelt
-werden, können im einseitigen Layout diese Befehle auch als Synonyme für die
-entsprechenden Befehle für rechte Seiten verwendet werden. In den meisten
-Fällen wird man daher eher diese sechs als die zwölf zuvor vorgestellten
-Befehle verwenden.
+werden, können \iffree{im einseitigen Layout}{dann} diese Befehle auch als
+Synonyme für die entsprechenden Befehle für rechte Seiten verwendet werden.%
+\else%
+Im einseitigen Layout können diese Befehle auch als Synonym für die
+entsprechenden Befehle für rechte Seiten verwendet werden, da dann alle Seiten
+rechte Seiten sind.%
+\fi%
+\iffalse% Umbruchoptimierung
+In den meisten Fällen wird man daher eher diese sechs als die zwölf zuvor
+vorgestellten Befehle verwenden.
+\fi
-Erlauben Sie mir noch einmal einen wichtigen Hinweis:\textnote{Achtung!} Sie
-sollten niemals die Überschrift oder die Nummer einer Gliederungsebene mit
+% Umbruchoptimierung
+\iffree{Erlauben Sie mir noch einmal einen wichtigen
+ Hinweis:\textnote{Achtung!} }{\leavevmode\textnote{Achtung!}}%
+Sie sollten niemals die Überschrift oder die Nummer einer Gliederungsebene mit
Hilfe einer dieser Anweisungen als Kolumnentitel in den Kopf oder Fuß der
Seite setzen. Aufgrund der Asynchronizität von Seitenaufbau und Seitenausgabe
-kann es sonst leicht geschehen, dass die falsche Nummer oder die falsche
-Überschrift im Kolumnentitel ausgegeben wird. Stattdessen ist der
-Mark-Mechanismus idealer Weise in Verbindung mit den Automatismen, die im
-nächsten Abschnitt erklärt werden, zu verwenden.%
+kann %
+\iffalse% Umbruchoptimierung
+es sonst leicht geschehen, dass die falsche Nummer oder die falsche
+Überschrift im Kolumnentitel ausgegeben wird%
+\else%
+sonst die falsche Nummer oder die falsche Überschrift im Kolumnentitel
+ausgegeben werden%
+\fi%
+. Stattdessen ist der Mark-Mechanismus, idealer Weise in Verbindung mit den
+Automatismen aus dem nächsten Abschnitt, zu verwenden.%
\EndIndexGroup
@@ -970,13 +1027,14 @@ nächsten Abschnitt erklärt werden, zu verwenden.%
\Parameter{Inhalt scrheadings}
\end{Declaration}
Die Sternvarianten\ChangedAt{v3.14}{\Package{scrlayer-scrpage}} der zuvor
-erklärten Befehle unterscheiden sich lediglich bei Weglassen des optionalen
-Arguments \PName{Inhalt plain.scrheadings} von der Form ohne Stern. Während
-die Form ohne Stern in diesem Fall den Inhalt von
-\PageStyle{plain.scrheadings} unangetastet lässt, wird bei der Sternvariante
-dann das obligatorische Argument \PName{Inhalt scrheadings} auch für
-\PageStyle{plain.scrheadings} verwendet. Sollen also beide Argumente gleich
-sein, so kann man einfach die Sternvariante mit nur einem Argument verwenden.%
+erklärten Befehle unterscheiden sich von der Form ohne Stern lediglich bei
+Weglassen des optionalen Arguments \OParameter{Inhalt
+ plain.scrheadings}. Während die Form ohne Stern in diesem Fall den Inhalt
+von \DescRef{\LabelBase.pagestyle.plain.scrheadings} unangetastet lässt, wird
+bei der Sternvariante dann das obligatorische Argument \PName{Inhalt
+ scrheadings} auch für \DescRef{\LabelBase.pagestyle.plain.scrheadings}
+verwendet. Sollen also beide Argumente gleich sein, so kann man einfach die
+Sternvariante mit nur einem Argument verwenden.%
%
\begin{Example}
Mit der Sternform von \DescRef{\LabelBase.cmd.ifoot} lässt sich das
@@ -997,12 +1055,8 @@ sein, so kann man einfach die Sternvariante mit nur einem Argument verwenden.%
\maketitle
\lipsum\lipsum
\end{document}
-\end{lstcode}
-\end{Example}
-
-Das veraltete Paket \Package{scrpage2}\important{\Package{scrpage2}} verfügt
-nicht über diese Möglichkeit.%
-%
+\end{lstcode}%
+\end{Example}%
\EndIndexGroup
@@ -1013,76 +1067,77 @@ nicht über diese Möglichkeit.%
\BeginIndex{Option}{pagestyleset~=standard}%
In den zurückliegenden Beispielen wurde bereits mehrfach auf die
Voreinstellung der Seitenstile
-\PageStyle{scrheadings}\IndexPagestyle{scrheadings} und
-\PageStyle{plain.scrheadings}\IndexPagestyle{plain.scrheadings}
-hingewiesen. Tatsächlich unterstützt \Package{scrlayer-scrpage} derzeit zwei
-unterschiedliche Voreinstellungen. Diese sind von Hand über Option
-\Option{pagestyleset} auswählbar.
-
-Mit der \PName{Einstellung} \PValue{KOMA-Script}%
-\important{\KOption{pagestyleset}\quad\\\quad\PValue{KOMA-Script}} wird die
-Voreinstellung gewählt, die auch automatisch eingestellt wird, falls die
+\DescRef{\LabelBase.pagestyle.scrheadings}\IndexPagestyle{scrheadings} und
+\DescRef{\LabelBase.pagestyle.plain.scrheadings}%
+\IndexPagestyle{plain.scrheadings} hingewiesen. Tatsächlich unterstützt
+\Package{scrlayer-scrpage} derzeit zwei unterschiedliche
+Voreinstellungen. Diese sind von Hand über Option \Option{pagestyleset}
+auswählbar.
+
+Mit der \PName{Einstellung}
+\PValue{KOMA-Script}\important{\OptionValue{pagestyleset}{KOMA-Script}} wird
+die Voreinstellung gewählt, die auch automatisch eingestellt wird, falls die
Option nicht angegeben ist und eine \KOMAScript-Klasse erkannt wurde. Dabei
-werden für \PageStyle{scrheadings} im doppelseitigen Satz Kolumnentitel außen
-im Kopf und Seitenzahlen außen im Fuß gesetzt. Im einseitigen Satz wird der
-Kolumnentitel stattdessen mittig im Kopf und die Seitenzahl mittig im Fuß
-platziert. Für die automatischen Kolumnentitel werden Groß- und
-Kleinbuchstaben verwendet, wie diese vorgefunden werden. Dies entspricht der
-gleichzeitigen Verwendung von Option
+werden für \DescRef{\LabelBase.pagestyle.scrheadings} im doppelseitigen Satz
+Kolumnentitel außen im Kopf und Seitenzahlen außen im Fuß gesetzt. Im
+einseitigen Satz wird der Kolumnentitel stattdessen mittig im Kopf und die
+Seitenzahl mittig im Fuß platziert. Für die automatischen Kolumnentitel werden
+Groß- und Kleinbuchstaben wie vorgefunden verwendet. Dies entspricht Option
\OptionValueRef{\LabelBase}{markcase}{used}\IndexOption{markcase~=used}%
\important{\OptionValueRef{\LabelBase}{markcase}{used}}. Für
-\PageStyle{plain.scrheadings} entfallen die Kolumnentitel. Die Seitenzahlen
-werden jedoch identisch platziert.
+\DescRef{\LabelBase.pagestyle.plain.scrheadings} entfallen die
+Kolumnentitel. Die Seitenzahlen werden jedoch identisch platziert.
-Wird allerdings
-\Class{scrlttr2}\important{\Class{scrlttr2}}\IndexClass{scrlttr2} als Klasse
-erkannt, so werden die Voreinstellungen an die Seitenstile jener Klasse
-angelehnt. Siehe dazu \autoref{sec:scrlttr2.pagestyle}, ab
-\autopageref{sec:scrlttr2.pagestyle}.
+Wird allerdings \hyperref[cha:scrlttr2]{\Class{scrlttr2}}%
+\important{\hyperref[cha:scrlttr2]{\Class{scrlttr2}}}%
+\IndexClass{scrlttr2} als Klasse erkannt, so werden die Voreinstellungen an
+die Seitenstile jener Klasse angelehnt. Siehe dazu
+\autoref{sec:scrlttr2.pagestyle}, ab \autopageref{sec:scrlttr2.pagestyle}.
-Mit der \PName{Einstellung} \PValue{standard}%
-\important{\KOption{pagestyleset}\quad\\\quad\PValue{standard}} wird die
+Mit der \PName{Einstellung}
+\PValue{standard}\important{\OptionValue{pagestyleset}{standard}} wird die
Voreinstellung gewählt, die den Standard-Klassen entspricht. Diese wird auch
automatisch eingestellt, falls die Option nicht angegeben ist und keine
-\KOMAScript-Klasse erkannt wurde. Dabei wird für \PageStyle{scrheadings} im
-doppelseitigen Satz der Kolumnentitel im Kopf innen und die Seitenzahl --
-ebenfalls im Kopf -- außen ausgerichtet platziert. Im einseitigen Satz werden
-dieselben Einstellungen verwendet. Da hierbei nur rechte Seiten existieren,
-steht der Kolumnentitel dann immer linksbündig im Kopf, die Seitenzahl
-entsprechend rechtsbündig. Die automatischen Kolumnentitel werden -- trotz
-erheblicher typografischer Bedenken -- entsprechend
+\KOMAScript-Klasse erkannt wurde. Dabei wird für
+\DescRef{\LabelBase.pagestyle.scrheadings} im doppelseitigen Satz der
+Kolumnentitel im Kopf innen und die Seitenzahl -- ebenfalls im Kopf -- außen
+ausgerichtet platziert. Im einseitigen Satz werden dieselben Einstellungen
+verwendet. Da hierbei nur rechte Seiten existieren, steht der Kolumnentitel
+dann immer linksbündig im Kopf, die Seitenzahl entsprechend rechtsbündig. Die
+automatischen Kolumnentitel werden -- trotz erheblicher typografischer
+Bedenken -- entsprechend
\OptionValueRef{\LabelBase}{markcase}{upper}\IndexOption{markcase~=upper}%
\important{\OptionValueRef{\LabelBase}{markcase}{upper}} in Großbuchstaben
-umgewandelt. Von \PageStyle{scrheadings} deutlich abweichend hat
-\PageStyle{plain.scrheadings} die Seitenzahl im einseitigen Satz mittig im
-Fuß. Abweichend vom Seitenstil \PageStyle{plain} der Standardklassen entfällt
-die Seitenzahl im doppelseitigen Modus. Die Standardklassen setzen die
-Seitenzahl stattdessen mittig im Fuß, was im doppelseitigen Satz nicht zum
-übrigen Stil der Seiten passt. Der Kolumnentitel entfällt bei
-\PageStyle{plain.scrheadings} natürlich in jedem Fall.
+umgewandelt. Von \DescRef{\LabelBase.pagestyle.scrheadings} deutlich
+abweichend hat \DescRef{\LabelBase.pagestyle.plain.scrheadings} die Seitenzahl
+im einseitigen Satz mittig im Fuß. Im Unterschied\textnote{\KOMAScript{}
+ vs. Standardklassen} zum Seitenstil \PageStyle{plain} der Standardklassen
+entfällt die Seitenzahl im doppelseitigen Modus. Die Standardklassen setzen
+die Seitenzahl stattdessen mittig im Fuß, was im doppelseitigen Satz nicht zum
+übrigen Stil der Seiten passt.
+\iffalse % Umbruchkorrekturtext
+Wer die Seitenzahl zurück haben will, kann dies
+mit
+\begin{lstcode}
+ \cfoot[\pagemark]{}
+\end{lstcode}
+erreichen. %
+\fi%
+Der Kolumnentitel entfällt bei
+\DescRef{\LabelBase.pagestyle.plain.scrheadings}.
Es ist zu beachten\textnote{Achtung!}, dass mit der Verwendung dieser Option
gleichzeitig der Seitenstil
-\PageStyle{scrheadings}\IndexPagestyle{scrheadings}%
-\important{\PageStyle{scrheadings}} aktiviert wird. Dies gilt auch, wenn die
-Option innerhalb eines Dokuments verwendet wird.
-
-\BeginIndex{Option}{komastyle}%
-\BeginIndex{Option}{standardstyle}%
-Die für \Package{scrpage2}\IndexPackage{scrpage2} dokumentierten Paketoptionen
-\Option{komastyle}\important{\Option{komastyle}\\ \Option{standardstyle}} und
-\Option{standardstyle} existieren in \Package{scrlayer-scrpage} nur aus
-Gründen der Kompatibilität. Sie werden jedoch auf Option \Option{pagestyleset}
-abgebildet, gelten als überholt und sollten nicht mehr verwendet
-werden.\iffree{}{ Bei Verwendung des veralteten Pakets
- \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}} sind
- sie hingegen die einzige Möglichkeit zwischen den beiden unterschiedlichen
- Voreinstellungen umzuschalten, da dort Option \Option{pagestyleset} nicht
- existiert.}%
+\DescRef{\LabelBase.pagestyle.scrheadings}\IndexPagestyle{scrheadings}%
+\important{\DescRef{\LabelBase.pagestyle.scrheadings}} aktiviert wird.
+\iffalse% Umbruchkorrektur
+Dies gilt auch, wenn die Option innerhalb eines Dokuments verwendet wird.%
+\fi
+%
\EndIndexGroup
-\LoadCommonFile{pagestylemanipulation}% \section{Beeinflussung von definierten Seitenstilen}
+\LoadCommonFile{pagestylemanipulation}% \section{Beeinflussung von Seitenstilen}
\begin{Declaration}
@@ -1125,49 +1180,50 @@ zuzüglich der Marginalienspalte, so ist die Voreinstellung von \PName{Offset}
immer Null. Falls Ihnen das zu kompliziert ist, sollten Sie den gewünschten
\PName{Offset} einfach selbst angeben.%
%
-\begin{table}[t!]% Umbruchoptimierung
+\begin{table}
\centering
\caption[Symbolische Werte für Option \Option{headwidth} und
\Option{footwidth}]{Erlaubte symbolische Werte für \PName{Breite} bei den
Optionen \Option{headwidth} und \Option{footwidth}}
\label{tab:scrlayer-scrpage.symbolic.values}
\begin{desctabular}
- \ventry{foot}{%
+ \entry{\PValue{foot}}{%
die aktuelle Breite des Fußes%
}%
- \ventry{footbotline}{%
+ \entry{\PValue{footbotline}}{%
die aktuelle Länge der horizontalen Linie unterhalb des Fußes%
}%
- \ventry{footsepline}{ die aktuelle Länge der horizontalen Linie zwischen
- dem Textbereich und dem Fuß%
- } \ventry{head}{%
+ \entry{\PValue{footsepline}}{%
+ die aktuelle Länge der horizontalen Linie zwischen dem Textbereich und
+ dem Fuß%
+ } \entry{\PValue{head}}{%
die aktuelle Breite des Kopfes%
}%
- \ventry{headsepline}{%
+ \entry{\PValue{headsepline}}{%
die aktuelle Länge der horizontalen Linie zwischen dem Kopf und dem
Textbereich%
}%
- \ventry{headtopline}{%
+ \entry{\PValue{headtopline}}{%
die aktuelle Länge der horizontalen Linie über dem Kopf%
}%
- \ventry{marginpar}{%
+ \entry{\PValue{marginpar}}{%
die Breite der Marginalienspalte einschließlich des Abstandes zwischen
dem Textbereich und der Marginalienspalte%
}%
- \ventry{page}{%
+ \entry{\PValue{page}}{%
die Breite der Seite unter Berücksichtigung einer eventuell mit Hilfe
des Pakets \Package{typearea} definierten Bindekorrektur (siehe Option
\DescRef{typearea.option.BCOR} in \autoref{sec:typearea.typearea},
\DescPageRef{typearea.option.BCOR})%
}%
- \ventry{paper}{%
+ \entry{\PValue{paper}}{%
die Breite des Papiers ohne Berücksichtigung einer etwaigen
Bindekorrektur%
}%
- \ventry{text}{%
+ \entry{\PValue{text}}{%
die Breite des Textbereichs%
}%
- \ventry{textwithmarginpar}{%
+ \entry{\PValue{textwithmarginpar}}{%
die Breite des Textbereichs einschließlich der Marginalienspalte und
natürlich des Abstandes zwischen den beiden (Achtung: Nur in diesem Fall
ist die Voreinstellung für \PName{Offset} Null)%
@@ -1218,13 +1274,14 @@ Abschnitt erklärt werden.
Neben der Dicke und der Länge kann man auch die Farben der Linien
ändern. Zunächst richtet sich diese natürlich nach der Farbe, die für den Kopf
und den Fuß eingestellt ist. Davon unabhängig werden aber auch noch die
-Einstellungen für die gleich benannten Elemente
-\FontElement{headtopline}\important[i]{\FontElement{headtopline}\\
+Einstellungen für die gleich benannten
+\important[i]{\FontElement{headtopline}\\
\FontElement{headsepline}\\
\FontElement{footsepline}\\
- \FontElement{footbotline}}, \FontElement{headsepline},
-\FontElement{footsepline} und \FontElement{footbotline} angewendet. Diese
-können mit den Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und
+ \FontElement{footbotline}}Elemente \FontElement{headtopline},
+\FontElement{headsepline}, \FontElement{footsepline} und
+\FontElement{footbotline} angewendet. Diese können mit den Anweisungen
+\DescRef{\LabelBase.cmd.setkomafont} und
\DescRef{\LabelBase.cmd.addtokomafont} geändert werden (siehe
\autoref{sec:scrlayer-scrpage.textmarkup}, ab
\DescPageRef{\LabelBase.cmd.setkomafont}). In der Voreinstellung sind die
@@ -1233,41 +1290,6 @@ Schrift oder Farbe führen. Änderungen der Schrift sind im Gegensatz zu
Farbänderungen an dieser Stelle ohnehin nicht sinnvoll und werden daher nicht
empfohlen.%
\EndIndexGroup
-
-\BeginIndexGroup
-\BeginIndex{Cmd}{setheadtopline}%
-\BeginIndex{Cmd}{setheadsepline}%
-\BeginIndex{Cmd}{setfootsepline}%
-\BeginIndex{Cmd}{setfootbotline}%
-\iffree{Neben den Optionen }{Das veraltete Paket
- \Package{scrpage2}\important{\Package{scrpage2}}\IndexPackage{scrpage2}
- kannte gleich benannte Paketoptionen, denen jedoch kein Wert zugewiesen
- werden konnte. Man aktivierte Haarlinien in der Breite des Kopfes respektive
- Fußes. Daneben }%
-gab es bei \Package{scrpage2} auch noch die nahezu
-gleichbedeutenden Befehle
-\Macro{setheadtopline}\IndexCmd[indexmain]{setheadtopline}%
-\important[i]{\Macro{setheadtopline}\\
- \Macro{setheadsepline}\\
- \Macro{setfootsepline}\\
- \Macro{setfootbotline}},
-\Macro{setheadsepline}\IndexCmd[indexmain]{setheadsepline},
-\Macro{setfootsepline}\IndexCmd[indexmain]{setfootsepline} und
-\Macro{setfootbotline}\IndexCmd[indexmain]{setfootbotline}. Diese Befehle
-hatten als erstes, optionales Argument ebenfalls die \PName{Länge} der
-entsprechende Linie, als zweites, obligatorisches Argument die \PName{Dicke}
-und als zusätzliches drittes, optionales Argument Einstellungen, die direkt
-für die Schrift oder Farbe des entsprechenden Elements verwendet wurden. Diese
-Anweisungen existieren in \Package{scrlayer-scrpage} aus
-Kompatibilitätsgründen ebenfalls, wobei die ersten beiden Argumente
-entsprechend der Werte für die Optionen erweitert wurden. Allerdings sind die
-Befehle gleichzeitig als überholt anzusehen und sollten nicht mehr verwendet
-werden. Es sei an dieser Stelle auch darauf hingewiesen, dass diese Befehle
-nie dazu gedacht waren, die entsprechenden Linien einzuschalten. Vielmehr
-waren sie ausschließlich zur Einstellung von \PName{Länge} und \PName{Dicke}
-der Linien gedacht, wenn diese über die Optionen eingeschaltet wurden. Dies
-wurde von den Anwendern aber leider häufig nicht beachtet!%
-\EndIndexGroup
%
\EndIndexGroup
@@ -1319,3 +1341,4 @@ möglich.%
% LocalWords: Paketoptionen Ebenenmodell Sternvariante Sternform Längenwert
+% LocalWords: Titelkopf Automatismen Bindekorrektur
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex
index b37b80c26fa..9d5b7e6ab8e 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlayer.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ============================================================================
\KOMAProvidesFile{scrlayer.tex}%
- [$Date: 2017-08-08 11:47:52 +0200 (Tue, 08 Aug 2017) $
+ [$Date: 2018-02-01 12:55:46 +0100 (Thu, 01 Feb 2018) $
KOMA-Script guide (chapter:scrlayer)]
\chapter[{Definition von Ebenen und Seitenstilen mit \Package{scrlayer}}]
@@ -86,22 +86,9 @@ Anwender werden als zusätzliche Pakete angeboten, die dann ihrerseits
\autoref{part:forAuthors} diese\iffree{r Anleitung}{s Buches}.
-\section{Hinweis zum Entwicklungsstand}
-\seclabel{draft}
-
-Die Entwicklung dieses Pakets ist noch nicht abgeschlossen. Teile des Pakets
-sind auch noch als experimentell einzustufen. Daher können sich in Zukunft
-insbesondere die internen Funktionalitäten und Funktionsweisen noch ändern. Es
-ist auch noch mit Erweiterungen zu rechnen. Wegen dieses noch nicht
-abgeschlossenen Entwicklungsstandes sollte der Leser auch keine abgeschlossene
-Anleitung erwarten. Dennoch gibt diese Anleitung, die sich vor allem an
-erfahrene Anwender und Entwickler richtet, den aktuellen Entwicklungsstand der
-Teile von \Package{scrlayer} wieder, die als zur Verwendung freigegeben
-eingestuft sind. Dinge, die hier nicht dokumentiert sind, sollten allenfalls
-zu Testzwecken Verwendung finden.
-
\LoadCommonFile{options} % \section{Frühe oder späte Optionenwahl}
+
\section{Einige grundlegende Informationen}
\seclabel{generic.information}
@@ -181,13 +168,13 @@ Klassenautors angewiesen.%
\begin{Declaration}
- \Macro{DeclareSectionNumberDepth}\Parameter{Name der Gliederungsebene}
- \Parameter{Tiefe der Gliederungsebene}
+ \Macro{DeclareSectionNumberDepth}\Parameter{Name~der~Gliederungsebene}
+ \Parameter{Tiefe~der~Gliederungsebene}
\end{Declaration}
Jeder Gliederungsebene ist normalerweise eine nummerische Tiefe
zugeordnet. Das ist notwendig, damit \LaTeX{} die Hierarchie der
-Gliederungsebenen verwalten kann. Allerdings sind die Werte normalerweise nur
-der jeweiligen Klasse bekannt, in der die Gliederungsbefehle definiert
+Gliederungsebenen verwalten kann. Allerdings sind die Werte
+nur der jeweiligen Klasse bekannt, in der die Gliederungsbefehle definiert
sind. Diese setzt dann in den entsprechenden \LaTeX-Befehlen selbst die
zugehörigen Nummern ein.
@@ -201,7 +188,7 @@ Tiefe bekannt gemacht werden. Für die Standardklassen wäre \PName{Name der
\PValue{paragraph} oder \PValue{subparagraph} und die jeweils zugehörige
\PName{Tiefe der Gliederungsebene} wäre -1, 0, 1, 2, 3, 4 oder 5.\par}
-Das Paket \Package{scrlayer} versucht diese nummerischen Werte zunächst beim
+Das Paket \Package{scrlayer} versucht, diese nummerischen Werte zunächst beim
Laden des Pakets und noch einmal während \Macro{begin}\PParameter{document}
selbst zu ermitteln. Aber für den Fall, dass dies einmal nicht zu einem
korrekten Ergebnis führt, beispielsweise falls es vollkommen andere
@@ -228,9 +215,14 @@ zwischen den beiden Ebenenstapeln.
Eine Ebene hat mehrere Eigenschaften, die als Antworten auf grundlegende
Fragen verstanden werden können:
-\begin{description}
-\item[Gehört die Ebene zum Vordergrund oder zum Hintergrund?\textnote{Vorder-
- oder Hintergrund}]%
+\iffree{\begin{description}}{%
+ \begingroup
+ \RedeclareSectionCommand[beforeskip=.5\baselineskip plus .25\baselineskip
+ minus .1\baselineskip]{paragraph}%
+ \renewcommand*\item[4][]{\paragraph*{#3{#4}#1}}%
+}%
+\item[Gehört die Ebene zum Vordergrund oder zum Hintergrund?]%
+ \leavevmode\textnote{Vorder- oder Hintergrund}\hskip 0pt
Hintergrundebenen werden ausgegeben, bevor der normale Inhalt der Seite
gedruckt wird. Optisch erscheinen sie daher \emph{hinter} oder \emph{unter}
dem normalen Inhalt der Seite. Vordergrundebenen werden an den normalen
@@ -240,23 +232,26 @@ Fragen verstanden werden können:
Vordergrundebene und wird daher zweimal ausgegeben. Normalerweise ist es
daher sinnvoll, dies explizit einzuschränken.
\item[An welcher Position soll die Ebene ausgegeben
- werden?\textnote{horizontale und vertikale Position}]%
+ werden?]%
+ \leavevmode\textnote{horizontale und vertikale Position}\hskip 0pt
Zur Beantwortung dieser Frage dienen Eigenschaften zur Festlegung der
horizontalen und der vertikalen Position.
-\item[Wie groß ist die Ebene?\textnote{horizontale und vertikale Größe}]%
+\item[Wie groß ist die Ebene?]%
+ \leavevmode\textnote{horizontale und vertikale Größe}\hskip 0pt
Ebenso wie für die Position gibt es auch für die horizontale und vertikale
Ausdehnung der Ebene Eigenschaften. Damit kann eine Ebene auch kleiner oder
größer als das Papier sein und an unterschiedlichen Positionen auf dem
Papier liegen.
\item[Wie werden die horizontale und die vertikale Position
- gemessen?\textnote{Ausrichtung}]%
+ gemessen?]%
+ \leavevmode\textnote{Ausrichtung}\hskip 0pt
Die Antwort auf diese Frage ist die Eigenschaft der Ausrichtung. Man kann
von der linken Papierkante zur linken Kante der Ebene, zur Mitte der Ebene
oder zur rechten Kante der Ebene messen. Entsprechend kann man von der
oberen Kante des Papiers zur oberen Kante der Ebene, zur Mitte der Ebene
oder zur unteren Kante der Ebene messen.
-\item[Ist die Ebene für Textausgabe oder für Grafik vorgesehen?\textnote{Text
- oder Grafik}]%
+\item[Ist die Ebene für Textausgabe oder für Grafik vorgesehen?]%
+ \leavevmode\textnote{Text oder Grafik}\hskip 0pt
Auch diese Frage ist eng mit der Position verknüpft. Während der Anwender
bei der Grafikausgabe beispielsweise davon ausgeht, dass der Ursprung in der
linken unteren Ecke der Ebene liegt, wäre dies bei der Textausgabe eher
@@ -266,23 +261,26 @@ Fragen verstanden werden können:
\Environment{picture}-Umgebung\IndexEnv{picture} auf, in der zusätzliche
Befehle zur Positionierung zur Verfügung stehen.
\item[Soll die Ebene auf linken oder rechten Seiten eines Dokuments gedruckt
- werden?\textnote{linke oder rechte Seite}]%
+ werden?]%
+ \leavevmode\textnote{linke oder rechte Seite}\hskip 0pt
In der Voreinstellung wird eine Ebene auf allen Seiten gedruckt. Es ist zu
beachten, dass \LaTeX{} Seiten mit geraden Seitenzahlen als linke Seiten und
Seiten mit ungeraden Seitenzahlen als rechte Seiten behandelt, dass es
jedoch im einseitigen Modus unabhängig von der Nummer nur rechte Seiten
- gibt. \LaTeX{} bezeichnet den Gepflogenheiten in der englischen Sprache
- entsprechend linke Seiten auch als gerade Seiten und rechte Seiten als
+ gibt. \LaTeX{} bezeichnet, den Gepflogenheiten in der englischen Sprache
+ entsprechend, linke Seiten auch als gerade Seiten und rechte Seiten als
ungerade Seiten.
\item[Soll die Ebene in einseitigen oder in doppelseitigen Dokumenten
- verwendet werden?\textnote{einseitig oder doppelseitig}]%
+ verwendet werden?]%
+ \leavevmode\textnote{einseitig oder doppelseitig}\hskip 0pt
In der Voreinstellung ist die Ebene diesbezüglich unbeschränkt, wird also
sowohl im einseitigen als auch im doppelseitigen Modus
ausgegeben. Nichtsdestotrotz wird eine Ebene, die auf gerade Seiten
beschränkt ist, im einseitigen Modus niemals ausgegeben werden und ist daher
auch keine einseitige Ebene.
\item[Soll die Ebene auf Gleitseiten oder auf Normalseiten ausgegeben
- werden?\textnote{Gleitseiten oder Normalseiten}]%
+ werden?]%
+ \leavevmode\textnote{Gleitseiten oder Normalseiten}\hskip 0pt
\LaTeX{} erzeugt Gleitseiten für Objekte aus Umgebungen wie
\Environment{table} oder \Environment{figure}, wenn diesen erlaubt wurde,
auf eigenen Seiten ohne Teile des normalen Dokumentinhalts ausgegeben zu
@@ -294,13 +292,17 @@ Fragen verstanden werden können:
Gleitumgebungen können auch den Eindruck einer Gleitseite erzeugen, obwohl
es sich bei ihnen in Wirklichkeit um oben auf einer Normalseite platzierte
Gleitumgebungen handelt.
-\item[Welchen Inhalt hat die Ebene?\textnote{Inhalt}]%
+\item[Welchen Inhalt hat die Ebene?]
+ \leavevmode\textnote{Inhalt}\hskip 0pt
Die zugehörige Eigenschaft gibt schlicht an, was gedruckt werden soll, wann
immer die Ebene ausgegeben wird.
-\end{description}
+\iffree{\end{description}}{%
+ \endgroup\par\bigskip\noindent\ignorespaces
+}%
Damit haben wir derzeit acht Fragen an die Ebenen, aus denen sich unmittelbar
-eine Reihe von Eigenschaften ergeben. Später in dieser Anleitung werden wir
-weitere Eigenschaften kennen lernen, die jedoch auf diese primären
+eine Reihe von Eigenschaften ergeben. Später
+\iffree{in dieser Anleitung }{}% Umbruchkorrektur
+werden wir weitere Eigenschaften kennenlernen, die jedoch auf diese primären
Eigenschaften abgebildet werden können.
\begin{Declaration}
@@ -313,19 +315,18 @@ Eigenschaften abgebildet werden können.
Diese Anweisungen können verwendet werden, um Ebenen zu definieren. Der
\PName{Name der Ebene} muss voll expandierbar sein. Die Expansion sollte in
ASCII-Buchstaben resultieren. Einige zusätzliche Zeichen werden ebenfalls
-akzeptiert, ihre Verwendung wird jedoch nicht empfohlen.
-
-Dabei spielt es bei Verwendung von
-\Macro{DeclareLayer}\important{\Macro{DeclareLayer}} keine Rolle, ob eine
-Ebene \PName{Name der Ebene} bereits existiert oder nicht. Sie wird in jedem
-Fall mit den über die \PName{Optionenliste} angegebenen Eigenschaften
-definiert. Einzelne Optionen bestehen entweder nur aus einem Schlüssel oder
-aus einem Schlüssel, gefolgt von einem Gleichheitszeichen und einem Wert. Die
-Optionen sind durch Komma voneinander getrennt. Um innerhalb der Werte einer
-Option ein Komma oder ein Leerzeichen verwenden zu können, muss der
-entsprechende Wert in geschweifte Klammern gesetzt werden. Eine Übersicht
-über die Optionen und die Eigenschaften, die sie repräsentieren, findet sich
-in \autoref{tab:scrlayer.layerkeys}.
+akzeptiert, ihre Verwendung wird jedoch nur erfahrenden Anwendern empfohlen.
+
+Bei Verwendung von \Macro{DeclareLayer}\important{\Macro{DeclareLayer}} spielt
+es keine Rolle, ob eine Ebene \PName{Name der Ebene} bereits existiert oder
+nicht. Sie wird in jedem Fall mit den über die \PName{Optionenliste}
+angegebenen Eigenschaften definiert. Einzelne Optionen bestehen entweder nur
+aus einem Schlüssel oder aus einem Schlüssel, gefolgt von einem
+Gleichheitszeichen und einem Wert. Die Optionen sind durch Komma voneinander
+getrennt. Um innerhalb der Werte einer Option ein Komma oder ein Leerzeichen
+verwenden zu können, muss der entsprechende Wert in geschweifte Klammern
+gesetzt werden. Eine Übersicht über die Optionen und die Eigenschaften, die
+sie repräsentieren, findet sich in \autoref{tab:scrlayer.layerkeys}.
Im Unterschied zu \Macro{DeclareLayer} meldet
\Macro{DeclareNewLayer}\important{\Macro{DeclareNewLayer}} einen Fehler, falls
@@ -400,7 +401,7 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar.
\Option{hoffset} oder \Option{voffset}. Mehrere
\PName{Ausrichtungszeichen} können ohne Leerzeichen oder Komma direkt
hintereinander geschrieben werden und werden in der Reihenfolge ihres
- Auftretens ausgewertet. Makros sind im Wert der Option jedoch
+ Auf"|tretens ausgewertet. Makros sind im Wert der Option jedoch
nicht zulässig. Zulässige \PName{Ausrichtungszeichen} sind:
\begin{description}
\item[\PValue{b} --] der Wert der Option \Option{voffset} ist der Abstand
@@ -421,7 +422,7 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar.
Die zusammengesetzte Eigenschaft resultiert in den primären Eigenschaften
\OptionVName{hoffset}{horizontaler Abstand},
\OptionVName{voffset}{vertikaler Abstand},
- \OptionVName{width}\PName{Breite}, \KOption{height}{Höhe}.%
+ \OptionVName{width}{Breite}, \KOption{height}{Höhe}.%
}%
\entry{\ChangedAt{v3.18}{\Package{scrlayer}}%
\Option{backandforeground}}{%
@@ -448,11 +449,10 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar.
\entry{\OptionVName{clone}{Name einer Ebene}}{%
Die zusammengesetzte Eigenschaft setzt alle primären Eigenschaften
entsprechend der aktuellen, primären Eigenschaften der Ebene mit dem
- angegebenen \PName{Name einer Ebene}. Es ist zu beachten, dass \PName{Name
- einer Ebene} voll expandierbar sein muss und zu Buchstaben expandieren
- sollte. Einige weitere Zeichen werden toleriert, ihre Verwendung wird
- jedoch nicht empfohlen! Die Ebene mit dem angegebenen \PName{Name einer
- Ebene} muss außerdem bereits existieren.%
+ angegebenen \PName{Name einer Ebene}. Bezüglich \PName{Name
+ einer Ebene} siehe die Hinweise zu \PName{Name der Ebene} am Anfang der
+ Erklärung zu \Macro{DeclareLayer}. Darüber hinaus muss die zu klonende
+ Ebene bereits definiert sein.%
}%
\entry{\OptionVName{contents}{Code}}{%
Der angegebene \PName{Code} wird immer dann expandiert und ausgeführt,
@@ -566,7 +566,7 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar.
}%
\entry{\ChangedAt{v3.19}{\Package{scrlayer}}%
\OptionVName{mode}{Modus}}{%
- Diese primäre Eigenschaft bestimmt in welchem \PName{Modus} der Inhalt der
+ Diese primäre Eigenschaft bestimmt, in welchem \PName{Modus} der Inhalt der
Ebene ausgegeben wird. Die Voreinstellung ist \PValue{text}. Dabei wird
die oberste Grundlinie um die Höhe einer Standardtextzeile unterhalb der
Oberkante der Ebene platziert. Damit ist Text normalerweise sauber am
@@ -575,12 +575,13 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar.
linken, unteren Ecke der Ebene aufgespannt. Der ebenfalls vordefinierte
\PName{Modus} \PValue{raw} entspricht in der Voreinstellung \PValue{text}.
- Die\textnote{Achtung!} Änderung des \PName{Modus} einer Ebene führt in der
- Regel zu einer Verschiebung des Inhalts. Außerdem stehen beispielsweise im
- \PName{Modus} \PValue{picture} zusätzliche Platzierungsbefehle zur
- Verfügung, die in einem anderen \PName{Modus} zu Fehlermeldungen führen.
- Daher ist es normalerweise nicht sinnvoll, den \PName{Modus} einer Ebene
- nachträglich zu ändern!%
+ Die %\textnote{Achtung!}
+ Änderung des \PName{Modus} einer Ebene führt in der Regel zu einer
+ Verschiebung des Inhalts. Außerdem stehen beispielsweise im \PName{Modus}
+ \PValue{picture} zusätzliche Platzierungsbefehle zur Verfügung, die in
+ einem anderen \PName{Modus} zu Fehlermeldungen führen. Daher ist es
+ normalerweise nicht sinnvoll, den \PName{Modus} einer Ebene nachträglich
+ zu ändern!%
}%
\entry{\Option{nonfloatpage}}{%
Mit dieser Option wird die Ebene auf Seiten beschränkt, die keine
@@ -695,20 +696,20 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar.
\Macro{layerwidth}
\Macro{layerheight}
\end{Declaration}
-Diese Anweisungen sind nur innerhalb der Ausgabe des mit \Option{contents},
-\Option{addcontents} oder \Option{pretocontents} angegebenen \PName{Code}
-gültig. In diesem Fall enthalten sie die tatsächlich verwendete Ausrichtung,
-Position und Ausdehnung der Ebene, die für die Ausgabe verwendet werden. Dies
-ist jedoch nicht zwangsläufig auch die tatsächliche Ausdehnung des Inhalts,
-falls dieser beispielsweise überbreit oder überhoch ist oder die Ebene nicht
-komplett ausfüllt.
+Diese Anweisungen sind nur im mit \Option{contents}, \Option{addcontents} oder
+\Option{pretocontents} angegebenen \PName{Code} gültig. Sie enthalten die
+tatsächlich verwendete Ausrichtung, Position und Ausdehnung der Ebene während
+deren Ausgabe. Dies ist jedoch nicht zwangsläufig auch die tatsächliche
+Ausdehnung des Inhalts, falls dieser beispielsweise überbreit oder überhoch
+ist oder die Ebene nicht komplett ausfüllt.
Die primäre Ebeneneigenschaft \PValue{align} wird auf
\Macro{layerhalign}\ChangedAt{v3.19}{\Package{scrlayer}} und
\Macro{layervalign} abgebildet. Dabei werden die horizontalen Werte \PValue{l}
und \PValue{r} nur in \Macro{layerhalign} übernommen, während die vertikalen
Werte \PValue{t} und \PValue{b} nur in \Macro{layervalign} übernommen
-werden. Der sowohl horizontale als auch vertikale Wert \PValue{c} wird in
+werden. \iffree{Der sowohl horizontale als auch vertikale }{}% Umbruchkorrektur
+Wert \PValue{c} wird in
beide Anweisungen übernommen. Sind bei \PValue{align} mehrere,
widersprüchliche Angaben zu finden, so gewinnt die jeweils letzte. Damit ist
also \Macro{layerhalign} immer entweder \PValue{l}, \PValue{c} oder \PValue{r}
@@ -724,21 +725,24 @@ Ergebnissen.%
\Macro{LenToUnit}\Parameter{Länge}
\end{Declaration}
Diese\ChangedAt{v3.19}{\Package{scrlayer}} Anweisung stammt ursprünglich von
-\Package{eso-pic}\IndexPackage{eso-pic} ab Version~2.0f. Sie rechnet
-Längen-Werte in Vielfache von \Length{unitlength} um und kann daher an Stelle
-von Koordinaten oder anderen von \Length{unitlength} abhängigen Werten einer
-\Environment{picture}-Umgebung verwendet werden. Siehe dazu auch
+\Package{eso-pic}\IndexPackage{eso-pic}\iffree{ ab
+ Version~2.0f}{}%Umbruchkorrektur
+. Sie rechnet Längen-Werte in Vielfache von \Length{unitlength} um und kann
+daher anstelle von Koordinaten oder anderen von \Length{unitlength} abhängigen
+Werten einer \Environment{picture}-Umgebung verwendet werden. Siehe dazu auch
\cite{package:eso-pic} und die nachfolgende Erklärung zu \Macro{putUR},
-\Macro{putLL} und \Macro{putLR}. Die Anweisung wird nur
-definiert, wenn sie nicht bereits beispielsweise durch das Laden von
-\Package{eso-pic} definiert ist.
-
+\Macro{putLL} und \Macro{putLR}. Die Anweisung wird nur definiert, wenn sie
+nicht bereits beispielsweise durch das Laden von \Package{eso-pic} definiert
+ist.%
+\iffalse% Umbruchkorrekturtext
+\par
Es sei an dieser Stelle darauf hingewiesen, dass man bei Verwendung von Paket
\Package{picture}\IndexPackage{picture}\textnote{\Package{picture}} (siehe
\cite{package:picture}) die Anweisung \Macro{LenToUnit} in der Regel nicht
mehr benötigt. Das Paket erweitert die \Environment{picture}-Umgebung und
deren Anweisung so, dass man für Koordinaten auch direkt \LaTeX-Längen
verwenden kann.%
+\fi
\EndIndexGroup
@@ -757,19 +761,21 @@ entspricht damit
\lstinline[breaklines=false]|\put(0,\LenToUnit{\layerheight})|. \Macro{putUR}
platziert \PName{Inhalt} relativ zur oberen, rechten Ecke der Ebene und
entspricht damit
-\lstinline[breaklines=false]|\put(\LenToUnit{\layerwidth},\LenToUnit{\layerheight})|.
+\lstinline[breaklines=false]
+|\put(\LenToUnit{\layerwidth},\LenToUnit{\layerheight})|.
+\iffree{}{\unskip\linebreak}% Umbruchkorrektur
\Macro{putLL} platziert \PName{Inhalt} relativ zur unteren, linken Ecke der
Ebene und entspricht damit
\lstinline[breaklines=false]|\put(0,0)|. \Macro{putLR} platziert
\PName{Inhalt} relativ zur unteren, rechten Ecke der Ebene und entspricht
damit
\lstinline[breaklines=false]|\put(\LenToUnit{\layerwidth},0)|. \Macro{putC}
-schließlich platziert \PName{Inhalt} relativ zur Mitte der Ebene.%
+schlussendlich platziert \PName{Inhalt} relativ zur Mitte der Ebene.%
%
\begin{Example}
Sie wollen feststellen, wie genau die Höhe des Textbereichs bei
\OptionValueRef{typearea}{DIV}{classic} tatsächlich der Breite der Seite
- entspricht und erstellen dazu eine Ebene, die sowohl den Textbereich
+ entspricht, und erstellen dazu eine Ebene, die sowohl den Textbereich
umrandet als auch einen Kreis mit der Papierbreite als Durchmesser im
Zentrum des Textbereichs platziert:
\begin{lstcode}
@@ -799,17 +805,17 @@ Näheres zu dem im Beispiel skizzierten spätmittelalterlichen Buchseitenkanon
finden Sie übrigens in \autoref{sec:typearea.circleConstruction},
\autopageref{sec:typearea.circleConstruction}.
-Die im Beispiel bereits verwendete Anweisung
-\Macro{DeclareNewPageStyleByLayers}\IndexCmd{DeclareNewPageStyleByLayers} wird
-leider erst in \autoref{sec:scrlayer.pagestyles},
-\DescPageRef{scrlayer.cmd.DeclareNewPageStyleByLayers} erklärt
-werden. Sie dient hier zur Definition eines Seitenstils, der die neu
-definierte Ebene auch tatsächlich verwendet.%
+Die Anweisung
+\Macro{DeclareNewPageStyleByLayers}\IndexCmd{DeclareNewPageStyleByLayers}, die
+im Beispiel bereits verwendet wurde, dient der Definition eines Seitenstils,
+der die neu definiert Ebene ausgibt. Sie wird in
+\autoref{sec:scrlayer.pagestyles},
+\DescPageRef{scrlayer.cmd.DeclareNewPageStyleByLayers} erklärt werden.%
\EndIndexGroup
\begin{Declaration}
- \Macro{GetLayerContents}\Parameter{Name der Ebene}
+ \Macro{GetLayerContents}\Parameter{Name~der~Ebene}
\end{Declaration}
Mit\ChangedAt{v3.16}{\Package{scrlayer}} dieser Anweisung kann der aktuelle
Inhalt einer Ebene ermittelt werden. Es\textnote{Achtung!} ist unbedingt zu
@@ -817,38 +823,44 @@ beachten, dass bei Verwendung dieser Anweisung im \PName{Code} der
Ebenen-Attribute \Option{contents}, \Option{addcontents} oder
\Option{pretocontents} unendliche Rekursionen entstehen können, wenn dabei auf
den Inhalt der aktuellen Ebene zugegriffen wird. Der Anwender ist selbst dafür
-verantwortlich solche Situationen zu vermeiden!%
+verantwortlich, solche Situationen zu vermeiden!%
\EndIndexGroup
\begin{Declaration}
- \Macro{IfLayerExists}\Parameter{Name}
+ \Macro{IfLayerExists}\Parameter{Name~der~Ebene}
\Parameter{Dann-Code}\Parameter{Sonst-Code}
\end{Declaration}
-Diese Anweisung kann dazu verwendet werden, Code in Abhängigkeit davon, ob ein
-eine Ebene existiert oder nicht, auszuführen. Wenn die Ebene mit dem
-angegebenen \PName{Name} existiert, so wird der \PName{Dann-Code}
-ausgeführt, anderenfalls der \PName{Sonst-Code}. Bitte beachten Sie, dass die
-Anweisung nicht wirklich testen kann, ob eine Ebene existiert. Sie verwendet
-stattdessen Heuristiken, die niemals falsch-negativ sein können, jedoch im
-Extremfall falsch-positiv sein könnten. Nichtsdestotrotz: Falls der Test
-falsch-positiv ist, läuft etwas schief. Beispielsweise könnte dies ein
-Indikator für die Verwendung eines inkompatiblen Pakets oder dafür sein, dass
-der Anwender etwas tut, was er besser nicht tun sollte.%
+Diese Anweisung kann dazu verwendet werden, Code in Abhängigkeit davon, ob
+eine Ebene existiert oder nicht, auszuführen. Wenn die Ebene \PName{Name der
+ Ebene} existiert, so wird der \PName{Dann-Code} ausgeführt, anderenfalls der
+\PName{Sonst-Code}. Bitte beachten Sie, dass die Anweisung nicht wirklich
+testen kann, ob eine Ebene existiert. Sie verwendet stattdessen Heuristiken,
+die niemals falsch-negativ sein können, jedoch im Extremfall falsch-positiv
+sein könnten. %
+\iffalse% Umbruchvarianten
+Nichtsdestotrotz: Falls der Test falsch-positiv ist, läuft etwas
+schief. Beispielsweise könnte dies ein Indikator für die Verwendung eines
+inkompatiblen Pakets oder dafür sein, dass der Anwender etwas tut, was er
+besser nicht tun sollte.%
+\else
+Falsch-positive Entscheidungen weisen auf ein Problem, beispielsweise die
+Verwendung eines inkompatiblen Pakets oder ungünstige Wahl von internen
+Makronamen durch den Anwender.%
+\fi
\EndIndexGroup
\begin{Declaration}
- \Macro{DestroyLayer}\Parameter{Name der Ebene}
+ \Macro{DestroyLayer}\Parameter{Name~der~Ebene}
\end{Declaration}
-Existiert eine Ebene mit dem angegebenen \PName{Name der Ebene}, so werden
-alle zu dieser Ebene gehörenden Makros zu \Macro{relax}. Anschließend kann die
-Ebene nicht länger verwendet werden. Allerdings ist es kein Problem, falls die
-Ebene Bestandteil eines mit \Package{scrlayer} definierten Seitenstils ist, da
-derart zerstörte Ebenen schlicht ignoriert werden. Nichtsdestotrotz können
-zerstörte Ebenen anschließend mit \DescRef{\LabelBase.cmd.DeclareNewLayer}
-oder \DescRef{\LabelBase.cmd.ProvideLayer} neu definiert werden. Sie können
-jedoch vor einer neuerlichen Definition nicht länger mit
+Existiert eine Ebene \PName{Name der Ebene}, so werden alle zu dieser Ebene
+gehörenden Makros zu \Macro{relax}. Die Ebene kann nicht länger verwendet
+werden. In bereits mit \Package{scrlayer} definierten Seitenstils werden
+derart zerstörte Ebenen ignoriert. Zerstörte Ebenen können mit
+\DescRef{\LabelBase.cmd.DeclareNewLayer} oder
+\DescRef{\LabelBase.cmd.ProvideLayer} neu definiert werden. Sie können jedoch
+vor einer neuerlichen Definition nicht länger mit
\DescRef{\LabelBase.cmd.RedeclareLayer} oder
\DescRef{\LabelBase.cmd.ModifyLayer} verändert werden.
@@ -890,15 +902,18 @@ möglicherweise überraschende Antwort lautet: mit Hilfe von
Seitenstilen. Üblicherweise werden Seitenstile in \LaTeX{} zur Definition von
Kopf und Fuß der Seite verwendet.
-Kopf und Fuß für ungerade oder rechte Seiten werden im doppelseitigen Modus
-auf Seiten mit ungerader Seitenzahl ausgegeben. Im einseitigen Modus werden
-sie auf allen Seiten verwendet. Das ist unmittelbar mit den Optionen
-\Option{oddpage} und \Option{evenpage} für Ebenen vergleichbar.
+Kopf und Fuß für ungerade oder rechte Seiten\textnote{gerade oder ungerade
+ Seite} werden im doppelseitigen Modus auf Seiten mit ungerader Seitenzahl
+ausgegeben. Im einseitigen Modus werden sie auf allen Seiten verwendet. Das
+ist unmittelbar mit den
+Optionen\important[i]{\Option{evenpage}\\\Option{oddpage}} \Option{oddpage}
+und \Option{evenpage} für Ebenen vergleichbar.
-Der Seitenkopf wird vor dem normalen Seiteninhalt ausgegeben. Der Seitenfuß
-wird entsprechend nach dem normalen Seiteninhalt ausgegeben. Dies
-korrespondiert also unmittelbar mit den Optionen \Option{background} und
-\Option{foreground} für Ebenen.
+Der Seitenkopf\textnote{Kopf oder Fuß} wird vor dem normalen Seiteninhalt
+ausgegeben. Der Seitenfuß wird entsprechend nach dem normalen Seiteninhalt
+ausgegeben. Dies korrespondiert also unmittelbar mit den
+Optionen\important[i]{\Option{background}\\\Option{foreground}}
+\Option{background} und \Option{foreground} für Ebenen.
Daher liegt es nahe, Seitenstile als Listen von Ebenen zu definieren. Aber
statt nur die genannten vier Optionen können dabei alle Eigenschaften
@@ -907,16 +922,16 @@ verwendet werden, die in \autoref{sec:scrlayer.layers},
erklärt wurden.
Als Ergebnis dieser Überlegungen ist eine Form von Seitenstilen, die
-\Package{scrlayer} bietet, der
-Ebenen-Seitenstil\textnote{Ebenen-Seitenstil}%
+\Package{scrlayer} bietet, der Ebenen-Seitenstil\textnote{Ebenen-Seitenstil}%
\Index{Seitenstil>Ebenen-}\Index{Ebenen>Seitenstil}\Index{Seiten>Stil}. Ein
solcher Ebenen-Seitenstil besteht aus Ebenen und zusätzlich aus mehreren Haken
(engl. \emph{hooks}). Die Ebenen wurden bereits in
-\autoref{sec:scrlayer.layers} beschrieben. Die Haken sind Punkte in der
-Expansion oder Anwendung von Seitenstilen, zu denen zusätzlicher Code
-hinzugefügt werden kann. Erfahrene Anwender kennen dieses Konzept bereits von
-beispielsweise \Macro{AtBeginDocument} (siehe \cite{latex:usrguide}) oder
-\Macro{BeforeClosingMainAux} (siehe
+\autoref{sec:scrlayer.layers} beschrieben. Die
+Haken\Index[indexmain]{Haken}\textnote{Haken} sind Punkte in der Expansion
+oder Anwendung von Seitenstilen, zu denen zusätzlicher Code hinzugefügt werden
+kann. Erfahrene Anwender kennen dieses Konzept bereits von beispielsweise
+\Macro{AtBeginDocument} (siehe \cite{latex:usrguide}) oder
+\DescRef{scrlfile.cmd.BeforeClosingMainAux} (siehe
\DescPageRef{scrlfile.cmd.BeforeClosingMainAux}).
Eine zweite Form von Seitenstilen, die \Package{scrlayer} bietet, ist der
@@ -930,11 +945,11 @@ Manipulation am originären Seitenstil. Ist der originäre Seitenstil selbst
ebenfalls ein Seitenstil-Alias, so führt dessen Manipulation wiederum zu einer
Manipulation dessen originären Seitenstils und immer so weiter, bis
schließlich ein realer Seitenstil verändert wird. Der Ausdruck \emph{realer
- Seitenstil} wird zur Unterscheidung von einem Seitenstil-Alias
-verwendet. Alle Seitenstile, die kein Seitenstil-Alias sind, sind reale
-Seitenstile. Seitenstil-Aliase können nicht nur für Seitenstile definiert
-werden, die mit \Package{scrlayer} definiert wurden, sondern für alle
-Seitenstile.
+ Seitenstil}\textnote{realer Seitenstil} wird zur Unterscheidung von einem
+Seitenstil-Alias verwendet. Alle Seitenstile, die kein Seitenstil-Alias sind,
+sind reale Seitenstile. Seitenstil-Aliase können nicht nur für Seitenstile
+definiert werden, die mit \Package{scrlayer} definiert wurden, sondern für
+alle Seitenstile.
\begin{Declaration}
@@ -970,7 +985,7 @@ den aktuellen Seitenstil auf eine Voreinstellung zu setzen.%
\Macro{BeforeSelectAnyPageStyle}\Parameter{Code}
\Macro{AfterSelectAnyPageStyle}\Parameter{Code}
\end{Declaration}
-Die Anweisung \Macro{BeforeSelectAnyPageStyle} fügt einem Haken
+Die Anweisung \Macro{BeforeSelectAnyPageStyle} fügt einem Haken\Index{Haken}
(engl. \emph{hook}) \PName{Code} hinzu, der innerhalb der Ausführung von
Anweisung \DescRef{maincls.cmd.pagestyle}%
\important{\DescRef{maincls.cmd.pagestyle}}\IndexCmd{pagestyle}, unmittelbar
@@ -996,13 +1011,13 @@ einer Gruppe beschränkt werden.%
\begin{Declaration}
\Macro{DeclarePageStyleAlias}\Parameter{Seitenstil-Alias-Name}
- \Parameter{originärer Seitenstil-Name}
+ \Parameter{originärer~Seitenstil-Name}
\Macro{DeclareNewPageStyleAlias}\Parameter{Seitenstil-Alias-Name}
- \Parameter{originärer Seitenstil-Name}
+ \Parameter{originärer~Seitenstil-Name}
\Macro{ProvidePageStyleAlias}\Parameter{Seitenstil-Alias-Name}
- \Parameter{originärer Seitenstil-Name}
+ \Parameter{originärer~Seitenstil-Name}
\Macro{RedeclarePageStyleAlias}\Parameter{Seitenstil-Alias-Name}
- \Parameter{originärer Seitenstil-Name}
+ \Parameter{originärer~Seitenstil-Name}
\end{Declaration}
\BeginIndex{}{Seitenstil>Alias-}%
\BeginIndex{}{Alias>Seitenstil}%
@@ -1046,8 +1061,8 @@ eine Fehlermeldung.
er dies mit:
\begin{lstcode}
\RedeclarePageStyleAlias{chapter}{empty}
-\end{lstcode}
-\end{Example}
+\end{lstcode}%
+\end{Example}%
\fi
\EndIndexGroup
@@ -1060,8 +1075,8 @@ eine Fehlermeldung.
Mit dieser Anweisung wird der Seitenstil-Alias mit dem angegebenen Namen
\PName{Seitenstil-Alias-Name} für \LaTeX{} wieder undefiniert, wenn es
tatsächlich einen Alias-Seitenstil dieses Namens gibt. Anschließend kann der
-Seitenstil auch mit \Macro{DeclareNewAliasPageStyle} oder
-\Macro{ProvideAliasPageStyle} wieder neu definiert werden.
+Seitenstil auch mit \DescRef{\LabelBase.cmd.DeclareNewPageStyleAlias} oder
+\DescRef{\LabelBase.cmd.ProvidePageStyleAlias} neu definiert werden.
Die Anweisung ist dazu bestimmt, innerhalb des Arguments \PName{Code} von
\DescRef{\LabelBase.cmd.scrlayerOnAutoRemoveInterface} (siehe
@@ -1083,8 +1098,7 @@ Alias-Seitenstil gehört. Ist \PName{Seitenstil-Name} nicht der Name eines
Alias-Seitenstils, so ist das Ergebnis \PName{Seitenstil-Name} selbst. Das
gilt auch, falls ein Seitenstil namens \PName{Seitenstil-Name} gar nicht
existiert. Die Anweisung ist voll expandierbar und kann damit beispielsweise
-auch im zweiten Argument einer \Macro{edef}-Anweisung verwendet werden.
-%
+auch im zweiten Argument einer \Macro{edef}-Anweisung verwendet werden.%
\EndIndexGroup
@@ -1104,23 +1118,23 @@ auch im zweiten Argument einer \Macro{edef}-Anweisung verwendet werden.
\end{Declaration}
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
-Diese Anweisungen deklarieren einen Seitenstil mit dem
-Namen \Parameter{Seitenstil-Name}. Der Seitenstil besteht aus einer Anzahl von
-Ebenen, die in der mit Komma separierten \PName{Ebenenliste} angegeben
-sind. Es ist zu beachten\textnote{Achtung!}, dass sowohl
-\PName{Seitenstil-Name} als auch \PName{Ebenenliste} voll expandierbar sein
-müssen und die Expansion zu einer Reihe von Buchstaben führen sollte. Einige
-andere Zeichen werden zwar toleriert, ihre Verwendung wird jedoch nicht
+Diese Anweisungen deklarieren einen Seitenstil mit dem Namen
+\PName{Seitenstil-Name}. Der Seitenstil besteht aus einer Anzahl von Ebenen,
+die in der mit Komma separierten \PName{Ebenenliste} angegeben sind. Es ist zu
+beachten\textnote{Achtung!}, dass sowohl \PName{Seitenstil-Name} als auch
+\PName{Ebenenliste} voll expandierbar sein müssen und die Expansion zu einer
+Reihe von Buchstaben führen sollte. Einige zusätzliche Zeichen werden
+ebenfalls akzeptiert, ihre Verwendung wird jedoch nur erfahrenden Anwendern
empfohlen.
Die \PName{Optionenliste} ist eine mit Komma separierte Liste von Optionen der
Form \texttt{\PName{Schlüssel}=\PName{Code}}. Diese Optionen können verwendet
werden, um zusätzliche Eigenschaften zu setzen und zusätzliche Möglichkeiten
-zu nutzen. Derzeit werden sie verwendet, um Code an bestimmten Stellen der
-Aktivierung oder Verwendung eines Seitenstils über Haken (engl. \emph{hooks})
-auszuführen. Für allgemeine Informationen zu Haken sei auf die Einleitung zu
-diesem Abschnitt verwiesen. Details zu den Haken und ihrer Bedeutung sind
-\autoref{tab:scrlayer.pagestyle.hooks} zu entnehmen.
+zu nutzen. Derzeit werden sie verwendet, um \mbox{Code} an bestimmten Stellen
+der Aktivierung oder Verwendung eines Seitenstils über Haken\Index{Haken}
+(engl. \emph{hooks}) auszuführen. Für allgemeine Informationen zu Haken sei
+auf die Einleitung zu diesem Abschnitt verwiesen. Details zu den Haken und
+ihrer Bedeutung sind \autoref{tab:scrlayer.pagestyle.hooks} zu entnehmen.
\begin{desclist}
\desccaption{%
@@ -1130,80 +1144,81 @@ diesem Abschnitt verwiesen. Details zu den Haken und ihrer Bedeutung sind
Optionen für die Haken von Ebenen-Seitenstilen (\emph{Fortsetzung})%
}%
\entry{\OptionVName{onselect}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn der
- Seitenstil beispielsweise mit \DescRef{maincls.cmd.pagestyle} ausgewählt wird. Es ist zu
- beachten, dass \DescRef{maincls.cmd.thispagestyle} selbst keinen Seitenstil unmittelbar
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn der Seitenstil beispielsweise mit \DescRef{maincls.cmd.pagestyle}
+ ausgewählt wird. Es ist zu beachten, dass
+ \DescRef{maincls.cmd.thispagestyle} selbst keinen Seitenstil unmittelbar
auswählt, sondern der Seitenstil in diesem Fall erst innerhalb der
Ausgaberoutine von \LaTeX{} aktiviert wird.%
}%
\entry{\OptionVName{oninit}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
- Ausgabe der Ebenen für den Seitenstil initialisiert wird. Beachten Sie,
- dass dies für jede Seite zweimal geschieht: einmal für Hintergrund-Ebenen
- und einmal für Vordergrund-Ebenen.%
- }%
- \entry{\OptionVName{ononeside}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn im
- einseitigen Modus die Ausgabe der Ebenen für den Seitenstil initialisiert
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn die Ausgabe der Ebenen für den Seitenstil initialisiert
wird. Beachten Sie, dass dies für jede Seite zweimal geschieht: einmal für
Hintergrund-Ebenen und einmal für Vordergrund-Ebenen.%
}%
+ \entry{\OptionVName{ononeside}{Code}}{%
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn im einseitigen Modus die Ausgabe der Ebenen für den Seitenstil
+ initialisiert wird. Beachten Sie, dass dies für jede Seite zweimal
+ geschieht: einmal für Hintergrund-Ebenen und einmal für
+ Vordergrund-Ebenen.%
+ }%
\entry{\OptionVName{ontwoside}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn im
- doppelseitigen Modus die Ausgabe der Ebenen für den Seitenstil
- initialisiert wird. Beachten Sie, dass dies für jede
- Seite zweimal geschieht: einmal für Hintergrund-Ebenen und einmal für
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn im doppelseitigen Modus die Ausgabe der Ebenen für den Seitenstil
+ initialisiert wird. Beachten Sie, dass dies für jede Seite zweimal
+ geschieht: einmal für Hintergrund-Ebenen und einmal für
Vordergrund-Ebenen.%
}%
\entry{\OptionVName{onoddpage}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
- Ausgabe der Ebenen für den Seitenstil auf einer rechten Seite
- initialisiert wird. Beachten Sie, dass dies für jede
- Seite zweimal geschieht: einmal für Hintergrund-Ebenen und einmal für
- Vordergrund-Ebenen. Beachten Sie außerdem, dass im
- einseitigen Modus alle Seiten rechte Seiten sind.%
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn die Ausgabe der Ebenen für den Seitenstil auf einer rechten Seite
+ initialisiert wird. Beachten Sie, dass dies für jede Seite zweimal
+ geschieht: einmal für Hintergrund-Ebenen und einmal für
+ Vordergrund-Ebenen. Beachten Sie außerdem, dass im einseitigen Modus alle
+ Seiten rechte Seiten sind.%
}%
\entry{\OptionVName{onevenpage}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
- Ausgabe der Ebenen für den Seitenstil auf einer linken Seite initialisiert
- wird. Beachten Sie, dass dies für jede Seite zweimal
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn die Ausgabe der Ebenen für den Seitenstil auf einer linken Seite
+ initialisiert wird. Beachten Sie, dass dies für jede Seite zweimal
geschieht: einmal für Hintergrund-Ebenen und einmal für
- Vordergrund-Ebenen. Beachten Sie außerdem, dass im
- einseitigen Modus keine linken Seiten existieren.%
+ Vordergrund-Ebenen. Beachten Sie außerdem, dass im einseitigen Modus keine
+ linken Seiten existieren.%
}%
\entry{\OptionVName{onfloatpage}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
- Ausgabe der Ebenen für den Seitenstil auf einer Gleitumgebungsseite
- initialisiert wird. Beachten Sie, dass dies für jede
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn die Ausgabe der Ebenen für den Seitenstil auf einer
+ Gleitumgebungsseite initialisiert wird. Beachten Sie, dass dies für jede
Seite zweimal geschieht: einmal für Hintergrund-Ebenen und einmal für
- Vordergrund-Ebenen. Beachten Sie außerdem, dass
- Gleitumgebungsseiten nur diejenigen Seiten sind, auf denen eine oder
- mehrere p-platzierte Gleitumgebungen ausgegeben werden.%
+ Vordergrund-Ebenen. Beachten Sie außerdem, dass Gleitumgebungsseiten nur
+ diejenigen Seiten sind, auf denen eine oder mehrere p-platzierte
+ Gleitumgebungen ausgegeben werden.%
}%
\entry{\OptionVName{onnonfloatpage}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
- Ausgabe der Ebenen für den Seitenstil auf einer Seite initialisiert wird,
- die keine Gleitumgebungsseite ist. Beachten Sie, dass
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn die Ausgabe der Ebenen für den Seitenstil auf einer Seite
+ initialisiert wird, die keine Gleitumgebungsseite ist. Beachten Sie, dass
dies für jede Seite zweimal geschieht: einmal für Hintergrund-Ebenen und
- einmal für Vordergrund-Ebenen. Beachten Sie außerdem,
- dass Gleitumgebungsseiten nur diejenigen Seiten sind, auf denen eine oder
+ einmal für Vordergrund-Ebenen. Beachten Sie außerdem, dass
+ Gleitumgebungsseiten nur diejenigen Seiten sind, auf denen eine oder
mehrere p-platzierte Gleitumgebungen ausgegeben werden, und auf anderen
Seiten sehr wohl t-, b- oder h-platzierte Gleitumgebungen stehen können.%
}%
\entry{\OptionVName{onbackground}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
- Ausgabe der Ebenen für den Hintergrund einer Seite initialisiert
- wird. Beachten Sie, dass dies auf jeder Seite genau
- einmal der Fall ist.%
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn die Ausgabe der Ebenen für den Hintergrund einer Seite initialisiert
+ wird. Beachten Sie, dass dies auf jeder Seite genau einmal der Fall ist.%
}%
\entry{\OptionVName{onforeground}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
- Ausgabe der Ebenen für den Vordergrund einer Seite initialisiert
- wird. Beachten Sie, dass dies auf jeder Seite genau
- einmal der Fall ist.%
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn die Ausgabe der Ebenen für den Vordergrund einer Seite initialisiert
+ wird. Beachten Sie, dass dies auf jeder Seite genau einmal der Fall ist.%
}%
\end{desclist}
+\iffalse% Umbruchvarianten
Während die Anweisung
\Macro{DeclarePageStyleByLayers} %\important{\Macro{DeclarePageStyleByLayers}}%
% Leider zu lang. Deshalb auch auf alle
@@ -1215,7 +1230,21 @@ Seitenstils, der bereits ein Alias für einen anderen Seitenstil ist (siehe
beispielsweise \Macro{DeclareAliasPageStyle} zuvor in diesem Abschnitt) nicht
zu der Umdefinierung des angegebenen Alias-Seitenstils, sondern des realen
Seitenstils (siehe \DescRef{\LabelBase.cmd.GetRealPageStyle} zuvor in diesem
-Abschnitt) führt.
+Abschnitt) führt.%
+\else%
+Die Anweisung \Macro{DeclarePageStyleByLayers} definiert den Seitenstil
+unabhängig davon, ob bereits ein Seitenstil des Namens \PName{Seitenstil-Name}
+existiert. Gegebenenfalls wird der existierende Seitenstil komplett neu
+definiert. Falls bereits ein Alias-Seitenstil \PName{Seitenstil-Name}
+existiert wird jedoch nicht der Alias-Seitenstil selbst neu definiert, sondern
+der zugehörige reale Seitenstil (siehe
+\DescRef{\LabelBase.cmd.GetRealPageStyle} zuvor in diesem Abschnitt).
+
+Die Anweisung \Macro{DeclareNewPageStyleByLayers} unterscheidet sich in dem
+Fall, dass bereits ein gleichnamiger Seitenstil existiert. Unabhängig davon,
+ob es sich um einen realen Seitenstil oder einen Alias-Seitenstil handelt,
+wird in diesem Fall ein Fehler gemeldet.%
+\fi
Im Unterschied dazu wird bei \Macro{ProvidePageStyleByLayers} der Seitenstil
unverändert erhalten, wenn bereits ein Seitenstil des Namens
@@ -1227,7 +1256,7 @@ bereits ein Seitenstil des Namens \PName{Seitenstil-Name} existiert und
definiert dessen realen Seitenstil dann um. Existiert jedoch noch kein
Seitenstil des angegebenen Namens, so resultiert daraus eine Fehlermeldung.
-Beachten Sie auch die nachfolgenden Anmerkungen zum Pseudo-Seitenstil
+Beachten Sie des Weiteren die nachfolgenden Anmerkungen zum Pseudo-Seitenstil
\PageStyle{@everystyle@}.%
\EndIndexGroup
@@ -1241,13 +1270,13 @@ Beachten Sie auch die nachfolgenden Anmerkungen zum Pseudo-Seitenstil
Das Paket \Package{scrlayer} definiert von sich aus bereits zwei in gewisser
Weise spezielle Seitenstile. Der erste davon ist
\PageStyle{@everystyle@}\important{\PageStyle{@everystyle@}}. Dieser
-Seitenstil sollte niemals als normaler Seitenstil beispielsweise mit
-\DescRef{maincls.cmd.pagestyle} oder \DescRef{maincls.cmd.thispagestyle} oder
+Seitenstil sollte niemals als normaler Seitenstil, beispielsweise mit
+\DescRef{maincls.cmd.pagestyle} oder \DescRef{maincls.cmd.thispagestyle}, oder
als Ziel eines Alias-Seitenstils verwendet werden. Stattdessen werden die
-Ebenen und Haken dieses Seitenstils von allen anderen Ebenen-Seitenstilen mit
-verwendet. Dabei werden die Haken von \PageStyle{@everystyle@} jeweils vor den
-entsprechenden Haken und die Ebenen jeweils vor den entsprechenden Ebenen des
-aktiven Seitenstils ausgeführt.
+Ebenen und Haken\Index{Haken} dieses Seitenstils von allen anderen
+Ebenen-Seitenstilen mit verwendet. Dabei werden die Haken von
+\PageStyle{@everystyle@} jeweils vor den entsprechenden Haken und die Ebenen
+jeweils vor den entsprechenden Ebenen des aktiven Seitenstils ausgeführt.
Damit ist das Hinzufügen einer Ebene zum Pseudo-Seitenstil
\PageStyle{@everystyle@} oder von Code zu einem Haken dieses Seitenstils
@@ -1266,8 +1295,9 @@ ein Seitenstil dieses Namens definiert, der einen leeren Kopf und Fuß hat. Das
Paket \Package{scrlayer} definiert diesen Seitenstil als Ebenen-Seitenstil
ohne Ebenen um. Nichtsdestotrotz kann er wie jeder andere Ebenen-Seitenstil
verwendet werden. Der Hauptvorteil dieses Ebenen-Seitenstils gegenüber dem
-ursprünglichen Seitenstil aus dem \LaTeX-Kern ist, dass er ebenfalls die Haken
-und Ebenen des Pseudo-Seitenstils \PageStyle{@everystyle@} ausführt.%
+ursprünglichen Seitenstil aus dem \LaTeX-Kern ist, dass er ebenfalls die
+Haken\Index{Haken} und Ebenen des Pseudo-Seitenstils \PageStyle{@everystyle@}
+ausführt.%
\EndIndexGroup
@@ -1285,17 +1315,21 @@ und Ebenen des Pseudo-Seitenstils \PageStyle{@everystyle@} ausführt.%
\end{Declaration}
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
-Für jeden der Haken aus \autoref{tab:scrlayer.pagestyle.hooks} existiert
-außerdem eine \KOMAScript-Option. Die Namen der \KOMAScript-Optionen ähneln
-den Namen der Optionen für die Befehle zur Deklaration von
-Ebenen-Seitenstilen. Es wird lediglich ein »\texttt{ps}« nach dem
-»\texttt{on}« am Anfang des Namens eingefügt. Die Werte dieser
-\KOMAScript-Optionen werden als Anfangswerte für die entsprechenden Haken
-verwendet. Dieser Anfangswert wird dann um alle Werte, die dem entsprechenden
-Haken in der \PName{Optionenliste} der Deklarationsbefehle zugewiesen werden,
-erweitert. Der Anfangswert kann mit Hilfe der Anweisung
-\DescRef{\LabelBase.cmd.ModifyLayerPageStyleOptions}, die später in diesem
-Abschnitt erklärt wird, entfernt werden.%
+Für jeden der Haken\Index{Haken} aus \autoref{tab:scrlayer.pagestyle.hooks}
+existiert außerdem eine \KOMAScript-Option%
+\iftrue%
+. Die Namen der \KOMAScript-Optionen ähneln den Namen der Optionen für die
+Befehle zur Deklaration von Ebenen-Seitenstilen. Es wird lediglich ein
+»\texttt{ps}« nach dem »\texttt{on}« am Anfang des Namens eingefügt%
+\else%
+, in deren Namen lediglich ein \texttt{ps} eingefügt wurde%
+\fi%
+. Die Werte dieser \KOMAScript-Optionen werden als Anfangswerte für die
+entsprechenden Haken verwendet. Dieser Anfangswert wird dann um alle Werte,
+die dem entsprechenden Haken in der \PName{Optionenliste} der
+Deklarationsbefehle zugewiesen werden, erweitert. Der Anfangswert kann mit
+Hilfe der Anweisung \DescRef{\LabelBase.cmd.ModifyLayerPageStyleOptions}, die
+später in diesem Abschnitt erklärt wird, entfernt werden.%
\EndIndexGroup
@@ -1304,14 +1338,15 @@ Abschnitt erklärt wird, entfernt werden.%
\end{Declaration}
Wird\ChangedAt{v3.24}{\Package{scrlayer}\and \Package{scrlayer-scrpage}} ein
Dokument beispielsweise mit Hilfe von Paket
-\Package{setspace}\IndexPackage{setspace} mit erhöhtem Zeilenabstand gesetzt,
-ist es oft dennoch nicht erwünscht, dass Kopf und Fuß der Seite ebenfalls mit
-diesem erhöhten Zeilenabstand gesetzt werden. Das gilt umso mehr, wenn Kopf
-und Fuß nur aus jeweils einer Zeile bestehen. In diesem Fall kann man
-\KOMAScript-Option \Option{singlespacing} setzen. In der Voreinstellung ist
-die Option jedoch nicht gesetzt! Die Option wirkt generell für alle
-Ebenen-Seitenstile. Will man hingegen nur einige Ebenen-Seitenstil einzeilig
-gesetzt haben, so sollte man stattdessen für diese Seitenstile
+\Package{setspace}\IndexPackage{setspace}\important{\Package{setspace}} mit
+erhöhtem Zeilenabstand gesetzt, ist es oft dennoch nicht erwünscht, dass Kopf
+und Fuß der Seite ebenfalls mit diesem erhöhten Zeilenabstand gesetzt
+werden. Das gilt umso mehr, wenn Kopf und Fuß nur aus jeweils einer Zeile
+bestehen. In diesem Fall kann man \KOMAScript-Option \Option{singlespacing}
+setzen. In der Voreinstellung\textnote{Voreinstellung} ist die Option jedoch
+nicht gesetzt! Die Option wirkt generell für alle Ebenen-Seitenstile. Will man
+hingegen nur einige Ebenen-Seitenstil einzeilig gesetzt haben, so sollte man
+stattdessen für diese Seitenstile
\OptionValue{oninit}{\Macro{linespread}\PParameter{1}\Macro{selectfont}}
verwenden.%
\EndIndexGroup
@@ -1342,16 +1377,16 @@ Platzhalter für den Namen der gerade abgearbeiteten Ebene.
\end{lstcode}
erreichen.
\end{Example}
-Die Verwendung von \Macro{gdef} an Stelle von \Macro{def} ist im Beispiel
-notwendig, weil \PName{Code} innerhalb einer Gruppe ausgeführt wird, um
-unerwünschte Seiteneffekte zu minimieren. Die Anweisung \Macro{gdef} definiert
-\Macro{commaatlist} jedoch global um, so dass beim Aufruf des Codes für die
-nächste Ebene die Änderung Bestand hat.
+Die Verwendung von \Macro{gdef} anstelle von \Macro{def} ist im Beispiel
+notwendig\textnote{Achtung!}, weil \PName{Code} innerhalb einer Gruppe
+ausgeführt wird, um unerwünschte Seiteneffekte zu minimieren. Die Anweisung
+\Macro{gdef} definiert \Macro{commaatlist} jedoch global um, so dass beim
+Aufruf des Codes für die nächste Ebene die Änderung Bestand hat.
Alternativ\ChangedAt{v3.18}{\Package{scrlayer}} hätte man auch zwar mit
\Macro{def}, dafür aber mit der Sternvariante \Macro{ForEachLayerOfPageStyle*}
arbeiten können. Diese Form verzichtet bei der Ausführung von \PName{Code} auf
-eine zusätzliche Gruppe. Allerdings muss der Anwender dann selbst
+eine Gruppe. Allerdings muss der Anwender dann selbst
sicherstellen, dass \PName{Code} keine unerwünschten Seiteneffekte
hat. Insbesondere würde die Deaktivierung der Ebenen mit
\OptionValue{deactivatepagestylelayers}{true} innerhalb von \PName{Code} dann
@@ -1361,8 +1396,7 @@ Diverse Anweisungen von \Package{scrlayer} setzen intern selbst ebenfalls
\Macro{ForEachLayerOfPageStyle} ein. Auch deren Funktion kann daher über die
\KOMAScript-Option \Option{deactivatepagestylelayers} verändert werden. Diese
Option kann also verwendet werden, um alle Ebenen aller Seitenstile temporär
-zu deaktivieren oder zu verstecken.
-%
+zu deaktivieren und damit zu verstecken.%
\EndIndexGroup
@@ -1379,7 +1413,7 @@ zu deaktivieren oder zu verstecken.
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
Diese Anweisungen können verwendet werden, um Ebenen zu einem Seitenstil
-hinzuzufügen oder davon zu entfernen. Der Seitenstil wird dabei über seinen
+hinzuzufügen oder davon zu entfernen. Der Seitenstil wird dabei über
\PName{Seitenstil-Name} referenziert. Die Ebenen werden in einer durch Komma
separierten \PName{Ebenenliste} angegeben.
@@ -1398,13 +1432,20 @@ Ende von \PName{Ebenenliste} steht, nach dem Einfügen die erste und damit die
unterste oder hinterste Ebene (jeweils entweder der Vordergrund- oder der
Hintergrundebenen) sein.
+\iffalse% Umbruchkorrekturtext (beim Aktiveren muss unten \textnot{entfernen}
+ % entfernt werden!)
+Die Anweisung \Macro{RemoveLayersFromPageStyle} dient dem genauen
+Gegenteil. Sie entfernt\textnote{entfernen} die angegebenen Ebenen von
+Seitenstil.%
+\fi
+
Der Versuch, mit Hilfe von
\Macro{RemoveLayersFromPageStyle}\textnote{entfernen} Ebenen von einem
Seitenstil zu entfernen, die gar nicht Teil des Seitenstils sind, wird
ignoriert, führt also nicht zu einer Fehlermeldung. Dagegen ist der Versuch,
Ebenen zu einem Seitenstil, der kein Ebenen-Seitenstil ist und auch kein
Alias-Seitenstil, der zu einem Ebenen-Seitenstil führt, hinzuzufügen oder von
-einem solchen zu entfernen ein Fehler und wird als solcher gemeldet.%
+einem solchen zu entfernen, ein Fehler und wird als solcher gemeldet.%
\EndIndexGroup
@@ -1418,14 +1459,23 @@ einem solchen zu entfernen ein Fehler und wird als solcher gemeldet.%
\end{Declaration}
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
+\iffalse% Umbruchvarianten
Diese beiden Befehle ähneln den vorangegangenen. Allerdings wird hier
zusätzlich ein \PName{Referenzebenen-Name} angegeben. Die Ebenen des über den
\PName{Seitenstil-Name} angegebenen Seitenstils werden nach dieser
-Referenzebene durchsucht. Die Ebenen der \PName{Ebenenliste} werden dann
+Referenzebene durchsucht. %
+\else%
+Die Befehle ähneln den vorherigen. Die existierenden Ebenen des Seitenstils
+werden jedoch nach \PName{Referenzebenen-Name} durchsucht. %
+\fi%
+Die Ebenen der \PName{Ebenenliste} werden dann
vor\textnote{hinzufügen vor/nach Ebene}
-respektive nach jedem Auf"|treten der Referenzebene in die Ebenen des
-Seitenstils eingefügt. Dabei bleibt die Reihenfolge der Ebenen der
-\PName{Ebenenliste} erhalten.%|
+respektive nach jedem Auf"|treten der Referenzebene %
+\iffalse% Umbruchkorrekturtext
+in die Ebenen des Seitenstils %
+\fi%
+eingefügt. Dabei bleibt die Reihenfolge der Ebenen der
+\PName{Ebenenliste} erhalten.
Ist die Referenzebene nicht Bestandteil des Seitenstils, so wird auch nichts
eingefügt. Ist der Seitenstil hingegen kein Ebenen-Seitenstil und auch kein
@@ -1464,18 +1514,19 @@ Reihenfolge neu hinzugefügt werden. In einem solchen Fall ist
\end{Declaration}
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
-Mit diesen beiden Anweisungen können die Optionen und damit die Haken eines
-Ebenen-Seitenstils nachträglich verändert werden. Bei
+Mit diesen beiden Anweisungen können die Optionen und damit die
+Haken\Index{Haken} eines Ebenen-Seitenstils nachträglich verändert werden. Bei
\Macro{ModifyLayerPageStyleOptions}\textnote{Seitenstil-Optionen ändern}
werden dabei genau die Optionen, die in der durch Komma separierten
-\PName{Optionenliste} angegeben sind, auf die dortigen neuen Werte gesetzt. Die
-bisherigen Werte gehen dabei verloren. Es sind alle Optionen aus
+\PName{Optionenliste} angegeben sind, auf die dortigen neuen Werte
+gesetzt. Die bisherigen Werte gehen dabei verloren. Es sind alle Optionen aus
\autoref{tab:scrlayer.pagestyle.hooks},
-\autopageref{tab:scrlayer.pagestyle.hooks} erlaubt. Optionen beziehungsweise
-Haken, die nicht in der \PName{Optionenliste} angegeben sind, bleiben hingegen
-unverändert. Diese Anweisung ist damit auch die einzige Möglichkeit, die
-globalen Voreinstellungen der \KOMAScript-Optionen von einem Seitenstil zu
-entfernen.
+\autopageref{tab:scrlayer.pagestyle.hooks} erlaubt. Optionen
+\iffree{beziehungsweise}{oder} Haken, die nicht in der \PName{Optionenliste}
+angegeben sind, bleiben hingegen unverändert. Diese Anweisung ist
+\iffree{damit auch }{}% Umbruchkorrektur
+die einzige Möglichkeit, die globalen Voreinstellungen der
+\KOMAScript-Optionen von einem Seitenstil zu entfernen.
Die Anweisung \Macro{AddToLayerPageStyleOptions}\textnote{Seitenstil-Optionen
erweitern} dagegen überschreibt die bisher vorhandenen Werte nicht, sondern
@@ -1494,19 +1545,20 @@ neuen Werte an die alten an.%
\end{Declaration}
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
-Mit diesen Anweisungen kann Code in Abhängigkeit davon ausgeführt werden, ob
+Mit den Anweisungen kann Code in Abhängigkeit davon ausgeführt werden, ob
ein Seitenstil ein Ebenen-Seitenstil ist oder nicht. Dabei führt
\Macro{IfLayerPageStyleExists} den \PName{Dann-Code} nur dann aus, wenn
\PName{Seitenstil-Name} der Name eines Ebenen-Seitenstils oder der Name eines
Alias-Seitenstils ist, der zu einem Ebenen-Seitenstil führt. Anderenfalls
führt die Anweisung den \PName{Sonst-Code} aus.
-Die Anweisung \Macro{IfRealLayerPageStyleExists} geht einen Schritt weiter und
-führt den \PName{Dann-Code} nur dann aus, wenn der über
-\PName{Seitenstil-Name} angegebene Seitenstil selbst ein Ebenen-Seitenstil
-ist. Im Falle eines Alias-Seitenstils führt diese Anweisung also selbst dann
-\PName{Sonst-Code} aus, wenn dieser Alias-Seitenstil zu einem
-Ebenen-Seitenstil führt.%
+\iffree{Die Anweisung }{}%Umbruchvarianten
+\Macro{IfRealLayerPageStyleExists} geht einen Schritt weiter und führt
+\iffree{den }{}% Umbruchvarianten
+\PName{Dann-Code} nur dann aus, wenn der über \PName{Seitenstil-Name}
+angegebene Seitenstil selbst ein Ebenen-Seitenstil ist. Im Falle eines
+Alias-Seitenstils führt diese Anweisung also selbst dann \PName{Sonst-Code}
+aus, wenn dieser Alias-Seitenstil zu einem Ebenen-Seitenstil führt.%
\EndIndexGroup
@@ -1527,22 +1579,21 @@ Ebenen-Seitenstil führt.%
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
Mit diesen Anweisungen kann überprüft werden, ob ein oder mehrere Ebenen
-Bestandteil eines Seitenstils sind. \Macro{IfLayerAtPageStyle}\textnote{genau
- eine Ebene}
-erwartet dabei nach dem \PName{Seitenstil-Name} im ersten Argument im zweiten
-Argument genau einen \PName{Ebenen-Name}. Ist die entsprechende Ebene
-Bestandteil des Seitenstils, so wird der \PName{Dann-Code} ausgeführt,
-anderenfalls der \PName{Sonst-Code}.
-
-Im Unterschied dazu erlauben \Macro{IfSomeLayersAtPageStyle}
-und \Macro{IfLayersAtPageStyle} im zweiten Argument eine durch Komma
-separierte \PName{Ebenenliste}. Dabei führt
-\Macro{IfSomeLayersAtPageStyle}\textnote{mindestens eine Ebene}
-den \PName{Dann-Code} bereits aus, wenn \emph{mindestens eine} der Ebenen
+Bestandteil eines Seitenstils sind. \Macro{IfLayerAtPageStyle} erwartet dabei
+nach dem \PName{Seitenstil-Name} im ersten Argument im zweiten Argument
+genau\textnote{genau eine Ebene} einen \PName{Ebenen-Name}. Ist die
+entsprechende Ebene Bestandteil des Seitenstils, so wird der \PName{Dann-Code}
+ausgeführt, anderenfalls der \PName{Sonst-Code}.
+
+Im Unterschied dazu erlauben \Macro{IfSomeLayersAtPageStyle} und
+\Macro{IfLayersAtPageStyle} im zweiten Argument eine durch Komma separierte
+\PName{Ebenenliste}. Dabei führt
+\Macro{IfSomeLayersAtPageStyle}\textnote{mindestens eine Ebene} den
+\PName{Dann-Code} bereits aus, wenn \emph{mindestens eine} der Ebenen
Bestandteil des Seitenstils ist. Dagegen führt
-\Macro{IfLayersAtPageStyle}\textnote{alle Ebenen} den
-\PName{Dann-Code} nur aus, wenn \emph{alle} Ebenen Bestandteil des Seitenstils
-sind. Ist die Bedingung nicht erfüllt, so wird jeweils \PName{Sonst-Code}
+\Macro{IfLayersAtPageStyle}\textnote{alle Ebenen} den \PName{Dann-Code} nur
+aus, wenn \emph{alle} Ebenen Bestandteil des Seitenstils sind. \iffree{Ist die
+ Bedingung nicht erfüllt, so}{Anderenfalls} wird jeweils \PName{Sonst-Code}
ausgeführt.
Durch geeignete Schachtelung sind auch komplexe Bedingungen abbildbar. Gibt
@@ -1556,24 +1607,31 @@ so sind alle drei Anweisungen gleichbedeutend.%
\end{Declaration}
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
+\iftrue%
+Mit der Anweisung wird ein Ebenen-Seitenstil aus \LaTeX-Sicht undefiniert.
+Wurde statt eines Ebenen-Seitenstils ein Alias-Seitenstil, ein anderer
+Seitenstil oder ein unbekannter Seitenstil angegeben, so wird die Anweisung
+ignoriert.%
+\else%
Mit dieser Anweisung kann ein Ebenen-Seitenstil aus \LaTeX-Sicht wieder
undefiniert werden. Dies gilt jedoch nur, wenn es einen Ebenen-Seitenstil mit
dem Namen \PName{Ebenen-Seitenstil-Name} auch tatsächlich gibt. Handelt es sich
stattdessen um einen Alias-Seitenstil -- auch wenn dieser zu einem
Ebenen-Seitenstil führt -- oder um einen anderen Seitenstil oder ist gar kein
Seitenstil mit dem Namen \PName{Ebenen-Seitenstil-Name} bekannt, so geschieht
-nichts, die Anweisung wird ignoriert.
+nichts, die Anweisung wird ignoriert.%
+\fi
Falls \PName{Ebenen-Seitenstil-Name} der Name des aktuellen Seitenstils ist,
-so wird der aktuelle Seitenstil auf eine Art leerer Seitenstil gesetzt. Falls
-der Spezial-Seitenstil, der durch \DescRef{maincls.cmd.thispagestyle} gesetzt
-wurde, auf \PName{Ebenen-Seitenstil-Name} lautet, so wird dieser einfach nur
+so wird dieser auf eine Art leeren Seitenstil gesetzt. Falls der mit
+\DescRef{maincls.cmd.thispagestyle} gesetzte Seitenstil
+\PName{Ebenen-Seitenstil-Name} lautet, so wird dieser einfach nur
zurückgesetzt. Die vorherige Anweisung \DescRef{maincls.cmd.thispagestyle}
verliert damit ihre aktuelle Auswirkung.
Es ist zu beachten\textnote{Achtung!}, dass die Ebenen des Seitenstils nicht
automatisch mit vernichtet werden. Falls Sie die Ebenen ebenfalls vernichten
-möchten, so können Sie dies beispielsweise mit:
+möchten, so können Sie dies beispielsweise mit
\begin{lstcode}
\ForEachLayerOfPageStyle{...}{\DestroyLayer{#1}}
\end{lstcode}
@@ -1597,18 +1655,21 @@ wurden, beim automatischen Entfernen dieses Interfaces mit zu entfernen.%
Das Paket \Package{scrlayer} stellt eine experimentelle Benutzerschnittstelle
zur Verfügung um (konkurrierende) Schnittstellen für Endanwender definieren
-und verwalten zu können. Möglicherweise wird diese Schnittstelle langfristig
-wieder aus \Package{scrlayer} verschwinden und dann stattdessen von
-\Package{scrbase} übernommen werden. Derzeit ist die Schnittstelle aber noch
-hoch experimentell und wird daher von eigenen Befehlen innerhalb von
-\Package{scrlayer} nur für Unterpakete von \Package{scrlayer} bereit
-gestellt. Es empfiehlt sich beim aktuellen Entwicklungsstand nicht, sich
-darauf zu verlassen, dass die automatische Entfernung einer konkurrierenden
+und verwalten zu können. \iffree{% Umbruchvarianten
+ Möglicherweise wird diese Schnittstelle langfristig wieder aus
+ \Package{scrlayer} verschwinden und dann stattdessen von \Package{scrbase}
+ übernommen werden. }{}%
+Derzeit ist die Schnittstelle aber noch hoch
+experimentell\iffree{% Umbruchvariante
+ und wird daher von eigenen Befehlen innerhalb von \Package{scrlayer} nur für
+ Unterpakete von \Package{scrlayer} bereit gestellt}{}%
+. Es empfiehlt sich beim aktuellen Entwicklungsstand nicht, sich darauf zu
+verlassen, dass die automatische Entfernung einer konkurrierenden
Schnittstelle funktioniert. Stattdessen sollte die Verwendung konkurrierender
Schnittstellen vermieden werden.
Dieser Abschnitt beschreibt lediglich die Schnittstellen"=Anweisungen für die
-Definition einer Endanwender-Schnittstelle. Für Endanwender selbst ist es
+Definition einer Endanwender-Schnittstelle. Für Endanwender selbst ist er
damit von geringem Interesse. Vielmehr richtet sich dieser Teil der Anleitung
an Autoren von Paketen und Klassen, die auf \Package{scrlayer}
aufbauen. Endanwender finden Informationen zu konkreten
@@ -1657,17 +1718,17 @@ optionale Argument auch dann zu verwenden, wenn es dem Dateinamen der Klasse
beziehungsweise des Pakets entspricht, da die Werte von \Macro{@currname} und
\Macro{@currext} nur während des Ladens Gültigkeit besitzen.
-Das erste obligatorische Argument ist der \PName{Befehl}\footnote{\PName{Befehl}
- besteht aus einem umgekehrten Schrägstrich (engl. \emph{backslash}) gefolgt
- von einer \PName{Befehlssequenz}, die entweder aus Zeichen der
- Kategorie \emph{letter} oder aus genau einem Zeichen der Kategorie
- \emph{other} besteht, oder aus einem Zeichen der Kategorie \texttt{active}
- (ohne umgekehrten Schrägstrich davor).}, der zu der
-Endanwender-Schnittstelle hinzugefügt werden soll. Falls der Befehl
-definiert werden kann, erfolgt dies. Außerdem wird dann der Befehl auf
-\Macro{relax} gesetzt und \PName{Code} wird ausgeführt. Innerhalb von
-\PName{Code} kann der \PName{Befehl} dann beispielsweise mit Hilfe von
-\Macro{newcommand} definiert werden.
+Das erste obligatorische Argument ist der
+\PName{Befehl}\footnote{\PName{Befehl} besteht aus einem umgekehrten
+ Schrägstrich (engl. \emph{backslash}), gefolgt von einer
+ \PName{Befehlssequenz}, die entweder aus Zeichen der Kategorie \emph{letter}
+ oder aus genau einem Zeichen der Kategorie \emph{other} besteht, oder aus
+ einem Zeichen der Kategorie \emph{active} (ohne umgekehrten Schrägstrich
+ davor).}, der zu der Endanwender-Schnittstelle hinzugefügt werden
+soll. Falls der Befehl definiert werden kann, erfolgt dies. Außerdem wird dann
+der Befehl auf \Macro{relax} gesetzt und \PName{Code} wird
+ausgeführt. Innerhalb von \PName{Code} kann der \PName{Befehl} dann
+beispielsweise mit Hilfe von \Macro{newcommand} definiert werden.
Wann aber kann ein \PName{Befehl}\textnote{definierbare Befehle} definiert
werden? Ist ein \PName{Befehl} undefiniert oder \Macro{relax}, so kann er
@@ -1728,6 +1789,7 @@ optionale Argument sei auf die Erklärung zu
% LocalWords: Vordergrundebene Sternvariante Gleitseiten Hintergrundebenen
% LocalWords: Ausgabebeschränkungen Grafikausgabe Textausgabe Textebenen
-% LocalWords: Standardgrundlinie Grafikebenen Standardtextzeile
+% LocalWords: Standardgrundlinie Grafikebenen Standardtextzeile überhoch
% LocalWords: Platzierungsbefehle Ebeneneigenschaft Satzspiegelkonstruktion
% LocalWords: Kreisschlagen Buchseitenkanon spätmittelalterlichen
+% LocalWords: Makronamen
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex
index b53924fc9fe..75c52600bf4 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlfile.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlfile.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ============================================================================
\KOMAProvidesFile{scrlfile.tex}%
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-02-16 04:42:17 +0100 (Fri, 16 Feb 2018) $
KOMA-Script guide (chapter: scrlfile)]
\chapter{Paketabhängigkeiten mit \Package{scrlfile}
@@ -69,16 +69,15 @@ erfüllt.
\section{Die Sache mit den Paketabhängigkeiten}
\seclabel{dependency}
%\begin{Explain}
- \iffree{}{\looseness=1\relax}% Umbruchkorrektur
Immer häufiger definieren unterschiedliche Pakete den gleichen
Befehl neu oder um. Dabei ist es dann sehr entscheidend, in welcher
Reihenfolge die Pakete geladen werden. Manchmal ist das für den
- Anwender kaum zu überschauen. In manchen Fällen ist es auch
- notwendig, einfach nur in irgendeiner Form auf das Laden eines
- anderen Paketes zu reagieren. Auch das ist nicht immer ganz einfach.
+ Anwender kaum zu überschauen. Teilweise ist es auch
+ notwendig, in irgendeiner Form auf das Laden eines
+ anderen Pakets zu reagieren.
Nehmen wir als einfaches Beispiel das Laden des
- \Package{longtable}-Paketes bei Verwendung von \KOMAScript{}. Das
+ \Package{longtable}-Pakets bei Verwendung von \KOMAScript{}. Das
\Package{longtable}-Paket definiert seine eigene Form von
Tabellenüberschriften. Diese passen perfekt zu den
Standardklassen. Sie passen aber überhaupt
@@ -107,8 +106,8 @@ erfüllt.
\Package{scrlfile} bringt hier Abhilfe.
Ebenso wäre es denkbar, dass man vor dem Laden eines bestimmten
- Paketes gerne die Bedeutung eines Makros in einem Hilfsmakro retten
- und nach dem Laden des Paketes wieder restaurieren will. Auch das
+ Pakets gerne die Bedeutung eines Makros in einem Hilfsmakro retten
+ und nach dem Laden des Pakets wieder restaurieren will. Auch das
geht mit \Package{scrlfile}.
Die Anwendung von \Package{scrlfile} ist nicht auf die Abhängigkeit
@@ -197,7 +196,7 @@ seinem Namen und nicht mit seinem Dateinamen angegeben wird. Die Endungen
\Macro{AfterAtEndOfPackage}\Parameter{Paket}\Parameter{Anweisungen}
\end{Declaration}%
Die Anweisungen \Macro{AfterClass} und \Macro{AfterPackage} arbeiten
-weitgehend wie \DescRef{\LabelBase.cmd.AfterFile} mit dem winzigen
+weitgehend wie \DescRef{\LabelBase.cmd.AfterFile}, mit dem winzigen
Unterschied, dass die \PName{Klasse} beziehungsweise das \PName{Paket} mit
seinem Namen und nicht mit seinem Dateinamen angegeben wird. Die Endungen
»\File{.cls}« und »\File{.sty}« entfallen hier also.
@@ -221,10 +220,10 @@ verzögerten Anweisungen ausgeführt.
Um\important[i]{\Macro{AfterClass!}\\\Macro{AfterPackage!}} eine Ausführung
nach den in der Klasse oder dem Paket selbst mit \Macro{AtEndOfClass} oder
-\Macro{AtEndOfPackage} verzögerten Anweisungen sicher zu stellen, ist die
+\Macro{AtEndOfPackage} verzögerten Anweisungen sicherzustellen, ist die
Variante mit Ausrufezeichen\ChangedAt{v3.09}{\Package{scrlfile}} zu
-verwenden. In diesem Fall werden die \PName{Anweisungen} nicht mehr im Kontext
-der angegebenen Klasse bzw. des angegebenen Pakets ausgeführt.
+verwenden. Bei dieser Spielart werden die \PName{Anweisungen} nicht mehr im
+Kontext der angegebenen Klasse oder des angegebenen Pakets ausgeführt.
Will\important[i]{\Macro{AfterAtEndOfClass}\\\Macro{AfterAtEndOfPackage}} man
nur für den Fall, dass die Klasse bzw. das Paket noch nicht geladen wurde,
@@ -237,8 +236,8 @@ und für Pakete \Macro{AfterAtEndOfPackage}.%
\begin{Example}
Als Beispiel für Paket- oder Klassenautoren will ich zunächst
erklären, wie \KOMAScript{} selbst Gebrauch von den neuen
- Anweisungen macht. Dazu findet sich in \Class{scrbook}
- beispielsweise Folgendes:
+ Anweisungen macht. Dazu findet sich beispielsweise in \Class{scrbook}
+ Folgendes:
\begin{lstcode}
\AfterPackage{hyperref}{%
\@ifpackagelater{hyperref}{2001/02/19}{}{%
@@ -260,7 +259,7 @@ und für Pakete \Macro{AfterAtEndOfPackage}.%
\Package{hyperref} unterlassen dies, wenn sie eine neuere Version
von \KOMAScript{} erkennen. Für den Fall, dass \Package{hyperref}
zu einem späteren Zeitpunkt geladen wird, sorgt also \Class{scrbook}
- dafür, dass unmittelbar nach dem Laden des Paketes überprüft wird, ob
+ dafür, dass unmittelbar nach dem Laden des Pakets überprüft wird, ob
es sich um eine verträgliche Version handelt. Falls dies nicht der
Fall ist, wird eine Warnung ausgegeben.
@@ -291,20 +290,14 @@ und für Pakete \Macro{AfterAtEndOfPackage}.%
\mbox{hyper\TeX} ist dies jedoch nicht
möglich. In diesem Fall hätten Sie gerne, dass bei
\Package{hyperref} die Einstellung \Option{linktocpage} verwendet
- wird. Die Entscheidung, welcher Treiber geladen wird, wird bei Ihnen
- automatisch von \File{hyperref.cfg} erledigt. Dazu sieht die Datei
- beispielsweise wie folgt aus:
-\begin{lstcode}
- \ProvidesFile{hyperref.cfg}
- \@ifundefined{pdfoutput}{\ExecuteOptions{dvips}}
- {\ExecuteOptions{pdftex}}
- \endinput
-\end{lstcode}
+ wird. Die Entscheidung, welcher Treiber geladen wird, wird von
+ \Package{hyperref} automatisch getroffen.
Alles weitere kann nun \DescRef{\LabelBase.cmd.AfterFile} überlassen werden:
\begin{lstcode}[moretexcs={hypersetup}]
\documentclass{article}
- \usepackage{scrlfile,ngerman}
+ \usepackage[ngerman]{babel}
+ \usepackage{scrlfile}
\AfterFile{hdvips.def}{\hypersetup{linktocpage}}
\AfterFile{hypertex.def}{\hypersetup{linktocpage}}
\usepackage{hyperref}
@@ -313,9 +306,10 @@ und für Pakete \Macro{AfterAtEndOfPackage}.%
\clearpage
\begin{figure}
\caption{Dies ist ein Beispiel mit einer
- Abbildungsunterschrift, die etwas länglich ist
- und bei der trotzdem auf die Verwendung des
- optionalen Arguments verzichtet wurde.}
+ Abbildungsunterschrift, die mehrere Zeile
+ umfasst und bei der trotzdem auf die
+ Verwendung des optionalen Arguments verzichtet
+ wurde.}
\end{figure}
\end{document}
\end{lstcode}
@@ -327,15 +321,21 @@ und für Pakete \Macro{AfterAtEndOfPackage}.%
dass weder die Treiberdatei \File{hdvips.def} noch \File{hypertex.def}
geladen wird.
\end{Example}
-
+\iffalse% Umbruchkorrekturtext (der besser nicht mehr verwendet wird!)
Übrigens\textnote{Tipp!} können Sie das Laden von \Package{scrlfile} und die
-obigen Anweisungen \DescRef{\LabelBase.cmd.AfterFile} auch in Ihre private \File{hyperref.cfg}
-(siehe oben) einfügen. Verwenden Sie dabei jedoch zum Laden des Paketes besser
-\Macro{RequirePackage} an Stelle von \Macro{usepackage} (siehe
-\cite{latex:clsguide}). Die neuen Zeilen müssen in obigem Beispiel unmittelbar
-nach der \Macro{ProvidesFile}-Zeile, also unbedingt vor der Ausführung der
-Optionen \Option{dvips} oder \Option{pdftex}, eingefügt werden.%
-%
+obigen Anweisungen \DescRef{\LabelBase.cmd.AfterFile} auch in Ihre private
+\File{hyperref.cfg} (siehe oben) einfügen. Verwenden Sie dabei jedoch zum
+Laden des Pakets besser \Macro{RequirePackage} anstelle von
+\Macro{usepackage} (siehe \cite{latex:clsguide}). Die neuen Zeilen müssen in
+obigem Beispiel unmittelbar nach der \Macro{ProvidesFile}-Zeile, also
+unbedingt vor der Ausführung der Optionen \Option{dvips} oder \Option{pdftex},
+eingefügt werden.%
+\fi%
+Übrigens\textnote{Tipp!} kann \Package{scrlfile} auch bereits vor
+\DescRef{maincls.cmd.documentclass}\IndexCmd{documentclass} geladen werden. In
+diesem Fall ist allerdings \Macro{RequirePackage}\IndexCmd{RequirePackage}
+anstelle von \DescRef{maincls.cmd.usepackage} zu verwenden (siehe
+\cite{latex:clsguide}).%
\EndIndexGroup
@@ -350,8 +350,8 @@ Problem, dass sie Anweisungen in die \File{aux}-Datei schreiben wollen,
nachdem die letzte Seite des Dokuments ausgegeben wurde. Dazu wird -- in
Unkenntnis der dadurch verursachten Probleme -- häufig Code
wie der folgende eingesetzt:
-\begin{lstcode}
- \AtEndDocument{%
+\begin{lstcode}[escapechar=\$]
+ \AtEndDocument{%$\textnote{Nicht nachmachen!}$
\if@filesw
\write\@auxout{%
\protect\writethistoaux%
@@ -367,8 +367,8 @@ umgekehrte Problem: wurde die letzte Seite bei
\Macro{end}\PParameter{document} noch nicht ausgegeben, so wird
\Macro{writethistoaux} zu früh in die \File{aux}-Datei geschrieben. Man sieht
daher häufig auch Lösungsversuche wie:
-\begin{lstcode}
- \AtEndDocument{%
+\begin{lstcode}[escapechar=\$]
+ \AtEndDocument{%$\textnote{Nicht nachmachen!}$
\if@filesw
\clearpage
\immediate\write\@auxout{%
@@ -378,11 +378,13 @@ daher häufig auch Lösungsversuche wie:
}
\end{lstcode}
Diese Lösung hat jedoch den Nachteil, dass damit die Ausgabe der letzten Seite
-erzwungen wird. Eine Anweisung wie:
+erzwungen wird. Eine Anweisung wie
\begin{lstcode}
\AtEndDocument{%
- \par\vspace*{\fill}%
- Hinweis am Ende des Dokuments.\par
+ \par
+ \vspace*{\fill}%
+ Hinweis am Ende des Dokuments.
+ \par
}
\end{lstcode}
führt dann nicht mehr dazu, dass der Hinweis am Ende der letzten Seite des
@@ -411,7 +413,7 @@ Unkenntnis der oben erläuterten Probleme -- \DescRef{maincls.cmd.clearpage}
innerhalb einer \Macro{AtEndDocument}-Anweisung zum Einsatz kam.
Es gibt jedoch für \Macro{BeforeClosingMainAux} eine Einschränkung: Im
-Argument \Macro{Anweisungen} sollte keine Satzanweisung verwendet
+Argument \PName{Anweisungen} sollte keine Satzanweisung verwendet
werden. Es darf also mit \Macro{BeforeClosingMainAux} kein zusätzliches
Material gesetzt werden! Wird diese Einschränkung nicht beachtet, so ist das
Ergebnis ebenso unvorhersehbarer wie bei den gezeigten Problemen mit
@@ -422,7 +424,7 @@ führt sogar \PName{Anweisungen} nach dem Schließen und Einlesen der
\File{aux}-Datei innerhalb von \Macro{end}\PParameter{document} aus. Dies ist
nur in einigen wenigen, sehr seltenen Fällen sinnvoll, beispielsweise, wenn
man statistische Informationen in die \File{log}-Datei schreiben will, die
-erst nach dem Einlesen der \File{aux}-Datei gültig sind oder zur
+erst nach dem Einlesen der \File{aux}-Datei gültig sind, oder zur
Implementierung zusätzlicher \emph{Rerun}-Aufforderungen. Satzanweisungen sind
an dieser Stelle noch kritischer zu betrachten als bei
\Macro{BeforeClosingMainAux}.%
@@ -450,7 +452,7 @@ alle Dateien aus, die vom Anwender oder intern von \LaTeX{} mit Hilfe von
dass \Package{scrlfile} diese Anweisung umdefiniert.
\begin{Example}
- Sie wollen, dass an Stelle der Datei \File{\Macro{jobname}.aux}, die Datei
+ Sie wollen, dass anstelle der Datei \File{\Macro{jobname}.aux}, die Datei
\File{\Macro{jobname}.xua} geladen wird. Dazu verwenden Sie:
\begin{lstcode}
\ReplaceInput{\jobname.aux}{\jobname.xua}
@@ -487,28 +489,31 @@ der Klasse passen. Eine Lösung dieses Problems finden Sie nachfolgend.
\end{Declaration}
Eine\ChangedAt{v2.96}{\Package{scrlfile}}\textnote{Achtung!} Klasse oder ein
Paket sollte niemals mit Hilfe der oben erklärten Anweisung
-\DescRef{\LabelBase.cmd.ReplaceInput} ersetzt werden. In diesem Fall würde \LaTeX{} eine
-Warnung über nicht übereinstimmende Klassen- oder Paketnamen melden.
+\DescRef{\LabelBase.cmd.ReplaceInput} ersetzt werden. In diesem Fall würde
+\LaTeX{} eine Warnung über nicht übereinstimmende Klassen- oder Paketnamen
+melden. Auch echte Fehler sind möglich, wenn eine Klasse oder ein Paket unter
+einem falschen Dateinamen geladen wird.
\begin{Example}
- Sie ersetzen das Paket \Package{fancyhdr} leichtfertig durch das nicht
- kompatible Paket \Package{scrpage2}, indem Sie
-\begin{lstcode}
- \ReplaceInput{fancyhdr.sty}{scrpage2.sty}
+ Sie ersetzen das Paket \Package{scrpage2} durch dessen offiziellen
+ Nachfolger \Package{scrlayer-scrpage}, indem Sie
+\begin{lstcode}[escapechar=\$]
+ \ReplaceInput{scrpage2.sty}{scrlayer-scrpage.sty}$\textnote{Nicht nachmachen!}$
\end{lstcode}
- verwenden. Dies wird beim Laden von \Package{fancyhdr} zu der Warnung
+ verwenden. Dies wird beim Laden von \Package{scrpage2} zu der Warnung
\begin{lstcode}
LaTeX warning: You have requested `scrpage2',
- but the package provides `fancyhdr'.
+ but the package provides
+ `scrlayer-scrpage'.
\end{lstcode}
führen. Für den Anwender wäre diese Warnung mehr als verwirrend, hat er doch
- gar nicht \Package{scrpage2}, sondern tatsächlich \Package{fancyhdr}
- angefordert, das jedoch durch \Package{scrpage2} ersetzt wurde.
+ gar nicht \Package{scrlayer-scrpage}, sondern tatsächlich \Package{scrpage2}
+ angefordert, das jedoch durch \Package{scrlayer-scrpage} ersetzt wurde.
\end{Example}
-Eine Lösung dieses Problems besteht nun darin, statt \DescRef{\LabelBase.cmd.ReplaceInput} eine
-der Anweisungen \Macro{ReplaceClass} oder \Macro{ReplacePackage} zu
-verwenden. Es ist zu beachten, dass wie bei \Macro{documentclass} und
-\Macro{usepackage} der Name der Klasse oder des Pakets und nicht deren
-kompletter Dateiname anzugeben ist.
+Eine Lösung dieser Probleme besteht nun darin, statt
+\DescRef{\LabelBase.cmd.ReplaceInput} eine der Anweisungen
+\Macro{ReplaceClass} oder \Macro{ReplacePackage} zu verwenden. Es ist zu
+beachten, dass wie bei \Macro{documentclass} und \Macro{usepackage} der Name
+der Klasse oder des Pakets und nicht deren kompletter Dateiname anzugeben ist.
Die Ersetzung funktioniert für Klassen, die mit
\Macro{documentclass}, \Macro{LoadClassWithOptions} oder \Macro{LoadClass}
@@ -520,7 +525,7 @@ Es\textnote{Achtung!} ist zu beachten, dass die \PName{Ersatzklasse} oder das
\PName{Ersatzpaket} mit denselben Optionen geladen wird, mit denen die
ursprünglich geforderte Klasse oder das ursprünglich geforderte Paket geladen
würden. Wird ein Paket oder eine Klasse durch ein Paket oder eine Klasse
-ersetzt, das eine geforderte Option nicht unterstützt, würde dies zu den
+ersetzt, die eine geforderte Option nicht unterstützt, würde das zu den
üblichen Warnungen und Fehlern führen. Es ist jedoch möglich, solche in der
\PName{Ersatzklasse} oder dem \PName{Ersatzpaket} fehlenden Optionen per
\DescRef{\LabelBase.cmd.BeforeClass} oder
@@ -528,7 +533,7 @@ ersetzt, das eine geforderte Option nicht unterstützt, würde dies zu den
\begin{Example}
Angenommen, das Paket \Package{oldfoo} soll beim Laden durch das
- Paket \Package{newfoo} ersetzt werden. Dies wird mit:
+ Paket \Package{newfoo} ersetzt werden. Dies wird mit
\begin{lstcode}
\ReplacePackage{oldfoo}{newfoo}
\end{lstcode}
@@ -539,20 +544,22 @@ ersetzt, das eine geforderte Option nicht unterstützt, würde dies zu den
\DeclareOption{oldopt}{%
\PackageInfo{newfoo}%
{option `oldopt' not supported}%
- }}%
+ }%
+ }%
\end{lstcode}
wird diese Option nun für das Paket \Package{newfoo} nachdefiniert. Dadurch
wird vermieden, dass beim Laden des Pakets \Package{oldfoo} ein Fehler über
die im Paket \Package{newfoo} nicht unterstützte Option gemeldet wird.
- Existiert hingegen eine Option \Option{newopt}, die an Stelle der Option
+ Existiert hingegen eine Option \Option{newopt}, die anstelle der Option
\Option{oldopt} verwendet werden soll, so kann dies ebenfalls erreicht
werden:
\begin{lstcode}
\BeforePackage{newfoo}{%
\DeclareOption{oldopt}{%
\ExecuteOptions{newopt}%
- }}%
+ }%
+ }%
\end{lstcode}
Es ist sogar möglich, festzulegen, dass beim Laden des neuen Pakets
andere Voreinstellung gelten sollen:
@@ -575,11 +582,15 @@ ersetzt, das eine geforderte Option nicht unterstützt, würde dies zu den
\PassOptionsToPackage{newdefoptA,newdefoptB}%
{newfoo}%
\end{lstcode}
+ Man beachte, dass im letzten Beispiel der Aufruf von
+ \Macro{PassOptionsToPackage} nicht innerhalb, sondern erst nach
+ \Macro{BeforePackage} erfolgt.
\end{Example}
-Damit Klassen ersetzt werden können, ist es erforderlich \Package{scrlfile}
-mit Hilfe von \Macro{RequirePackage} vor der Klasse zu laden.
-%
+Damit Klassen ersetzt werden können, ist es natürlich erforderlich
+\Package{scrlfile} vor der Klasse zu laden. Dazu ist
+\Macro{RequirePackage}\IndexCmd{RequirePackage} anstelle von
+\DescRef{maincls.cmd.usepackage} zu verwenden (siehe \cite{latex:clsguide}).%
\EndIndexGroup
@@ -595,7 +606,7 @@ und Ersetzungen von Klassen mit \Macro{UnReplaceClass} aufgehoben werden. Nach
der Aufhebung der Ersetzung führen Ladebefehle für den entsprechenden
\PName{Dateiname}, das entsprechende \PName{Paket} oder die entsprechende
\PName{Klasse} dann wieder dazu, dass die Datei, das Paket oder die Klasse
-selbst an Stelle der Ersatzdatei, des Ersatzpakets oder der Ersatzklasse
+selbst anstelle der Ersatzdatei, des Ersatzpakets oder der Ersatzklasse
geladen wird.%
\EndIndexGroup
@@ -606,8 +617,8 @@ geladen wird.%
Gerade\ChangedAt{v3.08}{\Package{scrlfile}} in Klassen und Paketen, die
innerhalb von Firmen oder Instituten verwendet werden, findet man häufig, dass
sehr viele Pakete nur deshalb geladen werden, weil die Anwender diese Pakete
-oft verwenden. Wenn es dann mit einem dieser automatisch geladenen Paketen
-zu einem Problem kommt, muss man irgendwie das Laden des problematischen Paketes
+oft verwenden. Wenn es dann mit einem dieser automatisch geladenen Paketen zu
+einem Problem kommt, muss man irgendwie das Laden des problematischen Pakets
verhindern. Auch hier bietet \Package{scrlfile} eine einfache Lösung.
\begin{Declaration}
@@ -624,7 +635,7 @@ aufgerufen, so wird das Laden des Pakets effektiv verhindert, falls es in
der \PName{Paketliste} zu finden ist.
%
\begin{Example}
- Angenommen Sie arbeiten in einer Firma, in der alle Dokumente mit
+ Angenommen, Sie arbeiten in einer Firma, in der alle Dokumente mit
Latin~Modern erzeugt werden. In der Firmenklasse, \Class{firmenci}, befinden
sich daher die Zeilen:
\begin{lstcode}
@@ -646,22 +657,23 @@ der \PName{Paketliste} zu finden ist.
Wie im Beispiel zu sehen ist, kann man das Paket \Package{scrlfile} auch
bereits vor der Klasse laden. In diesem Fall muss das Laden dann aber mit
Hilfe von \Macro{RequirePackage}\IndexCmd{RequirePackage} erfolgen, da
-\Macro{usepackage} vor \Macro{documentclass} verboten ist.
+\Macro{usepackage} vor \Macro{documentclass} verboten ist (siehe
+\cite{latex:clsguide}).
-Wird eine leere \PName{Paketliste} angegeben, oder wird ein Paket angegeben,
-das bereits geladen ist, so gibt \Macro{PreventPackageFromLoading} eine
+Wird eine leere \PName{Paketliste} angegeben oder wird ein Paket angegeben,
+das bereits geladen ist, gibt \Macro{PreventPackageFromLoading} eine
Warnung aus, während
\Macro{PreventPackageFromLoading*}\ChangedAt{v3.12}{\Package{scrlfile}}
lediglich einen entsprechenden Hinweis in die Log-Datei schreibt.
Das optionale Argument\ChangedAt{v3.12}{\Package{scrlfile}} kann verwendet
-werden, wenn an Stelle des Ladens des Pakets etwas anderes getan werden
+werden, wenn anstelle des Ladens des Pakets etwas anderes getan werden
soll. Innerhalb des \PName{Stattdessencode}s dürfen jedoch keine anderen
Pakete und keine Dateien geladen werden. Zum Laden eines anderen Pakets siehe
\DescRef{\LabelBase.cmd.ReplacePackage} in \autoref{sec:scrlfile.replace} auf
-\DescPageRef{\LabelBase.cmd.ReplacePackage}. Beachten Sie bitte auch, dass der
-\PName{Stattdessencode} mehrfach ausgeführt wird, falls Sie versuchen, das
-Paket mehrfach zu laden!%
+\DescPageRef{\LabelBase.cmd.ReplacePackage}. Beachten\textnote{Achtung!} Sie
+bitte auch, dass der \PName{Stattdessencode} mehrfach ausgeführt wird, falls
+Sie versuchen, das Paket mehrfach zu laden!%
\EndIndexGroup
@@ -690,7 +702,7 @@ können wieder alle Pakete geladen werden.
\end{lstcode}
Allerdings hat dies den Nachteil, dass ab diesem Zeitpunkt die komplette
Ausnahmeliste des Anwenders verloren ist. Also speichern Sie die Liste
- zunächst zwischen und reaktivieren Sie später wieder:
+ zunächst zwischen und reaktivieren sie später wieder:
\begin{lstcode}
\newcommand*{\Users@PreventList}{}%
\StorePreventPackageFromLoading\Users@PreventList
@@ -712,7 +724,7 @@ Verantwortung für eine korrekte Wiederherstellbarkeit tragen. So muss die
Liste unbedingt mit Komma separiert sein, sollte keine Leerzeichen oder
Gruppenklammern enthalten und muss voll expandierbar sein.%
-Beachten\textnote{Achtung!} Sie bitte auch, dass
+Beachten\textnote{Achtung!} Sie bitte, dass
\Macro{ResetPreventPackageFromLoading} den \PName{Stattdessencode} für ein
Paket nicht löscht, sondern nur vorübergehend dessen Ausführung nicht mehr
erfolgt.%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex
index 6d503beea33..0f9cdc2b523 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlttr2-experts.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlttr2-experts.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% Diese Datei ist Teil der KOMA-Script-Sammlung für LaTeX2e.
%
@@ -48,17 +48,15 @@
% ============================================================================
\KOMAProvidesFile{scrlttr2-experts.tex}%
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-02-01 12:55:46 +0100 (Thu, 01 Feb 2018) $
KOMA-Script guide (chapter: scrlttr2 for experts)]
-\chapter{Zusätzliche Informationen zur
- Briefklasse \Class{scrlttr2} und zum Briefpaket \Package{scrletter}}
+\chapter{Zusätzliche Informationen zur
+ Klasse \Class{scrlttr2} und Paket \Package{scrletter}}
\labelbase{scrlttr2-experts}
-\BeginIndexGroup
-\BeginIndex{Class}{scrlttr2}
-In diesem Kapitel finden Sie zusätzliche Informationen zu der
-\KOMAScript-Klasse \Class{scrlttr2}. %
+\BeginIndexGroup \BeginIndex{Class}{scrlttr2} In diesem Kapitel finden Sie
+zusätzliche Informationen zu der \KOMAScript-Klasse \Class{scrlttr2}. %
\iffree{Einige Teile des Kapitels sind dabei dem \KOMAScript-Buch
\cite{book:komascript} vorbehalten. Dies sollte kein Problem sein, denn
der}{Der} %
@@ -67,12 +65,15 @@ normalerweise nicht benötigen. Ein Teil der Informationen richtet sich an
Anwender, denen die vordefinierten Möglichkeiten nicht mehr genügen. So
befasst sich beispielsweise der erste Abschnitt ausführlich mit den
Pseudolängen, die den Briefbogen bestimmen und die für Anpassungen an eigene
-Briefbogenlayouts abweichend zu setzen sind. Darüber hinaus finden sich in
-diesem Kapitel auch Informationen über Möglichkeiten, die aus Gründen der
-Verbesserung der Kompatibilität zur obsoleten \KOMAScript-Klasse
-\Class{scrlettr} geschaffen wurden. Es wird auch ausführlich erklärt, wie man
-einen Brief dieser veralteten Klasse auf die aktuelle Briefklasse übertragen
-kann.
+Briefbogenlayouts abweichend zu setzen sind.%
+\iffalse% Es wird Zeit das komplett rauszuwerfen!
+\ Darüber hinaus finden
+ sich in diesem Kapitel auch Informationen über Möglichkeiten, die aus
+ Gründen der Verbesserung der Kompatibilität zur obsoleten \KOMAScript-Klasse
+ \Class{scrlettr} geschaffen wurden. Es wird auch ausführlich erklärt, wie
+ man einen Brief dieser veralteten Klasse auf die aktuelle Briefklasse
+ übertragen kann.
+\fi
\BeginIndex{Package}{scrletter}%
Darüber hinaus gibt es seit
@@ -94,14 +95,16 @@ Token, für Boxen, für Zähler, für Abstände (englisch: \emph{skip}) und für
Größen (englisch: \emph{dimension}). Von all diesen Registern gibt es jeweils
256~Stück. Für \LaTeX{}-Längen, die mit \Macro{newlength} angefordert werden,
werden Abstandsregister belegt. Sind alle diese Register verbraucht, kann man
-keine weiteren Längen definieren. Die Briefklasse \Class{scrlttr2} würde
-normalerweise allein für die erste Seite mehr als 20 solche Register
-verbrauchen. \LaTeX{} selbst belegt bereits 40 dieser Register. Das
-\Package{typearea}-Paket benötigt ebenfalls einige, so dass ein Viertel der
-kostbaren Register verbraucht wäre. Aus diesem Grund werden briefspezifische
-Längen in \Class{scrlttr2} eben nicht in Längen, sondern in Makros abgelegt,
-den Pseudolängen. Der Nachteil dieses Vorgehens besteht darin, dass man mit
-diesen Makros nicht so einfach rechnen kann wie mit echten Längen.
+keine weiteren Längen definieren. Sowohl \Class{scrlttr2} als auch
+\Package{scrletter} würden normalerweise allein für die erste Seite mehr als
+20 solche Register verbrauchen. \LaTeX{} selbst belegt bereits 40 dieser
+Register. Das \hyperref[cha:typearea]{\Package{typearea}}%
+\IndexPackage{typearea}-Paket benötigt ebenfalls einige, so dass ein Viertel
+der kostbaren Register verbraucht wäre. Aus diesem Grund werden
+briefspezifische Längen bei \KOMAScript{} eben nicht in Längen, sondern in
+Makros abgelegt, den Pseudolängen. Der Nachteil dieses Vorgehens besteht
+darin, dass man mit diesen Makros nicht so einfach rechnen kann wie mit echten
+Längen.
Bitte beachten\textnote{Achtung!} Sie unbedingt, dass die Pseudolängen zwar
intern als Makros implementiert sind, bei den Befehlen zur Nutzung der
@@ -112,9 +115,10 @@ umgekehrten Schrägstrich geschrieben!
Wer nun einwenden will, dass \LaTeX{} in der empfohlenen und für \KOMAScript{}
benötigten Installation mit \eTeX{} inzwischen das oben genannte
Beschränkungsproblem nicht mehr besitzt, hat Recht. Allerdings kam diese
-Entscheidung für \Class{scrlttr2} ein wenig zu spät.
+Entscheidung für \Class{scrlttr2} ein wenig zu spät. Bei \Package{scrletter}
+wurde das Konzept der Pseudolängen aus Gründen der Kompatibilität übernommen.
-Eine Auf"|listung aller von \Class{scrlttr2} definierten und verwendeten
+Eine Auf"|listung aller von \KOMAScript{} definierten und verwendeten
Pseudolängen ist \autoref{tab:scrlttr2-experts.pseudoLengths} zu
entnehmen. Dabei ist auch angegeben, wo in den nachfolgenden Unterabschnitten
nähere Erklärungen zu der jeweiligen Pseudolänge zu finden
@@ -123,7 +127,7 @@ sind.%|
\autoref{fig:scrlttr2-experts.pseudoLengths} auf
\autopageref{fig:scrlttr2-experts.pseudoLengths} zeigt eine schematische
Darstellung der wichtigsten Abstände auf dem Briefbogen. Dabei sind neben den
-Pseudolängen für die veränderbaren Abständen zusätzlich in heller Schrift auch
+Pseudolängen für die veränderbaren Abstände zusätzlich in heller Schrift auch
die Längen angegeben, die für einige, wenige fest programmierte Abstände
verwendet werden. Aus Gründen der Übersichtlichkeit wurde in der Darstellung
auf einige weniger häufig benötigte Pseudolängen jedoch auch verzichtet.
@@ -132,10 +136,10 @@ auf einige weniger häufig benötigte Pseudolängen jedoch auch verzichtet.
\begin{desclist}
\renewcommand{\abovecaptionskipcorrection}{-\normalbaselineskip}%
\desccaption{%
- Von der Klasse \Class{scrlttr2} verwendete Pseudolängen%
+ Von \Class{scrlttr2} und \Package{scrletter} verwendete Pseudolängen%
\label{tab:scrlttr2-experts.pseudoLengths}%
}{%
- Von der Klasse \Class{scrlttr2} verwendete Pseudolängen
+ Von \Class{scrlttr2} und \Package{scrletter} verwendete Pseudolängen
(\emph{Fortsetzung})%
}%
\pentry{backaddrheight}{%
@@ -175,7 +179,7 @@ auf einige weniger häufig benötigte Pseudolängen jedoch auch verzichtet.
größer der Breite oder kleiner der negativen Breite des Papiers werden
gesondert behandelt (\autoref{sec:scrlttr2-experts.firstHead},
\DescPageRef{scrlttr2-experts.plength.firstheadhpos})%
- }\iffree{}{\enlargethispage*{\baselineskip}}% Umbruchkorrektur!!!
+ }%\iffree{}{\enlargethispage*{\baselineskip}}% Umbruchkorrektur!!!
\pentry{firstheadvpos}{%
Abstand des Briefkopfes von der oberen Kante des Papiers
(\autoref{sec:scrlttr2-experts.firstHead},
@@ -276,7 +280,8 @@ auf einige weniger häufig benötigte Pseudolängen jedoch auch verzichtet.
\DescPageRef{scrlttr2-experts.plength.PPheadheight})%
}%
\pentry{PPheadwidth}{%
- Breite des linken Port-Payé-Feldes bei \OptionValueRef{scrlttr2}{addrfield}{PP}
+ Breite des linken Port-Payé-Feldes bei
+ \OptionValueRef{scrlttr2}{addrfield}{PP}
(\autoref{sec:scrlttr2-experts.addressee},
\DescPageRef{scrlttr2-experts.plength.PPheadwidth})%
}%
@@ -436,7 +441,7 @@ optionales Argument übergeben (siehe auch
\DescPageRef{scrlttr2.cmd.setlengthtoplength}).
Mit \Macro{@addtoplength} kann man zu einer \PName{Pseudolänge} das Vielfache
-von einem \PName{Wert} addieren. Auch dabei wird der \PName{Faktor} als
+eines \PName{Wertes} addieren. Auch dabei wird der \PName{Faktor} als
optionales Argument übergeben.
Um einer \PName{Pseudolänge} das Vielfache einer anderen Pseudolänge
@@ -485,7 +490,7 @@ unterstützt, die nicht in der Vertikalen verschoben werden kann.
\PLength{mfoldmarkvpos}
\PLength{bfoldmarkvpos}
\end{Declaration}
-Die Briefklasse \Class{scrlttr2} kennt insgesamt drei in der vertikalen
+\KOMAScript{} kennt für Briefe \Class{scrlttr2} insgesamt drei in der vertikalen
Platzierung konfigurierbare Faltmarken. Die Position der oberen Faltmarke vom
oberen Papierrand wird von der Pseudolänge \PLength{tfoldmarkvpos}
bestimmt. Für die Position der mittleren Faltmarke ist Pseudolänge
@@ -507,8 +512,8 @@ vordefinierten \File{lco}-Dateien\textnote{\File{lco}-Datei}%
\Index{lco-Datei=\File{lco}-Datei} unterschiedlich gewählt. Eine
Besonderheit\textnote{Achtung!} stellt \Option{DINmtext} dar. Hier wird
zwingend von einem Briefumschlag im Format C6/5 (auch »C6 lang« genannt)
-ausgegangen. Briefe, die mit dieser Option erstellt wurden, sind weder für
-Umschläge im Format C5 noch für Umschläge im Format C4 geeignet.
+ausgegangen. Briefe, die mit dieser Option erstellt wurden, sind normalerweise
+weder für Umschläge im Format C5 noch für Umschläge im Format C4 geeignet.
Die mittlere Faltmarke wird für abendländische Briefe normalerweise nicht
benötigt. Beispielsweise in Japan gibt es jedoch so unterschiedliche
@@ -519,10 +524,11 @@ Sprachkonvention darstellen. Tatsächlich ist nicht festgelegt, dass
\PLength{tfoldmarkvpos} kleiner als \PLength{mfoldmarkvpos} und dieses kleiner
als \PLength{bfoldmarkvpos} sein muss. Ist\textnote{Achtung!} eine der
Pseudolängen hingegen Null, so wird die entsprechende Faltmarke auch dann
-nicht gesetzt, wenn sie per Option
-\DescRef{scrlttr2.option.foldmarks}\IndexOption{foldmarks~=\PName{Einstellung}}\important{\DescRef{scrlttr2.option.foldmarks}}
-(siehe \autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.foldmarks}) explizit aktiviert wurde.%
+nicht gesetzt, wenn sie per Option \DescRef{scrlttr2.option.foldmarks}%
+\IndexOption{foldmarks~=\PName{Einstellung}}%
+\important{\DescRef{scrlttr2.option.foldmarks}} (siehe
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.foldmarks})
+explizit aktiviert wurde.%
%
\EndIndexGroup
@@ -554,8 +560,7 @@ einen Drucker verwenden, der einen breiteren unbedruckbaren linken Rand
hat. Ob die Faltmarken überhaupt gesetzt werden, hängt außerdem von der Option
\DescRef{scrlttr2.option.foldmarks}\important{\DescRef{scrlttr2.option.foldmarks}}%
\IndexOption{foldmarks~=\PName{Einstellung}} ab (siehe
-\autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.foldmarks}).%
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.foldmarks}).%
%
\EndIndexGroup
@@ -585,18 +590,19 @@ einer angegebenen Länge von Null stattdessen 4\Unit{mm} verwendet werden.%
\begin{Declaration}
\PLength{foldmarkvpos}
\end{Declaration}
-Diese\ChangedAt{v2.97e}{\Class{scrlttr2}} Pseudolänge gibt den Abstand aller
-vertikalen Faltmarken vom oberen Papier\-rand an. Normalerweise sind das
-3{,}5\Unit{mm}. Sie\textnote{Tipp!} können den Wert aber auch in Ihrer eigenen
-\File{lco}-Datei ändern, falls Sie einen Drucker verwenden, der einen
-breiteren unbedruckbaren oberen Rand hat. Ob die Faltmarken überhaupt gesetzt
-werden, hängt außerdem von der Option
-\DescRef{scrlttr2.option.foldmarks}\important{\DescRef{scrlttr2.option.foldmarks}}%
-\IndexOption{foldmarks~=\PName{Einstellung}}
-ab (siehe \autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.foldmarks}). Derzeit gibt es nur eine
-einzige vertikale Faltmarke, die als linke vertikale Faltmarke bezeichnet
-wird.%
+Die\ChangedAt{v2.97e}{\Class{scrlttr2}} Pseudolänge gibt den Abstand
+\iffree{aller}{der} vertikalen Faltmarke\iffree{n}{} vom oberen Papier\-rand
+an. Normalerweise sind das 3{,}5\Unit{mm}. Sie\textnote{Tipp!} können den
+Wert aber auch in Ihrer eigenen \File{lco}-Datei ändern, falls Sie einen
+Drucker verwenden, der einen breiteren unbedruckbaren oberen Rand hat. Ob die
+Faltmarke\iffree{n}{} überhaupt gesetzt \iffree{werden}{wird}, hängt außerdem
+von der Option \DescRef{scrlttr2.option.foldmarks}%
+\important{\DescRef{scrlttr2.option.foldmarks}}%
+\IndexOption{foldmarks~=\PName{Einstellung}} ab (siehe
+\autoref{sec:scrlttr2.firstpage},
+\DescPageRef{scrlttr2.option.foldmarks}).\iffree{ Derzeit gibt es nur eine
+ einzige vertikale Faltmarke, die als linke vertikale Faltmarke bezeichnet
+ wird.}{}%
\EndIndexGroup
@@ -620,15 +626,15 @@ geändert wird, kann dies zu wenig sein!%
Unter dem Briefkopf verstehen wir alle Angaben, die den Absender betreffen und
die über der Anschrift stehen. Normalerweise würde man erwarten, dass diese
über den Seitenstil gesetzt werden. Bei der alten Briefklasse \Class{scrlettr}
-war dies auch so. Bei\textnote{Achtung!} \Class{scrlttr2} wird der Briefkopf
-jedoch unabhängig vom Seitenstil von der Anweisung
-\DescRef{scrlttr2.cmd.opening}\IndexCmd{opening} ausgegeben.
+war dies auch so. Bei\textnote{Achtung!} \Class{scrlttr2} und
+\Package{scrletter} wird der Briefkopf jedoch unabhängig vom Seitenstil von
+der Anweisung \DescRef{scrlttr2.cmd.opening}\IndexCmd{opening} ausgegeben.
% Fuellmaterial
\iftrue%
-Dabei wird der Briefkopf absolut positioniert, ist also vom
-Satzspiegel unabhängig. Die erste Seite eines Briefes, also die Seite
-mit dem Briefkopf, wird tatsächlich mit dem Seitenstil \PValue{empty}
-gesetzt.%
+Dabei wird der Briefkopf absolut positioniert, ist also vom Satzspiegel
+unabhängig. Die erste Seite eines Briefes, also die Seite mit dem Briefkopf,
+wird tatsächlich mit dem Seitenstil
+\DescRef{scrlttr2.pagestyle.empty}\IndexPagestyle{empty} gesetzt.%
\fi
% Ende des Fuellmaterials
@@ -686,11 +692,14 @@ erwähnt wurde, kann in den vordefinierten Briefköpfen eine Linie im oder unter
dem Absender gesetzt werden. Hat\textnote{Achtung!} die Pseudolänge
\PLength{fromrulewidth} die Länge 0, so wird dabei die Länge dieser Linie
automatisch bestimmt. Dies ist die Voreinstellung bei den vordefinierten
-\File{lco}-Dateien. Der Wert kann mit \DescRef{\LabelBase.cmd.@setplength}
-(siehe \DescPageRef{scrlttr2-experts.cmd.@setplength}) in eigenen
-\File{lco}-Dateien aber auch abweichend gesetzt werden. Die voreingestellte
-Dicke\ChangedAt{v2.97c}{\Class{scrlttr2}}, \PLength{fromrulethickness}, der
-Linie beträgt 0,4\Unit{pt}.%
+\File{lco}-Dateien. %
+\iffalse % Umbruchkorrekturtext
+Der Wert kann mit \DescRef{\LabelBase.cmd.@setplength} (siehe
+\DescPageRef{scrlttr2-experts.cmd.@setplength}) in eigenen \File{lco}-Dateien
+aber auch abweichend gesetzt werden. %
+\fi%
+Die voreingestellte Dicke\ChangedAt{v2.97c}{\Class{scrlttr2}},
+\PLength{fromrulethickness}, der Linie beträgt 0,4\Unit{pt}.%
\EndIndexGroup
%
\EndIndexGroup
@@ -701,12 +710,20 @@ Linie beträgt 0,4\Unit{pt}.%
\BeginIndexGroup
\BeginIndex{}{Anschrift}%
+% Verschiedene Umbruchvarianten
Unter der Anschrift versteht man normalerweise nur den Namen und die Adresse
-des Empfängers. Als erste Erweiterung zur Anschrift kann die Versandart
-betrachtet werden, die etwa bei Einschreiben oder Infobriefen zur Anwendung
-kommt. Bei Fensterbriefumschlägen wird auch die so genannte Rücksendeadresse
-zur Anschrift gezählt, da sie im Anschriftfenster zu sehen sein wird. Die
-Anschrift folgt unmittelbar auf den Briefkopf.
+des Empfängers. %
+\iffalse%
+Als \iffree{erste }{}Erweiterung zur Anschrift kann die
+Versandart betrachtet werden, die etwa bei \iffree{Einschreiben oder
+}{}Infobriefen zur Anwendung kommt. Bei Fensterbriefumschlägen wird auch die
+sogenannte Rücksendeadresse \iffree{zur Anschrift}{dazu} gezählt, da sie im
+Anschriftfenster zu sehen \iffree{sein wird}{ist}. Die Anschrift folgt
+unmittelbar auf den Briefkopf.%
+\else%
+Aber auch die Versandart, beispielsweise bei Infobriefen, oder die
+Rücksendeadresse werden als Teil des Anschriftfeldes gesetzt.%
+\fi
\begin{Declaration}
@@ -718,13 +735,19 @@ Fensterbriefumschlags vom oberen und vom linken Rand des Papiers an. Sie
werden in den vordefinierten
\File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei}
unterschiedlich eingestellt. Für \PLength{toaddrhpos} gilt außerdem eine
-Besonderheit. Ist\textnote{Achtung!} der Wert negativ, so ist sein Betrag der
-Abstand des Anschriftfeldes vom rechten Rand des
-Papiers. Sie\textnote{Beispiel!} finden dies beispielsweise bei \Option{SN}
-oder \Option{NF}. Am kleinsten ist der Wert \PLength{toaddrvpos} bei
-\Option{DINmtext}. Hier kann es schnell passieren, dass der Briefkopf in das
-Anschriftfenster ragt. Ob das Anschriftfenster überhaupt gesetzt wird, hängt
-von der Option \Option{addrfield} ab (siehe \autoref{sec:scrlttr2.firstpage},
+Besonderheit. Ist\textnote{Achtung!} der Wert \iffree{}{wie bei \Option{SN}
+ oder \Option{NF} }negativ, so ist sein Betrag der Abstand des
+Anschriftfeldes vom rechten Rand des Papiers. %
+\iffree{%
+ Sie\textnote{Beispiele!} finden dies beispielsweise bei \Option{SN} oder
+ \Option{NF}. Am kleinsten ist der Wert \PLength{toaddrvpos} bei
+ \Option{DINmtext}. Hier kann es schnell passieren, dass der Briefkopf in das
+ Anschriftfenster ragt.%
+}{%
+ Große Briefköpfe\textnote{Achtung!} können bei kleinem \PLength{toaddrvpos},
+ beispielsweise bei \Option{DINmtext}, bis in das Anschriftfeld ragen.%
+} Ob das Anschriftfenster überhaupt gesetzt wird, hängt von der Option
+\Option{addrfield} ab (siehe \autoref{sec:scrlttr2.firstpage},
\DescPageRef{scrlttr2.option.addrfield}).%
\EndIndexGroup
@@ -733,10 +756,9 @@ von der Option \Option{addrfield} ab (siehe \autoref{sec:scrlttr2.firstpage},
\PLength{toaddrheight}
\end{Declaration}
Diese Pseudolänge gibt die Höhe des Anschriftfeldes einschließlich der
-Versandart an. Ist keine Versandart angegeben, so wird die Anschrift vertikal
-innerhalb dieses Feldes zentriert. Ist eine Versandart angegeben, so wird die
-Anschrift unterhalb der Versandart vertikal im Rest des Anschriftfeldes
-zentriert.%
+Versandart an. Ob Name und Adresse des Empfängers unter Berücksichtigung der
+Versandart im Anschriftfeld vertikal zentriert werden hängt von Option
+\DescRef{scrlttr2.option.addrfield} ab.%
\EndIndexGroup
@@ -744,15 +766,18 @@ zentriert.%
\PLength{toaddrwidth}
\end{Declaration}
Diese Pseudolänge gibt die Breite des Anschriftfensters an. Diese wird in den
-vordefinierten \File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei} entsprechend der unterschiedlichen Normen
-unterschiedlich eingestellt. Typische Werte liegen zwischen 70\Unit{mm} und
-100\Unit{mm}.
+vordefinierten
+\File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei}
+entsprechend der unterschiedlichen Normen unterschiedlich
+eingestellt. Typische Werte liegen zwischen 70\Unit{mm} und 100\Unit{mm}.
+
\begin{Example}
- Angenommen, Sie haben das Problem, dass Ihr Drucker einen sehr breiten
- unbedruckbaren rechten oder linken Rand von 15\Unit{mm} besitzt. Dadurch
- kann bei Option \Option{SN} der Briefkopf, die Absenderergänzung und die
- Anschrift nicht komplett gedruckt werden. Sie erstellen daher eine neue
- \File{lco}-Datei mit folgendem Inhalt:
+ Angenommen, Sie haben das Problem, dass Ihr Drucker einen \iffree{sehr
+ breiten }{}unbedruckbaren rechten \iffree{oder linken }{}Rand von
+ 15\Unit{mm} besitzt. Dadurch kann bei Option \Option{SN} der Briefkopf, die
+ Absenderergänzung und die Anschrift nicht komplett gedruckt werden. Sie
+ erstellen daher eine neue \iffree{\File{lco}-Datei mit folgendem Inhalt}{Datei
+ \File{SNmmarg.lco}, die Sie anstelle von \Option{SN} verwenden}:
\begin{lstcode}
\ProvidesFile{SNmmarg.lco}
[2002/06/04 v0.1 my own lco]
@@ -763,10 +788,11 @@ unterschiedlich eingestellt. Typische Werte liegen zwischen 70\Unit{mm} und
\@addtoplength{toaddrwidth}{%
\useplength{toaddrhpos}}
\endinput
-\end{lstcode}
- Bis Sie sich einen Drucker mit kleineren Rändern zugelegt haben, verwenden
- Sie dann \Option{SNmmarg} an Stelle von \Option{SN}.
-\end{Example}
+\end{lstcode}%
+ \iffree{ Bis Sie sich einen Drucker mit kleineren Rändern zugelegt haben,
+ verwenden Sie \Option{SNmmarg} anstelle von
+ \Option{SN}.}{}% Umbruchoptimierung
+\end{Example}\vskip-\ht\strutbox% Wegen Beispiel am Ende der Erklärung
%
\EndIndexGroup
@@ -782,21 +808,20 @@ dieser Wert jedoch 0\Unit{pt}.
Bei\textnote{Achtung!} jeder der
Einstellungen\ChangedAt{v3.03}{\Class{scrlttr2}}
-\OptionValueRef{scrlttr2}{addrfield}{PP}\important[i]{%
+\OptionValueRef{scrlttr2}{addrfield}{PP}\important{%
\OptionValueRef{scrlttr2}{addrfield}{PP}\\
\OptionValueRef{scrlttr2}{addrfield}{image}\\
- \begin{tabular}{@{}l@{}}
- \KOption{addrfield}\\
- \quad\PValue{backgroundimage}
- \end{tabular}}\IndexOption{addrfield~=\PValue{PP}},
-\OptionValueRef{scrlttr2}{addrfield}{image}\IndexOption{addrfield~=\PValue{image}} und
+ \OptionValueRef{scrlttr2}{addrfield}{backgroundimage}
+}\IndexOption{addrfield~=\textKValue{PP}},
+\OptionValueRef{scrlttr2}{addrfield}{image}%
+\IndexOption{addrfield~=\textKValue{image}} und
\OptionValueRef{scrlttr2}{addrfield}{backgroundimage}%
-\IndexOption{addrfield~=\PValue{backgroundimage}} (siehe
+\IndexOption{addrfield~=\textKValue{backgroundimage}} (siehe
\autoref{sec:scrlttr2.firstpage},
\DescPageRef{scrlttr2.option.addrfield}) wird beim Wert 0\Unit{pt}
stattdessen ein Einzug von 8\Unit{mm} verwendet. Soll hier tatsächlich kein
Einzug verwendet werden, so kann mit 1\Unit{sp} ein vernachlässigbar kleiner
-Einzug gesetzt werden. Desweiteren wird \PLength{toaddrindent} bei den
+Einzug gesetzt werden. Des Weiteren wird \PLength{toaddrindent} bei den
genannten Einstellungen für \Option{addrfield} auch für den Abstand zum
rechten Rand des Anschriftfensters verwendet.%
\EndIndexGroup
@@ -808,11 +833,10 @@ rechten Rand des Anschriftfensters verwendet.%
Bei Fensterbriefumschlägen wird der Absender häufig in einer kleinen Schrift
einzeilig über der Empfängeradresse ausgegeben. Diese Absenderangabe nennt man
Rücksendeadresse\textnote{Rücksendeadresse}%
-\Index{Ruecksendeadresse=Rücksendeadresse},
-da sie im Anschriftfenster sichtbar ist und der Post bei unzustellbaren
-Briefen für die Rücksendung an den Absender dient. In dieser Adresse muss
-daher auch nur die Information enthalten sein, die zu diesem Zweck notwendig
-ist.
+\Index{Ruecksendeadresse=Rücksendeadresse}, da sie \iffree{im Anschriftfenster
+ sichtbar ist und }{}der Post bei unzustellbaren Briefen für die Rücksendung
+an den Absender dient. In dieser Adresse muss daher auch nur die Information
+enthalten sein, die zur Rücksendung notwendig ist.
Die Höhe, die innerhalb des Anschriftfensters für die Rücksendeadresse zur
Verfügung steht, ist in der Pseudolänge \PLength{backaddrheight} abgelegt. Der
@@ -830,15 +854,15 @@ bestimmt der Anwender mit den Optionen \Option{addrfield} (siehe
\PLength{specialmailrightindent}
\end{Declaration}
Zwischen Rücksendeadresse und Empfängeradresse kann noch eine optionale
-Versandart\Index{Versandart} gesetzt werden. Diese wird genau dann gesetzt,
-wenn die Variable \DescRef{scrlttr2.variable.specialmail} einen Inhalt hat. Die Ausrichtung
-wird mit Hilfe der Pseudolängen \PLength{specialmailindent} und
-\PLength{specialmailrightindent} festgelegt. Diese geben den linken und
-rechten Einzug der Zeile an. In den vordefinierten \File{lco}-Dateien ist
-\PLength{specialmailindent} auf den dehnbaren Wert \Macro{fill} gesetzt,
-während \PLength{specialmailrightindent} auf 1\Unit{em} eingestellt ist. Damit
-wird die Versandart 1\Unit{em} vom rechten Rand des Anschriftfensters
-gesetzt.%
+Versandart\Index{Versandart} gesetzt werden\iffree{. Diese wird genau dann
+ gesetzt}{}, wenn die Variable \DescRef{scrlttr2.variable.specialmail} einen
+Inhalt hat. Die Ausrichtung wird mit Hilfe der Pseudolängen
+\PLength{specialmailindent} und \PLength{specialmailrightindent}
+festgelegt. Diese geben den linken und rechten Einzug der Zeile an. In den
+vordefinierten \File{lco}-Dateien ist \PLength{specialmailindent} auf den
+dehnbaren Wert \Macro{fill} gesetzt, während \PLength{specialmailrightindent}
+auf 1\Unit{em} eingestellt ist. Damit wird die Versandart 1\Unit{em} vom
+rechten Rand des Anschriftfensters gesetzt.%
\EndIndexGroup
@@ -848,26 +872,24 @@ gesetzt.%
\end{Declaration}
Die Pseudolänge \PLength{PPheadheight} gibt bei den beiden
Einstellungen\ChangedAt{v3.03}{\Class{scrlttr2}}
-\OptionValueRef{scrlttr2}{addrfield}{PP}\important[i]{%
+\OptionValueRef{scrlttr2}{addrfield}{PP}\important{%
\OptionValueRef{scrlttr2}{addrfield}{PP}\\
- \begin{tabular}{@{}l@{}}
- \KOption{addrfield}\\
- \quad\PValue{backgroundimage}
- \end{tabular}}\IndexOption{addrfield~=\PValue{PP}} und
+ \OptionValueRef{scrlttr2}{addrfield}{backgroundimage}}%
+\IndexOption{addrfield~=\textKValue{PP}} und
\OptionValueRef{scrlttr2}{addrfield}{backgroundimage}%
-\IndexOption{addrfield~=\PValue{backgroundimage}} die Höhe an, die am Anfang
+\IndexOption{addrfield~=\textKValue{backgroundimage}} die Höhe an, die am Anfang
des Adressfeldes für den Port-Payé-Kopf reserviert wird. Die Pseudolänge
-\PLength{PPheadwidth} wird nur bei \OptionValueRef{scrlttr2}{addrfield}{PP} (siehe
-\autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.addrfield}) verwendet und gibt die Breite
-des linken Feldes des Port-Payé-Kopf mit dem P.\,P.-Logo, der Postleitzahl und
-dem Ort an. Die Breite des rechten Feldes mit dem Code für den Absender und
-der Priorität ist durch die Restbreite bestimmt.
+\PLength{PPheadwidth} wird nur bei \OptionValueRef{scrlttr2}{addrfield}{PP}
+(siehe \autoref{sec:scrlttr2.firstpage},
+\DescPageRef{scrlttr2.option.addrfield}) verwendet und gibt die Breite des
+linken Feldes des Port-Payé-Kopf mit dem P.\,P.-Logo, der Postleitzahl und dem
+Ort an. Die Breite des rechten Feldes mit dem Code für den Absender und der
+Priorität ist durch die Restbreite bestimmt.
Den\textnote{Achtung!} normalerweise voreingestellten Wert von 0\Unit{mm} für
-Pseudolänge \PLength{PPheadheight} ändert \Class{scrlttr2} selbständig in
+Pseudolänge \PLength{PPheadheight} ändert \KOMAScript{} selbstständig in
20,74\Unit{pt}. Den normalerweise voreingestellten Wert von 0\Unit{mm} für
-\PLength{PPheadwidth} ändert \Class{scrlttr2} selbständig in 42\Unit{mm}.%
+\PLength{PPheadwidth} ändert \KOMAScript{} selbstständig in 42\Unit{mm}.%
%
\EndIndexGroup
@@ -879,11 +901,11 @@ Durch\ChangedAt{v3.03}{\Class{scrlttr2}} diese Pseudolänge wird der vertikale
Abstand zwischen dem Port-Payé-Kopf und der Data-Matrix bei
\OptionValueRef{scrlttr2}{addrfield}{PP}%
\important{\OptionValueRef{scrlttr2}{addrfield}{PP}}%
-\IndexOption{addrfield~=\PValue{PP}} (siehe \autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.addrfield}) festgelegt. Den\textnote{Achtung!}
-normalerweise voreingestellten Wert von 0\Unit{mm} ändert \Class{scrlttr2}
-selbständig in 9\Unit{mm}. Die Data-Matrix wird rechtsbündig zum
-Port-Payé-Kopf gesetzt.%
+\IndexOption{addrfield~=\textKValue{PP}} (siehe
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.addrfield})
+festgelegt. Den\textnote{Achtung!} normalerweise voreingestellten Wert von
+0\Unit{mm} ändert \KOMAScript{} selbstständig in 9\Unit{mm}. Die Data-Matrix
+wird rechtsbündig zum Port-Payé-Kopf gesetzt.%
\EndIndexGroup
%
\EndIndexGroup
@@ -894,11 +916,17 @@ Port-Payé-Kopf gesetzt.%
\BeginIndexGroup
\BeginIndex{}{Absenderergaenzung=Absenderergänzung}%
+\iffalse% Umbruchvarianten
Insbesondere bei Geschäftsbriefen reicht der Platz im Briefkopf und im
Seitenfuß oftmals nicht aus, um alle Angaben des Absenders unterzubringen. Für
-die zusätzlichen Informationen wird oft der Platz neben der Anschrift
-genutzt. In dieser Anleitung wird dieses Feld \emph{Absenderergänzung}
-genannt.
+die zusätzlichen Informationen kann der Platz neben der Anschrift
+genutzt werden. In dieser Anleitung wird dieses Feld \emph{Absenderergänzung}
+genannt.%
+\else%
+Reicht der Raum in Briefkopf und Seitenfuß nicht aus, um alle Angaben zum
+Absender unterzubringen, kann der Platz neben der Anschrift als
+\emph{Absenderergänzung} genutzt werden.%
+\fi
\begin{Declaration}
@@ -910,16 +938,16 @@ genannt.
Die Pseudolängen \PLength{locwidth} und
\PLength{locheight}\ChangedAt{v2.97d}{\Class{scrlttr2}} geben die Breite und
Höhe der Absenderergänzung an. Die Pseudolängen \PLength{lochpos} und
-\PLength{locvpos} geben die Abstände von der rechten und der oberen
-Papierkante an. Diese Werte werden in den vordefinierten \File{lco}-Dateien
+\PLength{locvpos} geben die Abstände von der rechten, oberen
+Papierkante an. Die Werte werden in den vordefinierten \File{lco}-Dateien
typischerweise auf 0\Unit{pt} gesetzt. Dieser\textnote{Achtung!} Wert nimmt
eine Sonderstellung ein. Er bedeutet, dass die Werte erst bei
-\DescRef{scrlttr2.cmd.opening}\IndexCmd{opening} an Hand der Breite des
-Papiers, der Breite des Anschriftfensters und des Abstandes des
-Anschriftfensters von der linken und oberen Papierkante gesetzt werden. Dabei
-findet auch die Option \DescRef{scrlttr2.option.locfield} (siehe
+\DescRef{scrlttr2.cmd.opening}\IndexCmd{opening} anhand der Breite des
+Papiers, der Breite des Anschriftfensters, des Abstandes des
+Anschriftfensters von der linken, oberen Papierkante und
+Option \DescRef{scrlttr2.option.locfield} (siehe
\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.locfield})
-Berücksichtigung. Wie\textnote{Achtung!} auch bei \PLength{toaddrhpos} nehmen
+gesetzt werden. Wie\textnote{Achtung!} bei \PLength{toaddrhpos} nehmen
negative Werte für \PLength{lochpos} eine Sonderstellung ein. Es wird dann
statt des Abstandes vom rechten Papierrand der Betrag von \PLength{lochpos}
als Abstand vom linken Papierrand verwendet. Die Bedeutung ist also genau
@@ -936,16 +964,18 @@ umgekehrt zu der bei \PLength{toaddrhpos} (siehe
\BeginIndexGroup
\BeginIndex{}{Geschaeftszeile=Geschäftszeile}%
-Die Geschäftszeile kann auch länger als eine Zeile sein und wird nur gesetzt,
+Die Geschäftszeile kann auch länger als eine Zeile sein. Sie wird nur gesetzt,
wenn mindestens eine der Variablen für die Geschäftszeile nicht leer ist. Es
-werden nur die Felder gesetzt, die nicht leer sind. Um\textnote{Tipp!} ein
-scheinbar leeres Feld zu setzen, muss man der entsprechenden Variablen einen
-scheinbar leeren Inhalt, beispielsweise ein festes Leerzeichen oder
-\Macro{null}, geben. Wird auf die Geschäftszeile verzichtet, so werden an
-ihrer Stelle Bezeichnung und Inhalt der Variablen \DescRef{scrlttr2.variable.date}
-ausgegeben. Informationen, wie Variablen zur Geschäftszeile hinzugefügt oder
-entfernt werden, sind in \autoref{sec:scrlttr2-experts.variables},
-\DescPageRef{scrlttr2-experts.cmd.removereffields} zu finden.
+werden nur nicht leere Felder gesetzt. Um\textnote{Tipp!} ein scheinbar leeres
+Feld zu setzen, kann man einen scheinbar leeren Variableninhalt wie
+\Macro{mbox}\Parameter{} verwenden. Wird auf die Geschäftszeile verzichtet, so
+werden an ihrer Stelle Bezeichnung und Inhalt der Variablen
+\DescRef{scrlttr2.variable.date} ausgegeben. %
+\iffalse% Umbruchoptimierung
+Informationen, wie Variablen zur Geschäftszeile hinzugefügt oder entfernt
+werden, sind in \autoref{sec:scrlttr2-experts.variables},
+\DescPageRef{scrlttr2-experts.cmd.removereffields} zu finden.%
+\fi
\begin{Declaration}
@@ -953,8 +983,10 @@ entfernt werden, sind in \autoref{sec:scrlttr2-experts.variables},
\end{Declaration}
Diese Pseudolänge gibt den Abstand der Geschäftszeile von der Oberkante des
Papiers an. Ihr Wert wird in den vordefinierten \File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei}
-unterschiedlich eingestellt. Typische Werte liegen zwischen 80{,}5\Unit{mm}
-und 98{,}5\Unit{mm}.%
+unterschiedlich eingestellt. %
+\iffalse%
+Typische Werte liegen zwischen 80{,}5\Unit{mm} und 98{,}5\Unit{mm}.%
+\fi%
\EndIndexGroup
@@ -965,20 +997,31 @@ und 98{,}5\Unit{mm}.%
Die Pseudolänge \PLength{refwidth} gibt die Breite an, die für die
Geschäftszeile zur Verfügung steht. Ihr Wert wird in den vordefinierten
\File{lco}-Dateien typischerweise auf 0\Unit{pt}
-gesetzt. Dieser\textnote{Achtung!} Wert hat eine besondere Bedeutung. Es wird
-damit keineswegs festgelegt, dass für die Geschäftszeile keine Breite zur
-Verfügung steht. Vielmehr bedeutet der Wert, dass die verfügbare Breite erst
-innerhalb von \DescRef{scrlttr2.cmd.opening}\IndexCmd{opening} ermittelt wird. Die dort
-ermittelte Breite richtet sich dann nach der Einstellung der Option
+gesetzt. Dieser\textnote{Achtung!} Wert hat eine besondere Bedeutung. %
+\iffalse% Umbruchoptimierung
+Es wird damit keineswegs festgelegt, dass für die Geschäftszeile keine Breite
+zur Verfügung steht. Vielmehr bedeutet der Wert%
+\else%
+Damit wird festgelegt%
+\fi%
+, dass die verfügbare Breite erst innerhalb von
+\DescRef{scrlttr2.cmd.opening}\IndexCmd{opening} ermittelt wird. Die%
+\iffalse% Umbruchoptimierung
+\ dort ermittelte %
+\else%
+se %
+\fi%
+Breite richtet sich \iffree{dann }{}nach der Einstellung der Option
\DescRef{scrlttr2.option.refline}\important{\DescRef{scrlttr2.option.refline}}%
\IndexOption{refline~=\PName{Einstellung}} (siehe
\autoref{sec:scrlttr2.firstpage},
\DescPageRef{scrlttr2.option.refline}). Gleichzeitig wird dann auch
\PLength{refhpos} entsprechend der Option gesetzt. Bei
-\OptionValueRef{scrlttr2}{refline}{wide}\IndexOption{refline~=\PValue{wide}} wird die
-Geschäftszeile zentriert, wohingegen sie bei
-\OptionValueRef{scrlttr2}{refline}{narrow}\IndexOption{refline~=\PValue{narrow}} am
-Satzspiegel links ausgerichtet wird.
+\OptionValueRef{scrlttr2}{refline}{wide}%
+\IndexOption{refline~=\textKValue{wide}} wird die Geschäftszeile zentriert,
+wohingegen sie bei \OptionValueRef{scrlttr2}{refline}{narrow}%
+\IndexOption{refline~=\textKValue{narrow}} am Satzspiegel links ausgerichtet
+wird.
Ist \PLength{refwidth} von Null verschieden, wird die Breite der
Geschäftszeile also nicht von der Option \DescRef{scrlttr2.option.refline}
@@ -995,7 +1038,7 @@ In der Regel werden diese Sonderfälle für die häufigsten Anwendungen von
geringem Interesse sein. Die\textnote{Tipp!} einfachste Regel lautet hier:
Entweder wird \PLength{refwidth} auf Null belassen und die Breite und
Ausrichtung der Geschäftszeile über die Option
-\DescRef{scrlttr2.option.refline} bestimmt, oder sowohl \PLength{refwidth} als
+\DescRef{scrlttr2.option.refline} bestimmt oder sowohl \PLength{refwidth} als
auch \PLength{refhpos} werden vom Anwender vorgegeben.%
\EndIndexGroup
@@ -1004,8 +1047,9 @@ auch \PLength{refhpos} werden vom Anwender vorgegeben.%
\PLength{refaftervskip}
\end{Declaration}
Diese Pseudolänge gibt den vertikalen Abstand an, der nach der Geschäftszeile
-eingefügt werden soll. Der Wert wird in den vordefinierten \File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei}
-eingestellt. Er wirkt sich unmittelbar auf die Höhe des Textbereiches der
+eingefügt werden soll. Der Wert wird in den vordefinierten
+\File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei}
+eingestellt. Er wirkt sich unmittelbar auf die Höhe des Textbereichs der
ersten Seite aus. Der typische Wert liegt zwischen einer und zwei Zeilen.%
\EndIndexGroup
%
@@ -1061,13 +1105,12 @@ steht, damit Überschneidungen mit anderen Elementen unwahrscheinlich sind.
\ChangedAt{v3.01}{\Class{scrlttr2}}%
Wird der Betreff nicht absolut platziert, sondern vor oder nach der Anrede, so
kann vor und nach dem Betreff ein zusätzlicher Abstand eingefügt werden. Der
-Abstand vor dem Betreff trifft dabei ggf. mit anderen Abständen, etwa dem
-automatischen Abstand von einer Zeile nach dem Titel, zusammen. In der
-Voreinstellung wird daher in der Regel kein weiterer Abstand an dieser Stelle
-eingefügt. Der Abstand nach dem Betreff beträgt in der Voreinstellung der
-Klasse hingegen zwei Zeilen.%
-\EndIndexGroup
-\EndIndexGroup
+Abstand vor dem Betreff trifft dabei gegebenenfalls mit anderen Abständen,
+etwa dem automatischen Abstand von einer Zeile nach dem Titel, zusammen. In
+der Voreinstellung wird daher in der Regel kein weiterer Abstand an dieser
+Stelle eingefügt. Der Abstand nach dem Betreff beträgt in der Voreinstellung
+von Klasse und Paket zwei Zeilen.%
+\EndIndexGroup \EndIndexGroup
\subsection{Schlussgruß}
@@ -1097,6 +1140,14 @@ Zwischen Grußfloskel und Erläuterung wird ein vertikaler Abstand eingefügt,
der mit der Pseudolänge \PLength{sigbeforevskip} festgelegt ist. In den
vordefinierten \File{lco}-Dateien ist der Wert auf zwei Zeilen eingestellt. In
diese Lücke setzen Sie dann Ihre Unterschrift.%
+\iffalse% Umbruchkorrekturtext
+\ Sollten\textnote{Tipp!} Sie sich dazu entschließen in die Variable
+\DescRef{scrlttr2.variable.signature}\IndexVariable{signature}%
+\important{\DescRef{scrlttr2.variable.signature}} mit Paket
+\Package{graphicx}\IndexPackage{graphicx} ein Faksimile Ihrer Unterschrift
+einzufügen, wäre es also sinnvoll den Wert von \PLength{sigbeforevskip} und
+damit die Lücke zwischen Schlussgruß und Signatur zu verringern.%
+\fi%
\EndIndexGroup
%
\EndIndexGroup
@@ -1109,9 +1160,14 @@ diese Lücke setzen Sie dann Ihre Unterschrift.%
Die erste Seite eines Briefes, der Briefbogen, enthält nicht nur einen eigenen
Kopf, den Briefkopf. Diese Seite enthält auch einen eigenen
-Fuß\Index{Fuss=Fuß}. Auch dieser wird nicht über den Seitenstil, sondern
-direkt von \DescRef{scrlttr2.cmd.opening}\IndexCmd{opening}\important{\DescRef{scrlttr2.cmd.opening}}
-ausgegeben.
+Fuß\Index{Fuss=Fuß}, den Briefbogenfuß. %
+\iftrue% Umbruchvarianten
+Auch dieser wird nicht über den Seitenstil%
+\else%
+Genau wie der Briefkopf wird der Briefbogenfuß nicht über den Seitenstil%
+\fi%
+, sondern unmittelbar von \DescRef{scrlttr2.cmd.opening}\IndexCmd{opening}%
+\important{\DescRef{scrlttr2.cmd.opening}} ausgegeben.
\begin{Declaration}
@@ -1120,15 +1176,16 @@ ausgegeben.
Diese Pseudolänge gibt den Abstand des Fußes der ersten Briefseite von der
Oberkante des Papiers an. Es wird außerdem dafür gesorgt, dass der Textbereich
nicht in den Fuß hineinragt. Hierzu wird auf der ersten Seite gegebenenfalls
-die Höhe des Textbereiches mit Hilfe von
+die Höhe des Textbereichs mit Hilfe von
\Macro{enlargethispage}\IndexCmd{enlargethispage}%
\important{\Macro{enlargethispage}} verkleinert. Mit Hilfe der Option
-\DescRef{scrlttr2.option.enlargefirstpage}\important{\DescRef{scrlttr2.option.enlargefirstpage}} (siehe
+\DescRef{scrlttr2.option.enlargefirstpage}%
+\important{\DescRef{scrlttr2.option.enlargefirstpage}} (siehe
\autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.enlargefirstpage}) kann dafür gesorgt
-werden, dass die Höhe des Textbereiches umgekehrt gegebenenfalls auch
-vergrößert wird. Damit kann dann der Abstand zwischen Textbereich und Fuß der
-ersten Seite auf den Wert der Länge
+\DescPageRef{scrlttr2.option.enlargefirstpage}) kann dafür gesorgt werden,
+dass die Höhe des Textbereichs umgekehrt gegebenenfalls auch vergrößert
+wird. Damit kann dann der Abstand zwischen Textbereich und Fuß der ersten
+Seite auf den Wert der Länge
\Length{footskip}\IndexLength{footskip}\important{\Length{footskip}}
verringert werden.
@@ -1149,7 +1206,7 @@ Option \DescRef{scrlttr2.option.enlargefirstpage} abhängig.
Sollte der Briefbogenfuß mittels Option
\OptionValueRef{scrlttr2}{firstfoot}{false}%
\important{\OptionValueRef{scrlttr2}{firstfoot}{false}}%
-\IndexOption{firstfoot~=\PValue{false}}\ChangedAt{v2.97e}{\Class{scrlttr2}}
+\IndexOption{firstfoot~=\textKValue{false}}\ChangedAt{v2.97e}{\Class{scrlttr2}}
(siehe \autoref{sec:scrlttr2.firstpage},
\DescPageRef{scrlttr2.option.firstfoot}) abgeschaltet sein, so wird die
Einstellung von \PLength{firstfootvpos} ignoriert und stattdessen
@@ -1198,7 +1255,7 @@ Briefbogens, an. Der Wert stimmt in den vordefinierten \File{lco}-Dateien mit
\BeginIndex{}{Variablen}
Neben der Möglichkeit, vordefinierte Variablen zu verwenden, bietet
-\Class{scrlttr2} auch Anweisungen, um neue Variablen zu definieren oder deren
+\KOMAScript{} auch Anweisungen, um neue Variablen zu definieren oder deren
automatische Verwendung innerhalb der Geschäftszeile zu beeinflussen.
@@ -1217,14 +1274,14 @@ zuzugreifen. Vielmehr ist die \PName{Bezeichnung} eine Ergänzung zum Inhalt
einer Variable, die ähnlich ihrem Inhalt ausgegeben werden kann.
Mit der Anweisung \Macro{addtoreffields} kann die Variable \PName{Name} der
-Geschäftszeile\Index{Geschaeftszeile=Geschäftszeile} (siehe
-\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.refline})
-hinzugefügt werden. Dabei wird die \PName{Bezeichnung} und der Inhalt der
-Variablen an das Ende der Geschäftszeile angehängt, falls ihr Inhalt nicht
-leer ist. Die Sternvariante \Macro{newkomavar*} entspricht der Variante ohne
-Stern mit anschließendem Aufruf der Anweisung \Macro{addtoreffields}. Bei der
-Sternvariante wird die Variable also automatisch zur Geschäftszeile
-hinzugefügt.
+Geschäftszeile\Index{Geschaeftszeile=Geschäftszeile}\textnote{Geschäftszeile}
+(siehe \autoref{sec:scrlttr2.firstpage},
+\DescPageRef{scrlttr2.option.refline}) hinzugefügt werden. Dabei wird die
+\PName{Bezeichnung} und der Inhalt der Variablen an das Ende der
+Geschäftszeile angehängt, falls ihr Inhalt nicht leer ist. Die Sternvariante
+\Macro{newkomavar*} entspricht der Variante ohne Stern mit anschließendem
+Aufruf der Anweisung \Macro{addtoreffields}. Bei der Sternvariante wird die
+Variable also automatisch zur Geschäftszeile hinzugefügt.
\begin{Example}
Angenommen, Sie benötigen in der Geschäftszeile ein zusätzliches Feld
für eine Durchwahl. Sie können das Feld dann wahlweise mit
@@ -1253,15 +1310,15 @@ selbst definierten Variablen aus der Geschäftszeile entfernt.
Das\textnote{Achtung!} Datum sollte der Geschäftszeile nicht über die
Anweisung \Macro{addtoreffields} hinzugefügt werden. Stattdessen stellt man
-mit Option
-\Option{date}\important[i]{\OptionValueRef{scrlttr2}{refline}{dateleft}\\
+mit Option \DescRef{scrlttr2.option.refline}%
+\important{\OptionValueRef{scrlttr2}{refline}{dateleft}\\
\OptionValueRef{scrlttr2}{refline}{dateright}\\
\OptionValueRef{scrlttr2}{refline}{nodate}}%
-\IndexOption{refline~=\PValue{dateleft}}%
-\IndexOption{refline~=\PValue{dateright}}%
-\IndexOption{refline~=\PValue{nodate}} ein, ob das Datum links, rechts oder
-gar nicht in der Geschäftszeile erscheinen soll. Diese Optionen haben darüber
-hinaus auch einen Einfluss auf die Position des Datums, wenn gar keine
+\IndexOption{refline~=\textKValue{dateleft}}%
+\IndexOption{refline~=\textKValue{dateright}}%
+\IndexOption{refline~=\textKValue{nodate}} ein, ob das Datum links, rechts oder
+gar nicht in der Geschäftszeile erscheinen soll. Diese Einstellungen haben
+darüber hinaus auch einen Einfluss auf die Position des Datums, wenn gar keine
Geschäftszeile verwendet wird.%
%
\EndIndexGroup
@@ -1272,14 +1329,15 @@ Geschäftszeile verwendet wird.%
\Macro{usekomavar*}\OParameter{Anweisung}\Parameter{Name}
\end{Declaration}
Die Anweisungen \DescRef{scrlttr2.cmd.usekomavar} und
-\DescRef{scrlttr2.cmd.usekomavar*} sind wie alle Anweisungen, von denen
-es eine Sternvariante gibt oder die ein optionales Argument besitzen, nicht
-voll expandierbar. Bei Verwendung innerhalb von
+\DescRef{scrlttr2.cmd.usekomavar*} sind wie alle Anweisungen, von denen es
+eine Sternvariante gibt oder die ein optionales Argument besitzen, nicht voll
+expandierbar. Bei Verwendung innerhalb von
\DescRef{scrlttr2.cmd.markboth}\IndexCmd{markboth},
\DescRef{scrlttr2.cmd.markright}\IndexCmd{markright} oder ähnlichen
Anweisungen muss dennoch kein \Macro{protect}\IndexCmd{protect} vorangestellt
werden. Selbstverständlich gilt dies bei Verwendung von
-\Package{scrlayer-scrpage} auch für
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage} auch für
\DescRef{scrlayer-scrpage.cmd.markleft}\IndexCmd{markleft} (siehe
\autoref{sec:scrlayer-scrpage.pagestyle.content},
\DescPageRef{scrlayer-scrpage.cmd.markleft}). Allerdings\textnote{Achtung!}
@@ -1317,96 +1375,15 @@ funktionieren.
\EndIndexGroup
-\section{Unterschiede bei den Seitenstilen von \Package{scrletter}}
+\section{Ergänzende Informationen zu den Seitenstilen}
\seclabel{pagestyleatscrletter}
\BeginIndexGroup
\BeginIndex{}{Seiten>Stil}
-In \autoref{sec:scrlttr2.pagestyle} wurde dokumentiert, dass beim Seitenstil
-\PageStyle{headings} der Inhalt der Variablen
-\DescRef{scrlttr2.variable.nexthead} und \DescRef{scrlttr2.variable.nextfoot}
-den Kopf und Fuß der Seite bestimmt. Da dieser Seitenstil bei den
-\KOMAScript-Klassen bereits anderweitig vordefiniert ist, definiert
-\Package{scrletter} ein neues Seitenstil-Paar mit Hilfe von
-\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} (siehe
-\autoref{sec:scrlayer-scrpage-experts.pagestyle.pairs},
-\autopageref{sec:scrlayer-scrpage-experts.pagestyle.pairs}).
-
-Durch diese interne Verwendung von \Package{scrlayer-scrpage} können die
-veralteten Pakete \Package{scrpage2}\IndexPackage{scrpage2} und
-\Package{scrpage} oder das mit \KOMAScript{} wenig kompatible Paket
-\Package{fancyhdr}\IndexPackage{fancyhdr} nicht zusammen mit
-\Package{scrletter} verwendet werden. Darüber hinaus wird durch das interne
-Laden von \Package{scrlayer-scrpage} automatisch der Seitenstil
-\PageStyle{scrheadings}\IndexPagestyle{scrheadings} aktiviert. Dies führt
-dazu, dass die Seitenstile \PageStyle{headings} und \PageStyle{plain} der
-verwendeten Klasse Aliase von \PageStyle{scrheadings} und
-\PageStyle{plain.scrheadings} werden und somit der Kontrolle von
-\Package{scrlayer-scrpage} unterstehen.
-
-\begin{Declaration}
- \PageStyle{letter}
- \PageStyle{plain.letter}
- \DescRef{scrlttr2.variable.nexthead}
- \DescRef{scrlttr2.variable.nextfoot}
-\end{Declaration}
-Das Seitenstil-Paar\ChangedAt{v3.15}{\Package{scrletter}} \PageStyle{letter}
-wird bei \Package{scrletter} mit Hilfe von \Package{scrlayer-scrpage}
-definiert, um unabhängig von den Seitenstilen der Klasse zu sein. Dabei werden
-die Variablen \DescRef{scrlttr2.variable.nexthead} und
-\DescRef{scrlttr2.variable.nextfoot} für \PageStyle{letter} so verwendet, wie
-dies in \autoref{sec:scrlttr2.pagestyle} für den Seitenstil
-\PageStyle{headings} dokumentiert ist. Der zugehörige
-\PageStyle{plain}-Seitenstil entspricht ebenfalls weitgehend dem Seitenstil
-\PageStyle{plain} von \Class{scrlttr2}. Insbesondere wird die Seitenzahl
-entsprechend Option
-\DescRef{scrlttr2.option.pagenumber}\IndexOption{pagenumber} (siehe
-\DescPageRef{scrlttr2.option.pagenumber}) platziert.%
+\LoadNonFree{scrlttr2-experts}{0}%
\EndIndexGroup
-
-\begin{Declaration}
- \Option{headsepline}
- \Option{footsepline}
-\end{Declaration}
-Die bei \Class{scrlttr2} vorhandenen Optionen
-\Option{headsepline}\important[i]{\Option{headsepline}\\\Option{footsepline}}
-und \Option{footsepline} gehorchen bei \Package{scrletter} den Regeln von
-\Package{scrlayer-scrpage}. Dies betrifft insbesondere das Setzen der Linien
-in Kopf und Fuß des \PageStyle{plain}-Seitenstils
-\PageStyle{plain.letter}. Siehe dazu
-\autoref{sec:scrlayer-scrpage.pagestyle.content},
-\DescPageRef{scrlayer-scrpage.option.headsepline} und
-\DescPageRef{scrlayer-scrpage.option.plainheadsepline}.%
-\EndIndexGroup
-
-
-\begin{Declaration}
- \Macro{pagemark}
- \Macro{letterpagemark}
-\end{Declaration}
-Da bereits die \KOMAScript-Klassen \Macro{pagemark} definieren und verwenden
-und daher eine Umdefinierung durch \Package{scrletter} nicht nur die
-Paginierung der Briefe, sondern alle Paginierungen betreffen würde, kann
-\Package{scrletter} der Seitenzahl nicht einfach bereits beim Laden via
-\Macro{pagename}\IndexCmd{pagename} den Terminus »Seite«
-voranstellen. Stattdessen\ChangedAt{v3.17}{\Package{scrletter}} definiert es
-\Macro{letterpagemark} entsprechend und setzt \Macro{pagemark} innerhalb von
-\Macro{begin}\PParameter{letter} nur für die Dauer des Briefs auf die
-Definition von \Macro{letterpagemark}. Will man daher \Macro{pagemark} sowohl
-für das normale Dokument als auch für die Briefe umdefinieren, so sollte man
-nach der normalen Umdefinierung von \Macro{pagemark} noch
-\begin{lstcode}
- \let\letterpagemark\pagemark
-\end{lstcode}
-ergänzen. Diese Anweisung stört im übrigen auch nicht, wenn man später auf die
-Briefklasse \Class{scrlttr2} umstellt, die \Macro{letterpagemark} weder kennt
-noch verwendet.%
-\EndIndexGroup
-%
-\EndIndexGroup
-
-
+\iffalse% Wurde bereits in Kapitel 4.21 behandelt
\section{Unterschiede in der Behandlung von \File{lco}-Dateien bei
\Package{scrletter}}
\seclabel{lcoatscrletter}
@@ -1416,7 +1393,8 @@ noch verwendet.%
In\ChangedAt{v3.15}{\Package{scrletter}} \autoref{sec:scrlttr2.lcoFile} wurde
erklärt, dass man \File{lco}-Dateien direkt über \Macro{documentclass} laden
-kann. Für \Package{scrletter} wurde auf diese Möglichkeit verzichtet.
+kann. Für \Package{scrletter}\OnlyAt{\Package{scrlttr2}} wurde auf diese
+Möglichkeit verzichtet.
\begin{Declaration}
\Macro{LoadLetterOption}\Parameter{Name}
@@ -1431,6 +1409,8 @@ erst nach \Package{scrletter} geladen werden.
\EndIndexGroup
%
\EndIndexGroup
+%
+\fi
\section{\File{lco}-Dateien für fortgeschrittene Anwender}
@@ -1439,24 +1419,25 @@ erst nach \Package{scrletter} geladen werden.
\BeginIndex{File}{lco}
\BeginIndex{}{lco-Datei=\File{lco}-Datei}
-\BeginIndexGroup
+\BeginIndexGroup%
\BeginIndex{}{Papier>Format}%
-Obwohl jedes von \Package{typearea} einstellbare Format verwendbar ist, kann
-es bei der Ausgabe der ersten Briefseite mit manchen Formaten zu unerwünschten
-Ergebnissen kommen. Das liegt aber nicht am Konzept der Klasse, sondern daran,
-dass derzeit hauptsächlich Parametersätze für ISO A4 existieren. Leider gibt
-es keine allgemein gültigen Regeln, um die Position von Anschriftfeldern und
-Ähnlichem für beliebige Papierformate zu berechnen. Es ist jedoch möglich,
-auch für andere Papierformate Parametersätze zu erstellen.%
-
+Obwohl jedes von \hyperref[cha:typearea]{\Package{typearea}}%
+\IndexPackage{typearea} einstellbare Format verwendbar ist, kann es bei der
+Ausgabe der ersten Briefseite mit manchen Formaten zu unerwünschten
+Ergebnissen kommen. Leider gibt es
+keine allgemein gültigen Regeln, um die Position von Anschriftfeldern und
+Ähnlichem für beliebige Papierformate zu berechnen. Vielmehr werden für
+unterschiedliche Papierformate unterschiedliche Parameter benötigt.%
-\subsection{Überwachung des Papierformats}
-\seclabel{papersize}
+%\subsection{Überwachung des Papierformats}
+%\seclabel{papersize}
Derzeit existieren Parametersätze und \File{lco}-Dateien für A4-Papier und
letter-Papier. Die Klasse \Class{scrlttr2} versteht aber theoretisch sehr viel
mehr Papierformate. Daher ist es notwendig zu überwachen, ob die korrekte
-Papiergröße eingestellt ist.
+Papiergröße eingestellt ist. Dies gilt umso mehr, wenn \Package{scrletter}
+verwendet wird, da die Einstellung der Papiergröße dann in erster Linie von
+der verwendeten Klasse abhängt.
\begin{Declaration}
\Macro{LetterOptionNeedsPapersize}%
@@ -1472,15 +1453,15 @@ wird dabei der Name der \File{lco}-Datei ohne die Endung »\File{.lco}«
Werden nacheinander mehrere \File{lco}-Dateien geladen, so kann jede dieser
\File{lco}-Dateien eine Anweisung \Macro{LetterOptionNeedsPapersize}
-enthalten. Innerhalb von \DescRef{scrlttr2.cmd.opening}\IndexCmd{opening} wird jedoch nur auf
-die jeweils letzte angegebene \PName{Papiergröße} geprüft. Wie das
-nachfolgende Beispiel zeigt, ist es daher für den versierten Anwender leicht
-möglich, \File{lco}-Dateien mit Parametersätzen für andere Papierformate zu
-schreiben.
+enthalten. Innerhalb von \DescRef{scrlttr2.cmd.opening}\IndexCmd{opening} wird
+jedoch nur auf die jeweils letzte angegebene \PName{Papiergröße} geprüft. Wie
+das nachfolgende Beispiel zeigt, ist es daher für den versierten Anwender
+leicht möglich, \File{lco}-Dateien mit Parametersätzen für andere
+Papierformate zu schreiben. %
\iffalse% Umbruchoptimierung!!!
-Wer allerdings nicht vor hat, selbst solche \File{lco}-Dateien zu
-schreiben, der kann die Erklärung zu dieser Anweisung gleich wieder vergessen
-und auch das Beispiel überspringen.
+Wer allerdings nicht vor hat, selbst solche \File{lco}-Dateien zu schreiben,
+der kann die Erklärung zu dieser Anweisung gleich wieder vergessen und auch
+das Beispiel überspringen.%
\fi
\begin{Example}
Nehmen wir einmal an, dass Sie A5-Papier in normaler Ausrichtung, also
@@ -1509,15 +1490,18 @@ und auch das Beispiel überspringen.
»\File{a5.lco}«, angegeben werden.
\end{Example}
%
-\EndIndexGroup
-\EndIndexGroup
+\EndIndexGroup%
+\EndIndexGroup%
+\vskip-\ht\strutbox% Wegen Beispiel am Ende der Erklärung
-\subsection{Positionen sichtbar machen}
-\seclabel{visualize}
-\BeginIndexGroup
-\BeginIndex{Option}{visualize}
-
+%\subsection{Positionen sichtbar machen}
+%\seclabel{visualize}
+%\BeginIndexGroup
+\begin{Declaration}
+ \File{visualize.lco}
+\end{Declaration}
+\BeginIndex{Option}{visualize}%
Wenn man selbst \File{lco}-Dateien entwickelt, beispielsweise um die
Positionen von verschiedenen Feldern des Briefbogens an eigene Wünsche oder
Notwendigkeiten anzupassen, ist es hilfreich, wenn zumindest einige Elemente
@@ -1536,10 +1520,10 @@ gehören.
\begin{Declaration}
\Macro{showfields}\Parameter{Feldliste}
\end{Declaration}
-Mit dieser Anweisung kann die Visualisierung von Feldern des Briefbogens
-aktiviert werden. Das Argument \PName{Feldliste} ist dabei eine durch Komma
-separierte Liste der Feldern, die visualisiert werden sollen. Folgende Felder
-werden derzeit unterstützt:
+Mit dieser Anweisung kann bei Verwendung von \File{visualize.lco} die
+Visualisierung von Feldern des Briefbogens aktiviert werden. Das Argument
+\PName{Feldliste} ist dabei eine durch Komma separierte Liste der Feldern, die
+visualisiert werden sollen. Folgende Felder werden derzeit unterstützt:
\begin{labeling}[~--]{\PValue{location}}
\item[\PValue{test}] ist ein Testfeld der Größe 10\Unit{cm} auf 15\Unit{cm},
das jeweils 1\Unit{cm} vom oberen und linken Papierrand entfernt ist. Dieses
@@ -1555,7 +1539,7 @@ werden derzeit unterstützt:
nach unten offenes Feld.
\end{labeling}%
\BeginIndex{FontElement}{field}\LabelFontElement{field}%
-Mit Hilfe der Anweisungen \DescRef{scrlttr2.cmd.setkomafont} und
+Mit den Anweisungen \DescRef{scrlttr2.cmd.setkomafont} und
\DescRef{scrlttr2.cmd.addtokomafont} (siehe \autoref{sec:scrlttr2.textmarkup},
\DescPageRef{scrlttr2.cmd.setkomafont}) für das Element
\FontElement{field}\important{\FontElement{field}} kann die Farbe der
@@ -1566,23 +1550,22 @@ Visualisierung geändert werden. Voreingestellt ist \Macro{normalcolor}.%
\begin{Declaration}
- \Macro{setshowstyle}\Parameter{Visualisierungsstil}
+ \Macro{setshowstyle}\Parameter{Stil}
\Macro{edgesize}
\end{Declaration}
-In der Voreinstellung werden die einzelnen Felder durch
-Begrenzungslinien\important{\PValue{frame}} markiert. Dies entspricht dem
-\PName{Visualisierungsstil} \PValue{frame}. Nach unten offene Felder werden
-dabei nicht komplett umrahmt, sondern unten offen mit kleinen Pfeilen nach
-unten dargestellt. Als Alternative\important{\PValue{rule}} hierzu steht auch
-der \PName{Visualisierungsstil} \PValue{rule} zur Verfügung. Dabei wird das
-Feld farbig hinterlegt. Hierbei kann nicht zwischen geschlossenen und nach
-unten offenen Feldern unterschieden werden. Stattdessen werden nach unten
-offene Felder mit einer Mindesthöhe dargestellt. Der
-dritte\important{\PValue{edges}} verfügbare \PName{Visualisierungsstil} ist
-\PValue{edges}. Dabei werden die Ecken der Felder markiert. Bei nach unten
-offenen Feldern entfallen dabei die unteren Eckmarkierungen. Die Größe der
-Eckmarkierungen ist im Makro \Macro{edgesize} abgelegt und mit 1\Unit{ex}
-voreingestellt.
+In der Voreinstellung werden von \File{visualize.lco} die einzelnen Felder
+durch Rahmen\important{\PValue{frame}} markiert. Dies entspricht dem
+\PName{Stil} \PValue{frame}. Nach unten offene Felder werden dabei nicht
+komplett umrahmt, sondern unten offen mit kleinen Pfeilen nach unten
+dargestellt. Als Alternative\important{\PValue{rule}} hierzu steht auch der
+\PName{Stil} \PValue{rule} zur Verfügung. Dabei wird das Feld farbig
+hinterlegt. Hierbei kann nicht zwischen geschlossenen und nach unten offenen
+Feldern unterschieden werden. Stattdessen werden nach unten offene Felder mit
+einer Mindesthöhe dargestellt. Der dritte\important{\PValue{edges}} verfügbare
+\PName{Stil} ist \PValue{edges}. Dabei werden die Ecken der Felder
+markiert. Bei nach unten offenen Feldern entfallen dabei die unteren
+Eckmarkierungen. Die Größe der Eckmarkierungen ist im Makro \Macro{edgesize}
+abgelegt und mit 1\Unit{ex} voreingestellt.%
\EndIndexGroup
@@ -1595,22 +1578,22 @@ voreingestellt.
\Macro{showUScheck}\OParameter{Zusatz}
\Macro{unitfactor}
\end{Declaration}
-Diese Anweisungen dienen dazu eine Seite mit einer Zeichnung eines Umschlags
-auszugeben. Der Umschlag wird dabei immer um 90° gedreht auf einer eigenen
-Seite im Maßstab~1:1 ausgegeben. Das Anschriftfenster wird automatisch aus den
-aktuellen Daten für die Anschriftposition auf dem Briefbogen:
-\PLength{toaddrvpos}, \PLength{toaddrheight}, \PLength{toaddrwidth} und
-\PLength{toaddrhpos}, erzeugt. Hierfür ist es notwendig zu wissen, um welchen
-Wert der gefaltete Briefbogen auf jeder Seite kleiner als die
-\PName{Breite} und \PName{Höhe} des Briefbogens ist. Sind diese beiden Werte,
-\PName{HOffset} und \PName{VOffset}, bei \Macro{showenvelope} nicht angegeben,
-so wird versucht, sie aus den Faltmarken und der Papiergröße selbst zu
-berechnen.
+Diese Anweisungen dienen bei Verwendung von \File{visualize.lco} dazu, eine
+Seite mit einer Zeichnung eines Umschlags auszugeben. Der Umschlag wird dabei
+immer um 90° gedreht auf einer eigenen Seite im Maßstab~1:1 ausgegeben. Das
+Anschriftfenster wird automatisch aus den aktuellen Daten für die
+Anschriftposition auf dem Briefbogen: \PLength{toaddrvpos},
+\PLength{toaddrheight}, \PLength{toaddrwidth} und \PLength{toaddrhpos},
+erzeugt. Hierfür ist es notwendig zu wissen, um welchen Wert der gefaltete
+Briefbogen auf jeder Seite kleiner als die \PName{Breite} und \PName{Höhe} des
+Briefbogens ist. Sind diese beiden Werte, \PName{HOffset} und \PName{VOffset},
+bei \Macro{showenvelope} nicht angegeben, so wird versucht, sie aus den
+Faltmarken und der Papiergröße selbst zu berechnen.
Die Anweisungen \Macro{showISOenvelope}, \Macro{showUScommercial} und
\Macro{showUScheck} basieren auf \Macro{showenvelope}. Mit
\Macro{showISOenvelope} kann ein ISO-Umschlag im \PName{Format} C4, C5, C5/6,
-DL (auch bekannt als C5/6) oder C6 erzeugt werden. Mit
+DL\iffree{ (auch bekannt als C5/6)}{} oder C6 erzeugt werden. Mit
\Macro{showUScommercial} wird hingegen ein US-Commercial-Umschlag im
\PName{Format} 9 oder 10 ausgegeben. \Macro{showUScheck} schließlich ist für
Umschläge im US-Check-Format zuständig.
@@ -1642,7 +1625,7 @@ mit \Macro{renewcommand} möglich.%
\begin{Example}
Es wird ein Beispielbrief im Format ISO~A4 erzeugt. Die unterstützten Felder
sollen zwecks Überprüfung ihrer Position mit gelben Rahmenlinien markiert
- werden. Desweiteren soll die Position des Fensters in einem Umschlag der
+ werden. Des Weiteren soll die Position des Fensters in einem Umschlag der
Größe~DL mit Hilfe einer Zeichnung überprüft werden. Die Maßlinien in dieser
Zeichnung sollen rot und die Maßzahlen in kleinerer Schrift ausgegeben
werden, wobei die Maßzahlen in cm mit einer Genauigkeit von 1\Unit{mm}
@@ -1695,12 +1678,12 @@ Implementierungsgrenzen.
\section{Unterstützung verschiedener Sprachen}
\seclabel{languages}%
-\BeginIndexGroup
+\BeginIndexGroup%
\BeginIndex{}{Sprachen}%
-Die Klasse \Class{scrlttr2} unterstützt viele Sprachen. Dazu zählen Deutsch
-(\PValue{german} für alte deutsche Rechtschreibung, \PValue{ngerman} für neue
-deutsche Rechtschreibung, \PValue{austrian} für Österreichisch mit alter
-deutscher Rechtschreibung und
+Die Klasse \Class{scrlttr2} und das Paket \Package{scrletter} unterstützen
+viele Sprachen. Dazu zählen Deutsch (\PValue{german} für alte deutsche
+Rechtschreibung, \PValue{ngerman} für neue deutsche Rechtschreibung,
+\PValue{austrian} für Österreichisch mit alter deutscher Rechtschreibung und
\PValue{naustrian}\ChangedAt{v3.09}{\Class{scrlttr2}} für Österreichisch mit
neuer deutscher Rechtschreibung),
\PValue{nswissgerman}\ChangedAt{v3.13}{\Class{scrlttr2}} für Schweizer Deutsch
@@ -1715,13 +1698,13 @@ Polnisch\ChangedAt{v3.13}{\Class{scrlttr2}},
Tschechisch\ChangedAt{v3.13}{\Class{scrlttr2}} und Slowakisch.
Zwischen den Sprachen wird bei Verwendung des
-\Package{babel}-Paketes\IndexPackage{babel} (siehe \cite{package:babel}) mit
+\Package{babel}-Pakets\IndexPackage{babel} (siehe \cite{package:babel}) mit
der Anweisung \Macro{selectlanguage}\Parameter{Sprache} gewechselt. Andere
Pakete wie \Package{german}\IndexPackage{german} (siehe \cite{package:german})
und \Package{ngerman}\IndexPackage{ngerman} (siehe \cite{package:ngerman})
besitzen diese Anweisung ebenfalls. In der Regel erfolgt eine
-Sprachumschaltung jedoch bereits aufgrund des Ladens eines solchen Paketes.
-\iftrue% Umbruchkorrekturtext!!!
+Sprachumschaltung jedoch bereits aufgrund des Ladens eines solchen Pakets.
+\iffalse% Umbruchkorrekturtext!!!
Näheres entnehmen Sie bitte der jeweiligen Anleitung.
\fi
@@ -1733,27 +1716,25 @@ Sprachumschaltpaketen. Das Paket
\autopageref{tab:scrlttr2-experts.languageTerms} weitere Änderungen vor. So
definiert es etwa die Anweisung \DescRef{scrlttr2.cmd.opening} um. Dabei geht
es einfach davon aus, dass \DescRef{scrlttr2.cmd.opening} immer wie in der
-Standardbriefklasse \Class{letter} definiert ist. Dies ist bei
-\Class{scrlttr2} jedoch nicht der Fall. Das Paket \Package{french} zerstört
-deshalb die Definition aus \Class{scrlttr2} und arbeitet nicht korrekt mir
-\KOMAScript{} zusammen. Ich betrachte dies als Fehler des Paketes
-\Package{french}.
+Standardbriefklasse \Class{letter} definiert ist. Dies ist bei \KOMAScript{}
+jedoch nicht der Fall. Das Paket \Package{french} zerstört deshalb die
+Definition und arbeitet nicht korrekt mir \KOMAScript{} zusammen. Ich
+betrachte dies als Fehler des Pakets \Package{french}, der obwohl schon vor
+Jahrzehnten gemeldet, leider nie beseitigt wurde.
Wird das Paket \Package{babel}\IndexPackage{babel} für die
-Umschaltung auf die Sprache \PValue{french} verwendet und ist gleichzeitig das
-Paket \Package{french} installiert, so ergeben sich eventuell genau dieselben
-Probleme, weil in diesem Fall Teile des Paketes \Package{french} verwendet
-werden.
-%
-\iftrue
- % Umbruchergänzungstext
- Ist das Paket \Package{french} nicht installiert, ergibt sich das Problem
+Umschaltung auf die Sprache verwendet, können vereinzelt ebenfalls
+Probleme auftreten. Bei \Package{babel} lassen sich problematisch Änderungen
+einer Sprache jedoch meist gezielt abschalten.%
+\iffalse% Das ist eigentlich überholt!
+\ Ist das Paket \Package{french} nicht installiert, ergibt sich das Problem
mit \Package{babel} nicht. Ebenfalls existiert das Problem normalerweise
- nicht, wenn man bei \Package{babel} an Stelle der Sprache \PValue{french}
+ nicht, wenn man bei \Package{babel} anstelle der Sprache \PValue{french}
eine der Sprachen \PValue{acadian}, \PValue{canadien} oder \PValue{francais}
verwendet.
\fi
+\iffalse% Das ist ebenfalls überholt!
Mit Babel ab Version 3.7j tritt dieses Problem jedoch nur noch auf, wenn per
Option explizit angegeben wird, dass \Package{babel} das
\Package{french}-Paket verwenden soll.
@@ -1776,12 +1757,13 @@ Option explizit angegeben wird, dass \Package{babel} das
\space bei \Package{babel} die Option \Option{frenchb}.%
\fi
\fi
+\fi
\iftrue
- \enlargethispage*{\baselineskip}%
+ %\enlargethispage*{\baselineskip}%
Es ist nicht auszuschließen, dass mit anderen Sprachen und Paketen ähnliche
Probleme auf"|treten.
- \iffalse
+% \iffalse
\iftrue
Für Deutsch sind solche Probleme jedoch nicht bekannt und treten weder
mit den Paketen \Package{german}\IndexPackage{german} oder
@@ -1792,9 +1774,46 @@ Option explizit angegeben wird, dass \Package{babel} das
\Package{ngerman}\IndexPackage{ngerman} oder \Package{babel} jedoch nicht
auf.
\fi
- \fi
+% \fi
\fi
+% Hinweis: Der folgende Block kann je nach Umbruch vor oder nach
+% \captions... und \date... (aber bitte nicht dazwischen) stehen.
+\begin{Declaration}
+ \Macro{yourrefname}
+ \Macro{yourmailname}
+ \Macro{myrefname}
+ \Macro{customername}
+ \Macro{invoicename}
+ \Macro{subjectname}
+ \Macro{ccname}
+ \Macro{enclname}
+ \Macro{headtoname}
+ \Macro{headfromname}
+ \Macro{datename}
+ \Macro{pagename}
+ \Macro{mobilephonename}
+ \Macro{phonename}
+ \Macro{faxname}
+ \Macro{emailname}
+ \Macro{wwwname}
+ \Macro{bankname}
+\end{Declaration}
+Die aufgeführten Anweisungen enthalten die jeweiligen sprachtypischen
+Begriffe. Diese\important[i]{%
+ \DescRef{scrbase.cmd.newcaptionname}\\
+ \DescRef{scrbase.cmd.renewcaptionname}\\
+ \DescRef{scrbase.cmd.providecaptionname}} können für die Realisierung einer
+weiteren Sprache oder aber auch zur eigenen freien Gestaltung wie in
+\autoref{sec:scrbase.languageSupport} erklärt angepasst werden. Von
+\KOMAScript{} werden die Begriffe erst nach der Präambel, also bei
+\Macro{begin}\PParameter{document} gesetzt. Sie sind daher vorher nicht
+verfügbar und können vorher auch nicht geändert werden. In
+\autoref{tab:scrlttr2-experts.languageTerms},
+\autopageref{tab:scrlttr2-experts.languageTerms} sind die Voreinstellungen
+für \Option{english} und \Option{ngerman} zu finden.%
+\EndIndexGroup
+%\iffree{}{\clearpage}% Siehe Kommentar zur Tabelle
\begin{Declaration}
\Macro{captionsacadian}
@@ -1832,7 +1851,58 @@ Anweisungen die Begriffe aus \autoref{tab:scrlttr2-experts.languageTerms},
verwendete Sprachumschaltpaket dies nicht unterstützen, so können obige
Anweisungen notfalls auch direkt verwendet werden.%
%
+\begin{table}%
+ \begin{minipage}{\textwidth}
+% \centering
+ \KOMAoptions{captions=topbeside}%
+ \setcapindent{0pt}%
+ %\caption
+ \begin{captionbeside}[{%
+ Voreinstellungen für die sprachabhängigen Begriffe%
+ }]{%
+ Voreinstellungen
+ für die sprachabhängigen Begriffe bei \iffalse Verwendung der \else
+ den \fi Sprachen
+ \Option{english} und \Option{ngerman} soweit nicht durch die Pakete
+ zur Sprachumschaltung bereits definiert%
+ \label{tab:scrlttr2-experts.languageTerms}%
+ }[l]
+ \begin{tabular}[t]{lll}
+ \toprule
+ Anweisung & \Option{english} & \Option{ngerman} \\
+ \midrule
+ \Macro{bankname} & Bank account & Bankverbindung \\
+ \Macro{ccname}\footnotemark[1] & cc & Kopien an \\
+ \Macro{customername} & Customer no. & Kundennummer \\
+ \Macro{datename} & Date & Datum \\
+ \Macro{emailname} & Email & E-Mail \\
+ \Macro{enclname}\footnotemark[1] & encl & Anlagen \\
+ \Macro{faxname} & Fax & Fax \\
+ \Macro{headfromname} & From & Von \\
+ \Macro{headtoname}\footnotemark[1] & To & An \\
+ \Macro{invoicename} & Invoice no. & Rechnungsnummer \\
+ \Macro{myrefname} & Our ref. & Unser Zeichen \\
+ \Macro{pagename}\footnotemark[1] & Page & Seite \\
+ \Macro{mobilephonename} & Mobile phone & Mobiltelefon \\
+ \Macro{phonename} & Phone & Telefon \\
+ \Macro{subjectname} & Subject & Betrifft \\
+ \Macro{wwwname} & Url & URL \\
+ \Macro{yourmailname} & Your letter of & Ihr Schreiben vom\\
+ \Macro{yourrefname} & Your ref. & Ihr Zeichen \\
+ \bottomrule
+ \end{tabular}
+ \deffootnote{1em}{1em}{1\ }% brutal aber effektiv
+ \footnotetext[1000]{Diese Begriffe werden normalerweise bereits von
+ Sprachpaketen wie \Package{babel} definiert und dann von
+ \KOMAScript{} nicht überschrieben. Abweichungen im Wortlaut sind
+ daher möglich und der Anleitung des verwendeten Sprachpakets zu
+ entnehmen.}
+ \end{captionbeside}
+ \end{minipage}
+\end{table}
+%
\EndIndexGroup
+\iffree{}{\clearpage}% Umbruchkorrektur
\begin{Declaration}
@@ -1867,12 +1937,15 @@ Anweisungen notfalls auch direkt verwendet werden.%
\end{Declaration}
Je nach verwendeter Sprache werden auch die Datumsangaben\Index{Datum} des
nummerischen Datums (siehe Option \DescRef{scrlttr2.option.numericaldate} in
-\autoref{sec:scrlttr2.firstpage},
-\DescPageRef{scrlttr2.option.numericaldate}) in unterschiedlicher Form
-umgesetzt. Die genauen Angaben können der \autoref{tab:date} entnommen
-werden.%
+\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.numericaldate})
+in unterschiedlicher Form umgesetzt. Die genauen Angaben können
+\autoref{tab:date}, \autopageref{tab:date} entnommen werden.%
+\EndIndexGroup
%
-\begin{table}
+\EndIndexGroup
+\iffree{}{\clearpage}% Umbruchkorrektur zwecks Ausgabe der Tabellen
+
+\begin{table}[!tp]% Umbruchoptimierung
% \centering
\KOMAoptions{captions=topbeside}%
\setcapindent{0pt}%
@@ -1916,97 +1989,14 @@ werden.%
\label{tab:date}
\end{table}
%
-\EndIndexGroup
-
-\clearpage% Umbruchoptimierung
+\section{Obsolete Anweisungen von \Class{scrlttr2}}
+\seclabel{obsolete}
+\BeginIndexGroup
-\begin{Declaration}
- \Macro{yourrefname}
- \Macro{yourmailname}
- \Macro{myrefname}
- \Macro{customername}
- \Macro{invoicename}
- \Macro{subjectname}
- \Macro{ccname}
- \Macro{enclname}
- \Macro{headtoname}
- \Macro{headfromname}
- \Macro{datename}
- \Macro{pagename}
- \Macro{mobilephonename}
- \Macro{phonename}
- \Macro{faxname}
- \Macro{emailname}
- \Macro{wwwname}
- \Macro{bankname}
-\end{Declaration}
-Die aufgeführten Anweisungen enthalten die jeweiligen sprachtypischen
-Begriffe. Diese können für die Realisierung einer weiteren Sprache oder aber
-auch zur eigenen freien Gestaltung wie\important[i]{%
- \DescRef{scrbase.cmd.newcaptionname}\\
- \DescRef{scrbase.cmd.renewcaptionname}\\
- \DescRef{scrbase.cmd.providecaptionname}} in
-\autoref{sec:scrbase.languageSupport} erklärt angepasst werden. Von
-\Class{scrlttr2} werden die Begriffe erst nach der Präambel, also bei
-\Macro{begin}\PParameter{document} gesetzt. Sie sind daher vorher nicht
-verfügbar und können vorher auch nicht geändert werden. In
-\autoref{tab:scrlttr2-experts.languageTerms} sind die Voreinstellungen für
-\Option{english} und \Option{ngerman} zu finden.%
-%
-\begin{table}
- \begin{minipage}{\textwidth}
-% \centering
- \KOMAoptions{captions=topbeside}%
- \setcapindent{0pt}%
- %\caption
- \begin{captionbeside}[{%
- Voreinstellungen für die sprachabhängigen Begriffe%
- }]{%
- Voreinstellungen
- für die sprachabhängigen Begriffe bei Verwendung der Sprachen
- \Option{english} und \Option{ngerman} soweit nicht durch die Pakete
- zur Sprachumschaltung bereits definiert%
- \label{tab:scrlttr2-experts.languageTerms}%
- }[l]
- \begin{tabular}[t]{lll}
- \toprule
- Anweisung & \Option{english} & \Option{ngerman} \\
- \midrule
- \Macro{bankname} & Bank account & Bankverbindung \\
- \Macro{ccname}\footnotemark[1] & cc & Kopien an \\
- \Macro{customername} & Customer no. & Kundennummer \\
- \Macro{datename} & Date & Datum \\
- \Macro{emailname} & Email & E-Mail \\
- \Macro{enclname}\footnotemark[1] & encl & Anlagen \\
- \Macro{faxname} & Fax & Fax \\
- \Macro{headfromname} & From & Von \\
- \Macro{headtoname}\footnotemark[1] & To & An \\
- \Macro{invoicename} & Invoice no. & Rechnungsnummer \\
- \Macro{myrefname} & Our ref. & Unser Zeichen \\
- \Macro{pagename}\footnotemark[1] & Page & Seite \\
- \Macro{mobilephonename} & Mobile phone & Mobiltelefon \\
- \Macro{phonename} & Phone & Telefon \\
- \Macro{subjectname} & Subject & Betrifft \\
- \Macro{wwwname} & Url & URL \\
- \Macro{yourmailname} & Your letter of & Ihr Schreiben vom\\
- \Macro{yourrefname} & Your ref. & Ihr Zeichen \\
- \bottomrule
- \end{tabular}
- \deffootnote{1em}{1em}{1\ }% brutal aber effektiv
- \footnotetext[1000]{Diese Begriffe werden normalerweise bereits von
- Sprachpaketen wie \Package{babel} definiert und dann von
- \Class{scrlttr2} nicht überschrieben. Abweichungen im Wortlaut sind
- daher möglich und der Anleitung des verwendeten Sprachpakets zu
- entnehmen.}
- \end{captionbeside}
- \end{minipage}
-\end{table}
-%
+\LoadNonFree{scrlttr2-experts}{1}
\EndIndexGroup
%
-\EndIndexGroup
-
-
+\iffalse% Es wird Zeit das komplett rauszuwerfen!
\section{Von der obsoleten \Class{scrlettr} zur
aktuellen \Class{scrlttr2}}
\seclabel{fromscrlettr}
@@ -2015,20 +2005,9 @@ aktuellen \Class{scrlttr2}}
Die\textnote{Achtung!} alte Briefklasse \Class{scrlettr} wurde mit Einführung
von \Class{scrlttr2} (siehe \autoref{cha:scrlttr2}) 2002
-obsolet. \Class{scrlettr} sollte für neue Briefe besser nicht mehr verwendet
-werden. Die Klasse wird nicht mehr weiterentwickelt und es findet daher auch
-kein Support mehr dafür statt. Wer dennoch unbedingt die Anleitung zur alten
-Briefklasse benötigt, kann diese in \File{scrlettr.dtx} finden. Am besten
-führt man dazu einige \LaTeX-Läufe mit jener Datei durch, also beispielsweise:
-\begin{lstoutput}[morekeywords={latex,mkindex}]
- latex scrlettr.dtx
- mkindex scrlettr
- latex scrlettr.dtx
- mkindex scrlettr
- latex scrlettr.dtx
-\end{lstoutput}
-Man erhält so die Datei \File{scrlettr.dvi} mit der Anleitung. Wer stattdessen
-\File{scrlettr.pdf} haben möchte, ersetzt \File{latex} durch \File{pdflatex}.
+obsolet und ist auch nicht mehr Bestandteil von \KOMAScript{}. Wer die Klasse
+oder Informationen dazu dennoch benötigt, findet sie in
+\cite{package:koma-script-obsolete}.
Um den Umstieg von der alten auf die neue Klasse zu erleichtern, existiert mit
\Option{KOMAold} eine Kompatibilitätseinstellung. Grundsätzlich ist in der
@@ -2037,9 +2016,10 @@ ist jedoch die Benutzerschnittstelle eine andere und auch die Voreinstellungen
stimmen nicht überein. Näheres dazu ist \autoref{sec:scrlttr2.lcoFile},
\autoref{tab:lcoFiles} zu entnehmen.
-\LoadNonFree{scrlttr2-experts}{0}
+\LoadNonFree{scrlttr2-experts}{2}
%
\EndIndexGroup
+\fi
%
\EndIndexGroup
@@ -2057,11 +2037,7 @@ stimmen nicht überein. Näheres dazu ist \autoref{sec:scrlttr2.lcoFile},
% LocalWords: Sternvariante Geschäftszeile Testfeld Kopfbereich Vergleichsmaß
% LocalWords: Dokumenterstellungsprozess Fußbereich Anschriftfenster Falt
% LocalWords: Absenderergänzung Kundennummer Rechnungsnummer Falzmarken
-
-
-
-
-
-
-% LocalWords: Sprachumschaltpaketen Standardbriefklasse Seitenstilen
-% LocalWords: Paginierung Paginierungen
+% LocalWords: Sprachumschaltpaketen Standardbriefklasse Seitenstilen
+% LocalWords: Paginierung Paginierungen Papiergröße Anschriftfeldes
+% LocalWords: Versandart Anschriftfensters Anschriftfeld Briefköpfe
+% LocalWords: Variableninhalt Schlussgruß Briefbogenfuß
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex
index b0bd6764c1b..f8d676bfcd1 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlttr2.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlttr2.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,29 +46,51 @@
% ============================================================================
\KOMAProvidesFile{scrlttr2.tex}%
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-02-13 09:46:41 +0100 (Tue, 13 Feb 2018) $
KOMA-Script guide (chapter: scrlttr2)]
-\chapter{Die Briefklasse \Class{scrlttr2}}
+\chapter{Briefe mit Klasse \Class{scrlttr2} oder Paket \Package{scrletter}}
\labelbase{scrlttr2}
\BeginIndexGroup
-\BeginIndex{Class}{scrlttr2}\BeginIndex{}{Briefe}%
-\iffalse
-Seit der Ausgabe vom Juni 2002 beinhaltet \KOMAScript{} eine komplett
-neue Briefklasse\ChangedAt{v2.8q}{\Class{scrlttr2}}. Obwohl einige
-Teile davon mit den Klassen aus \autoref{cha:maincls}
-übereinstimmen, sind Briefe doch
-\else
-Briefe sind in vielerlei Hinsicht
-\fi
-etwas ganz anderes als Artikel, Berichte, Bücher oder Ähnliches. Schon allein
-deshalb gibt es für die Briefklasse ein eigenes Kapitel. Aber auch aus einem
-anderen Grund ist ein eigenes Kapitel für \Class{scrlttr2} gerechtfertigt. Die
-Klasse wurde von Grund auf neu entwickelt. Sie hat daher auch ein komplett
-anderes Bedienkonzept als alle anderen mir bekannten Klassen. Die neue
-Art der Bedienung ist möglicherweise etwas ungewohnt, bietet jedoch
-nicht nur dem geübten Anwender einige Vorteile.
+\BeginIndex{Class}{scrlttr2}\BeginIndex{Package}{scrletter}%
+\BeginIndex{}{Briefe}%
+Briefe sind in vielerlei Hinsicht etwas ganz anderes als Artikel, Berichte,
+Bücher oder Ähnliches. Schon allein deshalb gibt es für Briefe ein eigenes
+Kapitel. Aber auch aus weiteren Gründen ist ein eigenes Kapitel für
+\Class{scrlttr2} und \Package{scrletter} gerechtfertigt.
+
+Die Klasse \Class{scrlttr2}\important{\Class{scrlttr2}} wurde 2002 von Grund
+auf neu entwickelt. Sie hat daher auch ein komplett anderes Bedienkonzept als
+alle übrigen mir bekannten Klassen. Die neue Art der Bedienung ist
+möglicherweise etwas ungewohnt, bietet jedoch nicht nur dem geübten Anwender
+einige Vorteile.
+
+Das Paket \Package{scrletter}\important{\Package{scrletter}}%
+\ChangedAt{v3.15}{\Package{scrletter}} wiederum verstärkt \KOMAScript{} seit
+Version 3.15. Es stellt die gesamte auf Briefe ausgelegte Funktionalität von
+\Class{scrlttr2} auch für andere Klassen bereit. Empfohlen wird die Verwendung
+mit einer der \KOMAScript-Klassen \Class{scrbook}, \Class{scrreprt} oder
+\Class{scrartcl}, die im vorherigen Kapitel erklärt sind. Mit geringfügigen
+Einschränkungen funktioniert \Package{scrletter} aber auch mit den
+Standardklassen.
+
+Ausgangspunkt für die Entwicklung von \Package{scrletter} waren einerseits
+Nachfragen von Anwendern, die Elemente wie
+Gliederungsüberschriften,\textnote{Überschriften, Gleitumgebungen,
+ Verzeichnisse} Gleitumgebungen oder ein Literaturverzeichnis auch in Briefen
+haben wollten. Umgekehrt gab es auch Wünsche nach der Verwendung der Variablen
+von \Class{scrlttr2} in den übrigen \KOMAScript-Klassen. Beides ist durch eine
+Kombination der gewünschten \KOMAScript-Klasse mit \Package{scrletter}
+möglich.
+
+Gegenüber der Briefklasse hat das Briefpaket einige, kleine Änderungen, die
+notwendig waren, um Konflikte mit den anderen Klassen zu vermeiden. Diese
+betreffen vor allem die Seitenstile und sind explizit dokumentiert (siehe
+\autoref{sec:\LabelBase.pagestyle}, ab
+\autopageref{sec:\LabelBase.pagestyle}). Wo \Package{scrletter} nicht explizit
+erwähnt ist, gilt dafür alles, was für \Class{scrlttr2} dokumentiert ist, ohne
+Änderung.
\section{Variablen}
@@ -82,32 +104,35 @@ eingeführt. Eine typische Eigenschaft eines Elements ist seine Schriftart und
die Möglichkeit, diese zu ändern (siehe \autoref{sec:\LabelBase.textmarkup},
\DescPageRef{\LabelBase.cmd.setkomafont}). An dieser Stelle werden nun
zusätzlich Variablen eingeführt. Variablen haben einen
-Namen\Index{Variablen>Name}, über den sie angesprochen werden und einen
-Inhalt\Index{Variablen>Inhalt}. Der Inhalt einer Variablen kann zeitlich
-bzw. räumlich getrennt von ihrer Verwendung gesetzt werden, so wie der Inhalt
-einer Anweisung getrennt von ihrer Ausführung definiert werden kann. Ein
-Hauptunterschied einer Variablen zu einer Anweisung besteht darin, dass eine
-Anweisung normalerweise eine Aktion auslöst, während der Inhalt einer
-Variablen normalerweise aus einem Text besteht, der dann von einer Anweisung
-ausgegeben wird. Außerdem kann eine Variable zusätzlich eine
-Bezeichnung\Index{Variablen>Bezeichnung} besitzen, die ebenfalls gesetzt und
-ausgegeben werden kann.
+Namen\Index{Variablen>Name}\textnote{Namen}, über den sie angesprochen werden,
+und einen Inhalt\Index{Variablen>Inhalt}\textnote{Inhalt}. Der Inhalt einer
+Variablen kann zeitlich bzw. räumlich getrennt von ihrer Verwendung gesetzt
+werden, so wie der Inhalt einer Anweisung getrennt von ihrer Ausführung
+definiert werden kann. Ein Hauptunterschied einer Variablen zu einer Anweisung
+besteht darin, dass eine Anweisung normalerweise eine Aktion auslöst, während
+der Inhalt einer Variablen normalerweise aus einem Text besteht, der dann von
+einer Anweisung ausgegeben wird. Außerdem kann eine Variable zusätzlich eine
+Bezeichnung\Index{Variablen>Bezeichnung}\textnote{Bezeichnung} besitzen, die
+ebenfalls gesetzt und ausgegeben werden kann.
Dieser Abschnitt beschränkt sich bewusst auf die Einführung des Begriffs der
Variablen. Die zur Verdeutlichung verwendeten Beispiele sind ohne tiefere
Bedeutung. Konkretere Anwendungsbeispiele gibt es bei der Erläuterung der in
-der Briefklasse bereits definierten und von ihr verwendeten Variablen in den
-nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} gibt eine
-Übersicht über alle in \Class{scrlttr2} definierten Variablen.
+der Klasse und Paket bereits definierten und von ihnen verwendeten Variablen in
+den nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} gibt eine
+Übersicht über alle definierten Variablen.
%
\begin{desclist}
- \desccaption{Von der Klasse \Class{scrlttr2} unterstützte
- Variablen\label{tab:\LabelBase.variables}} {Von der Klasse \Class{scrlttr2}
- unterstützte Variablen (\emph{Fortsetzung})}
- \ventry{addresseeimage}{Anweisungen, die zum Setzen des Port-Payé-Kopfes bei
- der Einstellung \OptionValueRef{\LabelBase}{addrfield}{backgroundimage} oder der
- Port-Payé-Anschrift bei der Einstellung \OptionValueRef{\LabelBase}{addrfield}{image},
- verwendet werden (\autoref{sec:\LabelBase.firstpage},
+ \desccaption{Von \Class{scrlttr2} und \Package{scrletter} unterstützte
+ Variablen\label{tab:\LabelBase.variables}}%
+ {Von \Class{scrlttr2} und \Package{scrletter} unterstützte Variablen
+ (\emph{Fortsetzung})}%
+ \ventry{addresseeimage}{Anweisungen, die zum Setzen
+ des Port-Payé-Kopfes bei der Einstellung
+ \OptionValueRef{\LabelBase}{addrfield}{backgroundimage} oder der
+ Port-Payé-Anschrift bei der Einstellung
+ \OptionValueRef{\LabelBase}{addrfield}{image}, verwendet werden
+ (\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.addresseeimage})}%
\ventry{backaddress}{Rücksendeadresse für Fensterbriefumschläge
(\autoref{sec:\LabelBase.firstpage},
@@ -149,7 +174,8 @@ nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} gibt eine
\ventry{fromemail}{E-Mail-Adresse des Absenders
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.fromemail})}%
- \ventry{fromfax}{Faxnummer des Absenders (\autoref{sec:\LabelBase.firstpage},
+ \ventry{fromfax}{Faxnummer des Absenders
+ (\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.fromfax})}%
\ventry{fromlogo}{Anweisungen zum Setzen des Absenderlogos
(\autoref{sec:\LabelBase.firstpage},
@@ -167,7 +193,8 @@ nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} gibt eine
\ventry{fromurl}{eine URL des Absenders (\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.fromurl})}%
\ventry{fromzipcode}{Postleitzahl des Absenders für den Port-Payé-Kopf bei
- \OptionValueRef{\LabelBase}{addrfield}{PP} (\autoref{sec:\LabelBase.firstpage},
+ \OptionValueRef{\LabelBase}{addrfield}{PP}
+ (\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.fromzipcode})}%
\ventry{invoice}{Geschäftszeilenfeld »Rechnungsnummer«
(\autoref{sec:\LabelBase.firstpage},
@@ -200,10 +227,12 @@ nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} gibt eine
(\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.placeseparator})}%
\ventry{PPdatamatrix}{Anweisungen zum Setzen einer Data-Matrix bei der
- Einstellung \OptionValueRef{\LabelBase}{addrfield}{PP} (\autoref{sec:\LabelBase.firstpage},
+ Einstellung \OptionValueRef{\LabelBase}{addrfield}{PP}
+ (\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.PPdatamatrix})}%
\ventry{PPcode}{Code zur Identifizierung des Absenders bei Einstellung
- \OptionValueRef{\LabelBase}{addrfield}{PP} (\autoref{sec:\LabelBase.firstpage},
+ \OptionValueRef{\LabelBase}{addrfield}{PP}
+ (\autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.PPcode})}%
\ventry{signature}{Signatur unter Unterschrift und Grußformel
(\autoref{sec:\LabelBase.closing},
@@ -248,14 +277,14 @@ Sternvariante \Macro{setkomavar*} auch nur die \PName{Bezeichnung} der
Variablen \PName{Name} gesetzt werden.
\begin{Example}
In Briefen ist es üblich, den Absender im Briefkopf stehen zu haben. Dazu
- muss \Class{scrlttr2} den Absender aber erst einmal mit Namen kennen. Für
+ muss \KOMAScript{} den Absender aber erst einmal mit Namen kennen. Für
»Peter Musterfrau« ginge das einfach mit:
\begin{lstcode}
\setkomavar{fromname}{Peter Musterfrau}
\end{lstcode}
Die voreingestellte Bezeichnung für den Namen des Absenders ist
»Von«. Angenommen, Herr Musterfrau will aber an den Stellen, an denen
- \Class{scrlttr2} diese Bezeichnung verwendet, lieber »Absender« haben, so
+ \KOMAScript{} diese Bezeichnung verwendet, lieber »Absender« haben, so
müsste er zusätzlich
\begin{lstcode}
\setkomavar*{fromname}{Absender}
@@ -396,16 +425,6 @@ verwendet werden.%
\Macro{addtolengthplength}
\OParameter{Faktor}\Parameter{Länge}\Parameter{Pseudolänge}
\end{Declaration}
-\begin{Explain}%
- Während man einer Länge einfach einen Faktor voranstellen kann, ist
- dies bei Pseudolängen nicht möglich. Angenommen, eine Länge
- \Macro{TestLength} hat den Wert 2\Unit{pt}, dann ergibt
- \texttt{3\Macro{TestLength}} den Wert 6\Unit{pt}. Verwendet man
- stattdessen eine Pseudolänge, so würde aus
- \texttt{3\Macro{useplength}\PParameter{Test}} der Wert 32\Unit{pt}.
- Dies ist insbesondere dann lästig, wenn man einer echten
- \PName{Länge} den Wert einer \PName{Pseudolänge} zuweisen will.
-\end{Explain}
Mit der Anweisung
\Macro{setlengthtoplength}\important{\Macro{setlengthtoplength}} kann man
einer echten \PName{Länge} das Vielfache einer \PName{Pseudolänge} zuweisen.
@@ -445,10 +464,15 @@ jedoch in der Regel nicht sinnvoll. Da Briefe normalerweise nicht gebunden
werden, betrachtet man bei Briefen jede Seite für sich. Das gilt auch dann,
wenn ausnahmsweise Vorder- oder Rückseite bedruckt werden. Daher spielt bei
Briefen normalerweise auch der vertikale Ausgleich keine Rolle. Sollten Sie
-diesen trotzdem benötigen oder wissen wollen, was das ist, sei auf die in
-\autoref{sec:maincls.typearea}, \DescPageRef{maincls.cmd.flushbottom}
-erklärten Anweisungen \DescRef{maincls.cmd.raggedbottom} und
-\DescRef{maincls.cmd.flushbottom} verwiesen.%
+diesen trotzdem benötigen
+\iffalse%
+% Umbruchkorrekturtext
+oder wissen wollen, was das ist, %
+\fi%
+sei auf die in \autoref{sec:maincls.typearea},
+\DescPageRef{maincls.cmd.flushbottom} erklärten Anweisungen
+\DescRef{maincls.cmd.raggedbottom} und \DescRef{maincls.cmd.flushbottom}
+verwiesen.%
%
\EndIndexGroup
@@ -505,9 +529,17 @@ Der Vorspann beinhaltet dabei alle Einstellungen, die generell alle Briefe
betreffen. Diese können in den Einstellungen der einzelnen Briefe jedoch
zumindest teilweise überschrieben werden. Die einzige Einstellung, die derzeit
nicht innerhalb eines einzelnen Briefes überschrieben werden kann, ist die
-Version von \Class{scrlttr2}, zu der Kompatibilität erreicht werden soll (siehe
-Option \DescRef{\LabelBase.option.version} in \autoref{sec:\LabelBase.compatibilityOptions},
-\DescPageRef{\LabelBase.option.version}).
+Version von \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}}, zu der Kompatibilität
+erreicht werden soll (siehe Option \DescRef{\LabelBase.option.version} in
+\autoref{sec:\LabelBase.compatibilityOptions},
+\DescPageRef{\LabelBase.option.version}).
+
+Bei Verwendung von \Package{scrletter}\important{scrletter} ändert sich
+lediglich, dass eine andere Klasse geladen und dafür zusätzlich
+\DescRef{\LabelBase.cmd.usepackage}\PParameter{scrletter} noch vor den
+Einstellungen für alle Briefe einzufügen ist. Für das Setzen von Optionen für
+\Package{scrletter} sei auf \autoref{sec:\LabelBase.options}, ab
+\autopageref{sec:\LabelBase.options} verwiesen.
Ich empfehle, vor \Macro{begin}\PParameter{document} nur allgemeine
Einstellungen wie das Laden von Paketen und das Setzen von Optionen
@@ -515,7 +547,8 @@ vorzunehmen. Alle Einstellungen, die das Setzen einer Variablen oder sonstige
Textangaben beinhalten, sollten nach \Macro{begin}\PParameter{document}
vorgenommen werden. Dies empfiehlt\textnote{Tipp!} sich umso mehr, wenn das
Babel-Paket\IndexPackage{babel} (siehe \cite{package:babel}) verwendet wird
-oder sprachabhängige Variablen von \Class{scrlttr2} verändert werden sollen.
+oder sprachabhängige Variablen von \Class{scrlttr2} oder \Package{scrletter}
+verändert werden sollen.
Der Abschluss besteht in der Regel nur aus
\Macro{end}\PParameter{document}. Natürlich können Sie dort aber auch
@@ -559,15 +592,17 @@ zusätzliche Kommentare einfügen.
\end{captionbeside}
\end{figure}
-Wie in \autoref{fig:\LabelBase.letter} verdeutlicht wird, bestehen die einzelnen
-Briefe wiederum aus einer Einleitung, dem eigentlichen Brief"|text und einem
-Schlussteil. In der Einleitung werden alle Einstellungen vorgenommen, die nur
-für diesen einen Brief gelten sollen. Entscheidend ist hierbei, dass diese
-Einleitung immer mit \DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} endet. Ebenso beginnt
-der Schlussteil immer mit \DescRef{\LabelBase.cmd.closing}\IndexCmd{closing}. Gegebenenfalls
-können die Argumente \PName{Anrede} und \PName{Grußformel} der beiden
-Anweisungen leer bleiben, die Anweisungen müssen jedoch gesetzt werden und
-haben immer ein Argument.
+Wie in \autoref{fig:\LabelBase.letter} verdeutlicht wird, bestehen die
+einzelnen Briefe wiederum aus einer Einleitung, dem eigentlichen Brief"|text
+und einem Schlussteil. In der Einleitung werden alle Einstellungen
+vorgenommen, die nur für diesen einen Brief gelten sollen. Entscheidend ist
+hierbei, dass diese Einleitung immer mit
+\DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} endet. Ebenso beginnt der
+Schlussteil immer mit
+\DescRef{\LabelBase.cmd.closing}\IndexCmd{closing}. Gegebenenfalls können die
+Argumente \PName{Anrede} und \PName{Grußformel} der beiden Anweisungen leer
+bleiben, die Anweisungen müssen jedoch gesetzt werden und haben immer ein
+Argument.
Es soll an dieser Stelle nicht verschwiegen werden, dass zwischen den
einzelnen Briefen weitere Einstellungen getroffen werden können. Diese
@@ -581,8 +616,10 @@ nicht empfehlen%
, da die Suche nach Einstellungen dadurch erschwert wird%
\fi
%
-.
-
+. Dagegen spricht bei Verwendung von \Package{scrletter2} nichts dagegen, vor,
+zwischen oder nach Briefen weitere Dokumentteile einzufügen, die nicht im
+Briefkontext stehen sollen. So kann man beispielsweise Anschreiben und
+Lebenslauf in einem Dokument zusammenfassen.
\begin{Declaration}
\begin{Environment}{letter}\OParameter{Optionen}\Parameter{Empfänger}
@@ -590,10 +627,11 @@ nicht empfehlen%
\end{Declaration}
\BeginIndex{}{Anschrift}%
Die Briefumgebung \Environment{letter} ist einer der zentralen Dreh- und
-Angelpunkte der Briefklasse. Als Besonderheit\textnote{\KOMAScript{}
- vs. Standardklassen} kann man bei \Class{scrlttr2} der Briefumgebung
-zusätzliche \PName{Optionen} mit auf den Weg geben. Diese werden dann intern
-per \DescRef{\LabelBase.cmd.KOMAoptions}-Anweisung ausgeführt.
+Angelpunkte der Briefklasse und des Briefpakets. Als
+Besonderheit\textnote{\KOMAScript{} vs. Standardklassen} kann man bei
+\Class{scrlttr2} und \Package{scrletter} der Briefumgebung zusätzliche
+\PName{Optionen} mit auf den Weg geben. Diese werden dann intern per
+\DescRef{\LabelBase.cmd.KOMAoptions}-Anweisung ausgeführt.
Der \PName{Empfänger} wird als obligatorischer Parameter an die Umgebung
übergeben. Dabei\textnote{Achtung!} dient der doppelte Backslash als
@@ -618,10 +656,10 @@ ist übrigens bei der Standardbriefklasse genauso.
\end{letter}
\end{document}
\end{lstcode}
- Allerdings würde dabei noch keinerlei Ausgabe entstehen. Es würde noch nicht
- einmal die Anschrift auf dem Briefbogen ausgegeben. Warum das so ist,
- erfahren Sie bei der Erklärung zur Anweisung \DescRef{\LabelBase.cmd.opening} auf
- \DescPageRef{\LabelBase.cmd.opening}.
+ Allerdings\textnote{Achtung!} würde dabei noch keinerlei Ausgabe
+ entstehen. Es würde noch nicht einmal die Anschrift auf dem Briefbogen
+ ausgegeben. Warum das so ist, erfahren Sie bei der Erklärung zur Anweisung
+ \DescRef{\LabelBase.cmd.opening} auf \DescPageRef{\LabelBase.cmd.opening}.
\end{Example}
%
\EndIndexGroup
@@ -631,39 +669,42 @@ ist übrigens bei der Standardbriefklasse genauso.
\Macro{AtBeginLetter}\Parameter{Anweisungen}
\Macro{AtEndLetter}\Parameter{Anweisungen}
\end{Declaration}
-Wie in \cite{latex:clsguide} erwähnt, gibt es bei \LaTeX{} die Möglichkeit, zu
-bestimmten Gelegenheiten während des \LaTeX-Laufs eines Dokuments zusätzliche
-\PName{Anweisungen} ausführen zu lassen. Zu diesem Zweck stellt der
-\LaTeX-Kern beispielsweise die Anweisungen
+\iftrue% Umbruchvarianten
+Wie\textnote{Haken}\Index[indexmain]{Haken} in \cite{latex:clsguide} erwähnt,
+gibt es bei \LaTeX{} die Möglichkeit, zu bestimmten Gelegenheiten während des
+\LaTeX-Laufs eines Dokuments zusätzliche \PName{Anweisungen} ausführen zu
+lassen. Zu diesem Zweck stellt der \LaTeX-Kern beispielsweise die Anweisungen
\Macro{AtEndOfClass}\IndexCmd{AtEndOfClass} und
\Macro{AtBeginDocument}\IndexCmd{AtBeginDocument} zur Verfügung. Man nennt
solche Eingriffspunkte auch \emph{hooks}\Index{hook=\emph{hook}}, also
-Haken\Index{Haken}. Die Klasse \Class{scrlttr2} fügt zwei weitere Haken hinzu,
-die mit \Macro{AtBeginLetter} und
+Haken. Die Klasse \Class{scrlttr2} und das Paket \Package{scrletter} fügen
+zwei weitere Haken hinzu, die mit \Macro{AtBeginLetter} und
\Macro{AtEndLetter}\ChangedAt{v2.95}{\Class{scrlttr2}} mit Inhalt versehen
werden können. Wie man schon daran erkennt, dass die \LaTeX-Kern-Anweisungen
für Haken nicht in \cite{latex:usrguide} sondern in \cite{latex:clsguide}
dokumentiert sind, sind diese Anweisungen eigentlich eher für Paket- und
-Klassenautoren gedacht. Bei der Briefklasse kann es jedoch sinnvolle
-Anwendungen für die beiden neuen Haken auch auf Benutzerebene geben. Das
-folgende Beispiel zeigt dies.
+Klassenautoren gedacht. Bei der Briefklasse und dem Briefpaket kann es jedoch
+sinnvolle Anwendungen für die beiden neuen Haken auch auf Benutzerebene
+geben.\Index[indexmain]{Haken} Das folgende Beispiel zeigt dies.%
%
\begin{Example}
Angenommen, Sie haben mehrere Briefe in einem Dokument. Sie verwenden
außerdem eine eigene Anweisung, um in den Briefen einen Fragebogen
zu setzen. Dabei werden die Fragen automatisch mit Hilfe eines
- Zählers nummeriert. Da \Class{scrlttr2} dieser Zähler nicht bekannt
+ Zählers nummeriert. Da \KOMAScript{} dieser Zähler nicht bekannt
ist, würde er auch im Gegensatz etwa zur Seitenzahl am Anfang eines
neuen Briefes nicht zurückgesetzt. Wenn jeder Brief zehn Fragen
beinhaltet, hätte damit die erste Frage im fünften Brief die Nummer
- 41 statt der Nummer 1. Sie lösen das, indem Sie \Class{scrlttr2}
+ 41 statt der Nummer 1. Sie lösen das, indem Sie \KOMAScript{}
mitteilen, dass am Anfang jedes Briefes der Zähler zurückgesetzt
werden soll:
\begin{lstcode}
\newcounter{Frage}
\newcommand{\Frage}[1]{%
- \refstepcounter{Frage}\par
- \noindent\begin{tabularx}{\textwidth}{l@{}X}
+ \par
+ \refstepcounter{Frage}%
+ \noindent
+ \begin{tabularx}{\textwidth}{l@{}X}
\theFrage:~ & #1\\
\end{tabularx}%
}%
@@ -674,6 +715,47 @@ folgende Beispiel zeigt dies.
\Package{tabularx}-Paket\IndexPackage{tabularx} (siehe
\cite{package:tabularx}).
\end{Example}
+\else%
+ Wie\Index[indexmain]{Haken} in \cite{latex:clsguide} erwähnt, gibt es bei
+ \LaTeX{} die Möglichkeit, während des \LaTeX-Laufs eines Dokuments zusätzliche
+ \PName{Anweisungen} ausführen zu lassen. Zu diesem Zweck stellt der
+ \LaTeX-Kern die Anweisungen \Macro{AtEndOfClass}\IndexCmd{AtEndOfClass} und
+ \Macro{AtBeginDocument}\IndexCmd{AtBeginDocument} zur Verfügung. Man nennt
+ solche Eingriffspunkte auch \emph{hooks}\Index{hook=\emph{hook}}, also
+ Haken. \KOMAScript{} fügt zwei weitere Haken hinzu, die mit
+ \Macro{AtBeginLetter} und
+ \Macro{AtEndLetter}\ChangedAt{v2.95}{\Class{scrlttr2}} mit Inhalt versehen
+ werden können. Wie man schon daran erkennt, dass die \LaTeX-Kern-Anweisungen
+ für Haken nicht in \cite{latex:usrguide} sondern in \cite{latex:clsguide}
+ dokumentiert sind, sind diese Anweisungen eigentlich eher für Paket- und
+ Klassenautoren gedacht. Bei Briefen kann es jedoch sinnvolle Anwendungen für
+ die beiden neuen Haken auch auf Benutzerebene geben.\Index[indexmain]{Haken}%
+ %
+ \begin{Example}
+ Angenommen, Sie haben mehrere Briefe in einem Dokument und verwenden
+ eine eigene Anweisung, um in den Briefen einen Fragebogen
+ zu setzen. Die Fragen werden mit Hilfe eines
+ Zählers nummeriert. Da \KOMAScript{} diesen Zähler nicht kennt,
+ würde er auch im Gegensatz zur Seitenzahl am Anfang eines
+ neuen Briefes nicht zurückgesetzt. Bei 10 Fragen je Brief, hätte damit die
+ erste Frage im fünften Brief die Nummer 41 statt der Nummer 1. Sie lösen
+ das, indem Sie am Anfang jedes Briefes den Zähler zurücksetzen lassen:
+\begin{lstcode}
+ \newcounter{Frage}
+ \newcommand{\Frage}[1]{%
+ \refstepcounter{Frage}\par
+ \noindent\begin{tabularx}{\textwidth}{l@{}X}
+ \theFrage:~ & #1\\
+ \end{tabularx}%
+ }%
+ \AtBeginLetter{\setcounter{Frage}{0}}
+\end{lstcode}
+ Damit hat dann auch die erste Frage im 1001.~Brief wieder die Nummer
+ Eins. Die hier angegebene Definition benötigt übrigens das
+ \Package{tabularx}-Paket\IndexPackage{tabularx} (siehe
+ \cite{package:tabularx}).
+ \end{Example}%
+\fi
%
\EndIndexGroup
@@ -697,8 +779,10 @@ referenzierbar um eins erhöht wird.
\begin{lstcode}
\newcounter{Frage}[letter]
\newcommand{\Frage}[1]{%
- \refstepcounter{Frage}\par
- \noindent\begin{tabularx}{\textwidth}{l@{}X}
+ \par
+ \refstepcounter{Frage}%
+ \noindent
+ \begin{tabularx}{\textwidth}{l@{}X}
\theFrage:~ & #1\\
\end{tabularx}%
}%
@@ -733,14 +817,15 @@ drei -- gültig. Achten Sie gegebenenfalls auf entsprechende
\begin{Declaration}
\Macro{opening}\Parameter{Anrede}
\end{Declaration}
-Dies ist eine der wichtigsten Anweisungen in \Class{scrlttr2}. Vordergründig
-wird damit die \PName{Anrede}\Index{Anrede} des Briefes, beispielsweise »Sehr
-geehrte Frau \dots«, gesetzt. Tatsächlich\textnote{Achtung!} setzt diese
+Dies ist eine der wichtigsten Anweisungen in Briefen. Vordergründig
+wird damit die \PName{Anrede}\Index{Anrede}, beispielsweise »Sehr
+geehrte Frau~\dots«, gesetzt. Tatsächlich\textnote{Achtung!} setzt diese
Anweisung aber auch alle Elemente des Briefbogens wie die
Faltmarken\Index{Faltmarke}, den Briefkopf\Index{Briefkopf}, die
Anschrift\Index{Anschrift}, die Absenderergänzung, die
Geschäftszeile\Index{Geschaeftszeile=Geschäftszeile}, den Titel\Index{Titel},
-den Betreff\Index{Betreff} und den Seitenfuß\Index{Kopf}\Index{Fuss=Fuß}. Kurz
+den Betreff\Index{Betreff} und den
+Seitenfuß\Index{Kopf}\Index{Fuss=Fuß}. Kurz\textnote{Ohne Anrede kein Brief!}
gesagt: ohne Anrede kein Brief. Soll tatsächlich einmal ein Brief ohne Anrede
gesetzt werden, so muss eben das Argument von \Macro{opening} leer bleiben.
@@ -761,7 +846,7 @@ gesetzt werden, so muss eben das Argument von \Macro{opening} leer bleiben.
\label{fig:\LabelBase.letter-0}
\end{figure}
\end{Example}
-\iftrue % Umbruchkorrekturtext
+\iffalse % Umbruchkorrekturtext
\begin{Explain}
Bei\textnote{Tipp!} maschinell erstellten Briefen wurde früher meist auf
eine Anrede verzichtet, da individualisierte Serienbriefe kaum möglich
@@ -781,8 +866,8 @@ mit doppeltem Backslash voneinander getrennt werden. Absätze innerhalb der
\PName{Grußfloskel} sind jedoch nicht gestattet.
Darüber hinaus setzt diese Anweisung aber auch noch gleich den Inhalt der
-Variablen \DescRef{\LabelBase.variable.signature} als Signatur. Näheres zur Signatur und deren
-Konfiguration ist \autoref{sec:\LabelBase.closing} ab
+Variablen \DescRef{\LabelBase.variable.signature} als Signatur. Näheres zur
+Signatur und deren Konfiguration ist \autoref{sec:\LabelBase.closing} ab
\DescPageRef{\LabelBase.variable.signature} zu entnehmen.
\begin{Example}
@@ -814,7 +899,7 @@ begonnen und ein vertikaler Abstand -- in der Regel zur Signatur --
eingefügt. Auf die Anweisung \Macro{ps} kann beliebiger Text folgen.
Dabei muss der Anwender auch selbst entscheiden, ob er den Nachsatz
etwa mit der Abkürzung »PS:«, die übrigens ohne Punkt gesetzt wird,
-beginnen will. Die Klasse \Class{scrlttr2} setzt diese Abkürzung weder
+beginnen will. \KOMAScript{} setzt diese Abkürzung weder
automatisch noch optional.
\begin{Example}
@@ -845,6 +930,10 @@ automatisch noch optional.
sehr schön noch einmal auf ganz andere äußerst wichtige oder eigentlich
ganz unwichtige Dinge hinweisen.%
\fi
+\iftrue % Umbruchkorrektur
+ Heutzutage verwendet man das Postskriptum dagegen eher für
+ Hinweise, die mit dem eigentlichen Briefinhalt wenig zu tun haben.
+\fi
\end{Explain}
%
\EndIndexGroup
@@ -929,17 +1018,17 @@ hier von der \PName{Bezeichnung} und dem \PName{Inhalt} der Variablen
Der Briefbogen ist die erste Seite und damit das Aushängeschild jedes
Briefes. Im geschäftlichen Bereich handelt es sich dabei oft um einen
-Vordruck, auf dem viele Elemente wie ein Briefkopf mit Absenderinformationen
-und Logo bereits enthalten sind. Bei \KOMAScript{} sind diese Elemente frei
+Vordruck, auf dem viele Elemente, wie ein Briefkopf mit Absenderinformationen
+und Logo, bereits enthalten sind. Bei \KOMAScript{} sind diese Elemente frei
positionierbar. Damit ist es nicht nur möglich, einen Briefbogen direkt
-nachzubilden, sondern auch vorgesehene Felder wie die Anschrift unmittelbar
+nachzubilden, sondern auch vorgesehene Felder, wie die Anschrift, unmittelbar
auszufüllen. Die freie Positionierbarkeit wird über Pseudolängen (siehe
\autoref{sec:\LabelBase.pseudoLength} ab
\autopageref{sec:\LabelBase.pseudoLength}) erreicht. Eine schematische
Darstellung des Briefbogens und der dafür verwendeten Variablen ist in
-\autoref{fig:\LabelBase.variables} zu finden. Dabei sind die Namen der Variablen
-zur besseren Unterscheidung von Anweisungen und deren Argumenten fett
-gedruckt.
+\autoref{fig:\LabelBase.variables} zu finden. Dabei sind die Namen der
+Variablen zur besseren Unterscheidung von Anweisungen und deren Argumenten
+fett gedruckt.
Folgeseiten\Index{Folgeseite} sind vom Briefbogen zu
unterscheiden. Folgeseiten im Sprachgebrauch dieser Anleitung sind alle
@@ -958,11 +1047,12 @@ Briefseiten abgesehen von der ersten.
\begin{Declaration}
\OptionVName{foldmarks}{Einstellung}
\end{Declaration}
-Falt- oder Falzmarken sind kleine horizontale Striche am linken und kleine
-vertikale Striche am oberen Rand. \KOMAScript{} unterstützt für den Briefbogen
-derzeit drei konfigurierbare horizontale und eine konfigurierbare vertikale
-Faltmarke. Dazu wird noch eine horizontale Loch- oder Seitenmittenmarke
-unterstützt, die nicht in der Vertikalen verschoben werden kann.
+Falt- oder Falzmarken\Index{Faltmarken}\textnote{Faltmarken} sind kleine
+horizontale Striche am linken und kleine vertikale Striche am oberen
+Rand. \KOMAScript{} unterstützt für den Briefbogen derzeit drei
+konfigurierbare horizontale und eine konfigurierbare vertikale Faltmarke. Dazu
+wird noch eine horizontale Loch- oder Seitenmittenmarke unterstützt, die nicht
+in der Vertikalen verschoben werden kann.
Mit der Option \Option{foldmarks} können Faltmarken\Index{Faltmarke} für eine
vertikale Zwei"~, Drei- oder Vierteilung und eine horizontale Zweiteilung
@@ -984,7 +1074,8 @@ die Faltmarken nur dann angezeigt, wenn die Faltmarken nicht mit
wurden. Die genaue Position der Faltmarken ist von den Einstellungen des
Anwenders beziehungsweise der \File{lco}-Dateien (siehe
\autoref{sec:\LabelBase.lcoFile} ab \autopageref{sec:\LabelBase.lcoFile})
-abhängig. Voreingestellt sind \PValue{true} und \PValue{TBMPL}.
+abhängig. Voreingestellt sind \PValue{true} und
+\PValue{TBMPL}.\textnote{Voreinstellung}
%
\begin{table}
% \centering
@@ -1059,8 +1150,8 @@ keine Änderung.%
\begin{Explain}
Die erste Seite eines Briefes fällt %
\iftrue % Umbruchkorrektur
- aufgrund der vielen Konsultationselemente wie dem Briefkopf oder der
- Anschrift
+ aufgrund der vielen Konsultationselemente, wie dem Briefkopf oder der
+ Anschrift,
%
\fi %
immer aus dem normalen Satzspiegel. Von \Class{scrlttr2} werden Mechanismen
@@ -1078,7 +1169,7 @@ erste Seite. Siehe hierzu auch die Erklärung zur Pseudolänge
\DescPageRef{scrlttr2-experts.plength.firstfootvpos}. Als
\PName{Ein-Aus-Wert} kann dabei einer der Standardwerte für einfache Schalter
aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet
-werden. Voreingestellt ist \PValue{false}.%
+werden. Voreingestellt ist \PValue{false}.\textnote{Voreinstellung}%
%
\EndIndexGroup
@@ -1086,13 +1177,18 @@ werden. Voreingestellt ist \PValue{false}.%
\begin{Declaration}
\OptionVName{firsthead}{Ein-Aus-Wert}
\end{Declaration}
+\iffalse% Umbruchkorrekturtext
Das\ChangedAt{v2.97e}{\Class{scrlttr2}} oberste Element eines Briefbogens ist
-normalerweise der Briefkopf. Bei \KOMAScript{} kann mit der Option
+normalerweise der Briefkopf. Bei
+\else%
+Bei\ChangedAt{v2.97e}{\Class{scrlttr2}}
+\fi%
+\KOMAScript{} kann mit der Option
\Option{firsthead} gewählt werden, ob der Briefkopf auf dem Briefbogen
überhaupt gesetzt werden soll. Als \PName{Ein-Aus-Wert} kann dabei einer der
Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch},
\autopageref{tab:truefalseswitch} verwendet werden. In der Voreinstellung ist
-der Briefkopf aktiviert.%
+der Briefkopf aktiviert.\textnote{Voreinstellung}%%
%
\EndIndexGroup
@@ -1106,24 +1202,25 @@ Absender\Index{Absender} auf der ersten Seite platziert werden soll. Neben
verschiedenen Platzierungen im Briefkopf gibt es
auch\ChangedAt{v2.97e}{\Class{scrlttr2}} die Möglichkeit, den Absender in der
Absenderergänzung\Index{Absenderergaenzung=Absenderergänzung}
-unter zu bringen. Gleichzeitig\textnote{Achtung!} dient diese Option als
+unterzubringen. Gleichzeitig\textnote{Achtung!} dient diese Option als
zentraler Schalter, um die Erweiterungen der Briefkopfgestaltung überhaupt zu
aktivieren oder zu deaktivieren. Sind die Erweiterungen deaktiviert, so
bleiben die übrigen nachfolgend angegebenen Optionen ohne Wirkung. Mögliche
Werte für \Option{fromalign} sind \autoref{tab:\LabelBase.fromalign} zu
-entnehmen. Voreingestellt ist der Wert \PValue{left}.
+entnehmen. Voreingestellt ist der Wert \PValue{left}.\textnote{Voreinstellung}%
%
\EndIndexGroup
\begin{table}
\Index{Briefkopf}%
- \caption[{Mögliche Werte für Option \Option{fromalign} bei
- \Class{scrlttr2}}]{Mögliche Werte für Option \Option{fromalign} zur
- Platzierung des Absenders auf dem Briefbogen von \Class{scrlttr2}}
+ \caption[{Mögliche Werte für Option
+ \Option{fromalign} zur Platzierung des Absenders auf dem Briefbogen}]
+ {Mögliche Werte für Option
+ \Option{fromalign} zur Platzierung des Absenders auf dem Briefbogen}
\label{tab:\LabelBase.fromalign}
\begin{desctabular}
\entry{\PValue{center}, \PValue{centered}, \PValue{middle}}{%
- Absender wird innerhalb des Briefkopfs zentriert; ein Logo wird
+ Absender wird innerhalb des Briefkopfes zentriert; ein Logo wird
gegebenenfalls am Anfang der erweiterten Absenderangabe platziert; die
Erweiterungen der Briefkopfgestaltung werden aktiviert.}%
\entry{\PValue{false}, \PValue{no}, \PValue{off}}{%
@@ -1165,29 +1262,31 @@ Der\important{\Variable{fromname}} Name des Absenders wird über die Variable
Optional\important{\OptionValue{fromrule}{aftername}} kann mit Einstellung
\OptionValue{fromrule}{aftername} im erweiterten Briefkopf auf den Namen eine
horizontale Linie
-folgen. Alternativ\important[i]{\begin{tabular}{@{}l@{}}\KOption{fromrule}\\\quad\PValue{afteraddress}\end{tabular}} kann die
+folgen. Alternativ\important{\OptionValue{fromrule}{afteraddress}} kann die
Linie mit \OptionValue{fromrule}{afteraddress} auch unterhalb des kompletten
Absenders gesetzt werden. Eine Übersicht über alle möglichen Einstellungen für
die Linie bietet \autoref{tab:\LabelBase.fromrule}. Die Länge der Linie wird
-über die Pseudolänge \PLength{fromrulewidth} bestimmt.
+über die Pseudolänge \PLength{fromrulewidth}\IndexPLength{fromrulewidth}
+bestimmt.
\begin{table}
-% \KOMAoptions{captions=topbeside}%
-% \setcapindent{0pt}%
- \caption
-% \begin{captionbeside}
+ \KOMAoptions{captions=topbeside}%
+ \setcapindent{0pt}%
+% \caption
+ \begin{captionbeside}
[{%
Mögliche Werte für Option \Option{fromrule} bei
- \Class{scrlttr2}%
+ \Class{scrlttr2} und \Package{scrletter}%
}]{%
+ \label{tab:\LabelBase.fromrule}%
Mögliche Werte für Option \Option{fromrule} zur
Platzierung einer horizontalen Linie im Absender des erweiterten
- Briefkopfs von \Class{scrlttr2}%
- }
- \label{tab:\LabelBase.fromrule}%
-% [l]
-% \begin{minipage}[t]{.6\linewidth}%
- \begin{desctabular}
+ Briefkopfes von \Class{scrlttr2} und \Package{scrletter}%
+ }%
+ [l]%
+% \label{tab:\LabelBase.fromrule}%
+ \begin{minipage}[t]{.6\linewidth}%
+ \begin{desctabular}[t]
\entry{%
\PValue{afteraddress}, \PValue{below}, \PValue{on}, \PValue{true},
\PValue{yes}}{%
@@ -1197,12 +1296,13 @@ die Linie bietet \autoref{tab:\LabelBase.fromrule}. Die Länge der Linie wird
\entry{\PValue{false}, \PValue{no}, \PValue{off}}{%
keine Linie}%
\end{desctabular}
-% \end{minipage}
-% \end{captionbeside}
+ \end{minipage}
+ \end{captionbeside}
\end{table}
-In der Voreinstellung ist die Linie im erweiterten Briefkopf nicht
-aktiviert. Im Standardbriefkopf wird die Linie immer nach dem Namen gesetzt.
+In der Voreinstellung\textnote{Voreinstellung} ist die Linie im erweiterten
+Briefkopf nicht aktiviert. Im Standardbriefkopf wird die Linie immer nach dem
+Namen gesetzt.
Unter\important{\Variable{fromaddress}} dem Namen folgt die Anschrift des
Absenders. Diese wird über die Variable \Variable{fromaddress} bestimmt. Im
@@ -1224,14 +1324,14 @@ Linie über das Element \FontElement{fromrule}\IndexFontElement{fromrule}%
\important{\FontElement{fromrule}} eingestellt werden. In der Voreinstellung
erfolgt keinerlei Schriftumschaltung. Bei der Linie ist die Möglichkeit der
Schriftumschaltung hauptsächlich dazu gedacht, die Farbe der Linie ändern zu
-können, um etwa Grau an Stelle von Schwarz zu verwenden. Siehe hierzu
+können, um etwa Grau anstelle von Schwarz zu verwenden. Siehe hierzu
\cite{package:xcolor}.%
%
\EndIndexGroup
\begin{Example}
Geben wir nun dem Absender
- \iffalse % Umbruchkorrektur
+ \iftrue % Umbruchkorrektur
aus den bisherigen Beispielen
\fi %
einen Namen.
@@ -1245,17 +1345,18 @@ können, um etwa Grau an Stelle von Schwarz zu verwenden. Siehe hierzu
{Ergebnis eines kleinen Briefes mit Absender, Anschrift, Anrede, Text,
Grußfloskel, Signatur, Postskriptum, Anlagen und Verteiler (Datum und
Faltmarken entstammen den Voreinstellungen für DIN-Briefe); links der
- Standardbriefkopf mit \OptionValueRef{\LabelBase}{fromalign}{false}, rechts der
+ Standardbriefkopf mit \OptionValueRef{\LabelBase}{fromalign}{false},
+ rechts der
erweiterte Briefkopf mit \OptionValueRef{\LabelBase}{fromalign}{center}}
\label{fig:\LabelBase.letter-8-9}
\end{figure}
Dabei wird zunächst einmal nicht der erweiterte Briefkopf, sondern nur der
Standardbriefkopf verwendet. Das Ergebnis ist in
- \autoref{fig:\LabelBase.letter-8-9}, links zu sehen. Im Vergleich dazu ist
+ \autoref{fig:\LabelBase.letter-8-9} links zu sehen. Im Vergleich dazu ist
rechts daneben das gleiche Beispiel, jedoch mit Option
- \OptionValueRef{\LabelBase}{fromalign}{center}, also mit den aktivierten Erweiterungen für
- den Briefkopf, abgebildet. Wie zu sehen ist, hat diese Variante zunächst
- einmal keine Linie.
+ \OptionValueRef{\LabelBase}{fromalign}{center}, also mit den aktivierten
+ Erweiterungen für den Briefkopf, abgebildet. Wie zu sehen ist, hat diese
+ Variante zunächst einmal keine Linie.
In \autoref{fig:\LabelBase.letter-8-9} taucht nun auch erstmals eine Signatur
unter dem Gruß auf. Diese wird automatisch aus dem Absendername
@@ -1267,7 +1368,7 @@ können, um etwa Grau an Stelle von Schwarz zu verwenden. Siehe hierzu
der Option \Option{fromrule} auch noch eine Linie unter dem Namen erhalten:%
\lstinputcode[xleftmargin=1em]{letter-11.tex}%
Das Ergebnis ist in \autoref{fig:\LabelBase.letter-10-11} rechts zu sehen. %
- \iffalse % Umbruchkorrektur
+ \iftrue % Umbruchkorrektur
Im Vergleich dazu ist links daneben das gleiche Beispiel noch einmal mit dem
Standardbriefkopf und ohne Reaktion auf die zusätzliche Option.
%
@@ -1300,8 +1401,8 @@ Länderangabe. Dieser doppelte Backslash wird je nach Verwendung der
Absenderadresse unterschiedlich interpretiert und ist nicht zwangsläufig als
Zeilenumbruch zu verstehen. Absätze, vertikale Abstände und Ähnliches sind
innerhalb der Absenderangaben normalerweise nicht gestattet%
-\iffalse % Umbruchkorrektur
-. Man muss \Class{scrlttr2} schon sehr genau kennen, um solche Mittel
+\iftrue % Umbruchkorrektur
+. Man muss \KOMAScript{} schon sehr genau kennen, um solche Mittel
gegebenenfalls sinnvoll im Absender einsetzen zu können. Außerdem sollte man
in dem Fall unbedingt die Variablen für Rücksendeadresse (siehe Variable
\DescRef{\LabelBase.variable.backaddress},
@@ -1345,26 +1446,29 @@ Mobiltelefonnummer\Index{Mobiltelefon}\Index{Handy}, die Faxnummer\Index{Fax},
die E-Mail-Adresse und die URL im Absender\Index{Absender} gesetzt werden
soll. Als \PName{Ein-Aus-Wert} kann dabei einer der Standardwerte für einfache
Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}
-verwendet werden. Voreingestellt ist jeweils \PValue{false}. Die Inhalte
-selbst werden über die gleichnamigen Variablen bestimmt. Die Voreinstellungen
-für die dabei verwendeten Bezeichnungen sind \autoref{tab:\LabelBase.fromTerm}
-zu entnehmen, die verwendeten Trennzeichen, die zwischen der
-\PName{Bezeichnung} und dem \PName{Inhalt} einer Variablen eingefügt werden,
-\autoref{tab:\LabelBase.fromSeparator}.
+verwendet werden. Voreingestellt\textnote{Voreinstellung} ist jeweils
+\PValue{false}. Die Inhalte selbst werden über die gleichnamigen Variablen
+bestimmt. Die Voreinstellungen für die dabei verwendeten Bezeichnungen sind
+\autoref{tab:\LabelBase.fromTerm} zu entnehmen, die verwendeten Trennzeichen,
+die zwischen der \PName{Bezeichnung} und dem \PName{Inhalt} einer Variablen
+eingefügt werden, \autoref{tab:\LabelBase.fromSeparator}.
Mit\ChangedAt{v3.12}{\Class{scrlttr2}}\important{\Option{symbolicnames}}
Option \Option{symbolicnames} kann diese Voreinstellung auf einen Schlag
geändert werden. Die Option versteht die \PName{Ein-Aus-Werte} für einfache
Schalter, wie sie in \autoref{tab:truefalseswitch},
\autopageref{tab:truefalseswitch} angegeben sind. Durch Aktivierung der Option
-werden statt der sprachabhängigen Bezeichner \DescRef{scrlttr2-experts.cmd.emailname},
-\DescRef{scrlttr2-experts.cmd.faxname}, \DescRef{scrlttr2-experts.cmd.mobilephonename} und \DescRef{scrlttr2-experts.cmd.phonename} Symbole aus dem
-\Package{marvosym}\IndexPackage{marvosym}-Paket
-verwendet. Gleichzeitig entfällt der Doppelpunkt bei der Definition der
-Trennzeichen. Für die URL entfallen in diesem Fall sowohl der sprachabhängige
-Bezeichner als auch das Trennzeichen. Es ist zu beachten\textnote{Achtung!},
-dass das Paket \Package{marvosym} gegebenenfalls selbst zu laden ist, falls
-die Option erst nach \Macro{begin}\PParameter{document} aktiviert wird.
+werden statt der sprachabhängigen Bezeichner
+\DescRef{scrlttr2-experts.cmd.emailname},
+\DescRef{scrlttr2-experts.cmd.faxname},
+\DescRef{scrlttr2-experts.cmd.mobilephonename} und
+\DescRef{scrlttr2-experts.cmd.phonename} Symbole aus dem
+\Package{marvosym}\IndexPackage{marvosym}-Paket verwendet. Gleichzeitig
+entfällt der Doppelpunkt bei der Definition der Trennzeichen. Für die URL
+entfallen in diesem Fall sowohl der sprachabhängige Bezeichner als auch das
+Trennzeichen. Es ist zu beachten\textnote{Achtung!}, dass das Paket
+\Package{marvosym} gegebenenfalls selbst zu laden ist, falls die Option erst
+nach \Macro{begin}\PParameter{document} aktiviert wird.
\begin{table}
\centering
@@ -1374,17 +1478,21 @@ die Option erst nach \Macro{begin}\PParameter{document} aktiviert wird.
verwendeten Variablen für Trennzeichen ist
\autoref{tab:\LabelBase.fromSeparator} zu entnehmen)}
\begin{desctabular}[1.8em]
- \ventry{fromemail}{\DescRef{\LabelBase.cmd.usekomavar*}\PParameter{emailseparator}%
+ \ventry{fromemail}{%
+ \DescRef{\LabelBase.cmd.usekomavar*}\PParameter{emailseparator}%
\DescRef{\LabelBase.cmd.usekomavar}\PParameter{emailseparator}}%
- \ventry{fromfax}{\DescRef{\LabelBase.cmd.usekomavar*}\PParameter{faxseparator}%
+ \ventry{fromfax}{%
+ \DescRef{\LabelBase.cmd.usekomavar*}\PParameter{faxseparator}%
\DescRef{\LabelBase.cmd.usekomavar}\PParameter{faxseparator}}%
\ventry{frommobilephone}{%
\DescRef{\LabelBase.cmd.usekomavar*}\PParameter{mobilephoneseparator}%
\DescRef{\LabelBase.cmd.usekomavar}\PParameter{mobilephoneseparator}}%
\ventry{fromname}{\DescRef{scrlttr2-experts.cmd.headfromname}}%
- \ventry{fromphone}{\DescRef{\LabelBase.cmd.usekomavar*}\PParameter{phoneseparator}%
+ \ventry{fromphone}{%
+ \DescRef{\LabelBase.cmd.usekomavar*}\PParameter{phoneseparator}%
\DescRef{\LabelBase.cmd.usekomavar}\PParameter{phoneseparator}}%
- \ventry{fromurl}{\DescRef{\LabelBase.cmd.usekomavar*}\PParameter{urlseparator}%
+ \ventry{fromurl}{%
+ \DescRef{\LabelBase.cmd.usekomavar*}\PParameter{urlseparator}%
\DescRef{\LabelBase.cmd.usekomavar}\PParameter{urlseparator}}%
\end{desctabular}
\label{tab:\LabelBase.fromTerm}
@@ -1422,28 +1530,29 @@ die Option erst nach \Macro{begin}\PParameter{document} aktiviert wird.
soll die Trennlinie nun nach dem Briefkopf stehen. Also gibt er die
entsprechenden Optionen an und setzt auch die zugehörigen Variablen:%
\lstinputcode[xleftmargin=1em]{letter-12.tex}%
- Das Ergebnis aus \autoref{fig:\LabelBase.letter-12-13}, links ist jedoch
+ Das Ergebnis aus \autoref{fig:\LabelBase.letter-12-13} links ist jedoch
ernüchternd. Die Optionen werden ignoriert. Das liegt daran, dass diese
zusätzlichen Variablen und Optionen nur im erweiterten Briefkopf verwendet
- werden. Es muss also wie in \autoref{fig:\LabelBase.letter-12-13}, rechts die
+ werden. Es muss also, wie in \autoref{fig:\LabelBase.letter-12-13}, rechts die
Option \DescRef{\LabelBase.option.fromalign} verwendet werden:
\begin{figure}
\centering
\frame{\includegraphics[width=.4\textwidth]{letter-12}}\quad
\frame{\includegraphics[width=.4\textwidth]{letter-13}}
\caption[{Beispiel: Brief mit erweitertem Absender, Trennlinie, Anschrift,
- Anrede, Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und
- Lochermarke; Standard- vs. erweiterter Briefkopf}]{Ergebnis eines
+ Anrede, Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler
+ und Lochermarke; Standard- vs. erweiterter Briefkopf}]{Ergebnis eines
kleinen Briefes mit erweitertem Absender, Trennlinie, Anschrift, Anrede,
Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und
Lochermarke (das Datum entstammt den Voreinstellungen für DIN-Briefe);
- links der Standardbriefkopf mit \OptionValueRef{\LabelBase}{fromalign}{false}, rechts
- der erweiterte Briefkopf mit \OptionValueRef{\LabelBase}{fromalign}{center}}
+ links der Standardbriefkopf mit
+ \OptionValueRef{\LabelBase}{fromalign}{false}, rechts der erweiterte
+ Briefkopf mit \OptionValueRef{\LabelBase}{fromalign}{center}}
\label{fig:\LabelBase.letter-12-13}
\end{figure}
\lstinputcode[xleftmargin=1em]{letter-13.tex}
- Den Vergleich zweier Alternativen mit linksbündigem Absender durch
+ Den Vergleich zweier weiterer Alternativen mit linksbündigem Absender durch
Einstellung \OptionValueRef{\LabelBase}{fromalign}{left} und rechtsbündigem
Absender durch Einstellung \OptionValueRef{\LabelBase}{fromalign}{right} zeigt
\autoref{fig:\LabelBase.letter-14-15}.
@@ -1457,8 +1566,10 @@ die Option erst nach \Macro{begin}\PParameter{document} aktiviert wird.
kleinen Briefes mit erweitertem Absender, Trennlinie, Anschrift, Anrede,
Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und
Lochermarke (das Datum entstammt den Voreinstellungen für DIN-Briefe);
- links mit linksbündigem Kopf durch \OptionValueRef{\LabelBase}{fromalign}{left}, rechts
- mit Option \OptionValueRef{\LabelBase}{fromalign}{right} und damit rechtsbündigem Kopf}
+ links mit linksbündigem Kopf durch
+ \OptionValueRef{\LabelBase}{fromalign}{left}, rechts mit Option
+ \OptionValueRef{\LabelBase}{fromalign}{right} und damit rechtsbündigem
+ Kopf}
\label{fig:\LabelBase.letter-14-15}
\end{figure}
\end{Example}
@@ -1475,11 +1586,12 @@ die Option erst nach \Macro{begin}\PParameter{document} aktiviert wird.
Mit der Option \Option{fromlogo} kann bestimmt werden, ob ein Logo\Index{Logo}
im Briefkopf gesetzt werden soll. Als \PName{Ein-Aus-Wert} kann dabei einer
der Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch},
-\autopageref{tab:truefalseswitch} verwendet werden. Voreingestellt ist
-\PValue{false}, also kein Logo. Das Logo selbst wird über die Variable
-\Variable{fromlogo} definiert. Die \PName{Bezeichnung} für das Logo ist in der
-Voreinstellung leer und wird von \KOMAScript{} auch nicht verwendet (siehe
-auch \autoref{tab:\LabelBase.fromTerm}, \autopageref{tab:\LabelBase.fromTerm}).%
+\autopageref{tab:truefalseswitch} verwendet
+werden. Voreingestellt\textnote{Voreinstellung} ist \PValue{false}, also kein
+Logo. Das Logo selbst wird über die Variable \Variable{fromlogo}
+definiert. Die \PName{Bezeichnung} für das Logo ist in der Voreinstellung leer
+und wird von \KOMAScript{} auch nicht verwendet (siehe auch
+\autoref{tab:\LabelBase.fromTerm}, \autopageref{tab:\LabelBase.fromTerm}).%
\begin{Example}
Herr Musterfrau findet es besonders schick, wenn er seine Briefe mit einem
Logo versieht. Sein Logo hat er als Grafikdatei gespeichert, die er gerne
@@ -1528,17 +1640,11 @@ definiert man den gewünschten Aufbau über den \PName{Inhalt} der Variablen
\Macro{parbox}-Anweisung (siehe \cite{latex:usrguide}) mehrere Boxen neben-
und untereinander gesetzt werden. Einem versierten Anwender sollte es so
möglich sein, seinen eigenen Briefkopf zu gestalten. Natürlich kann und sollte
-man dabei auch Zugriffe auf andere Variablen mit Hilfe von \DescRef{\LabelBase.cmd.usekomavar}
-nehmen. Die \PName{Bezeichnung} der Variablen \Variable{firsthead} wird von
-\KOMAScript{} nicht verwendet.
-\iffree{}{Ein ausführliches Beispiel für
- Definition eines Briefkopfes wird in \autoref{cha:modernletters} behandelt.}
-
-Lediglich\textnote{Achtung!} aus Gründen der Kompatibilität zu früheren
-Versionen von \Class{scrlttr2} existiert auch noch Anweisung
-\Macro{firsthead}\IndexCmd[indexmain]{firsthead}. Diese sollte jedoch nicht
-mehr verwendet werden.%
-%
+man dabei auch Zugriffe auf andere Variablen mit Hilfe von
+\DescRef{\LabelBase.cmd.usekomavar} nehmen. Die \PName{Bezeichnung} der
+Variablen \Variable{firsthead} wird von \KOMAScript{} nicht verwendet.
+\iffree{}{Ein ausführliches Beispiel für Definition eines Briefkopfes wird in
+ \autoref{cha:modernletters} behandelt.}%
\EndIndexGroup
@@ -1560,20 +1666,19 @@ mehr verwendet werden.%
\end{Declaration}%
\BeginIndex{}{Anschrift}%
Mit der Option \Option{addrfield} kann gewählt werden, ob ein Anschriftfeld
-gesetzt werden soll oder nicht. Voreingestellt ist die
-\iffree{}{\nopagebreak} % Umbruchoptimierung
-Verwendung eines Anschriftfeldes. Die Option versteht die in
-\autoref{tab:\LabelBase.addrfield}\ChangedAt{v3.03}{\Class{scrlttr2}}
+gesetzt werden soll oder nicht. Voreingestellt\textnote{Voreinstellung} ist
+mit \PValue{true} die Verwendung eines Anschriftfeldes. Die Option versteht
+die in \autoref{tab:\LabelBase.addrfield}\ChangedAt{v3.03}{\Class{scrlttr2}}
%, \autopageref{tab:\LabelBase.addrfield}
-angegebenen Werte für den \PName{Modus}. Voreingestellt ist \PValue{true}. Bei
-den Werten \PValue{true},
+angegebenen Werte für den \PName{Modus}. Bei den Werten \PValue{true},
\PValue{topaligned}\ChangedAt{v3.17}{\Class{scrlttr2}\and
\Package{scrletter}}, \PValue{PP} und \PValue{backgroundimage} werden Name
und Adresse des Empfängers, die im Anschriftfeld gesetzt werden, über das
Argument der Umgebung \DescRef{\LabelBase.env.letter} (siehe
-\autoref{sec:\LabelBase.document}, \DescPageRef{\LabelBase.env.letter} )
+\autoref{sec:\LabelBase.document}, \DescPageRef{\LabelBase.env.letter})
bestimmt. Diese Angaben werden außerdem in die Variablen \Variable{toname} und
\Variable{toaddress} kopiert.
+
\BeginIndexGroup
\BeginIndex{FontElement}{addressee}\LabelFontElement{addressee}%
\BeginIndex{FontElement}{toname}\LabelFontElement{toname}%
@@ -1594,11 +1699,12 @@ Adresse des Empfängers beziehen. Für \FontElement{toname} und
\FontElement{toaddress} können also Abweichungen von der Einstellung für
\FontElement{addressee} definiert werden.%
\EndIndexGroup
-
+%
\begin{table}
\caption[{Mögliche Werte für Option \Option{addrfield} bei
- \Class{scrlttr2}}]{Mögliche Werte für Option \Option{addrfield} zur
- Auswahl der Art der Anschrift bei \Class{scrlttr2}%
+ \Class{scrlttr2} und \Package{scrletter}}]
+ {Mögliche Werte für Option \Option{addrfield} zur
+ Auswahl der Art der Anschrift%
\label{tab:\LabelBase.addrfield}}%
\begin{desctabular}
\entry{\PValue{backgroundimage}, \PValue{PPbackgroundimage},
@@ -1634,8 +1740,8 @@ Adresse des Empfängers beziehen. Für \FontElement{toname} und
\end{table}%
Im Anschriftfeld wird in der Voreinstellung \OptionValue{addrfield}{true}
-zusätzlich noch die unterstrichene Rücksendeadresse gesetzt. Mit
-Option \Option{backaddress} kann gewählt werden, ob und in welcher Form die
+zusätzlich noch die unterstrichene Rücksendeadresse gesetzt. Mit Option
+\Option{backaddress} kann gewählt werden, ob und in welcher Form die
Rücksendeadresse\Index{Ruecksendeadresse=Rücksendeadresse} für
Fensterbriefumschläge im Anschriftfeld gesetzt werden soll. Die
Option\important{\OptionValue{backaddress}{false}} versteht dazu einerseits
@@ -1643,18 +1749,19 @@ die Standardwerte für einfache Schalter, die in \autoref{tab:truefalseswitch},
\autopageref{tab:truefalseswitch} angegeben sind. Dabei bleibt der Stil der
Rücksendeadresse unverändert. Beim Einschalten der Rücksendeadresse kann
andererseits\ChangedAt{v2.96}{\Class{scrlttr2}} gleichzeitig auch der Stil der
-Rücksendeadresse gewählt werden. So aktiviert der Wert \PValue{underlined} die
-unterstrichene Rücksendeadresse,
-während\important{\OptionValue{backaddress}{plain}} \PValue{plain} den Stil
-ohne Unterstreichung auswählt. Voreingestellt ist \PValue{underlined}, also
-das Setzen der unterstrichenen Rücksendeadresse.
+Rücksendeadresse gewählt werden. So aktiviert der Wert
+\PValue{underlined}\important{\OptionValue{backaddress}{underlined}} die
+unterstrichene Rücksendeadresse, während
+\PValue{plain}\important{\OptionValue{backaddress}{plain}} den Stil ohne
+Unterstreichung auswählt. Voreingestellt\textnote{Voreinstellung} ist
+\PValue{underlined}, also das Setzen der unterstrichenen Rücksendeadresse.
Die Rücksendeadresse selbst wird über den \PName{Inhalt} der Variable
\Variable{backaddress} bestimmt. Voreingestellt ist hier der über
\DescRef{\LabelBase.variable.fromname} angegebene Name und die über
\DescRef{\LabelBase.variable.fromaddress} angegebene Adresse, wobei der
Doppelbackslash in diesem Fall durch den Inhalt der Variablen
-\Variable{backaddressseparator} ersetzt wird. Für diese ist ein Komma gefolgt
+\Variable{backaddressseparator} ersetzt wird. Für diese ist ein Komma, gefolgt
von einem nicht umbrechbaren Leerzeichen vordefiniert. Die \PName{Bezeichnung}
der Variablen \Variable{backaddress} wird von \KOMAScript{} nicht genutzt.
\BeginIndexGroup\BeginIndex{FontElement}{backaddress}%
@@ -1662,9 +1769,8 @@ der Variablen \Variable{backaddress} wird von \KOMAScript{} nicht genutzt.
Die Schriftart der Rücksendeadresse ist über das Element
\FontElement{backaddress}\important{\FontElement{backaddress}}
konfigurierbar. Voreingestellt ist hierbei \Macro{sffamily} (siehe
-\autoref{tab:\LabelBase.AddresseeElements}), wobei vor der Anwendung der
-konfigurierten Schriftumschaltung noch auf \Macro{scriptsize} umgeschaltet
-wird.%
+\autoref{tab:\LabelBase.AddresseeElements}). Vor der Anwendung der
+konfigurierten Schriftumschaltung wird noch \Macro{scriptsize} ausgeführt.%
\EndIndexGroup
Während die Adresse in der Voreinstellung
@@ -1736,38 +1842,41 @@ Ausrichtung wird mit Hilfe der Pseudolängen \PLength{specialmailindent} und
\DescPageRef{scrlttr2-experts.plength.specialmailindent}) festgelegt. Die
voreingestellte Schriftart des Elements\ChangedAt{v2.97c}{\Class{scrlttr2}}
\FontElement{specialmail}\important{\FontElement{specialmail}}, die Sie
-\autoref{tab:\LabelBase.AddresseeElements} entnehmen können, kann mit Hilfe der
-Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe
-\autoref{sec:\LabelBase.textmarkup},
-\DescPageRef{\LabelBase.cmd.setkomafont}) verändert werden.%
+\autoref{tab:\LabelBase.AddresseeElements} entnehmen können, kann mit Hilfe
+der Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und
+\DescRef{\LabelBase.cmd.addtokomafont} (siehe
+\autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont})
+verändert werden.%
\EndIndexGroup
\BeginIndexGroup
\BeginIndex{FontElement}{priority}\LabelFontElement{priority}%
\BeginIndex{FontElement}{prioritykey}\LabelFontElement{prioritykey}%
-Wird\ChangedAt{v3.03}{\Class{scrlttr2}}\important[i]{\OptionValue{priority}{A}\\
- \OptionValue{priority}{B}} hingegen mit \OptionValue{priority}{A} oder
-\OptionValue{priority}{B} (siehe \autoref{tab:\LabelBase.priority}) eine
-internationale Priorität ausgewählt, so wird diese bei
-\OptionValue{addrfield}{true} als Versandart und bei
+Wird\ChangedAt{v3.03}{\Class{scrlttr2}}\important{\normalcolor
+ \OptionValue{priority}{A}\\
+ \normalcolor\OptionValue{priority}{B}} hingegen mit
+\OptionValue{priority}{A} oder \OptionValue{priority}{B} (siehe
+\autoref{tab:\LabelBase.priority}) eine internationale Priorität ausgewählt,
+so wird diese bei \OptionValue{addrfield}{true} als Versandart und bei
\OptionValue{addrfield}{PP}\important{\OptionValue{addrfield}{PP}} an
entsprechender Stelle im Port-Payé-Kopf gesetzt. Dabei wird die
-Grundschrift\important[i]{\FontElement{priority}\\
- \FontElement{prioritykey}} über das Element
-\FontElement{priority} und die davon
-abweichende Schrift für den Prioritätsschlüssel, »A« oder »B«, über das
-Element \FontElement{prioritykey}
-bestimmt. Die voreingestellten Schriftarten der beiden Elemente, die Sie
-\autoref{tab:\LabelBase.AddresseeElements} entnehmen können, kann mit Hilfe der
-Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe
-\autoref{sec:\LabelBase.textmarkup},
-\DescPageRef{\LabelBase.cmd.setkomafont}) verändert werden.%
+Grundschrift\important{\FontElement{priority}\\
+ \FontElement{prioritykey}} über das Element \FontElement{priority} und die
+davon abweichende Schrift für den Prioritätsschlüssel, »A« oder »B«, über das
+Element \FontElement{prioritykey} bestimmt. Die voreingestellten Schriftarten
+der beiden Elemente, die Sie \autoref{tab:\LabelBase.AddresseeElements}
+entnehmen können, kann mit Hilfe der Anweisungen
+\DescRef{\LabelBase.cmd.setkomafont} und
+\DescRef{\LabelBase.cmd.addtokomafont} (siehe
+\autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont})
+verändert werden.%
\EndIndexGroup
\begin{table}
\caption[{Mögliche Werte für Option \Option{priority} bei
- \Class{scrlttr2}}]{Mögliche Werte für Option \Option{priority} zur
- Auswahl einer internationalen Priorität im Adressfeld von \Class{scrlttr2}}
+ \Class{scrlttr2} und \Class{scrletter}}]
+ {Mögliche Werte für Option \Option{priority} zur
+ Auswahl einer internationalen Priorität im Adressfeld}
\label{tab:\LabelBase.priority}
\begin{desctabular}
\entry{\PValue{false}, \PValue{off}, \PValue{no}, \PValue{manual}}{%
@@ -1776,12 +1885,12 @@ Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.add
\PValue{ECONOMY}, \PValue{B-ECONOMY}, \PValue{B-Economy},
\PValue{b-economy}}{%
Es wird die internationale Priorität B-Economy gesetzt. Bei
- \OptionValue{addrfield}{true} erfolgt dies an Stelle der Versandart.}%
+ \OptionValue{addrfield}{true} erfolgt dies anstelle der Versandart.}%
\entry{\PValue{A}, \PValue{a}, \PValue{priority}, \PValue{Priority},
\PValue{PRIORITY}, \PValue{A-PRIORITY}, \PValue{A-Priority},
\PValue{a-priority}}{%
Es wird die internationale Priorität A-Priority gesetzt. Bei
- \OptionValue{addrfield}{true} erfolgt dies an Stelle der Versandart.}%
+ \OptionValue{addrfield}{true} erfolgt dies anstelle der Versandart.}%
\end{desctabular}
\end{table}
@@ -1790,13 +1899,18 @@ Bei\ChangedAt{v3.03}{\Class{scrlttr2}}\important{\OptionValue{addrfield}{PP}}
Variablen \Variable{fromzipcode} und der Ort aus der Variablen
\Variable{place} gesetzt. Dabei wird der Postleitzahl, also dem \PName{Inhalt}
von \Variable{fromzipcode}, die \PName{Bezeichnung} der Variablen
-\Variable{fromzipcode} gefolgt vom \PName{Inhalt} von
+\Variable{fromzipcode}, gefolgt vom \PName{Inhalt} von
\Variable{zipcodeseparator} vorangestellt. Für diese \PName{Bezeichnung} hängt
die Voreinstellung von der verwendeten \File{lco}-Datei (siehe
\autoref{sec:\LabelBase.lcoFile} ab \autopageref{sec:\LabelBase.lcoFile})
-ab. Für den \PName{Inhalt} von \Variable{zipcodeseparator} ist hingegen ein
-kleiner Abstand, gefolgt von einem Streckenstrich, gefolgt von einem kleinen
-Abstand (\Macro{,}\texttt{-{}-}\Macro{,}) voreingestellt.
+ab. Für den \PName{Inhalt} von \Variable{zipcodeseparator} ist hingegen
+\iffalse % Umbruchvarianten
+ein kleiner Abstand, gefolgt von einem Streckenstrich, gefolgt von einem
+kleinen Abstand (\Macro{,}\texttt{-{}-}\Macro{,}) %
+\else%
+»\Macro{,}\texttt{-{}-}\Macro{,}« %
+\fi%
+voreingestellt.
Darüber\ChangedAt{v3.03}{\Class{scrlttr2}} hinaus wird bei
\OptionValue{addrfield}{PP}\important{\OptionValue{addrfield}{PP}} im
@@ -1826,9 +1940,8 @@ Voreinstellung ist ebenfalls Tabelle
\autoref{tab:\LabelBase.AddresseeElements} zu entnehmen.%
\EndIndexGroup
-Bei\important[i]{\begin{tabular}[t]{@{}l@{}}
- \KOption{addrfield}\\\quad\PValue{backgroundimage}\end{tabular}\strut\\
- \strut\OptionValue{addrfield}{image}} den beiden Einstellungen
+Bei\important{\OptionValue{addrfield}{backgroundimage}\\
+ \OptionValue{addrfield}{image}} den beiden Einstellungen
\OptionValue{addrfield}{backgroundimage}\ChangedAt{v3.03}{\Class{scrlttr2}}
und \OptionValue{addrfield}{image} wird eine Abbildung in das Adressfenster
gesetzt. Diese ist im \PName{Inhalt} der Variablen \Variable{addresseeimage}
@@ -1863,23 +1976,22 @@ Anweisung \Macro{includegraphics} zu verwenden.%
\end{Declaration}
\BeginIndex{}{Absenderergaenzung=Absenderergänzung}%
Neben dem Anschriftfeld setzt \Class{scrlttr2} noch ein Feld mit erweiterter
-Absenderangabe. Der Inhalt ist frei wählbar.
-Je\important[i]{\OptionValueRef{\LabelBase}{fromalign}{center}\\
- \begin{tabular}[t]{@{}l@{}}
- \KOption{fromalign}\\\quad\PValue{locationleft}\end{tabular}\\
- \begin{tabular}[t]{@{}l@{}}
- \KOption{fromalign}\\\quad\PValue{locationright}\end{tabular}} nach
-Einstellung der oben erklärten Option \DescRef{\LabelBase.option.fromalign}
-wird es außerdem für das Logo des Absenders oder den Absender selbst
-mitverwendet. Die Breite dieses Feldes kann beispielsweise in einer
-\File{lco}-Datei (siehe \autoref{sec:\LabelBase.lcoFile}) gesetzt werden. Wird
-dort die Breite 0 gesetzt, so kann über die Option \Option{locfield} zwischen
-zwei unterschiedlichen Voreinstellungen für die Breite dieses Feldes gewählt
-werden. Siehe hierzu auch die Erklärungen zur Pseudolänge \PLength{locwidth}
-in \autoref{sec:scrlttr2-experts.locationField},
-\DescPageRef{scrlttr2-experts.plength.locwidth}. Mögliche Werte für die
-Option sind \autoref{tab:\LabelBase.locfield} zu entnehmen. Voreingestellt ist
-\PValue{narrow}.
+Absenderangabe. Der Inhalt ist frei wählbar. Je\important{%
+ \OptionValueRef{\LabelBase}{fromalign}{locationleft}\\
+ \OptionValueRef{\LabelBase}{fromalign}{center}\\
+ \OptionValueRef{\LabelBase}{fromalign}{locationright}} nach Einstellung der
+oben erklärten Option \DescRef{\LabelBase.option.fromalign} wird es außerdem
+für das Logo des Absenders oder den Absender selbst mitverwendet. Die Breite
+dieses Feldes kann beispielsweise in einer \File{lco}-Datei (siehe
+\autoref{sec:\LabelBase.lcoFile}) gesetzt werden. Wird dort die Breite 0
+gesetzt, so kann über die Option \Option{locfield} zwischen zwei
+unterschiedlichen Voreinstellungen für die Breite dieses Feldes gewählt
+werden. Dies ist bei der Mehrzahl der \File{lco}-Dateien der Fall, die
+\KOMAScript{} beiliegen. Siehe hierzu auch die Erklärungen zur Pseudolänge
+\PLength{locwidth} in \autoref{sec:scrlttr2-experts.locationField},
+\DescPageRef{scrlttr2-experts.plength.locwidth}. Mögliche Werte für die Option
+sind \autoref{tab:\LabelBase.locfield} zu
+entnehmen. Voreingestellt\textnote{Voreinstellung} ist \PValue{narrow}.
%
\begin{table}
% \caption
@@ -1906,8 +2018,8 @@ Option sind \autoref{tab:\LabelBase.locfield} zu entnehmen. Voreingestellt ist
\end{Declaration}
Der Inhalt der Absenderergänzung, soweit er nicht durch Logo oder den Absender
selbst belegt ist, wird mit der Variablen \Variable{location} festgelegt. Für
-den \PName{Inhalt} dieser Variablen dürfen auch Formatierungsanweisungen wie
-\Macro{raggedright} verwendet werden. Die \PName{Bezeichnung} dieser Variablen
+den \PName{Inhalt} dieser Variablen dürfen auch Formatierungsanweisungen, wie
+\Macro{raggedright}, verwendet werden. Die \PName{Bezeichnung} dieser Variablen
wird von \KOMAScript{} nicht genutzt.
\begin{Example}
@@ -1948,21 +2060,25 @@ wahlweise von einem Paket wie \Package{ngerman}\IndexPackage{ngerman},
stammen. Das\important{\OptionValue{numericaldate}{true}} kurze nummerische
Datum wird hingegen von \Class{scrlttr2} selbst erzeugt. Die Option versteht
die Standardwerte für einfache Schalter, die in \autoref{tab:truefalseswitch},
-\autopageref{tab:truefalseswitch} angegeben sind. Voreingestellt ist mit
-\PValue{false} die Verwendung der Standarddarstellung.
+\autopageref{tab:truefalseswitch} angegeben
+sind. Voreingestellt\textnote{Voreinstellung} ist mit \PValue{false} die
+Verwendung der Standarddarstellung.
\begin{Declaration}
\Variable{date}
\end{Declaration}
-Das Datum in der gewählten Darstellung wird in im \PName{Inhalt} der Variablen
-\Variable{date} abgelegt. Die Einstellung von \DescRef{\LabelBase.option.numericaldate} hat keine
-Auswirkung, wenn diese Variable überschrieben wird. Gesetzt wird das Datum
-normalerweise als Teil der Geschäftszeile. Wenn die Geschäftszeile ansonsten
-leer bleibt wird allerdings nur eine Datumszeile, bestehend aus dem Ort und
-dem Datum gesetzt. Trotzdem haben auch in diesem Fall die Einstellungen der
-nachfolgend beschriebenen Option \DescRef{\LabelBase.option.refline} Auswirkungen auf diese
-Datumszeile. Weitere Informationen zum Ort finden Sie in der Beschreibung zur
-Variablen \DescRef{\LabelBase.variable.place}\IndexVariable{place} auf
+Das Datum in der gewählten Darstellung wird im \PName{Inhalt} der Variablen
+\Variable{date} abgelegt. Die Einstellung von
+\DescRef{\LabelBase.option.numericaldate}%
+\important{\DescRef{\LabelBase.option.numericaldate}} hat keine Auswirkung,
+wenn diese Variable überschrieben wird. Gesetzt wird das Datum normalerweise
+als Teil der Geschäftszeile. Wenn die Geschäftszeile ansonsten leer bleibt
+wird allerdings nur eine Datumszeile, bestehend aus dem Ort und dem Datum,
+gesetzt. Trotzdem haben auch in diesem Fall die Einstellungen der nachfolgend
+beschriebenen Option \DescRef{\LabelBase.option.refline} Auswirkungen auf
+diese Datumszeile. Weitere Informationen zum Ort finden Sie in der
+Beschreibung zur Variablen
+\DescRef{\LabelBase.variable.placeseparator}\IndexVariable{placeseparator} auf
\DescPageRef{\LabelBase.variable.placeseparator}.%
%
\EndIndexGroup
@@ -1979,19 +2095,22 @@ Kunden-\Index{Kundennummer} und Rechnungsnummer\Index{Rechnungsnummer} oder
zur Bezugnahme auf ein früheres Schreiben. Diese Zeile wird in dieser
Anleitung \emph{Geschäftszeile}\textnote{Geschäftszeile} genannt.
-Bei \Class{scrlttr2} können Kopf, Fuß, Anschrift und das Feld mit der
-Absenderergänzung links und rechts aus dem normalen Satzspiegel herausragen.
-Über \OptionValue{refline}{wide}\important{\OptionValue{refline}{wide}} kann
+Bei \Class{scrlttr2} und \Package{scrletter} können Kopf, Fuß, Anschrift und
+das Feld mit der Absenderergänzung links und rechts aus dem normalen
+Satzspiegel herausragen. Über
+\OptionValue{refline}{wide}\important{\OptionValue{refline}{wide}} kann
gewählt werden, dass dies auch für die Geschäftszeile gelten soll. Die
Geschäftszeile enthält normalerweise zumindest das Datum, kann aber auch
weitere Angaben aufnehmen. Mögliche Werte für diese Option sind
-\autoref{tab:\LabelBase.refline} zu entnehmen. Voreingestellt sind
-\PValue{narrow} und \PValue{dateright}\ChangedAt{v3.09}{\Class{scrlttr2}}.%
+\autoref{tab:\LabelBase.refline} zu
+entnehmen. Voreingestellt\textnote{Voreinstellung} sind \PValue{narrow} und
+\PValue{dateright}\ChangedAt{v3.09}{\Class{scrlttr2}}.%
%
\begin{table}
\caption[{Mögliche Werte für Option \Option{refline} bei
- \Class{scrlttr2}}]{Mögliche Werte für Option \Option{refline} zur
- Konfiguration der Geschäftszeile bei \Class{scrlttr2}}
+ \Class{scrlttr2} und \Package{scrletter}}]
+ {Mögliche Werte für Option \Option{refline} zur
+ Konfiguration der Geschäftszeile}
\label{tab:\LabelBase.refline}
\begin{desctabular}
\pventry{dateleft}{\ChangedAt{v3.09}{\Class{scrlttr2}}%
@@ -2022,8 +2141,8 @@ Die Bedeutung dieser Felder %
\else %
Ihre Bedeutung %
\fi %
-ist \autoref{tab:\LabelBase.variables}, \autopageref{tab:\LabelBase.variables} zu
-entnehmen. Jede dieser Variablen hat auch eine vordefinierte
+ist \autoref{tab:\LabelBase.variables}, \autopageref{tab:\LabelBase.variables}
+zu entnehmen. Jede dieser Variablen hat auch eine vordefinierte
\PName{Bezeichnung}, die in \autoref{tab:\LabelBase.reflineTerm} zu finden
ist. Wie weitere Variablen zur Geschäftszeile hinzugefügt werden können, ist
in \autoref{sec:scrlttr2-experts.variables} ab
@@ -2061,13 +2180,13 @@ in \autoref{sec:scrlttr2-experts.variables} ab
\BeginIndex{FontElement}{refname}\LabelFontElement{refname}%
\BeginIndex{FontElement}{refvalue}\LabelFontElement{refvalue}%
Schriftart und Farbe\ChangedAt{v2.97c}{\Class{scrlttr2}} der Feldbezeichnung
-und des Feldinhaltes können über die beiden Elemente \FontElement{refname}%
-\important[i]{\FontElement{refname}\\\FontElement{refvalue}} und
-\FontElement{refvalue} geändert werden. Dazu werden die Anweisungen
+und des Feldinhalts können über die beiden Elemente
+\FontElement{refname}\important{\FontElement{refname}, \FontElement{refvalue}}
+und \FontElement{refvalue} geändert werden. Dazu werden die Anweisungen
\DescRef{\LabelBase.cmd.setkomafont} und
\DescRef{\LabelBase.cmd.addtokomafont} (siehe
\autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont})
-verwendet. Die Voreinstellungen der beiden Elemente sind
+verwendet. Die Voreinstellungen der \iffree{beiden }{}Elemente sind
\autoref{tab:\LabelBase.refnamerefvalue} zu entnehmen.%
\begin{table}[tp]
% \centering
@@ -2096,24 +2215,29 @@ verwendet. Die Voreinstellungen der beiden Elemente sind
\begin{Declaration}
\Variable{placeseparator}
\end{Declaration}%
-Sind bis auf \DescRef{\LabelBase.variable.date} alle Variablen der
-Geschäftszeile leer, so wird keine eigentliche Geschäftszeile
+Sind bis auf \DescRef{\LabelBase.variable.date}%
+\important{\DescRef{\LabelBase.variable.date}}\IndexVariable{date} alle
+Variablen der Geschäftszeile leer, so wird keine eigentliche Geschäftszeile
gesetzt. Stattdessen werden dann nur Ort\Index{Ort} und Datum\Index{Datum}
ausgegeben. Dabei bestimmt der \PName{Inhalt} der Variablen
\DescRef{\LabelBase.variable.place} den Ort. Für das Trennzeichen, das in
diesem Fall nach dem Ort gesetzt wird, ist der \PName{Inhalt} der Variablen
-\Variable{placeseparator} zuständig. Der vordefinierte \PName{Inhalt} des
-Trennzeichens ist dabei ein Komma gefolgt von einem nicht umbrechbaren
-Leerzeichen. Ist der Ort leer, so wird auch das Trennzeichen nicht
-gesetzt. Der vordefinierte \PName{Inhalt} der Variablen
-\DescRef{\LabelBase.variable.date} ist \Macro{today}\IndexCmd{today} und hängt
-von der Einstellung der Option \DescRef{\LabelBase.option.numericaldate} ab
-(siehe \DescPageRef{\LabelBase.option.numericaldate}).
+\Variable{placeseparator} zuständig. Der
+vordefinierte\textnote{Voreinstellung} \PName{Inhalt} des Trennzeichens ist
+dabei ein Komma, gefolgt von einem nicht umbrechbaren Leerzeichen. Ist der Ort
+leer, so wird auch das Trennzeichen nicht gesetzt. Der vordefinierte
+\PName{Inhalt} der Variablen \DescRef{\LabelBase.variable.date} ist
+\Macro{today}\IndexCmd{today}\important{\Macro{today}} und hängt von der
+Einstellung der Option \DescRef{\LabelBase.option.numericaldate}%
+\important{\DescRef{\LabelBase.option.numericaldate}}%
+\IndexOption{numericaldate} ab (siehe
+\DescPageRef{\LabelBase.option.numericaldate}).
Seit Version~3.09\ChangedAt{v3.09}{\Class{scrlttr2}} werden Ort und Datum
nicht mehr zwingend rechtsbündig ausgegeben. Stattdessen findet auch im Falle
der Datumszeile die Datumseinstellung von Option
-\DescRef{\LabelBase.option.refline}, wie sie in
+\DescRef{\LabelBase.option.refline}\IndexOption{refline}%
+\important{\DescRef{\LabelBase.option.refline}}, wie sie in
\autoref{tab:\LabelBase.refline} angegeben ist, Anwendung.
\BeginIndexGroup
@@ -2122,7 +2246,7 @@ Falls\ChangedAt{v3.12}{\Class{scrlttr2}} statt der Geschäftszeile eine solche
Datumszeile mit Ort gesetzt wird, so findet nicht die Schrifteinstellung des
Elements \DescRef{\LabelBase.fontelement.refvalue} Anwendung. Stattdessen wird
in diesem Fall das Element
-\FontElement{placeanddate}\important[i]{\FontElement{placeanddate}} verwendet,
+\FontElement{placeanddate}\important{\FontElement{placeanddate}} verwendet,
dessen leere Voreinstellung wie gewohnt mit Hilfe der Anweisungen
\DescRef{\LabelBase.cmd.setkomafont} und
\DescRef{\LabelBase.cmd.addtokomafont} (siehe
@@ -2134,11 +2258,12 @@ geändert werden kann.%
Herr Musterfrau setzt nun auch die Variable für den Ort:
\lstinputcode[xleftmargin=1em]{letter-20.tex}%
Damit erscheint vor dem Datum, wie in \autoref{fig:\LabelBase.letter-20},
- \autopageref{fig:\LabelBase.letter-20} zu sehen, der Ort gefolgt von den
+ \autopageref{fig:\LabelBase.letter-20} zu sehen, der Ort, gefolgt von den
automatischen Trennzeichen vor dem Datum. Dieses Datum wurde im Beispielcode
- über Variable \DescRef{\LabelBase.variable.date} ebenfalls explizit gesetzt, damit bei einem
- späteren \LaTeX-Durchlauf des Briefes das ursprüngliche Datum erhalten
- bleibt und nicht etwa automatisch das Datum des \LaTeX-Laufs verwendet wird.
+ über Variable \DescRef{\LabelBase.variable.date} ebenfalls explizit gesetzt,
+ damit bei einem späteren \LaTeX-Durchlauf des Briefes das ursprüngliche
+ Datum erhalten bleibt und nicht etwa automatisch das Datum des \LaTeX-Laufs
+ verwendet wird.
\begin{figure}
\setcapindent{0pt}%
\begin{captionbeside}[{Beispiel: Brief mit erweitertem Absender, Logo,
@@ -2162,26 +2287,30 @@ geändert werden kann.%
\begin{Declaration}
\Variable{title}
\end{Declaration}
-Bei \Class{scrlttr2} kann ein Brief zusätzlich mit einem Titel\Index{Titel}
+Bei \KOMAScript{} kann ein Brief zusätzlich mit einem Titel\Index{Titel}
versehen werden. Der Titel wird zentriert in der Schriftgröße \Macro{LARGE}
unterhalb der Geschäftszeile ausgegeben.
+
\BeginIndex{FontElement}{lettertitle}\LabelFontElement{lettertitle}%
\BeginIndex{FontElement}{title}\LabelFontElement{title}%
Die Schriftart für das Element\ChangedAt{v3.17}{\Class{scrlttr2}\and
- \Package{scrletter}} \FontElement{lettertitle}
+ \Package{scrletter}} \FontElement{lettertitle}%
\important{\FontElement{lettertitle}} kann mit den Anweisungen
\DescRef{\LabelBase.cmd.setkomafont} und
\DescRef{\LabelBase.cmd.addtokomafont} (siehe
\autoref{sec:\LabelBase.textmarkup} ab
\DescPageRef{\LabelBase.cmd.setkomafont}) geändert werden. Dabei sind auch
-Größenangaben erlaubt. Die Größe \Macro{LARGE} wird der Schriftauswahl dabei
-immer voran gestellt und ist daher auch nicht Teil der Voreinstellung
-\Macro{normalcolor}\Macro{sffamily}\Macro{bfseries}. Bei \Class{scrlttr2} kann
-als Alias für \FontElement{lettertitle} auch
+Größenangaben erlaubt. Die Größe \Macro{LARGE} wird der Schriftauswahl
+innerhalb von \KOMAScript{} immer vorangestellt und ist daher auch nicht
+Teil\textnote{Voreinstellung} der Voreinstellung
+\Macro{normalcolor}\Macro{sffamily}\Macro{bfseries}. Bei
+\Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} kann als Alias für
+\FontElement{lettertitle} auch
\FontElement{title}\important{\FontElement{title}} verwendet werden. Bei
-Verwendung von \Package{scrletter} mit einer \KOMAScript-Klasse ist das nicht
-möglich, da bei diesen Klassen bereits ein Element \FontElement{title} mit
-abweichender Einstellung für den Dokumenttitel existiert.%
+Verwendung von \Package{scrletter} mit einer \KOMAScript-Klasse ist das
+nicht\textnote{Achtung!} möglich, da bei diesen Klassen bereits ein Element
+\FontElement{title} mit abweichender Einstellung für den Dokumenttitel
+existiert.%
\EndIndex{FontElement}{title}%
\EndIndex{FontElement}{lettertitle}%
\begin{Example}
@@ -2210,10 +2339,10 @@ Um einen Betreff zu setzen, legt man den \PName{Inhalt} der Variablen
\OptionValue{subject}{titled}\important{\OptionValue{subject}{titled}} kann
dann zum einen gewählt werden, dass der Betreff mit einem Titel versehen
werden soll oder nicht. Der Titel wird über die Bezeichnung der Variablen
-\Variable{subject} bestimmt (siehe \autoref{tab:\LabelBase.subjectTerm}). Der
-vordefinierte Inhalt des Trennzeichens\Index{Trennzeichen}
-\Variable{subjectseparator} besteht aus einem Doppelpunkt, gefolgt von einem
-Leerzeichen.
+\Variable{subject} bestimmt (siehe \autoref{tab:\LabelBase.subjectTerm}).
+Der\textnote{Voreinstellung} vordefinierte Inhalt des
+Trennzeichens\Index{Trennzeichen} \Variable{subjectseparator} besteht aus
+einem Doppelpunkt, gefolgt von einem Leerzeichen.
\begin{table}
% \centering
@@ -2241,19 +2370,23 @@ Leerzeichen.
\end{table}
Zum anderen kann über \OptionValue{subject}{afteropening}%
-\important{\OptionValue{subject}{afteropening}} gewählt werden, dass der
-Betreff abweichend von der Voreinstellung erst nach der Anrede gesetzt werden
+\important{\OptionValue{subject}{afteropening}\\
+ \OptionValue{subject}{beforeopening}} gewählt werden, dass der Betreff
+abweichend von der Voreinstellung
+\OptionValue{subject}{beforeopening} erst nach der Anrede gesetzt werden
soll. Eine andere Formatierung%
-\important[i]{\OptionValue{subject}{underlined}\\
+\important{\OptionValue{subject}{underlined}\\
\OptionValue{subject}{centered}\\
- \OptionValue{subject}{right}} kann mit \OptionValue{subject}{underlined} und \OptionValue{subject}{centered} oder
+ \OptionValue{subject}{right}} kann mit \OptionValue{subject}{underlined} und
+\OptionValue{subject}{centered} oder
\OptionValue{subject}{right}\ChangedAt{v2.97c}{\Class{scrlttr2}} eingestellt
werden. Mögliche Werte für Option \Option{subject} sind
\autoref{tab:\LabelBase.subject} zu entnehmen. Es\textnote{Achtung!} wird
ausdrücklich darauf hingewiesen, dass bei der Einstellung
\OptionValue{subject}{underlined} der Betreff komplett in eine Zeile passen
-muss! Voreingestellt sind \OptionValue{subject}{left},
-\OptionValue{subject}{beforeopening} und \OptionValue{subject}{untitled}.%
+muss! Voreingestellt\textnote{Voreinstellung} sind
+\OptionValue{subject}{left}, \OptionValue{subject}{beforeopening} und
+\OptionValue{subject}{untitled}.%
%
\begin{table}
% \centering
@@ -2293,20 +2426,22 @@ diese zu ändern, verwenden Sie die Anweisungen
\autoref{sec:\LabelBase.textmarkup} ab
\DescPageRef{\LabelBase.cmd.setkomafont}). Für das
Element\ChangedAt{v3.17}{\Class{scrlttr2}\and \Package{scrletter}}
-\FontElement{lettersubject} \important{\FontElement{lettersubject}} ist als
-Schrift \Macro{normalcolor}\Macro{bfseries} voreingestellt. Bei
-\Class{scrlttr2} kann als Alias für \FontElement{lettersubject} auch
+\FontElement{lettersubject}\important{\FontElement{lettersubject}} ist als
+Schrift \Macro{normalcolor}\Macro{bfseries} voreingestellt. Bei Klasse
+\Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} kann als Alias für
+\FontElement{lettersubject} auch
\FontElement{subject}\important{\FontElement{subject}} verwendet werden. Bei
-Verwendung von \Package{scrletter} mit einer \KOMAScript-Klasse ist das nicht
-möglich, da bei diesen Klassen bereits ein Element \FontElement{subject} mit
-abweichender Einstellung für den Dokumenttitel existiert.
+Verwendung von Paket \Package{scrletter} mit einer \KOMAScript-Klasse ist das
+nicht\textnote{Achtung!} möglich, da bei diesen Klassen bereits ein Element
+\FontElement{subject} mit abweichender Einstellung für den Dokumenttitel
+existiert.
\EndIndexGroup
\begin{Example}
Herr Musterfrau setzt nun auch den Betreff. Als eher traditioneller
veranlagter Mensch möchte er außerdem, dass der Betreff mit einer
- entsprechenden Spitzmarke versehen wird und setzt deshalb auch die
- entsprechende Option:%
+ entsprechenden Spitzmarke versehen wird, und setzt deshalb auch die
+ zugehörige Option:%
\lstinputcode[xleftmargin=1em]{letter-21.tex}%
Das Ergebnis ist in \autoref{fig:\LabelBase.letter-21} zu sehen.
\begin{figure}
@@ -2343,7 +2478,8 @@ Satzspiegel und Seitenfuß.
Die Option versteht die Standardwerte für einfache Schalter, die in
\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} angegeben
-sind. Voreingestellt ist das Setzen des Briefbogenfußes.%
+sind. Voreingestellt\textnote{Voreinstellung} ist das Setzen des
+Briefbogenfußes.%
%
\EndIndexGroup
@@ -2401,47 +2537,48 @@ neue Festlegung zu treffen. Die \PName{Bezeichnung} der Variablen wird von
}%
}
\end{lstcode}
- Das Beispiel stammt ursprünglich von Torsten Krüger, und mit
+ Das Beispiel stammt ursprünglich von Torsten Krüger. Es wird empfohlen, eine
+ solche Definition für die mehrfache Verwendung in unterschiedlichen
+ Dokumenten in einer eigenen
+ \File{lco}-Datei\Index{lco-Datei=\File{lco}-Datei} abzulegen. Mit
\begin{lstcode}
\setkomavar{frombank}{IBAN DE21~87654321~13456789\\
bei der HansWurstBank\\
BIC GRMLDEHD000}
\end{lstcode}
- kann die Bankverbindung passend dazu gesetzt werden.
-% Abhängig von den
-% Voreinstellungen ist ein solch hoher Fuß nicht vorgesehen und wird deshalb
-% möglicherweise zu tief platziert. In einem solchen Fall kann die vertikale
-% Position über die Pseudolänge
-% \PLength{firstfootvpos}\IndexPLength{firstfootvpos} angepasst werden (siehe
-% \DescPageRef{scrlttr2-experts.plength.firstfootvpos}).
+ kann die Bankverbindung dann im Dokument passend dazu gesetzt werden.%
+\iffalse% Umbruchkorrekturmöglichkeit
+ \ Abhängig\textnote{Achtung!} von den Voreinstellungen ist ein solch hoher
+ Fuß jedoch eventuell nicht vorgesehen und wird deshalb möglicherweise zu
+ tief platziert. In einem solchen Fall kann die vertikale Position über die
+ Pseudolänge \DescRef{scrlttr2-experts.plength.firstfootvpos}%
+ \important{\DescRef{scrlttr2-experts.plength.firstfootvpos}}%
+ \IndexPLength{firstfootvpos} angepasst werden (siehe
+ \DescPageRef{scrlttr2-experts.plength.firstfootvpos}).%
+\fi
\end{Example}
Im\textnote{Achtung!} Beispiel wurde ein mehrzeiliger Fuß gesetzt. Bei einer
-Kompatibilitätseinstellung ab Version 2.9u (siehe
+Kompatibilitätseinstellung ab Version
+2.9u\important{\OptionValueRef{\LabelBase}{version}{2.9u}} (siehe
\DescRef{\LabelBase.option.version} in
\autoref{sec:\LabelBase.compatibilityOptions},
-\DescPageRef{\LabelBase.option.version}) reicht der Platz dafür in der
-Regel nicht aus. Sie sollten dann \PLength{firstfootvpos} (siehe
+\DescPageRef{\LabelBase.option.version}) reicht der Platz dafür in der Regel
+nicht aus. Sie sollten dann \PLength{firstfootvpos} (siehe
\DescPageRef{scrlttr2-experts.plength.firstfootvpos}) entsprechend
-verringern.
-
-Lediglich\textnote{Achtung!} aus Gründen der Kompatibilität zu früheren
-Versionen von \Class{scrlttr2} existiert auch noch Anweisung
-\Macro{firstfoot}\IndexCmd[indexmain]{firstfoot}. Diese sollte jedoch nicht
-mehr verwendet werden.%
-%
+verringern.%
\EndIndexGroup
\begin{Declaration}
\Variable{frombank}
\end{Declaration}%
-\BeginIndex{}{Briefbogenfuss=Briefbogenfuß}
-Die im vorherigen Beispiel verwendete Variable \Variable{frombank} nimmt
-derzeit eine Sonderstellung ein. Sie wird intern bisher nicht verwendet. Sie
-kann jedoch vom Anwender verwendet werden, um die
-Bankverbindung\Index{Bankverbindung} in das Absenderergänzungsfeld (siehe
-Variable \DescRef{\LabelBase.variable.location}, \DescPageRef{\LabelBase.variable.location})
-oder wie im Beispiel in den Fuß zu setzen.%
+\BeginIndex{}{Briefbogenfuss=Briefbogenfuß} Die im vorherigen Beispiel
+verwendete Variable \Variable{frombank} nimmt derzeit eine Sonderstellung
+ein. Sie wird intern bisher nicht verwendet. Sie kann jedoch vom Anwender
+verwendet werden, um die Bankverbindung\Index{Bankverbindung} in das
+Absenderergänzungsfeld (siehe Variable \DescRef{\LabelBase.variable.location},
+\DescPageRef{\LabelBase.variable.location}) oder wie im Beispiel in den Fuß zu
+setzen.%
%
\EndIndexGroup
%
@@ -2473,38 +2610,41 @@ auch der Seitenstil aller Rückseiten betroffen.
\end{Declaration}
Der\ChangedAt{v3.19}{\Class{scrlttr2}\and \Package{scrletter}} für Briefe
voreingestellte Seitenstil wird durch den Inhalt dieser Anweisung bestimmt. In
-der Voreinstellung von \Class{scrlttr2} ist die Anweisung leer definiert. Das
-bedeutet, dass der Seitenstil von Briefen dem des restlichen Dokuments
-entspricht. Dies ist deshalb sinnvoll, weil \Class{scrlttr2} für reine
-Briefdokumente gedacht ist und es dafür einfacher ist, den Seitenstil wie
-gewohnt mit \DescRef{\LabelBase.cmd.pagestyle} global einzustellen.
-
-Da der \PageStyle{plain}-Seitenstil von Briefen vom
-\PageStyle{plain}-Seitenstil anderer Klassen abweicht, ist für das Paket
-\Package{scrletter} der Seitenstil
-\PageStyle{plain.letter}\IndexPagestyle{plain.letter} in der Anweisung
-gespeichert. Damit werden alle Briefe mit dem zum Seitenstil
-\PageStyle{letter}\IndexPagestyle{letter} gehörenden
-\PageStyle{plain}-Seitenstil gesetzt unabhängig davon, was für das restliche
-Dokument als Seitenstil eingestellt ist. Siehe
-\autoref{sec:scrlttr2-experts.pagestyleatscrletter}
-%, \DescPageRef{scrlttr2-experts.pagestyle.letter}
-für weitere Informationen zu den Besonderheiten der Seitenstile von Paket
-\Package{scrletter}.
+der Voreinstellung\textnote{Voreinstellung} von
+\Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} ist die Anweisung leer
+definiert. Das bedeutet, dass der Seitenstil von Briefen dem des restlichen
+Dokuments entspricht. Dies ist deshalb sinnvoll, weil \Class{scrlttr2} für
+reine Briefdokumente gedacht ist und es dafür einfacher ist, den Seitenstil
+wie gewohnt mit \DescRef{\LabelBase.cmd.pagestyle} global einzustellen.
+
+Da sowohl Seitenstil \DescRef{\LabelBase.pagestyle.plain} als auch der Stil
+\DescRef{\LabelBase.pagestyle.headings} anderer Klassen vom gewünschten
+Seitenstil für Briefe abweicht, ist für das Paket
+\Package{scrletter}\OnlyAt{\Package{scrletter}}\textnote{Voreinstellung} der
+Seitenstil
+\DescRef{\LabelBase.pagestyle.plain.letter}\IndexPagestyle{plain.letter}%
+\important{\DescRef{\LabelBase.pagestyle.plain.letter}} in der Anweisung
+\Macro{letterpagestyle} gespeichert. Damit werden alle Briefe mit dem zum
+Seitenstil \DescRef{\LabelBase.pagestyle.letter}\IndexPagestyle{letter}
+gehörenden
+\hyperref[desc:\LabelBase.pagestyle.plain.letter]{\PageStyle{plain}}-Seitenstil
+gesetzt unabhängig davon, was für das restliche Dokument als Seitenstil
+eingestellt ist.
\begin{Example}
Sie wollen auch bei Verwendung von Paket \Package{scrletter}, dass die
Briefe in dem Seitenstil gesetzt werden, der für das Dokument selbst mit
- \DescRef{\LabelBase.cmd.pagestyle} eingestellt wurde. Dazu schreiben sie die Anweisung
+ \DescRef{\LabelBase.cmd.pagestyle} eingestellt wurde. Dazu schreiben sie die
+ Anweisung
\begin{lstcode}
\renewcommand*{\letterpagestyle}{}
\end{lstcode}
in die Dokumentpräambel. Dabei ist übrigens der Stern bei
\Macro{renewcommand*} wichtig!%
\end{Example}
-Natürlich haben die Anweisung \DescRef{\LabelBase.cmd.pagestyle} und \DescRef{\LabelBase.cmd.thispagestyle}
-innerhalb eines Briefes Vorrang vor dem innerhalb von
-\Macro{begin}\PParameter{letter} über \Macro{letterpagestyle} eingestellten
-Seitenstil.%
+Natürlich haben die Anweisung \DescRef{\LabelBase.cmd.pagestyle} und
+\DescRef{\LabelBase.cmd.thispagestyle} innerhalb eines Briefes Vorrang vor dem
+innerhalb von \Macro{begin}\PParameter{letter} über \Macro{letterpagestyle}
+eingestellten Seitenstil.%
\EndIndexGroup
@@ -2512,36 +2652,38 @@ Seitenstil.%
\OptionVName{headsepline}{Ein-Aus-Wert}
\OptionVName{footsepline}{Ein-Aus-Wert}
\end{Declaration}%
-Mit diesen Optionen kann eingestellt werden, ob eine
-Trennlinie\Index{Trennlinie}\Index{Linie} unter dem Kopf\Index{Seiten>Kopf}
-oder über dem Fuß\Index{Seiten>Fuss=Fuß} von Folgeseiten gewünscht wird. Als
-\PName{Ein-Aus-Wert} kann einer der Standardwerte für einfache Schalter aus
-\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet
+Mit diesen Optionen kann bei \Class{scrlttr2}\OnlyAt{scrlttr2} eingestellt
+werden, ob eine Trennlinie\Index{Trennlinie}\Index{Linie} unter dem
+Kopf\Index{Seiten>Kopf} oder über dem Fuß\Index{Seiten>Fuss=Fuß} von
+Folgeseiten gewünscht wird. Als \PName{Ein-Aus-Wert} kann einer der
+Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch},
+\autopageref{tab:truefalseswitch} verwendet
werden. Ein\important{\OptionValue{headsepline}{true}} Aktivieren der Option
\Option{headsepline} schaltet die Linie unter dem Kopf
ein. Ein\important{\OptionValue{footsepline}{true}} Aktivieren der Option
\Option{footsepline} schaltet die Linie über dem Fuß ein. Die Deaktivierung
der Optionen schaltet die jeweilige Linie aus.
-Beim Seitenstil \PValue{empty}\important{\PageStyle{empty}} (siehe später in
+Beim Seitenstil \DescRef{\LabelBase.pagestyle.empty}%
+\important{\DescRef{\LabelBase.pagestyle.empty}} (siehe später in
diesem Abschnitt) haben die Optionen \Option{headsepline} und
\Option{footsepline} selbstverständlich keine Auswirkung. Bei diesem
Seitenstil soll ja auf Seitenkopf\Index{Seiten>Kopf} und
Seitenfuß\Index{Seiten>Fuss=Fuß} ausdrücklich verzichtet werden.
-Typografisch\important[i]{\PageStyle{headings}\\
- \PageStyle{myheadings}\\
- \PageStyle{plain}} betrachtet hat eine solche Linie immer die Auswirkung,
-dass der Kopf oder Fuß optisch näher an den Text heranrückt. Dies bedeutet
-nun nicht, dass Kopf oder Fuß räumlich weiter vom
-Textkörper\Index{Text>Bereich} weggerückt werden müssten. Stattdessen sollte
+Typografisch\important{\DescRef{\LabelBase.pagestyle.headings}\\
+ \DescRef{\LabelBase.pagestyle.myheadings}\\
+ \DescRef{\LabelBase.pagestyle.plain}} betrachtet hat eine solche Linie immer
+die Auswirkung, dass der Kopf oder Fuß optisch näher an den Text heranrückt.
+Dies bedeutet nun nicht, dass Kopf oder Fuß räumlich weiter vom
+Textkörper\Index{Text>Bereich} weggerückt werden müssten. Stattdessen sollten
sie dann bei der Berechnung des Satzspiegels als zum Textkörper gehörend
-betrachtet werden. Dies wird bei {\KOMAScript} dadurch erreicht, dass bei
+betrachtet werden. Dies wird bei \Class{scrlttr2} dadurch erreicht, dass bei
Verwendung der Klassenoption \Option{headsepline} automatisch die Paketoption
\DescRef{typearea.option.headinclude}%
\important{\DescRef{typearea.option.headinclude}} mit gleichem Wert an das
-\Package{typearea}-Paket weitergereicht wird. Entsprechendes gilt bei
-\DescRef{\LabelBase.option.footsepline} für
+\hyperref[cha:typearea]{\Package{typearea}}-Paket weitergereicht
+wird. Entsprechendes gilt bei \DescRef{\LabelBase.option.footsepline} für
\DescRef{typearea.option.footinclude}%
\important{\DescRef{typearea.option.footinclude}}.
@@ -2552,10 +2694,30 @@ aus. Zur Neuberechnung des Satzspiegels siehe Option
Anweisung \DescRef{typearea.cmd.recalctypearea} (siehe
\DescPageRef{typearea.cmd.recalctypearea}) in \autoref{cha:typearea}.
-Das Paket \Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage}%
-\important{\Package{scrlayer-scrpage}} (siehe \autoref{cha:scrlayer-scrpage})
-bietet weitere Einflussmöglichkeiten für Linien im Kopf und Fuß und kann auch
-mit \Class{scrlttr2} kombiniert werden.%
+Das Paket \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} (siehe
+\autoref{cha:scrlayer-scrpage}) bietet weitere Einflussmöglichkeiten für
+Linien im Kopf und Fuß und kann auch mit \Class{scrlttr2} kombiniert
+werden. Das Paket \Package{scrletter} verwendet hingegen automatisch
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} zur
+Definition der Seitenstile \DescRef{\LabelBase.pagestyle.letter} und
+\DescRef{\LabelBase.pagestyle.plain.letter}.
+
+Die von \Package{scrletter}\OnlyAt{\Package{scrletter}} definierten Seitenstile
+\DescRef{\LabelBase.pagestyle.letter} und
+\DescRef{\LabelBase.pagestyle.plain.letter} unterliegen den Regeln von
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}. Dies betrifft
+insbesondere das Setzen der Linien in Kopf und Fuß des
+\PageStyle{plain}-Seitenstils
+\DescRef{\LabelBase.pagestyle.plain.letter}. Siehe dazu in
+\autoref{sec:scrlayer-scrpage.pagestyle.content},
+\DescPageRef{scrlayer-scrpage.option.headsepline} und
+\DescPageRef{scrlayer-scrpage.option.plainheadsepline} die Optionen
+\DescRef{scrlayer-scrpage.option.headsepline} und
+\DescRef{scrlayer-scrpage.option.plainheadsepline}. Auch Einstellungen wie
+\DescRef{scrlayer-scrpage.option.automark} sind für den Seitenstil
+\DescRef{\LabelBase.pagestyle.letter} von einiger Bedeutung.%
%
\EndIndexGroup
@@ -2564,24 +2726,31 @@ mit \Class{scrlttr2} kombiniert werden.%
\OptionVName{pagenumber}{Position}
\end{Declaration}
Mit Hilfe dieser Option kann bestimmt werden, ob und wo eine Seitenzahl auf
-Folgeseiten gesetzt werden soll. Die Option wirkt sich auf die
-Seitenstile\important[i]{\PageStyle{headings}\\
- \PageStyle{myheadings}\\
- \PageStyle{plain}} \PValue{headings}, \PValue{myheadings} und \PValue{plain}
-aus. Sie beeinflusst außerdem die Voreinstellung der Seitenstile des Pakets
-\Package{scrlayer-scrpage}\important{\Package{scrlayer-scrpage}}%
-\IndexPackage{scrlayer-scrpage}, soweit sie vor dem Laden des Paketes gesetzt
+Folgeseiten gesetzt werden soll. Die Option wirkt sich bei
+\Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} auf die
+Seitenstile\important{\DescRef{\LabelBase.pagestyle.headings}\\
+ \DescRef{\LabelBase.pagestyle.myheadings}\\
+ \DescRef{\LabelBase.pagestyle.plain}}
+\DescRef{\LabelBase.pagestyle.headings},
+\DescRef{\LabelBase.pagestyle.myheadings} und
+\DescRef{\LabelBase.pagestyle.plain} und bei
+\Package{scrletter}\OnlyAt{\Package{scrletter}} auf
+\DescRef{\LabelBase.pagestyle.letter} und
+\DescRef{\LabelBase.pagestyle.plain.letter} aus. Sie beeinflusst außerdem die
+Voreinstellung der Seitenstile des Pakets
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}%
+\IndexPackage{scrlayer-scrpage}, soweit sie vor dem Laden des Pakets gesetzt
wird (siehe \autoref{cha:scrlayer-scrpage}). Es gibt Werte, die sich nur auf
die horizontale Position auswirken, Werte, die nur die vertikale Position
beeinflussen, und Werte, die zugleich die vertikale und die horizontale
Position festlegen. Mögliche Werte sind \autoref{tab:\LabelBase.pagenumber} zu
-entnehmen. Voreingestellt ist \PValue{botcenter}.
+entnehmen. Voreingestellt\textnote{Voreinstellung} ist \PValue{botcenter}.
\begin{table}[t!]% Umbruchkorrektur
- \caption[{Mögliche Werte für Option \Option{pagenumber} bei
- \Class{scrlttr2}}]{Mögliche Werte für Option \Option{pagenumber} zur
- Positionierung der Paginierung bei den Seitenstilen \PValue{headings},
- \PValue{myheadings} und \PValue{plain} von \Class{scrlttr2}}
+ \caption[{Mögliche Werte für Option \Option{pagenumber} bei \Class{scrlttr2}
+ und \Package{scrletter}}]{Mögliche Werte für Option \Option{pagenumber}
+ zur Positionierung der Paginierung innerhalb der Seitenstile}
\label{tab:\LabelBase.pagenumber}
\begin{desctabular}
\entry{\PValue{bot}, \PValue{foot}}{%
@@ -2623,56 +2792,123 @@ entnehmen. Voreingestellt ist \PValue{botcenter}.
\BeginIndex{Pagestyle}{plain}%
\BeginIndex{Pagestyle}{headings}%
\BeginIndex{Pagestyle}{myheadings}%
-Bei Briefen mit \Class{scrlttr2} wird zwischen vier verschiedenen
-Seitenstilen unterschieden.
-\begin{description}
-\item[{\PageStyle{empty}}] ist der Seitenstil, bei dem Kopf- und Fußzeile von
+Bei Briefen mit \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} wird zwischen vier
+verschiedenen Seitenstilen unterschieden. Dagegen definiert
+\Package{scrletter}\OnlyAt{\Package{scrletter}} nur zwei eigene Seitenstile.
+\begin{description}\setkomafont{descriptionlabel}{}
+\item[{\PageStyle{empty}}]
+ \LabelPageStyle{empty}%
+ ist der Seitenstil, bei dem Kopf- und Fußzeile von
Folgeseiten vollständig leer bleiben. Dieser Seitenstil wird auch
automatisch für die erste Briefseite verwendet, da auf dieser Seite Kopf und
Fuß über \DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} (siehe
\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.cmd.opening})
mit anderen Mitteln gesetzt werden.
-\item[{\PageStyle{headings}}] ist der Seitenstil für automatische
- Kolumnentitel auf Folgeseiten. Dabei werden als automatisch gesetzte Marken
- der Absendername aus der Variablen
+\item[{\PageStyle{headings}}]
+ \LabelPageStyle{headings}%
+ ist bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} der Seitenstil für
+ automatische Kolumnentitel auf Folgeseiten. Dabei werden als automatisch
+ gesetzte Marken der Absendername aus der Variablen
\DescRef{\LabelBase.variable.fromname}\IndexVariable{fromname} und der
- Betreff aus der Variablen \DescRef{\LabelBase.variable.subject}\IndexVariable{subject}
- verwendet (siehe \autoref{sec:\LabelBase.firstpage},
+ Betreff aus der Variablen
+ \DescRef{\LabelBase.variable.subject}\IndexVariable{subject} verwendet
+ (siehe \autoref{sec:\LabelBase.firstpage},
\DescPageRef{\LabelBase.variable.fromname} und
\DescPageRef{\LabelBase.variable.subject}). Wo genau diese Marken und die
Seitenangabe ausgegeben werden, hängt von der oben erklärten Option
\DescRef{\LabelBase.option.pagenumber} und dem Inhalt der Variablen
\DescRef{\LabelBase.variable.nexthead}\IndexVariable{nexthead} und
- \DescRef{\LabelBase.variable.nextfoot}\IndexVariable{nextfoot} ab. Der Autor kann die Marken
- aber auch noch nach \DescRef{\LabelBase.cmd.opening} manuell
+ \DescRef{\LabelBase.variable.nextfoot}\IndexVariable{nextfoot} ab. Der Autor
+ kann die Marken aber auch noch nach \DescRef{\LabelBase.cmd.opening} manuell
beeinflussen. Hierzu stehen wie üblich die Anweisungen
\DescRef{\LabelBase.cmd.markboth} und \DescRef{\LabelBase.cmd.markright},
- bei Verwendung von \Package{scrlayer-scrpage}%
- \IndexPackage{scrlayer-scrpage}\important{\Package{scrlayer-scrpage}} auch
- \DescRef{scrlayer-scrpage.cmd.markleft} (siehe
+ bei Verwendung von
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ \IndexPackage{scrlayer-scrpage}%
+ \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}
+ auch \DescRef{scrlayer-scrpage.cmd.markleft} (siehe
\autoref{sec:scrlayer-scrpage.pagestyle.content},
\DescPageRef{scrlayer-scrpage.cmd.markleft}), zur Verfügung.
-\item[{\PageStyle{myheadings}}] ist der Seitenstil für manuelle Kolumnentitel
- auf Folgeseiten. Im Unterschied zu \PValue{headings} müssen die Marken vom
- Anwender gesetzt werden. Er verwendet dazu die Anweisungen
- \DescRef{\LabelBase.cmd.markboth}\IndexCmd{markboth} und
+
+ Da \Package{scrletter}\OnlyAt{scrletter} intern
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} verwendet, wird
+ ein eventuell von der Klasse bereitgestellter Seitenstil
+ \DescRef{maincls.pagestyle.headings} als Alias von
+ \DescRef{scrlayer-scrpage.pagestyle.scrheadings} umdefiniert. Näheres zu
+ diesem Seitenstil ist in \autoref{cha:scrlayer-scrpage} auf
+ \DescPageRef{scrlayer-scrpage.pagestyle.scrheadings} zu erfahren.
+\item[{\PageStyle{letter}}]
+ \LabelPageStyle{letter}%
+ Da der Seitenstil \PageStyle{headings} im allgemeinen bereits von den
+ Klassen belegt ist, definiert das Paket
+ \Package{scrletter}\OnlyAt{scrletter} stattdessen einen Seitenstil
+ \PageStyle{letter}. Dies geschieht mit Hilfe von
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} aus
+ \autoref{cha:scrlayer-scrpage}, \autopageref{cha:scrlayer-scrpage}. Bei der
+ Einstellung \OptionValueRef{scrlayer-scrpage}{automark}{true}%
+ \important{\OptionValueRef{scrlayer-scrpage}{automark}{true}}%
+ \IndexOption{automark} übernimmt \PageStyle{letter} dann die Rolle, die bei
+ \Class{scrlttr2} von \PageStyle{headings} ausgefüllt wird. Bei
+ \OptionValueRef{scrlayer-scrpage}{automark}{false}%
+ \important{\OptionValueRef{scrlayer-scrpage}{automark}{false}}%
+ \IndexOption{automark} übernimmt \PageStyle{letter} dagegen die Rolle von
+ \PageStyle{myheadings}.
+
+ Durch\textnote{Achtung!} die Verwendung von
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} kann das
+ veraltete Paket \Package{scrpage2}\IndexPackage{scrpage2}
+ oder das mit \KOMAScript{} wenig kompatible Paket
+ \Package{fancyhdr}\IndexPackage{fancyhdr} nicht zusammen mit
+ \Package{scrletter} verwendet werden.
+\item[{\PageStyle{myheadings}}]
+ \LabelPageStyle{myheadings}%
+ ist bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} der Seitenstil für
+ manuelle Kolumnentitel auf Folgeseiten. Im Unterschied zu \PValue{headings}
+ müssen die Marken vom Anwender gesetzt werden. Er verwendet dazu die
+ Anweisungen \DescRef{\LabelBase.cmd.markboth}\IndexCmd{markboth} und
\DescRef{\LabelBase.cmd.markright}\IndexCmd{markright}. Bei Verwendung von
- \Package{scrlayer-scrpage} steht außerdem
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} steht außerdem
\DescRef{scrlayer-scrpage.cmd.markleft}\IndexCmd{markleft} zur Verfügung.
-\item[{\PageStyle{plain}}] ist der voreingestellte Seitenstil, bei dem auf
- Folgeseiten keinerlei Kolumnentitel verwendet, sondern nur eine Seitenangabe
- ausgegeben wird. Wo diese gesetzt wird, hängt von der oben erklärten Option
+
+ Beim Paket \Package{scrletter}\OnlyAt{\Package{scrletter}} übernimmt der
+ Seitenstil \PageStyle{letter} ebenfalls die Rolle von
+ \PageStyle{myheadings}.
+\item[{\PageStyle{plain}}]
+ \LabelPageStyle{plain}%
+ ist bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}}
+ der voreingestellte Seitenstil, bei dem auf Folgeseiten keinerlei
+ Kolumnentitel verwendet, sondern nur eine Seitenangabe ausgegeben wird. Wo
+ diese gesetzt wird, hängt von der oben erklärten Option
\DescRef{\LabelBase.option.pagenumber} ab.
+
+ Da \Package{scrletter}\OnlyAt{scrletter} intern
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} verwendet, wird
+ der Seitenstil \DescRef{maincls.pagestyle.plain} als Alias von
+ \DescRef{scrlayer-scrpage.pagestyle.plain.scrheadings} umdefiniert. Näheres
+ zu diesem Seitenstil ist in \autoref{cha:scrlayer-scrpage} auf
+ \DescPageRef{scrlayer-scrpage.pagestyle.scrheadings} zu erfahren.
+\item[{\PageStyle{plain.letter}}]
+ \LabelPageStyle{plain.letter}%
+ Da der Seitenstil \PageStyle{plain} im allgemeinen bereits von den Klassen
+ belegt ist, definiert das Paket \Package{scrletter}\OnlyAt{scrletter}
+ stattdessen einen Seitenstil \PageStyle{plain.letter}. Dies geschieht mit
+ Hilfe von \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}.
+ Durch\textnote{Achtung!} diese Verwendung von
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} kann das
+ veraltete Pakete \Package{scrpage2}\IndexPackage{scrpage2} oder das mit
+ \KOMAScript{} wenig kompatible Paket
+ \Package{fancyhdr}\IndexPackage{fancyhdr} nicht zusammen mit
+ \Package{scrletter} verwendet werden.
\end{description}
Die Form der Seitenstile wird außerdem durch die oben erklärten
-Optionen\important[i]{\DescRef{\LabelBase.option.headsepline}\\
+Optionen\important{\DescRef{\LabelBase.option.headsepline}\\
\DescRef{\LabelBase.option.footsepline}}
\DescRef{\LabelBase.option.headsepline}\IndexOption{headsepline} und
\DescRef{\LabelBase.option.footsepline}\IndexOption{footsepline}
beeinflusst. Der Seitenstil ab der aktuellen Seite wird mit \Macro{pagestyle}
umgeschaltet. Demgegenüber verändert \Macro{thispagestyle} nur den Seitenstil
-der aktuellen Seite. Die\textnote{Achtung!} Briefklasse verwendet
+der aktuellen Seite. \KOMAScript\textnote{Achtung!} verwendet
\Macro{thispagestyle}\PParameter{empty} selbst innerhalb von
\DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} für die erste Briefseite.
@@ -2691,12 +2927,13 @@ Fuß\ChangedAt{v3.00}{\Class{scrlttr2}} ist zusätzlich auch noch das Element
\FontElement{pagefoot}\important{\FontElement{pagefoot}} zuständig, das nach
\FontElement{pageheadfoot} in mit Variable
\DescRef{\LabelBase.variable.nextfoot}\IndexVariable{nextfoot} oder per Paket
-\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage}%
-\important{\Package{scrlayer-scrpage}} (siehe \autoref{cha:scrlayer-scrpage},
-\DescPageRef{scrlayer-scrpage.fontelement.pagefoot}) definierten
-Seitenstilen zur Anwendung kommt. Das Element für die Seitenzahl innerhalb des
-Kopfes oder Fußes heißt
-\FontElement{pagenumber}\important{\FontElement{pagenumber}}. Die
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} (siehe
+\autoref{cha:scrlayer-scrpage},
+\DescPageRef{scrlayer-scrpage.fontelement.pagefoot}) definierten Seitenstilen
+zur Anwendung kommt. Das Element für die Seitenzahl innerhalb des Kopfes oder
+Fußes heißt \FontElement{pagenumber}\important{\FontElement{pagenumber}}. Die
Voreinstellungen sind in \autoref{tab:maincls.defaultFontsHeadFoot},
\autopageref{tab:maincls.defaultFontsHeadFoot} zu finden. Beachten Sie dazu
auch das Beispiel aus \autoref{sec:maincls.pagestyle},
@@ -2711,17 +2948,20 @@ auch das Beispiel aus \autoref{sec:maincls.pagestyle},
\Macro{markboth}\Parameter{linke Marke}\Parameter{rechte Marke}
\Macro{markright}\Parameter{rechte Marke}
\end{Declaration}
-In den meisten Fällen werden die Möglichkeiten, die \Class{scrlttr2} über
+In den meisten Fällen werden die Möglichkeiten, die \KOMAScript{} über
Optionen und Variablen für die Gestaltung des Seitenkopfes\Index{Kopf} und
-fußes\Index{Fuss=Fuß} auf Folgeseiten\Index{Folgeseite} zur Verfügung stellt,
-vollkommen ausreichen. Dies umso mehr, als man zusätzlich mit
+vollkommen ausreichen. Dies gilt umso mehr, als man zusätzlich mit
\Macro{markboth} und \Macro{markright} die Möglichkeit hat, die Angaben zu
-ändern, die \Class{scrlttr2} in den Kopf setzt. Die Anweisungen
-\Macro{markboth}\IndexCmd{markboth} und \Macro{markright}\IndexCmd{markright}
-können insbesondere mit dem Seitenstil \PageStyle{myheadings}%
+ändern, die \Class{scrlttr2} oder \Package{scrletter} in den Kopf setzt. Die
+Anweisungen \Macro{markboth}\IndexCmd{markboth} und
+\Macro{markright}\IndexCmd{markright} können insbesondere mit dem Seitenstil
+\PageStyle{myheadings}%
\IndexPagestyle{myheadings}\important{\PageStyle{myheadings}} verwendet
-werden. Bei Verwendung des Pakets \Package{scrlayer-scrpage}%
-\IndexPackage{scrlayer-scrpage}\important{\Package{scrlayer-scrpage}} gilt
+werden. Bei Verwendung des Pakets
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} gilt
dies natürlich auch für den Seitenstil \PageStyle{scrheadings}%
\IndexPagestyle{scrheadings}\important{\PageStyle{scrheadings}}. Dort steht
außerdem die Anweisung \DescRef{scrlayer-scrpage.cmd.markleft}%
@@ -2738,11 +2978,15 @@ In einigen wenigen Fällen will man jedoch den Kopf oder Fuß der Folgeseiten
muss auf die vordefinierten Möglichkeiten, die per oben erklärter Option
\DescRef{\LabelBase.option.pagenumber}\IndexOption{pagenumber} auswählbar
sind, verzichtet werden. Stattdessen gestaltet man sich den Kopf und Fuß der
-Folgeseiten im Seitenstil
-\PageStyle{headings}\IndexPagestyle{headings}\important{\PageStyle{headings},
- \PageStyle{myheadings}} oder
-\PageStyle{myheadings}\IndexPagestyle{myheadings} frei. Dazu setzt man den
-gewünschten Aufbau als \PName{Inhalt} der
+Folgeseiten bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} im Seitenstil
+\DescRef{\LabelBase.pagestyle.headings}\IndexPagestyle{headings}%
+\important{\DescRef{\LabelBase.pagestyle.headings},
+ \DescRef{\LabelBase.pagestyle.myheadings}} oder
+\DescRef{\LabelBase.pagestyle.myheadings}\IndexPagestyle{myheadings} und bei
+\Package{scrletter}\OnlyAt{\Package{scrletter}} im Seitenstil
+\DescRef{\LabelBase.pagestyle.letter}%
+\IndexPagestyle{letter}\important{\DescRef{\LabelBase.pagestyle.letter}}
+frei. Dazu setzt man den gewünschten Aufbau als \PName{Inhalt} der
Variablen\ChangedAt{v3.08}{\Class{scrlttr2}} \Variable{nexthead}
beziehungsweise \Variable{nextfoot}. Innerhalb des Inhalts von
\Variable{nexthead} und \Variable{nextfoot} können beispielsweise mit Hilfe
@@ -2751,14 +2995,7 @@ neben- und untereinander gesetzt werden. Einem versierten Anwender sollte es
so möglich sein, eigene Seitenköpfe und "~füße zu gestalten. Natürlich kann
und sollte im Wert mit Hilfe von \DescRef{\LabelBase.cmd.usekomavar} auch auf
weitere Variablen zugegriffen werden. Die \PName{Bezeichnung} wird von
-\KOMAScript{} bei beiden Variablen nicht genutzt.
-
-Lediglich\textnote{Achtung!} aus Gründen der Kompatibilität zu früheren
-Versionen von \Class{scrlttr2} existieren auch noch die Anweisungen
-\Macro{nexthead}\IndexCmd[indexmain]{nexthead} und
-\Macro{nextfoot}\IndexCmd[indexmain]{nextfoot}. Diese sollten jedoch nicht
-mehr verwendet werden.%
-%
+\KOMAScript{} bei beiden Variablen nicht genutzt.%
\EndIndexGroup
\EndIndexGroup
%
@@ -2784,18 +3021,21 @@ Formeln, Gleichungssysteme oder ähnliche Elemente der Mathematik
bereit. Stattdessen stützt sich \KOMAScript{} im Bereich der Mathematik voll
und ganz auf den \LaTeX-Kern. Da\textnote{Achtung!} jedoch Mathematik in Form
von nummerierten Gleichungen und Formeln in Briefen eher ungewöhnlich ist,
-unterstützt \Class{scrlttr2} dies nicht aktiv. Daher gibt es bei
-\Class{scrlttr2} auch nicht die Optionen \DescRef{maincls.option.leqno} und
-\DescRef{maincls.option.fleqn}, die in \autoref{sec:maincls.math} für
-\Class{scrbook}, \Class{scrreprt} und \Class{scrartcl} dokumentiert sind.
-
-Auf eine Beschreibung der Mathematikumgebungen des \LaTeX-Kerns, also
-\Environment{displaymath}\IndexEnv{displaymath},
-\Environment{equation}\IndexEnv{equation} und
-\Environment{eqnarray}\IndexEnv{eqnarray}, wird an dieser Stelle
-verzichtet. Wer diese verwenden möchte, sei auf \cite{l2kurz} verwiesen. Für
-mehr als nur einfachste mathematische Formeln und Gleichungen sei jedoch die
-Verwendung von \Package{amsmath} empfohlen (siehe \cite{package:amsmath}).%
+unterstützt \KOMAScript{} dies nicht aktiv. Daher gibt es auch nicht die
+Optionen \DescRef{maincls.option.leqno} und \DescRef{maincls.option.fleqn},
+die in \autoref{sec:maincls.math}, \autopageref{sec:maincls.math} für
+\Class{scrbook}, \Class{scrreprt} und \Class{scrartcl} dokumentiert sind.%
+\iffalse% Umbruchkorrekturtext
+ \par
+ Auf eine Beschreibung der Mathematikumgebungen des \LaTeX-Kerns, also
+ \Environment{displaymath}\IndexEnv{displaymath},
+ \Environment{equation}\IndexEnv{equation} und
+ \Environment{eqnarray}\IndexEnv{eqnarray}, wird an dieser Stelle
+ verzichtet. Wer diese verwenden möchte, sei auf \cite{l2kurz} verwiesen. Für
+ mehr als nur einfachste mathematische Formeln und Gleichungen sei jedoch die
+ Verwendung von \Package{amsmath}\IndexPackage{amsmath} empfohlen (siehe
+ \cite{package:amsmath}).%
+\fi
%
\EndIndexGroup
@@ -2806,13 +3046,14 @@ Verwendung von \Package{amsmath} empfohlen (siehe \cite{package:amsmath}).%
Gleitumgebungen für Tabellen und Abbildungen sind in Briefen normalerweise
fehl am Platz. Daher\textnote{Achtung!} werden sie von \Class{scrlttr2} auch
nicht unterstützt. Wenn solche dennoch benötigt werden, deutet dies häufig auf
-einen Missbrauch der Briefklasse hin. In solchen Fällen müssen Sie versuchen,
-die Gleitumgebungen mit Hilfe von Zusatzpaketen wie
-\Package{tocbasic}\important{\Package{tocbasic}} (siehe
-\autoref{cha:tocbasic}) nachzurüsten. Tabellen und Abbildungen ohne
-Gleitumgebungen und ohne Titel sind hingegen natürlich auch mit der
-Briefklasse \Class{scrlttr2} in gewohnter Weise möglich (siehe beispielsweise
-\cite[Abschnitt~3.9.6 und Abschnitt~5]{l2kurz}).
+einen Missbrauch der Briefklasse hin. In solchen Fällen ist stattdessen zu
+raten, eine der \KOMAScript-Klassen aus \autoref{cha:maincls} mit dem Paket
+\Package{scrletter}\important{\Package{scrletter}} zu kombinieren. In diesem
+Fall können Gleitumgebungen, wie für die Klasse dokumentiert, auch in Briefen
+verwendet werden. Die Möglichkeiten zur Definition eigener Gleitumgebungen mit
+Hilfe von \hyperref[cha:tocbasic]{\Package{tocbasic}}\IndexPackage{tocbasic}%
+\important{\hyperref[cha:tocbasic]{\Package{tocbasic}}}, wie sie in
+\autoref{cha:tocbasic} dokumentiert sind, können ebenfalls genutzt werden.
\LoadCommonFile{marginpar}% \section{Randnotizen}
@@ -2869,7 +3110,7 @@ gleicher Weise umdefiniert werden wie \DescRef{maincls.cmd.raggedsection}
Signatur nochmals darauf hinweisen, dass er selbst auch mal
Vereinsvorsitzender war. Deshalb ändert er die Variable
\DescRef{\LabelBase.variable.signature}. Außerdem will er, dass die Signatur
- linksbündig unter dem Schlussgruß steht und definiert daher auch noch
+ linksbündig unter dem Schlussgruß steht, und definiert daher auch noch
\Macro{raggedsignature} um:%
\lstinputcode[xleftmargin=1em]{letter-22}%
Das Ergebnis ist in \autoref{fig:\LabelBase.letter-22} zu sehen.
@@ -2887,6 +3128,12 @@ gleicher Weise umdefiniert werden wie \DescRef{maincls.cmd.raggedsection}
\label{fig:\LabelBase.letter-22}
\end{figure}
\end{Example}
+
+\iftrue% Umbruchkorrekturtext
+ Das vorausgehende Beispiel zeigt die wichtigsten, aber nicht alle möglichen
+ Elemente eines Briefes. Es kann jedoch sehr gut als allgemeines Muster
+ dienen.%
+\fi
%
\EndIndexGroup
%
@@ -2902,15 +3149,19 @@ Normalerweise wird man Einstellungen wie den Absender nicht in jedem Brief neu
wählen, sondern diverse Parameter für bestimmte Gelegenheiten immer wieder
verwenden. Ganz Ähnliches gilt für die verwendeten Briefköpfe und den
Fußbereich der ersten Seite. Es ist deshalb sinnvoll, diese Einstellungen in
-einer eigenen Datei zu speichern. Die Klasse \Class{scrlttr2} bietet
+einer eigenen Datei zu speichern. \KOMAScript{} bietet
hierfür die \File{lco}-Dateien an. Die Endung \File{lco} steht
-für \emph{\emph{l}etter \emph{c}lass \emph{o}ption}, also Briefklassenoption.
+für \emph{\emph{l}etter \emph{c}lass \emph{o}ption}, also
+Briefklassenoption. Dennoch finden diese Dateien für \Package{scrletter}
+ebenso Anwendung.
In \File{lco}-Dateien können alle Anweisungen verwendet werden, die auch an
-der Stelle im Dokument verwendet werden könnten, an der die \File{lco}-Datei
-geladen wird. Außerdem können interne Anweisungen verwendet werden, die für
-Paketautoren freigegeben sind. Bei \Class{scrlttr2} sind dies inbesondere die
-Anweisungen \DescRef{scrlttr2-experts.cmd.@newplength}\IndexCmd{@newplength},
+der Stelle im Dokument verwendet werden könnten, an der %die \File{lco}-Datei
+sie mit \DescRef{\LabelBase.cmd.LoadLetterOption}
+geladen werden. Außerdem können interne Anweisungen verwendet werden, die für
+Paketautoren freigegeben sind. Bei \Class{scrlttr2} und \Package{scrletter}
+sind dies insbesondere die Anweisungen
+\DescRef{scrlttr2-experts.cmd.@newplength}\IndexCmd{@newplength},
\DescRef{scrlttr2-experts.cmd.@setplength}\IndexCmd{@setplength} und
\DescRef{scrlttr2-experts.cmd.@setplength}\IndexCmd{@addtoplength} (siehe
\autoref{sec:scrlttr2-experts.pseudoLengths}).
@@ -2919,13 +3170,15 @@ Anweisungen \DescRef{scrlttr2-experts.cmd.@newplength}\IndexCmd{@newplength},
\File{DIN.lco}, \File{DINmtext.lco}, \File{SNleft.lco}, \File{SN.lco},
\File{UScommercial9}, \File{UScommercial9DW} und
\File{NF.lco}\ChangedAt{v3.04}{\Class{scrlttr2}} dienen dazu, \Class{scrlttr2}
-an verschiedene Normen\Index{Norm} anzupassen. Sie können von angehenden
-Experten sehr gut als Vorlage für eigene Parametersätze verwendet werden. Die
-Datei \File{KOMAold.lco} dient hingegen dazu, die Kompatibilität zu
-\Class{scrlettr}, der alten Briefklasse, zu verbessern. Da hierbei auch auf
-Anweisungen zurückgegriffen wird, die nicht für Paketautoren freigegeben sind,
-sollte man sie nicht als Vorlage für eigene \File{lco}-Dateien verwenden. Eine
-Liste aller vordefinierten \File{lco}-Dateien ist in \autoref{tab:lcoFiles},
+und \Package{scrletter} an verschiedene Normen\Index{Norm} anzupassen. Sie
+können von angehenden Experten sehr gut als Vorlage für eigene Parametersätze
+verwendet werden. Die Datei \File{KOMAold.lco} dient hingegen dazu, die
+Kompatibilität zu \Class{scrlettr}\IndexClass{scrlettr} zu verbessern. Diese
+Klasse wurde schon vor über 15~Jahren aus \KOMAScript{} entfernt. Es wird
+daher nicht mehr näher darauf eingegangen. Da hierbei auch auf Anweisungen
+zurückgegriffen wird, die nicht für Paketautoren freigegeben sind, sollte man
+sie nicht als Vorlage für eigene \File{lco}-Dateien verwenden. Eine Liste
+aller vordefinierten \File{lco}-Dateien ist in \autoref{tab:lcoFiles},
\autopageref{tab:lcoFiles} zu finden.
Wenn Sie einen Parametersatz für eine Briefnorm, die bisher nicht von
@@ -2933,33 +3186,38 @@ Wenn Sie einen Parametersatz für eine Briefnorm, die bisher nicht von
gebeten, diesen Parametersatz an die Supportadresse von \KOMAScript{} zu
schicken. Bitte geben Sie dabei auch die Erlaubnis zur Weiterverbreitung unter
den Lizenzbedingungen von \KOMAScript{} (siehe dazu die Datei
-\File{lppl-de.txt} im \KOMAScript-Paket). Wenn Sie zwar über die notwendigen
+\href{http://mirrors.ctan.org/macros/latex/contrib/koma-script/doc/lppl-de.txt}%
+{\File{lppl-de.txt}} im \KOMAScript-Paket). Wenn Sie zwar über die notwendigen
Maße aus einer bisher nicht unterstützen Briefnorm verfügen, sich jedoch nicht
in der Lage sehen, selbst eine passende \File{lco}-Datei zu erstellen, so
-können Sie sich ebenfalls mit dem \KOMAScript-Autor, Markus Kohm, in
-Verbindung setzen. Beispiele für teilweise sehr komplexe \File{lco}-Dateien
-finden sich unter anderem unter \cite{homepage} und in
-\cite{DANTE:TK0203:MJK}.
+können Sie sich ebenfalls mit dem \KOMAScript-Autor in Verbindung
+setzen. Beispiele für teilweise sehr komplexe \File{lco}-Dateien finden sich
+unter anderem unter \cite{homepage} und in \cite{DANTE:TK0203:MJK}.
\begin{Declaration}
\Macro{LoadLetterOption}\Parameter{Name}
\Macro{LoadLetterOptions}\Parameter{Liste von Namen}
\end{Declaration}
-\File{lco}-Dateien können bei \Class{scrlttr2} direkt über
-\Macro{documentclass} geladen werden. Dazu gibt man den Namen der
-\File{lco}-Datei ohne die Endung als Option\Index{Optionen} an. Das Laden der
-\File{lco}-Datei erfolgt dann direkt nach der Klasse.
-
-Empfohlen wird jedoch, eine \File{lco}-Datei über \Macro{LoadLetterOption}
-oder \Macro{LoadLetterOptions}\ChangedAt{v3.14}{\Class{scrlttr2}} erst danach
-zu laden. Dies ist auch zu einem späteren Zeitpunkt und sogar innerhalb einer
-anderen \File{lco}-Datei möglich. Der \PName{Name} der \File{lco}-Datei wird
-in diesen Fällen ebenfalls ohne Endung übergeben. Während als Argument von
-\Macro{LoadLetterOption} der \Parameter{Name} von genau einer \File{lco}-Datei
-erwartet wird, versteht \Macro{LoadLetterOptions} eine durch Komma separierte
-\PName{Liste von Namen}. Die zu den Namen gehörenden \File{lco}-Dateien werden
-dann in der Reihenfolge der Angabe in der Liste geladen.
+Bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} können \File{lco}-Dateien direkt
+über \DescRef{\LabelBase.cmd.documentclass} geladen werden. Dazu gibt man den
+Namen der \File{lco}-Datei ohne die Endung als Option\Index{Optionen} an. Das
+Laden der \File{lco}-Datei erfolgt dann direkt nach der Klasse. Das Paket
+\Package{scrletter}\textnote{Achtung!} bietet diese Möglichkeit nicht! Hier
+bleibt nur \File{lco}-Dateien über \Macro{LoadLetterOption}
+oder \Macro{LoadLetterOptions}\ChangedAt{v3.14}{\Class{scrlttr2}} zu
+laden. Für\textnote{Empfehlung!} \Class{scrlttr2} wird dies ebenfalls
+ausdrücklich empfohlen!
+
+\Macro{LoadLetterOption} und \Macro{LoadLetterOptions} können auch zu einem
+späteren Zeitpunkt, selbst nach \Macro{begin}\PParameter{document} und sogar
+innerhalb einer anderen \File{lco}-Datei verwendet werden. Der \PName{Name}
+der \File{lco}-Datei wird in diesen Fällen ebenfalls ohne Endung
+übergeben. Während als Argument von \Macro{LoadLetterOption} der \PName{Name}
+von genau einer \File{lco}-Datei erwartet wird, versteht
+\Macro{LoadLetterOptions} eine durch Komma separierte \PName{Liste von
+ Namen}. Die zu den Namen gehörenden \File{lco}-Dateien werden dann in der
+Reihenfolge der Angabe in der Liste geladen.
\begin{Example}
Peter Musterfrau erstellt auch ein Dokument, in dem mehrere Briefe enthalten
sind. Die Mehrzahl der Briefe soll nach DIN erstellt werden. Also
@@ -3036,15 +3294,19 @@ bekommen. Da die Schweizer Norm SN~101\,130 vorsieht, dass das Adressfeld
8\Unit{mm} vom rechten Papierrand gesetzt wird, werden bei Schweizer Briefen
auch die Kopfzeile und die Absenderergänzung mit einem entsprechend geringen
Abstand zum Papierrand gesetzt. Dies betrifft ebenfalls die Geschäftszeile bei
-der Einstellung \OptionValueRef{\LabelBase}{refline}{wide} (siehe
-\autoref{sec:\LabelBase.firstpage},
-\DescPageRef{\LabelBase.option.refline}). Sollten\textnote{Tipp!} Sie
-damit ein Problem haben, erstellen Sie sich eine eigene \File{lco}-Datei, die
-zunächst \Option{SN} lädt und in der \PLength{toaddrhpos} (siehe
+der Einstellung
+\OptionValueRef{\LabelBase}{refline}{wide}%
+\IndexOption{refline~=\textKValue{wide}}
+(siehe \autoref{sec:\LabelBase.firstpage},
+\DescPageRef{\LabelBase.option.refline}). Sollten\textnote{Tipp!} Sie damit
+ein Problem haben, erstellen Sie sich eine eigene \File{lco}-Datei, die
+zunächst \Option{SN} lädt und in der
+\DescRef{scrlttr2-experts.plength.toaddrhpos}\IndexPLength{toaddrhpos} (siehe
\autoref{sec:scrlttr2-experts.addressee},
-\DescPageRef{scrlttr2-experts.plength.toaddrvpos}) dann auf einen
-kleineren Wert gesetzt wird. Verringern Sie dann außerdem
-\PLength{toaddrwidth} entsprechend.%
+\DescPageRef{scrlttr2-experts.plength.toaddrvpos}) dann auf einen kleineren
+Wert gesetzt wird. Verringern Sie dann außerdem
+\DescRef{scrlttr2-experts.plength.toaddrwidth}\IndexPLength{toaddrwidth}
+entsprechend.%
Die\textnote{Tipp!}\phantomsection\label{tipp:\LabelBase.DIN} \File{lco}-Datei
\File{DIN}\important{\Option{DIN}} wird übrigens immer als erste
@@ -3060,19 +3322,31 @@ voreingestellte Datei selbst zu laden.
Vordefinierte \File{lco}-Dateien (\emph{Fortsetzung})%
}%
\oentry{DIN}{%
+ \leavevmode%
+ \IndexOption[indexmain]{DIN}\IndexFile[indexmain]{DIN.lco}%
Parametersatz für Briefe im Format A4 nach DIN~676; geeignet für
Fensterbriefumschläge in den Formaten C4, C5, C6 und C6/5 (C6 lang)}%
\oentry{DINmtext}{%
+ \leavevmode%
+ \IndexOption[indexmain]{DINmtext}\IndexFile[indexmain]{DINmtext.lco}%
Parametersatz für Briefe im Format A4 nach DIN~676, wobei die Alternative
für mehr Text auf der ersten Briefseite verwendet wird; nur geeignet für
Fensterbriefumschläge in den Formaten C6 und C6/5 (C6 lang)}%
\oentry{KakuLL}{%
+ \leavevmode%
+ \IndexOption[indexmain]{KakuLL}\IndexFile[indexmain]{KakuLL.lco}%
Parametersatz für japanische Briefe im Format A4; geeignet für japanische
Fensterbriefumschläge des Typs Kaku A4, bei denen das Fenster in etwa
90\Unit{mm} breit, 45\Unit{mm} hoch, 25\Unit{mm} vom linken und
24\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch \iffree{den
Anhang der englischen \KOMAScript-Anleitung}{\autoref{cha:japanlco}})}%
\oentry{KOMAold}{%
+ \leavevmode%
+ \IndexOption[indexmain]{KOMAold}\IndexFile[indexmain]{KOMAold.lco}%
+ \iffalse
+ existiert nur noch aus Kompatibilitätsgründen; die Verwendung wird nicht
+ mehr empfohlen%
+ \else
Parametersatz für Briefe im Format A4 mit Annäherung an das Aussehen von
Briefen der obsoleten Briefklasse \Class{scrlettr}; geeignet für
Fensterbriefumschläge in den Formaten C4, C5, C6 und C6/5 (C6 lang); es
@@ -3080,15 +3354,21 @@ voreingestellte Datei selbst zu laden.
mit der obsoleten Briefklasse \Class{scrlettr}\IndexClass{scrlettr}
definiert; \Class{scrlttr2} verhält sich mit dieser \File{lco}-Datei
möglicherweise nicht genau wie bei Verwendung der übrigen
- \File{lco}-Dateien}%
+ \File{lco}-Dateien%
+ \fi
+ }%
\oentry{NF}{%
+ \leavevmode%
+ \IndexOption[indexmain]{NF}\IndexFile[indexmain]{NF.lco}%
Parametersatz für französische Briefe nach NF~Z~11-001; geeignet für
Fensterbriefumschläge im Format DL (110\Unit{mm} auf 220\Unit{mm}) mit
einem Fenster von 45\Unit{mm} Breite und 100\Unit{mm} Höhe ca. jeweils
20\Unit{mm} entfernt vom rechten unteren Rand; diese Datei wurde
ursprünglich von Jean-Marie Pacquet entwickelt, der auf \cite{www:NF.lco}
- neben einer Erweiterung auch eine LyX-Einbindung bereit stellt.}%
+ neben einer Erweiterung auch eine LyX-Einbindung bereitstellt.}%
\oentry{NipponEH}{%
+ \leavevmode%
+ \IndexOption[indexmain]{NipponEH}\IndexFile[indexmain]{NipponEH.lco}%
Parametersatz für japanische Briefe im Format A4; geeignet für japanische
Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das
Fenster in etwa 90\Unit{mm} breit, 55\Unit{mm} hoch, 22\Unit{mm} vom
@@ -3096,6 +3376,8 @@ voreingestellte Datei selbst zu laden.
\iffree{den Anhang der englischen
\KOMAScript-Anleitung}{\autoref{cha:japanlco}})}%
\oentry{NipponEL}{%
+ \leavevmode%
+ \IndexOption[indexmain]{NipponEL}\IndexFile[indexmain]{NipponEL.lco}%
Parametersatz für japanische Briefe im Format A4; geeignet für japanische
Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das
Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 22\Unit{mm} vom
@@ -3103,6 +3385,8 @@ voreingestellte Datei selbst zu laden.
\iffree{den Anhang der englischen
\KOMAScript-Anleitung}{\autoref{cha:japanlco}})}%
\oentry{NipponLH}{%
+ \leavevmode%
+ \IndexOption[indexmain]{NipponLH}\IndexFile[indexmain]{NipponLH.lco}%
Parametersatz für japanische Briefe im Format A4; geeignet für japanische
Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das
Fenster in etwa 90\Unit{mm} breit, 55\Unit{mm} hoch, 25\Unit{mm} vom
@@ -3110,6 +3394,8 @@ voreingestellte Datei selbst zu laden.
\iffree{den Anhang der englischen
\KOMAScript-Anleitung}{\autoref{cha:japanlco}})}%
\oentry{NipponLL}{%
+ \leavevmode%
+ \IndexOption[indexmain]{NipponLL}\IndexFile[indexmain]{NipponLL.lco}%
Parametersatz für japanische Briefe im Format A4; geeignet für japanische
Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das
Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 25\Unit{mm} vom
@@ -3117,6 +3403,8 @@ voreingestellte Datei selbst zu laden.
\iffree{den Anhang der englischen
\KOMAScript-Anleitung}{\autoref{cha:japanlco}})}%
\oentry{NipponRL}{%
+ \leavevmode%
+ \IndexOption[indexmain]{NipponRL}\IndexFile[indexmain]{NipponRL.lco}%
Parametersatz für japanische Briefe im Format A4; geeignet für japanische
Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das
Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 22\Unit{mm} vom
@@ -3124,14 +3412,21 @@ voreingestellte Datei selbst zu laden.
\iffree{den Anhang der englischen
\KOMAScript-Anleitung}{\autoref{cha:japanlco}})}%
\oentry{SN}{%
+ \leavevmode%
+ \IndexOption[indexmain]{SN}\IndexFile[indexmain]{SN.lco}%
Parametersatz für Schweizer Briefe nach SN~010\,130 mit Anschrift rechts;
geeignet für Schweizer Fensterbriefumschläge in den Formaten C4, C5, C6
und C6/5 (C6 lang)}%
\oentry{SNleft}{%
+ \leavevmode%
+ \IndexOption[indexmain]{SNleft}\IndexFile[indexmain]{SNleft.lco}%
Parametersatz für Schweizer Briefe mit Anschrift links; geeignet für
Schweizer Fensterbriefumschläge mit dem Fenster links in den Formaten C4,
C5, C6 und C6/5 (C6 lang)}%
\oentry{UScommercial9}{%
+ \leavevmode%
+ \IndexOption[indexmain]{UScommercial9}%
+ \IndexFile[indexmain]{UScommercial9.lco}%
Parametersatz für US-amerikanische Briefe im Format letter;
geeignet für US-amerikanische Fensterbriefumschläge der Größe
\emph{commercial~No.\,9} mit einem
@@ -3141,6 +3436,9 @@ voreingestellte Datei selbst zu laden.
dann an der oberen Faltmarke kann auch Papier im Format legal verwendet
werden, führt dann jedoch zu einer Papiergrößen-Warnung}%
\oentry{UScommercial9DW}{%
+ \leavevmode%
+ \IndexOption[indexmain]{UScommercial9DW}%
+ \IndexFile[indexmain]{UScommercial9DW.lco}%
Parametersatz für US-amerikanische Briefe im Format letter;
geeignet für US-amerikanische Fensterbriefumschläge der Größe
\emph{commercial~No.\,9} mit einem
@@ -3156,8 +3454,11 @@ voreingestellte Datei selbst zu laden.
Beachten\textnote{Achtung!} Sie bitte noch, dass es nicht möglich ist,
innerhalb einer \File{lco}-Datei mittels \Macro{PassOptionsToPackage} Optionen
an Pakete zu übergeben, die von der Klasse bereits geladen sind. Normalerweise
-betrifft dies nur die Pakete \Package{typearea}, \Package{scrlfile},
-\Package{scrbase} und \Package{keyval}.%
+betrifft dies nur die Pakete
+\hyperref[cha:typearea]{\Package{typearea}}\IndexPackage{typearea},
+\hyperref[cha:scrlfile]{\Package{scrlfile}}\IndexPackage{scrlfile},
+\hyperref[cha:scrbase]{\Package{scrbase}}\IndexPackage{scrbase} und
+\Package{keyval}\IndexPackage{keyval}.%
%
\EndIndexGroup
%
@@ -3170,12 +3471,12 @@ betrifft dies nur die Pakete \Package{typearea}, \Package{scrlfile},
\BeginIndex{}{Adressdatei}\BeginIndex{}{Serienbriefe}%
Als besonders lästig wird bei Briefen immer das Eintippen der Adressen und das
-Erstellen von Serienbriefen betrachtet. Die Klasse \Class{scrlttr2} bietet
-hierfür
+Erstellen von Serienbriefen betrachtet. \KOMAScript{} bietet
+hierfür%
\iffalse% Umbruchkorrekturtext
- wie schon die obsolete Klasse \Class{scrlettr}
+ , wie schon die obsolete Klasse \Class{scrlettr},%
\fi%
-eine gewisse Unterstützung.%
+\ eine minimalistische Unterstützung.%
\iffalse% Umbruchkorrekturtext
\ Eine stark verbesserte Serienbrief"|funktion ist bereits seit längerem in
Planung.%
@@ -3186,7 +3487,7 @@ eine gewisse Unterstützung.%
\Parameter{Tel.}\Parameter{F1}\Parameter{F2}\Parameter{Kommentar}
\Parameter{Kürzel}
\end{Declaration}
-Mit der \Class{scrlttr2}-Klasse können
+Mit \Class{scrlttr2} und \Package{scrletter} können
Adressdateien\Index[indexmain]{Adressdatei} ausgewertet werden. Dies ist
beispielsweise für Serienbriefe sehr nützlich. Eine Adressdatei muss
die Endung \File{.adr} haben und besteht aus einer Reihe von
@@ -3213,10 +3514,10 @@ Großbuchstaben zu verwenden.
Herr Maier gehört zu Ihren engeren Geschäftspartnern. Da Sie eine
rege Korrespondenz mit ihm pflegen, ist es Ihnen auf Dauer zu
mühsam, jedesmal alle Empfängerdaten aufs Neue einzugeben.
- \Class{scrlttr2} nimmt Ihnen diese Arbeit ab. Angenommen, Sie haben
+ \KOMAScript{} nimmt Ihnen diese Arbeit ab. Angenommen, Sie haben
Ihre Kundenkontakte in der Datei \File{partner.adr} gespeichert und
Sie möchten Herrn Maier einen Brief schreiben, dann sparen Sie sich
- viel Tipparbeit, wenn Sie folgendes eingeben:
+ viel Tipparbeit, wenn Sie Folgendes eingeben:
\begin{lstcode}
\input{partner.adr}
\begin{letter}{\MAIER}
@@ -3231,6 +3532,7 @@ Großbuchstaben zu verwenden.
\end{Example}
%
\EndIndexGroup
+\vskip-\ht\strutbox% Wegen Beispiel am Ende der Erklärung
\begin{Declaration}
@@ -3238,18 +3540,18 @@ Großbuchstaben zu verwenden.
\Parameter{Telefon}\Parameter{F1}\Parameter{F2}\Parameter{F3}
\Parameter{F4}\Parameter{Kürzel}
\end{Declaration}
-Da über die Jahre hinweg immer wieder Klagen aufkamen, dass insgesamt
-nur zwei freie Felder zu wenig seien, verfügt \Class{scrlttr2} nun
-alternativ über die Anweisung \Macro{addrentry}. Mit dem zusätzlichen
-»\texttt{d}« im Namen sind hier auch zwei weitere freie Felder
-hinzugekommen, dafür ist jedoch der Kommentar entfallen. Ansonsten
-kann die Anweisung genau wie \DescRef{\LabelBase.cmd.adrentry} verwendet werden.
-
-In einer \File{adr}-Datei können die beiden Anweisungen \DescRef{\LabelBase.cmd.adrentry} und
-\Macro{addrentry} nebeneinander verwendet werden. Ich\textnote{Achtung!}
-weise jedoch darauf hin, dass Zusatzpakete wie das \Package{adrconv}-Paket von
-Axel Kielhorn eventuell nicht auf die Verwendung von \Macro{addrentry}
-ausgelegt sind. Hier muss der Anwender gegebenenfalls selbst entsprechende
+Bevor Klagen aufkommen, dass insgesamt nur zwei freie Felder zu wenig seien:
+\KOMAScript{} verfügt alternativ über die Anweisung \Macro{addrentry}. Mit dem
+zusätzlichen »\texttt{d}« im Namen sind hier auch zwei weitere freie Felder
+hinzugekommen, dafür ist jedoch der Kommentar entfallen. Ansonsten kann die
+Anweisung genau wie \DescRef{\LabelBase.cmd.adrentry} verwendet werden.
+
+In einer \File{adr}-Datei können die beiden Anweisungen
+\DescRef{\LabelBase.cmd.adrentry} und \Macro{addrentry} nebeneinander
+verwendet werden. Ich\textnote{Achtung!} weise jedoch darauf hin, dass
+Zusatzpakete wie das \Package{adrconv}-Paket\IndexPackage{adrconv} von Axel
+Kielhorn eventuell nicht auf die Verwendung von \Macro{addrentry} ausgelegt
+sind. Hier muss der Anwender gegebenenfalls selbst entsprechende
Erweiterungen vornehmen.%
%
\EndIndexGroup
@@ -3284,7 +3586,8 @@ Datenbanksysteme möglich, solche Massenpostsendungen zu erstellen.
\input{mitglieder.adr}
\end{document}
\end{lstcode}
- Sind in Ihrer \File{adr}-Datei auch \DescRef{\LabelBase.cmd.addrentry}-Anweisungen
+ Sind in Ihrer \File{adr}-Datei auch
+ \DescRef{\LabelBase.cmd.addrentry}-Anweisungen
enthalten, müssen Sie dafür eine entsprechende Definition vor dem
Einladen der Adressdatei ergänzen:
\begin{lstcode}
@@ -3293,14 +3596,15 @@ Datenbanksysteme möglich, solche Massenpostsendungen zu erstellen.
}
\end{lstcode}
Bei diesem Beispiel wird kein Gebrauch von dem zusätzlichen freien
- Feld gemacht und deshalb \DescRef{\LabelBase.cmd.addrentry} mit Hilfe von \DescRef{\LabelBase.cmd.adrentry}
- definiert.
+ Feld gemacht und deshalb \DescRef{\LabelBase.cmd.addrentry} mit Hilfe von
+ \DescRef{\LabelBase.cmd.adrentry} definiert.
\end{Example}
Natürlich kann der Brief"|inhalt auch von den Adressatenmerkmalen
abhängig gemacht werden. Als Bedingungsfelder können die frei
-bestimmbaren Elemente fünf oder sechs eines \DescRef{\LabelBase.cmd.adrentry}-Eintrages oder
-die frei bestimmbaren Elemente fünf bis acht eines \DescRef{\LabelBase.cmd.addrentry}-Eintrags
+bestimmbaren Elemente fünf oder sechs eines
+\DescRef{\LabelBase.cmd.adrentry}-Eintrages oder die frei bestimmbaren
+Elemente fünf bis acht eines \DescRef{\LabelBase.cmd.addrentry}-Eintrags
genutzt werden.
\begin{Example}
Angenommen, Sie verwenden das Element fünf, um das Geschlecht eines
@@ -3333,7 +3637,8 @@ Es ist also möglich, den Brieftext auf bestimmte Empfängermerkmale
gezielt abzustimmen und so den Eindruck eines persönlichen
Schreibens zu erwecken. Die Anwendungsbreite ist lediglich durch
die maximale Anzahl von zwei freien \DescRef{\LabelBase.cmd.adrentry}-Elementen
-beziehungsweise vier freien \DescRef{\LabelBase.cmd.addrentry}-Elementen begrenzt.
+beziehungsweise vier freien \DescRef{\LabelBase.cmd.addrentry}-Elementen
+begrenzt.
\begin{Declaration}
@@ -3343,16 +3648,16 @@ beziehungsweise vier freien \DescRef{\LabelBase.cmd.addrentry}-Elementen begrenz
\Index[indexmain]{Adressverzeichnis}\Index[indexmain]{Telefonliste}%
Es ist auch möglich, die Informationen einer \File{.adr}-Datei in
Adressverzeichnisse oder Telefonlisten umzuwandeln. Sie benötigen dazu
-zusätzlich das \Package{adrconv}-Paket von Axel Kielhorn (siehe
-\cite{package:adrconv}). In diesem Paket sind interaktive
-\LaTeX-Dokumente enthalten, mit deren Hilfe sehr einfach entsprechende
-Listen erstellt werden können.
+zusätzlich das \Package{adrconv}\IndexPackage{adrconv}-Paket von Axel Kielhorn
+(siehe \cite{package:adrconv}). In diesem Paket sind interaktive
+\LaTeX-Dokumente enthalten, mit deren Hilfe sehr einfach entsprechende Listen
+erstellt werden können.
-Damit die Listen alphabetisch sortiert ausgegeben werden, muss bereits
-die Adressdatei sortiert gewesen sein. Es empfiehlt sich dabei, vor
-jedem neuen Anfangsbuchstaben eine Anweisung \Macro{adrchar} mit
-diesem Buchstaben als Argument einzufügen. \Class{scrlttr2} selbst
-ignoriert diese Anweisung ebenso wie \Macro{addrchar}.
+Damit die Listen alphabetisch sortiert ausgegeben werden, muss bereits die
+Adressdatei sortiert gewesen sein. Es empfiehlt sich dabei, vor jedem neuen
+Anfangsbuchstaben eine Anweisung \Macro{adrchar} mit diesem Buchstaben als
+Argument einzufügen. \Class{scrlttr2} und \Package{scrletter} selbst
+ignorieren diese Anweisung ebenso wie \Macro{addrchar}.
%
\begin{Example}
Angenommen Sie haben folgende, eher winzige Adressdatei für die ein
@@ -3361,6 +3666,16 @@ ignoriert diese Anweisung ebenso wie \Macro{addrchar}.
% Elemente löschen oder hinzufügen. MICHAEL und GABRIEL sollten jedoch
% erhalten bleiben.
% Umbruchkorrektur: Dies kann noch dazu:
+ % \adrentry{Engel}{Raphael}
+ % {Wolke 3b\\12345 Himmelreich}
+ % {000\,01\,02\,05}{}{}{Erzengel}
+ % {RAPHAEL}
+ % \adrchar{T}
+ % \adrentry{Teufel}{Luzifer}
+ % {Hinter der Flamme 1\\
+ % 66666 H\"ollenschlund}
+ % {}{}{}{Gefallener Engel ohne Telefon}
+ % {LUZIFER}
\begin{lstcode}
\adrchar{E}
\adrentry{Engel}{Gabriel}
@@ -3371,10 +3686,6 @@ ignoriert diese Anweisung ebenso wie \Macro{addrchar}.
{Wolke 3a\\12345 Himmelreich}
{000\,01\,02\,04}{}{}{Erzengel}
{MICHAEL}
- \adrentry{Engel}{Raphael}
- {Wolke 3b\\12345 Himmelreich}
- {000\,01\,02\,05}{}{}{Erzengel}
- {RAPHAEL}
\adrchar{K}
\adrentry{Kohm}{Markus}
{Freiherr-von-Drais-Stra\ss e 66\\
@@ -3382,15 +3693,17 @@ ignoriert diese Anweisung ebenso wie \Macro{addrchar}.
{+49~62\,03~1\,??\,??}{}{}
{\"Uberhaupt kein Engel}
{KOMA}
- \adrchar{T}
- \adrentry{Teufel}{Luzifer}
- {Hinter der Flamme 1\\
- 66666 H\"ollenschlund}
- {}{}{}{Gefallener Engel ohne Telefon}
- {LUZIFER}
\end{lstcode}
Diese verarbeiten Sie nun unter Verwendung des Dokuments \File{adrdir.tex}
- aus \cite{package:adrconv}. Eine Seite des Ergebnisses sieht dann etwa so aus:
+ aus \cite{package:adrconv}. Ein Problem dabei ist, dass \File{adrdir.tex}
+ bis einschließlich Version~1.3 sowohl das veraltete Paket \Package{scrpage}
+ als auch veraltete Schriftbefehle verwendet, die von \KOMAScript{} schon
+ seit einiger Zeit nicht mehr unterstützt werden. Sollten Sie entsprechende
+ Fehlermeldungen erhalten und keine neuere Version installieren können,
+ finden Sie unter \cite{https://komascript.de/node/2154} eine Lösung für
+ dieses Problem.
+
+ Eine Seite des Ergebnisses sieht dann etwa so aus:
\begin{center}
\setlength{\unitlength}{1mm}
\begin{picture}(80,58)
@@ -3401,13 +3714,13 @@ ignoriert diese Anweisung ebenso wie \Macro{addrchar}.
\put(10,43){\line(1,0){60}}
\put(70,46){\makebox(0,0)[r]{\textsf{\textbf{E}}}}
\put(10,23){\makebox(0,20)[l]{\parbox{5cm}{\raggedright
- \textbf{Engel}, Gabriel\\\quad\small Wolke 3\\
+ \textsc{Engel}, Gabriel\\\quad\small Wolke 3\\
\quad 12345 Himmelreich\\
\quad (Erzengel)}}}
\put(70,23){\makebox(0,20)[r]{\parbox{2cm}{\raggedright~\\
\small~\\{\footnotesize GABRIEL}\\000\,01\,02\,03}}}
\put(10,4){\makebox(0,20)[l]{\parbox{5cm}{\raggedright
- \textbf{Engel}, Michael\\\quad\small Wolke 3a\\
+ \textsc{Engel}, Michael\\\quad\small Wolke 3a\\
\quad 12345 Himmelreich\\
\quad (Erzengel)}}}
\put(70,4){\makebox(0,20)[r]{\parbox{2cm}{\raggedright~\\
@@ -3416,13 +3729,16 @@ ignoriert diese Anweisung ebenso wie \Macro{addrchar}.
\end{picture}
\end{center}
Dabei wird der Buchstabe in der Kopfzeile von \Macro{adrchar}
- erzeugt. Siehe dazu die Definition in \File{adrdir.tex}.
-\end{Example}
-Näheres zum \Package{adrconv}-Paket ist der zugehörigen Anleitung zu
-entnehmen. Dort finden Sie auch Angaben darüber, ob die aktuelle Version von
-\Package{adrconv} bereits mit \DescRef{\LabelBase.cmd.addrentry} und
-\Macro{addrchar} umgehen kann. Frühere Versionen kannten nur
+ erzeugt, wenn man die Frage »Namen in der Kopfzeile?« verneint. Siehe dazu
+ die Definition in \File{adrdir.tex}.%
+\end{Example}%
+\iffalse% Umbruchkorrektur
+Näheres zum \Package{adrconv}\IndexPackage{adrconv}-Paket ist der zugehörigen
+Anleitung zu entnehmen. Dort finden Sie auch Angaben darüber, ob die aktuelle
+Version von \Package{adrconv} bereits mit \DescRef{\LabelBase.cmd.addrentry}
+und \Macro{addrchar} umgehen kann. Frühere Versionen kannten nur
\DescRef{\LabelBase.cmd.adrentry} und \Macro{adrchar}.%
+\fi
%
\EndIndexGroup
%
@@ -3445,3 +3761,8 @@ entnehmen. Dort finden Sie auch Angaben darüber, ob die aktuelle Version von
% LocalWords: Versandart Zentrierung Dokumenttitel Serienbriefen Seitenstil
% LocalWords: Dokumentpräambel Grafikpaket Briefbogenfuß Briefbogenfußes
+% LocalWords: Standardklassen Briefpaket Dokumentteile Briefkontext Torsten
+% LocalWords: Briefumgebung neckische Briefinhalt Absenderinformationen
+% LocalWords: Falzmarken Faltmarken Adressfeld Geschäftszeile Feldinhalts
+% LocalWords: Feldbezeichnung Seitenstilen Paginierung Briefklassenoption
+% LocalWords: Bedingungsfelder Schriftauswahl Spitzmarke
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2examples.dtx b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2examples.dtx
index 0bdb6ba8677..18286886b38 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2examples.dtx
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2examples.dtx
@@ -2,7 +2,7 @@
% \iffalse
% ======================================================================
% scrlttr2examples.dtx
-% Copyright (c) Markus Kohm, 2008-2013
+% Copyright (c) Markus Kohm, 2008-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -20,7 +20,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlttr2examples.dtx
-% Copyright (c) Markus Kohm, 2008-2013
+% Copyright (c) Markus Kohm, 2008-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -101,25 +101,50 @@
% \begin{macrocode}
%<*lco&23>
\ProvidesFile{ich.lco}[2008/06/11 lco
- (Peter Musterfrau)]
+%<english> (Joe Public)]
+%<ngerman> (Peter Musterfrau)]
\KOMAoptions{foldmarks=true,foldmarks=blmtP,
fromphone,fromemail,fromlogo,subject=titled}
+%<*english>
+\setkomavar{fromname}{Joe Public}
+\setkomavar{signature}{Joe Public\\
+ (former chairman)}
+%</english>
+%<*ngerman>
\setkomavar{fromname}{Peter Musterfrau}
\setkomavar{signature}{Peter Musterfrau\\
(ehemaliger Vorsitzender)}
+%</ngerman>
\renewcommand*{\raggedsignature}{\raggedright}
+%<*english>
+\setkomavar{fromaddress}{2 Valley\\
+ SAMPLEBY\\
+ ZY32 1XW}
+%</english>
+%<*ngerman>
\setkomavar{fromaddress}{Hinter dem Tal 2\\
54321 Musterheim}
+%</ngerman>
\setkomavar{fromphone}{0\,12\,34~56\,78}
-\setkomavar{fromemail}{Peter@Musterfrau.invalid}
+%<english>\setkomavar{fromemail}{joe@public.invalid}
+%<ngerman>\setkomavar{fromemail}{Peter@Musterfrau.invalid}
\setkomavar{fromlogo}{%
\includegraphics{musterlogo}}
\setkomavar{location}{\raggedright
+%<*english>
+ Club member no.~4711\\
+ since 11.09.2001\\
+ chairman 2003--2005}
+\setkomavar{place}{Sampleby}
+\setkomavar{frombank}{Bank of Friendly Greetings}
+%</english>
+%<*ngerman>
Mitglied Nr.~4711\\
seit dem 11.09.2001\\
Vorsitzender in den Jahren 2003--2005}
\setkomavar{place}{Musterheim}
\setkomavar{frombank}{Bank freundlichen Gru\ss es}
+%</ngerman>
%</lco&23>
%<*example>
%<*label>
@@ -168,21 +193,36 @@
%<nipponB>\LoadLetterOption{NipponEL}
%<label>\documentclass[version=last,ich,settleford600label]{scrlttr2}
%<ngerman>\usepackage[ngerman]{babel}
-%<english>\usepackage[english]{babel}
+%<english>\usepackage[british]{babel}
%<16|17|18|19|20|21|22|23|label>\usepackage{graphics}
\begin{document}
%<*!0&!1&!2&!3&!4&!5&!6&!7&!23&!label>
-\setkomavar{fromname}{Peter Musterfrau}
+%<english>\setkomavar{fromname}{Joe Public}
+%<ngerman>\setkomavar{fromname}{Peter Musterfrau}
%<*22>
+%<*english>
+\setkomavar{signature}{Joe Public\\
+ (former chairman)}
+%</english>
+%<*ngerman>
\setkomavar{signature}{Peter Musterfrau\\
(ehemaliger Vorsitzender)}
+%</ngerman>
\renewcommand*{\raggedsignature}{\raggedright}
%</22>
+%<*english>
+\setkomavar{fromaddress}{2 Valley\\
+ SAMPLEBY\\
+ ZY32 1XW}
+%</english>
+%<*ngerman>
\setkomavar{fromaddress}{Hinter dem Tal 2\\
54321 Musterheim}
+%</ngerman>
%<*!9&!10&!11>
\setkomavar{fromphone}{0\,12\,34~56\,78}
-\setkomavar{fromemail}{Peter@Musterfrau.invalid}
+%<english>\setkomavar{fromemail}{joe@public.invalid}
+%<ngerman>\setkomavar{fromemail}{Peter@Musterfrau.invalid}
%<*!12&!13&!14&!15>
\setkomavar{fromlogo}{\includegraphics{musterlogo}}
%</!12&!13&!14&!15>
@@ -191,20 +231,38 @@
%<*19|20|21|22|23|label>
%<*!23&!label&!nipponA&!nipponB>
\setkomavar{location}{\raggedright
+%<*english>
+ Club member no.~4711\\
+ since 11.09.2001\\
+ chairman 2003--2005}
+%</english>
+%<*ngerman>
Mitglied Nr.~4711\\
seit dem 11.09.2001\\
Vorsitzender in den Jahren 2003--2005}
+%</ngerman>
%</!23&!label&!nipponA&!nipponB>
%<*20|21|22|23|label>
-\setkomavar{date}{29. Februar 2011}
-%<!23&!label>\setkomavar{place}{Musterheim}
+%<english>\setkomavar{date}{29th February 2011}
+%<ngerman>\setkomavar{date}{29. Februar 2011}
+%<*!23&!label>
+%<english>\setkomavar{place}{Sampleby}
+%<ngerman>\setkomavar{place}{Musterheim}
+%</!23&!label>
%<*21|22|23|label>
-\setkomavar{subject}{Mitgliederversammlung vermisst}
+%<english>\setkomavar{subject}{Missing general meeting}
+%<ngerman>\setkomavar{subject}{Mitgliederversammlung vermisst}
%</21|22|23|label>
%</20|21|22|23|label>
%</19|20|21|22|23|label>
%<!5>\begin{letter}{%
%<5>\begin{letter}[fontsize=14pt]{%
+%<*english>
+ Joanna Public\\
+ 1 Hillside\\
+ SAMPLESTEAD\\
+ WX12 3YZ%
+%</english>
%<*ngerman>
Petra Mustermann\\
Vor dem Berg 1\\
@@ -212,28 +270,48 @@
%</ngerman>
}
%<label>\savelabel{3}{2}
-\opening{Liebe Vereinsvorsitzende,}
+%<english>\opening{Dear Madam Chair,}
+%<ngerman>\opening{Liebe Vereinsvorsitzende,}
%<*!0>
+%<*english>
+The last general meeting was more than a year ago.
+I would like to remind you that the articles of our
+club stipulate that one should be held every
+six months. For this reason, I call on the executive
+board to arrange such a meeting immediately.
+\closing{Anticipating an invitation}
+%</english>
%<*ngerman>
seit einem Jahr gab es keine Mitgliederversammlung
mehr. Ich erinnere daran, dass unsere Satzung eine
-solche alle halbe Jahr vorsieht. Ich fordere den
+solche jedes halbe Jahr vorsieht. Ich fordere den
Vorstand daher auf, umgehend eine solche in
Angriff zu nehmen.
\closing{In Erwartung einer Einladung}
%</ngerman>
%<*!1>
+%<*english>
+\ps PS: I hope you do not take this request amiss.
+%</english>
%<*ngerman>
\ps PS: Ich hoffe, Du nimmst mir das nicht krumm.
%</ngerman>
%<*!2>
%<*!3>
+%<*english>
+\setkomavar*{enclseparator}{Enclosure}
+\encl{Excerpt from the articles governing general
+ meetings}
+%</english>
%<*ngerman>
\setkomavar*{enclseparator}{Anlage}
\encl{Auszug aus der Satzung, in dem die
Mitgliederversammlungen geregelt sind}
%</ngerman>
%</!3>
+%<*english>
+\cc{executive board\\all members}
+%</english>
%<*ngerman>
\cc{Die Vereinsvorsitzende\\Alle Mitglieder}
%</ngerman>
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrwfile.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrwfile.tex
index cec15276397..4e27aa22eb4 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrwfile.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrwfile.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrwfile.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrwfile.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ============================================================================
\KOMAProvidesFile{scrwfile.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-02-16 04:42:17 +0100 (Fri, 16 Feb 2018) $
KOMA-Script guide (chapter: scrwfile)]
\chapter{Dateien mit \Package{scrwfile} sparen und ersetzen}
@@ -69,7 +69,12 @@ Im Endeffekt kann es daher geschehen, dass irgendwann die Meldung
\ch@ck ...\else \errmessage {No room for a new #3}
\fi
\end{lstcode}
-erscheint.
+erscheint. Seit einiger Zeit ist die einfachste Lösung dieses Problems die
+Verwendung von Lua\LaTeX{} anstelle von PDF\LaTeX{} oder \XeLaTeX. Damit
+entfällt die Beschränkung und die maximale Anzahl der gleichzeitig zum
+Schreiben geöffneten Dateien wird nur noch durch das Betriebssystem
+bestimmt. In der Realität braucht man sich darüber dann normalerweise keine
+Gedanken mehr zu machen.
Dass \LaTeX{} bei Verzeichnissen wie dem Inhaltsverzeichnis, dem
Tabellenverzeichnis und dem Abbildungsverzeichnis immer sofort eine neue Datei
@@ -79,7 +84,8 @@ auch kein weiteres Mal gesetzt werden, da die zugehörige Hilfsdatei nach dem
jeweiligen Befehl bis zum Ende des Dokuments leer ist.
Das Paket \Package{scrwfile} bietet hier eine grundsätzliche Änderung im
-\LaTeX-Kern, durch die beide Probleme gelöst werden können.
+\LaTeX-Kern, durch die beide Probleme nicht nur für Lua\LaTeX{} sondern auch bei
+Verwendung von PDF\LaTeX{} oder \XeLaTeX{} gelöst werden können.
\section{Grundsätzliche Änderungen am \LaTeX-Kern}
@@ -109,11 +115,7 @@ Natürlich\textnote{Achtung!} besitzen Änderungen am \LaTeX-Kern immer das
Potential, dass es zu Unverträglichkeiten mit anderen Paketen kommen
kann. Betroffen können in erster Linie Pakete sein, die ebenfalls
\Macro{@starttoc} oder \Macro{@writefile} umdefinieren. In einigen Fällen kann
-es helfen, die Reihenfolge der Pakete zu ändern.
-
-Tatsächlich sind bisher keine solchen Probleme im Zusammenhang mit
-\Package{scrwfile} bekannt, obwohl das Paket vor der Veröffentlichung von
-verschiedenen Anwendern über ein Jahr lang getestet wurde. Wenn Sie jedoch auf
+es helfen, die Reihenfolge der Pakete zu ändern. Wenn Sie auf
ein solches Problem stoßen, sollten Sie sich an den \KOMAScript-Autor wenden.
@@ -131,15 +133,15 @@ geöffnet wird. Unmittelbar vor dem Schließen der \File{aux}-Datei in
\Macro{end}\PParameter{document} wird dann \Macro{@writefile} so umdefiniert,
dass diese Anweisung statt in die eigentlichen Hilfsdateien in eine neue
Hilfsdatei mit der Endung \File{wrt} schreibt. Nach dem Einlesen der
-\File{aux}-Dateien wird dann noch die \File{wrt}-Datei abgearbeitet und zwar
+\File{aux}-Dateien wird schließlich die \File{wrt}-Datei abgearbeitet und zwar
ein Mal für jede der Hilfsdateien, in die mit \Macro{@writefile} geschrieben
-wird. Dabei muss dann aber nicht jede dieser Hilfsdateien gleichzeitig
+wird. Dabei muss aber nicht jede dieser Hilfsdateien gleichzeitig
geöffnet sein. Stattdessen ist immer nur eine zum Schreiben geöffnet und wird
auch wieder explizit geschlossen. Da dabei eine interne Schreibdatei von
\LaTeX{} wiederverwendet wird, benötigt \Package{scrwfile} keine einzige
eigene Schreibdatei für diese Art von Verzeichnissen.
-Selbst, wenn bisher nur mit einem Inhaltsverzeichnis gearbeitet wird, steht
+Selbst wenn bisher nur mit einem Inhaltsverzeichnis gearbeitet wird, steht
nach dem Laden des Pakets bereits eine Schreibdatei mehr für
Literaturverzeichnisse, Stichwortverzeichnisse, Glossare und ähnliche
Verzeichnisse, die nicht mit \Macro{@starttoc} arbeiten, zur
@@ -169,23 +171,26 @@ kann man in dieses geklonte Verzeichnis auch zusätzliche Einträge
schreiben.
Die \PName{Zielendung} der Zieldatei wird mit Hilfe von
-\Package{tocbasic}\important{\Package{tocbasic}} (siehe
+\hyperref[cha:tocbasic]{\Package{tocbasic}}%
+\important{\hyperref[cha:tocbasic]{\Package{tocbasic}}} (siehe
\autoref{cha:tocbasic}) verwaltet. Steht eine solche Datei bereits unter
-Kontrolle von \Package{tocbasic} wird eine Warnung ausgegeben. Anderenfalls
-wird mit Hilfe von \Package{tocbasic} ein neues Verzeichnis für diese Endung
-angelegt. Die Überschrift dieses Verzeichnisses kann man über das optionale
-Argument \PName{Verzeichnisüberschrift} bestimmen.
+Kontrolle von \hyperref[cha:tocbasic]{\Package{tocbasic}} wird eine Warnung
+ausgegeben. Anderenfalls wird mit Hilfe von
+\hyperref[cha:tocbasic]{\Package{tocbasic}} ein neues Verzeichnis für diese
+Endung angelegt. Die Überschrift dieses Verzeichnisses kann man über das
+optionale Argument \PName{Verzeichnisüberschrift} bestimmen.
Ausgeben kann man dieses neue Verzeichnis dann beispielsweise über die
Anweisung \Macro{listof\PName{Zielendung}}. Die
-Verzeichniseigenschaften\important{\Package{tocbasic}} \PValue{leveldown},
-\PValue{numbered}, \PValue{onecolumn} und \PValue{totoc} (siehe Anweisung
-\DescRef{tocbasic.cmd.setuptoc} in \autoref{sec:tocbasic.toc},
-\DescPageRef{tocbasic.cmd.setuptoc}) werden automatisch in das
-Zielverzeichnis übernommen, falls sie für das Quellverzeichnis bereits gesetzt
-waren. Die Eigenschaft \PValue{nobabel} wird für geklonte Verzeichnisse immer
-gesetzt, da die entsprechenden \Package{babel}-Einträge in das
-Quellverzeichnis ohnehin bereits kopiert werden.
+Verzeichniseigenschaften\important{\hyperref[cha:tocbasic]{\Package{tocbasic}}}
+\PValue{leveldown}, \PValue{numbered}, \PValue{onecolumn} und \PValue{totoc}
+(siehe Anweisung \DescRef{tocbasic.cmd.setuptoc} in
+\autoref{sec:tocbasic.toc}, \DescPageRef{tocbasic.cmd.setuptoc}) werden
+automatisch in das Zielverzeichnis übernommen, falls sie für das
+Quellverzeichnis bereits gesetzt waren. Die Eigenschaft \PValue{nobabel} wird
+für geklonte Verzeichnisse immer gesetzt, da die entsprechenden
+\Package{babel}-Einträge in das Quellverzeichnis ohnehin bereits kopiert
+werden.
\begin{Example}
Angenommen, Sie wollen zusätzlich zum normalen Inhaltsverzeichnis eine
@@ -222,29 +227,34 @@ Quellverzeichnis ohnehin bereits kopiert werden.
Gliederungsübersicht angezeigt werden soll. Dies wäre zwar mit
\begin{lstcode}
\addtocontents{toc}{%
- \protect\addcontentsline
+ \protect\addxcontentsline
{stoc}{chapter}{\protect\contentsname}%
}
\end{lstcode}
möglich. Da jedoch alle Einträge in \File{toc} auch nach \File{stoc} kopiert
werden, würde so von der Gliederungsübersicht dieser Eintrag ebenfalls
übernommen. Also darf der Eintrag nicht aus der Verzeichnisdatei heraus
- erzeugt werden. Da das Paket \Package{tocbasic}\important{\Package{tocbasic}}
- zum Einsatz kommt, kann aber
- \phantomsection\xmpllabel{cmd.BeforeStartingTOC}
+ erzeugt werden. Da das Paket \hyperref[cha:tocbasic]{\Package{tocbasic}}%
+ \important{\hyperref[cha:tocbasic]{\Package{tocbasic}}} zum Einsatz kommt,
+ kann aber%
+ \phantomsection\xmpllabel{cmd.BeforeStartingTOC}%
\begin{lstcode}
\BeforeStartingTOC[toc]{%
- \addcontentsline{stoc}{chapter}
- {\protect\contentsname}}
+ \addxcontentsline{stoc}{chapter}
+ {\protect\contentsname}}
\end{lstcode}
verwendet werden. Natürlich\textnote{Achtung!} setzt dies voraus, dass die
- Datei mit Endung \File{toc} auch unter der Kontrolle von \Package{tocbasic}
- steht. Dies ist bei allen \KOMAScript-Klassen der Fall. Näheres zur
- Anweisung \DescPageRef{tocbasic.cmd.BeforeStartingTOC} ist in
- \autoref{sec:tocbasic.toc} auf \DescPageRef{tocbasic.cmd.BeforeStartingTOC}
- zu finden.
-\end{Example}
+ Datei mit Endung \File{toc} auch unter der Kontrolle von
+ \hyperref[cha:tocbasic]{\Package{tocbasic}} steht. Dies ist bei allen
+ \KOMAScript-Klassen der Fall. Näheres zur Anweisung
+ \DescRef{tocbasic.cmd.BeforeStartingTOC} ist in \autoref{sec:tocbasic.toc}
+ auf \DescPageRef{tocbasic.cmd.BeforeStartingTOC} zu finden.%
+\end{Example}%
%
+Die in den Beispielen verwendete Anweisung
+\DescRef{tocbasic.cmd.addxcontentsline} ist übrigens ebenfalls in
+\autoref{cha:tocbasic}, \DescPageRef{tocbasic.cmd.addxcontentsline}
+dokumentiert.%
\EndIndexGroup
@@ -293,5 +303,5 @@ in \Package{titletoc} noch in \Package{scrwfile}.%
% LocalWords: Eindateiensystem Schreibdatei Zieldatei Zielendung Quellendung
% LocalWords: Verzeichnisüberschrift Dateiendung Zielendungen Verzeichnisdatei
% LocalWords: Benutzeranweisungen Dokumentpräambel Kapitelebene
-% LocalWords: Paketunverträglichkeiten
+% LocalWords: Paketunverträglichkeiten Verzeichniseigenschaften
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/tocbasic.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/tocbasic.tex
index 61c285c4754..e8532e621a9 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/tocbasic.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/tocbasic.tex
@@ -1,6 +1,6 @@
% ======================================================================
% tocbasic.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% tocbasic.tex
-% Copyright (c) Markus Kohm, 2002-2017
+% Copyright (c) Markus Kohm, 2002-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{tocbasic.tex}
- [$Date: 2017-08-08 11:57:30 +0200 (Tue, 08 Aug 2017) $
+ [$Date: 2018-03-27 11:46:14 +0200 (Tue, 27 Mar 2018) $
KOMA-Script guide (package tocbasic)]
\chapter{Verzeichnisse verwalten mit Hilfe von \Package{tocbasic}}
@@ -71,9 +71,9 @@ vornehmen zu müssen.
Als kleiner Nebeneffekt kann das Paket auch verwendet werden, um neue
Gleitumgebungen oder den Gleitumgebungen ähnliche nicht gleitende Umgebungen
für Konsultationsobjekte zu definieren. Näheres dazu wird nach der Erklärung
-der grundlegenden Anweisungen in \autoref{sec:tocbasic.toc} durch ein Beispiel
-in \autoref{sec:tocbasic.example} verdeutlicht, das in kompakter Form noch
-einmal in \autoref{sec:tocbasic.declarenewtoc} aufgegriffen wird.
+der grundlegenden Anweisungen in den folgenden vier Abschnitten durch ein
+Beispiel in \autoref{sec:tocbasic.example} verdeutlicht, das in kompakter Form
+noch einmal in \autoref{sec:tocbasic.declarenewtoc} aufgegriffen wird.
\KOMAScript{} verwendet \Package{tocbasic} sowohl für das Inhaltsverzeichnis
als auch für die bereits erwähnten Verzeichnisse für Abbildungen und Tabellen.
@@ -87,18 +87,19 @@ bekannten Dateierweiterungen\textnote{Dateierweiterung, Verzeichnis}, die für
Verzeichnisse stehen, zu verwalten. Einträge in Dateien mit solchen
Dateierweiterungen werden typischerweise mit
\Macro{addtocontents}\important{\Macro{addtocontents},
- \DescRef{\LabelBase.cmd.addxcontentsline}} oder \DescRef{\LabelBase.cmd.addxcontentsline} vorgenommen. Darüber
-hinaus gibt es Anweisungen, mit denen Aktionen für all diese
-Dateierweiterungen durchgeführt werden können. Außerdem gibt es Anweisungen,
-um Einstellungen für die Datei vorzunehmen, die zu einer gegebenen
-Dateierweiterung gehört. Typischerweise hat so eine Dateierweiterung auch
-einen Besitzer\textnote{Dateibesitzer}. Dieser Besitzer kann eine Klasse oder
-ein Paket oder ein Bezeichner sein, den der Autor der Klasse oder des Pakets,
-das \Package{tocbasic} verwendet, frei gewählt hat. \KOMAScript{} selbst
-verwendet beispielsweise den Besitzer \PValue{float} für die
-Dateierweiterungen \File{lof} und \File{lot}, die für das Abbildungs- und das
-Tabellenverzeichnis stehen. Für das Inhaltsverzeichnis verwendet \KOMAScript{}
-als Besitzer den Dateiname der Klasse.
+ \DescRef{\LabelBase.cmd.addxcontentsline}} oder
+\DescRef{\LabelBase.cmd.addxcontentsline} vorgenommen. Darüber hinaus gibt es
+Anweisungen, mit denen Aktionen für all diese Dateierweiterungen durchgeführt
+werden können. Außerdem gibt es Anweisungen, um Einstellungen für die Datei
+vorzunehmen, die zu einer gegebenen Dateierweiterung gehört. Typischerweise
+hat so eine Dateierweiterung auch einen
+Besitzer\textnote{Dateibesitzer}. Dieser Besitzer kann eine Klasse oder ein
+Paket oder ein Bezeichner sein, den der Autor der Klasse oder des Pakets, das
+\Package{tocbasic} verwendet, frei gewählt hat. \KOMAScript{} selbst verwendet
+beispielsweise den Besitzer \PValue{float} für die Dateierweiterungen
+\File{lof} und \File{lot}, die für das Abbildungs- und das Tabellenverzeichnis
+stehen. Für das Inhaltsverzeichnis verwendet \KOMAScript{} als Besitzer den
+Dateinamen der Klasse.
\begin{Declaration}
\Macro{ifattoclist}\Parameter{Dateierweiterung}
@@ -111,7 +112,7 @@ die \PName{Dateierweiterung} bereits über diese Liste bekannt, so wird der
ausgeführt.
\begin{Example}
Angenommen, Sie wollen wissen, ob die Dateierweiterung »\File{foo}« bereits
- verwendet wird, um in diesem Fall einen Fehlermeldung auszugeben, weil diese
+ verwendet wird, um in diesem Fall eine Fehlermeldung auszugeben, weil diese
damit nicht mehr verwendet werden kann:
\begin{lstcode}
\ifattoclist{foo}{%
@@ -151,7 +152,7 @@ aufgrund der Verwendung einer Anweisung durch den Benutzer aufgerufen wird. In
diesem Fall wird als \PName{Besitzer} »\PValue{.}« eingetragen.
Beachten\textnote{Achtung!} Sie, dass ein leeres Argument \PName{Besitzer}
-nicht das gleiche ist, wie das Weglassen des kompletten optionalen Arguments
+nicht das Gleiche ist wie das Weglassen des kompletten optionalen Arguments
einschließlich der eckigen Klammern. Ein leeres Argument würde auch einen
leeren \PName{Besitzer} ergeben.
\begin{Example}
@@ -172,7 +173,7 @@ leeren \PName{Besitzer} ergeben.
See the tocbasic package documentation for explanation.
Type H <return> for immediate help.
\end{lstoutput}
- Wenn Sie dann tatsächlich die Taste »\texttt{H}« gefolgt von der
+ Wenn Sie dann tatsächlich die Taste »\texttt{H}«, gefolgt von der
Return-Taste drücken, erhalten Sie als Hilfe:
\begin{lstoutput}
File extension `foo' is already used by a toc-file, while bar.sty
@@ -201,33 +202,45 @@ leeren \PName{Besitzer} ergeben.
oder aber ein Fehler gemeldet, wenn diese Dateierweiterung bereits verwendet
wird.
\end{Example}
+
Sie können als \PName{Besitzer} angeben, was immer Sie wollen, aber es sollte
eindeutig sein! Wenn Sie beispielsweise der Autor des Pakets \Package{float}
-wären, könnten Sie als \PName{Besitzer} auch »\PValue{float}« an Stelle von
-»\PValue{float.sty}« angeben. In diesem Fall würden die \KOMAScript-Optionen
-für das Verzeichnis der Abbildungen und das Verzeichnis der Tabellen auch Ihre
-Verzeichnisse betreffen, die zum Zeitpunkt der Verwendung der jeweiligen
-Option bereits zur Liste der bekannten Dateierweiterungen hinzugefügt
-sind. Das liegt daran, dass \KOMAScript{} die Dateierweiterungen
-»\PValue{lof}« für das Abbildungsverzeichnis und »\PValue{lot}« für das
-Tabellenverzeichnis mit dem Besitzer »\PName{float}« anmeldet und die Optionen
-für diese Besitzer setzt.%
-%
+wären, könnten Sie als \PName{Besitzer} auch »\PValue{float}« anstelle von
+»\PValue{float.sty}« angeben. In diesem Fall würden die
+\KOMAScript-Optionen\important{\DescRef{maincls.option.listof}}%
+\IndexOption{listof~=\PName{Einstellung}} für das Verzeichnis der Abbildungen
+und das Verzeichnis der Tabellen auch Ihre Verzeichnisse betreffen, die zum
+Zeitpunkt der Verwendung der jeweiligen Option bereits zur Liste der bekannten
+Dateierweiterungen hinzugefügt sind. Das liegt daran, dass \KOMAScript{} die
+Dateierweiterungen »\PValue{lof}« für das Abbildungsverzeichnis und
+»\PValue{lot}« für das Tabellenverzeichnis mit dem Besitzer »\PValue{float}«
+anmeldet und die Optionen für diese Besitzer setzt.
+
+Das Paket \hyperref[cha:scrhack]{\Package{scrhack}}\IndexPackage{scrhack}%
+\important{ \hyperref[cha:scrhack]{\Package{scrhack}}} enthält übrigens
+Patches für mehrere Pakete wie \Package{float} oder \Package{listings}, die
+eigene Verzeichnisse bereitstellen. Bei Verwendung von
+\hyperref[cha:scrhack]{\Package{scrhack}} wird dann unter anderem die
+jeweilige Dateierweiterung der Liste der bekannten Dateierweiterungen
+hinzugefügt. Dabei wird als \PName{Besitzer} ebenfalls »\PValue{float}«
+verwendet. Dies ist sozusagen der grundlegende Baustein, um die Möglichkeiten
+von \Package{tocbasic} und der \KOMAScript-Klassen auch für diese
+Verzeichnisse nutzen zu können.%
\EndIndexGroup
\begin{Declaration}
\Macro{AtAddToTocList}\OParameter{Besitzer}\Parameter{Anweisungen}
\end{Declaration}
-Auf diese Weise können die \Parameter{Anweisungen} zu einer internen Liste von
+Auf diese Weise können die \PName{Anweisungen} zu einer internen Liste von
Anweisungen hinzugefügt werden, die immer dann auszuführen sind, wenn eine
Dateierweiterung mit dem angegebenen \PName{Besitzer} zur Liste der bekannten
Dateierweiterungen hinzugefügt wird. Bezüglich des optionalen Arguments wird
-wie in der Erklärung von \DescRef{\LabelBase.cmd.addtotoclist} beschrieben verfahren. Wird das
-optionale Argument leer gelassen, werden in diesem Fall die Aktionen
-unabhängig vom Besitzer immer ausgeführt, wenn die Dateierweiterung zu der
-Liste der bekannten Dateierweiterungen hinzugefügt wird. Während der
-Ausführung der \PName{Anweisungen} ist außerdem
+wie in der Erklärung von \DescRef{\LabelBase.cmd.addtotoclist} beschrieben
+verfahren. Wird das optionale Argument leer gelassen, werden in diesem Fall
+die Aktionen unabhängig vom Besitzer immer ausgeführt, wenn die
+Dateierweiterung zu der Liste der bekannten Dateierweiterungen hinzugefügt
+wird. Während der Ausführung der \PName{Anweisungen} ist außerdem
\Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} die
Dateierweiterung, die gerade hinzugefügt wird.
\begin{Example}
@@ -243,9 +256,11 @@ Dateierweiterung, die gerade hinzugefügt wird.
\end{Example}
Die\textnote{Achtung!} zweimalige Verwendung von \Macro{expandafter} ist im
-Beispiel erforderlich, weil das Argument von \DescRef{\LabelBase.cmd.tocbasic@extend@babel}
-zwingend bereits expandiert sein muss. Siehe dazu auch die Erklärung zu
-\DescRef{\LabelBase.cmd.tocbasic@extend@babel} in \autoref{sec:tocbasic.internals},
+Beispiel erforderlich, weil das Argument von
+\DescRef{\LabelBase.cmd.tocbasic@extend@babel} zwingend bereits expandiert
+sein muss. Siehe dazu auch die Erklärung zu
+\DescRef{\LabelBase.cmd.tocbasic@extend@babel} in
+\autoref{sec:tocbasic.internals},
\DescPageRef{\LabelBase.cmd.tocbasic@extend@babel}.
%
\EndIndexGroup
@@ -259,23 +274,24 @@ Dateierweiterungen entfernen. Ist das optionale Argument \OParameter{Besitzer}
angegeben, so wird die Dateierweiterung nur entfernt, wenn sie für den
angegebenen \PName{Besitzer} angemeldet wurde. Wie der Besitzer beim Weglassen
des optionalen Argument bestimmt wird, ist der Erklärung zu
-\DescRef{\LabelBase.cmd.addtotoclist} zu entnehmen. Wird ein leerer \PName{Besitzer} angegeben,
-findet kein Besitzertest statt, sondern die \PName{Dateierweiterung} wird
-unabhängig vom Besitzer entfernt.%
+\DescRef{\LabelBase.cmd.addtotoclist} zu entnehmen. Wird ein leerer
+\PName{Besitzer} angegeben, findet kein Besitzertest statt, sondern die
+\PName{Dateierweiterung} wird unabhängig vom Besitzer entfernt.%
\EndIndexGroup
\begin{Declaration}
\Macro{doforeachtocfile}\OParameter{Besitzer}\Parameter{Anweisungen}
\end{Declaration}
-Bisher haben Sie nur Anweisungen kennen gelernt, die für Klassen- und
+Bisher haben Sie nur Anweisungen kennengelernt, die für Klassen- und
Paketautoren zwar zusätzliche Sicherheit, aber auch eher zusätzlichen Aufwand
bedeuten. Mit \Macro{doforeachtocfile} kann man die erste Ernte dafür
einfahren. Diese Anweisung erlaubt es die angegebenen \PName{Anweisungen} für
jede von dem \PName{Besitzer} angemeldete Dateierweiterung
auszuführen. Während der Ausführung der \PName{Anweisungen} ist
-\Macro{@currext} die aktuell verarbeitete Dateierweiterung. Wird das optionale
-Argument \OParameter{Besitzer} weggelassen, so werden alle Dateierweiterungen
+\Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} die aktuell
+verarbeitete Dateierweiterung. Wird das optionale Argument
+\OParameter{Besitzer} weggelassen, so werden alle Dateierweiterungen
unabhängig vom Besitzer abgearbeitet. Ein leeres optionales Argument würde
hingegen nur die Dateierweiterungen mit leerem Besitzer verarbeiten.
\begin{Example}
@@ -284,42 +300,44 @@ hingegen nur die Dateierweiterungen mit leerem Besitzer verarbeiten.
\begin{lstcode}
\doforeachtocfile{\typeout{\@currext}}
\end{lstcode}
- möglich. Wollen Sie hingegen nur die Dateierweiterungen des Besitzer
- »\PValue{foo}«, dann geht das einfach mit:
+ möglich. Sollen hingegen nur die Dateierweiterungen des Besitzer
+ »\PValue{foo}« ausgegeben werden, geht das einfach mit:
\begin{lstcode}
\doforeachtocfile[foo]{\typeout{\@currext}}
\end{lstcode}
\end{Example}
-Die \KOMAScript-Klassen \Class{scrbook} und \Class{scrreprt} verwenden diese
-Anweisung übrigens, um für jedes Verzeichnis, für das die Eigenschaft
-\PValue{chapteratlist} gesetzt ist, optional einen vertikalen Abstand oder die
-Kapitelüberschrift in dieses Verzeichnis einzutragen. Wie Sie diese
-Eigenschaft setzen können, ist in \autoref{sec:tocbasic.toc},
-\DescPageRef{\LabelBase.cmd.setuptoc} zu finden.%
+Die \KOMAScript-Klassen \Class{scrbook} und \Class{scrreprt} verwenden die
+Anweisung, um für Verzeichnisse, für die Eigenschaft \PValue{chapteratlist}
+gesetzt ist, optional einen vertikalen Abstand oder die Kapitelüberschrift in
+das Verzeichnis einzutragen. Wie Sie diese Eigenschaft setzen können, ist
+in \autoref{sec:tocbasic.toc} ab \DescPageRef{\LabelBase.cmd.setuptoc} zu
+finden.%
\EndIndexGroup
\begin{Declaration}
\Macro{tocbasicautomode}
\end{Declaration}
-Diese Anweisung definiert die Anweisung \Macro{@starttoc}, die der \LaTeX-Kern
-bereit stellt, so um, dass bei jedem Aufruf von \Macro{@starttoc} die dabei
-angegebene Dateierweiterung in die Liste der bekannten Dateierweiterungen
-eingefügt wird, soweit sie dort noch nicht vorhanden ist. Außerdem wird dann
-\DescRef{\LabelBase.cmd.tocbasic@starttoc} an Stelle von \Macro{@starttoc} verwendet. Näheres
-zu \DescRef{\LabelBase.cmd.tocbasic@starttoc} und \Macro{@starttoc} ist
-\autoref{sec:tocbasic.internals},
+Diese Anweisung definiert das vom \LaTeX-Kern für Klassen- und Paketautoren
+bereitgestellte
+\Macro{@starttoc}\IndexCmd{@starttoc}\important{\Macro{\@starttoc}} so um,
+dass bei jedem Aufruf von \Macro{@starttoc} die dabei angegebene
+Dateierweiterung in die Liste der bekannten Dateierweiterungen eingefügt wird,
+soweit sie dort noch nicht vorhanden ist. Außerdem wird dann
+\DescRef{\LabelBase.cmd.tocbasic@starttoc} anstelle von \Macro{@starttoc}
+verwendet. Näheres zu \DescRef{\LabelBase.cmd.tocbasic@starttoc} und
+\Macro{@starttoc} ist \autoref{sec:tocbasic.internals},
\DescPageRef{\LabelBase.cmd.tocbasic@starttoc} zu entnehmen.
-Mit Hilfe von \Macro{tocbasicautomode} wird also sozusagen jedes Verzeichnis,
-das mit Hilfe von \Macro{@starttoc} erstellt wird, automatisch zumindest
-teilweise unter die Kontrolle von \Package{tocbasic} gestellt. Ob das zum
-gewünschten Ergebnis führt, hängt jedoch sehr von den jeweiligen
-Verzeichnissen ab. Immerhin funktioniert damit schon einmal die Erweiterung
-für das \Package{babel}-Paket für alle Verzeichnisse. Es ist jedoch
-vorzuziehen, wenn der Paketautor selbst \Package{tocbasic} explizit
-verwendet. Er kann dann auch die weiteren Vorteile nutzen, die ihm das Paket
-bietet und die in den nachfolgenden Abschnitten beschrieben werden.%
+Mit Hilfe von \Macro{tocbasicautomode} wird also jedes Verzeichnis, das mit
+Hilfe von \Macro{@starttoc} erstellt wird, automatisch unter die Kontrolle von
+\Package{tocbasic} gestellt. Ob das zum gewünschten Ergebnis führt, hängt
+jedoch sehr von den jeweiligen Verzeichnissen ab. Immerhin funktioniert damit
+schon einmal die Erweiterung für das \Package{babel}-Paket für alle
+Verzeichnisse. Es ist jedoch vorzuziehen, wenn der Paketautor selbst
+\Package{tocbasic} explizit verwendet. Er kann dann auch die weiteren Vorteile
+nutzen, die ihm das Paket bietet und die in den nachfolgenden Abschnitten
+beschrieben werden.%
\EndIndexGroup
@@ -327,12 +345,12 @@ bietet und die in den nachfolgenden Abschnitten beschrieben werden.%
\seclabel{toc}
Im vorherigen Abschnitt haben Sie erfahren, wie eine Liste bekannter
-Dateierweiterungen geführt werden kann und wie automatisch Anweisungen beim
-Hinzufügen von Dateierweiterungen zu dieser Liste ausgeführt werden
-können. Des Weiteren haben Sie eine Anweisung kennen gelernt, mit der man für
-jede einzelne bekannte Dateierweiterung oder einen spezifischen Teil davon
-Anweisungen ausführen kann. In diesem Abschnitt werden Sie Anweisungen kennen
-lernen, die sich auf die Datei beziehen, die mit dieser Dateierweiterung
+Dateierweiterungen verwaltet werden kann\iffree{ und wie automatisch Anweisungen
+ beim Hinzufügen von Dateierweiterungen zu dieser Liste ausgeführt werden
+ können}{}. Des Weiteren haben Sie eine Anweisung kennengelernt, mit der man
+für jede einzelne bekannte Dateierweiterung oder einen spezifischen Teil davon
+Anweisungen ausführen kann. In diesem Abschnitt werden Sie Anweisungen
+kennenlernen, die sich auf die Datei beziehen, die mit dieser Dateierweiterung
verbunden ist.
@@ -340,12 +358,13 @@ verbunden ist.
\Macro{addtoeachtocfile}\OParameter{Besitzer}\Parameter{Inhalt}
\end{Declaration}
Die Anweisung \Macro{addtoeachtocfile} schreibt \PName{Inhalt} mit Hilfe von
-\Macro{addtocontents} aus dem \LaTeX-Kern in jede Datei, die für den
-angegebenen \PName{Besitzer} in der Liste der bekannten Dateierweiterungen zu
-finden ist. Wird das optionale Argument weggelassen, wird in jede Datei aus
-der Liste der bekannten Dateierweiterungen geschrieben. Der konkrete Dateiname
-setzt sich dabei übrigens aus \Macro{jobname} und der Dateierweiterung
-zusammen. Während des Schreibens von \PName{Inhalt} ist
+\Macro{addtocontents}\IndexCmd{addtocontents}\important{\Macro{addtocontents}}%
+\iffree{ aus dem \LaTeX-Kern}{} in jede Datei, die mit dem angegebenen
+\PName{Besitzer} in der Liste der bekannten Dateierweiterungen \iffree{zu
+ finden ist}{steht}. Wird das optionale Argument weggelassen, wird in jede
+Datei aus der Liste der bekannten Dateierweiterungen geschrieben.\iffree{ Der
+ konkrete Dateiname setzt sich dabei übrigens aus \Macro{jobname} und der
+ Dateierweiterung zusammen.}{} Während des Schreibens von \PName{Inhalt} ist
\Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} die
Dateierweiterung der Datei, in die aktuell geschrieben wird.
\begin{Example}
@@ -362,10 +381,11 @@ Dateierweiterung der Datei, in die aktuell geschrieben wird.
\addtoeachtocfile[foo]{%
\protect\addvspace{\protect\baselineskip}%
}
-\end{lstcode}
-\end{Example}
-Anweisungen, die nicht bereits beim Schreiben expandiert werden sollen, sind
-wie bei \Macro{addtocontents} mit \Macro{protect} zu schützen.
+\end{lstcode}%
+\end{Example}%
+\iffree{Anweisungen, die nicht bereits beim Schreiben expandiert werden
+ sollen, sind wie bei \Macro{addtocontents} mit \Macro{protect} zu
+ schützen.}{}%
\EndIndexGroup
@@ -373,18 +393,15 @@ wie bei \Macro{addtocontents} mit \Macro{protect} zu schützen.
\Macro{addxcontentsline}\Parameter{Dateierweiterung}\Parameter{Ebene}
\OParameter{Gliederungsnummer}\Parameter{Inhalt}
\end{Declaration}
-Diese\ChangedAt{v3.12}{\Package{tocbasic}}
-Anweisung ähnelt sehr der Anweisung
+Diese\ChangedAt{v3.12}{\Package{tocbasic}} Anweisung ähnelt sehr der Anweisung
\Macro{addcontentsline}\IndexCmd{addcontentsline} aus dem
\LaTeX-Kern. Allerdings besitzt sie ein zusätzliches optionales Argument für
die \PName{Gliederungsnummer} des Eintrags, während diese bei
-\Macro{addcontentsline} im Argument \PName{Inhalt} mit angegeben wird.
-
-Die Anweisung wird verwendet, um nummerierte oder nicht nummerierte Einträge
-in das über die \PName{Dateierweiterung} spezifierte Verzeichnis
-aufzunehmen. Dabei ist \PName{Ebene} der symbolische Name der Gliederungsebene
-und \PName{Inhalt} der entsprechende Eintrag. Die Seitenzahl wird automatisch
-bestimmt.
+\Macro{addcontentsline} im Argument \PName{Inhalt} mit angegeben wird. Sie
+wird verwendet, um nummerierte oder nicht nummerierte Einträge in das über die
+\PName{Dateierweiterung} spezifizierte Verzeichnis aufzunehmen. Dabei ist
+\PName{Ebene} der symbolische Name der Gliederungsebene und \PName{Inhalt} der
+entsprechende Eintrag. Die Seitenzahl wird automatisch bestimmt.
Im Unterschied zu \Macro{addcontentsline} testet \Macro{addxcontentsline}
zunächst, ob Anweisung \Macro{add\PName{Ebene}\PName{Dateierweiterung}entry}
@@ -394,7 +411,7 @@ obligatorisches Argument übergeben wird. Ein Beispiel für eine solche
Anweisung, die von den \KOMAScript-Klassen bereitgestellt wird, wäre
\DescRef{maincls-experts.cmd.addparttocentry} (siehe
\autoref{sec:maincls-experts.experts},
-\DescPageRef{maincls-experts.cmd.addparttocentry}). Ist die entsprechend
+\DescPageRef{maincls-experts.cmd.addparttocentry}). Ist die entsprechende
Anweisung nicht definiert, wird stattdessen die interne Anweisung
\DescRef{\LabelBase.cmd.tocbasic@addxcontentsline} verwendet. Diese erhält
alle vier Argumente als obligatorische Argumente und verwendet dann
@@ -431,7 +448,7 @@ Dateien aus der Liste der bekannten Dateierweiterungen schreibt.
\begin{Example}
Angenommen, Sie sind Klassen-Autor und wollen den Kapiteleintrag nicht nur in
das Inhaltsverzeichnis, sondern in alle Verzeichnisdateien schreiben. Nehmen
- wir weiter an, dass aktuell \PName{\#1} den Titel enthält, der geschrieben
+ wir weiter an, dass aktuell \PValue{\#1} den Titel enthält, der geschrieben
werden soll.
\begin{lstcode}
\addxcontentslinetoeachtocfile{chapter}%
@@ -449,8 +466,8 @@ Dateierweiterung der Datei, in die aktuell geschrieben wird.%
Die Anweisung\ChangedAt{v3.12}{\Package{tocbasic}}
\Macro{addxcontentslinetoeachtocfile} ist wann immer möglich gegenüber
\Macro{addcontentslinetoeachtocfile} vorzuziehen, da die Erweiterungen von
-\DescRef{\LabelBase.cmd.addxcontentsline} nur damit Anwendung finden. Näheres zu diesen
-Erweiterungen und Vorteilen ist in der vorausgehenden Erklärung von
+\DescRef{\LabelBase.cmd.addxcontentsline} nur damit Anwendung finden. Näheres
+zu diesen Erweiterungen und Vorteilen ist in der vorausgehenden Erklärung von
\DescRef{\LabelBase.cmd.addxcontentsline} zu finden.%
%
\EndIndexGroup
@@ -509,8 +526,9 @@ passend zu definieren.
\end{lstcode}
Im zweiten Fall würde natürlich auch ein optional aktivierter Eintrag in das
Inhaltsverzeichnis nicht gesetzt. Näheres zur Eigenschaft des Eintrags in
- das Inhaltsverzeichnis ist bei der Anweisung \DescRef{\LabelBase.cmd.setuptoc},
- \DescPageRef{\LabelBase.cmd.setuptoc} zu finden.
+ das Inhaltsverzeichnis ist bei der Anweisung
+ \DescRef{\LabelBase.cmd.setuptoc}, \DescPageRef{\LabelBase.cmd.setuptoc} zu
+ finden.
Wenn Sie zuvor
\begin{lstcode}
@@ -540,8 +558,15 @@ dieser Anweisungen zu einer Fehlermeldung der Art
\end{lstoutput}
führen, wenn keine Schreibdateien mehr zur Verfügung stehen. Abhilfe kann in
diesem Fall das Laden des in \autoref{cha:scrwfile} beschriebenen Pakets
-\Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile} bieten.
-%
+\Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile}
+bieten.
+
+Das Paket \hyperref[cha:scrhack]{\Package{scrhack}}\IndexPackage{scrhack}%
+\important{ \hyperref[cha:scrhack]{\Package{scrhack}}} enthält übrigens
+Patches für mehrere Pakete wie \Package{float} oder \Package{listings}, damit
+deren Verzeichnisbefehle \Macro{listoftoc} verwenden. Dadurch stehen viele
+Möglichkeiten von \Package{tocbasic} und den \KOMAScript-Klassen auch für
+deren Verzeichnisse zur Verfügung.%
\EndIndexGroup
@@ -552,15 +577,15 @@ diesem Fall das Laden des in \autoref{cha:scrwfile} beschriebenen Pakets
\end{Declaration}
Manchmal ist es nützlich, wenn unmittelbar vor dem Einlesen der Datei mit den
Verzeichnisdaten \PName{Anweisungen} ausgeführt werden können. Mit Hilfe von
-\Macro{BeforeStartingTOC} können Sie genau solche \PName{Anweisungen}
+\Macro{BeforeStartingTOC} können Sie eine solche Ausführung
wahlweise für eine einzelne \PName{Dateierweiterung} oder alle Dateien, die
-mit Hilfe von \DescRef{\LabelBase.cmd.listoftoc*}, \DescRef{\LabelBase.cmd.listoftoc} oder \DescRef{\LabelBase.cmd.listofeachtoc}
+mit Hilfe von \DescRef{\LabelBase.cmd.listoftoc*},
+\DescRef{\LabelBase.cmd.listoftoc} oder \DescRef{\LabelBase.cmd.listofeachtoc}
eingelesen werden, erreichen. Ebenso können Sie \PName{Anweisungen} nach dem
Einlesen der Datei ausführen, wenn Sie diese mit \Macro{AfterStartingTOC}
definieren. Während der Ausführung der \PName{Anweisungen} ist
\Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} die
-Dateierweiterung der Datei, die eingelesen wird bzw. gerade eingelesen
-wurde.
+Dateierweiterung der Datei, die eingelesen wird bzw. gerade eingelesen wurde.
Ein Beispiel\textnote{Beispiel} zur Verwendung von \Macro{BeforeStartingTOC}
ist in \autoref{sec:scrwfile.clonefilefeature} auf
@@ -611,7 +636,7 @@ sondern verwendet wie vorgefunden.
Erlauben\textnote{Tipp!} Sie mir einen Hinweis zu \Macro{MakeUppercase}. Diese
Anweisung ist zum einen nicht voll expandierbar. Das bedeutet, dass sie im
-Zusammenspiel mit anderen Anweisungen zu Problemen führen kann. Darüber hinaus
+Zusammenspiel mit anderen Anweisungen zu Problemen führen kann. Zum anderen
sind sich alle Typografen einig, dass beim Versalsatz, also beim Satz
kompletter Wörter oder Passagen in Großbuchstaben, Sperrung unbedingt
notwendig ist. Dabei darf jedoch kein fester Abstand zwischen den Buchstaben
@@ -624,11 +649,10 @@ ebenso wenig leisten wie der Befehl \Macro{MakeUppercase} selbst. Auch die
automatische Sperrung mit Hilfe des \Package{microtype}-Pakets ist
diesbezüglich nur eine näherungsweise Notlösung, da die von der konkreten
Schrift abhängige Form der Buchstaben auch hier nicht näher betrachtet
-wird. Da\textnote{Empfehlung} Versalsatz also eher etwas für die absoluten
+wird. Da\textnote{Empfehlung} Versalsatz also eher etwas für absolute
Experten ist und fast immer Handarbeit bedeutet, wird Laien empfohlen, darauf
-eher zu verzichten oder ihn nur vorsichtig und nicht an so exponierter Stelle
-wie im Kolumnentitel zu verwenden.
-%
+zu verzichten oder ihn nur vorsichtig und nicht an so exponierter Stelle
+wie dem Kolumnentitel zu verwenden.%
\EndIndexGroup
@@ -637,15 +661,15 @@ wie im Kolumnentitel zu verwenden.
\end{Declaration}
Das Paket \Package{tocbasic} enthält eine Standarddefinition für das Setzen
von Überschriften von Verzeichnissen. Diese Standarddefinition ist durch
-verschiedene Eigenschaften, die bei der Anweisung \DescRef{\LabelBase.cmd.setuptoc} erläutert
-werden, konfigurierbar. Sollte diese Möglichkeit einmal nicht ausreichen, so
-besteht die Möglichkeit, mit \Macro{deftocheading} eine alternative
-Überschriftenanweisung für ein Verzeichnis mit einer bestimmten
-\PName{Dateierweiterung} zu definieren. Die Definition kann als einzigen
-Parameter \PName{\#1} enthalten. Beim Aufruf der Anweisung innerhalb von
-\DescRef{\LabelBase.cmd.listoftoc} oder \DescRef{\LabelBase.cmd.listofeachtoc} wird als dieses Argument dann der
-Titel für das Verzeichnis übergeben.
-%
+verschiedene Eigenschaften, die bei der Anweisung
+\DescRef{\LabelBase.cmd.setuptoc} erläutert werden, konfigurierbar. Sollte
+diese Möglichkeit einmal nicht ausreichen, so besteht die Möglichkeit, mit
+\Macro{deftocheading} eine alternative Überschriftenanweisung für ein
+Verzeichnis mit einer bestimmten \PName{Dateierweiterung} zu definieren. Die
+Definition kann als einzigen Parameter \PValue{\#1} enthalten. Beim Aufruf der
+Anweisung innerhalb von \DescRef{\LabelBase.cmd.listoftoc} oder
+\DescRef{\LabelBase.cmd.listofeachtoc} wird für dieses Argument dann der Titel
+für das Verzeichnis übergeben.%
\EndIndexGroup
@@ -656,23 +680,25 @@ Titel für das Verzeichnis übergeben.
\Parameter{Liste von Eigenschaften}
\end{Declaration}
Mit diesen beiden Anweisungen können \PName{Eigenschaften} für eine
-\PName{Dateierweiterung} bzw. das Verzeichnis, das dazu gehört, gesetzt
-werden. Die \PName{Liste von Eigenschaften} ist dabei eine durch Komma
-getrennte Aneinanderreihung von \PName{Eigenschaften}. Das Paket
+\PName{Dateierweiterung} bzw. das Verzeichnis, das dazu gehört, gesetzt und
+gelöscht werden. Die \PName{Liste von Eigenschaften} ist dabei eine durch
+Komma getrennte Folge von \PName{Eigenschaften}. Das Paket
\Package{tocbasic} wertet folgende Eigenschaften aus:
-\begin{description}
+\begin{description}\setkomafont{descriptionlabel}{}%
\item[\PValue{leveldown}] bedeutet, dass das Verzeichnis nicht mit der
- obersten Gliederungsebene unterhalb von \DescRef{maincls.cmd.part} -- wenn vorhanden
- \DescRef{maincls.cmd.chapter}, sonst \DescRef{maincls.cmd.section} -- erstellt wird, sondern mit einer
- Überschrift der nächst tieferen Gliederungsebene. Diese Eigenschaft wird von
- der internen Überschriftenanweisung ausgewertet. Wird\textnote{Achtung!}
- hingegen eine eigene Überschriftenanweisung mit \DescRef{\LabelBase.cmd.deftocheading}
+ obersten Gliederungsebene unterhalb von \DescRef{maincls.cmd.part} -- wenn
+ vorhanden \DescRef{maincls.cmd.chapter}, sonst \DescRef{maincls.cmd.section}
+ -- erstellt wird, sondern mit einer Überschrift der nächst tieferen
+ Gliederungsebene. Diese Eigenschaft wird von der internen
+ Überschriftenanweisung ausgewertet. Wird\textnote{Achtung!} hingegen eine
+ eigene Überschriftenanweisung mit \DescRef{\LabelBase.cmd.deftocheading}
definiert, liegt die Auswertung der Eigenschaft in der Verantwortung dessen,
der die Definition vornimmt. Die \KOMAScript-Klassen setzen diese
Eigenschaft bei Verwendung der Option
- \OptionValueRef{maincls}{listof}{leveldown}\important{\OptionValueRef{maincls}{listof}{leveldown}}%
- \IndexOption{listof~=\PValue{leveldown}}
- für alle Dateierweiterungen des Besitzers \PValue{float}.
+ \OptionValueRef{maincls}{listof}{leveldown}%
+ \important{\OptionValueRef{maincls}{listof}{leveldown}}%
+ \IndexOption{listof~=\textKValue{leveldown}} für alle Dateierweiterungen des
+ Besitzers \PValue{float}.
\item[\PValue{nobabel}] bedeutet, dass die normalerweise automatisch
verwendete Erweiterung für die Sprachumschaltung mit
\Package{babel}\IndexPackage{babel} für diese Dateierweiterung nicht
@@ -698,7 +724,7 @@ getrennte Aneinanderreihung von \PName{Eigenschaften}. Das Paket
das Abschalten des optischen Randausgleichs in den Verzeichnissen. Optischer
Randausgleich wird standardmäßig abgeschaltet, wenn das Paket
\Package{microtype}\IndexPackage{microtype} oder ein anderes Paket, das die
- Anweisung \Macro{microtypesetup}\IndexCmd{microtypesetup} bereit stellt,
+ Anweisung \Macro{microtypesetup}\IndexCmd{microtypesetup} bereitstellt,
geladen ist. Wenn also optischer Randausgleich in den Verzeichnissen
gewünscht wird, dann muss diese Eigenschaft aktiviert
werden. Es\textnote{Achtung!} ist jedoch zu beachten, dass der optische
@@ -713,14 +739,13 @@ getrennte Aneinanderreihung von \PName{Eigenschaften}. Das Paket
\KOMAScript-Klassen setzen diese Eigenschaft bei Verwendung der Option
\OptionValueRef{maincls}{listof}{numbered}%
\important{\OptionValueRef{maincls}{listof}{numbered}}%
- \IndexOption{listof~=\PValue{numbered}} für alle Dateierweiterungen des
+ \IndexOption{listof~=\textKValue{numbered}} für alle Dateierweiterungen des
Besitzers \Package{float}.
\item[\PValue{numberline}] \ChangedAt{v3.12}{\Package{tocbasic}}%
- bedeutet, dass auch all diejenigen Einträge, die mit Hilfe der Anweisung
+ bedeutet, dass all diejenigen Einträge, die mit Hilfe der Anweisung
\DescRef{\LabelBase.cmd.addxcontentsline} oder der Anweisung
- \DescRef{\LabelBase.cmd.addxcontentslinetoeachtocfile} in das Verzeichnis
- geschrieben werden und bei denen das optionale Argument für die Nummer fehlt
- oder leer ist, mit einer (leeren)
+ \DescRef{\LabelBase.cmd.addxcontentslinetoeachtocfile} vorgenommen werden, wobei das optionale Argument für die Nummer fehlt
+ oder leer ist, mit einer leeren
\DescRef{\LabelBase.cmd.numberline}-Anweisung versehen werden. Das führt in
der Regel dazu, dass diese Einträge nicht linksbündig mit der Nummer,
sondern mit dem Text der nummerierten Einträge gleicher Ebene gesetzt
@@ -734,18 +759,18 @@ getrennte Aneinanderreihung von \PName{Eigenschaften}. Das Paket
Die \KOMAScript-Klassen setzen diese Eigenschaft bei Verwendung der Option
\OptionValueRef{maincls}{listof}{numberline}%
\important{\OptionValueRef{maincls}{listof}{numberline}}%
- \IndexOption{listof~=\PValue{numberline}} für die Dateierweiterungen des
+ \IndexOption{listof~=\textKValue{numberline}} für die Dateierweiterungen des
Besitzers \PValue{float} und bei Verwendung der Option
\OptionValueRef{maincls}{toc}{numberline}%
\important{\OptionValueRef{maincls}{toc}{numberline}}%
- \IndexOption{toc~=\PValue{numberline}} für die Dateierweiterung
+ \IndexOption{toc~=\textKValue{numberline}} für die Dateierweiterung
\PValue{toc}. Entsprechend wird die Eigenschaft bei Verwendung von Option
\OptionValueRef{maincls}{listof}{nonumberline}%
\important{\OptionValueRef{maincls}{listof}{nonumberline}}%
- \IndexOption{listof~=\PValue{nonumberline}} oder
+ \IndexOption{listof~=\textKValue{nonumberline}} oder
\OptionValueRef{maincls}{toc}{nonumberline}%
\important{\OptionValueRef{maincls}{toc}{nonumberline}}%
- \IndexOption{toc~=\PValue{nonumberline}} wieder zurückgesetzt.
+ \IndexOption{toc~=\textKValue{nonumberline}} wieder zurückgesetzt.
\item[\PValue{onecolumn}] \leavevmode\ChangedAt{v3.01}{\Package{tocbasic}}%
bedeutet, dass für dieses Verzeichnis automatisch der \LaTeX-interne
Einspaltenmodus mit \Macro{onecolumn}\IndexCmd{onecolumn} verwendet
@@ -772,17 +797,18 @@ getrennte Aneinanderreihung von \PName{Eigenschaften}. Das Paket
Eigenschaft bei Verwendung der Option
\OptionValueRef{maincls}{listof}{totoc}%
\important{\OptionValueRef{maincls}{listof}{totoc}}%
- \IndexOption{listof~=\PValue{totoc}} für alle Dateierweiterungen des
+ \IndexOption{listof~=\textKValue{totoc}} für alle Dateierweiterungen des
Besitzers \Package{float}.
\end{description}
Die \KOMAScript-Klassen kennen eine weitere Eigenschaft:
-\begin{description}
+\begin{description}\setkomafont{descriptionlabel}{}
\item[\PValue{chapteratlist}] sorgt dafür, dass in dieses Verzeichnis bei
jedem neuen Kapitel eine optionale Gliederung eingefügt wird. In der
Voreinstellung ist diese Untergliederung dann ein vertikaler
Abstand. Näheres zu den Möglichkeiten ist Option
\DescRef{maincls.option.listof}%
- \IndexOption{listof}\important{\DescRef{maincls.option.listof}} in
+ \IndexOption{listof~=\PName{Einstellung}}%
+ \important{\DescRef{maincls.option.listof}} in
\autoref{sec:maincls.floats}, \DescPageRef{maincls.option.listof} zu
entnehmen.
\end{description}
@@ -801,9 +827,9 @@ Die \KOMAScript-Klassen kennen eine weitere Eigenschaft:
\begin{lstcode}
\setuptoc{loa}{chapteratlist}
\end{lstcode}
- Wollen Sie außerdem, dass bei Klassen, die \DescRef{maincls.cmd.chapter} als oberste
- Gliederungsebene verwenden, das Verzeichnis automatisch einspaltig gesetzt
- wird, so verwenden Sie zusätzlich
+Wollen Sie außerdem, dass bei Klassen, die \DescRef{maincls.cmd.chapter} als
+oberste Gliederungsebene verwenden, das Verzeichnis automatisch einspaltig
+gesetzt wird, so verwenden Sie zusätzlich
\begin{lstcode}
\ifundefinedorrelax{chapter}{}{%
\setuptoc{loa}{onecolumn}%
@@ -822,7 +848,7 @@ Die \KOMAScript-Klassen kennen eine weitere Eigenschaft:
Wie Sie hier sehen, unterstützt ein Paket, das \Package{tocbasic} verwendet,
bereits ohne nennenswerten Aufwand diverse Möglichkeiten für die dadurch
realisierten Verzeichnisse, die sonst einigen Implementierungsaufwand
-bedeuteten und deshalb in vielen Paketen leider fehlen.%
+bedeuten würden und deshalb in vielen Paketen leider fehlen.%
\EndIndexGroup
@@ -847,7 +873,7 @@ unterstützen wollen.
\BeginIndex{}{Verzeichnis>Eintrag}
Neben\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} den eigentlichen
-Verzeichnissen und den zugehörigen Hilfsdateien kann man mit Paket
+Verzeichnissen und den zugehörigen Hilfsdateien kann man mit dem Paket
\Package{tocbasic} ab Version~3.20 auch Einfluss auf die Verzeichniseinträge
nehmen. Dazu können neue Stile definiert werden. Es stehen aber auch mehrere
vordefinierte Stile zur Verfügung. Mittelfristig wird \Package{tocbasic} das
@@ -868,15 +894,14 @@ Ebene Einträge im Verzeichnis ausgegeben werden.
Bei \Class{book} ist \Counter{tocdepth} beispielsweise mit 2 voreingestellt,
es werden also die Einträge der Ebenen \PValue{part}, \PValue{chapter},
\PValue{section} und \PValue{subsection} ausgeben. Tiefere Ebenen wie
-\PValue{subsubsection}, deren numerischer Wert 3 ist, werden nicht
+\PValue{subsubsection}, deren nummerischer Wert 3 ist, werden nicht
ausgegeben. Trotzdem sind die Einträge in der Hilfsdatei für das
Inhaltsverzeichnis vorhanden.
-Die von \Package{tocbasic} definierten Eintragsstile beachten abgesehen von
+Die von \Package{tocbasic} definierten Eintragsstile beachten, abgesehen von
\PValue{gobble} (siehe
\DescRef{\LabelBase.cmd.DeclareTOCStyleEntry}\iffree{}{, weiter unten in
- diesem Abschnitt}) ebenfalls \Counter{tocdepth}.
-%
+ diesem Abschnitt}), ebenfalls \Counter{tocdepth}.%
\EndIndexGroup
@@ -886,25 +911,25 @@ Die von \Package{tocbasic} definierten Eintragsstile beachten abgesehen von
\end{Declaration}
Zwar\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} definiert bereits der
\LaTeX-Kern eine Anweisung \Macro{numberline}, diese ist allerdings für die
-Anforderungen von \Package{tocbasic} nicht ausreichend. Deshalb definiert es
-eigene Anweisungen und setzt \Macro{numberline} bei Bedarf mit Hilfe von
-\Macro{usetocbasicnumberline} für die einzelnen Verzeichniseinträge
-entsprechend. Eine Umdefinierung von \Macro{numberline} ist daher bei
-Verwendung von \Package{tocbasic} oftmals wirkungslos und führt teilweise auch
-zu Warnungen.
+Anforderungen von \Package{tocbasic} nicht ausreichend. Deshalb definiert
+\Package{tocbasic} eigene Anweisungen und setzt \Macro{numberline} bei Bedarf
+mit Hilfe von \Macro{usetocbasicnumberline} für die einzelnen
+Verzeichniseinträge entsprechend. Eine Umdefinierung von \Macro{numberline}
+ist daher bei Verwendung von \Package{tocbasic} oftmals wirkungslos und führt
+teilweise auch zu Warnungen.
Man kann auch die Definition von \Package{tocbasic} generell nutzen, indem man
bereits in der Dokumentpräambel \Macro{usetocbasicnumberline} aufruft. Die
Anweisung versucht zunächst zu ermitteln, ob in der aktuellen Definition
wichtige interne Anweisungen von \Package{tocbasic} verwendet werden. Ist dies
-nicht der Fall wird \Macro{numberline} entsprechend umdefiniert und zusätzlich
+nicht der Fall, wird \Macro{numberline} entsprechend umdefiniert und zusätzlich
\PName{Code} ausgeführt. Ist kein optionales Arguments angegeben, wird
stattdessen via \Macro{PackageInfo} eine Meldung über die erfolgte
Umdefinierung ausgegeben. Diese Meldung kann man einfach unterdrücken, indem
ein leeres optionales Argument angegeben wird.
Es\textnote{Achtung!} ist zu beachten, dass \Macro{usetocbasicnumberline} den
-internen Schalter \Macro{@tempswa} global verändern kann!%
+internen Schalter \Macro{if@tempswa} global verändern kann!%
\EndIndexGroup
@@ -924,10 +949,11 @@ sein muss. Über die \PName{Optionenliste} können die verschiedenen, meist vom
\PName{Stil} abhängenden Eigenschaften des Eintrags festgelegt werden.
Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert:
-\begin{description}
+\begin{description}\setkomafont{descriptionlabel}{}
\item[\PValue{default}] ist in der Voreinstellung ein Klon von Stil
\PValue{dottedtocline}. Klassenautoren, die \Package{tocbasic} verwenden,
- wird empfohlen, diesen Stil mit Hilfe von \Macro{CloneTOCStyle} auf den
+ wird empfohlen, diesen Stil mit Hilfe von
+ \DescRef{\LabelBase.cmd.CloneTOCEntryStyle} auf den
Standardverzeichniseintragsstil der Klasse zu ändern. Bei den
\KOMAScript-Klassen wird \PValue{default} beispielsweise zu einem Klon von
Stil \PValue{tocline}.
@@ -935,8 +961,8 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert:
\Class{book} und \Class{report} für die Inhaltsverzeichniseinträge der
Ebenen \PValue{section} bis \PValue{subparagraph} und bei allen
Standardklassen für die Einträge in das Abbildungs- und das
- Tabellenverzeichnis bekannt ist. Er kennt nur die Eigenschaften
- \PValue{level}, \PValue{indent} und \PValue{numwidth}. Die Einträge werden
+ Tabellenverzeichnis bekannt ist. Er kennt nur drei\important{\PValue{level},
+ \PValue{indent}, \PValue{numwidth}} Eigenschaften. Die Einträge werden
um \PValue{indent} von links eingezogen in der aktuellen Schrift
ausgegeben. \DescRef{\LabelBase.cmd.numberline} wird nicht umdefiniert. Die
Breite der Nummer wird von \PValue{numwidth} bestimmt. Bei mehrzeiligen
@@ -999,27 +1025,30 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert:
nicht ausgegeben sondern sozusagen verschluckt. Dennoch verfügt er über die
Standardeigenschaft \PValue{level}, die jedoch nie ausgewertet wird.
\item[\PValue{largetocline}] entspricht dem Stil, der von den Standardklassen
- für die Ebene \PValue{part} bekannt ist. Er kennt nur die Eigenschaften
+ für die Ebene \PValue{part} bekannt ist. Er kennt
+ nur\important{\PValue{level}, \PValue{indent}} die Eigenschaften
\PName{level} und \PName{indent}. Letzteres ist gleichsam eine Abweichung
von den Standardklassen, die selbst keinen Einzug der \PValue{part}-Einträge
unterstützen.
Vor dem Eintrag wird ein Seitenumbruch erleichtert. Die Einträge werden um
- \PValue{indent} von links eingezogen in \Macro{large}\Macro{bfseries}
- ausgegeben. Sollte \DescRef{\LabelBase.cmd.numberline} verwendet werden, so
- ist die Nummernbreite fest auf 3\Unit{em}
+ \PValue{indent} von links eingezogen und mit den Schrifteinstellungen
+ \Macro{large}\Macro{bfseries} ausgegeben. Sollte
+ \DescRef{\LabelBase.cmd.numberline} verwendet werden, so ist die
+ Nummernbreite fest auf 3\Unit{em}
eingestellt. \DescRef{\LabelBase.cmd.numberline} wird nicht umdefiniert. Die
Standardklassen verwenden für \PName{part}-Einträge kein
\DescRef{\LabelBase.cmd.numberline}. Der Wert hat bei mehrzeiligen Einträgen
auch keine Auswirkung auf den Einzug ab der zweiten Zeile.
- \autoref{fig:tocbasic.largetocline} illustriert die Eigenschaften des
- Stils. Dabei wird auch auffällig, dass der Stil einige Ungereimtheiten der
- Standardklassen übernommen hat, beispielsweise der fehlende Einzug ab der
- zweiten Zeile bei mehrzeiligen Einträgen und zwei unterschiedliche Werte für
- \Macro{@pnumwidth}, die aus einer Abhängigkeit von der Schriftgröße
+ \autoref{fig:tocbasic.largetocline} illustriert die
+ Eigenschaften
+ des Stils. Dabei wird auch auf"|fällig, dass der Stil einige Ungereimtheiten
+ der Standardklassen übernommen hat, beispielsweise der fehlende Einzug ab
+ der zweiten Zeile bei mehrzeiligen Einträgen und zwei unterschiedliche Werte
+ für \Macro{@pnumwidth}, die aus einer Abhängigkeit von der Schriftgröße
resultieren. Daraus resultiert auch der Umstand, dass im Extremfall der Text
- der Überschrift der Seitenzahl zu nah kommen kann. Es ist zu beachten, dass
+ der Überschrift der Seitenzahl zu nahe kommen kann. Es ist zu beachten, dass
die in der Abbildung gezeigte Breite der Gliederungsnummer nur dann
Verwendung findet, wenn auch tatsächlich \DescRef{\LabelBase.cmd.numberline}
verwendet wird. Die Standardklassen setzen hingegen einen festen Abstand von
@@ -1066,21 +1095,23 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert:
mit Hilfe dieses Stils, ändern dann jedoch den \PName{Initialisierungscode}
der Klone so ab, dass sie unterschiedliche Voreinstellungen besitzen.
- Der Stil kennt die Eigenschaften \PValue{level}, \PValue{beforeskip},
- \PValue{dynnumwidth}, \PValue{entryformat}, \PValue{entrynumberformat},
- \PValue{breakafternumber}, \PValue{indent}, \PValue{linefill},
- \PValue{numsep}, \PValue{numwidth}, \PValue{onstarthigherlevel},
- \PValue{onstartlowerlevel}, \PValue{onstartsamelevel},
- \PValue{pagenumberbox}, \PValue{pagenumberformat}, \PValue{raggedentrytext}
- und \PValue{raggedpagenumber}. Die Voreinstellungen all dieser Eigenschaften
- werden abhängig vom Namen der \PName{Eintragsebene} bestimmt und orientieren
- sich dann an den Ergebnissen der Standardklassen. Es ist daher möglich, nach
- Laden von \Package{tocbasic} den Stil der Inhaltsverzeichniseinträge der
- Standardklassen mit \DescRef{\LabelBase.cmd.DeclareTOCEntryStyle} in \PValue{tocline} zu
- ändern, ohne dass dies unmittelbar zu größeren Veränderungen im Aussehen der
+ Der Stil kennt neben der Standardeigenschaft \PValue{level} noch
+ 16\important{\PValue{level}, \PValue{beforeskip}, \PValue{breakafternumber},
+ \PValue{dynnumwidth}, \PValue{entryformat}, \PValue{entrynumberformat},
+ \PValue{indent}, \PValue{linefill}, \PValue{numsep}, \PValue{numwidth},
+ \PValue{onstarthigherlevel}, \PValue{onstartlowerlevel},
+ \PValue{onstartsamelevel}, \PValue{pagenumberbox},
+ \PValue{pagenumberformat}, \PValue{raggedentrytext},
+ \PValue{raggedpagenumber}} weitere Eigenschaften. Die Voreinstellungen all
+ dieser Eigenschaften werden abhängig vom Namen der \PName{Eintragsebene}
+ bestimmt und orientieren sich dann an den Ergebnissen der
+ Standardklassen. Es ist daher möglich, nach Laden von \Package{tocbasic} den
+ Stil der Inhaltsverzeichniseinträge der Standardklassen mit
+ \DescRef{\LabelBase.cmd.DeclareTOCEntryStyle} in \PValue{tocline} zu ändern,
+ ohne dass dies unmittelbar zu größeren Veränderungen im Aussehen der
Inhaltsverzeichniseinträge führt. So kann man gezielt nur die Eigenschaften
ändern, die für erwünschte Änderungen notwendig sind. Dasselbe gilt für
- Abbildungs- und Tabellenverzeichnis der Standardklassen.
+ Abbildungs- und Tabellenverzeichnis der Standardklassen.%
Aufgrund der hohen Flexibilität kann dieser Stil prinzipiell die Stile
\PValue{dottedtocline}, \PValue{undottedtocline} und \PValue{largetocline}
@@ -1237,19 +1268,17 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert:
\item[\PValue{undottedtocline}] entspricht dem Stil, der von den
Standardklassen \Class{book} und \Class{report} für die Ebene
\PValue{chapter} und von \Class{article} für die Ebene \PValue{section}
- bekannt ist. Er kennt nur die Eigenschaften \PValue{level}, \PValue{indent}
- und \PValue{numwidth}. Letztere ist gleichsam eine Abweichung von den
- Standardklassen, die selbst keinen Einzug für die genannten Ebenen
- unterstützen.
-
+ bekannt ist. Er kennt\important{\PValue{level}, \PValue{indent},
+ \PValue{numwidth}} nur drei Eigenschaften.
Vor dem Eintrag wird ein Seitenumbruch erleichtert und ein vertikaler
Abstand eingefügt. Die Einträge werden um \PValue{indent} von links
- eingezogen in \Macro{bfseries}
- ausgegeben. \DescRef{\LabelBase.cmd.numberline} wird nicht umdefiniert. Die
- Breite der Nummer wird von \PValue{numwidth} bestimmt. Bei mehrzeiligen
- Einträgen wird der Einzug ab der zweiten Zeile um \PValue{numwidth}
- erhöht. \autoref{fig:tocbasic.undottedtocline} illustriert die Eigenschaften
- des Stils.
+ eingezogen in \Macro{bfseries} ausgegeben. Dies ist gleichsam eine
+ Abweichung von den Standardklassen, die selbst keinen Einzug für Einträge
+ der genannten Ebenen bieten. \DescRef{\LabelBase.cmd.numberline} wird nicht
+ umdefiniert. Die Breite der Nummer wird von \PValue{numwidth} bestimmt. Bei
+ mehrzeiligen Einträgen wird der Einzug ab der zweiten Zeile um
+ \PValue{numwidth} erhöht. \autoref{fig:tocbasic.undottedtocline} illustriert
+ die Eigenschaften des Stils.
\begin{figure}
\centering
\resizebox{.8\linewidth}{!}{%
@@ -1292,16 +1321,19 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert:
Eine Erklärung zu den Eigenschaften der von \Package{tocbasic} definierten
Stile findet sich in \autoref{tab:tocbasic.tocstyle.attributes}.
Bei\ChangedAt[2016/06]{v3.21}{\Package{tocbasic}} Verwendung der Eigenschaften
-als Optionen für \DescRef{\LabelBase.cmd.DeclareNewTOC} (siehe
+als Optionen für
+\DescRef{\LabelBase.cmd.DeclareNewTOC}\IndexCmd{DeclareNewTOC} (siehe
\DescPageRef{\LabelBase.cmd.DeclareNewTOC}) sind die Namen der Eigenschaften
mit dem Präfix \PValue{tocentry}, also beispielsweise \Option{tocentrylevel}
-an Stelle von \PValue{level} zu
+anstelle von \PValue{level}, zu
verwenden. Bei\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}} Verwendung als
-Optionen für \DescRef{maincls-experts.cmd.DeclareSectionCommand} (siehe
+Optionen für \DescRef{maincls-experts.cmd.DeclareSectionCommand}%
+\IndexCmd{DeclareSectionCommand}\IndexCmd{DeclareNewSectionCommand}%
+\IndexCmd{RedeclareSectionCommand}\IndexCmd{ProvideSectionCommand} (siehe
\DescPageRef{maincls-experts.cmd.DeclareSectionCommand}) und verwandten
Anweisungen sind die Namen der Eigenschaften mit dem Präfix \PValue{toc} zu
-versehen, also beispielsweise \Option{toclevel} an Stelle von \PValue{level}
-zu verwenden.
+versehen, also beispielsweise \Option{toclevel} anstelle von \PValue{level} zu
+verwenden.
Letztlich führt der Aufruf von \Macro{DeclareTOCStyleEntry} zur Definition der
Anweisung \Macro{l@\PName{Eintragsebene}}.
@@ -1324,9 +1356,9 @@ Anweisung \Macro{l@\PName{Eintragsebene}}.
Bei der \PName{Eintragsebene} \PValue{part} wird das Attribut mit
\texttt{2.25em plus 1pt} initialisiert, bei \PValue{chapter} mit
\texttt{1em plus 1pt}. Ist noch keine \PName{Eintragsebene}
- \PValue{chapter} bekannt wird für \PValue{section} ebenfalls \texttt{1em
- plus 1pt} verwendet. Alle anderen Ebenen werden mit \texttt{0pt plus
- .2pt} initialisiert.%
+ \PValue{chapter} bekannt, wird stattdessen für \PValue{section}
+ \texttt{1em plus 1pt} verwendet. Ansonsten wird \PValue{section} wie alle
+ anderen Ebenen mit \texttt{0pt plus .2pt} initialisiert.%
}%
\entry{\OptionVName{breakafternumber}{Schalter}}{%
\PName{Schalter} ist einer der Werte für einfache Schalter aus
@@ -1338,14 +1370,14 @@ Anweisung \Macro{l@\PName{Eintragsebene}}.
In der Voreinstellung ist die Eigenschaft im Stil \PValue{tocline} nicht
gesetzt.
- Ist\textnote{Achtung!} für ein Verzeichnis mit
- \DescRef{\LabelBase.cmd.setuptoc} die Eigenschaft \Option{numberline}
- gesetzt (siehe \autoref{sec:tocbasic.toc},
+ Ist %\textnote{Achtung!}
+ für ein Verzeichnis mit \DescRef{\LabelBase.cmd.setuptoc} die Eigenschaft
+ \Option{numberline} gesetzt (siehe \autoref{sec:tocbasic.toc},
\DescPageRef{\LabelBase.cmd.setuptoc}), wie dies bei den
\KOMAScript-Klassen und Verwendung deren Option
\OptionValueRef{maincls}{toc}{numberline}%
- \IndexOption{toc~=\PValue{numberline}} der Fall ist, führt dies auch dazu,
- dass bei nicht nummerierten Einträgen dennoch die Zeile mit der dann
+ \IndexOption{toc~=\textKValue{numberline}} der Fall ist, führt dies auch
+ dazu, dass bei nicht nummerierten Einträgen dennoch die Zeile mit der dann
leeren Nummer in der Formatierung von \Option{entrynumberformat} gesetzt
wird.%
}%
@@ -1355,8 +1387,8 @@ Anweisung \Macro{l@\PName{Eintragsebene}}.
Schalter beim Stil \PValue{tocline} aktiviert, gibt die Eigenschaft
\PValue{numwidth} nur noch einen Minimalwert an. Übertrifft die beim
letzten \LaTeX-Lauf ermittelte maximale Breite der Eintragsnummern
- gleicher Ebene zuzüglich des Werts von \PValue{numsep} diesen Minimalwert,
- so wird stattdessen der ermittelte Wert verwendet.%
+ gleicher Ebene zuzüglich des Wertes von \PValue{numsep} diesen
+ Minimalwert, so wird stattdessen der ermittelte Wert verwendet.%
}%
\entry{\OptionVName{entryformat}{Befehl}}{%
Über diese Eigenschaft kann die Formatierung des gesamten Eintrags
@@ -1388,14 +1420,15 @@ Anweisung \Macro{l@\PName{Eintragsebene}}.
Initialisiert wird die Eigenschaft mit Ausgabe des übergebenen
Arguments. Die Eintragsnummer wird also unverändert ausgegeben.
- Ist\textnote{Achtung!} für ein Verzeichnis mit
- \DescRef{\LabelBase.cmd.setuptoc} die Eigenschaft \Option{numberline}
- gesetzt (siehe \autoref{sec:tocbasic.toc},
- \DescPageRef{\LabelBase.cmd.setuptoc}), wie dies bei den \KOMAScript-Klassen
- und Verwendung deren Option \OptionValueRef{maincls}{toc}{numberline}%
- \IndexOption{toc~=\PValue{numberline}} der Fall ist, führt dies auch dazu,
- dass bei nicht nummerierten Einträgen \PName{Befehl} dennoch ausgeführt
- wird.%
+ Ist %\textnote{Achtung!}
+ für ein Verzeichnis mit \DescRef{\LabelBase.cmd.setuptoc} die Eigenschaft
+ \Option{numberline} gesetzt (siehe \autoref{sec:tocbasic.toc},
+ \DescPageRef{\LabelBase.cmd.setuptoc}), wie dies bei den
+ \KOMAScript-Klassen und Verwendung deren Option
+ \OptionValueRef{maincls}{toc}{numberline}%
+ \IndexOption{toc~=\textKValue{numberline}} der Fall ist, führt dies auch
+ dazu, dass bei nicht nummerierten Einträgen \PName{Befehl} dennoch
+ ausgeführt wird.%
}%
\entry{\OptionVName{indent}{Länge}}{%
Horizontaler Abstand des Eintrags vom linken Rand (siehe
@@ -1417,7 +1450,8 @@ Anweisung \Macro{l@\PName{Eintragsebene}}.
Nummerischer Wert der \PName{Eintragsebene}. Tatsächlich angezeigt werden
nur Einträge, deren nummerische Ebene nicht größer als Zähler
\DescRef{\LabelBase.counter.tocdepth}%
- \important{\DescRef{\LabelBase.counter.tocdepth}}\IndexCounter{tocdepth}
+ %\important{\DescRef{\LabelBase.counter.tocdepth}}
+ \IndexCounter{tocdepth}
ist.
Diese Eigenschaft ist für alle Stile zwingend und wird bei der
@@ -1495,46 +1529,48 @@ Anweisung \Macro{l@\PName{Eintragsebene}}.
Die Erkennung funktioniert übrigens nur, solange sich \Macro{lastpenalty}
seit dem letzten Eintrag nicht geändert hat.
- Initialisiert wird die Eigenschaft mit \DescRef{\LabelBase.cmd.LastTOCLevelWasLower} (siehe
+ Initialisiert wird die Eigenschaft mit
+ \DescRef{\LabelBase.cmd.LastTOCLevelWasLower} (siehe
\DescPageRef{\LabelBase.cmd.LastTOCLevelWasLower}).%
}%
\entry{\OptionVName{onstartlowerlevel}{Code}}{%
Der Stil \PValue{tocline} kann zu Beginn eines Eintrags eine Aktion in
Abhängigkeit davon ausführen, ob der zuletzt gesetzte Eintrag einen
- höheren, denselben oder einen niedrigeren \PName{level}-Wert
- hatte. Der im Falle, dass der aktuelle Eintrag einen kleineren
- \PName{level}-Wert besitzt, in der Hierarchie der Einträge also höher
- steht, wird der über diese Eigenschaft angegebene \PName{Code} ausgeführt.
+ höheren, denselben oder einen niedrigeren \PName{level}-Wert hatte. Im
+ Falle, dass der aktuelle Eintrag einen kleineren \PName{level}-Wert
+ besitzt, in der Hierarchie der Einträge also höher steht, wird der über
+ diese Eigenschaft angegebene \PName{Code} ausgeführt.
Die Erkennung funktioniert übrigens nur, solange sich \Macro{lastpenalty}
seit dem letzten Eintrag nicht geändert hat.
- Initialisiert wird die Eigenschaft mit \DescRef{\LabelBase.cmd.LastTOCLevelWasHigher} (siehe
+ Initialisiert wird die Eigenschaft mit
+ \DescRef{\LabelBase.cmd.LastTOCLevelWasHigher} (siehe
\DescPageRef{\LabelBase.cmd.LastTOCLevelWasHigher}), was normalerweise
dazu führt, dass ein Umbruch vor dem Eintrag begünstigt wird.%
}%
\entry{\OptionVName{onstartsamelevel}{Code}}{%
Der Stil \PValue{tocline} kann zu Beginn eines Eintrags eine Aktion in
Abhängigkeit davon ausführen, ob der zuletzt gesetzte Eintrag einen
- höheren, denselben oder einen niedrigeren \PName{level}-Wert
- hatte. Der im Falle, dass der aktuelle Eintrag denselben
- \PName{level}-Wert besitzt, in der Hierarchie der Einträge also gleich
- gestellt ist, wird der über diese Eigenschaft angegebene \PName{Code}
- ausgeführt.
+ höheren, denselben oder einen niedrigeren \PName{level}-Wert hatte. Im
+ Falle, dass der aktuelle Eintrag denselben \PName{level}-Wert besitzt, in
+ der Hierarchie der Einträge also gleich gestellt ist, wird der über diese
+ Eigenschaft angegebene \PName{Code} ausgeführt.
Die Erkennung funktioniert übrigens nur, solange sich \Macro{lastpenalty}
seit dem letzten Eintrag nicht geändert hat.
- Initialisiert wird die Eigenschaft mit \DescRef{\LabelBase.cmd.LastTOCLevelWasSame} (siehe
- \DescPageRef{\LabelBase.cmd.LastTOCLevelWasSame}), was normalerweise
- dazu führt, dass ein Umbruch vor dem Eintrag begünstigt wird.%
+ Initialisiert wird die Eigenschaft mit
+ \DescRef{\LabelBase.cmd.LastTOCLevelWasSame} (siehe
+ \DescPageRef{\LabelBase.cmd.LastTOCLevelWasSame}), was normalerweise dazu
+ führt, dass ein Umbruch vor dem Eintrag begünstigt wird.%
}%
\entry{\OptionVName{pagenumberbox}{Befehl}}{%
Normalerweise wird die zu einem Eintrag gehörende Seitenzahl rechtsbündig
in eine Box der Breite \Macro{@pnumwidth} gesetzt. Beim Stil
\PValue{tocline} kann der Befehl, der dazu verwendet wird, über diese
- Eigenschaft konfiguriert werden. Der dabei anzugebende \PName{Befehl}
- hat genau ein Argument zu erwarten.
+ Eigenschaft konfiguriert werden. Der dabei anzugebende \PName{Befehl} hat
+ genau ein Argument zu erwarten.
Initialisiert wird die Eigenschaft mit der bereits erwähnten Box.%
}%
@@ -1542,7 +1578,7 @@ Anweisung \Macro{l@\PName{Eintragsebene}}.
Über diese Eigenschaft kann die Formatierung der Seitenzahl des Eintrags
verändert werden. Der dabei als Wert angegebene \PName{Befehl} hat genau
ein Argument zu erwarten. Font-Änderungen über \Option{entryformat}
- erfolgen ausgehend von \Option{entryformat} gefolgt von
+ erfolgen ausgehend von \Option{entryformat}, gefolgt von
\Macro{normalfont}\Macro{normalsize}.
Initialisiert wird die Eigenschaft für die \PName{Eintragsebene}
@@ -1632,19 +1668,19 @@ Einlesen dieser Hilfsdatei führt \LaTeX{} dann für jedes \Macro{contentsline}
eine Anweisung \Macro{l@\PName{Eintragsebene}} aus.
Wird später einer \PName{Eintragsebene} über
-\DescRef{\LabelBase.cmd.DeclareTOCStyleEntry} der \PName{Stil} zugewiesen, so
-wird zunächst der optionale \PName{Initialisierungscode} ausgeführt und dann
-\Macro{l@\PName{Eintragsebene}} als \PName{Befehlscode}
-definiert. \PName{Befehlscode} ist also letztlich der Code, der bei
+\DescRef{\LabelBase.cmd.DeclareTOCStyleEntry} ein \PName{Stil} zugewiesen, so
+wird zunächst \PName{Initialisierungscode} ausgeführt falls angegeben und dann
+\PName{Befehlscode} für die Definition von \Macro{l@\PName{Eintragsebene}}
+verwendet. \PName{Befehlscode} ist also letztlich der Code, der bei
\Macro{l@\PName{Eintragsebene}} ausgeführt wird. Dabei ist \texttt{\#1} der
Name der Eintragsebene, während \texttt{\#\#1} und \texttt{\#\#2} Platzhalter
für die beiden Argumente von \Macro{l@\PName{Eintragsebene}} sind.
-Der \PName{Initialisierungscode} dient einerseits dazu, alle Einstellungen zu
-initialisieren. Entwickler sollten darauf achten, dass wirklich alle
-Einstellungen hier bereits einen Wert erhalten, damit
-\DescRef{\LabelBase.cmd.DeclareTOCStyleEntry} auch ohne Angabe einer
-\PName{Optionenliste} fehlerfrei funktioniert. Darüber hinaus hat der
+Der \PName{Initialisierungscode} dient einerseits dazu, die Einstellungen
+eines Stils zu initialisieren. Entwickler\textnote{Empfehlung!} sollten darauf
+achten, dass wirklich alle Einstellungen hier bereits einen Wert erhalten. Nur
+dann funktioniert \DescRef{\LabelBase.cmd.DeclareTOCStyleEntry} auch ohne
+Angabe einer \PName{Optionenliste} fehlerfrei. Darüber hinaus hat der
\PName{Initialisierungscode} auch alle Optionen, die der jeweilige Stil
versteht, zu definieren. Zwingend vordefiniert wird lediglich
\Option{level}. Der eingestellte Wert für \Option{level} kann in
@@ -1653,12 +1689,13 @@ versteht, zu definieren. Zwingend vordefiniert wird lediglich
beispielsweise mit dem Wert des Zählers
\DescRef{\LabelBase.counter.tocdepth}\IndexCounter{tocdepth} zu vergleichen.
-Zur Definition neuer Optionen zur Einstellung von Eigenschaften einer
-Eintragsebene stehen nur innerhalb von \PName{Initialisierungscode} die
-Anweisungen \Macro{DefineTOCEntryBooleanOption},
+Zur Definition neuer Optionen für die Eigenschaften einer
+Eintragsebene existieren nur innerhalb von \PName{Initialisierungscode} die
+Anweisungen \iffree{\Macro{DefineTOCEntryBooleanOption},
\Macro{DefineTOCEntryCommandOption}, \Macro{DefineTOCEntryIfOption},
-\Macro{DefineTOCEntryLengthOption} und \Macro{DefineTOCEntryNumberOption}.
-All diese Anweisungen definieren jeweils eine \PName{Option}, die bei ihrem
+\Macro{DefineTOCEntryLengthOption} und
+\Macro{DefineTOCEntryNumberOption}}{\Macro{DefineTOCEntry\dots Option}}.
+Diese Anweisungen definieren jeweils eine \PName{Option}, die bei ihrem
Aufruf eine Anweisung
\Macro{\PName{Präfix}\PName{Eintragsebene}\PName{Postfix}} mit dem übergebenen
Wert oder bei Fehlen einer Wertzuweisung mit dem \PName{Säumniswert}
@@ -1693,29 +1730,32 @@ entsprechen.
Innerhalb von Stil \PValue{tocline} wird beispielsweise
\begin{lstcode}
- \DefineTOCEntryCommandOption{linefill}[\TOCLineLeaderFill]%
- {scr@tso@}{@linefill}{filling between text and page number}%
+ \DefineTOCEntryCommandOption{linefill}%
+ [\TOCLineLeaderFill]{scr@tso@}{@linefill}%
+ {filling between text and page number}%
\end{lstcode}
-verwendet, um Option \Option{linefill} mit dem \PName{Säumniswert}
-\DescRef{\LabelBase.cmd.TOCLineLeaderFill} zu definieren. Ein Aufruf wie
+verwendet, um Option \Option{linefill} zu definieren. Durch die Angabe von
+\DescRef{\LabelBase.cmd.TOCLineLeaderFill} als \PName{Säumniswert} würde ein
+Aufruf wie
\begin{lstcode}
\RedeclareTOCStyleEntry[linefill]{tocline}{part}
\end{lstcode}
-würde daher unter anderem die Definition
+unter anderem die Definition
\begin{lstcode}
\def\scr@tso@part@linefill{\TOCLineLeaderFill}
\end{lstcode}
vornehmen.
-Wer sich selbst einen Stil definieren möchte, dem sei empfohlen, zunächst die
-Definition des Stils \PValue{dottedtocline} zu studieren. Nachdem dessen
-Definition verstanden wurde, gibt dann die deutlich komplexere Definition von
-Stil \PValue{tocline} viele Hinweise darauf, wie die Anweisungen sinnvoll zu
-verwenden sind.
+Wer\textnote{Tipp!} sich selbst einen Stil definieren möchte, dem sei
+empfohlen, zunächst die Definition des Stils \PValue{dottedtocline} zu
+studieren. Nachdem dessen Definition verstanden wurde, gibt dann die deutlich
+komplexere Definition von Stil \PValue{tocline} viele Hinweise darauf, wie die
+Anweisungen sinnvoll zu verwenden sind.
-In vielen Fällen wird es jedoch auch ausreichen, einen der vorhandenen Stile
-mit \DescRef{\LabelBase.cmd.CloneTOCEntryStyle} zu klonen und dann dessen
-Initialisierungscode mit \DescRef{\LabelBase.cmd.TOCEntryStyleInitCode} oder
+In\textnote{Tipp!} vielen Fällen wird es jedoch auch ausreichen, einen der
+vorhandenen Stile mit \DescRef{\LabelBase.cmd.CloneTOCEntryStyle} zu klonen
+und dann dessen Initialisierungscode mit Anweisung
+\DescRef{\LabelBase.cmd.TOCEntryStyleInitCode} oder
\DescRef{\LabelBase.cmd.TOCEntryStyleStartInitCode} abzuändern.
\Macro{DefineTOCEntryOption} dient eher der Definition der übrigen
@@ -1735,9 +1775,12 @@ mit denselben Eigenschaften und Voreinstellungen wie der existierende
\Macro{CloneTOCEntryStyle}, um den Stil \PValue{default} als Klon von
\PValue{dottedtocline} zu deklarieren. Die \KOMAScript-Klassen verwenden die
Anweisung um die Stile \PValue{part}, \PValue{section} und \PValue{chapter}
-oder \PValue{subsection} als Klon von \PValue{tocline} zu deklarieren und den
-Stil \PValue{default} neu als Klon von \PValue{section} beziehungsweise
-\PValue{subsection} zu deklarieren.%
+oder \PValue{subsection} als Klon von \PValue{tocline} zu deklarieren und dann
+mit \DescRef{\LabelBase.cmd.TOCEntryStyleInitCode} und
+\DescRef{\LabelBase.cmd.TOCEntryStyleStartInitCode} abzuändern. Der Stil
+\PValue{default} wird von \Class{scrbook} und \Class{scrreprt} neu als Klon
+von \PValue{section} und von \Class{scrartcl} als Klon von \PValue{subsection}
+deklariert.%
\EndIndexGroup
@@ -1751,14 +1794,15 @@ Jeder\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} Verzeichniseintragsstil
verfügt über einen Initialisierungscode. Dieser wird immer dann aufgerufen,
wenn einer Verzeichnisebene der entsprechende \PName{Stil} mit
\DescRef{\LabelBase.cmd.DeclareTOCEntryStyle}\IndexCmd{DeclareTOCEntryStyle}
-zugewiesen wird. Dieser \PName{Initialisierungscode} sollte keine globalen
-Seiteneffekte aufweisen, da er auch für lokale Initialisierungen innerhalb
-anderer Anweisungen wie \DescRef{\LabelBase.cmd.DeclareNewTOC}\IndexCmd{DeclareNewTOC}
-verwendet wird. Der \PName{Initialisierungscode} dient einerseits dazu,
-Eigenschaften für den jeweiligen \PName{Stil} zu definieren. Er setzt aber
-auch die Standardeinstellungen für diese Eigenschaften.
-
-Mit Hilfe von \Macro{TOCEntryStyleStartInitCode} und
+zugewiesen wird. Dieser\textnote{Achtung!} \PName{Initialisierungscode} sollte
+keine globalen Seiteneffekte aufweisen, da er auch für lokale
+Initialisierungen innerhalb anderer Anweisungen wie
+\DescRef{\LabelBase.cmd.DeclareNewTOC}\IndexCmd{DeclareNewTOC} verwendet
+wird. Der \PName{Initialisierungscode} dient einerseits dazu, Eigenschaften
+für den jeweiligen \PName{Stil} zu definieren. Er setzt aber auch die
+Standardeinstellungen für diese Eigenschaften.
+
+Mit Hilfe der Anweisungen \Macro{TOCEntryStyleStartInitCode} und
\Macro{TOCEntryStyleInitCode} kann der für einen \PName{Stil} bereits
definierte Initialisierungscode um weiteren \PName{Initialisierungscode}
erweitert werden. Dabei fügt \Macro{TOCEntryStyleStartInitCode} den neuen
@@ -1787,8 +1831,9 @@ definieren.%
\Macro{LastTOCLevelWasLower}
\end{Declaration}
Bei\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} Einträgen im Stil
-\PValue{tocline} wird am Anfang abhängig von \Macro{lastpenalty} eine dieser
-drei Anweisungen ausgeführt. Dabei fügen \Macro{LastTOCLevelWasHigher} und
+\PValue{tocline} wird am Anfang abhängig vom Wert von
+\Macro{lastpenalty}\IndexCmd{lastpenalty} eine dieser drei Anweisungen
+ausgeführt. Dabei fügen \Macro{LastTOCLevelWasHigher} und
\Macro{LastTOCLevelWasSame} im vertikalen Modus
\Macro{addpenalty}\PParameter{\Macro{@lowpenalty}} ein und ermöglichen so
einen Umbruch vor Einträgen gleicher oder übergeordneter
@@ -1797,8 +1842,8 @@ dass zwischen einem Eintrag und seinem ersten Untereintrag normalerweise ein
Umbruch untersagt ist.
Anwender sollten diese Anweisungen nicht umdefinieren. Stattdessen können und
-sollten Änderungen für die jeweiligen Eintragsebenen gezielt über die
-Eigenschaften \PValue{onstartlowerlevel}, \PValue{onstartsamelevel} und
+sollten Änderungen bei Zuweisung des Stils an eine Eintragsebene gezielt über
+die Eigenschaften \PValue{onstartlowerlevel}, \PValue{onstartsamelevel} und
\PValue{onstarthigherlevel} vorgenommen werden.%
\EndIndexGroup
@@ -1811,11 +1856,12 @@ als Wert für die Eigenschaft \Option{linefill} des Verzeichniseintragsstils
\PName{tocline} verwendet zu werden. Sie erzeugt dann eine Verbindung zwischen
dem Ende des Textes eines Eintrags und der zugehörigen Seitenzahl. Das
\PName{Füllzeichen}, das dazu in regelmäßigem Abstand wiederholt wird, kann
-als optionales Argument angegeben werden. Voreinstellung ist ein Punkt.
+als optionales Argument angegeben werden. Voreinstellung ist ein
+Punkt.\textnote{Voreinstellung}
Wie der Name schon vermuten lässt, werden die Füllzeichen mit Hilfe von
-\Macro{leaders} gesetzt. Als Abstand wird wie bei \Macro{@dottedtocline} aus
-dem \LaTeX-Kern vor und nach dem Füllzeichen
+\Macro{leaders} gesetzt. Als Abstand wird wie bei der \LaTeX-Kern-Anweisung
+\Macro{@dottedtocline} vor und nach dem Füllzeichen
\Macro{mkern}\Macro{@dotsep}\Unit{\texttt{mu}} verwendet.%
\EndIndexGroup
%
@@ -1830,7 +1876,7 @@ Benutzung durch Klassen- und Paketautoren freigegeben ist. Diese Anweisungen
beginnen alle mit \Macro{tocbasic@}. Aber\textnote{Achtung!} auch Klassen- und
Paketautoren sollten diese Anweisungen nur verwenden und nicht etwa
umdefinieren! Ihre interne Funktion kann jederzeit geändert oder erweitert
-werden, so dass Umdefinierung der Anweisungen die Funktion von
+werden, so dass jede Umdefinierung der Anweisungen die Funktion von
\Package{tocbasic} erheblich beschädigen könnte!
@@ -1856,39 +1902,43 @@ die Eigenschaft \PValue{nobabel}\important{\PValue{nobabel}} (siehe
\DescRef{\LabelBase.cmd.setuptoc}, \autoref{sec:tocbasic.toc},
\DescPageRef{\LabelBase.cmd.setuptoc}) kann dies unterdrückt werden. Für die
Dateinamenerweiterungen \File{toc}, \File{lof} und \File{lot} unterdrückt
-\Package{tocbasic} dies bereits selbst, damit die Umschaltung nicht mehrfach
-in die zugehörigen Dateien eingetragen wird.
+\Package{tocbasic} dies bereits selbst, %
+\iftrue% Umbruchvarianten
+da \Package{babel} sie von sich aus vornimmt.%
+\else%
+damit die Umschaltung nicht mehrfach in die zugehörigen Dateien
+eingetragen wird.%
+\fi
Normalerweise gibt es keinen Grund, diese Anweisung selbst aufzurufen. Es sind
allerdings Verzeichnisse denkbar, die nicht unter der Kontrolle von
\Package{tocbasic} stehen, also nicht in der Liste der bekannten
Dateierweiterungen geführt werden, aber trotzdem die Spracherweiterung für
-\Package{babel} nutzen sollen. Für diese ist die Anweisung explizit
-aufzurufen. Bitte achten Sie jedoch darauf, dass dies für jede Dateierweiterung
-nur einmal geschieht!
-%
+\Package{babel} nutzen sollen. Für derartige Verzeichnisse wäre die Anweisung
+explizit aufzurufen. Bitte\textnote{Achtung!} achten Sie jedoch darauf, dass
+dies für jede Dateierweiterung nur einmal geschieht!%
\EndIndexGroup
\begin{Declaration}
\Macro{tocbasic@starttoc}\Parameter{Dateierweiterung}
\end{Declaration}
-Diese Anweisung ist der eigentlich Ersatz der Anweisung
+Diese Anweisung ist der eigentliche Ersatz der Anweisung
\Macro{@starttoc}\IndexCmd{@starttoc}\important{\Macro{@starttoc}} aus dem
-\LaTeX-Kern. Es ist die Anweisung, die sich hinter \DescRef{\LabelBase.cmd.listoftoc*} (siehe
-\autoref{sec:tocbasic.toc}, \DescPageRef{\LabelBase.cmd.listoftoc*})
-verbirgt. Klassen- oder Paketautoren, die Vorteile von \Package{tocbasic}
-nutzen wollen, sollten zumindest diese Anweisung, besser jedoch
-\DescRef{\LabelBase.cmd.listoftoc} verwenden. Die Anweisung baut selbst auf \Macro{@starttoc}
-auf, setzt allerdings zuvor
-\Length{parskip}\IndexLength{parskip}\important[i]{\Length{parskip}\\
- \Length{parindent}\\
- \Length{parfillskip}} und \Length{parindent}\IndexLength{parindent} auf 0
-und \Length{parfillskip}\IndexLength{parfillskip} auf 0 bis
-unendlich. Außerdem wird
-\Macro{@currext}\important{\Macro{@currext}}\IndexCmd{@currext} auf die
+\LaTeX-Kern. Es ist die Anweisung, die sich hinter
+\DescRef{\LabelBase.cmd.listoftoc*} (siehe \autoref{sec:tocbasic.toc},
+\DescPageRef{\LabelBase.cmd.listoftoc*}) verbirgt. Klassen- oder Paketautoren,
+die Vorteile von \Package{tocbasic} nutzen wollen, sollten zumindest diese
+Anweisung, besser jedoch \DescRef{\LabelBase.cmd.listoftoc} verwenden. Die
+Anweisung baut selbst auf \Macro{@starttoc} auf, setzt allerdings zuvor
+\Length{parskip}\IndexLength{parskip}\important[i]{\Length{parskip},
+ \Length{parindent}, \Length{parfillskip}} und
+\Length{parindent}\IndexLength{parindent} auf 0 und
+\Length{parfillskip}\IndexLength{parfillskip} auf 0 bis unendlich. Außerdem
+wird \Macro{@currext}\important{\Macro{@currext}}\IndexCmd{@currext} auf die
aktuelle Dateierweiterung gesetzt, damit diese in den nachfolgend ausgeführten
-Haken ausgewertet werden kann.
+Haken\Index{Haken} ausgewertet werden kann. Die Erklärungen der Haken finden
+Sie im Anschluss.
Da\textnote{Achtung!} \LaTeX{} bei der Ausgabe eines Verzeichnisses auch
gleich eine neue Verzeichnisdatei zum Schreiben öffnet, kann der Aufruf dieser
@@ -1901,8 +1951,7 @@ Anweisung zu einer Fehlermeldung der Art
führen, wenn keine Schreibdateien mehr zur Verfügung stehen. Abhilfe kann in
diesem Fall das Laden des in \autoref{cha:scrwfile} beschriebenen Pakets
\Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile}
-bieten.
-%
+oder die Verwendung von Lua\LaTeX{} bieten.%
\EndIndexGroup
@@ -1910,16 +1959,17 @@ bieten.
\Macro{tocbasic@@before@hook}
\Macro{tocbasic@@after@hook}
\end{Declaration}
-Der Haken \Macro{tocbasic@@before@hook} wird unmittelbar vor dem Einlesen der
-Verzeichnisdatei, noch vor den mit \DescRef{\LabelBase.cmd.BeforeStartingTOC}
-definierten Anweisungen ausgeführt. Es ist erlaubt, diesen Haken mit Hilfe von
+Der Haken\Index{Haken} \Macro{tocbasic@@before@hook} wird unmittelbar vor dem
+Einlesen der Verzeichnisdatei, noch vor den mit
+\DescRef{\LabelBase.cmd.BeforeStartingTOC} definierten Anweisungen
+ausgeführt. Es ist erlaubt, diesen Haken mit Hilfe von
\Macro{g@addto@macro}\IndexCmd{g@addto@macro} zu erweitern.
Ebenso wird \Macro{tocbasic@@after@hook} unmittelbar nach der
Verzeichnisdatei, aber noch vor den mit
\DescRef{\LabelBase.cmd.AfterStartingTOC} definierten Anweisungen
-ausgeführt. Es ist erlaubt, diesen Haken mit Hilfe von \Macro{g@addto@macro}
-zu erweitern.
+ausgeführt. Es ist erlaubt, diesen Haken mit Hilfe von
+\Macro{g@addto@macro}\IndexCmd{g@addto@macro} zu erweitern.
\KOMAScript{} nutzt diese Haken, um Verzeichnisse mit dynamischer Anpassung an
die Breite der Gliederungsnummern zu ermöglichen. Ihre Verwendung ist Klassen
@@ -1932,9 +1982,8 @@ innerhalb der beiden Haken sind nicht gestattet!
Wird keine\textnote{Achtung!} der Anweisungen
\DescRef{\LabelBase.cmd.listofeachtoc}, \DescRef{\LabelBase.cmd.listoftoc} und
\DescRef{\LabelBase.cmd.listoftoc*} für die Ausgabe der Verzeichnisse
-verwendet, sollten die beiden Anweisungen für die Haken trotzdem aufgerufen
-werden.
-%
+verwendet, sollten die Anweisungen für die Haken\Index{Haken} trotzdem
+aufgerufen werden.%
\EndIndexGroup
@@ -1942,19 +1991,20 @@ werden.
\Macro{tb@\PName{Dateierweiterung}@before@hook}
\Macro{tb@\PName{Dateierweiterung}@after@hook}
\end{Declaration}
-Diese Anweisungen werden direkt nach \DescRef{\LabelBase.cmd.tocbasic@@before@hook} bzw. vor
-\DescRef{\LabelBase.cmd.tocbasic@@after@hook} für das jeweilige Verzeichnis mit der
-entsprechenden \PName{Dateierweiterung} ausgeführt. Sie\textnote{Achtung!}
-dürfen keinesfalls von Klassen- und Paketautoren verändert werden. Werden für
-die Ausgabe der Verzeichnisse die Anweisungen
-\DescRef{\LabelBase.cmd.listoftoc}, \DescRef{\LabelBase.cmd.listoftoc*} und
-\DescRef{\LabelBase.cmd.listofeachtoc} nicht verwendet, sollten die beiden
-Anweisungen für die Haken trotzdem aufgerufen werden, soweit sie definiert
-sind. Die Anweisungen können auch undefiniert sein. Für einen entsprechenden
-Test siehe
+Diese Anweisungen werden direkt nach
+\DescRef{\LabelBase.cmd.tocbasic@@before@hook} bzw. vor
+\DescRef{\LabelBase.cmd.tocbasic@@after@hook} für das jeweilige Verzeichnis
+mit der entsprechenden \PName{Dateierweiterung}
+ausgeführt. Sie\textnote{Achtung!} dürfen keinesfalls von Klassen- und
+Paketautoren verändert werden. Werden für die Ausgabe der Verzeichnisse die
+Anweisungen \DescRef{\LabelBase.cmd.listoftoc},
+\DescRef{\LabelBase.cmd.listoftoc*} und \DescRef{\LabelBase.cmd.listofeachtoc}
+nicht verwendet, sollten die beiden Anweisungen für die Haken\Index{Haken}
+trotzdem aufgerufen werden, soweit sie definiert sind. Die Anweisungen können
+auch undefiniert sein. Für einen entsprechenden Test siehe
\DescRef{scrbase.cmd.scr@ifundefinedorrelax}\IndexCmd{scr@ifundefinedorrelax}
-in \autoref{sec:scrbase.if}, \DescPageRef{scrbase.cmd.scr@ifundefinedorrelax}.
-%
+in \autoref{sec:scrbase.if},
+\DescPageRef{scrbase.cmd.scr@ifundefinedorrelax}.%
\EndIndexGroup
@@ -1969,8 +2019,7 @@ Anweisung sein. Wenn Sie Ihre eigene Anweisung für die Überschrift definieren,
können Sie ebenfalls \Macro{tocbasic@listhead} verwenden. In diesem Fall
sollte vor dem Aufruf von \Macro{tocbasic@listhead} die Anweisung
\Macro{@currext}\important{\Macro{@currext}}\IndexCmd{@currext} auf die
-Dateinamenerweiterung, die zu diesem Verzeichnis gehört, gesetzt werden.
-%
+Dateinamenerweiterung, die zu diesem Verzeichnis gehört, gesetzt werden.%
\EndIndexGroup
@@ -1978,9 +2027,9 @@ Dateinamenerweiterung, die zu diesem Verzeichnis gehört, gesetzt werden.
\Macro{tocbasic@listhead@\PName{Dateierweiterung}}\Parameter{Titel}
\end{Declaration}
Ist diese individuelle Anweisung für das Setzen einer Verzeichnisüberschrift
-definiert, so verwendet \DescRef{\LabelBase.cmd.tocbasic@listhead} diese. Anderenfalls
-definiert \DescRef{\LabelBase.cmd.tocbasic@listhead} diese und ruft sie dann auf.
-%
+definiert, so verwendet \DescRef{\LabelBase.cmd.tocbasic@listhead}
+sie. Anderenfalls definiert \DescRef{\LabelBase.cmd.tocbasic@listhead} diese
+vor der Verwendung.%
\EndIndexGroup
@@ -1994,19 +2043,22 @@ definiert \DescRef{\LabelBase.cmd.tocbasic@listhead} diese und ruft sie dann auf
Anweisung\ChangedAt{v3.12}{\Package{tocbasic}}
\Macro{tocbasic@addxcontentsline} nimmt einen \PName{Eintrag} der angegebenen
\PName{Ebene} in das über die \PName{Dateierweiterung} spezifizierte
-Verzeichnis vor. Ob der Eintrag nummeriert wird oder nicht, hängt davon ab, ob
-das Argument \PName{Gliederungsnummer} leer ist oder nicht. Im Falle eines
-leeren Argument wird dem \PName{Eintrag} ein \Macro{nonumberline} ohne
-Argument vorangestellt. Anderenfalls wird wie gewohnt
-\DescRef{\LabelBase.cmd.numberline} mit \PName{Gliederungsnummer} als Argument
-verwendet.
+Verzeichnis vor. Ob der Eintrag nummeriert wird\iffree{ oder
+ nicht}{}% Umbruchvarianten
+, hängt davon ab, ob das Argument \PName{Gliederungsnummer} leer ist oder
+nicht. Im Falle eines leeren Argument wird dem \PName{Eintrag} ein
+\Macro{nonumberline} ohne Argument vorangestellt. Anderenfalls wird wie
+gewohnt \DescRef{\LabelBase.cmd.numberline} mit \PName{Gliederungsnummer} als
+Argument verwendet.
Die Anweisung \Macro{nonumberline} wird innerhalb
\DescRef{\LabelBase.cmd.listoftoc} (siehe \autoref{sec:tocbasic.toc},
\DescPageRef{\LabelBase.cmd.listoftoc}) entsprechend der Eigenschaft
\PValue{numberline} (siehe \autoref{sec:tocbasic.toc},
\DescPageRef{\LabelBase.cmd.setuptoc}) umdefiniert. Dadurch wirkt sich das
-Setzen oder Löschen dieser Eigenschaft bereits beim nächsten \LaTeX-Lauf aus.%
+Setzen oder Löschen dieser Eigenschaft \iffree{bereits beim nächsten
+ \LaTeX-Lauf}{unmittelbar} % Umbruchvarianten
+aus.%
%
\EndIndexGroup
@@ -2017,21 +2069,30 @@ Setzen oder Löschen dieser Eigenschaft bereits beim nächsten \LaTeX-Lauf aus.%
\end{Declaration}
Der\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} Verzeichniseintragsstil
\PValue{tocline} (siehe \autoref{sec:tocbasic.tocstyle}) setzt am Ende jedes
-Eintrags \Macro{penalty} so, dass nach einem Eintrag kein Seitenumbruch
-erfolgen darf. Dabei wird der genaue Wert abhängig von der
-\PName{Eintragsebene} gewählt. Dies erledigt
-\Macro{tocbasic@SetPenaltyByTOCLevel}. Am Anfang eines Eintrags wird dann über
-\Macro{tocbasic@DependOnPenaltyAndTOCLevel} abhängig von \Macro{lastpenalty}
-und der aktuellen \PName{Eintragsebene} die über die Eigenschaften
-\Option{onstartlowerlevel}, \Option{onstartsamelevel} oder
-\Option{onstarthigherlevel} festgelegte Aktion eines der internen Makros
-\Macro{scr@tso@\PName{Eintragsebene}@LastTOCLevelWasHigher},
-\Macro{scr@tso@\PName{Eintragsebene}@LastTOCLevelWasSame} oder
-\Macro{scr@tso@\PName{Eintragsebene}@LastTOCLevelWasLower} ausgeführt. In der
-Voreinstellung erlauben die ersten beiden einen Umbruch, wenn sie im
-vertikalen Modus ausgeführt werden.
-
-Entwickler, die eigene Stile kompatibel mit Stil \PValue{tocline} erstellen
+Eintrags über \Macro{tocbasic@SetPenaltyByTOCLevel} \Macro{penalty} so, dass
+nach einem Eintrag kein Seitenumbruch erfolgen darf. Der genaue Wert wird
+dabei abhängig von der \PName{Eintragsebene} gewählt.
+
+% \begin{sloppypar}
+\begingroup
+\emergencystretch=2em
+Über \Macro{tocbasic@DependOnPenaltyAndTOCLevel} wird am Anfang eines
+Eintrags, abhängig von \Macro{lastpenalty} und der \PName{Eintragsebene} die
+über die Eigenschaft \Option{onstartlowerlevel} im internen Makro
+\Macro{scr@tso@\PName{Eintragsebene}@LastTOCLevelWasHigher}, über die
+\iffree{Eigenschaft}{Ei\-genschaft}
+\Option{onstartsamelevel} im zugehörigen, internen
+Makro\iffree{
+}{\linebreak}\Macro{scr@tso@\PName{Eintragsebene}@LastTOCLevelWasSame} oder
+über die Eigenschaft \Option{onstarthigherlevel} im zugehörigen, internen
+Makro \Macro{scr@tso@\PName{Eintragsebene}@LastTOCLevelWasLower} gespeicherte
+Aktion ausgeführt. In der Voreinstellung\textnote{Voreinstellung} erlauben die
+ersten beiden einen Umbruch, wenn sie im vertikalen Modus ausgeführt
+werden.\par
+\endgroup
+%\end{sloppypar}
+
+Entwicklern, die eigene Stile kompatibel mit \PValue{tocline} erstellen
wollen, sei empfohlen, dieses Verhalten zu kopieren. Zu diesem Zweck dürfen
sie auf diese eigentlich internen Makros zurückgreifen.%
\EndIndexGroup
@@ -2052,30 +2113,27 @@ verwendet werden müssen.
Als\textnote{Umgebung} erstes wird eine Umgebung benötigt, die diese neue
Gleitumgebung bereitstellt. Das geht ganz einfach mit:
-% Umbruchkorrektur: listings korrigiert!
\begin{lstcode}
- \newenvironment{remarkbox}{%
- \@float{remarkbox}%
- }{%
- \end@float
- }
+ \newenvironment{remarkbox}%
+ {\@float{remarkbox}}%
+ {\end@float}
\end{lstcode}
Die neue Umgebung heißt also \Environment{remarkbox}.
Jede\textnote{Platzierung} Gleitumgebung hat eine Standardplatzierung. Diese
-setzt sich aus den bekannten Platzierungsoptionen zusammen:
-% Umbruchkorrektur: listings korrigiert!
+setzt sich aus einer oder mehreren der bekannten Platzierungsoptionen
+\PValue{b}, \PValue{h}, \PValue{p} und \PValue{t} zusammen:
\begin{lstcode}
\newcommand*{\fps@remarkbox}{tbp}
\end{lstcode}
Die neue Gleitumgebung soll also in der Voreinstellung nur oben, unten oder
auf einer eigenen Seite platziert werden dürfen.
-Gleitumgebungen\textnote{Gleittyp} haben außerdem einen nummerischen
-Gleittyp. Umgebungen, bei denen das gleiche Bit im Gleittyp gesetzt ist,
-dürfen sich nicht gegenseitig überholen. Abbildungen und Tabellen haben
-normalerweise den Typ~1 und 2. Sie dürfen sich also gegenseitig überholen.
-% Umbruchkorrektur: listings korrigiert!
+Gleitumgebungen\textnote{Gleittyp} haben außerdem einen nummerischen Gleittyp
+zwischen 1 und 31. Umgebungen, bei denen das gleiche Bit
+im Gleittyp gesetzt ist, dürfen sich nicht gegenseitig überholen. Abbildungen
+und Tabellen haben normalerweise den Typ~1 und 2. Abbildungen dürfen also
+Tabellen überholen und umgekehrt.
\begin{lstcode}
\newcommand*{\ftype@remarkbox}{4}
\end{lstcode}
@@ -2083,11 +2141,11 @@ Die neue Umgebung hat den Typ~4, darf also Tabellen und Abbildungen überholen
und von diesen überholt werden.
Gleitumgebungen\textnote{Nummer} haben außerdem eine Nummer.
-% Umbruchkorrektur: listings korrigiert!
\begin{lstcode}
\newcounter{remarkbox}
\newcommand*{\remarkboxformat}{%
- Merksatz~\theremarkbox\csname autodot\endcsname}
+ Merksatz~\theremarkbox\csname autodot\endcsname
+ }
\newcommand*{\fnum@remarkbox}{\remarkboxformat}
\end{lstcode}
Hier wird zunächst ein neuer Zähler definiert, der unabhängig von Kapiteln
@@ -2099,7 +2157,6 @@ Ausgabe wird wiederum als Gleitumgebungsnummer für die Verwendung in
Gleitumgebungen\textnote{Dateierweiterung} haben Verzeichnisse und diese haben
eine Datei mit dem Namen \Macro{jobname} und einer Dateierweiterung.
-% Umbruchkorrektur: listings korrigiert!
\begin{lstcode}
\newcommand*{\ext@remarkbox}{lor}
\end{lstcode}
@@ -2109,12 +2166,10 @@ Die\important{\Package{tocbasic}} Umgebung selbst steht damit. Es fehlt
allerdings das Verzeichnis. Damit wir dabei möglichst wenig selbst machen
müssen, verwenden wir das Paket \Package{tocbasic}. Dieses wird in Dokumenten
mit
-% Umbruchkorrektur: listings korrigiert!
\begin{lstcode}
\usepackage{tocbasic}
\end{lstcode}
geladen. Ein Klassen- oder Paketautor würde hingegen
-% Umbruchkorrektur: listings korrigiert!
\begin{lstcode}
\RequirePackage{tocbasic}
\end{lstcode}
@@ -2122,7 +2177,6 @@ verwenden.
Nun\textnote{Dateierweiterung} machen wir die neue Dateierweiterung dem Paket
\Package{tocbasic} bekannt.
-% Umbruchkorrektur: listings korrigiert!
\begin{lstcode}
\addtotoclist[float]{lor}
\end{lstcode}
@@ -2132,7 +2186,6 @@ von Gleitumgebungen beziehen, auch auf das neue Verzeichnis beziehen.
Jetzt\textnote{Verzeichnistitel} definieren wir noch einen Titel für dieses
Verzeichnis:
-% Umbruchkorrektur: listings korrigiert!
\begin{lstcode}
\newcommand*{\listoflorname}{Verzeichnis der Merksätze}
\end{lstcode}
@@ -2144,22 +2197,20 @@ will. Siehe dazu \autoref{sec:scrbase.languageSupport}, ab
Jetzt\textnote{Verzeichniseintrag}\index{Verzeichnis>Eintrag} müssen wir nur
noch definieren, wie ein einzelner Eintrag in dem Verzeichnis aussehen soll:
-% Umbruchkorrektur: listings korrigiert!
\begin{lstcode}
\newcommand*{\l@remarkbox}{\l@figure}
\end{lstcode}
Weil das die einfachste Lösung ist, wurde hier festgelegt, dass Einträge in
das Verzeichnis der Merksätze genau wie Einträge in das Abbildungsverzeichnis
aussehen sollen. Man hätte auch eine explizite Festlegung wie
-% Umbruchkorrektur: listings korrigiert!
\begin{lstcode}
- \newcommand*{\l@remarkbox}{\@dottedtocline{1}{1em}{1.5em}}
+ \DeclareTOCStyleEntry[level=1,indent=1em,numwidth=1.5em]%
+ {tocline}{remarkbox}
\end{lstcode}
verwenden können.
-Außerdem\textnote{Kapiteleintrag} wollen Sie, das Kapiteleinträge sich auf das
+Außerdem\textnote{Kapiteleintrag} wollen Sie, dass sich Kapiteleinträge auf das
Verzeichnis auswirken.
-% Umbruchkorrektur: listings korrigiert!
\begin{lstcode}
\setuptoc{lor}{chapteratlist}
\end{lstcode}
@@ -2174,7 +2225,6 @@ Inhaltsverzeichniseintrag, mit Inhaltsverzeichniseintrag, mit Nummerierung)
wählen und das Verzeichnis mit
\DescRef{\LabelBase.cmd.listoftoc}\PParameter{lor} ausgeben. Mit einem
schlichten
-% Umbruchkorrektur: listings korrigiert!
\begin{lstcode}
\newcommand*{\listofremarkboxes}{\listoftoc{lor}}
\end{lstcode}
@@ -2200,12 +2250,16 @@ dass der Anwender automatisch von etwaigen zukünftigen Erweiterungen von
\Package{tocbasic} profitiert. Soll der Anwender aber nicht mit der Tatsache
belastet werden, dass für die Merksätze die Dateierweiterung \File{lor}
verwendet wird, so genügt
-% Umbruchkorrektur: listings korrigiert!
\begin{lstcode}
\newcommand*{\setupremarkboxes}{\setuptoc{lor}}
\end{lstcode}
+\iffalse%
um eine als Argument an \Macro{setupremarkboxes} übergebene Liste von
-Eigenschaften direkt als Liste von Eigenschaften für \File{lor} zu setzen.
+Eigenschaften direkt als Liste von %
+\else%
+um über \Macro{setupremarkboxes}
+\fi
+Eigenschaften für \File{lor} zu setzen.
\section{Alles mit einer Anweisung}
@@ -2213,7 +2267,7 @@ Eigenschaften direkt als Liste von Eigenschaften für \File{lor} zu setzen.
Das Beispiel aus dem vorherigen Abschnitt hat gezeigt, dass es mit mit
\Package{tocbasic} recht einfach ist, eigene Gleitumgebungen mit eigenen
-Verzeichnissen zu definieren. In diesem Beispiel wird gezeigt, dass es sogar
+Verzeichnissen zu definieren. In diesem Abschnitt wird gezeigt, dass es sogar
noch einfacher gehen kann.
\begin{Declaration}
@@ -2236,8 +2290,9 @@ können dann verwendet werden.
\PName{Dateierweiterung} definiert dabei die Dateiendung der Hilfsdatei, die
das Verzeichnis repräsentiert, wie dies in \autoref{sec:tocbasic.basics}, ab
-\autopageref{sec:tocbasic.basics} bereits erläutert wurde. Dieser Parameter
-muss angegeben werden und darf nicht leer sein!
+\autopageref{sec:tocbasic.basics} bereits erläutert
+wurde. Dieser\textnote{Achtung!} Parameter muss angegeben werden und darf
+nicht leer sein!
\PName{Optionenliste} ist eine durch Komma getrennte Liste, wie dies auch von
\DescRef{maincls.cmd.KOMAoptions} (siehe \autoref{sec:typearea.options},
@@ -2245,145 +2300,30 @@ muss angegeben werden und darf nicht leer sein!
Optionen\textnote{Achtung!} können jedoch \emph{nicht} mit
\DescRef{maincls.cmd.KOMAoptions}\IndexCmd{KOMAoptions} gesetzt werden! Eine
Übersicht über die möglichen Optionen bietet
-\autoref{tab:tocbasic.DeclareNewTOC-options} ab
-\autopageref{tab:tocbasic.DeclareNewTOC-options}.
+\autoref{tab:tocbasic.DeclareNewTOC-options}\iffalse ab
+\autopageref{tab:tocbasic.DeclareNewTOC-options}\fi.
Wird\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}} Option
\Option{tocentrystyle} nicht gesetzt, so wird bei Bedarf der Stil
\PValue{default} verwendet. Näheres zu diesem Stil ist
\autoref{sec:tocbasic.tocstyle} zu entnehmen. Soll kein Befehl für
Verzeichniseinträge definiert werden, so kann ein leeres Argument, also
-wahlweise \OptionValue{tocentrystyle}{} oder
-\OptionValue{tocentrystyle}{\PParameter{}} verwendet werden. Dies birgt
-allerdings das Risiko, dass bei Ausgabe des entsprechenden Verzeichnisses
-diverse Fehler gemeldet werden.
+wahlweise \OptionValue{tocentrystyle}{}\iffree{}{\unskip} oder
+\OptionValue{tocentrystyle}{\PParameter{}} verwendet werden.
Abhängig\ChangedAt[2016/06]{v3.21}{\Package{tocbasic}} vom Stil der
Verzeichniseinträge können auch alle für diesen Stil gültigen Eigenschaften
gesetzt werden, indem die entsprechenden in
\autoref{tab:tocbasic.tocstyle.attributes} ab
-\autopageref{tab:tocbasic.tocstyle.attributes} aufgeführten Namen mit dem
-Präfix \PValue{tocentry} versehen in der \PName{Optionenliste} angegeben
+\autopageref{tab:tocbasic.tocstyle.attributes} aufgeführten Namen, mit dem
+Präfix \PValue{tocentry} versehen, in der \PName{Optionenliste} angegeben
werden. Nachträgliche Änderungen am Stil sind mit
\DescRef{\LabelBase.cmd.DeclareTOCStyleEntry}%
\IndexCmd{DeclareTOCStyleEntry}%
\important{\DescRef{\LabelBase.cmd.DeclareTOCStyleEntry}} jederzeit
möglich. Siehe dazu \autoref{sec:tocbasic.tocstyle},
\DescPageRef{\LabelBase.cmd.DeclareTOCStyleEntry}.
-%
-\begin{Example}
- Das Beispiel aus \autoref{sec:tocbasic.example} kann mit Hilfe der neuen
- Anweisung deutlich verkürzt werden:
-\begin{lstcode}
- \DeclareNewTOC[%
- type=remarkbox,%
- types=remarkboxes,%
- float,% Gleitumgebungen sollen definiert werden.
- floattype=4,%
- name=Merksatz,%
- listname={Verzeichnis der Merks\"atze}%
- ]{lor}
- \setuptoc{lor}{chapteratlist}
-\end{lstcode}
- Neben den Umgebungen \Environment{remarkbox} und \Environment{remarkbox*}
- sind damit auch der Zähler \Counter{remarkbox}, die zur Ausgabe gehörenden
- Anweisungen \Macro{theremarkbox}, \Macro{remarkboxname} und
- \Macro{remarkboxformat}, die für das Verzeichnis benötigten
- \Macro{listremarkboxname} und \Macro{listofremarkboxes} sowie einige intern
- verwendete Anweisungen mit Bezug auf die Dateiendung \File{lor}
- definiert. Soll der Gleitumgebungstyp dem Paket überlassen werden, so kann
- Option \Option{floattype} im Beispiel entfallen. Wird zusätzlich
- die Option \Option{nonfloat} angegeben, wird außerdem eine nicht gleitende
- Umgebung \Environment{remarkbox-} definiert, in der ebenfalls
- \DescRef{maincls.cmd.caption}\IndexCmd{caption} verwendet werden kann.
- Zum besseren Verständnis zeigt \autoref{tab:tocbasic.comparison} eine
- Gegenüberstellung der Anweisungen und Umgebungen für die neu erstellte
- Beispielumgebung \Environment{remarkbox} mit den entsprechenden Befehlen und
- Umgebungen für Abbildungen.%
- \begin{table}
- \centering
- \caption{Gegenüberstellung von Beispielumgebung \Environment{remarkbox}
- und Umgebung \Environment{figure}}
- \label{tab:tocbasic.comparison}
- \begin{tabularx}{\textwidth}{l@{\hskip\tabcolsep}l@{\hskip\tabcolsep}>{\raggedright}p{7em}@{\hskip\tabcolsep}X}
- \toprule
- \begin{tabular}[t]{@{}l@{}}
- Umgebung\\
- \Environment{remarkbox}
- \end{tabular}
- & \begin{tabular}[t]{@{}l@{}}
- Umgebung\\
- \Environment{figure}
- \end{tabular}
- & Optionen von \Macro{DeclareNewTOC} & Kurzbeschreibung \\[1ex]
- \midrule
- \Environment{remarkbox} & \Environment{figure}
- & \Option{type}, \Option{float}
- & Gleitumgebung des jeweiligen Typs.\\[1ex]
- \Environment{remarkbox*} & \Environment{figure*}
- & \Option{type}, \Option{float}
- & spaltenübergreifende Gleitumgebung des jeweiligen Typs \\[1ex]
- \Counter{remarkbox} & \Counter{figure}
- & \Option{type}, \Option{float}
- & Zähler, der von \DescRef{maincls.cmd.caption} verwendet wird \\[1ex]
- \Macro{theremarkbox} & \Macro{thefigure}
- & \Option{type}, \Option{float}
- & Anweisung zur Ausgabe des jeweiligen Zählers \\[1ex]
- \Macro{remarkboxformat} & \DescRef{maincls.cmd.figureformat}
- & \Option{type}, \Option{float}
- & Anweisung zur Formatierung des jeweiligen Zählers in der Ausgabe von
- \DescRef{maincls.cmd.caption}\\[1ex]
- \Macro{remarkboxname} & \Macro{figurename}
- & \Option{type}, \Option{float}, \Option{name}
- & Name, der im Label von \DescRef{maincls.cmd.caption} verwendet
- wird\\[1ex]
- \Macro{listofremarkboxes} & \DescRef{maincls.cmd.listoffigures}
- & \Option{types}, \Option{float}
- & Anweisung zur Ausgabe des jeweiligen Verzeichnisses \\[1ex]
- \Macro{listremarkboxname} & \Macro{listfigurename}
- & \Option{type}, \Option{float}, \Option{listname}
- & Überschrift des jeweiligen Verzeichnisses \\[1ex]
- \Macro{fps@remarkbox} & \Macro{fps@figure}
- & \Option{type}, \Option{float}, \Option{floattype}
- & nummerischer Gleitumge\-bungstyp zwecks
- Reihen\-fol\-gen\-erhalts\\[1ex]
- \File{lor} & \File{lof}
- &
- & Dateiendung der Hilfsdatei für das jeweilige Verzeichnis \\
- \bottomrule
- \end{tabularx}
- \end{table}
-
- Und hier nun eine mögliche Verwendung der Umgebung:
-\begin{lstcode}
- \begin{remarkbox}
- \centering
- Gleiches sollte immer auf gleiche Weise und
- mit gleichem Aussehen gesetzt werden.
- \caption{Erster Hauptsatz der Typografie}
- \label{rem:typo1}
- \end{remarkbox}
-\end{lstcode}
- Ein Ausschnitt aus einer Beispielseite mit dieser Umgebung könnte dann so
- aussehen:
- \begin{center}\footnotesize
- \begin{tabular}
- {|!{\hspace{.1\linewidth}}p{.55\linewidth}!{\hspace{.1\linewidth}}|}
- \\
- \centering
- Gleiches sollte immer auf gleiche Weise und
- mit gleichem Aussehen gesetzt werden.\\[\abovecaptionskip]
- {%
- \usekomafont{caption}\footnotesize
- \begin{tabularx}{\hsize}[t]{@{}l@{ }X@{}}
- \usekomafont{captionlabel}{Merksatz 1:} &
- Erster Hauptsatz der Typografie \\
- \end{tabularx}
- }\\
- \end{tabular}%
- \end{center}%
-\end{Example}%
% Umbruchoptimierung: Tabelle verschoben.
\begin{desclist}
\renewcommand*{\abovecaptionskipcorrection}{-\normalbaselineskip}%
@@ -2410,7 +2350,7 @@ möglich. Siehe dazu \autoref{sec:tocbasic.tocstyle},
\Counter{\PName{Eintragstyp}} (siehe Option \Option{type})
angelegt. Dieser Zähler kann in gleicher Weise wie beispielsweise der
Zähler \Counter{figure} bei \Class{book}-Klassen von Zähler
- \Counter{chapter} abhängt von einem \LaTeX-Zähler ahängig gemacht
+ \Counter{chapter} abhängt, von einem \LaTeX-Zähler ahängig gemacht
werden.}%
\entry{\Option{float}}{%
Es wird nicht nur ein neuer Verzeichnistyp definiert, sondern auch
@@ -2481,7 +2421,7 @@ möglich. Siehe dazu \autoref{sec:tocbasic.tocstyle},
Jedes Verzeichnis hat eine Überschrift, die durch diese Option bestimmt
werden kann. Ist die Option nicht angegeben, so wird als Verzeichnistitel
»\texttt{List of \PName{Mehrzahl des Eintragstyps}}« (siehe Option
- \PName{types}) verwendet, wobei das erste Zeichen der \PName{Mehrzahl des
+ \Option{types}) verwendet, wobei das erste Zeichen der \PName{Mehrzahl des
Eintragstyps} in einen Großbuchstaben gewandelt wird. Es wird auch ein
Makro \Macro{list\PName{Eintragstyp}name} mit diesem Wert definiert, der
jederzeit geändert werden kann. Dieses Makro wird jedoch nur definiert,
@@ -2503,16 +2443,24 @@ möglich. Siehe dazu \autoref{sec:tocbasic.tocstyle},
Es wird nicht nur ein neuer Verzeichnistyp definiert, sondern auch eine
nicht gleitende Umgebungen \Environment{\PName{Eintragstyp}-} (siehe
Option \Option{type}), die ähnlich wie eine Gleitumgebung verwendet werden
- kann, jedoch nicht gleitet und auch nicht die Grenzen der aktuell gültigen
- Umgebung durchbricht.}%
+ kann, jedoch nicht gleitet und auch nicht die Grenzen der Umgebung, in der
+ sie verwendet wird, durchbricht.}%
\entry{\OptionVName{owner}{Besitzer}}{%
Jedes neue Verzeichnis hat bei \Package{tocbasic} einen Besitzer (siehe
\autoref{sec:tocbasic.basics}). Dieser kann hier angegeben werden. Ist
kein Besitzer angegeben, so wird der Besitzer »\PValue{float}« verwendet,
den auch die \KOMAScript-Klassen für das Abbildungs- und das
Tabellenverzeichnis verwenden.}%
+ \entry{\OptionVName{setup}{Liste von Eigenschaften}}{%
+ \ChangedAt{v3.25}{\Package{tocbasic}}%
+ Die \PName{Liste von Eigenschaften} wird via
+ \DescRef{\LabelBase.cmd.setuptoc} gesetzt. Es wird darauf hingewiesen,
+ dass für die Angabe mehrerer durch Komma getrennter Eigenschaften die
+ \PName{Liste von Eigenschaften} in geschweifte Klammern gesetzt werden
+ muss.%
+ }%
\entry{\OptionVName{tocentrystyle}{Eintragsstil}}{%
- \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}%
+ \ChangedAt{v3.20}{\Package{tocbasic}}%
\PName{Eintragsstil} gibt den Stil an, den Einträge in das entsprechende
Verzeichnis haben sollen. Der Name der Eintragsebene wird dabei über
Option \Option{type} bestimmt. Zusätzlich zu den Optionen dieser Tabelle
@@ -2543,16 +2491,140 @@ möglich. Siehe dazu \autoref{sec:tocbasic.tocstyle},
An verschiedenen Stellen wird auch die Mehrzahlform des Eintragstyps
verwendet, beispielsweise um eine Anweisung \Macro{listof\PName{Mehrzahl
des Eintragstyps}} zu definieren. Wird diese Option nicht verwendet,
- so wird als \PName{Mehrzahl des Eintragstyps} einfach
- »\PName{Eintragstyp}s« verwendet.}%
+ so wird als \PName{Mehrzahl des Eintragstyps} der Wert von
+ \Option{type} mit angehängtem »s« verwendet.}%
+ \entry{\OptionVName{unset}{Liste von Eigenschaften}}{%
+ \ChangedAt{v3.25}{\Package{tocbasic}}%
+ Die \PName{Liste von Eigenschaften} wird via
+ \DescRef{\LabelBase.cmd.unsettoc} aufgehoben. Es wird darauf hingewiesen,
+ dass für die Angabe mehrerer durch Komma getrennter Eigenschaften die
+ \PName{Liste von Eigenschaften} in geschweifte Klammern gesetzt werden
+ muss.%
+ }%
\end{desclist}
-Benutzer von \Package{hyperref}\IndexPackage{hyperref} sollten Option
-\Option{listname} übrigens immer angeben. Anderenfalls kommt es in der Regel
-zu einer Fehlermeldung, weil \Package{hyperref} nicht mit dem
-\Macro{MakeUppercase} im Namen des Verzeichnisses zurecht kommt, das benötigt
-wird, um den ersten Buchstaben des Wert von \Option{types} in Großbuchstaben
-zu wandeln.%
+\begin{Example}
+ Das Beispiel aus \autoref{sec:tocbasic.example} kann mit Hilfe der neuen
+ Anweisung deutlich verkürzt werden:
+\begin{lstcode}
+ \DeclareNewTOC[%
+ type=remarkbox,%
+ types=remarkboxes,%
+ float,% Gleitumgebungen sollen definiert werden.
+ floattype=4,%
+ name=Merksatz,%
+ listname={Verzeichnis der Merks\"atze}%
+ ]{lor}
+ \setuptoc{lor}{chapteratlist}
+\end{lstcode}
+ Neben den Umgebungen \Environment{remarkbox} und \Environment{remarkbox*}
+ sind damit auch der Zähler \Counter{remarkbox}, die zur Ausgabe gehörenden
+ Anweisungen \Macro{theremarkbox}, \Macro{remarkboxname} und
+ \Macro{remarkboxformat}, die für das Verzeichnis benötigten
+ \Macro{listremarkboxname} und \Macro{listofremarkboxes} sowie einige intern
+ verwendete Anweisungen mit Bezug auf die Dateiendung \File{lor}
+ definiert. Soll der Gleitumgebungstyp dem Paket überlassen werden, so kann
+ Option \Option{floattype} im Beispiel entfallen. Wird zusätzlich
+ die Option \Option{nonfloat} angegeben, wird außerdem eine nicht gleitende
+ Umgebung \Environment{remarkbox-} definiert, in der ebenfalls
+ \DescRef{maincls.cmd.caption}\IndexCmd{caption} verwendet werden kann.
+
+ Zum besseren Verständnis zeigt \autoref{tab:tocbasic.comparison} eine
+ Gegenüberstellung der Anweisungen und Umgebungen für die neu erstellte
+ Beispielumgebung \Environment{remarkbox} mit den entsprechenden Befehlen und
+ Umgebungen für Abbildungen.%
+ \begin{table}
+ \centering
+ \caption{Gegenüberstellung von Beispielumgebung \Environment{remarkbox}
+ und Umgebung \Environment{figure}}
+ \label{tab:tocbasic.comparison}
+ \begin{tabularx}{\textwidth}{l@{\hskip\tabcolsep}l@{\hskip\tabcolsep}>{\raggedright}p{7em}@{\hskip\tabcolsep}X}
+ \toprule
+ \begin{tabular}[t]{@{}l@{}}
+ Umgebung\\
+ \Environment{remarkbox}
+ \end{tabular}
+ & \begin{tabular}[t]{@{}l@{}}
+ Umgebung\\
+ \Environment{figure}
+ \end{tabular}
+ & Optionen von \Macro{DeclareNewTOC} & Kurzbeschreibung \\[1ex]
+ \midrule
+ \Environment{remarkbox} & \Environment{figure}
+ & \Option{type}, \Option{float}
+ & Gleitumgebung des jeweiligen Typs.\\[1ex]
+ \Environment{remarkbox*} & \Environment{figure*}
+ & \Option{type}, \Option{float}
+ & spaltenübergreifende Gleitumgebung des jeweiligen Typs \\[1ex]
+ \Counter{remarkbox} & \Counter{figure}
+ & \Option{type}, \Option{float}
+ & Zähler, der von \DescRef{maincls.cmd.caption} verwendet wird \\[1ex]
+ \Macro{theremarkbox} & \Macro{thefigure}
+ & \Option{type}, \Option{float}
+ & Anweisung zur Ausgabe des jeweiligen Zählers \\[1ex]
+ \Macro{remarkboxformat} & \DescRef{maincls.cmd.figureformat}
+ & \Option{type}, \Option{float}
+ & Anweisung zur Formatierung des jeweiligen Zählers in der Ausgabe von
+ \DescRef{maincls.cmd.caption}\\[1ex]
+ \Macro{remarkboxname} & \Macro{figurename}
+ & \Option{type}, \Option{float}, \Option{name}
+ & Name, der im Label von \DescRef{maincls.cmd.caption} verwendet
+ wird\\[1ex]
+ \Macro{listofremarkboxes} & \DescRef{maincls.cmd.listoffigures}
+ & \Option{types}, \Option{float}
+ & Anweisung zur Ausgabe des jeweiligen Verzeichnisses \\[1ex]
+ \Macro{listremarkboxname} & \Macro{listfigurename}
+ & \Option{type}, \Option{float}, \Option{listname}
+ & Überschrift des jeweiligen Verzeichnisses \\[1ex]
+ \Macro{fps@remarkbox} & \Macro{fps@figure}
+ & \Option{type}, \Option{float}, \Option{floattype}
+ & nummerischer Gleitumge\-bungstyp zwecks
+ Reihen\-fol\-gen\-erhalts\\[1ex]
+ \File{lor} & \File{lof}
+ &
+ & Dateiendung der Hilfsdatei für das jeweilige Verzeichnis \\
+ \bottomrule
+ \end{tabularx}
+ \end{table}
+
+ Und hier nun eine mögliche Verwendung der Umgebung:
+\begin{lstcode}
+ \begin{remarkbox}
+ \centering
+ Gleiches sollte immer auf gleiche Weise und
+ mit gleichem Aussehen gesetzt werden.
+ \caption{Erster Hauptsatz der Typografie}
+ \label{rem:typo1}
+ \end{remarkbox}
+\end{lstcode}
+ Ein Ausschnitt aus einer Beispielseite mit dieser Umgebung könnte dann so
+ aussehen:
+ \begin{center}\footnotesize
+ \begin{tabular}
+ {|!{\hspace{.1\linewidth}}p{.55\linewidth}!{\hspace{.1\linewidth}}|}
+ \\
+ \centering
+ Gleiches sollte immer auf gleiche Weise und
+ mit gleichem Aussehen gesetzt werden.\\[\abovecaptionskip]
+ {%
+ \usekomafont{caption}\footnotesize
+ \begin{tabularx}{\hsize}[t]{@{}l@{ }X@{}}
+ \usekomafont{captionlabel}{Merksatz 1:} &
+ Erster Hauptsatz der Typografie%\\
+ \end{tabularx}%
+ }%
+ \\
+ \end{tabular}%
+ \end{center}%
+\end{Example}%
+
+Benutzer von
+\Package{hyperref}\IndexPackage{hyperref}\important{\Package{hyperref}}
+sollten Option \Option{listname} übrigens immer angeben. Anderenfalls kommt es
+in der Regel zu einer Fehlermeldung, weil \Package{hyperref} nicht mit dem
+\Macro{MakeUppercase}\IndexCmd{MakeUppercase} im Namen des Verzeichnisses
+zurecht kommt, das benötigt wird, um den ersten Buchstaben des Wertes von
+\Option{types} in Großbuchstaben zu wandeln.%
\EndIndexGroup
%
\EndIndexGroup
@@ -2568,7 +2640,6 @@ zu wandeln.%
%%% End:
% LocalWords: Verzeichnisdatei Klonquelle Absatzabstandes Absatzabstand
-
% LocalWords: Verzeichniseinträge Verzeichniseintrag Eintragsstile
% LocalWords: Inhaltsverzeichniseinträge Standardklassen Nummernbreite
% LocalWords: Standardeigenschaft Eintragsebene Optionenliste expandierbar
@@ -2578,4 +2649,6 @@ zu wandeln.%
% LocalWords: Eintragsnummer Initialisierungscode Aktivierungswerte
% LocalWords: Deaktivierungswert Verzeichnistitel Eintragstyp Eintragstyps
% LocalWords: Verzeichniseintrags Säumniswert Überschriftenanweisung
-% LocalWords: Eintragstext
+% LocalWords: Eintragstext Dateierweiterung Dateierweiterungen Paketautoren
+% LocalWords: Verzeichnisbefehle Verzeichnisdaten Schrifteinstellungen
+% LocalWords: Eintragsebenen Platzierungsoptionen Kapiteleinträge
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex
index 933d3d458ad..9b071f0edd3 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex
@@ -1,6 +1,6 @@
% ======================================================================
% typearea-experts.tex
-% Copyright (c) Markus Kohm, 2008-2017
+% Copyright (c) Markus Kohm, 2008-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% typearea-experts.tex
-% Copyright (c) Markus Kohm, 2008-2017
+% Copyright (c) Markus Kohm, 2008-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,26 +46,26 @@
% ======================================================================
\KOMAProvidesFile{typearea-experts.tex}
- [$Date: 2017-04-13 09:47:38 +0200 (Thu, 13 Apr 2017) $
+ [$Date: 2018-01-31 09:49:41 +0100 (Wed, 31 Jan 2018) $
KOMA-Script guide (chapter: typearea for experts)]
\chapter{Zusätzliche Informationen zum Paket \Package{typearea.sty}}
\labelbase{typearea-experts}
-\BeginIndexGroup
-\BeginIndex{Package}{typearea}
-In diesem Kapitel finden Sie zusätzliche Informationen zum Paket
-\Package{typearea}. \iffree{Einige Teile des Kapitels sind dabei dem
- \KOMAScript-Buch \cite{book:komascript} vorbehalten. Dies sollte kein
- Problem sein, denn der}{Der} normale Anwender, der das Paket einfach nur
-verwenden will, wird diese Informationen normalerweise nicht benötigen. Ein
-Teil der Informationen richtet sich an Anwender, die ausgefallene Aufgaben
-lösen oder eigene Pakete schreiben wollen, die auf \Package{typearea}
-basieren. Ein weiterer Teil der Informationen behandelt Möglichkeiten von
-\Package{typearea}, die aus Gründen der Kompatibilität zu den Standardklassen
-oder früheren Versionen von \KOMAScript{} existieren. Die Teile, die nur aus
-Gründen der Kompatibilität zu früheren Versionen von \KOMAScript{} existieren,
-sind in serifenloser Schrift gesetzt und sollten nicht mehr verwendet werden.
+\BeginIndexGroup \BeginIndex{Package}{typearea} In diesem Kapitel finden Sie
+zusätzliche Informationen zum Paket
+\hyperref[cha:typearea]{\Package{typearea}}. \iffree{Einige Teile des Kapitels
+ sind dabei dem \KOMAScript-Buch \cite{book:komascript} vorbehalten. Dies
+ sollte kein Problem sein, denn der}{Der} normale Anwender, der das Paket
+einfach nur verwenden will, wird diese Informationen eher selten
+benötigen. Ein Teil der Informationen richtet sich an Anwender, die
+ausgefallene Aufgaben lösen oder eigene Pakete schreiben wollen, die auf
+\Package{typearea} basieren. Ein weiterer Teil der Informationen behandelt
+Möglichkeiten von \Package{typearea}, die aus Gründen der Kompatibilität zu
+den Standardklassen oder früheren Versionen von \KOMAScript{} existieren. Die
+Teile, die nur aus Gründen der Kompatibilität zu früheren Versionen von
+\KOMAScript{} existieren, sind in serifenloser Schrift gesetzt und sollten
+nicht mehr verwendet werden.
\section{Experimentelle Möglichkeiten}
@@ -86,19 +86,19 @@ Normalerweise kümmert sich \Package{typearea} wenig darum, ob es in irgend
einer Konstellation zusammen mit dem Paket
\Package{geometry}\IndexPackage{geometry} (siehe \cite{package:geometry})
verwendet wird. Das bedeutet insbesondere, dass \Package{geometry} nach wie
-vor nichts davon mit bekommt, wenn man mit \Package{typearea} beispielsweise
+vor nichts davon mitbekommt, wenn man mit \Package{typearea} beispielsweise
die Papiergröße ändert -- etwas, das \Package{geometry} selbst gar nicht
bietet.
Sobald\ChangedAt{v3.17}{\Package{typearea}} Option \Option{usegeometry}
-gesetzt wird versucht \Package{typearea} alle eigenen Optionen auch in
-Optionen für \Package{geometry} zu übersetzen und innerhalb des Dokuments wird
-sogar \Macro{newgeometry} aufgerufen, wenn neue Parameter aktiviert werden
-(siehe \DescRef{\LabelBase.cmd.activateareas} im nachfolgenden Abschnitt). Da
-\Package{geometry} keine Änderung der Papiergröße oder Papierausrichtung via
-\Macro{newgeometry} bietet, wird diese bei Bedarf über interne Anweisungen und
-Längen von \Package{geometry} umgesetzt. Getestet ist dies für
-\Package{geometry}~5.3 bis 5.6.
+gesetzt wird, versucht \Package{typearea}, alle eigenen Optionen für
+\Package{geometry} in dessen Optionen zu übersetzen. Innerhalb des Dokuments
+wird sogar \Macro{newgeometry} aufgerufen, wenn neue Parameter aktiviert
+werden (siehe \DescRef{\LabelBase.cmd.activateareas} im nachfolgenden
+Abschnitt). Da \Package{geometry} keine Änderung der Papiergröße oder
+Papierausrichtung via \Macro{newgeometry} bietet, wird diese bei Bedarf über
+interne Anweisungen und Längen von \Package{geometry} umgesetzt. Getestet ist
+dies für \Package{geometry}~5.3 bis 5.6.
Die Option bedeutet übrigens nicht, dass bei Verwendung von \Package{geometry}
nach einer Papiergrößen- oder Papierausrichtungsänderung mit
@@ -108,11 +108,21 @@ Papiereinstellung bietet, als für die Bestimmung von Textbereich, Rändern,
Kopf, Fuß etc. benötigt werden -- man spricht von \emph{Überbestimmung} -- und
gleichzeitig bei neuen Aufrufen von \Macro{newgeometry} fehlende Angaben aus
bereits bekannten ableitet -- man spricht von \emph{Werterhalt} --,
-muss man gegebenenfalls durch explizite vollständige Bestimmung neuer Werte
+muss man gegebenenfalls durch vollständige Bestimmung neuer Werte
bei einem eigenen Aufruf von \Macro{newgeometry} alle gewünschten
Einstellungen explizit vornehmen. Nichts desto Trotz kann die Berücksichtigung
von \Package{geometry} durch \Package{typearea} zusätzliche Möglichkeiten
-eröffnen.%
+eröffnen.
+
+{\setlength{\emergencystretch}{1em}%
+Von \Package{typearea} werden mit \Option{usegeometry} für \Package{geometry}
+derzeit die Optionen
+\Option{bindingoffset}, \Option{footskip}, \Option{headheight},
+\Option{headsep}, \Option{includefoot}, \Option{includehead},
+\Option{includemp}, \Option{lmargin}, \Option{marginparsep},
+\Option{marginparwidth}, \Option{textheight}, \Option{textwidth}, \Option{top}
+und in der Dokumentpräambel zusätzlich \Option{paperheight} und
+\Option{paperwidth} gesetzt.\par}%
\EndIndexGroup
@@ -142,8 +152,8 @@ verschoben sein.%
In diesem Abschnitt werden Anweisungen beschrieben, die für den normalen
Anwender kaum oder gar nicht von Interesse sind. Experten bieten diese
-Anweisungen zusätzliche Möglichkeiten. Da die Beschreibungen für Experten
-gedacht sind, sind sie kürzer gefasst.
+Anweisungen zusätzliche Möglichkeiten.\iffree{ Da die Beschreibungen für
+ Experten gedacht sind, sind sie kürzer gefasst.}{}
\begin{Declaration}
\Macro{activateareas}
@@ -183,7 +193,7 @@ Einstellungen wieder zu reaktivieren.
Sie wollen in einem Dokument im Hochformat eine Seite im Querformat
unterbringen. Mit \Macro{storeareas} kein Problem:
\begin{lstcode}
- \documentclass[pagesize]{scrartcl}
+ \documentclass{scrartcl}
\begin{document}
\noindent\rule{\textwidth}{\textheight}
@@ -205,11 +215,11 @@ Einstellungen wieder zu reaktivieren.
\DescRef{maincls.cmd.cleardoubleoddpage}\IndexCmd{cleardoubleoddpage} oder
-- wenn keine \KOMAScript-Klasse zum Einsatz kommt --
\DescRef{maincls.cmd.cleardoublepage}\IndexCmd{cleardoublepage} verwendet
- werden.
+ werden.%
+ \iffree{\par Außerdem wird \Macro{noindent} verwendet, um den normalen
+ Absatzeinzug vor den schwarzen Kästen zu verhindern. Sie würden sonst kein
+ korrektes Bild des Seitenlayouts wiedergeben.}{}%
\end{Example}
-Im Beispiel wird \Macro{noindent} verwendet, um den normalen Absatzeinzug vor
-den schwarzen Kästen zu verhindern. Sie würden sonst kein korrektes Bilde des
-Seitenlayouts wiedergeben.
Bei\textnote{Achtung!} der Verwendung von \Macro{storeareas} ist zu beachten,
dass sowohl \Macro{storeareas} als auch die damit definierte \PName{Anweisung}
@@ -219,7 +229,7 @@ nicht innerhalb einer Gruppe aufgerufen werden sollten. Die Definition der
erneuter Verwendung einer bereits definierten \PName{Anweisung} wird eine
entsprechende Fehlermeldung ausgegeben.
-Oftmals\ChangedAt{v3.18}{\Package{typearea}} ist es auch erwünscht, vor der
+Oftmals\ChangedAt{v3.18}{\Package{typearea}} ist auch erwünscht, vor der
Wiederherstellung der Einstelllungen per \PName{Anweisung} grundsätzlich
bestimmte Aktionen wie beispielsweise ein
\DescRef{maincls.cmd.cleardoubleoddpage} auszuführen. Dies kann man mit Hilfe
@@ -244,7 +254,7 @@ auswirkt.%
Diese Anweisungen dienen der Verwaltung zweier Haken\Index{Haken} (engl.
\emph{hooks}\Index{hook=\emph{hook}}). Die ersten beiden,
\Macro{AfterCalculatingTypearea} und deren Sternform, ermöglichen es dem
-Experten jedes Mal, nachdem \Package{typearea} eine neue Aufteilung in
+Experten jedes Mal, nachdem \Package{typearea} eine neue Auf"|teilung in
Satzspiegel und Ränder berechnet hat, also nach jeder impliziten oder
expliziten Ausführung von \DescRef{typearea.cmd.typearea}, \PName{Anweisungen}
ausführen zu lassen. Entsprechendes leisten
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea.tex
index 2d0e3d5eb15..0ff9dd4573a 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea.tex
@@ -1,6 +1,6 @@
% ======================================================================
% typearea.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% typearea.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -47,11 +47,13 @@
\KOMAProvidesFile{typearea.tex}
- [$Date: 2017-08-08 11:47:52 +0200 (Tue, 08 Aug 2017) $
+ [$Date: 2018-01-31 13:01:01 +0100 (Wed, 31 Jan 2018) $
KOMA-Script guide (chapter: typearea)]
\chapter{Satzspiegelberechnung mit \Package{typearea.sty}}
\labelbase{typearea}
+\BeginIndexGroup%
+\BeginIndex{Package}{typearea}%
Viele \LaTeX-Klassen\iffree{, darunter auch die Standardklassen,}{} bieten dem
Anwender eine weitgehend feste Auf"|teilung von Rändern und Textbereich. Bei
den Standardklassen ist die konkrete Auf"|teilung in engen Grenzen von der
@@ -88,10 +90,10 @@ Anwender erleichtern, eine gute Wahl zu treffen.
Rändern« die Rede.}%
\fi%
, einem Kopfbereich, einem Textkörper und einem Fußbereich. Genauer
- betrachtet kommt noch ein Abstand zwischen Kopfbereich und Textkörper sowie
+ betrachtet, kommt noch ein Abstand zwischen Kopfbereich und Textkörper sowie
zwischen Textkörper und Fußbereich hinzu. Der Textkörper heißt in der
Fachsprache der Typografen und Setzer \emph{Satzspiegel}. Die Auf"|teilung
- dieser Bereiche, sowie ihre Anordnung zueinander und auf dem Papier nennen
+ dieser Bereiche sowie ihre Anordnung zueinander und auf dem Papier nennen
wir \emph{Satzspiegeldefinition} oder
\emph{Satzspiegelkonstruktion}.\Index[indexmain]{Satzspiegel}
@@ -100,8 +102,8 @@ Anwender erleichtern, eine gute Wahl zu treffen.
\iffree{ \cite{DANTE:TK0402:MJK}}{. Einen Überblick über einige Möglichkeiten
und der dabei angenommenen Grundsätze gibt
\autoref{cha:typeareaconstruction}}%
- . Häufig findet man dabei ein Verfahren, das mit verschiedenen Diagonalen
- und Schnittpunkten arbeitet. Das gewünschte Ergebnis dabei ist, dass das
+ . Häufig findet man ein Verfahren, das mit verschiedenen Diagonalen
+ und deren Schnittpunkten arbeitet. Das gewünschte Ergebnis ist, dass das
Seitenverhältnis des Satzspiegels dem Seitenverhältnis \emph{der Seite}
entspricht. Bei einem einseitigen\Index{einseitig} Dokument sollen außerdem
der linke und der rechte Rand gleich breit sein, während der obere zum
@@ -170,26 +172,28 @@ Anwender erleichtern, eine gute Wahl zu treffen.
\Var{Bundsteg}\index{Bundsteg}
\end{align*}
}{%
+ % Umbruchkorrektur: Abstände verändert!
\begin{prepareformargin}
- \vskip-\baselineskip
+ \vskip -.5\baselineskip plus .25\baselineskip
\begin{align*}
\Var{Satzspiegelhöhe}\Index{Satzspiegel} : \Var{Satzspiegelbreite} &=
\Var{Seitenhöhe}\Index{Seite} : \Var{Seitenbreite} \\
\Var{oberer~Rand}\Index{Rand} : \Var{unterer~Rand} &=
- \text{1} : \text{2} \\
+ \text{1} : \text{2} \\
\Var{linker~Rand} : \Var{rechter~Rand} &= \text{1} : \text{1} \\
- \Var{innerer~Randanteil} : \Var{äußerer~Rand} &= \text{1} : \text{2}\\
+ \Var{innerer~Randanteil} : \Var{äußerer~Rand} &=
+ \text{1} : \text{2}\\
\Var{Seitenbreite} &=
- \Var{Papierbreite}\Index{Papier} -
- \Var{Bindekorrektur}\Index{Bindekorrektur} \\
+ \Var{Papierbreite}\Index{Papier} -
+ \Var{Bindekorrektur}\Index{Bindekorrektur} \\
\Var{oberer~Rand} + \Var{unterer~Rand} &=
- \Var{Seitenhöhe} - \Var{Satzspiegelhöhe} \\
+ \Var{Seitenhöhe} - \Var{Satzspiegelhöhe} \\
%
\Var{linker~Rand} + \Var{rechter Rand} &=
- \Var{Seitenbreite} - \Var{Satzspiegelbreite} \\
+ \Var{Seitenbreite} - \Var{Satzspiegelbreite} \\
%
\Var{innerer Randanteil} + \Var{äußerer Rand} &=
- \Var{Seitenbreite} - \Var{Satzspiegelbreite} \\
+ \Var{Seitenbreite} - \Var{Satzspiegelbreite} \\
%
% \end{align*}
% \end{prepareformargin}\pagebreak
@@ -199,6 +203,7 @@ Anwender erleichtern, eine gute Wahl zu treffen.
\Var{Bundsteg}\index{Bundsteg}
\end{align*}
\end{prepareformargin}
+ \vskip .5\baselineskip minus .25\baselineskip
}%
\Index[indexmain]{Rand}%
Dabei gibt es \Var{linker~Rand} und \Var{rechter~Rand} nur im einseitigen
@@ -213,11 +218,16 @@ Anwender erleichtern, eine gute Wahl zu treffen.
Die Frage nach der Breite des Satzspiegels wird in der Literatur
ebenfalls diskutiert. Die optimale Satzspiegelbreite ist von
verschiedenen Faktoren abhängig:
- \begin{itemize}
- \item Größe, Laufweite und Art der verwendeten Schrift
- \item Verwendeter Durchschuss
- \item Länge der Worte
- \item Verfügbarer Platz
+ \iffree{\begin{itemize}}{\begin{itemize}[% Umbuchkorrektur
+ topsep=.5\baselineskip plus .25\baselineskip minus .33\baselineskip,
+ partopsep=.5\baselineskip plus .25\baselineskip minus .33\baselineskip,
+ itemsep=.33\baselineskip plus .25\baselineskip minus .25\baselineskip,
+ parsep=0pt
+ ]}
+ \item Größe, Laufweite und Art der verwendeten Schrift,
+ \item verwendeter Durchschuss,
+ \item Länge der Worte,
+ \item verfügbarer Platz.
\end{itemize}
Der Einfluss der Schrift wird deutlich, wenn man sich bewusst macht,
wozu Serifen dienen. Serifen\Index[indexmain]{Serifen} sind kleine
@@ -249,10 +259,10 @@ Anwender erleichtern, eine gute Wahl zu treffen.
Zeilenlängen\Index[indexmain]{Zeilenlaenge=Zeilenlänge} findet man in der
Literatur je nach Autor unterschiedliche Angaben. Teilweise ist dies auch in
der Muttersprache des Autors begründet. Das Auge springt nämlich
- üblicherweise von Wort zu Wort, wobei kurze Worte diese Aufgabe
+ üblicherweise von Wort zu Wort, wobei kurze Wörter diese Aufgabe
erleichtern. Über alle Sprachen und Schriftarten hinweg kann man sagen, dass
eine Zeilenlänge von 60 bis 70 Zeichen, einschließlich Leer- und
- Satzzeichen, einen brauchbaren Kompromiss darstellen. Ein gut gewählter
+ Satzzeichen, einen brauchbaren Kompromiss darstellt. Ein gut gewählter
Durchschuss wird dabei vorausgesetzt. Bei den Voreinstellungen von \LaTeX{}
braucht man sich über Letzteres normalerweise keine Sorgen zu
machen. Größere Zeilenlängen darf man nur Gewohnheitslesern zumuten, die
@@ -292,14 +302,14 @@ Anwender erleichtern, eine gute Wahl zu treffen.
\else
Soweit die Grundlagen.
\fi
-\iftrue% Umbruchkorrektur
+\iffalse% Umbruchkorrektur
Es folgen die beiden von \KOMAScript{} angebotenen Konstruktionen.
\else
-\iftrue% Umbruchkorrektur
+\iffalse% Umbruchkorrektur
Wir können also mit den konkreten Konstruktionen beginnen.
\else
In den folgenden beiden Abschnitten werden die von {\KOMAScript} angebotenen
- Konstruktionen vorgestellt.
+ Konstruktionen im Detail vorgestellt.
\fi
\fi
\end{Explain}
@@ -448,8 +458,8 @@ Anwender erleichtern, eine gute Wahl zu treffen.
Im \Package{typearea}-Paket wird diese Konstruktion dahingehend abgewandelt,
dass durch Auswahl eines ausgezeichneten -- normalerweise unsinnigen --
- \Var{DIV}-Wertes oder eine spezielle Paket-Option derjenige \Var{DIV}-Wert
- ermittelt wird, bei dem der resultierende Satzspiegel dem
+ \Var{DIV}-Wertes oder einer speziellen, symbolischen Angabe derjenige
+ \Var{DIV}-Wert ermittelt wird, bei dem der resultierende Satzspiegel dem
spätmittelalterlichen Buchseitenkanon am nächsten kommt. Es wird also
wiederum auf die Satzspiegelkonstruktion durch Teilung zurückgegriffen.
%
@@ -475,10 +485,11 @@ nehmen. Die wichtigste Möglichkeit ist die Angabe von Optionen. Wie
im vorherigen Abschnitt erwähnt, können die Optionen dabei auf
unterschiedlichen Wegen gesetzt werden.
-In diesem Abschnitt wird die Klasse \Class{protokol} verwendet werden. Es
-handelt sich dabei nicht um eine \KOMAScript-Klasse, sondern um eine
-hypothetische Klasse. Diese\iffree{ Anleitung}{s Buch} geht von dem Idealfall
-aus, dass für jede Aufgabe eine dafür passende Klasse zur Verfügung steht.
+In\textnote{Hinweis!} diesem Abschnitt wird die Klasse \Class{protokol}
+verwendet werden. Es handelt sich dabei nicht um eine \KOMAScript-Klasse,
+sondern um eine hypothetische Klasse. Diese\iffree{ Anleitung}{s Buch} geht
+von dem Idealfall aus, dass für jede Aufgabe eine dafür passende Klasse zur
+Verfügung steht.
\begin{Declaration}
@@ -486,7 +497,8 @@ aus, dass für jede Aufgabe eine dafür passende Klasse zur Verfügung steht.
\end{Declaration}%
Mit Hilfe der Option
\OptionVName{BCOR}{Korrektur}\ChangedAt{v3.00}{\Package{typearea}} geben Sie
-den absoluten Wert der Bindekorrektur\Index{Bindekorrektur} an, also die
+den absoluten Wert der
+Bindekorrektur\Index{Bindekorrektur}\textnote{Bindekorrektur} an, also die
Breite des Bereichs, der durch die Bindung von der Papierbreite verloren
geht. Dieser Wert wird in der Satzspiegelkonstruktion automatisch
berücksichtigt und bei der Ausgabe wieder dem inneren beziehungsweise linken
@@ -504,12 +516,12 @@ verstandene Maßeinheit angeben.
\documentclass[a4paper]{report}
\usepackage[BCOR=8.25mm]{typearea}
\end{lstcode}
- oder
+ mit \OptionValue{BCOR}{8.25mm} als Option für \Package{typearea} oder
\begin{lstcode}
\documentclass[a4paper,BCOR=8.25mm]{report}
\usepackage{typearea}
\end{lstcode}
- bei Angabe von \Option{BCOR} als globale Option.
+ zur Angabe von \OptionValue{BCOR}{8.25mm} als globale Option.
Bei Verwendung einer \KOMAScript-Klasse kann das explizite Laden von
\Package{typearea} entfallen:
@@ -578,7 +590,7 @@ Schriftgröße abhängigen Nebenbedingungen nicht berücksichtigt.
% \caption
[{Satzspiegelma"se in Abh"angigkeit von \Var{DIV} bei A4}]
{\label{tab:typearea.typearea}Satzspiegelma"se in Abh"angigkeit von \Var{DIV}
- bei A4 ohne Berücksichtigung von \Length{topskip}}
+ bei A4 ohne Berücksichtigung von \Length{topskip} oder \Var{BCOR}}
[l]
\begin{tabular}[t]{ccccc}
\toprule
@@ -615,7 +627,7 @@ Schriftgröße abhängigen Nebenbedingungen nicht berücksichtigt.
Höhe relativ breit. Deshalb ist Ihnen die Voreinstellung für den
\Var{DIV}-Wert in \Package{typearea} zu gering. Statt einem Wert von 12 sind
Sie nach gründlichem Studium dieses Kapitels einschließlich der
- weiterführenden Abschnitte überzeugt, dass ein Wert 15 angebracht ist. Das
+ weiterführenden Abschnitte überzeugt, dass der Wert 15 angebracht ist. Das
Protokoll wird nicht gebunden, sondern gelocht und in einen Ordner
abgeheftet. Eine Bindekorrektur ist deshalb nicht notwendig. Sie schreiben
also:
@@ -662,7 +674,7 @@ muss. Weder sollte das Paket \Package{typearea} bei Verwendung einer
noch die Option dabei als optionales Argument angegeben
werden. Wird\textnote{automatische Neuberechnung} die Option per
\DescRef{\LabelBase.cmd.KOMAoptions} oder \DescRef{\LabelBase.cmd.KOMAoption}
-nach dem Laden des Pakets geändert, so werden Satzspiegel und Rändern
+nach dem Laden des Pakets geändert, so werden Satzspiegel und Ränder
automatisch neu berechnet.
\begin{Declaration}
@@ -679,13 +691,13 @@ sehr rasch zu unangenehm hoher Zeichenzahl je Zeile führen. Siehe hierzu die
Überlegungen in \autoref{sec:typearea.basics}. Wird ein anderes Papierformat
gewählt, so berechnet \Package{typearea} selbst einen guten \Var{DIV}-Wert.
Natürlich können Sie diese Berechnung auch für A4 wählen. Hierzu verwenden Sie
-\OptionValue{DIV}{calc}\important{\OptionValue{DIV}{calc}} an Stelle von
-\OptionVName{\DescRef{\LabelBase.option.DIV}}{Faktor}. Selbstverständlich können Sie diese Option auch
-explizit bei allen anderen Papierformaten angeben. Wenn Sie die automatische
-Berechnung wünschen, ist diese Angabe sogar sinnvoll, da die Möglichkeit
-besteht, in einer Konfigurationsdatei andere Voreinstellungen zu setzen (siehe
-\autoref{sec:typearea-experts.cfg}). Eine explizit angegebene Option
-\OptionValue{DIV}{calc} überschreibt diese Vorkonfiguration aber.
+\OptionValue{DIV}{calc}\important{\OptionValue{DIV}{calc}} anstelle von
+\OptionVNameRef{\LabelBase}{DIV}{Faktor}. Selbstverständlich können Sie
+diese Option auch explizit bei allen anderen Papierformaten angeben. Wenn Sie
+die automatische Berechnung wünschen, ist diese Angabe sogar sinnvoll, da die
+Möglichkeit besteht, in einer Konfigurationsdatei andere Voreinstellungen zu
+setzen (siehe \autoref{sec:typearea-experts.cfg}). Eine explizit angegebene
+Option \OptionValue{DIV}{calc} überschreibt diese Vorkonfiguration aber.
\begin{table}
% \centering
@@ -694,8 +706,7 @@ besteht, in einer Konfigurationsdatei andere Voreinstellungen zu setzen (siehe
\begin{captionbeside}
%\caption
[{\PName{DIV}-Voreinstellungen f"ur A4}]
- {\label{tab:typearea.div}\PName{DIV}-Voreinstellungen f"ur A4 bei Verzicht
- auf \Var{BCOR}}
+ {\label{tab:typearea.div}\PName{DIV}-Voreinstellungen f"ur A4}
[l]
\begin{tabular}[t]{lccc}
\toprule
@@ -708,26 +719,26 @@ besteht, in einer Konfigurationsdatei andere Voreinstellungen zu setzen (siehe
Die in \autoref{sec:typearea.circleConstruction} erwähnte klassische
Konstruktion, der mittelalterliche Buchseitenkanon, ist ebenfalls auswählbar.
-Verwenden Sie in diesem Fall an Stelle von \OptionVName{\DescRef{\LabelBase.option.DIV}}{Faktor} oder
-\OptionValue{DIV}{calc} einfach
+Verwenden Sie in diesem Fall anstelle von
+\OptionVNameRef{\LabelBase}{DIV}{Faktor} oder \OptionValue{DIV}{calc} einfach
\OptionValue{DIV}{classic}\important{\OptionValue{DIV}{classic}}. Es wird dann
ein \Var{DIV}-Wert ermittelt, der eine möglichst gute Näherung an den
mittelalterlichen Buchseitenkanon darstellt.
\begin{Example}
- In dem bei der Option \OptionVName{\DescRef{\LabelBase.option.DIV}}{Faktor} aufgeführten
- Beispiel mit der Schriftart Bookman gab es ja genau das Problem,
- dass man einen zur Schriftart besser passenden \Var{DIV}-Wert haben
- wollte. Man könnte also in Abwandlung des ersten Beispiels auch
- einfach die Ermittlung dieses Wertes \Package{typearea} überlassen:
+ In dem bei der Option \OptionVNameRef{\LabelBase}{DIV}{Faktor} aufgeführten
+ Beispiel mit der Schriftart Bookman gab es ja genau das Problem, dass man
+ einen zur Schriftart besser passenden \Var{DIV}-Wert haben wollte. Man
+ könnte also in Abwandlung des ersten Beispiels auch einfach die Ermittlung
+ dieses Wertes \Package{typearea} überlassen:
\begin{lstcode}
\documentclass[a4paper,twoside]{protokol}
\usepackage{bookman}
\usepackage[DIV=calc]{typearea}
\end{lstcode}
\end{Example}
-
-\iffree{Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Option bei
+\iffree{\par%
+ Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Option bei
Verwendung einer der \KOMAScript-Klassen %
\iftrue wie im Beispiel \fi%
als Klassenoption oder per \DescRef{\LabelBase.cmd.KOMAoptions}
@@ -738,7 +749,10 @@ mittelalterlichen Buchseitenkanon darstellt.
optionales Argument angegeben werden. Wird die Option per
\DescRef{\LabelBase.cmd.KOMAoptions} oder
\DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden des Pakets geändert, so
- werden Satzspiegel und Rändern automatisch neu berechnet.}{}%
+ werden Satzspiegel und Ränder automatisch neu berechnet.%
+}{%
+ \vskip-\dp\strutbox% Wegen Code im Beispiel am Ende
+}%
%
\EndIndexGroup
@@ -794,14 +808,14 @@ Berechnung verwendet wird.
Gehen wir wieder davon aus, dass für die Schriftart Bookman ein Satzspiegel
mit guter Zeilenlänge berechnet werden soll. Gleichzeitig wird eine
\KOMAScript-Klasse verwendet. Dies ist mit dem symbolischen Wert
- \PValue{last} und der Anweisung \DescRef{\LabelBase.cmd.KOMAoptions} sehr einfach möglich:
+ \PValue{last} und der Anweisung \DescRef{\LabelBase.cmd.KOMAoptions} sehr
+ einfach möglich:
\begin{lstcode}
\documentclass[BCOR=12mm,DIV=calc,twoside]
{scrartcl}
\usepackage{bookman}
\KOMAoptions{DIV=last}
\end{lstcode}
- \iffree{}{\clearpage}% Umbruchoptimierung
Wird später entschieden, dass ein anderer \Var{DIV}-Wert
verwendet werden soll, so muss nur die Einstellung im optionalen Argument
von \DescRef{\LabelBase.cmd.documentclass} geändert werden.
@@ -814,27 +828,34 @@ darauf hingewiesen, dass auch die Verwendung des Pakets
andere Schrift lädt.
\begin{table}
- \caption[{Symbolische Werte für Option \Option{DIV} und das
- \PName{DIV}-Argument von \DescRef{typearea.cmd.typearea}}]{Mögliche symbolische Werte
- für die Option \Option{DIV} oder das \PName{DIV}-Argument der Anweisung
- \DescRef{typearea.cmd.typearea}\OParameter{BCOR}\Parameter{DIV}}
+ \caption[{%
+ Symbolische Werte für Option \DescRef{typearea.option.DIV} und das
+ \PName{DIV}-Argument von \DescRef{typearea.cmd.typearea}%
+ }]{%
+ Mögliche symbolische Werte für die Option \DescRef{typearea.option.DIV}
+ oder das \PName{DIV}-Argument der Anweisung
+ \DescRef{typearea.cmd.typearea}\OParameter{BCOR}\Parameter{DIV}%
+ }
\label{tab:symbolicDIV}
\begin{desctabular}
- \pventry{areaset}{Satzspiegel neu anordnen.\IndexOption{DIV~=\PValue{areaset}}}%
+ \pventry{areaset}{Satzspiegel neu
+ anordnen.\IndexOption{DIV~=\textKValue{areaset}}}%
\pventry{calc}{Satzspiegelberechnung einschließlich Ermittlung eines guten
- \Var{DIV}-Wertes erneut durchführen.\IndexOption{DIV~=\PValue{calc}}}%
+ \Var{DIV}-Wertes erneut
+ durchführen.\IndexOption{DIV~=\textKValue{calc}}}%
\pventry{classic}{Satzspiegelberechnung nach dem mittelalterlichen
Buchseitenkanon (Kreisberechnung) erneut
- durchführen.\IndexOption{DIV~=\PValue{classic}}}%
+ durchführen.\IndexOption{DIV~=\textKValue{classic}}}%
\pventry{current}{Satzspiegelberechnung mit dem aktuell gültigen
- \Var{DIV}-Wert erneut durchführen.\IndexOption{DIV~=\PValue{current}}}%
+ \Var{DIV}-Wert erneut
+ durchführen.\IndexOption{DIV~=\textKValue{current}}}%
\pventry{default}{Satzspiegelberechnung mit dem Standardwert für das
aktuelle Seitenformat und die aktuelle Schriftgröße erneut durchführen.
Falls kein Standardwert existiert, \PValue{calc}
- anwenden.\IndexOption{DIV~=\PValue{default}}}%
+ anwenden.\IndexOption{DIV~=\textKValue{default}}}%
\pventry{last}{Satzspiegelberechnung mit demselben \PName{DIV}-Argument,
das beim letzten Aufruf angegeben wurde, erneut
- durchführen.\IndexOption{DIV~=\PValue{last}}}%
+ durchführen.\IndexOption{DIV~=\textKValue{last}}}%
\end{desctabular}
\end{table}
@@ -863,14 +884,15 @@ normalen der Satzspiegel für diesen Zeilenabstand neu berechnet werden.
Berechnung eines neuen Satzspiegels ausführt, ist es nicht zwingend
notwendig, nach \Macro{linespread} den gewählten Durchschuss mit
\Macro{selectfont} zu aktivieren, damit dieser %
-\iffalse % Umbruchkorrektur
+\iftrue % Umbruchkorrektur
auch tatsächlich
\fi %
für die Neuberechnung verwendet wird.
Das gleiche Beispiel sähe unter Verwendung des
- \Package{setspace}-Pakets\IndexPackage{setspace} (siehe
- \cite{package:setspace}) wie folgt aus:
+ \Package{setspace}-Pakets\IndexPackage{setspace}%
+ \important{\Package{setspace}}
+ (siehe \cite{package:setspace}) wie folgt aus:
\begin{lstcode}
\documentclass[10pt,twoside,BCOR=12mm,DIV=calc]
{scrreprt}
@@ -884,7 +906,7 @@ Wie\textnote{Tipp!} man an dem Beispiel sieht, spart man sich mit dem
allerdings nur für die Standardschriftgrößen 10\Unit{pt}, 11\Unit{pt} und
12\Unit{pt}. Für alle anderen Schriftgrößen verwendet das Paket
%
-\iffalse % Umbruchkorrektur
+\iftrue % Umbruchkorrektur
einen näherungsweise passenden Dehnungswert.
%
\else %
@@ -923,7 +945,9 @@ Auswirkungen auf Kopf und Fuß der Seite haben können. Dies kann sich
beispielsweise bei Verwendung von \Package{scrlayer-scrpage} auswirken und man
muss dann selbst entscheiden, ob man dort lieber den normalen Durchschuss oder
den veränderten haben will. Siehe dazu auch Option
-\DescRef{scrlayer.option.singlespacing} in \autoref{cha:scrlayer} auf
+\DescRef{scrlayer.option.singlespacing} in \autoref{cha:scrlayer}%
+\important{\hyperref[cha:scrlayer]{\Package{scrlayer}}}%
+\IndexPackage{scrlayer}\IndexOption{singlespacing} auf
\DescPageRef{scrlayer.option.singlespacing}.
Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Optionen auch zur
@@ -944,35 +968,40 @@ von Satzspiegel und Rändern auslösen.%
Wird die Option \DescRef{\LabelBase.option.DIV} oder die Option
\DescRef{\LabelBase.option.BCOR} nach dem Laden des Pakets
\Package{typearea} gesetzt, so wird intern die Anweisung \Macro{typearea}
- aufgerufen. Dabei wird beim Setzen der Option \DescRef{\LabelBase.option.DIV} für \PName{BCOR}
- intern der symbolische Wert \PValue{current} verwendet, der aus Gründen der
- Vollständigkeit auch in \autoref{tab:symbolicBCOR} zu finden ist. Beim
- Setzen der Option \DescRef{\LabelBase.option.BCOR} wird für \PName{DIV}
- hingegen der symbolische Wert \PValue{last} verwendet. Wollen Sie, dass
- Satzspiegel und Rändern stattdessen mit dem symbolischen Wert
- \PValue{current} für \PName{DIV} neu berechnet werden, so können Sie direkt
+ aufgerufen. Dabei wird beim Setzen der Option
+ \DescRef{\LabelBase.option.DIV} für \PName{BCOR} intern der symbolische Wert
+ \PValue{current} verwendet, der aus Gründen der Vollständigkeit auch in
+ \autoref{tab:symbolicBCOR} zu finden ist. Beim Setzen der Option
+ \DescRef{\LabelBase.option.BCOR} wird für \PName{DIV} hingegen der
+ symbolische Wert \PValue{last} verwendet. Wollen Sie, dass Satzspiegel und
+ Ränder stattdessen mit dem symbolischen Wert \PValue{current} für
+ \PName{DIV} neu berechnet werden, so können Sie direkt
\Macro{typearea}\POParameter{current}\PParameter{current} verwenden.
\end{Explain}
\begin{table}
- \caption[{Symbolische \PName{BCOR}-Argumente für
- \Macro{typearea}}]{Mögliche symbolische \PName{BCOR}-Argumente für
- \Macro{typearea}\OParameter{BCOR}\Parameter{DIV}}
+ \caption[{%
+ Symbolische \PName{BCOR}-Argumente für \DescRef{typearea.cmd.typearea}%
+ }]{%
+ Mögliche symbolische \PName{BCOR}-Argumente für
+ \Macro{typearea}\OParameter{BCOR}\Parameter{DIV}%
+ }
\label{tab:symbolicBCOR}
\begin{desctabular}
\pventry{current}{Satzspiegelberechnung mit dem aktuell gültigen
- \Var{BCOR}-Wert erneut durchführen.\IndexOption{BCOR~=\PValue{current}}}
+ \Var{BCOR}-Wert erneut
+ durchführen.\IndexOption{BCOR~=\textKValue{current}}}
\end{desctabular}
\end{table}
Sollen die Werte sowohl von \PName{BCOR} als auch \PName{DIV} geändert werden,
so ist die Verwendung von \Macro{typearea} zu empfehlen, da hierbei die Ränder
-und der Satzspiegel nur einmal neu berechnet werden. Hingegen werden bei
+und der Satzspiegel nur einmal neu berechnet werden. Bei
\DescRef{\LabelBase.cmd.KOMAoptions}%
-\PParameter{\OptionVName{\DescRef{\LabelBase.option.DIV}}{DIV},%
- \OptionVName{\DescRef{\LabelBase.option.BCOR}}{BCOR}} Ränder und Satzspiegel
-zunächst bei der Änderung für \PName{DIV} und dann zusätzlich bei der Änderung
-für \PName{BCOR} neu berechnet.
+\PParameter{\OptionVNameRef{\LabelBase}{DIV}{Faktor},%
+ \OptionVNameRef{\LabelBase}{BCOR}{Korrektur}} werden hingegen Ränder und
+Satzspiegel zunächst in Folge von Option \DescRef{\LabelBase.option.DIV} und
+dann zusätzlich durch Option \DescRef{\LabelBase.option.BCOR} neu berechnet.
\begin{Explain}
Der Befehl \Macro{typearea} ist derzeit so definiert, dass es auch möglich
@@ -986,9 +1015,11 @@ für \PName{BCOR} neu berechnet.
Seitenumbruch.
\end{Explain}
-Da\important{\Macro{recalctypearea}}
-\DescRef{\LabelBase.cmd.KOMAoption}\PParameter{DIV}\PParameter{last} oder
-\DescRef{\LabelBase.cmd.KOMAoptions}\PParameter{DIV=last} beziehungsweise
+Da\important{\Macro{recalctypearea}} \DescRef{\LabelBase.cmd.KOMAoption}%
+\PParameter{\hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}}}%
+\PParameter{\hyperref[desc:\LabelBase.option.DIV.last]{last}} oder
+\DescRef{\LabelBase.cmd.KOMAoptions}%
+\PParameter{\OptionValueRef{\LabelBase}{DIV}{last}} beziehungsweise
\Macro{typearea}\POParameter{current}\PParameter{last} für die Neuberechnung
des Satzspiegels und der Ränder recht häufig benötigt werden, gibt es dafür
die abkürzende Anweisung
@@ -1061,23 +1092,24 @@ Wert \PValue{semi}\ChangedAt{v3.00}{\Package{typearea}}%
einseitigen, also nicht alternierenden
Marginalien. Eine\ChangedAt{v3.12}{\Package{typearea}} eventuelle
Bindekorrektur (siehe Option \DescRef{\LabelBase.option.BCOR},
-\DescPageRef{typearea.option.BCOR}) wird jedoch ab \KOMAScript~Version
-3.12 wie beim doppelseitigen Satz auf Seiten mit ungerader Nummer dem linken
-Rand und auf Seiten mit gerader Nummer dem rechten Rand zugeschlagen. Wird auf
-Kompatibilität zu einer Version früheren Version zurückgeschaltet (siehe
-\autoref{sec:typearea.compatibilityOptions},
+\DescPageRef{typearea.option.BCOR}) wird jedoch ab \KOMAScript~Version 3.12
+wie beim doppelseitigen Satz auf Seiten mit ungerader Nummer dem linken Rand
+und auf Seiten mit gerader Nummer dem rechten Rand zugeschlagen. Wird auf
+Kompatibilität zu einer früheren
+Version\important{\OptionValueRef{\LabelBase}{version}{3.12}} zurückgeschaltet
+(siehe \autoref{sec:typearea.compatibilityOptions},
\autopageref{sec:typearea.compatibilityOptions}), so ist die Bindekorrektur
jedoch auch bei \OptionValue{twoside}{semi} immer Teil des linken Randes.
Die Option kann %
-\iffalse % Umbruchkorrektur
+\iftrue % Umbruchkorrektur
wahlweise \fi %
als Klassenoption bei \DescRef{\LabelBase.cmd.documentclass}, als Paketoption
bei \DescRef{\LabelBase.cmd.usepackage} oder auch nach dem Laden von
\Package{typearea} per \DescRef{\LabelBase.cmd.KOMAoptions} oder
\DescRef{\LabelBase.cmd.KOMAoption} gesetzt werden. Eine Verwendung dieser
Option nach dem Laden von \Package{typearea} führt\textnote{automatische
- Neuberechnung} automatisch zur Neuberechnung des Satzspiegels mittels
+ Neuberechnung} automatisch zur Neuberechnung des Satzspiegels mit
\DescRef{\LabelBase.cmd.recalctypearea} (siehe
\DescPageRef{typearea.cmd.recalctypearea}). War vor der Option
doppelseitiger Satz aktiv, wird noch vor der Neuberechnung auf die nächste
@@ -1090,11 +1122,11 @@ ungerade Seite umbrochen.%
\OptionVName{twocolumn}{Ein-Aus-Wert}
\end{Declaration}%
Für die Berechnung eines guten Satzspiegels mit Hilfe von
-\OptionValueRef{\LabelBase}{DIV}{calc} ist es erforderlich zu wissen, ob das Dokument ein-
-oder zweispaltig gesetzt wird. Da die Betrachtungen zur Zeilenlänge aus
-\autoref{sec:typearea.basics} dann für jede einzelne Spalte gelten, darf der
-Satzspiegel in doppelspaltigen Dokumenten bis zu doppelt so breit sein wie in
-einspaltigen Dokumenten.
+\OptionValueRef{\LabelBase}{DIV}{calc} ist es erforderlich zu wissen, ob das
+Dokument ein- oder zweispaltig gesetzt wird. Da die Betrachtungen zur
+Zeilenlänge aus \autoref{sec:typearea.basics} dann für jede einzelne Spalte
+gelten, darf der Satzspiegel in doppelspaltigen Dokumenten bis zu doppelt so
+breit sein wie in einspaltigen Dokumenten.
Um diese Unterscheidung vornehmen zu können, muss \Package{typearea} mit
Option \Option{twocolumn} mitgeteilt werden, ob das Dokument doppelspaltig
@@ -1103,7 +1135,7 @@ einfache Schalter aus \autoref{tab:truefalseswitch} verwendet werden. Wird die
Option ohne Wert-Angabe verwendet, so wird der Wert
\PValue{true}\important{\OptionValue{twocolumn}{true}} angenommen, also
doppelspaltiger Satz verwendet. Ein
-Deaktivieren der Option führt wieder zum voreingestellten,
+Deaktivieren der Option führt wieder zum voreingestellten
einspaltigen Satz.
Die Option kann als Klassenoption bei \DescRef{\LabelBase.cmd.documentclass},
@@ -1157,7 +1189,7 @@ Option nach dem Laden von \Package{typearea} führt\textnote{automatische
Ermangelung erreichbarer Großeltern kann man sich auch damit behelfen, dass
man die eigenen Augen auf Fernsicht stellt, die Seite aber nur mit
ausgestreckten Armen hält. Brillenträger sind hier deutlich im Vorteil. Hat
- man eine Fußzeile, die neben der Paginierung weitere, weitschweifige Angaben
+ man eine Fußzeile, die neben der Paginierung weitere weitschweifige Angaben
enthält, beispielsweise einen Copyright-Hinweis, so wirkt die Fußzeile eher
wie ein etwas abgesetzter Teil des Textkörpers. Bei der Berechnung des
Satzspiegels sollte das berücksichtigt werden.
@@ -1177,7 +1209,7 @@ Option nach dem Laden von \Package{typearea} führt\textnote{automatische
erfolgt. Dadurch erhält man einen links und rechts abgeschlossenen Bereich,
der kaum noch als leerer Rand wirkt. Schwieriger ist es bei Paginierung im
Fuß und Überschriften, deren Länge sehr stark schwankt. Hier kann der Kopf
- der einen Seite wie Textkörper wirken, der Kopf der anderen Seite jedoch
+ der einen Seite wie Textkörper wirken, der Kopf der anderen Seite aber
eher wie Rand. Keinesfalls sollte man die Seiten jedoch unterschiedlich
behandeln. Das würde zu vertikal springenden Köpfen führen und ist nicht
einmal für ein Daumenkino geeignet. Ich rate in diesem Fall dazu, den Kopf
@@ -1215,13 +1247,16 @@ obige Erläuterungen. Voreingestellt sind normalerweise
Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Optionen bei
Verwendung einer der \KOMAScript-Klassen als Klassenoptionen oder per
-\DescRef{\LabelBase.cmd.KOMAoptions} beziehungsweise \DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der
-Klasse übergeben werden müssen. Eine Änderung dieser Optionen nach dem Laden
-von \Package{typearea} führt dabei nicht\textnote{keine automatische
- Neuberechnung} zu einer automatischen Neuberechnung des
-Satzspiegels. Vielmehr wirkt sich die Änderung erst bei der nächsten
-Neuberechnung des Satzspiegels aus. Zur Neuberechnung des Satzspiegels siehe
-Option \DescRef{\LabelBase.option.DIV} mit den Werten \PValue{last} oder \PValue{current} (siehe
+\DescRef{\LabelBase.cmd.KOMAoptions} beziehungsweise
+\DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der Klasse übergeben werden
+müssen. Eine Änderung dieser Optionen nach dem Laden von \Package{typearea}
+führt dabei nicht\textnote{keine automatische Neuberechnung} zu einer
+automatischen Neuberechnung des Satzspiegels. Vielmehr wirkt sich die Änderung
+erst bei der nächsten Neuberechnung des Satzspiegels aus. Zur Neuberechnung
+des Satzspiegels siehe Option
+\hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}} mit den Werten
+\hyperref[desc:\LabelBase.option.DIV.last]{\PValue{last}} oder
+\hyperref[desc:\LabelBase.option.DIV.current]{\PValue{current}} (siehe
\DescPageRef{typearea.option.DIV.last}) oder die Anweisung
\DescRef{\LabelBase.cmd.recalctypearea} (siehe
\DescPageRef{typearea.cmd.recalctypearea}).%
@@ -1304,13 +1339,16 @@ bleiben.
Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Option bei
Verwendung einer der \KOMAScript-Klassen als Klassenoption oder per
-\DescRef{\LabelBase.cmd.KOMAoptions} beziehungsweise oder \DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der
-Klasse übergeben werden muss. Eine Änderung dieser Option nach dem Laden von
-\Package{typearea} führt nicht\textnote{keine automatische Neuberechnung} zu
-einer automatischen Neuberechnung des Satzspiegels. Vielmehr wirkt sich die
-Änderung erst bei der nächsten Neuberechnung des Satzspiegels aus. Zur
-Neuberechnung des Satzspiegels siehe Option \DescRef{\LabelBase.option.DIV} mit den Werten
-\PValue{last} oder \PValue{current} (siehe
+\DescRef{\LabelBase.cmd.KOMAoptions} beziehungsweise oder
+\DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der Klasse übergeben werden
+muss. Eine Änderung dieser Option nach dem Laden von \Package{typearea} führt
+nicht\textnote{keine automatische Neuberechnung} zu einer automatischen
+Neuberechnung des Satzspiegels. Vielmehr wirkt sich die Änderung erst bei der
+nächsten Neuberechnung des Satzspiegels aus. Zur Neuberechnung des
+Satzspiegels siehe Option
+\hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}} mit den Werten
+\hyperref[desc:\LabelBase.option.DIV.last]{\PValue{last}} oder
+\hyperref[desc:\LabelBase.option.DIV.current]{\PValue{current}} (siehe
\DescPageRef{typearea.option.DIV.last}) oder die Anweisung
\DescRef{\LabelBase.cmd.recalctypearea} (siehe
\DescPageRef{typearea.cmd.recalctypearea}).%
@@ -1334,7 +1372,7 @@ Die Option \Option{headlines}\important{\Option{headlines}} setzt man dabei
auf die Anzahl der Kopfzeilen. Normalerweise arbeitet das
\Package{typearea}-Paket mit 1,25 Kopfzeilen. Dieser Wert stellt einen
Kompromiss dar. Zum einen ist er groß genug, um auch für eine unterstrichene
-Kopfzeile (siehe \autoref{sec:maincls.options}) Platz zu bieten, zum anderen
+Kopfzeile (siehe \autoref{sec:maincls.pagestyle}) Platz zu bieten, zum anderen
ist er klein genug, um das Randgewicht nicht zu stark zu verändern, wenn mit
einer einfachen, nicht unterstrichenen Kopfzeile gearbeitet wird. Damit ist
der voreingestellte Wert in den meisten Standardfällen ein guter Wert. In
@@ -1368,18 +1406,23 @@ möglich. Als \PName{Höhe} sind alle Längen und Größen verwendbar, die \LaTeX{}
kennt. Es ist jedoch zu beachten, dass bei Verwendung einer \LaTeX-Länge wie
\Length{baselineskip} nicht deren Größe zum Zeitpunkt des Setzens der Option,
sondern zum Zeitpunkt der Berechnung des Satzspiegels und der Ränder
-entscheidend ist.
+entscheidend ist. Außerdem\textnote{Achtung!} sollten \LaTeX-Längen wie
+\Length{baselineskip} keinesfalls im optionalen Argument von
+\DescRef{\LabelBase.cmd.documentclass} oder
+\DescRef{\LabelBase.cmd.usepackage} verwendet werden.
-\iffree{}{\pagebreak}% Umbruchoptimierung!!!
Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Optionen bei
Verwendung einer der \KOMAScript-Klassen als Klassenoptionen oder per
-\DescRef{\LabelBase.cmd.KOMAoptions} beziehungsweise \DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der
-Klasse übergeben werden müssen. Eine Änderung dieser Optionen nach dem Laden
-von \Package{typearea} führt nicht\textnote{keine automatische
- Neuberechnung} zu einer automatischen Neuberechnung des
-Satzspiegels. Vielmehr wirkt sich die Änderung erst bei der nächsten
-Neuberechnung des Satzspiegels aus. Zur Neuberechnung des Satzspiegels siehe
-Option \DescRef{\LabelBase.option.DIV} mit den Werten \PValue{last} oder \PValue{current} (siehe
+\DescRef{\LabelBase.cmd.KOMAoptions} beziehungsweise
+\DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der Klasse übergeben werden
+müssen. Eine Änderung dieser Optionen nach dem Laden von \Package{typearea}
+führt nicht\textnote{keine automatische Neuberechnung} zu einer automatischen
+Neuberechnung des Satzspiegels. Vielmehr wirkt sich die Änderung erst bei der
+nächsten Neuberechnung des Satzspiegels aus. Zur Neuberechnung des
+Satzspiegels siehe Option
+\hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}} mit den Werten
+\hyperref[desc:\LabelBase.option.DIV.last]{\PValue{last}} oder
+\hyperref[desc:\LabelBase.option.DIV.current]{\PValue{current}} (siehe
\DescPageRef{typearea.option.DIV.last}) oder die Anweisung
\DescRef{\LabelBase.cmd.recalctypearea} (siehe
\DescPageRef{typearea.cmd.recalctypearea}).%
@@ -1398,14 +1441,15 @@ soll. Hierzu dienen die Optionen \Option{footlines} und
\Option{footheight}\ChangedAt{v3.12}{\Package{typearea}}. Allerdings ist die
Höhe des Fußes im Gegensatz zur Höhe des Kopfes keine Länge des \LaTeX-Kerns
selbst. Daher definiert \Package{typearea} zur Einführung eine neue Länge
-\Length{footheight}\IndexLength[indexmain]{footheight},
-falls diese noch nicht existiert. Ob diese dann auch beispielsweise von
-Klassen und Paketen für die Gestaltung von Kopf und Fuß verwendet wird, hängt
-von den verwendeten Klassen und Paketen ab. Das \KOMAScript-Paket
-\Package{scrlayer-scrpage} berücksichtigt
-\Length{footheight} und arbeitet somit aktiv mit
-\Package{typearea} zusammen. Die \KOMAScript-Klassen berücksichtigen
-\Length{footheight} hingegen nicht, da sie ohne
+\Length{footheight}\IndexLength[indexmain]{footheight}, falls diese noch nicht
+existiert. Ob diese dann auch beispielsweise von Klassen und Paketen für die
+Gestaltung von Kopf und Fuß verwendet wird, hängt von den verwendeten Klassen
+und Paketen ab. Das \KOMAScript-Paket
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}%
+\IndexPackage{scrlayer-scrpage} berücksichtigt \Length{footheight} und
+arbeitet somit aktiv mit \Package{typearea} zusammen. Die \KOMAScript-Klassen
+berücksichtigen \Length{footheight} hingegen nicht, da sie ohne
Paketunterstützung nur Seitenstile mit einzeiligen Seitenfüßen anbieten.
Die Option \Option{footlines}\important{\Option{footlines}} setzt man
@@ -1413,7 +1457,7 @@ vergleichbar zu \DescRef{\LabelBase.option.headlines} auf die Anzahl der
Fußzeilen. Normalerweise arbeitet das \Package{typearea}-Paket mit 1,25
Fußzeilen. Dieser Wert stellt einen Kompromiss dar. Zum einen ist er groß
genug, um auch für eine über- und unterstrichene Fußzeile (siehe
-\autoref{sec:maincls.options}) Platz zu bieten, zum anderen ist er klein
+\autoref{sec:maincls.pagestyle}) Platz zu bieten, zum anderen ist er klein
genug, um das Randgewicht nicht zu stark zu verändern, wenn mit einer
einfachen Fußzeile ohne Trennlinien gearbeitet wird. Damit ist der
voreingestellte Wert in den meisten Standardfällen ein guter Wert. In einigen
@@ -1426,7 +1470,9 @@ Erfordernissen anpassen.
vorgesehene Platz dafür genügend Raum bietet, die Überschreitung der
vorgesehenen Höhe resultiert aber wahrscheinlich in einer unausgeglichenen
Verteilung von Satzspiegeln und Rändern. Außerdem führt beispielsweise das
- Paket \Package{scrlayer-scrpage}, mit dem ein solcher Fuß\-in\-halt gesetzt
+ Paket \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}%
+ \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}%
+ \IndexPackage{scrlayer-scrpage}, mit dem ein solcher Fuß\-in\-halt gesetzt
werden könnte, durchaus eine entsprechende Überprüfung durch und meldet
gegebenenfalls auch Überschreitungen. Daher ist es sinnvoll, die benötigte
größere Fußhöhe bereits bei der Berechnung des Satzspiegels anzugeben:
@@ -1450,21 +1496,26 @@ möglich. Als \PName{Höhe} sind alle Längen und Größen verwendbar, die \LaTeX{}
kennt. Es ist jedoch zu beachten, dass bei Verwendung einer \LaTeX-Länge wie
\Length{baselineskip} nicht deren Größe zum Zeitpunkt des Setzens der Option,
sondern zum Zeitpunkt der Berechnung des Satzspiegels und der Ränder
-entscheidend ist.
+entscheidend ist. Außerdem\textnote{Achtung!} sollten \LaTeX-Längen wie
+\Length{baselineskip} keinesfalls im optionalen Argument von
+\DescRef{\LabelBase.cmd.documentclass} oder
+\DescRef{\LabelBase.cmd.usepackage} verwendet werden.
Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Optionen bei
Verwendung einer der \KOMAScript-Klassen als Klassenoptionen oder per
-\DescRef{\LabelBase.cmd.KOMAoptions} beziehungsweise \DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der
-Klasse übergeben werden müssen. Eine Änderung dieser Optionen nach dem Laden
-von \Package{typearea} führt nicht\textnote{keine automatische
- Neuberechnung} zu einer automatischen Neuberechnung des
-Satzspiegels. Vielmehr wirkt sich die Änderung erst bei der nächsten
-Neuberechnung des Satzspiegels aus. Zur Neuberechnung des Satzspiegels siehe
-Option \DescRef{\LabelBase.option.DIV} mit den Werten \PValue{last} oder \PValue{current} (siehe
+\DescRef{\LabelBase.cmd.KOMAoptions} beziehungsweise
+\DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der Klasse übergeben werden
+müssen. Eine Änderung dieser Optionen nach dem Laden von \Package{typearea}
+führt nicht\textnote{keine automatische Neuberechnung} zu einer automatischen
+Neuberechnung des Satzspiegels. Vielmehr wirkt sich die Änderung erst bei der
+nächsten Neuberechnung des Satzspiegels aus. Zur Neuberechnung des
+Satzspiegels siehe Option
+\hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}} mit den Werten
+\hyperref[desc:\LabelBase.option.DIV.last]{\PValue{last}} oder
+\hyperref[desc:\LabelBase.option.DIV.current]{\PValue{current}} (siehe
\DescPageRef{typearea.option.DIV.last}) oder die Anweisung
\DescRef{\LabelBase.cmd.recalctypearea} (siehe
\DescPageRef{typearea.cmd.recalctypearea}).%
-%
\EndIndexGroup
@@ -1494,7 +1545,7 @@ Informationen zu \DescRef{typearea-experts.cmd.areaset} auf
\DescPageRef{typearea-experts.cmd.areaset} in
\autoref{sec:typearea-experts.experimental}.
-Die Voreinstellung für \PName{BCOR} ist 0\Unit{pt}. Soll hingegen die aktuell,
+Die Voreinstellung für \PName{BCOR} ist 0\Unit{pt}. Soll hingegen die aktuelle,
beispielsweise per Option \DescRef{\LabelBase.option.BCOR}\IndexOption{BCOR}
eingestellte Bindekorrektur erhalten bleiben, sollte man den symbolischen Wert
\PValue{current} als optionales Argument verwenden.
@@ -1530,7 +1581,7 @@ eingestellte Bindekorrektur erhalten bleiben, sollte man den symbolischen Wert
\else %
Soll stattdessen ein Gedichtband mit quadratischem Textbereich der
Seitenlänge 15\Unit{cm} und einem Binderand von 1\Unit{cm} gesetzt
- werden, so ist folgendes möglich:
+ werden, so ist Folgendes möglich:
%
\fi
\begin{lstcode}
@@ -1563,7 +1614,7 @@ zuletzt per \DescRef{\LabelBase.cmd.areaset} eingestellt wurde.%
\iftrue% Umbruchkorrekturtext: Alternativen
Wenn Sie konkrete Vorgaben bezüglich der Ränder zu erfüllen haben, ist
\Package{typearea} nicht geeignet. In diesem Fall ist die Verwendung des
-Paketes
+Pakets
\Package{geometry}\IndexPackage{geometry}\important{\Package{geometry}} (siehe
\cite{package:geometry}) empfehlenswert.
%
@@ -1631,16 +1682,16 @@ deaktiviert sein.
Zusätzlich kann das \PName{Format} auch in der Form
\PName{Breite}\texttt{:}\PName{Höhe}\ChangedAt{v3.01b}{\Package{typearea}}%
-\important{\OptionVName{paper}\PName{Breite}\texttt{:}{Höhe}}
-beziehungsweise
+\important{\OptionVName{paper}{Breite\textup{:}Höhe}} beziehungsweise
\PName{Höhe}\texttt{:}\PName{Breite}\ChangedAt{v3.22}{\Package{typearea}}%
-\important{\OptionVName{paper}{Höhe}\texttt{:}\PName{Breite}} angegeben
+\important{\OptionVName{paper}{Höhe\textup{:}Breite}} angegeben
werden. Welcher Wert die \PName{Höhe} und welcher die \PName{Breite} ist,
richtet sich nach der Ausrichtung des Papiers. Mit
\OptionValue{paper}{landscape} oder \OptionValue{paper}{seascape} ist der
kleinere Wert die \PName{Höhe} und der größere Wert die \PName{Breite}. Mit
-\OptionValue{paper}{portrait} ist dagegen der kleinere Wert die \PName{Breite}
-und der größere Wert die \PName{Höhe}.
+\OptionValue{paper}{portrait}\important{\OptionValue{paper}{portrait}} ist
+dagegen der kleinere Wert die \PName{Breite} und der größere Wert die
+\PName{Höhe}.
Es\textnote{Achtung!} wird darauf hingewiesen, dass bis Version~3.01a der
erste Wert immer die \PName{Höhe} und der zweite Wert die \PName{Breite}
@@ -1686,8 +1737,9 @@ Kompatibilitätseinstellung (siehe Option \DescRef{\LabelBase.option.version}%
\end{Example}
In der Voreinstellung wird bei \KOMAScript{} mit A4-Papier in der Ausrichtung
-portrait gearbeitet. Dies ist ein Unterschied zu den Standardklassen, bei denen
-in der Voreinstellung das amerikanische Format letter verwendet wird.
+portrait gearbeitet. Dies ist ein Unterschied\textnote{\KOMAScript{}
+ vs. Standardklassen} zu den Standardklassen, bei denen in der Voreinstellung
+das amerikanische Format letter verwendet wird.
Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Option bei
Verwendung einer der \KOMAScript-Klassen als Klassenoption oder per
@@ -1699,11 +1751,12 @@ der Anweisung \DescRef{\LabelBase.cmd.KOMAoptions}\textnote{keine automatische
\Package{typearea} führt nicht zu einer automatischen Neuberechnung des
Satzspiegels. Vielmehr wirkt sich die Änderung erst bei der nächsten
Neuberechnung des Satzspiegels aus. Zur Neuberechnung des Satzspiegels siehe
-Option \DescRef{\LabelBase.option.DIV} mit den Werten \PValue{last} oder
-\PValue{current} (siehe \DescPageRef{typearea.option.DIV.last}) oder die
-Anweisung \DescRef{\LabelBase.cmd.recalctypearea} (siehe
+Option \hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}} mit den Werten
+\hyperref[desc:\LabelBase.option.DIV.last]{\PValue{last}} oder
+\hyperref[desc:\LabelBase.option.DIV.current]{\PValue{current}} (siehe
+\DescPageRef{typearea.option.DIV.last}) oder die Anweisung
+\DescRef{\LabelBase.cmd.recalctypearea} (siehe
\DescPageRef{typearea.cmd.recalctypearea}).%
-%
\EndIndexGroup
@@ -1713,29 +1766,39 @@ Anweisung \DescRef{\LabelBase.cmd.recalctypearea} (siehe
\begin{Explain}%
Die oben genannten Mechanismen zur Auswahl des Papierformats haben nur
insofern einen Einfluss auf die Ausgabe, als interne {\LaTeX}-Maße gesetzt
- werden. Das \Package{typearea} verwendet diese dann bei der Auf"|teilung der
- Seite in Ränder und Textbereich. Die Spezifikation des
+ werden. Das Paket \Package{typearea} verwendet diese dann bei der
+ Auf"|teilung der Seite in Ränder und Textbereich. Die Spezifikation des
DVI-Formats\Index{DVI} sieht aber an keiner Stelle Angaben zum Papierformat
- vor. Wird direkt aus dem DVI-Format in eine Low-Level-Druckersprache wie
- PCL%
- \iftrue% Umbruchkorrektur
- \footnote{PCL ist die Druckersprache, die HP für seine Tinten- und
- Laserdrucker verwendet.}%
- \fi \ oder ESC/P2%
- \iftrue% Umbruchkorrektur
- \footnote{ESC/P2 ist die Druckersprache, die EPSON für seine Nadel-, Tinten-
- und Laserdrucker benutzt.}%
- \fi \ ausgegeben, spielt dies normalerweise keine Rolle, da auch bei diesen
- Ausgaben der 0-Bezugspunkt wie bei DVI links oben liegt. Wird aber in
- Sprachen wie PostScript\Index{PostScript} oder PDF\Index{PDF} übersetzt, bei
- denen der 0-Bezugspunkt an anderer Stelle liegt und außerdem das
- Papierformat in der Ausgabedatei angegeben werden sollte, so fehlt diese
+ vor. %
+ \iffree{%
+ Wird direkt aus dem DVI-Format in eine Low-Level-Druckersprache wie PCL%
+ \iftrue% Umbruchkorrektur
+ \footnote{PCL ist eine Familie von Druckersprachen, die HP für seine
+ Tinten- und Laserdrucker verwendet.}%
+ \fi \ oder ESC/P2%
+ \iftrue% Umbruchkorrektur
+ \footnote{ESC/P2 ist die Druckersprache, die EPSON für seine 24-Nadel- und
+ ältere Tinten- oder Laserdrucker benutzt.}%
+ \fi \ beziehungsweise ESC/P-R%
+ \iftrue% Umbruchkorrektur
+ \footnote{ESC/P-R ist die Druckersprache, die EPSON aktuell für Tinten-
+ und Laserdrucker benutzt.}%
+ \fi \ ausgegeben, spielt dies normalerweise keine Rolle%
+ }{%
+ In früheren Zeiten, als DVI zum Ausruck noch direkt in
+ Low-Level-Druckersprachen übertragen wurde, spielte dies keine Rolle%
+ }, da auch bei diesen Ausgaben der 0-Bezugspunkt wie bei DVI links oben
+ liegt. \iffree{Wird aber}{Heutzutage wird aber meist} in Sprachen wie
+ PostScript\Index{PostScript} oder PDF\Index{PDF} übersetzt, bei denen der
+ 0-Bezugspunkt an anderer Stelle liegt und außerdem das Papierformat in der
+ Ausgabedatei angegeben werden sollte\iffree{, so}{. Dabei} fehlt diese
Information. Als Lösung des Problems verwendet der entsprechende Treiber
eine voreingestellte Papiergröße, die der Anwender entweder per Option oder
durch entsprechende Angabe in der {\TeX}-Quelldatei verändern kann. Bei
Verwendung des DVI-Treibers \File{dvips} oder \File{dvipdfm} kann diese
- Angabe in Form einer \Macro{special}-Anweisung erfolgen. Bei {pdf\TeX} oder
- {V\TeX} werden stattdessen zwei Längen entsprechend gesetzt.
+ Angabe in Form einer \Macro{special}-Anweisung erfolgen. Bei Verwendung von
+ {pdf\TeX}, {lua\TeX}, {\XeTeX} oder {V\TeX} werden deren
+ Papierformat-Längen entsprechend gesetzt.%
\end{Explain}
Mit der Option \Option{pagesize} kann eingestellt werden, für welchen
Ausgabetreiber die Papiergröße in das Ausgabedokument geschrieben wird. Die
@@ -1750,25 +1813,32 @@ entspricht \OptionValue{pagesize}{auto}.
\begin{desctabular}
\pventry{auto}{Falls die pdf\TeX-spezifischen Register
\Macro{pdfpagewidth}\IndexLength{pdfpagewidth} und
- \Macro{pdfpageheight}\IndexLength{pdfpageheight} vorhanden sind, wird
+ \Macro{pdfpageheight}\IndexLength{pdfpageheight} oder die
+ lua\TeX-spezifischen Register \Macro{pagewidth}\IndexLength{pagewidth}
+ und \Macro{pageheight}\IndexLength{pageheight} vorhanden sind, wird
der Ausgabetreiber \PValue{pdftex} aktiviert. Zusätzlich wird auch der
- Ausgabetreiber \PValue{dvips} verwendet.\IndexOption{pagesize~=\PValue{auto}}}%
+ Ausgabetreiber \PValue{dvips}
+ verwendet. Diese Einstellung ist grundsätzlich auch für \XeTeX{}
+ geeignet.%
+ \IndexOption{pagesize~=\textKValue{auto}}}%
\pventry{automedia}{Dies entspricht dem Ausgabetreiber
\PValue{auto}. Allerdings werden zusätzlich auch noch die
\mbox{V\TeX}-spezifischen Register
\Macro{mediawidth}\IndexLength{mediawidth} und
\Macro{mediaheight}\IndexLength{mediaheight} gesetzt, falls diese
- definiert sind.\IndexOption{pagesize~=\PValue{automedia}}}%
+ definiert sind.%
+ \IndexOption{pagesize~=\textKValue{automedia}}}%
\entry{\PValue{false}, \PValue{no}, \PValue{off}}{%
Die Papiergröße wird nicht an den Ausgabetreiber
- gemeldet.\IndexOption{pagesize~=\PValue{false}}}%
+ gemeldet.%
+ \IndexOption{pagesize~=\textKValue{false}}}%
\pventry{dvipdfmx}{\ChangedAt{v3.05a}{\Package{typearea}}Die Papiergröße
wird als
\Macro{special}\PParameter{pagesize=\PName{Breite},\PName{Höhe}} in die
DVI-Datei geschrieben. Der Name des Ausgabetreibers kommt daher, dass
das Programm \File{dvipdfmx} eine Pa\-pier\-for\-mat\-um\-schal\-tung
- über diese Anweisung auch innerhalb des Dokuments
- erlaubt.\IndexOption{pagesize~=\PValue{dvipdfmx}}}%
+ über diese Anweisung auch innerhalb des Dokuments erlaubt.%
+ \IndexOption{pagesize~=\textKValue{dvipdfmx}}}%
\pventry{dvips}{Bei Verwendung innerhalb der Dokumentpräambel wird die
Papiergröße über
\Macro{special}\PParameter{pagesize=\PName{Breite},\PName{Höhe}} in das
@@ -1778,12 +1848,19 @@ entspricht \OptionValue{pagesize}{auto}.
Umschaltung nach Möglichkeit dennoch zu
erreichen. Pa\-pier\-for\-mat\-um\-schal\-tung nach der Dokumentprämbel
bei gleichzeitiger Verwendung des Ausgabetreibers \PValue{dvips}
- erfolgen daher auf eigene Gefahr!\IndexOption{pagesize~=\PValue{dvips}}}%
- \pventry{pdftex}{Die Papiergröße wird über die pdf\TeX-spezifischen
- Register \Macro{pdfpagewidth}\IndexLength{pdfpagewidth} und
- \Macro{pdfpageheight}\IndexLength{pdfpageheight} gesetzt. Dies ist
+ erfolgen daher auf eigene Gefahr!%
+ \IndexOption{pagesize~=\textKValue{dvips}}}%
+ \entry{\PValue{pdftex}, \PValue{luatex}}{%
+ \ChangedAt{v3.20}{\Package{typearea}}Die Papiergröße
+ wird über die pdf\TeX-spezifischen Register
+ \Macro{pdfpagewidth}\IndexLength{pdfpagewidth} und
+ \Macro{pdfpageheight}\IndexLength{pdfpageheight} oder die
+ lua\TeX-spezifischen Register \Macro{pagewidth}\IndexLength{pagewidth}
+ und \Macro{pageheight}\IndexLength{pageheight} gesetzt. Dies ist
auch jederzeit innerhalb des Dokuments problemlos
- möglich.\IndexOption{pagesize~=\PValue{pdftex}}}%
+ möglich.%
+ \IndexOption{pagesize~=\textKValue{pdftex}}%
+ \IndexOption{pagesize~=\textKValue{luatex}}}%
\end{desctabular}
\label{tab:typearea.outputdriver}
\end{table}
@@ -1792,7 +1869,9 @@ entspricht \OptionValue{pagesize}{auto}.
Angenommen, es soll ein Dokument sowohl als DVI-Datei verwendet
werden, als auch eine Online-Version im PDF-Format erstellt
werden. Dann könnte die Präambel beispielsweise so beginnen:
-\begin{lstcode}
+ \begin{lstcode}[%
+ aboveskip=.5\baselineskip plus .1\baselineskip minus .1\baselineskip,%
+ belowskip=.4\baselineskip plus .1\baselineskip minus .1\baselineskip]
\documentclass{article}
\usepackage[paper=A4,pagesize]{typearea}
\end{lstcode}
@@ -1803,48 +1882,56 @@ entspricht \OptionValue{pagesize}{auto}.
{pdf\LaTeX} --, so wird ein \Macro{special} an den Anfang dieser
Datei geschrieben.
\end{Example}%
+\iffree{% Die Empfehlung ist eigentlich überholt. Wer derart alte Versionen
+ % von typearea verwendet, ist selbst schuld.
Es wird empfohlen\textnote{Achtung!}, die Option \Option{pagesize} immer
anzugeben, weil frühere Versionen von \Package{typearea} sie noch nicht als
Voreinstellung gesetzt haben. In der Regel ist dabei die Methode ohne
\PName{Ausgabetreiber} oder mit \PValue{auto} oder \PValue{automedia}
günstig.%
+}{%
+ \vskip-1\ht\strutbox plus .75\ht\strutbox% Wegen Beispiel am Ende der Erklärung
+}
\EndIndexGroup
%
\EndIndexGroup
-
+% Umbruchverbesserung:
+%\iffree{}{\clearpage}
\section{Tipps}
\seclabel{tips}
Insbesondere für die Erstellung von schriftlichen Arbeiten während des
-Studiums findet man häufig Vorschriften, die einer typografischen Begutachtung
-nicht nur in keiner Weise standhalten, sondern massiv gegen alle Regeln der
-Typografie verstoßen. Ursache für solche Regeln ist oft typografische
-Inkompetenz derjenigen, die sie herausgeben. Manchmal ist die Ursache auch im
+Studiums findet man häufig Vorschriften\textnote{Satzvorschriften
+ vs. gute~Typografie}, die einer typografischen Begutachtung nicht nur in
+keiner Weise standhalten, sondern massiv gegen alle Regeln der Typografie
+verstoßen. Ursache für solche Regeln ist oft typografische Inkompetenz
+derjenigen, die sie herausgeben. Manchmal ist die Ursache auch im
Ausgangspunkt begründet, nämlich der Schreibmaschine. Mit einer
-Schreibmaschine oder einer Textverarbeitung von 1980 ist es ohne erheblichen
-Aufwand kaum möglich, typografisch perfekte Ergebnisse zu erzielen. Also
-wurden einst Vorschriften erlassen, die leicht erfüllbar schienen und dem
-Korrektor trotzdem entgegenkommen. Dazu zählen dann Randeinstellungen, die
-für einseitigen Druck mit einer Schreibmaschine zu brauchbaren Zeilenlängen
-führen. Um nicht extrem kurze Zeilen zu erhalten, die durch Flattersatz zudem
-verschlimmert werden, werden die Ränder schmal gehalten und für Korrekturen
-stattdessen ein großer Durchschuss in Form von eineinhalbzeiligem Satz
-vorgeschrieben. Bevor moderne Textverarbeitungssysteme verfügbar wurden, wäre
--- außer mit {\TeX} -- einzeiliger Satz die einzige Alternative gewesen. Dabei
-wäre dann selbst das Anbringen von Korrekturzeichen schwierig geworden. Als
-die Verwendung von Computern für die Erstellung schriftlicher Arbeiten
-üblicher wurde, hat sich manches Mal auch der Spieltrieb des einen oder
-anderen Studenten gezeigt, der durch Verwendung einer Schmuckschrift seine
-Arbeit aufpeppen und so eine bessere Note mit weniger Einsatz herausschinden
-wollte. Nicht bedacht hat er dabei, dass solche Schriften schlechter zu lesen
-und deshalb für den Zweck ungeeignet sind. Damit hielten zwei Brotschriften
-Einzug in die Vorschriften, die weder zusammenpassen noch im Falle von Times
-wirklich gut geeignet sind. Times ist eine relativ enge Schrift, die Anfang
-des 20.~Jahrhunderts speziell für schmale Spalten im englischen Zeitungssatz
-entworfen wurde. In modernen Schnitten ist dies etwas entschärft. Dennoch
-passt die häufig vorgeschriebene Times meist nicht zu den gleichzeitig
-gegebenen Randvorgaben.
+Schreibmaschine oder einer Textverarbeitung von 1980 ist es
+ohne
+erheblichen Aufwand kaum möglich, typografisch perfekte Ergebnisse zu
+erzielen. Also wurden einst Vorschriften erlassen, die leicht erfüllbar
+schienen und dem Korrektor trotzdem entgegenkommen. Dazu zählen dann
+Randeinstellungen, die für einseitigen Druck mit einer Schreibmaschine zu
+brauchbaren Zeilenlängen führen. Um nicht extrem kurze Zeilen zu erhalten, die
+durch Flattersatz zudem verschlimmert werden, werden die Ränder schmal
+gehalten und für Korrekturen stattdessen ein großer Durchschuss in Form von
+eineinhalbzeiligem Satz vorgeschrieben. Bevor moderne
+Textverarbeitungssysteme verfügbar wurden, wäre -- außer mit {\TeX} --
+einzeiliger Satz die einzige Alternative gewesen. Dabei wäre dann selbst das
+Anbringen von Korrekturzeichen schwierig geworden. Als die Verwendung von
+Computern für die Erstellung schriftlicher Arbeiten üblicher wurde, hat sich
+manches Mal auch der Spieltrieb des einen oder anderen Studenten gezeigt, der
+durch Verwendung einer Schmuckschrift seine Arbeit aufpeppen und so eine
+bessere Note mit weniger Einsatz herausschinden wollte. Nicht bedacht hat er
+dabei, dass solche Schriften schlechter zu lesen und deshalb für den Zweck
+ungeeignet sind. Damit hielten zwei Brotschriften Einzug in die Vorschriften,
+die weder zusammenpassen noch im Falle von Times wirklich gut geeignet
+sind. Times ist eine relativ enge Schrift, die Anfang des 20.~Jahrhunderts
+speziell für schmale Spalten im englischen Zeitungssatz entworfen wurde. In
+modernen Schnitten ist dies etwas entschärft. Dennoch passt die häufig
+vorgeschriebene Times meist nicht zu den gleichzeitig gegebenen Randvorgaben.
{\LaTeX} setzt bereits von sich aus mit ausreichendem Durchschuss.
Gleichzeitig sind die Ränder bei sinnvollen Zeilenlängen groß genug, um Platz
@@ -1879,46 +1966,54 @@ gerecht. Wenn Sie also mit Vorschriften konfrontiert sind, die offensichtlich
erheblich davon abweichen, so empfehle ich, dem Betreuer einen Textauszug
vorzulegen und nachzufragen, ob es gestattet ist, die Arbeit trotz der
Abweichungen in dieser Form zu liefern. Gegebenenfalls kann durch Veränderung
-der Option \DescRef{\LabelBase.option.DIV} der Satzspiegel moderat angepasst
-werden. Von der Verwendung von \DescRef{\LabelBase.cmd.areaset} zu diesem
-Zweck rate ich jedoch ab. Schlimmstenfalls verwenden Sie das nicht zu
-{\KOMAScript} gehörende \Package{geometry}-Paket (siehe
-\cite{package:geometry}) oder verändern Sie die Satzspiegelparameter von
-{\LaTeX} selbst. Die von \Package{typearea} ermittelten Werte finden Sie in
-der \File{log}-Datei Ihres Dokuments. Damit sollten moderate Anpassungen
-möglich sein. Achten Sie jedoch unbedingt darauf, dass die Proportionen des
-Textbereichs mit denen der Seite unter Berücksichtigung der Bindekorrektur
-annähernd übereinstimmen.
+der Option
+\DescRef{\LabelBase.option.DIV}\important{\DescRef{\LabelBase.option.DIV}} der
+Satzspiegel moderat angepasst werden. Von der Verwendung von
+\DescRef{\LabelBase.cmd.areaset} zu diesem Zweck rate ich jedoch
+ab. Schlimmstenfalls verwenden Sie das nicht zu {\KOMAScript} gehörende
+\Package{geometry}-Paket\important{\Package{geometry}}\IndexPackage{geometry}
+(siehe \cite{package:geometry}) oder verändern Sie die Satzspiegelparameter
+von {\LaTeX} selbst. Die von \Package{typearea} ermittelten Werte finden Sie
+in der \File{log}-Datei Ihres Dokuments. Mit Hilfe von Option
+\DescRef{typearea-experts.option.usegeometry}%
+\important{\DescRef{typearea-experts.option.usegeometry}}, die Sie in
+\autoref{part:forExperts} finden, kann außerdem die Zusammenarbeit von
+\Package{typearea} und \Package{geometry} verbessert werden. Damit sollten
+moderate Anpassungen möglich sein. Achten Sie jedoch unbedingt darauf, dass
+die Proportionen des Textbereichs mit denen der Seite unter Berücksichtigung
+der Bindekorrektur annähernd übereinstimmen.
Sollte es unbedingt erforderlich sein, den Text eineinhalbzeilig zu setzen, so
definieren Sie keinesfalls \Macro{baselinestretch} um. Dieses Vorgehen wird
zwar allzu häufig empfohlen, ist aber seit der Einführung von {\LaTeXe} im
Jahre 1994 obsolet. Verwenden Sie schlimmstenfalls den Befehl
\Macro{linespread}. Ich empfehle das Paket
-\Package{setspace},\IndexPackage{setspace} das nicht zu {\KOMAScript} gehört
-(siehe \cite{package:setspace}). Auch sollten Sie \Package{typearea} nach der
-Umstellung des Zeilenabstandes den Satzspiegel für diesen Abstand berechnen
-lassen, jedoch für den Titel, besser auch für die Verzeichnisse -- sowie das
-Literaturverzeichnis und den Index -- wieder auf normalen Satz umschalten. Das
-\Package{setspace}-Paket bietet dafür eine spezielle Umgebung und eigene
-Befehle.
+\Package{setspace}\important{\Package{setspace}}\IndexPackage{setspace}, das
+nicht zu {\KOMAScript} gehört (siehe \cite{package:setspace}). Auch sollten
+Sie \Package{typearea} nach der Umstellung des Zeilenabstandes den Satzspiegel
+für diesen Abstand berechnen lassen, jedoch für den Titel, besser auch für die
+Verzeichnisse -- sowie das Literaturverzeichnis und den Index -- wieder auf
+normalen Satz umschalten. Näheres dazu finden Sie bei der Erklärung zu
+\OptionValueRef{\LabelBase}{DIV}{current}%
+\important{\OptionValueRef{\LabelBase}{DIV}{current}}.
Das \Package{typearea}-Paket berechnet auch bei der Option
-\OptionValueRef{\LabelBase}{DIV}{calc} einen sehr großzügigen
+\OptionValueRef{\LabelBase}{DIV}{calc}%
+\important{\OptionValueRef{\LabelBase}{DIV}{calc}} einen sehr großzügigen
Textbereich. Viele konservative Typografen werden feststellen, dass die
resultierende Zeilenlänge noch zu groß ist. Der berechnete \Var{DIV}-Wert ist
ebenfalls in der \File{log}-Datei zum jeweiligen Dokument zu finden. Sie
können also leicht nach dem ersten \LaTeX-Lauf einen kleineren Wert wählen.
-Nicht selten wird mir die Frage gestellt, warum ich eigentlich kapitelweise
-auf einer Satzspiegelberechnung herumreite, während es sehr viel einfacher
-wäre, nur ein Paket zur Verfügung zu stellen, mit dem man die Ränder wie bei
-einer Textverarbeitung einstellen kann. Oft wird auch behauptet, ein solches
-Paket wäre ohnehin die bessere Lösung, da jeder selbst wisse, wie gute Ränder
-zu wählen seien, und die Ränder von {\KOMAScript} wären ohnehin nicht gut. Ich
-erlaube mir zum Abschluss dieses Kapitels ein passendes Zitat von Hans Peter
-Willberg und Friedrich Forssmann, zwei der angesehensten Typografen der
-Gegenwart (siehe \cite{TYPO:ErsteHilfe}):
+Nicht\textnote{Was ist besser?} selten wird mir die Frage gestellt, warum ich
+eigentlich kapitelweise auf einer Satzspiegelberechnung herumreite, während es
+sehr viel einfacher wäre, nur ein Paket zur Verfügung zu stellen, mit dem man
+die Ränder wie bei einer Textverarbeitung einstellen kann. Oft wird auch
+behauptet, ein solches Paket wäre ohnehin die bessere Lösung, da jeder selbst
+wisse, wie gute Ränder zu wählen seien, und die Ränder von {\KOMAScript} wären
+ohnehin nicht gut. Ich erlaube mir zum Abschluss dieses Kapitels ein passendes
+Zitat von Hans Peter Willberg und Friedrich Forssmann, zwei der angesehensten
+Typografen der Gegenwart (siehe \cite{TYPO:ErsteHilfe}):
\begin{quote}
\phantomsection\label{sec:typearea.tips.cite}%
\textit{Das\textnote{Zitat!} Selbermachen ist längst üblich, die Ergebnisse
@@ -1930,6 +2025,8 @@ Gegenwart (siehe \cite{TYPO:ErsteHilfe}):
erster Linie um Information geht, können Fehler nicht nur stören, sondern
sogar Schaden anrichten.}
\end{quote}
+%
+\EndIndexGroup
%%% Local Variables:
%%% mode: latex
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/scrguide.cls b/Master/texmf-dist/source/latex/koma-script/doc/scrguide.cls
index 5abd1e630aa..1929f7493db 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/scrguide.cls
+++ b/Master/texmf-dist/source/latex/koma-script/doc/scrguide.cls
@@ -1,6 +1,6 @@
% ======================================================================
% scrguide.cls
-% Copyright (c) Markus Kohm, 2005-2017
+% Copyright (c) Markus Kohm, 2005-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrguide.cls
-% Copyright (c) Markus Kohm, 2005-2017
+% Copyright (c) Markus Kohm, 2005-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -145,14 +145,8 @@
\RequirePackage{multicol}
\RequirePackage{marginnote}
\RequirePackage{tabularx}
-\RequirePackage[svgnames]{xcolor}
-\RequirePackage{tocstyle}% hyperref needs xcolor with tocstyle
-\RequirePackage{tikz}
-\usetikzlibrary{calc}
-\RequirePackage[\uselanguage]{hyperref}
-\RequirePackage[open,openlevel=0]{bookmark}% improved pdf bookmarks
-\RequirePackage{scrhack}
-\RequirePackage{mparhack}
+\RequirePackage{scrhack}%
+\RequirePackage{mparhack}%
% \end{macrocode}
%
% \section{Dependence from \KOMAScript{} Version}
@@ -169,84 +163,88 @@
%
% \begin{macrocode}
\newif\ifshortversion\shortversionfalse
-\AtEndOfClass{%
- \InputIfFileExists{scrnonfree.tex}{}{%
- \typeout{^^J
- ----------------------------------------------------------------------^^J
- FREE VERSION OF THE KOMA-SCRIPT GUIDE.^^J
- NOTE THAT THIS VERSION MAY BE FULL OF UGLY PARAGRAPH AND PAGE BREAKS.^^J
- THIS IS BECAUSE THIS VERSION OF THE KOMA-SCRIPT GUIDE IS UNDER^^J
- CONSTRUCTION FOREVER.^^J
- ----------------------------------------------------------------------^^J
- ^^J%
- }%
- \newcommand*{\iffree}{\@firstoftwo}%
- \newcommand*{\important}[2][]{}%
- \newcommand*{\textnote}[2][]{}%
- \shortversiontrue
- \newcommand*{\LoadNonFree}[2]{\par\GuideLoadNonFree\par}%
- \AtBeginDocument{\InputIfFileExists{linkalias.tex}{}{}}%
- \usepackage{lmodern}%
- \@twosidefalse\@openrightfalse\@mparswitchfalse
- \RequirePackage{geometry}%
- \geometry{papersize={180mm,210mm},%
- includehead,includemp,reversemp,marginparwidth=4em,%
- vmargin={1.5mm,3mm},hmargin=1.75mm}%
- \RequirePackage{scrlayer-scrpage}%
- \clearpairofpagestyles
- \ihead{%
- \smash{%
- \hspace*{.5em}\rule[-\dp\strutbox]{0pt}{\headheight}\headmark
- }%
- }%
- \ohead*{\smash{\pagemark\hspace{2mm}}}%
- \colorlet{headbackground}{DarkBlue}%
- \colorlet{headline}{white}%
- \setkomafont{pageheadfoot}{\small\sffamily\bfseries\color{headline}}%
- \setkomafont{pagenumber}{}%
- \DeclareNewLayer[head,background,
- hoffset=0pt,
- width=\paperwidth,
- addheight=\dimexpr \topmargin+1in+\dp\strutbox\relax,
- addvoffset=2\dp\strutbox,
- contents={%
- \color{headbackground}\rule{\layerwidth}{\layerheight}}]
- {headbackground}%
- \AddLayersAtBeginOfPageStyle{scrheadings}{headbackground}%
- \renewcommand*{\chaptermark}[1]{%
- \@mkdouble{\ifnumbered{chapter}{\chaptermarkformat}{}##1}%
+\InputIfFileExists{scrnonfree.tex}{}{%
+ \RequirePackage[svgnames]{xcolor}%
+ \RequirePackage{tocstyle}% hyperref needs xcolor with tocstyle
+ \RequirePackage{tikz}%
+ \usetikzlibrary{calc}%
+ \RequirePackage[\uselanguage]{hyperref}%
+ \RequirePackage[open,openlevel=0]{bookmark}% improved pdf bookmarks
+ \typeout{^^J
+ ----------------------------------------------------------------------^^J
+ FREE VERSION OF THE KOMA-SCRIPT GUIDE.^^J
+ NOTE THAT THIS VERSION MAY BE FULL OF UGLY PARAGRAPH AND PAGE BREAKS.^^J
+ THIS IS BECAUSE THIS VERSION OF THE KOMA-SCRIPT GUIDE IS UNDER^^J
+ CONSTRUCTION FOREVER.^^J
+ ----------------------------------------------------------------------^^J
+ ^^J%
+ }%
+ \newcommand*{\iffree}{\@firstoftwo}%
+ \newcommand*{\important}[2][]{}%
+ \newcommand*{\textnote}[2][]{}%
+ \shortversiontrue
+ \newcommand*{\LoadNonFree}[2]{\par\GuideLoadNonFree\par}%
+ \AtBeginDocument{\InputIfFileExists{linkalias.tex}{}{}}%
+ \usepackage{lmodern}%
+ \@twosidefalse\@openrightfalse\@mparswitchfalse
+ \RequirePackage{geometry}%
+ \geometry{papersize={180mm,210mm},%
+ includehead,includemp,reversemp,marginparwidth=4em,%
+ vmargin={1.5mm,3mm},hmargin=1.75mm}%
+ \RequirePackage{scrlayer-scrpage}%
+ \clearpairofpagestyles
+ \ihead{%
+ \smash{%
+ \hspace*{.5em}\rule[-\dp\strutbox]{0pt}{\headheight}\headmark
}%
- \renewcommand*{\chaptermarkformat}{%
- \makebox[\dimexpr \oddsidemargin+1in-.5em][r]{%
- \chapapp~\thechapter:~%
- }%
+ }%
+ \ohead*{\smash{\pagemark\hspace{2mm}}}%
+ \colorlet{headbackground}{DarkBlue}%
+ \colorlet{headline}{white}%
+ \setkomafont{pageheadfoot}{\small\sffamily\bfseries\color{headline}}%
+ \setkomafont{pagenumber}{}%
+ \DeclareNewLayer[head,background,
+ hoffset=0pt,
+ width=\paperwidth,
+ addheight=\dimexpr \topmargin+1in+\dp\strutbox\relax,
+ addvoffset=2\dp\strutbox,
+ contents={%
+ \color{headbackground}\rule{\layerwidth}{\layerheight}}]
+ {headbackground}%
+ \AddLayersAtBeginOfPageStyle{scrheadings}{headbackground}%
+ \renewcommand*{\chaptermark}[1]{%
+ \@mkdouble{\ifnumbered{chapter}{\chaptermarkformat}{}##1}%
+ }%
+ \renewcommand*{\chaptermarkformat}{%
+ \makebox[\dimexpr \oddsidemargin+1in-.5em][r]{%
+ \chapapp~\thechapter:~%
}%
- \renewcommand*{\chapterformat}{}%
- \renewcommand*{\chapterpagestyle}{scrheadings}%
- \setlength{\@tempdimc}{\oddsidemargin}%
- \addtolength{\@tempdimc}{1in}%
- \setheadwidth[-\@tempdimc]{paper}%
- % Entweder:
- \hypersetup{colorlinks}%
- % oder:
+ }%
+ \renewcommand*{\chapterformat}{}%
+ \renewcommand*{\chapterpagestyle}{scrheadings}%
+ \setlength{\@tempdimc}{\oddsidemargin}%
+ \addtolength{\@tempdimc}{1in}%
+ \setheadwidth[-\@tempdimc]{paper}%
+ % Entweder:
+ \hypersetup{colorlinks,citecolor=Green,linkcolor=Crimson,urlcolor=Blue}%
+ % oder:
% \hypersetup{pdfborderstyle={/S/U/W 1}}%
- \let\orig@maketitle\maketitle
- \def\maketitle{%
- \begingroup
- \@twosidetrue
- \let\cleardoublepage\clearpage
- \addtolength{\oddsidemargin}{\evensidemargin}%
- \setlength{\evensidemargin}{.5\oddsidemargin}%
- \setlength{\oddsidemargin}{\evensidemargin}%
- \orig@maketitle\relax
- \endgroup
- }%
- \renewcommand*{\chapterheadstartvskip}{}%
- \raggedbottom
- \sloppy
- \lstset{breaklines,prebreak=\mbox{$\hookleftarrow$}}%
+ \let\orig@maketitle\maketitle
+ \def\maketitle{%
+ \begingroup
+ \@twosidetrue
+ \let\cleardoublepage\clearpage
+ \addtolength{\oddsidemargin}{\evensidemargin}%
+ \setlength{\evensidemargin}{.5\oddsidemargin}%
+ \setlength{\oddsidemargin}{\evensidemargin}%
+ \orig@maketitle\relax
+ \endgroup
}%
-}
+ \renewcommand*{\chapterheadstartvskip}{}%
+ \raggedbottom
+ \sloppy
+ \lstset{breaklines,prebreak=\mbox{$\hookleftarrow$}}%
+}%
% \end{macrocode}
%
% Now loading the last package (better do it late than never):
@@ -576,6 +574,14 @@
% The \KOMAScript{} guide uses a lot of emphasizations. Most of them are
% declared robustly to avoid problems at index, change log etc.
%
+% We need some colors for emphasizing in images:
+% \begin{macrocode}
+\colorlet{ImageRed}{Crimson}%
+\colorlet{ImageBlue}{Blue}%
+\colorlet{ImageGreen}{Green}%
+\colorlet{ImageYellow}{Yellow}%
+% \end{macrocode}
+%
% \begin{macro}{\textsfrm}
% Something like |\emph| using |\textsf| and |\textrm| instead of |\textit|
% and |\textup|.
@@ -725,7 +731,9 @@
\LabelOption{#1}%
\textOption{#1}%
}
-\DeclareSpecialMarkup{\KOption}{\mbox{\textOption{#1=}}\linebreak[0]}{%
+\DeclareSpecialMarkup{\KOption}{%
+ \mbox{\textOption{#1=}}\linebreak[0]%
+}{%
\ClassWarning{scrguide}{You should replace
\string\KOption{#1}\string\PName{...}\MessageBreak
by \string\OptionVName{#1}{...}}%
@@ -845,6 +853,35 @@
\label{\label@desc@prefix\label@base.option.#2=#3#1}%
\endgroup
}
+% \end{macrocode}
+% \begin{macro}{\OptionVNameRef}
+% \cs{OptionVName} by reference. Use it like
+% |\OptionVNameRef[suffix]{maincls}{version}{value}|.
+% \begin{macrocode}
+\newcommand*{\OptionVNameRef}{%
+ \kernel@ifstar {\@RefOptionVName0}{\@RefOptionVName1}%
+}
+\newcommand*{\@RefOptionVName}[1]{%
+ \kernel@ifnextchar [%]
+ {\@@RefOptionVName#1}{\@@RefOptionVName#1[]}%
+}
+\newcommand*{\@@RefOptionVName}{}
+\def\@@RefOptionVName#1[#2]#3#4#5{%
+ \scr@ifundefinedorrelax{r@\label@desc@prefix#3.option.#4=#5#2}{%
+ \ifcase #1
+ \expandafter\scr@no@hyperref
+ \else
+ \expandafter\hyperref
+ \fi
+ [\label@desc@prefix#3.option.#4#2]%
+ {\OptionVName{\ref*{\label@desc@prefix#3.option.#4#2}}{#5}}%
+ }{%
+ \expandafter\ref\ifcase #1 *\fi{\label@desc@prefix#3.option.#4=#5#2}%
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+% \begin{macrocode}
\newcommand*{\DescOptionVName}[2]{%
\par
\leftskip\z@
@@ -872,7 +909,7 @@
}
\newcommand*{\LabelPageStyle}[2][\label@suffix]{%
\begingroup
- \protected@edef\@currentlabel{\FloatStyle{#2}}%
+ \protected@edef\@currentlabel{\PageStyle{#2}}%
\label@sanitize
\Hy@MakeCurrentHref{\label@desc@prefix\label@base.pagestyle.#2#1}%
\ClassInfo{scrguide}{Anchor: `\@currentHref'}%
@@ -1848,16 +1885,22 @@
\lstdefinestyle{code}{%
language=[LaTeX]TeX,%
moretexcs={%
- @auxout, @currext, @dottedtocline, @empty, @float, @ifpackagelater,
+ @auxout,@currext,@dottedtocline,@empty,@float,@hangfrom,@ifpackagelater,
@ifundefined,
- @rightmark, @secondoftwo, @tempswafalse,@tempswatrue, @undefined,
+ @rightmark,@secondoftwo,
+ @tempskipa,@tempdima,@tempswafalse,@tempswatrue,
+ @undefined,
AtBeginDocument,AtEndDocument, appendix, ClassWarningNoLine,CurrentOption,
color,colorbox,
- DeclareOption,DeclareRobustCommand,dimexpr, end@float, ExecuteOptions,
- if@filesw,if@tempswa,if@twoside, includegraphics, MessageBreak,
+ DeclareOption,DeclareRobustCommand,dimexpr,end@float,ExecuteOptions,
+ gluexpr,
+ if@filesw,if@tempswa,if@twoside,includegraphics,
+ MessageBreak,
+ numexpr,
onehalfspacing,
PackageError,PackageInfo,PackageWarning,PassOptionsToPackage,
- ProcessOptions,protected@write,ProvidesFile,ProvidesPackage,
+ ProcessOptions,protected@edef,protected@write,
+ ProvidesFile,ProvidesPackage,
providecommand,
RequirePackage,RequirePackageWithOptions,setkey,setlength,
SelectInputMappings,setkeys,
@@ -1885,11 +1928,15 @@
blinddocument,blindtext,Blinddocument,Blindtext,
cc,captionabove,captionaboveof,captionbelow,captionbelowof,captionformat,
captionof,cefoot,cfoot,chapapp, chapappifchapterprefix,
+ chapterheadstartvskip,chapterheadmidvskip,chapterheadendvskip,
chapter,chapterlinesformat,chapterlineswithprefixformat,
- chapterformat,chaptermarkformat,chapterpagestyle,chead,
+ chapterformat,chaptermarkformat,chapternumdepth,chaptertocdepth,
+ chapterpagestyle,chead,
Clause,
- cleardoubleevenemptypage,clearscrheadfoot,closing,cofoot,Comment,
+ cleardoubleevenemptypage,cleardoubleoddpage,
+ clearscrheadfoot,closing,cofoot,Comment,
CloneTOCEntryStyle,
+ DeclareNewJuraEnvironment,
DeclareLayer,DeclareNewLayer,DeclareNewPageStyleByLayers,
DeclarePageStyleByLayers,
DeclareTOCStyleEntry,DeclareTOCEntryStyle,
@@ -1897,8 +1944,11 @@
DeclareNewTOC,DeclareSectionCommand,DeclareNewSectionCommand,
RedeclareSectionCommand,ProvideSectionCommand,
dedication,defcaptionname,deffootnote,deffootnotemark,
- DefineFamily,DefineFamilyKey,
- DefineFamilyMember,DestroyLayer,defpagestyle,deftripstyle,
+ DefineFamily,DefineFamilyKey,DefineFamilyMember,
+ DefineTOCEntryOption,DefineTOCEntryBooleanOption,
+ DefineTOCEntryCommandOption,DefintTOCEntryIfOption,
+ DefineTOCEntryLengthOption,DefineTOCEntryNumberOption,
+ DestroyLayer,defpagestyle,deftripstyle,
dictum,dictumauthorformat,dictumrule,dictumwidth,doforeachtocfile,
ellipsispar,
encl,extratitle,FamilyBoolKey,FamilyExecuteOptions,
@@ -1906,7 +1956,7 @@
FamilyKeyStateUnknownValue,FamilyKeyStateNeedValue,
FamilyNumericalKey,%
FamilyOption,FamilyOptions,FamilyProcessOptions,FamilySetBool,
- FamilyStringKey,
+ FamilyStringKey,FamilyUnknownKeyValue,
figureformat,figurename,firstfoot,firsthead,FirstName,footfont,footref,
ForEachLayerOfPageStyle,
FreeI,FreeII,FreeIII,FreeIV,
@@ -1915,7 +1965,8 @@
ifundefinedorrelax,
ifattoclist,ifoot,ihead,ifkomavarempty,ifstr,ifthispageodd,InputAddressFile,
KOMAoption,KOMAoptions,KOMAScript, l@addto@macro,
- LastName,layerwidth,layerheight,lefoot,lehead,LetterOptionNeedsPapersize,
+ LastName,layerwidth,layerheight,lefoot,lefttopmark,leftbotmark,
+ leftfirstmark,lehead,LetterOptionNeedsPapersize,
LenToUnit,
lipsum,listoffigures,
listoftables,listoftoc,LoadLetterOption,lofoot,lohead,lowertitleback,
@@ -1924,23 +1975,34 @@
Name,nameday,newbibstyle,newcaptionname,newkomavar,nexthead,
ofoot,ohead,opening,othersectionlevelsformat,
p@section,pagemark,paragraphformat,subparagraphformat,
+ paragraphnumdepth,paragraphtocdepth,
+ subparagraphnumdepth,subparagraphtocdepth,
parellipsis,parformat,parname,parshortname,
- part,partformat,partname,partpagestyle,pnumfont,
+ part,partformat,partlineswithprefixformat,
+ partname,partnumdepth,partpagestyle,partnumdepth,
+ partheadstartvskip,partheadmidvskip,partheadendvskip,
+ pnumfont,
PreventPackageFromLoading,providecaptionname,publishers,ps,
putLL,putLR,putUL,putUR,putC,
- raggedsection,raggedpart,raggedsignature,recalctypearea,
+ raggedcaption,raggedchapter,raggedfootnote,raggedsection,raggedpart,
+ raggedsignature,
+ recalctypearea,
refL,refS,refN,refoot,
refParagraph,refParagraphN,refPar,refParL,refParS,refParN,
refSentence,refSentenceL,refSentenceS,refSentenceN,rehead,
RelaxFamilyKey,
removereffields,renewcaptionname,
- RedeclarePageStyleAlias,
+ RedeclarePageStyleAlias,RedeclareTOCStyleEntry,
ReplaceInput,ReplacePackage,ResetPreventPackageFromLoading,
+ rightbotmark,righttopmark,rightfirstmark,
rohead,
sectionformat,subsectionformat,subsubsectionformat,
+ sectionnumdepth,sectiontocdepth,
+ subsectionnumdepth,subsectiontocdepth,
+ subsubsectionnumdepth,subsubsectiontocdepth,
sectionmarkformat,sectioncatchphraseformat,sectionlinesformat,
Sentence,sentencename,sentenceshortname,
- setbibpreamble,setcapindent,setcapwidth,
+ setbibpreamble,setcapindent,setcapwidth,setcaptionalignment,
setchapterpreamble,setfootbotline,setfootsepline,setfootwidth,
setheadsepline,setheadtopline,setheadwidth,setindexpreamble,setkomafont,
setkomavar,setlengthtoplength,setparsizes,setpartpreamble,setuptoc,
@@ -2004,16 +2066,18 @@ KOMAScript \endcsname
% We have to setup \textsf{hyperref}:
% \begin{macrocode}
\AtBeginDocument{%
- \hypersetup{%
- plainpages=false,
- pdftitle={\GuideTitle},
- pdfauthor={Markus Kohm, Jens-Uwe Morawski},
- pdfsubject={\GuideSubject},
- pdfkeywords={\KOMAScript, scrbook, scrreprt, scrartcl,
- typearea, scrlfile,
- scrpage, scrpage2, scrlettr, scrlttr2, scraddr, scrtime, scrdate},
- pdfcreator={\KOMAScript, hyperref}
- }%
+ \iffree{%
+ \hypersetup{%
+ plainpages=false,
+ pdftitle={\GuideTitle},
+ pdfauthor={Markus Kohm},
+ pdfsubject={\GuideSubject},
+ pdfkeywords={\KOMAScript, scrbook, scrreprt, scrartcl,
+ typearea, scrlfile, scrlayer, scrlayer-scrpage, scrlayer-notecolumn,
+ scrletter, scrlttr2, scraddr, scrtime, scrdate, scrwfile},
+ pdfcreator={\KOMAScript, hyperref}
+ }%
+ }{}%
}
% \end{macrocode}
%
@@ -2092,6 +2156,18 @@ KOMAScript \endcsname
% \end{macrocode}
%
%
+% \section{Logos}
+%
+% I don't want to use package \textsf{hologo} for only one logo:
+% \begin{macrocode}
+\DeclareRobustCommand{\XeTeX}{%
+ X\kern-.125em\lower.5ex\hbox{\reflectbox{E}}\kern-.10em\TeX%
+}%
+\DeclareRobustCommand{\XeLaTeX}{%
+ X\kern-.125em\lower.5ex\hbox{\reflectbox{E}}\kern-.10em\LaTeX%
+}%
+% \end{macrocode}
+%
% \section{Appendix}
%
% \begin{macro}{\appendix}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/scrguide.html b/Master/texmf-dist/source/latex/koma-script/doc/scrguide.html
index 91c68657257..68ad75018df 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/scrguide.html
+++ b/Master/texmf-dist/source/latex/koma-script/doc/scrguide.html
@@ -10,967 +10,975 @@
<li><a href="#option">Optionen</a></li><li><a href="#macro">Anweisungen</a></li><li><a href="#environment">Umgebungen</a></li><li><a href="#length">Längen</a></li><li><a href="#plength">Pseudolängen</a></li><li><a href="#variable">Variablen</a></li><li><a href="#pagestyle">Seitenstile</a></li><li><a href="#counter">Zähler</a></li><li><a href="#floatstyle">Stile für das float-Paket</a></li></ul>
<h2><a name="option">Optionen</a></h2>
<ul>
-<li><a name="option.12h"></a><a href="#option.12h">12h</a> --&gt; <a href="scrguide.pdf#desc:scrtime.option.12h">283</a></li>
+<li><a name="option.12h"></a><a href="#option.12h">12h</a> --&gt; <a href="scrguide.pdf#desc:scrtime.option.12h">287</a></li>
<li><a name="option.BCOR"></a><a href="#option.BCOR">BCOR</a> --&gt; <a href="scrguide.pdf#desc:typearea.option.BCOR">34</a></li>
<li><a name="option.DIV"></a><a href="#option.DIV">DIV</a> --&gt; <a href="scrguide.pdf#desc:typearea.option.DIV">35</a></li>
<li><a name="option.abstract"></a><a href="#option.abstract">abstract</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.abstract">75</a></li>
-<li><a name="option.addrfield"></a><a href="#option.addrfield">addrfield</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.addrfield">202</a></li>
-<li><a name="option.adrFreeIVempty"></a><a href="#option.adrFreeIVempty">adrFreeIVempty</a> --&gt; <a href="scrguide.pdf#desc:scraddr.option.adrFreeIVempty">287</a></li>
-<li><a name="option.adrFreeIVshow"></a><a href="#option.adrFreeIVshow">adrFreeIVshow</a> --&gt; <a href="scrguide.pdf#desc:scraddr.option.adrFreeIVshow">287</a></li>
-<li><a name="option.adrFreeIVstop"></a><a href="#option.adrFreeIVstop">adrFreeIVstop</a> --&gt; <a href="scrguide.pdf#desc:scraddr.option.adrFreeIVstop">287</a></li>
-<li><a name="option.adrFreeIVwarn"></a><a href="#option.adrFreeIVwarn">adrFreeIVwarn</a> --&gt; <a href="scrguide.pdf#desc:scraddr.option.adrFreeIVwarn">287</a></li>
-<li><a name="option.appendixprefix"></a><a href="#option.appendixprefix">appendixprefix</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.appendixprefix">100</a></li>
-<li><a name="option.areasetadvanced"></a><a href="#option.areasetadvanced">areasetadvanced</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.option.areasetadvanced">485</a></li>
-<li><a name="option.autoclearnotecolumns"></a><a href="#option.autoclearnotecolumns">autoclearnotecolumns</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.option.autoclearnotecolumns">482</a></li>
-<li><a name="option.automark"></a><a href="#option.automark">automark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.automark">264</a>, <a href="scrguide.pdf#desc:scrlayer.option.automark">448</a></li>
-<li><a name="option.autooneside"></a><a href="#option.autooneside">autooneside</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.autooneside">264</a>, <a href="scrguide.pdf#desc:scrlayer.option.autooneside">448</a></li>
-<li><a name="option.autoremoveinterfaces"></a><a href="#option.autoremoveinterfaces">autoremoveinterfaces</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.autoremoveinterfaces">455</a></li>
-<li><a name="option.backaddress"></a><a href="#option.backaddress">backaddress</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.backaddress">202</a></li>
-<li><a name="option.bibliography"></a><a href="#option.bibliography">bibliography</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.bibliography">154</a></li>
-<li><a name="option.captions"></a><a href="#option.captions">captions</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.captions">134</a></li>
-<li><a name="option.chapteratlists"></a><a href="#option.chapteratlists">chapteratlists</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.chapteratlists">104</a></li>
+<li><a name="option.addrfield"></a><a href="#option.addrfield">addrfield</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.addrfield">208</a></li>
+<li><a name="option.adrFreeIVempty"></a><a href="#option.adrFreeIVempty">adrFreeIVempty</a> --&gt; <a href="scrguide.pdf#desc:scraddr.option.adrFreeIVempty">291</a></li>
+<li><a name="option.adrFreeIVshow"></a><a href="#option.adrFreeIVshow">adrFreeIVshow</a> --&gt; <a href="scrguide.pdf#desc:scraddr.option.adrFreeIVshow">291</a></li>
+<li><a name="option.adrFreeIVstop"></a><a href="#option.adrFreeIVstop">adrFreeIVstop</a> --&gt; <a href="scrguide.pdf#desc:scraddr.option.adrFreeIVstop">291</a></li>
+<li><a name="option.adrFreeIVwarn"></a><a href="#option.adrFreeIVwarn">adrFreeIVwarn</a> --&gt; <a href="scrguide.pdf#desc:scraddr.option.adrFreeIVwarn">291</a></li>
+<li><a name="option.appendixprefix"></a><a href="#option.appendixprefix">appendixprefix</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.appendixprefix">102</a></li>
+<li><a name="option.areasetadvanced"></a><a href="#option.areasetadvanced">areasetadvanced</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.option.areasetadvanced">489</a></li>
+<li><a name="option.autoclearnotecolumns"></a><a href="#option.autoclearnotecolumns">autoclearnotecolumns</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.option.autoclearnotecolumns">486</a></li>
+<li><a name="option.autoenlargeheadfoot"></a><a href="#option.autoenlargeheadfoot">autoenlargeheadfoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.autoenlargeheadfoot">254</a></li>
+<li><a name="option.automark"></a><a href="#option.automark">automark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.automark">271</a>, <a href="scrguide.pdf#desc:scrlayer.option.automark">454</a></li>
+<li><a name="option.autooneside"></a><a href="#option.autooneside">autooneside</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.autooneside">271</a>, <a href="scrguide.pdf#desc:scrlayer.option.autooneside">454</a></li>
+<li><a name="option.autoremoveinterfaces"></a><a href="#option.autoremoveinterfaces">autoremoveinterfaces</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.autoremoveinterfaces">461</a></li>
+<li><a name="option.backaddress"></a><a href="#option.backaddress">backaddress</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.backaddress">208</a></li>
+<li><a name="option.bibliography"></a><a href="#option.bibliography">bibliography</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.bibliography">159</a></li>
+<li><a name="option.captions"></a><a href="#option.captions">captions</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.captions">137</a></li>
+<li><a name="option.chapteratlists"></a><a href="#option.chapteratlists">chapteratlists</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.chapteratlists">106</a></li>
<li><a name="option.chapterentrydots"></a><a href="#option.chapterentrydots">chapterentrydots</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.chapterentrydots">79</a></li>
-<li><a name="option.chapterprefix"></a><a href="#option.chapterprefix">chapterprefix</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.chapterprefix">100</a></li>
-<li><a name="option.clausemark"></a><a href="#option.clausemark">clausemark</a> --&gt; <a href="scrguide.pdf#desc:scrjura.option.clausemark">320</a></li>
-<li><a name="option.cleardoublepage"></a><a href="#option.cleardoublepage">cleardoublepage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.cleardoublepage">223</a>, <a href="scrguide.pdf#desc:scrextend.option.cleardoublepage">302</a>, <a href="scrguide.pdf#desc:maincls.option.cleardoublepage">90</a></li>
-<li><a name="option.clines"></a><a href="#option.clines">clines</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.clines">276</a></li>
-<li><a name="option.contract"></a><a href="#option.contract">contract</a> --&gt; <a href="scrguide.pdf#desc:scrjura.option.contract">317</a></li>
-<li><a name="option.deactivatepagestylelayers"></a><a href="#option.deactivatepagestylelayers">deactivatepagestylelayers</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.deactivatepagestylelayers">443</a></li>
-<li><a name="option.draft"></a><a href="#option.draft">draft</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.draft">168</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.option.draft">267</a>, <a href="scrguide.pdf#desc:scrextend.option.draft">292</a>, <a href="scrguide.pdf#desc:scrlayer.option.draft">449</a>, <a href="scrguide.pdf#desc:maincls.option.draft">59</a></li>
-<li><a name="option.enlargefirstpage"></a><a href="#option.enlargefirstpage">enlargefirstpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.enlargefirstpage">189</a></li>
-<li><a name="option.extendedfeature"></a><a href="#option.extendedfeature">extendedfeature</a> --&gt; <a href="scrguide.pdf#desc:scrextend.option.extendedfeature">292</a></li>
-<li><a name="option.firstfoot"></a><a href="#option.firstfoot">firstfoot</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.firstfoot">215</a></li>
-<li><a name="option.firsthead"></a><a href="#option.firsthead">firsthead</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.firsthead">190</a></li>
-<li><a name="option.fleqn"></a><a href="#option.fleqn">fleqn</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.fleqn">133</a></li>
-<li><a name="option.foldmarks"></a><a href="#option.foldmarks">foldmarks</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.foldmarks">186</a></li>
-<li><a name="option.fontsize"></a><a href="#option.fontsize">fontsize</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.fontsize">179</a>, <a href="scrguide.pdf#desc:scrextend.option.fontsize">293</a>, <a href="scrguide.pdf#desc:maincls.option.fontsize">61</a></li>
-<li><a name="option.footbotline"></a><a href="#option.footbotline">footbotline</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.footbotline">274</a></li>
+<li><a name="option.chapterprefix"></a><a href="#option.chapterprefix">chapterprefix</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.chapterprefix">102</a></li>
+<li><a name="option.clausemark"></a><a href="#option.clausemark">clausemark</a> --&gt; <a href="scrguide.pdf#desc:scrjura.option.clausemark">322</a></li>
+<li><a name="option.cleardoublepage"></a><a href="#option.cleardoublepage">cleardoublepage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.cleardoublepage">230</a>, <a href="scrguide.pdf#desc:scrextend.option.cleardoublepage">306</a>, <a href="scrguide.pdf#desc:maincls.option.cleardoublepage">92</a></li>
+<li><a name="option.clines"></a><a href="#option.clines">clines</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.clines">280</a></li>
+<li><a name="option.contract"></a><a href="#option.contract">contract</a> --&gt; <a href="scrguide.pdf#desc:scrjura.option.contract">319</a></li>
+<li><a name="option.deactivatepagestylelayers"></a><a href="#option.deactivatepagestylelayers">deactivatepagestylelayers</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.deactivatepagestylelayers">449</a></li>
+<li><a name="option.draft"></a><a href="#option.draft">draft</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.draft">173</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.option.draft">272</a>, <a href="scrguide.pdf#desc:scrextend.option.draft">296</a>, <a href="scrguide.pdf#desc:scrlayer.option.draft">455</a>, <a href="scrguide.pdf#desc:maincls.option.draft">59</a></li>
+<li><a name="option.enlargefirstpage"></a><a href="#option.enlargefirstpage">enlargefirstpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.enlargefirstpage">194</a></li>
+<li><a name="option.extendedfeature"></a><a href="#option.extendedfeature">extendedfeature</a> --&gt; <a href="scrguide.pdf#desc:scrextend.option.extendedfeature">296</a></li>
+<li><a name="option.firstfoot"></a><a href="#option.firstfoot">firstfoot</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.firstfoot">221</a></li>
+<li><a name="option.firsthead"></a><a href="#option.firsthead">firsthead</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.firsthead">195</a></li>
+<li><a name="option.fleqn"></a><a href="#option.fleqn">fleqn</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.fleqn">136</a></li>
+<li><a name="option.foldmarks"></a><a href="#option.foldmarks">foldmarks</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.foldmarks">192</a></li>
+<li><a name="option.fontsize"></a><a href="#option.fontsize">fontsize</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.fontsize">184</a>, <a href="scrguide.pdf#desc:scrextend.option.fontsize">297</a>, <a href="scrguide.pdf#desc:maincls.option.fontsize">61</a></li>
+<li><a name="option.footbotline"></a><a href="#option.footbotline">footbotline</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.footbotline">279</a></li>
<li><a name="option.footheight"></a><a href="#option.footheight">footheight</a> --&gt; <a href="scrguide.pdf#desc:typearea.option.footheight">47</a></li>
<li><a name="option.footinclude"></a><a href="#option.footinclude">footinclude</a> --&gt; <a href="scrguide.pdf#desc:typearea.option.footinclude">43</a></li>
<li><a name="option.footlines"></a><a href="#option.footlines">footlines</a> --&gt; <a href="scrguide.pdf#desc:typearea.option.footlines">47</a></li>
-<li><a name="option.footnotes"></a><a href="#option.footnotes">footnotes</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.footnotes">225</a>, <a href="scrguide.pdf#desc:scrextend.option.footnotes">304</a>, <a href="scrguide.pdf#desc:maincls.option.footnotes">93</a></li>
-<li><a name="option.footsepline"></a><a href="#option.footsepline">footsepline</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.footsepline">219</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.option.footsepline">274</a>, <a href="scrguide.pdf#desc:scrlttr2-experts.option.footsepline">533</a>, <a href="scrguide.pdf#desc:maincls.option.footsepline">84</a></li>
-<li><a name="option.footwidth"></a><a href="#option.footwidth">footwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.footwidth">273</a></li>
-<li><a name="option.forceoverwrite"></a><a href="#option.forceoverwrite">forceoverwrite</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.forceoverwrite">455</a></li>
-<li><a name="option.fromalign"></a><a href="#option.fromalign">fromalign</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.fromalign">190</a></li>
-<li><a name="option.fromemail"></a><a href="#option.fromemail">fromemail</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.fromemail">195</a></li>
-<li><a name="option.fromfax"></a><a href="#option.fromfax">fromfax</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.fromfax">195</a></li>
-<li><a name="option.fromlogo"></a><a href="#option.fromlogo">fromlogo</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.fromlogo">198</a></li>
-<li><a name="option.frommobilephone"></a><a href="#option.frommobilephone">frommobilephone</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.frommobilephone">195</a></li>
-<li><a name="option.fromphone"></a><a href="#option.fromphone">fromphone</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.fromphone">195</a></li>
-<li><a name="option.fromrule"></a><a href="#option.fromrule">fromrule</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.fromrule">190</a></li>
-<li><a name="option.fromurl"></a><a href="#option.fromurl">fromurl</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.fromurl">195</a></li>
-<li><a name="option.headheight"></a><a href="#option.headheight">headheight</a> --&gt; <a href="scrguide.pdf#desc:typearea.option.headheight">45</a></li>
+<li><a name="option.footnotes"></a><a href="#option.footnotes">footnotes</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.footnotes">231</a>, <a href="scrguide.pdf#desc:scrextend.option.footnotes">308</a>, <a href="scrguide.pdf#desc:maincls.option.footnotes">95</a></li>
+<li><a name="option.footsepline"></a><a href="#option.footsepline">footsepline</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.footsepline">225</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.option.footsepline">279</a>, <a href="scrguide.pdf#desc:maincls.option.footsepline">85</a></li>
+<li><a name="option.footwidth"></a><a href="#option.footwidth">footwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.footwidth">277</a></li>
+<li><a name="option.forceoverwrite"></a><a href="#option.forceoverwrite">forceoverwrite</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.forceoverwrite">461</a></li>
+<li><a name="option.fromalign"></a><a href="#option.fromalign">fromalign</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.fromalign">195</a></li>
+<li><a name="option.fromemail"></a><a href="#option.fromemail">fromemail</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.fromemail">201</a></li>
+<li><a name="option.fromfax"></a><a href="#option.fromfax">fromfax</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.fromfax">201</a></li>
+<li><a name="option.fromlogo"></a><a href="#option.fromlogo">fromlogo</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.fromlogo">204</a></li>
+<li><a name="option.frommobilephone"></a><a href="#option.frommobilephone">frommobilephone</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.frommobilephone">201</a></li>
+<li><a name="option.fromphone"></a><a href="#option.fromphone">fromphone</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.fromphone">201</a></li>
+<li><a name="option.fromrule"></a><a href="#option.fromrule">fromrule</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.fromrule">196</a></li>
+<li><a name="option.fromurl"></a><a href="#option.fromurl">fromurl</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.fromurl">201</a></li>
+<li><a name="option.headheight"></a><a href="#option.headheight">headheight</a> --&gt; <a href="scrguide.pdf#desc:typearea.option.headheight">46</a></li>
<li><a name="option.headinclude"></a><a href="#option.headinclude">headinclude</a> --&gt; <a href="scrguide.pdf#desc:typearea.option.headinclude">43</a></li>
-<li><a name="option.headings"></a><a href="#option.headings">headings</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.headings">100</a></li>
-<li><a name="option.headlines"></a><a href="#option.headlines">headlines</a> --&gt; <a href="scrguide.pdf#desc:typearea.option.headlines">45</a></li>
-<li><a name="option.headsepline"></a><a href="#option.headsepline">headsepline</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.headsepline">219</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.option.headsepline">274</a>, <a href="scrguide.pdf#desc:scrlttr2-experts.option.headsepline">533</a>, <a href="scrguide.pdf#desc:maincls.option.headsepline">84</a></li>
-<li><a name="option.headtopline"></a><a href="#option.headtopline">headtopline</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.headtopline">274</a></li>
-<li><a name="option.headwidth"></a><a href="#option.headwidth">headwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.headwidth">273</a></li>
-<li><a name="option.hmode"></a><a href="#option.hmode">hmode</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.option.hmode">468</a></li>
-<li><a name="option.ilines"></a><a href="#option.ilines">ilines</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.ilines">276</a></li>
-<li><a name="option.index"></a><a href="#option.index">index</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.index">157</a></li>
-<li><a name="option.internalonly"></a><a href="#option.internalonly">internalonly</a> --&gt; <a href="scrguide.pdf#desc:scrbase.option.internalonly">336</a></li>
-<li><a name="option.juratitlepagebreak"></a><a href="#option.juratitlepagebreak">juratitlepagebreak</a> --&gt; <a href="scrguide.pdf#desc:scrjura.option.juratitlepagebreak">320</a></li>
-<li><a name="option.juratocindent"></a><a href="#option.juratocindent">juratocindent</a> --&gt; <a href="scrguide.pdf#desc:scrjura.option.juratocindent">316</a></li>
-<li><a name="option.juratocnumberwidth"></a><a href="#option.juratocnumberwidth">juratocnumberwidth</a> --&gt; <a href="scrguide.pdf#desc:scrjura.option.juratocnumberwidth">316</a></li>
-<li><a name="option.juratotoc"></a><a href="#option.juratotoc">juratotoc</a> --&gt; <a href="scrguide.pdf#desc:scrjura.option.juratotoc">316</a></li>
-<li><a name="option.leqno"></a><a href="#option.leqno">leqno</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.leqno">133</a></li>
-<li><a name="option.listof"></a><a href="#option.listof">listof</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.listof">148</a></li>
-<li><a name="option.locfield"></a><a href="#option.locfield">locfield</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.locfield">205</a></li>
-<li><a name="option.manualmark"></a><a href="#option.manualmark">manualmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.manualmark">264</a>, <a href="scrguide.pdf#desc:scrlayer.option.manualmark">448</a></li>
-<li><a name="option.markcase"></a><a href="#option.markcase">markcase</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.markcase">268</a>, <a href="scrguide.pdf#desc:scrlayer.option.markcase">449</a></li>
-<li><a name="option.mpinclude"></a><a href="#option.mpinclude">mpinclude</a> --&gt; <a href="scrguide.pdf#desc:typearea.option.mpinclude">44</a></li>
-<li><a name="option.numbers"></a><a href="#option.numbers">numbers</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.numbers">103</a></li>
-<li><a name="option.numericaldate"></a><a href="#option.numericaldate">numericaldate</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.numericaldate">207</a></li>
-<li><a name="option.olines"></a><a href="#option.olines">olines</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.olines">276</a></li>
-<li><a name="option.onpsbackground"></a><a href="#option.onpsbackground">onpsbackground</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsbackground">443</a></li>
-<li><a name="option.onpsevenpage"></a><a href="#option.onpsevenpage">onpsevenpage</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsevenpage">443</a></li>
-<li><a name="option.onpsfloatpage"></a><a href="#option.onpsfloatpage">onpsfloatpage</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsfloatpage">443</a></li>
-<li><a name="option.onpsforeground"></a><a href="#option.onpsforeground">onpsforeground</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsforeground">443</a></li>
-<li><a name="option.onpsinit"></a><a href="#option.onpsinit">onpsinit</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsinit">443</a></li>
-<li><a name="option.onpsnonfloatpage"></a><a href="#option.onpsnonfloatpage">onpsnonfloatpage</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsnonfloatpage">443</a></li>
-<li><a name="option.onpsoddpage"></a><a href="#option.onpsoddpage">onpsoddpage</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsoddpage">443</a></li>
-<li><a name="option.onpsoneside"></a><a href="#option.onpsoneside">onpsoneside</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsoneside">443</a></li>
-<li><a name="option.onpsselect"></a><a href="#option.onpsselect">onpsselect</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsselect">443</a></li>
-<li><a name="option.onpstwoside"></a><a href="#option.onpstwoside">onpstwoside</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpstwoside">443</a></li>
-<li><a name="option.open"></a><a href="#option.open">open</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.open">99</a></li>
-<li><a name="option.origlongtable"></a><a href="#option.origlongtable">origlongtable</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.origlongtable">148</a></li>
-<li><a name="option.pagenumber"></a><a href="#option.pagenumber">pagenumber</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.pagenumber">220</a></li>
+<li><a name="option.headings"></a><a href="#option.headings">headings</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.headings">102</a></li>
+<li><a name="option.headlines"></a><a href="#option.headlines">headlines</a> --&gt; <a href="scrguide.pdf#desc:typearea.option.headlines">46</a></li>
+<li><a name="option.headsepline"></a><a href="#option.headsepline">headsepline</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.headsepline">225</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.option.headsepline">279</a>, <a href="scrguide.pdf#desc:maincls.option.headsepline">85</a></li>
+<li><a name="option.headtopline"></a><a href="#option.headtopline">headtopline</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.headtopline">279</a></li>
+<li><a name="option.headwidth"></a><a href="#option.headwidth">headwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.headwidth">277</a></li>
+<li><a name="option.hmode"></a><a href="#option.hmode">hmode</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.option.hmode">471</a></li>
+<li><a name="option.ilines"></a><a href="#option.ilines">ilines</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.ilines">280</a></li>
+<li><a name="option.index"></a><a href="#option.index">index</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.index">162</a></li>
+<li><a name="option.internalonly"></a><a href="#option.internalonly">internalonly</a> --&gt; <a href="scrguide.pdf#desc:scrbase.option.internalonly">356</a></li>
+<li><a name="option.juratitlepagebreak"></a><a href="#option.juratitlepagebreak">juratitlepagebreak</a> --&gt; <a href="scrguide.pdf#desc:scrjura.option.juratitlepagebreak">322</a></li>
+<li><a name="option.juratocindent"></a><a href="#option.juratocindent">juratocindent</a> --&gt; <a href="scrguide.pdf#desc:scrjura.option.juratocindent">319</a></li>
+<li><a name="option.juratocnumberwidth"></a><a href="#option.juratocnumberwidth">juratocnumberwidth</a> --&gt; <a href="scrguide.pdf#desc:scrjura.option.juratocnumberwidth">319</a></li>
+<li><a name="option.juratotoc"></a><a href="#option.juratotoc">juratotoc</a> --&gt; <a href="scrguide.pdf#desc:scrjura.option.juratotoc">318</a></li>
+<li><a name="option.leqno"></a><a href="#option.leqno">leqno</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.leqno">136</a></li>
+<li><a name="option.listof"></a><a href="#option.listof">listof</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.listof">153</a></li>
+<li><a name="option.locfield"></a><a href="#option.locfield">locfield</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.locfield">211</a></li>
+<li><a name="option.manualmark"></a><a href="#option.manualmark">manualmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.manualmark">271</a>, <a href="scrguide.pdf#desc:scrlayer.option.manualmark">454</a></li>
+<li><a name="option.markcase"></a><a href="#option.markcase">markcase</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.markcase">272</a>, <a href="scrguide.pdf#desc:scrlayer.option.markcase">455</a></li>
+<li><a name="option.mpinclude"></a><a href="#option.mpinclude">mpinclude</a> --&gt; <a href="scrguide.pdf#desc:typearea.option.mpinclude">45</a></li>
+<li><a name="option.numbers"></a><a href="#option.numbers">numbers</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.numbers">105</a></li>
+<li><a name="option.numericaldate"></a><a href="#option.numericaldate">numericaldate</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.numericaldate">213</a></li>
+<li><a name="option.olines"></a><a href="#option.olines">olines</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.olines">280</a></li>
+<li><a name="option.onpsbackground"></a><a href="#option.onpsbackground">onpsbackground</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsbackground">448</a></li>
+<li><a name="option.onpsevenpage"></a><a href="#option.onpsevenpage">onpsevenpage</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsevenpage">448</a></li>
+<li><a name="option.onpsfloatpage"></a><a href="#option.onpsfloatpage">onpsfloatpage</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsfloatpage">448</a></li>
+<li><a name="option.onpsforeground"></a><a href="#option.onpsforeground">onpsforeground</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsforeground">448</a></li>
+<li><a name="option.onpsinit"></a><a href="#option.onpsinit">onpsinit</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsinit">448</a></li>
+<li><a name="option.onpsnonfloatpage"></a><a href="#option.onpsnonfloatpage">onpsnonfloatpage</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsnonfloatpage">448</a></li>
+<li><a name="option.onpsoddpage"></a><a href="#option.onpsoddpage">onpsoddpage</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsoddpage">448</a></li>
+<li><a name="option.onpsoneside"></a><a href="#option.onpsoneside">onpsoneside</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsoneside">448</a></li>
+<li><a name="option.onpsselect"></a><a href="#option.onpsselect">onpsselect</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpsselect">448</a></li>
+<li><a name="option.onpstwoside"></a><a href="#option.onpstwoside">onpstwoside</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.onpstwoside">448</a></li>
+<li><a name="option.open"></a><a href="#option.open">open</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.open">101</a></li>
+<li><a name="option.origlongtable"></a><a href="#option.origlongtable">origlongtable</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.origlongtable">153</a></li>
+<li><a name="option.overfullrule"></a><a href="#option.overfullrule">overfullrule</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.overfullrule">173</a>, <a href="scrguide.pdf#desc:scrextend.option.overfullrule">296</a>, <a href="scrguide.pdf#desc:maincls.option.overfullrule">59</a></li>
+<li><a name="option.pagenumber"></a><a href="#option.pagenumber">pagenumber</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.pagenumber">226</a></li>
<li><a name="option.pagesize"></a><a href="#option.pagesize">pagesize</a> --&gt; <a href="scrguide.pdf#desc:typearea.option.pagesize">51</a></li>
-<li><a name="option.pagestyleset"></a><a href="#option.pagestyleset">pagestyleset</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.pagestyleset">263</a></li>
+<li><a name="option.pagestyleset"></a><a href="#option.pagestyleset">pagestyleset</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.pagestyleset">267</a></li>
<li><a name="option.paper"></a><a href="#option.paper">paper</a> --&gt; <a href="scrguide.pdf#desc:typearea.option.paper">50</a></li>
-<li><a name="option.parnumber"></a><a href="#option.parnumber">parnumber</a> --&gt; <a href="scrguide.pdf#desc:scrjura.option.parnumber">321</a></li>
-<li><a name="option.parskip"></a><a href="#option.parskip">parskip</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.parskip">217</a>, <a href="scrguide.pdf#desc:maincls.option.parskip">81</a></li>
-<li><a name="option.plainfootbotline"></a><a href="#option.plainfootbotline">plainfootbotline</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.plainfootbotline">275</a></li>
-<li><a name="option.plainfootsepline"></a><a href="#option.plainfootsepline">plainfootsepline</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.plainfootsepline">275</a></li>
-<li><a name="option.plainheadsepline"></a><a href="#option.plainheadsepline">plainheadsepline</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.plainheadsepline">275</a></li>
-<li><a name="option.plainheadtopline"></a><a href="#option.plainheadtopline">plainheadtopline</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.plainheadtopline">275</a></li>
-<li><a name="option.priority"></a><a href="#option.priority">priority</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.priority">202</a></li>
-<li><a name="option.ref"></a><a href="#option.ref">ref</a> --&gt; <a href="scrguide.pdf#desc:scrjura.option.ref">324</a></li>
-<li><a name="option.refline"></a><a href="#option.refline">refline</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.refline">208</a></li>
+<li><a name="option.parnumber"></a><a href="#option.parnumber">parnumber</a> --&gt; <a href="scrguide.pdf#desc:scrjura.option.parnumber">323</a></li>
+<li><a name="option.parskip"></a><a href="#option.parskip">parskip</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.parskip">223</a>, <a href="scrguide.pdf#desc:maincls.option.parskip">82</a></li>
+<li><a name="option.plainfootbotline"></a><a href="#option.plainfootbotline">plainfootbotline</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.plainfootbotline">279</a></li>
+<li><a name="option.plainfootsepline"></a><a href="#option.plainfootsepline">plainfootsepline</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.plainfootsepline">279</a></li>
+<li><a name="option.plainheadsepline"></a><a href="#option.plainheadsepline">plainheadsepline</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.plainheadsepline">279</a></li>
+<li><a name="option.plainheadtopline"></a><a href="#option.plainheadtopline">plainheadtopline</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.option.plainheadtopline">279</a></li>
+<li><a name="option.priority"></a><a href="#option.priority">priority</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.priority">208</a></li>
+<li><a name="option.ref"></a><a href="#option.ref">ref</a> --&gt; <a href="scrguide.pdf#desc:scrjura.option.ref">327</a></li>
+<li><a name="option.refline"></a><a href="#option.refline">refline</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.refline">214</a></li>
<li><a name="option.sectionentrydots"></a><a href="#option.sectionentrydots">sectionentrydots</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.sectionentrydots">79</a></li>
-<li><a name="option.singlespacing"></a><a href="#option.singlespacing">singlespacing</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.singlespacing">443</a></li>
-<li><a name="option.subject"></a><a href="#option.subject">subject</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.subject">212</a></li>
-<li><a name="option.symbolicnames"></a><a href="#option.symbolicnames">symbolicnames</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.symbolicnames">195</a></li>
-<li><a name="option.titlepage"></a><a href="#option.titlepage">titlepage</a> --&gt; <a href="scrguide.pdf#desc:scrextend.option.titlepage">296</a>, <a href="scrguide.pdf#desc:maincls.option.titlepage">68</a></li>
+<li><a name="option.singlespacing"></a><a href="#option.singlespacing">singlespacing</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.option.singlespacing">448</a></li>
+<li><a name="option.subject"></a><a href="#option.subject">subject</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.subject">218</a></li>
+<li><a name="option.symbolicnames"></a><a href="#option.symbolicnames">symbolicnames</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.symbolicnames">201</a></li>
+<li><a name="option.titlepage"></a><a href="#option.titlepage">titlepage</a> --&gt; <a href="scrguide.pdf#desc:scrextend.option.titlepage">300</a>, <a href="scrguide.pdf#desc:maincls.option.titlepage">68</a></li>
<li><a name="option.toc"></a><a href="#option.toc">toc</a> --&gt; <a href="scrguide.pdf#desc:maincls.option.toc">76</a></li>
<li><a name="option.twocolumn"></a><a href="#option.twocolumn">twocolumn</a> --&gt; <a href="scrguide.pdf#desc:typearea.option.twocolumn">43</a></li>
<li><a name="option.twoside"></a><a href="#option.twoside">twoside</a> --&gt; <a href="scrguide.pdf#desc:typearea.option.twoside">42</a></li>
-<li><a name="option.usegeometry"></a><a href="#option.usegeometry">usegeometry</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.option.usegeometry">484</a></li>
-<li><a name="option.version"></a><a href="#option.version">version</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.version">167</a>, <a href="scrguide.pdf#desc:scrextend.option.version">291</a>, <a href="scrguide.pdf#desc:typearea.option.version">33</a>, <a href="scrguide.pdf#desc:maincls.option.version">58</a></li>
+<li><a name="option.usegeometry"></a><a href="#option.usegeometry">usegeometry</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.option.usegeometry">488</a></li>
+<li><a name="option.version"></a><a href="#option.version">version</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.option.version">172</a>, <a href="scrguide.pdf#desc:scrextend.option.version">295</a>, <a href="scrguide.pdf#desc:typearea.option.version">33</a>, <a href="scrguide.pdf#desc:maincls.option.version">58</a></li>
</ul>
<h2><a name="macro">Anweisungen</a></h2>
<ul>
-<li><a name="cmd.@addtoplength"></a><a href="#cmd.@addtoplength">\@addtoplength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.@addtoplength">519</a></li>
-<li><a name="cmd.@fontsizefilebase"></a><a href="#cmd.@fontsizefilebase">\@fontsizefilebase</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.@fontsizefilebase">491</a></li>
-<li><a name="cmd.@mkboth"></a><a href="#cmd.@mkboth">\@mkboth</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.@mkboth">454</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.@mkboth">460</a></li>
-<li><a name="cmd.@mkdouble"></a><a href="#cmd.@mkdouble">\@mkdouble</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.@mkdouble">454</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.@mkdouble">460</a></li>
-<li><a name="cmd.@mkleft"></a><a href="#cmd.@mkleft">\@mkleft</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.@mkleft">454</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.@mkleft">460</a></li>
-<li><a name="cmd.@mkright"></a><a href="#cmd.@mkright">\@mkright</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.@mkright">454</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.@mkright">460</a></li>
-<li><a name="cmd.@newplength"></a><a href="#cmd.@newplength">\@newplength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.@newplength">519</a></li>
-<li><a name="cmd.@openbib@code"></a><a href="#cmd.@openbib@code">\@openbib@code</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.@openbib@code">512</a></li>
-<li><a name="cmd.@setplength"></a><a href="#cmd.@setplength">\@setplength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.@setplength">519</a></li>
-<li><a name="cmd.AddLayersAtBeginOfPageStyle"></a><a href="#cmd.AddLayersAtBeginOfPageStyle">\AddLayersAtBeginOfPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.AddLayersAtBeginOfPageStyle">444</a></li>
-<li><a name="cmd.AddLayersAtEndOfPageStyle"></a><a href="#cmd.AddLayersAtEndOfPageStyle">\AddLayersAtEndOfPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.AddLayersAtEndOfPageStyle">444</a></li>
-<li><a name="cmd.AddLayersToPageStyle"></a><a href="#cmd.AddLayersToPageStyle">\AddLayersToPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.AddLayersToPageStyle">444</a></li>
-<li><a name="cmd.AddLayersToPageStyleAfterLayer"></a><a href="#cmd.AddLayersToPageStyleAfterLayer">\AddLayersToPageStyleAfterLayer</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.AddLayersToPageStyleAfterLayer">445</a></li>
-<li><a name="cmd.AddLayersToPageStyleBeforeLayer"></a><a href="#cmd.AddLayersToPageStyleBeforeLayer">\AddLayersToPageStyleBeforeLayer</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.AddLayersToPageStyleBeforeLayer">445</a></li>
-<li><a name="cmd.AddToLayerPageStyleOptions"></a><a href="#cmd.AddToLayerPageStyleOptions">\AddToLayerPageStyleOptions</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.AddToLayerPageStyleOptions">445</a></li>
-<li><a name="cmd.Address"></a><a href="#cmd.Address">\Address</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.Address">285</a></li>
-<li><a name="cmd.AfterAtEndOfClass"></a><a href="#cmd.AfterAtEndOfClass">\AfterAtEndOfClass</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterAtEndOfClass">364</a></li>
-<li><a name="cmd.AfterAtEndOfPackage"></a><a href="#cmd.AfterAtEndOfPackage">\AfterAtEndOfPackage</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterAtEndOfPackage">364</a></li>
-<li><a name="cmd.AfterBibliographyPreamble"></a><a href="#cmd.AfterBibliographyPreamble">\AfterBibliographyPreamble</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.AfterBibliographyPreamble">156</a></li>
-<li><a name="cmd.AfterCalculatingTypearea*"></a><a href="#cmd.AfterCalculatingTypearea*">\AfterCalculatingTypearea*</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.AfterCalculatingTypearea*">487</a></li>
-<li><a name="cmd.AfterCalculatingTypearea"></a><a href="#cmd.AfterCalculatingTypearea">\AfterCalculatingTypearea</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.AfterCalculatingTypearea">487</a></li>
-<li><a name="cmd.AfterClass!"></a><a href="#cmd.AfterClass!">\AfterClass!</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterClass!">364</a></li>
-<li><a name="cmd.AfterClass*"></a><a href="#cmd.AfterClass*">\AfterClass*</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterClass*">364</a></li>
-<li><a name="cmd.AfterClass+"></a><a href="#cmd.AfterClass+">\AfterClass+</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterClass+">364</a></li>
-<li><a name="cmd.AfterClass"></a><a href="#cmd.AfterClass">\AfterClass</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterClass">364</a></li>
-<li><a name="cmd.AfterFile"></a><a href="#cmd.AfterFile">\AfterFile</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterFile">363</a></li>
-<li><a name="cmd.AfterPackage!"></a><a href="#cmd.AfterPackage!">\AfterPackage!</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterPackage!">364</a></li>
-<li><a name="cmd.AfterPackage*"></a><a href="#cmd.AfterPackage*">\AfterPackage*</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterPackage*">364</a></li>
-<li><a name="cmd.AfterPackage+"></a><a href="#cmd.AfterPackage+">\AfterPackage+</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterPackage+">364</a></li>
-<li><a name="cmd.AfterPackage"></a><a href="#cmd.AfterPackage">\AfterPackage</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterPackage">364</a></li>
-<li><a name="cmd.AfterReadingMainAux"></a><a href="#cmd.AfterReadingMainAux">\AfterReadingMainAux</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterReadingMainAux">366</a></li>
-<li><a name="cmd.AfterRestoreareas*"></a><a href="#cmd.AfterRestoreareas*">\AfterRestoreareas*</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.AfterRestoreareas*">486</a></li>
-<li><a name="cmd.AfterRestoreareas"></a><a href="#cmd.AfterRestoreareas">\AfterRestoreareas</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.AfterRestoreareas">486</a></li>
-<li><a name="cmd.AfterSelectAnyPageStyle"></a><a href="#cmd.AfterSelectAnyPageStyle">\AfterSelectAnyPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.AfterSelectAnyPageStyle">438</a></li>
-<li><a name="cmd.AfterSettingArea*"></a><a href="#cmd.AfterSettingArea*">\AfterSettingArea*</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.AfterSettingArea*">487</a></li>
-<li><a name="cmd.AfterSettingArea"></a><a href="#cmd.AfterSettingArea">\AfterSettingArea</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.AfterSettingArea">487</a></li>
-<li><a name="cmd.AfterStartingTOC"></a><a href="#cmd.AfterStartingTOC">\AfterStartingTOC</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.AfterStartingTOC">385</a></li>
-<li><a name="cmd.AfterTOCHead"></a><a href="#cmd.AfterTOCHead">\AfterTOCHead</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.AfterTOCHead">386</a></li>
-<li><a name="cmd.At@startsection"></a><a href="#cmd.At@startsection">\At@startsection</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.At@startsection">510</a></li>
-<li><a name="cmd.AtAddToTocList"></a><a href="#cmd.AtAddToTocList">\AtAddToTocList</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.AtAddToTocList">380</a></li>
-<li><a name="cmd.AtBeginLetter"></a><a href="#cmd.AtBeginLetter">\AtBeginLetter</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.AtBeginLetter">171</a></li>
-<li><a name="cmd.AtEndBibliography"></a><a href="#cmd.AtEndBibliography">\AtEndBibliography</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.AtEndBibliography">156</a></li>
-<li><a name="cmd.AtEndLetter"></a><a href="#cmd.AtEndLetter">\AtEndLetter</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.AtEndLetter">171</a></li>
-<li><a name="cmd.AtEndOfFamilyOptions*"></a><a href="#cmd.AtEndOfFamilyOptions*">\AtEndOfFamilyOptions*</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.AtEndOfFamilyOptions*">344</a></li>
-<li><a name="cmd.AtEndOfFamilyOptions"></a><a href="#cmd.AtEndOfFamilyOptions">\AtEndOfFamilyOptions</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.AtEndOfFamilyOptions">344</a></li>
-<li><a name="cmd.Before@sect"></a><a href="#cmd.Before@sect">\Before@sect</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.Before@sect">510</a></li>
-<li><a name="cmd.Before@ssect"></a><a href="#cmd.Before@ssect">\Before@ssect</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.Before@ssect">510</a></li>
-<li><a name="cmd.BeforeClass"></a><a href="#cmd.BeforeClass">\BeforeClass</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.BeforeClass">364</a></li>
-<li><a name="cmd.BeforeClosingMainAux"></a><a href="#cmd.BeforeClosingMainAux">\BeforeClosingMainAux</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.BeforeClosingMainAux">366</a></li>
-<li><a name="cmd.BeforeFamilyProcessOptions"></a><a href="#cmd.BeforeFamilyProcessOptions">\BeforeFamilyProcessOptions</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.BeforeFamilyProcessOptions">341</a></li>
-<li><a name="cmd.BeforeFile"></a><a href="#cmd.BeforeFile">\BeforeFile</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.BeforeFile">363</a></li>
-<li><a name="cmd.BeforePackage"></a><a href="#cmd.BeforePackage">\BeforePackage</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.BeforePackage">364</a></li>
-<li><a name="cmd.BeforeRestoreareas*"></a><a href="#cmd.BeforeRestoreareas*">\BeforeRestoreareas*</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.BeforeRestoreareas*">486</a></li>
-<li><a name="cmd.BeforeRestoreareas"></a><a href="#cmd.BeforeRestoreareas">\BeforeRestoreareas</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.BeforeRestoreareas">486</a></li>
-<li><a name="cmd.BeforeSelectAnyPageStyle"></a><a href="#cmd.BeforeSelectAnyPageStyle">\BeforeSelectAnyPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.BeforeSelectAnyPageStyle">438</a></li>
-<li><a name="cmd.BeforeStartingTOC"></a><a href="#cmd.BeforeStartingTOC">\BeforeStartingTOC</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.BeforeStartingTOC">385</a></li>
-<li><a name="cmd.BeforeTOCHead"></a><a href="#cmd.BeforeTOCHead">\BeforeTOCHead</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.BeforeTOCHead">386</a></li>
-<li><a name="cmd.BreakBibliography"></a><a href="#cmd.BreakBibliography">\BreakBibliography</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.BreakBibliography">156</a></li>
-<li><a name="cmd.CenturyPart"></a><a href="#cmd.CenturyPart">\CenturyPart</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.CenturyPart">277</a></li>
-<li><a name="cmd.ClassInfoNoLine"></a><a href="#cmd.ClassInfoNoLine">\ClassInfoNoLine</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ClassInfoNoLine">360</a></li>
-<li><a name="cmd.ClassName"></a><a href="#cmd.ClassName">\ClassName</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.ClassName">488</a></li>
-<li><a name="cmd.Clause"></a><a href="#cmd.Clause">\Clause</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.Clause">317</a></li>
-<li><a name="cmd.Clauseformat"></a><a href="#cmd.Clauseformat">\Clauseformat</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.Clauseformat">319</a></li>
-<li><a name="cmd.CloneTOCEntryStyle"></a><a href="#cmd.CloneTOCEntryStyle">\CloneTOCEntryStyle</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.CloneTOCEntryStyle">401</a></li>
-<li><a name="cmd.Comment"></a><a href="#cmd.Comment">\Comment</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.Comment">285</a></li>
-<li><a name="cmd.DayName"></a><a href="#cmd.DayName">\DayName</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.DayName">278</a></li>
-<li><a name="cmd.DayNameByNumber"></a><a href="#cmd.DayNameByNumber">\DayNameByNumber</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.DayNameByNumber">278</a></li>
-<li><a name="cmd.DayNumber"></a><a href="#cmd.DayNumber">\DayNumber</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.DayNumber">277</a></li>
-<li><a name="cmd.DecadePart"></a><a href="#cmd.DecadePart">\DecadePart</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.DecadePart">277</a></li>
-<li><a name="cmd.DeclareLayer"></a><a href="#cmd.DeclareLayer">\DeclareLayer</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DeclareLayer">425</a></li>
-<li><a name="cmd.DeclareNewJuraEnvironment"></a><a href="#cmd.DeclareNewJuraEnvironment">\DeclareNewJuraEnvironment</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.DeclareNewJuraEnvironment">326</a></li>
-<li><a name="cmd.DeclareNewLayer"></a><a href="#cmd.DeclareNewLayer">\DeclareNewLayer</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DeclareNewLayer">425</a></li>
-<li><a name="cmd.DeclareNewNoteColumn"></a><a href="#cmd.DeclareNewNoteColumn">\DeclareNewNoteColumn</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.DeclareNewNoteColumn">473</a></li>
-<li><a name="cmd.DeclareNewPageStyleAlias"></a><a href="#cmd.DeclareNewPageStyleAlias">\DeclareNewPageStyleAlias</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DeclareNewPageStyleAlias">438</a></li>
-<li><a name="cmd.DeclareNewPageStyleByLayers"></a><a href="#cmd.DeclareNewPageStyleByLayers">\DeclareNewPageStyleByLayers</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DeclareNewPageStyleByLayers">439</a></li>
-<li><a name="cmd.DeclareNewSectionCommand"></a><a href="#cmd.DeclareNewSectionCommand">\DeclareNewSectionCommand</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.DeclareNewSectionCommand">493</a></li>
-<li><a name="cmd.DeclareNewSectionCommands"></a><a href="#cmd.DeclareNewSectionCommands">\DeclareNewSectionCommands</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.DeclareNewSectionCommands">503</a></li>
-<li><a name="cmd.DeclareNewTOC"></a><a href="#cmd.DeclareNewTOC">\DeclareNewTOC</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DeclareNewTOC">408</a></li>
-<li><a name="cmd.DeclareNoteColumn"></a><a href="#cmd.DeclareNoteColumn">\DeclareNoteColumn</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.DeclareNoteColumn">473</a></li>
-<li><a name="cmd.DeclarePageStyleAlias"></a><a href="#cmd.DeclarePageStyleAlias">\DeclarePageStyleAlias</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DeclarePageStyleAlias">438</a></li>
-<li><a name="cmd.DeclarePageStyleByLayers"></a><a href="#cmd.DeclarePageStyleByLayers">\DeclarePageStyleByLayers</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DeclarePageStyleByLayers">439</a></li>
-<li><a name="cmd.DeclareSectionCommand"></a><a href="#cmd.DeclareSectionCommand">\DeclareSectionCommand</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.DeclareSectionCommand">493</a></li>
-<li><a name="cmd.DeclareSectionCommands"></a><a href="#cmd.DeclareSectionCommands">\DeclareSectionCommands</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.DeclareSectionCommands">503</a></li>
-<li><a name="cmd.DeclareSectionNumberDepth"></a><a href="#cmd.DeclareSectionNumberDepth">\DeclareSectionNumberDepth</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DeclareSectionNumberDepth">423</a></li>
-<li><a name="cmd.DeclareTOCEntryStyle"></a><a href="#cmd.DeclareTOCEntryStyle">\DeclareTOCEntryStyle</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DeclareTOCEntryStyle">399</a></li>
-<li><a name="cmd.DeclareTOCStyleEntry"></a><a href="#cmd.DeclareTOCStyleEntry">\DeclareTOCStyleEntry</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DeclareTOCStyleEntry">391</a></li>
-<li><a name="cmd.DefineFamily"></a><a href="#cmd.DefineFamily">\DefineFamily</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.DefineFamily">337</a></li>
-<li><a name="cmd.DefineFamilyKey"></a><a href="#cmd.DefineFamilyKey">\DefineFamilyKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.DefineFamilyKey">338</a></li>
-<li><a name="cmd.DefineFamilyMember"></a><a href="#cmd.DefineFamilyMember">\DefineFamilyMember</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.DefineFamilyMember">337</a></li>
-<li><a name="cmd.DefineTOCEntryBooleanOption"></a><a href="#cmd.DefineTOCEntryBooleanOption">\DefineTOCEntryBooleanOption</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DefineTOCEntryBooleanOption">399</a></li>
-<li><a name="cmd.DefineTOCEntryCommandOption"></a><a href="#cmd.DefineTOCEntryCommandOption">\DefineTOCEntryCommandOption</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DefineTOCEntryCommandOption">399</a></li>
-<li><a name="cmd.DefineTOCEntryIfOption"></a><a href="#cmd.DefineTOCEntryIfOption">\DefineTOCEntryIfOption</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DefineTOCEntryIfOption">399</a></li>
-<li><a name="cmd.DefineTOCEntryLengthOption"></a><a href="#cmd.DefineTOCEntryLengthOption">\DefineTOCEntryLengthOption</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DefineTOCEntryLengthOption">399</a></li>
-<li><a name="cmd.DefineTOCEntryNumberOption"></a><a href="#cmd.DefineTOCEntryNumberOption">\DefineTOCEntryNumberOption</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DefineTOCEntryNumberOption">399</a></li>
-<li><a name="cmd.DefineTOCEntryOption"></a><a href="#cmd.DefineTOCEntryOption">\DefineTOCEntryOption</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DefineTOCEntryOption">399</a></li>
-<li><a name="cmd.DestroyLayer"></a><a href="#cmd.DestroyLayer">\DestroyLayer</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DestroyLayer">436</a></li>
-<li><a name="cmd.DestroyPageStyleAlias"></a><a href="#cmd.DestroyPageStyleAlias">\DestroyPageStyleAlias</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DestroyPageStyleAlias">439</a></li>
-<li><a name="cmd.DestroyRealLayerPageStyle"></a><a href="#cmd.DestroyRealLayerPageStyle">\DestroyRealLayerPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DestroyRealLayerPageStyle">446</a></li>
-<li><a name="cmd.FamilyBoolKey"></a><a href="#cmd.FamilyBoolKey">\FamilyBoolKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyBoolKey">344</a></li>
-<li><a name="cmd.FamilyCounterKey"></a><a href="#cmd.FamilyCounterKey">\FamilyCounterKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyCounterKey">348</a></li>
-<li><a name="cmd.FamilyCounterMacroKey"></a><a href="#cmd.FamilyCounterMacroKey">\FamilyCounterMacroKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyCounterMacroKey">348</a></li>
-<li><a name="cmd.FamilyElseValues"></a><a href="#cmd.FamilyElseValues">\FamilyElseValues</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyElseValues">350</a></li>
-<li><a name="cmd.FamilyExecuteOptions"></a><a href="#cmd.FamilyExecuteOptions">\FamilyExecuteOptions</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyExecuteOptions">341</a></li>
-<li><a name="cmd.FamilyKeyState"></a><a href="#cmd.FamilyKeyState">\FamilyKeyState</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyKeyState">338</a></li>
-<li><a name="cmd.FamilyKeyStateNeedValue"></a><a href="#cmd.FamilyKeyStateNeedValue">\FamilyKeyStateNeedValue</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyKeyStateNeedValue">338</a></li>
-<li><a name="cmd.FamilyKeyStateProcessed"></a><a href="#cmd.FamilyKeyStateProcessed">\FamilyKeyStateProcessed</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyKeyStateProcessed">338</a></li>
-<li><a name="cmd.FamilyKeyStateUnknown"></a><a href="#cmd.FamilyKeyStateUnknown">\FamilyKeyStateUnknown</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyKeyStateUnknown">338</a></li>
-<li><a name="cmd.FamilyKeyStateUnknownValue"></a><a href="#cmd.FamilyKeyStateUnknownValue">\FamilyKeyStateUnknownValue</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyKeyStateUnknownValue">338</a></li>
-<li><a name="cmd.FamilyLengthKey"></a><a href="#cmd.FamilyLengthKey">\FamilyLengthKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyLengthKey">348</a></li>
-<li><a name="cmd.FamilyLengthMacroKey"></a><a href="#cmd.FamilyLengthMacroKey">\FamilyLengthMacroKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyLengthMacroKey">348</a></li>
-<li><a name="cmd.FamilyNumericalKey"></a><a href="#cmd.FamilyNumericalKey">\FamilyNumericalKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyNumericalKey">346</a></li>
-<li><a name="cmd.FamilyOption"></a><a href="#cmd.FamilyOption">\FamilyOption</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyOption">343</a></li>
-<li><a name="cmd.FamilyOptions"></a><a href="#cmd.FamilyOptions">\FamilyOptions</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyOptions">342</a></li>
-<li><a name="cmd.FamilyProcessOptions"></a><a href="#cmd.FamilyProcessOptions">\FamilyProcessOptions</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyProcessOptions">340</a></li>
-<li><a name="cmd.FamilySetBool"></a><a href="#cmd.FamilySetBool">\FamilySetBool</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilySetBool">344</a></li>
-<li><a name="cmd.FamilySetCounter"></a><a href="#cmd.FamilySetCounter">\FamilySetCounter</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilySetCounter">348</a></li>
-<li><a name="cmd.FamilySetCounterMacro"></a><a href="#cmd.FamilySetCounterMacro">\FamilySetCounterMacro</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilySetCounterMacro">348</a></li>
-<li><a name="cmd.FamilySetLength"></a><a href="#cmd.FamilySetLength">\FamilySetLength</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilySetLength">348</a></li>
-<li><a name="cmd.FamilySetLengthMacro"></a><a href="#cmd.FamilySetLengthMacro">\FamilySetLengthMacro</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilySetLengthMacro">348</a></li>
-<li><a name="cmd.FamilySetNumerical"></a><a href="#cmd.FamilySetNumerical">\FamilySetNumerical</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilySetNumerical">346</a></li>
-<li><a name="cmd.FamilyStringKey"></a><a href="#cmd.FamilyStringKey">\FamilyStringKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyStringKey">349</a></li>
-<li><a name="cmd.FamilyUnknownKeyValue"></a><a href="#cmd.FamilyUnknownKeyValue">\FamilyUnknownKeyValue</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyUnknownKeyValue">349</a></li>
-<li><a name="cmd.FirstName"></a><a href="#cmd.FirstName">\FirstName</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.FirstName">285</a></li>
-<li><a name="cmd.ForEachLayerOfPageStyle*"></a><a href="#cmd.ForEachLayerOfPageStyle*">\ForEachLayerOfPageStyle*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.ForEachLayerOfPageStyle*">443</a></li>
-<li><a name="cmd.ForEachLayerOfPageStyle"></a><a href="#cmd.ForEachLayerOfPageStyle">\ForEachLayerOfPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.ForEachLayerOfPageStyle">443</a></li>
-<li><a name="cmd.FreeI"></a><a href="#cmd.FreeI">\FreeI</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.FreeI">285</a></li>
-<li><a name="cmd.FreeII"></a><a href="#cmd.FreeII">\FreeII</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.FreeII">285</a></li>
-<li><a name="cmd.FreeIII"></a><a href="#cmd.FreeIII">\FreeIII</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.FreeIII">285</a></li>
-<li><a name="cmd.FreeIV"></a><a href="#cmd.FreeIV">\FreeIV</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.FreeIV">285</a></li>
-<li><a name="cmd.GenericMarkFormat"></a><a href="#cmd.GenericMarkFormat">\GenericMarkFormat</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.GenericMarkFormat">452</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.GenericMarkFormat">457</a></li>
-<li><a name="cmd.GetLayerContents"></a><a href="#cmd.GetLayerContents">\GetLayerContents</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.GetLayerContents">435</a></li>
-<li><a name="cmd.GetRealPageStyle"></a><a href="#cmd.GetRealPageStyle">\GetRealPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.GetRealPageStyle">439</a></li>
-<li><a name="cmd.ISODayName"></a><a href="#cmd.ISODayName">\ISODayName</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.ISODayName">278</a></li>
-<li><a name="cmd.ISODayNumber"></a><a href="#cmd.ISODayNumber">\ISODayNumber</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.ISODayNumber">277</a></li>
-<li><a name="cmd.ISOToday"></a><a href="#cmd.ISOToday">\ISOToday</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.ISOToday">279</a></li>
-<li><a name="cmd.IfChapterUsesPrefixLine"></a><a href="#cmd.IfChapterUsesPrefixLine">\IfChapterUsesPrefixLine</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.IfChapterUsesPrefixLine">100</a></li>
-<li><a name="cmd.IfExistskomafont"></a><a href="#cmd.IfExistskomafont">\IfExistskomafont</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.IfExistskomafont">492</a></li>
-<li><a name="cmd.IfLayerAtPageStyle"></a><a href="#cmd.IfLayerAtPageStyle">\IfLayerAtPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.IfLayerAtPageStyle">446</a></li>
-<li><a name="cmd.IfLayerExists"></a><a href="#cmd.IfLayerExists">\IfLayerExists</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.IfLayerExists">435</a></li>
-<li><a name="cmd.IfLayerPageStyleExists"></a><a href="#cmd.IfLayerPageStyleExists">\IfLayerPageStyleExists</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.IfLayerPageStyleExists">446</a></li>
-<li><a name="cmd.IfLayersAtPageStyle"></a><a href="#cmd.IfLayersAtPageStyle">\IfLayersAtPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.IfLayersAtPageStyle">446</a></li>
-<li><a name="cmd.IfRealLayerPageStyleExists"></a><a href="#cmd.IfRealLayerPageStyleExists">\IfRealLayerPageStyleExists</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.IfRealLayerPageStyleExists">446</a></li>
-<li><a name="cmd.IfSomeLayersAtPageStyle"></a><a href="#cmd.IfSomeLayersAtPageStyle">\IfSomeLayersAtPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.IfSomeLayersAtPageStyle">446</a></li>
-<li><a name="cmd.IfUsePrefixLine"></a><a href="#cmd.IfUsePrefixLine">\IfUsePrefixLine</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.IfUsePrefixLine">115</a></li>
-<li><a name="cmd.InputAddressFile"></a><a href="#cmd.InputAddressFile">\InputAddressFile</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.InputAddressFile">284</a></li>
-<li><a name="cmd.IsoToday"></a><a href="#cmd.IsoToday">\IsoToday</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.IsoToday">279</a></li>
-<li><a name="cmd.KOMAClassName"></a><a href="#cmd.KOMAClassName">\KOMAClassName</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.KOMAClassName">488</a></li>
-<li><a name="cmd.KOMAScript"></a><a href="#cmd.KOMAScript">\KOMAScript</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.KOMAScript">359</a></li>
-<li><a name="cmd.KOMAScriptVersion"></a><a href="#cmd.KOMAScriptVersion">\KOMAScriptVersion</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.KOMAScriptVersion">359</a></li>
-<li><a name="cmd.KOMAoption"></a><a href="#cmd.KOMAoption">\KOMAoption</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.KOMAoption">166</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.KOMAoption">248</a>, <a href="scrguide.pdf#desc:scrextend.cmd.KOMAoption">290</a>, <a href="scrguide.pdf#desc:scrjura.cmd.KOMAoption">314</a>, <a href="scrguide.pdf#desc:typearea.cmd.KOMAoption">32</a>, <a href="scrguide.pdf#desc:scrhack.cmd.KOMAoption">416</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.KOMAoption">421</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.KOMAoption">471</a>, <a href="scrguide.pdf#desc:maincls.cmd.KOMAoption">57</a></li>
-<li><a name="cmd.KOMAoptions"></a><a href="#cmd.KOMAoptions">\KOMAoptions</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.KOMAoptions">166</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.KOMAoptions">248</a>, <a href="scrguide.pdf#desc:scrextend.cmd.KOMAoptions">290</a>, <a href="scrguide.pdf#desc:scrjura.cmd.KOMAoptions">314</a>, <a href="scrguide.pdf#desc:typearea.cmd.KOMAoptions">32</a>, <a href="scrguide.pdf#desc:scrhack.cmd.KOMAoptions">416</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.KOMAoptions">421</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.KOMAoptions">471</a>, <a href="scrguide.pdf#desc:maincls.cmd.KOMAoptions">57</a></li>
-<li><a name="cmd.LastName"></a><a href="#cmd.LastName">\LastName</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.LastName">285</a></li>
-<li><a name="cmd.LastTOCLevelWasHigher"></a><a href="#cmd.LastTOCLevelWasHigher">\LastTOCLevelWasHigher</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.LastTOCLevelWasHigher">402</a></li>
-<li><a name="cmd.LastTOCLevelWasLower"></a><a href="#cmd.LastTOCLevelWasLower">\LastTOCLevelWasLower</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.LastTOCLevelWasLower">402</a></li>
-<li><a name="cmd.LastTOCLevelWasSame"></a><a href="#cmd.LastTOCLevelWasSame">\LastTOCLevelWasSame</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.LastTOCLevelWasSame">402</a></li>
-<li><a name="cmd.LenToUnit"></a><a href="#cmd.LenToUnit">\LenToUnit</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.LenToUnit">434</a></li>
-<li><a name="cmd.LetterOptionNeedsPapersize"></a><a href="#cmd.LetterOptionNeedsPapersize">\LetterOptionNeedsPapersize</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.LetterOptionNeedsPapersize">534</a></li>
-<li><a name="cmd.MakeMarkcase"></a><a href="#cmd.MakeMarkcase">\MakeMarkcase</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.MakeMarkcase">267</a>, <a href="scrguide.pdf#desc:tocbasic.cmd.MakeMarkcase">386</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.MakeMarkcase">449</a></li>
-<li><a name="cmd.ModifyLayer"></a><a href="#cmd.ModifyLayer">\ModifyLayer</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.ModifyLayer">425</a></li>
-<li><a name="cmd.ModifyLayerPageStyleOptions"></a><a href="#cmd.ModifyLayerPageStyleOptions">\ModifyLayerPageStyleOptions</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.ModifyLayerPageStyleOptions">445</a></li>
-<li><a name="cmd.Name"></a><a href="#cmd.Name">\Name</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.Name">285</a></li>
-<li><a name="cmd.PackageInfoNoLine"></a><a href="#cmd.PackageInfoNoLine">\PackageInfoNoLine</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.PackageInfoNoLine">360</a></li>
-<li><a name="cmd.PreventPackageFromLoading*"></a><a href="#cmd.PreventPackageFromLoading*">\PreventPackageFromLoading*</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.PreventPackageFromLoading*">371</a></li>
-<li><a name="cmd.PreventPackageFromLoading"></a><a href="#cmd.PreventPackageFromLoading">\PreventPackageFromLoading</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.PreventPackageFromLoading">371</a></li>
-<li><a name="cmd.ProvideLayer"></a><a href="#cmd.ProvideLayer">\ProvideLayer</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.ProvideLayer">425</a></li>
-<li><a name="cmd.ProvideNoteColumn"></a><a href="#cmd.ProvideNoteColumn">\ProvideNoteColumn</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.ProvideNoteColumn">473</a></li>
-<li><a name="cmd.ProvidePageStyleAlias"></a><a href="#cmd.ProvidePageStyleAlias">\ProvidePageStyleAlias</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.ProvidePageStyleAlias">438</a></li>
-<li><a name="cmd.ProvidePageStyleByLayers"></a><a href="#cmd.ProvidePageStyleByLayers">\ProvidePageStyleByLayers</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.ProvidePageStyleByLayers">439</a></li>
-<li><a name="cmd.ProvideSectionCommand"></a><a href="#cmd.ProvideSectionCommand">\ProvideSectionCommand</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.ProvideSectionCommand">493</a></li>
-<li><a name="cmd.ProvideSectionCommands"></a><a href="#cmd.ProvideSectionCommands">\ProvideSectionCommands</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.ProvideSectionCommands">503</a></li>
-<li><a name="cmd.RedeclareLayer"></a><a href="#cmd.RedeclareLayer">\RedeclareLayer</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.RedeclareLayer">425</a></li>
-<li><a name="cmd.RedeclareNoteColumn"></a><a href="#cmd.RedeclareNoteColumn">\RedeclareNoteColumn</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.RedeclareNoteColumn">473</a></li>
-<li><a name="cmd.RedeclarePageStyleAlias"></a><a href="#cmd.RedeclarePageStyleAlias">\RedeclarePageStyleAlias</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.RedeclarePageStyleAlias">438</a></li>
-<li><a name="cmd.RedeclarePageStyleByLayers"></a><a href="#cmd.RedeclarePageStyleByLayers">\RedeclarePageStyleByLayers</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.RedeclarePageStyleByLayers">439</a></li>
-<li><a name="cmd.RedeclareSectionCommand"></a><a href="#cmd.RedeclareSectionCommand">\RedeclareSectionCommand</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.RedeclareSectionCommand">493</a></li>
-<li><a name="cmd.RedeclareSectionCommands"></a><a href="#cmd.RedeclareSectionCommands">\RedeclareSectionCommands</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.RedeclareSectionCommands">503</a></li>
-<li><a name="cmd.RelaxFamilyKey"></a><a href="#cmd.RelaxFamilyKey">\RelaxFamilyKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.RelaxFamilyKey">340</a></li>
-<li><a name="cmd.RemoveLayersFromPageStyle"></a><a href="#cmd.RemoveLayersFromPageStyle">\RemoveLayersFromPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.RemoveLayersFromPageStyle">444</a></li>
-<li><a name="cmd.ReplaceClass"></a><a href="#cmd.ReplaceClass">\ReplaceClass</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.ReplaceClass">369</a></li>
-<li><a name="cmd.ReplaceInput"></a><a href="#cmd.ReplaceInput">\ReplaceInput</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.ReplaceInput">368</a></li>
-<li><a name="cmd.ReplacePackage"></a><a href="#cmd.ReplacePackage">\ReplacePackage</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.ReplacePackage">369</a></li>
-<li><a name="cmd.ResetPreventPackageFromLoading"></a><a href="#cmd.ResetPreventPackageFromLoading">\ResetPreventPackageFromLoading</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.ResetPreventPackageFromLoading">372</a></li>
-<li><a name="cmd.SecDef"></a><a href="#cmd.SecDef">\SecDef</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.SecDef">510</a></li>
-<li><a name="cmd.Sentence"></a><a href="#cmd.Sentence">\Sentence</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.Sentence">323</a></li>
-<li><a name="cmd.StorePreventPackageFromLoading"></a><a href="#cmd.StorePreventPackageFromLoading">\StorePreventPackageFromLoading</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.StorePreventPackageFromLoading">372</a></li>
-<li><a name="cmd.SubClause"></a><a href="#cmd.SubClause">\SubClause</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.SubClause">317</a></li>
-<li><a name="cmd.TOCEntryStyleInitCode"></a><a href="#cmd.TOCEntryStyleInitCode">\TOCEntryStyleInitCode</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.TOCEntryStyleInitCode">401</a></li>
-<li><a name="cmd.TOCEntryStyleStartInitCode"></a><a href="#cmd.TOCEntryStyleStartInitCode">\TOCEntryStyleStartInitCode</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.TOCEntryStyleStartInitCode">401</a></li>
-<li><a name="cmd.TOCLineLeaderFill"></a><a href="#cmd.TOCLineLeaderFill">\TOCLineLeaderFill</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.TOCLineLeaderFill">402</a></li>
-<li><a name="cmd.TOCclone"></a><a href="#cmd.TOCclone">\TOCclone</a> --&gt; <a href="scrguide.pdf#desc:scrwfile.cmd.TOCclone">375</a></li>
-<li><a name="cmd.Telephone"></a><a href="#cmd.Telephone">\Telephone</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.Telephone">285</a></li>
-<li><a name="cmd.UnPreventPackageFromLoading*"></a><a href="#cmd.UnPreventPackageFromLoading*">\UnPreventPackageFromLoading*</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.UnPreventPackageFromLoading*">373</a></li>
-<li><a name="cmd.UnPreventPackageFromLoading"></a><a href="#cmd.UnPreventPackageFromLoading">\UnPreventPackageFromLoading</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.UnPreventPackageFromLoading">373</a></li>
-<li><a name="cmd.UnReplaceClass"></a><a href="#cmd.UnReplaceClass">\UnReplaceClass</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.UnReplaceClass">371</a></li>
-<li><a name="cmd.UnReplaceInput"></a><a href="#cmd.UnReplaceInput">\UnReplaceInput</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.UnReplaceInput">371</a></li>
-<li><a name="cmd.UnReplacePackage"></a><a href="#cmd.UnReplacePackage">\UnReplacePackage</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.UnReplacePackage">371</a></li>
-<li><a name="cmd.UnifyLayersAtPageStyle"></a><a href="#cmd.UnifyLayersAtPageStyle">\UnifyLayersAtPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.UnifyLayersAtPageStyle">445</a></li>
-<li><a name="cmd.XdivY"></a><a href="#cmd.XdivY">\XdivY</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.XdivY">361</a></li>
-<li><a name="cmd.XmodY"></a><a href="#cmd.XmodY">\XmodY</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.XmodY">361</a></li>
-<li><a name="cmd.activateareas"></a><a href="#cmd.activateareas">\activateareas</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.activateareas">485</a></li>
-<li><a name="cmd.addchap*"></a><a href="#cmd.addchap*">\addchap*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.addchap*">111</a></li>
-<li><a name="cmd.addchap"></a><a href="#cmd.addchap">\addchap</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.addchap">111</a></li>
-<li><a name="cmd.addchapmark"></a><a href="#cmd.addchapmark">\addchapmark</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.addchapmark">117</a></li>
-<li><a name="cmd.addchaptertocentry"></a><a href="#cmd.addchaptertocentry">\addchaptertocentry</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addchaptertocentry">490</a></li>
-<li><a name="cmd.addcontentslinetoeachtocfile"></a><a href="#cmd.addcontentslinetoeachtocfile">\addcontentslinetoeachtocfile</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.addcontentslinetoeachtocfile">383</a></li>
-<li><a name="cmd.addparagraphtocentry"></a><a href="#cmd.addparagraphtocentry">\addparagraphtocentry</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addparagraphtocentry">490</a></li>
-<li><a name="cmd.addpart*"></a><a href="#cmd.addpart*">\addpart*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.addpart*">111</a></li>
-<li><a name="cmd.addpart"></a><a href="#cmd.addpart">\addpart</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.addpart">111</a></li>
-<li><a name="cmd.addparttocentry"></a><a href="#cmd.addparttocentry">\addparttocentry</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addparttocentry">490</a></li>
-<li><a name="cmd.addrchar"></a><a href="#cmd.addrchar">\addrchar</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.addrchar">244</a>, <a href="scrguide.pdf#desc:scraddr.cmd.addrchar">284</a></li>
-<li><a name="cmd.addrentry"></a><a href="#cmd.addrentry">\addrentry</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.addrentry">242</a>, <a href="scrguide.pdf#desc:scraddr.cmd.addrentry">284</a></li>
-<li><a name="cmd.addsec*"></a><a href="#cmd.addsec*">\addsec*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.addsec*">111</a></li>
-<li><a name="cmd.addsec"></a><a href="#cmd.addsec">\addsec</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.addsec">111</a></li>
-<li><a name="cmd.addsecmark"></a><a href="#cmd.addsecmark">\addsecmark</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.addsecmark">117</a></li>
-<li><a name="cmd.addsectiontocentry"></a><a href="#cmd.addsectiontocentry">\addsectiontocentry</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addsectiontocentry">490</a></li>
-<li><a name="cmd.addsubparagraphtocentry"></a><a href="#cmd.addsubparagraphtocentry">\addsubparagraphtocentry</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addsubparagraphtocentry">490</a></li>
-<li><a name="cmd.addsubsectiontocentry"></a><a href="#cmd.addsubsectiontocentry">\addsubsectiontocentry</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addsubsectiontocentry">490</a></li>
-<li><a name="cmd.addsubsubsectiontocentry"></a><a href="#cmd.addsubsubsectiontocentry">\addsubsubsectiontocentry</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addsubsubsectiontocentry">490</a></li>
-<li><a name="cmd.addtocentrydefault"></a><a href="#cmd.addtocentrydefault">\addtocentrydefault</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addtocentrydefault">489</a></li>
-<li><a name="cmd.addtoeachtocfile"></a><a href="#cmd.addtoeachtocfile">\addtoeachtocfile</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.addtoeachtocfile">382</a></li>
-<li><a name="cmd.addtokomafont"></a><a href="#cmd.addtokomafont">\addtokomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.addtokomafont">182</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.addtokomafont">250</a>, <a href="scrguide.pdf#desc:scrextend.cmd.addtokomafont">294</a>, <a href="scrguide.pdf#desc:scrjura.cmd.addtokomafont">315</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.addtokomafont">471</a>, <a href="scrguide.pdf#desc:maincls.cmd.addtokomafont">62</a></li>
-<li><a name="cmd.addtokomafontgobblelist"></a><a href="#cmd.addtokomafontgobblelist">\addtokomafontgobblelist</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addtokomafontgobblelist">491</a></li>
-<li><a name="cmd.addtokomafontonearglist"></a><a href="#cmd.addtokomafontonearglist">\addtokomafontonearglist</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addtokomafontonearglist">491</a></li>
-<li><a name="cmd.addtokomafontrelaxlist"></a><a href="#cmd.addtokomafontrelaxlist">\addtokomafontrelaxlist</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addtokomafontrelaxlist">491</a></li>
-<li><a name="cmd.addtolengthplength"></a><a href="#cmd.addtolengthplength">\addtolengthplength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.addtolengthplength">165</a></li>
-<li><a name="cmd.addtoreffields"></a><a href="#cmd.addtoreffields">\addtoreffields</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.addtoreffields">530</a></li>
-<li><a name="cmd.addtotoclist"></a><a href="#cmd.addtotoclist">\addtotoclist</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.addtotoclist">379</a></li>
-<li><a name="cmd.addxcontentsline"></a><a href="#cmd.addxcontentsline">\addxcontentsline</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.addxcontentsline">383</a></li>
-<li><a name="cmd.addxcontentslinetoeachtocfile"></a><a href="#cmd.addxcontentslinetoeachtocfile">\addxcontentslinetoeachtocfile</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.addxcontentslinetoeachtocfile">383</a></li>
-<li><a name="cmd.adrchar"></a><a href="#cmd.adrchar">\adrchar</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.adrchar">244</a>, <a href="scrguide.pdf#desc:scraddr.cmd.adrchar">284</a></li>
-<li><a name="cmd.adrentry"></a><a href="#cmd.adrentry">\adrentry</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.adrentry">242</a>, <a href="scrguide.pdf#desc:scraddr.cmd.adrentry">284</a></li>
-<li><a name="cmd.aliaskomafont"></a><a href="#cmd.aliaskomafont">\aliaskomafont</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.aliaskomafont">491</a></li>
-<li><a name="cmd.and"></a><a href="#cmd.and">\and</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.and">298</a>, <a href="scrguide.pdf#desc:maincls.cmd.and">71</a></li>
-<li><a name="cmd.appendix"></a><a href="#cmd.appendix">\appendix</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.appendix">153</a></li>
-<li><a name="cmd.appendixmore"></a><a href="#cmd.appendixmore">\appendixmore</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.appendixmore">511</a></li>
-<li><a name="cmd.areaset"></a><a href="#cmd.areaset">\areaset</a> --&gt; <a href="scrguide.pdf#desc:typearea.cmd.areaset">48</a>, <a href="scrguide.pdf#desc:typearea-experts.cmd.areaset">485</a></li>
-<li><a name="cmd.author"></a><a href="#cmd.author">\author</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.author">298</a>, <a href="scrguide.pdf#desc:maincls.cmd.author">71</a></li>
-<li><a name="cmd.autodot"></a><a href="#cmd.autodot">\autodot</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.autodot">115</a></li>
-<li><a name="cmd.automark*"></a><a href="#cmd.automark*">\automark*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.automark*">264</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.automark*">448</a></li>
-<li><a name="cmd.automark"></a><a href="#cmd.automark">\automark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.automark">264</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.automark">448</a></li>
-<li><a name="cmd.backmatter"></a><a href="#cmd.backmatter">\backmatter</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.backmatter">98</a></li>
-<li><a name="cmd.bankname"></a><a href="#cmd.bankname">\bankname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.bankname">542</a></li>
-<li><a name="cmd.bib@beginhook"></a><a href="#cmd.bib@beginhook">\bib@beginhook</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.bib@beginhook">512</a></li>
-<li><a name="cmd.bib@endhook"></a><a href="#cmd.bib@endhook">\bib@endhook</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.bib@endhook">512</a></li>
-<li><a name="cmd.caption"></a><a href="#cmd.caption">\caption</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.caption">137</a></li>
-<li><a name="cmd.captionabove"></a><a href="#cmd.captionabove">\captionabove</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.captionabove">137</a></li>
-<li><a name="cmd.captionaboveof"></a><a href="#cmd.captionaboveof">\captionaboveof</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.captionaboveof">139</a></li>
-<li><a name="cmd.captionbelow"></a><a href="#cmd.captionbelow">\captionbelow</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.captionbelow">137</a></li>
-<li><a name="cmd.captionbelowof"></a><a href="#cmd.captionbelowof">\captionbelowof</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.captionbelowof">139</a></li>
-<li><a name="cmd.captionformat"></a><a href="#cmd.captionformat">\captionformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.captionformat">144</a></li>
-<li><a name="cmd.captionof"></a><a href="#cmd.captionof">\captionof</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.captionof">139</a></li>
-<li><a name="cmd.captionsUKenglish"></a><a href="#cmd.captionsUKenglish">\captionsUKenglish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsUKenglish">539</a></li>
-<li><a name="cmd.captionsUSenglish"></a><a href="#cmd.captionsUSenglish">\captionsUSenglish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsUSenglish">539</a></li>
-<li><a name="cmd.captionsacadian"></a><a href="#cmd.captionsacadian">\captionsacadian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsacadian">539</a></li>
-<li><a name="cmd.captionsamerican"></a><a href="#cmd.captionsamerican">\captionsamerican</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsamerican">539</a></li>
-<li><a name="cmd.captionsaustralien"></a><a href="#cmd.captionsaustralien">\captionsaustralien</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsaustralien">539</a></li>
-<li><a name="cmd.captionsaustrian"></a><a href="#cmd.captionsaustrian">\captionsaustrian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsaustrian">539</a></li>
-<li><a name="cmd.captionsbritish"></a><a href="#cmd.captionsbritish">\captionsbritish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsbritish">539</a></li>
-<li><a name="cmd.captionscanadian"></a><a href="#cmd.captionscanadian">\captionscanadian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionscanadian">539</a></li>
-<li><a name="cmd.captionscanadien"></a><a href="#cmd.captionscanadien">\captionscanadien</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionscanadien">539</a></li>
-<li><a name="cmd.captionscroatian"></a><a href="#cmd.captionscroatian">\captionscroatian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionscroatian">539</a></li>
-<li><a name="cmd.captionsczech"></a><a href="#cmd.captionsczech">\captionsczech</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsczech">539</a></li>
-<li><a name="cmd.captionsdutch"></a><a href="#cmd.captionsdutch">\captionsdutch</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsdutch">539</a></li>
-<li><a name="cmd.captionsenglish"></a><a href="#cmd.captionsenglish">\captionsenglish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsenglish">539</a></li>
-<li><a name="cmd.captionsfinnish"></a><a href="#cmd.captionsfinnish">\captionsfinnish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsfinnish">539</a></li>
-<li><a name="cmd.captionsfrancais"></a><a href="#cmd.captionsfrancais">\captionsfrancais</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsfrancais">539</a></li>
-<li><a name="cmd.captionsfrench"></a><a href="#cmd.captionsfrench">\captionsfrench</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsfrench">539</a></li>
-<li><a name="cmd.captionsgerman"></a><a href="#cmd.captionsgerman">\captionsgerman</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsgerman">539</a></li>
-<li><a name="cmd.captionsitalian"></a><a href="#cmd.captionsitalian">\captionsitalian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsitalian">539</a></li>
-<li><a name="cmd.captionsnaustrian"></a><a href="#cmd.captionsnaustrian">\captionsnaustrian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsnaustrian">539</a></li>
-<li><a name="cmd.captionsnewzealand"></a><a href="#cmd.captionsnewzealand">\captionsnewzealand</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsnewzealand">539</a></li>
-<li><a name="cmd.captionsngerman"></a><a href="#cmd.captionsngerman">\captionsngerman</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsngerman">539</a></li>
-<li><a name="cmd.captionsnorsk"></a><a href="#cmd.captionsnorsk">\captionsnorsk</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsnorsk">539</a></li>
-<li><a name="cmd.captionsnswissgerman"></a><a href="#cmd.captionsnswissgerman">\captionsnswissgerman</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsnswissgerman">539</a></li>
-<li><a name="cmd.captionspolish"></a><a href="#cmd.captionspolish">\captionspolish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionspolish">539</a></li>
-<li><a name="cmd.captionsslovak"></a><a href="#cmd.captionsslovak">\captionsslovak</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsslovak">539</a></li>
-<li><a name="cmd.captionsspanish"></a><a href="#cmd.captionsspanish">\captionsspanish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsspanish">539</a></li>
-<li><a name="cmd.captionsswedish"></a><a href="#cmd.captionsswedish">\captionsswedish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsswedish">539</a></li>
-<li><a name="cmd.captionsswissgerman"></a><a href="#cmd.captionsswissgerman">\captionsswissgerman</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsswissgerman">539</a></li>
-<li><a name="cmd.cc"></a><a href="#cmd.cc">\cc</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cc">177</a></li>
-<li><a name="cmd.ccname"></a><a href="#cmd.ccname">\ccname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.ccname">542</a></li>
-<li><a name="cmd.cefoot*"></a><a href="#cmd.cefoot*">\cefoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cefoot*">260</a></li>
-<li><a name="cmd.cefoot"></a><a href="#cmd.cefoot">\cefoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cefoot">257</a></li>
-<li><a name="cmd.cehead*"></a><a href="#cmd.cehead*">\cehead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cehead*">256</a></li>
-<li><a name="cmd.cehead"></a><a href="#cmd.cehead">\cehead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cehead">254</a></li>
-<li><a name="cmd.cfoot*"></a><a href="#cmd.cfoot*">\cfoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cfoot*">262</a></li>
-<li><a name="cmd.cfoot"></a><a href="#cmd.cfoot">\cfoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cfoot">261</a></li>
-<li><a name="cmd.changefontsizes"></a><a href="#cmd.changefontsizes">\changefontsizes</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.changefontsizes">491</a></li>
-<li><a name="cmd.chapapp"></a><a href="#cmd.chapapp">\chapapp</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chapapp">117</a></li>
-<li><a name="cmd.chapappifchapterprefix"></a><a href="#cmd.chapappifchapterprefix">\chapappifchapterprefix</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chapappifchapterprefix">117</a></li>
-<li><a name="cmd.chapter*"></a><a href="#cmd.chapter*">\chapter*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chapter*">110</a></li>
-<li><a name="cmd.chapter"></a><a href="#cmd.chapter">\chapter</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chapter">105</a></li>
-<li><a name="cmd.chapterformat"></a><a href="#cmd.chapterformat">\chapterformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chapterformat">115</a></li>
-<li><a name="cmd.chapterheadendvskip"></a><a href="#cmd.chapterheadendvskip">\chapterheadendvskip</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.chapterheadendvskip">504</a></li>
-<li><a name="cmd.chapterheadmidvskip"></a><a href="#cmd.chapterheadmidvskip">\chapterheadmidvskip</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.chapterheadmidvskip">504</a></li>
-<li><a name="cmd.chapterheadstartvskip"></a><a href="#cmd.chapterheadstartvskip">\chapterheadstartvskip</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.chapterheadstartvskip">504</a></li>
-<li><a name="cmd.chapterlinesformat"></a><a href="#cmd.chapterlinesformat">\chapterlinesformat</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.chapterlinesformat">506</a></li>
-<li><a name="cmd.chapterlineswithprefixformat"></a><a href="#cmd.chapterlineswithprefixformat">\chapterlineswithprefixformat</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.chapterlineswithprefixformat">506</a></li>
-<li><a name="cmd.chaptermark"></a><a href="#cmd.chaptermark">\chaptermark</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chaptermark">117</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.chaptermark">271</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.chaptermark">451</a></li>
-<li><a name="cmd.chaptermarkformat"></a><a href="#cmd.chaptermarkformat">\chaptermarkformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chaptermarkformat">117</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.chaptermarkformat">270</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.chaptermarkformat">451</a></li>
-<li><a name="cmd.chapternumdepth"></a><a href="#cmd.chapternumdepth">\chapternumdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chapternumdepth">118</a></li>
+<li><a name="cmd.@addtoplength"></a><a href="#cmd.@addtoplength">\@addtoplength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.@addtoplength">525</a></li>
+<li><a name="cmd.@fontsizefilebase"></a><a href="#cmd.@fontsizefilebase">\@fontsizefilebase</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.@fontsizefilebase">494</a></li>
+<li><a name="cmd.@mkboth"></a><a href="#cmd.@mkboth">\@mkboth</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.@mkboth">459</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.@mkboth">466</a></li>
+<li><a name="cmd.@mkdouble"></a><a href="#cmd.@mkdouble">\@mkdouble</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.@mkdouble">459</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.@mkdouble">466</a></li>
+<li><a name="cmd.@mkleft"></a><a href="#cmd.@mkleft">\@mkleft</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.@mkleft">459</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.@mkleft">466</a></li>
+<li><a name="cmd.@mkright"></a><a href="#cmd.@mkright">\@mkright</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.@mkright">459</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.@mkright">466</a></li>
+<li><a name="cmd.@newplength"></a><a href="#cmd.@newplength">\@newplength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.@newplength">525</a></li>
+<li><a name="cmd.@openbib@code"></a><a href="#cmd.@openbib@code">\@openbib@code</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.@openbib@code">518</a></li>
+<li><a name="cmd.@setplength"></a><a href="#cmd.@setplength">\@setplength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.@setplength">525</a></li>
+<li><a name="cmd.AddLayersAtBeginOfPageStyle"></a><a href="#cmd.AddLayersAtBeginOfPageStyle">\AddLayersAtBeginOfPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.AddLayersAtBeginOfPageStyle">450</a></li>
+<li><a name="cmd.AddLayersAtEndOfPageStyle"></a><a href="#cmd.AddLayersAtEndOfPageStyle">\AddLayersAtEndOfPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.AddLayersAtEndOfPageStyle">450</a></li>
+<li><a name="cmd.AddLayersToPageStyle"></a><a href="#cmd.AddLayersToPageStyle">\AddLayersToPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.AddLayersToPageStyle">450</a></li>
+<li><a name="cmd.AddLayersToPageStyleAfterLayer"></a><a href="#cmd.AddLayersToPageStyleAfterLayer">\AddLayersToPageStyleAfterLayer</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.AddLayersToPageStyleAfterLayer">450</a></li>
+<li><a name="cmd.AddLayersToPageStyleBeforeLayer"></a><a href="#cmd.AddLayersToPageStyleBeforeLayer">\AddLayersToPageStyleBeforeLayer</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.AddLayersToPageStyleBeforeLayer">450</a></li>
+<li><a name="cmd.AddToLayerPageStyleOptions"></a><a href="#cmd.AddToLayerPageStyleOptions">\AddToLayerPageStyleOptions</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.AddToLayerPageStyleOptions">451</a></li>
+<li><a name="cmd.Address"></a><a href="#cmd.Address">\Address</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.Address">289</a></li>
+<li><a name="cmd.AfterAtEndOfClass"></a><a href="#cmd.AfterAtEndOfClass">\AfterAtEndOfClass</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterAtEndOfClass">369</a></li>
+<li><a name="cmd.AfterAtEndOfPackage"></a><a href="#cmd.AfterAtEndOfPackage">\AfterAtEndOfPackage</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterAtEndOfPackage">369</a></li>
+<li><a name="cmd.AfterBibliographyPreamble"></a><a href="#cmd.AfterBibliographyPreamble">\AfterBibliographyPreamble</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.AfterBibliographyPreamble">161</a></li>
+<li><a name="cmd.AfterCalculatingTypearea*"></a><a href="#cmd.AfterCalculatingTypearea*">\AfterCalculatingTypearea*</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.AfterCalculatingTypearea*">491</a></li>
+<li><a name="cmd.AfterCalculatingTypearea"></a><a href="#cmd.AfterCalculatingTypearea">\AfterCalculatingTypearea</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.AfterCalculatingTypearea">491</a></li>
+<li><a name="cmd.AfterClass!"></a><a href="#cmd.AfterClass!">\AfterClass!</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterClass!">369</a></li>
+<li><a name="cmd.AfterClass*"></a><a href="#cmd.AfterClass*">\AfterClass*</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterClass*">369</a></li>
+<li><a name="cmd.AfterClass+"></a><a href="#cmd.AfterClass+">\AfterClass+</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterClass+">369</a></li>
+<li><a name="cmd.AfterClass"></a><a href="#cmd.AfterClass">\AfterClass</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterClass">369</a></li>
+<li><a name="cmd.AfterFile"></a><a href="#cmd.AfterFile">\AfterFile</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterFile">368</a></li>
+<li><a name="cmd.AfterPackage!"></a><a href="#cmd.AfterPackage!">\AfterPackage!</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterPackage!">369</a></li>
+<li><a name="cmd.AfterPackage*"></a><a href="#cmd.AfterPackage*">\AfterPackage*</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterPackage*">369</a></li>
+<li><a name="cmd.AfterPackage+"></a><a href="#cmd.AfterPackage+">\AfterPackage+</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterPackage+">369</a></li>
+<li><a name="cmd.AfterPackage"></a><a href="#cmd.AfterPackage">\AfterPackage</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterPackage">369</a></li>
+<li><a name="cmd.AfterReadingMainAux"></a><a href="#cmd.AfterReadingMainAux">\AfterReadingMainAux</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.AfterReadingMainAux">371</a></li>
+<li><a name="cmd.AfterRestoreareas*"></a><a href="#cmd.AfterRestoreareas*">\AfterRestoreareas*</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.AfterRestoreareas*">490</a></li>
+<li><a name="cmd.AfterRestoreareas"></a><a href="#cmd.AfterRestoreareas">\AfterRestoreareas</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.AfterRestoreareas">490</a></li>
+<li><a name="cmd.AfterSelectAnyPageStyle"></a><a href="#cmd.AfterSelectAnyPageStyle">\AfterSelectAnyPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.AfterSelectAnyPageStyle">443</a></li>
+<li><a name="cmd.AfterSettingArea*"></a><a href="#cmd.AfterSettingArea*">\AfterSettingArea*</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.AfterSettingArea*">491</a></li>
+<li><a name="cmd.AfterSettingArea"></a><a href="#cmd.AfterSettingArea">\AfterSettingArea</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.AfterSettingArea">491</a></li>
+<li><a name="cmd.AfterStartingTOC"></a><a href="#cmd.AfterStartingTOC">\AfterStartingTOC</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.AfterStartingTOC">391</a></li>
+<li><a name="cmd.AfterTOCHead"></a><a href="#cmd.AfterTOCHead">\AfterTOCHead</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.AfterTOCHead">391</a></li>
+<li><a name="cmd.At@startsection"></a><a href="#cmd.At@startsection">\At@startsection</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.At@startsection">516</a></li>
+<li><a name="cmd.AtAddToTocList"></a><a href="#cmd.AtAddToTocList">\AtAddToTocList</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.AtAddToTocList">386</a></li>
+<li><a name="cmd.AtBeginLetter"></a><a href="#cmd.AtBeginLetter">\AtBeginLetter</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.AtBeginLetter">177</a></li>
+<li><a name="cmd.AtEndBibliography"></a><a href="#cmd.AtEndBibliography">\AtEndBibliography</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.AtEndBibliography">161</a></li>
+<li><a name="cmd.AtEndLetter"></a><a href="#cmd.AtEndLetter">\AtEndLetter</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.AtEndLetter">177</a></li>
+<li><a name="cmd.AtEndOfFamilyOptions*"></a><a href="#cmd.AtEndOfFamilyOptions*">\AtEndOfFamilyOptions*</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.AtEndOfFamilyOptions*">348</a></li>
+<li><a name="cmd.AtEndOfFamilyOptions"></a><a href="#cmd.AtEndOfFamilyOptions">\AtEndOfFamilyOptions</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.AtEndOfFamilyOptions">348</a></li>
+<li><a name="cmd.Before@sect"></a><a href="#cmd.Before@sect">\Before@sect</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.Before@sect">516</a></li>
+<li><a name="cmd.Before@ssect"></a><a href="#cmd.Before@ssect">\Before@ssect</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.Before@ssect">516</a></li>
+<li><a name="cmd.BeforeClass"></a><a href="#cmd.BeforeClass">\BeforeClass</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.BeforeClass">369</a></li>
+<li><a name="cmd.BeforeClosingMainAux"></a><a href="#cmd.BeforeClosingMainAux">\BeforeClosingMainAux</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.BeforeClosingMainAux">371</a></li>
+<li><a name="cmd.BeforeFamilyProcessOptions"></a><a href="#cmd.BeforeFamilyProcessOptions">\BeforeFamilyProcessOptions</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.BeforeFamilyProcessOptions">344</a></li>
+<li><a name="cmd.BeforeFile"></a><a href="#cmd.BeforeFile">\BeforeFile</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.BeforeFile">368</a></li>
+<li><a name="cmd.BeforePackage"></a><a href="#cmd.BeforePackage">\BeforePackage</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.BeforePackage">369</a></li>
+<li><a name="cmd.BeforeRestoreareas*"></a><a href="#cmd.BeforeRestoreareas*">\BeforeRestoreareas*</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.BeforeRestoreareas*">490</a></li>
+<li><a name="cmd.BeforeRestoreareas"></a><a href="#cmd.BeforeRestoreareas">\BeforeRestoreareas</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.BeforeRestoreareas">490</a></li>
+<li><a name="cmd.BeforeSelectAnyPageStyle"></a><a href="#cmd.BeforeSelectAnyPageStyle">\BeforeSelectAnyPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.BeforeSelectAnyPageStyle">443</a></li>
+<li><a name="cmd.BeforeStartingTOC"></a><a href="#cmd.BeforeStartingTOC">\BeforeStartingTOC</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.BeforeStartingTOC">391</a></li>
+<li><a name="cmd.BeforeTOCHead"></a><a href="#cmd.BeforeTOCHead">\BeforeTOCHead</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.BeforeTOCHead">391</a></li>
+<li><a name="cmd.BreakBibliography"></a><a href="#cmd.BreakBibliography">\BreakBibliography</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.BreakBibliography">161</a></li>
+<li><a name="cmd.CenturyPart"></a><a href="#cmd.CenturyPart">\CenturyPart</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.CenturyPart">281</a></li>
+<li><a name="cmd.ClassInfoNoLine"></a><a href="#cmd.ClassInfoNoLine">\ClassInfoNoLine</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ClassInfoNoLine">365</a></li>
+<li><a name="cmd.ClassName"></a><a href="#cmd.ClassName">\ClassName</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.ClassName">492</a></li>
+<li><a name="cmd.Clause"></a><a href="#cmd.Clause">\Clause</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.Clause">320</a></li>
+<li><a name="cmd.Clauseformat"></a><a href="#cmd.Clauseformat">\Clauseformat</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.Clauseformat">322</a></li>
+<li><a name="cmd.CloneTOCEntryStyle"></a><a href="#cmd.CloneTOCEntryStyle">\CloneTOCEntryStyle</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.CloneTOCEntryStyle">406</a></li>
+<li><a name="cmd.Comment"></a><a href="#cmd.Comment">\Comment</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.Comment">289</a></li>
+<li><a name="cmd.DayName"></a><a href="#cmd.DayName">\DayName</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.DayName">282</a></li>
+<li><a name="cmd.DayNameByNumber"></a><a href="#cmd.DayNameByNumber">\DayNameByNumber</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.DayNameByNumber">282</a></li>
+<li><a name="cmd.DayNumber"></a><a href="#cmd.DayNumber">\DayNumber</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.DayNumber">281</a></li>
+<li><a name="cmd.DecadePart"></a><a href="#cmd.DecadePart">\DecadePart</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.DecadePart">281</a></li>
+<li><a name="cmd.DeclareLayer"></a><a href="#cmd.DeclareLayer">\DeclareLayer</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DeclareLayer">431</a></li>
+<li><a name="cmd.DeclareNewJuraEnvironment"></a><a href="#cmd.DeclareNewJuraEnvironment">\DeclareNewJuraEnvironment</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.DeclareNewJuraEnvironment">329</a></li>
+<li><a name="cmd.DeclareNewLayer"></a><a href="#cmd.DeclareNewLayer">\DeclareNewLayer</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DeclareNewLayer">431</a></li>
+<li><a name="cmd.DeclareNewNoteColumn"></a><a href="#cmd.DeclareNewNoteColumn">\DeclareNewNoteColumn</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.DeclareNewNoteColumn">477</a></li>
+<li><a name="cmd.DeclareNewPageStyleAlias"></a><a href="#cmd.DeclareNewPageStyleAlias">\DeclareNewPageStyleAlias</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DeclareNewPageStyleAlias">444</a></li>
+<li><a name="cmd.DeclareNewPageStyleByLayers"></a><a href="#cmd.DeclareNewPageStyleByLayers">\DeclareNewPageStyleByLayers</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DeclareNewPageStyleByLayers">445</a></li>
+<li><a name="cmd.DeclareNewSectionCommand"></a><a href="#cmd.DeclareNewSectionCommand">\DeclareNewSectionCommand</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.DeclareNewSectionCommand">497</a></li>
+<li><a name="cmd.DeclareNewSectionCommands"></a><a href="#cmd.DeclareNewSectionCommands">\DeclareNewSectionCommands</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.DeclareNewSectionCommands">507</a></li>
+<li><a name="cmd.DeclareNewTOC"></a><a href="#cmd.DeclareNewTOC">\DeclareNewTOC</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DeclareNewTOC">413</a></li>
+<li><a name="cmd.DeclareNoteColumn"></a><a href="#cmd.DeclareNoteColumn">\DeclareNoteColumn</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.DeclareNoteColumn">477</a></li>
+<li><a name="cmd.DeclarePageStyleAlias"></a><a href="#cmd.DeclarePageStyleAlias">\DeclarePageStyleAlias</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DeclarePageStyleAlias">444</a></li>
+<li><a name="cmd.DeclarePageStyleByLayers"></a><a href="#cmd.DeclarePageStyleByLayers">\DeclarePageStyleByLayers</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DeclarePageStyleByLayers">445</a></li>
+<li><a name="cmd.DeclareSectionCommand"></a><a href="#cmd.DeclareSectionCommand">\DeclareSectionCommand</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.DeclareSectionCommand">497</a></li>
+<li><a name="cmd.DeclareSectionCommands"></a><a href="#cmd.DeclareSectionCommands">\DeclareSectionCommands</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.DeclareSectionCommands">507</a></li>
+<li><a name="cmd.DeclareSectionNumberDepth"></a><a href="#cmd.DeclareSectionNumberDepth">\DeclareSectionNumberDepth</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DeclareSectionNumberDepth">429</a></li>
+<li><a name="cmd.DeclareTOCEntryStyle"></a><a href="#cmd.DeclareTOCEntryStyle">\DeclareTOCEntryStyle</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DeclareTOCEntryStyle">404</a></li>
+<li><a name="cmd.DeclareTOCStyleEntry"></a><a href="#cmd.DeclareTOCStyleEntry">\DeclareTOCStyleEntry</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DeclareTOCStyleEntry">396</a></li>
+<li><a name="cmd.DefineFamily"></a><a href="#cmd.DefineFamily">\DefineFamily</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.DefineFamily">340</a></li>
+<li><a name="cmd.DefineFamilyKey"></a><a href="#cmd.DefineFamilyKey">\DefineFamilyKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.DefineFamilyKey">341</a></li>
+<li><a name="cmd.DefineFamilyMember"></a><a href="#cmd.DefineFamilyMember">\DefineFamilyMember</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.DefineFamilyMember">340</a></li>
+<li><a name="cmd.DefineTOCEntryBooleanOption"></a><a href="#cmd.DefineTOCEntryBooleanOption">\DefineTOCEntryBooleanOption</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DefineTOCEntryBooleanOption">404</a></li>
+<li><a name="cmd.DefineTOCEntryCommandOption"></a><a href="#cmd.DefineTOCEntryCommandOption">\DefineTOCEntryCommandOption</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DefineTOCEntryCommandOption">404</a></li>
+<li><a name="cmd.DefineTOCEntryIfOption"></a><a href="#cmd.DefineTOCEntryIfOption">\DefineTOCEntryIfOption</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DefineTOCEntryIfOption">404</a></li>
+<li><a name="cmd.DefineTOCEntryLengthOption"></a><a href="#cmd.DefineTOCEntryLengthOption">\DefineTOCEntryLengthOption</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DefineTOCEntryLengthOption">404</a></li>
+<li><a name="cmd.DefineTOCEntryNumberOption"></a><a href="#cmd.DefineTOCEntryNumberOption">\DefineTOCEntryNumberOption</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DefineTOCEntryNumberOption">404</a></li>
+<li><a name="cmd.DefineTOCEntryOption"></a><a href="#cmd.DefineTOCEntryOption">\DefineTOCEntryOption</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.DefineTOCEntryOption">404</a></li>
+<li><a name="cmd.DestroyLayer"></a><a href="#cmd.DestroyLayer">\DestroyLayer</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DestroyLayer">441</a></li>
+<li><a name="cmd.DestroyPageStyleAlias"></a><a href="#cmd.DestroyPageStyleAlias">\DestroyPageStyleAlias</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DestroyPageStyleAlias">444</a></li>
+<li><a name="cmd.DestroyRealLayerPageStyle"></a><a href="#cmd.DestroyRealLayerPageStyle">\DestroyRealLayerPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.DestroyRealLayerPageStyle">452</a></li>
+<li><a name="cmd.FamilyBoolKey"></a><a href="#cmd.FamilyBoolKey">\FamilyBoolKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyBoolKey">348</a></li>
+<li><a name="cmd.FamilyCSKey"></a><a href="#cmd.FamilyCSKey">\FamilyCSKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyCSKey">353</a></li>
+<li><a name="cmd.FamilyCounterKey"></a><a href="#cmd.FamilyCounterKey">\FamilyCounterKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyCounterKey">352</a></li>
+<li><a name="cmd.FamilyCounterMacroKey"></a><a href="#cmd.FamilyCounterMacroKey">\FamilyCounterMacroKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyCounterMacroKey">352</a></li>
+<li><a name="cmd.FamilyElseValues"></a><a href="#cmd.FamilyElseValues">\FamilyElseValues</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyElseValues">355</a></li>
+<li><a name="cmd.FamilyExecuteOptions"></a><a href="#cmd.FamilyExecuteOptions">\FamilyExecuteOptions</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyExecuteOptions">345</a></li>
+<li><a name="cmd.FamilyKeyState"></a><a href="#cmd.FamilyKeyState">\FamilyKeyState</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyKeyState">341</a></li>
+<li><a name="cmd.FamilyKeyStateNeedValue"></a><a href="#cmd.FamilyKeyStateNeedValue">\FamilyKeyStateNeedValue</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyKeyStateNeedValue">341</a></li>
+<li><a name="cmd.FamilyKeyStateProcessed"></a><a href="#cmd.FamilyKeyStateProcessed">\FamilyKeyStateProcessed</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyKeyStateProcessed">341</a></li>
+<li><a name="cmd.FamilyKeyStateUnknown"></a><a href="#cmd.FamilyKeyStateUnknown">\FamilyKeyStateUnknown</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyKeyStateUnknown">341</a></li>
+<li><a name="cmd.FamilyKeyStateUnknownValue"></a><a href="#cmd.FamilyKeyStateUnknownValue">\FamilyKeyStateUnknownValue</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyKeyStateUnknownValue">341</a></li>
+<li><a name="cmd.FamilyLengthKey"></a><a href="#cmd.FamilyLengthKey">\FamilyLengthKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyLengthKey">352</a></li>
+<li><a name="cmd.FamilyLengthMacroKey"></a><a href="#cmd.FamilyLengthMacroKey">\FamilyLengthMacroKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyLengthMacroKey">352</a></li>
+<li><a name="cmd.FamilyNumericalKey"></a><a href="#cmd.FamilyNumericalKey">\FamilyNumericalKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyNumericalKey">350</a></li>
+<li><a name="cmd.FamilyOption"></a><a href="#cmd.FamilyOption">\FamilyOption</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyOption">347</a></li>
+<li><a name="cmd.FamilyOptions"></a><a href="#cmd.FamilyOptions">\FamilyOptions</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyOptions">346</a></li>
+<li><a name="cmd.FamilyProcessOptions"></a><a href="#cmd.FamilyProcessOptions">\FamilyProcessOptions</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyProcessOptions">343</a></li>
+<li><a name="cmd.FamilySetBool"></a><a href="#cmd.FamilySetBool">\FamilySetBool</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilySetBool">348</a></li>
+<li><a name="cmd.FamilySetCounter"></a><a href="#cmd.FamilySetCounter">\FamilySetCounter</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilySetCounter">352</a></li>
+<li><a name="cmd.FamilySetCounterMacro"></a><a href="#cmd.FamilySetCounterMacro">\FamilySetCounterMacro</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilySetCounterMacro">352</a></li>
+<li><a name="cmd.FamilySetLength"></a><a href="#cmd.FamilySetLength">\FamilySetLength</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilySetLength">352</a></li>
+<li><a name="cmd.FamilySetLengthMacro"></a><a href="#cmd.FamilySetLengthMacro">\FamilySetLengthMacro</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilySetLengthMacro">352</a></li>
+<li><a name="cmd.FamilySetNumerical"></a><a href="#cmd.FamilySetNumerical">\FamilySetNumerical</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilySetNumerical">350</a></li>
+<li><a name="cmd.FamilyStringKey"></a><a href="#cmd.FamilyStringKey">\FamilyStringKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyStringKey">353</a></li>
+<li><a name="cmd.FamilyUnknownKeyValue"></a><a href="#cmd.FamilyUnknownKeyValue">\FamilyUnknownKeyValue</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.FamilyUnknownKeyValue">354</a></li>
+<li><a name="cmd.FirstName"></a><a href="#cmd.FirstName">\FirstName</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.FirstName">289</a></li>
+<li><a name="cmd.ForEachLayerOfPageStyle*"></a><a href="#cmd.ForEachLayerOfPageStyle*">\ForEachLayerOfPageStyle*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.ForEachLayerOfPageStyle*">449</a></li>
+<li><a name="cmd.ForEachLayerOfPageStyle"></a><a href="#cmd.ForEachLayerOfPageStyle">\ForEachLayerOfPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.ForEachLayerOfPageStyle">449</a></li>
+<li><a name="cmd.FreeI"></a><a href="#cmd.FreeI">\FreeI</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.FreeI">289</a></li>
+<li><a name="cmd.FreeII"></a><a href="#cmd.FreeII">\FreeII</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.FreeII">289</a></li>
+<li><a name="cmd.FreeIII"></a><a href="#cmd.FreeIII">\FreeIII</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.FreeIII">289</a></li>
+<li><a name="cmd.FreeIV"></a><a href="#cmd.FreeIV">\FreeIV</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.FreeIV">289</a></li>
+<li><a name="cmd.GenericMarkFormat"></a><a href="#cmd.GenericMarkFormat">\GenericMarkFormat</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.GenericMarkFormat">458</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.GenericMarkFormat">463</a></li>
+<li><a name="cmd.GetLayerContents"></a><a href="#cmd.GetLayerContents">\GetLayerContents</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.GetLayerContents">441</a></li>
+<li><a name="cmd.GetRealPageStyle"></a><a href="#cmd.GetRealPageStyle">\GetRealPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.GetRealPageStyle">444</a></li>
+<li><a name="cmd.ISODayName"></a><a href="#cmd.ISODayName">\ISODayName</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.ISODayName">282</a></li>
+<li><a name="cmd.ISODayNumber"></a><a href="#cmd.ISODayNumber">\ISODayNumber</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.ISODayNumber">281</a></li>
+<li><a name="cmd.ISOToday"></a><a href="#cmd.ISOToday">\ISOToday</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.ISOToday">283</a></li>
+<li><a name="cmd.IfChapterUsesPrefixLine"></a><a href="#cmd.IfChapterUsesPrefixLine">\IfChapterUsesPrefixLine</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.IfChapterUsesPrefixLine">102</a></li>
+<li><a name="cmd.IfExistskomafont"></a><a href="#cmd.IfExistskomafont">\IfExistskomafont</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.IfExistskomafont">496</a></li>
+<li><a name="cmd.IfIsAliaskomafont"></a><a href="#cmd.IfIsAliaskomafont">\IfIsAliaskomafont</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.IfIsAliaskomafont">496</a></li>
+<li><a name="cmd.IfLayerAtPageStyle"></a><a href="#cmd.IfLayerAtPageStyle">\IfLayerAtPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.IfLayerAtPageStyle">451</a></li>
+<li><a name="cmd.IfLayerExists"></a><a href="#cmd.IfLayerExists">\IfLayerExists</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.IfLayerExists">441</a></li>
+<li><a name="cmd.IfLayerPageStyleExists"></a><a href="#cmd.IfLayerPageStyleExists">\IfLayerPageStyleExists</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.IfLayerPageStyleExists">451</a></li>
+<li><a name="cmd.IfLayersAtPageStyle"></a><a href="#cmd.IfLayersAtPageStyle">\IfLayersAtPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.IfLayersAtPageStyle">451</a></li>
+<li><a name="cmd.IfRealLayerPageStyleExists"></a><a href="#cmd.IfRealLayerPageStyleExists">\IfRealLayerPageStyleExists</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.IfRealLayerPageStyleExists">451</a></li>
+<li><a name="cmd.IfSomeLayersAtPageStyle"></a><a href="#cmd.IfSomeLayersAtPageStyle">\IfSomeLayersAtPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.IfSomeLayersAtPageStyle">451</a></li>
+<li><a name="cmd.IfUsePrefixLine"></a><a href="#cmd.IfUsePrefixLine">\IfUsePrefixLine</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.IfUsePrefixLine">117</a></li>
+<li><a name="cmd.InputAddressFile"></a><a href="#cmd.InputAddressFile">\InputAddressFile</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.InputAddressFile">288</a></li>
+<li><a name="cmd.IsoToday"></a><a href="#cmd.IsoToday">\IsoToday</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.IsoToday">283</a></li>
+<li><a name="cmd.KOMAClassName"></a><a href="#cmd.KOMAClassName">\KOMAClassName</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.KOMAClassName">492</a></li>
+<li><a name="cmd.KOMAScript"></a><a href="#cmd.KOMAScript">\KOMAScript</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.KOMAScript">365</a></li>
+<li><a name="cmd.KOMAScriptVersion"></a><a href="#cmd.KOMAScriptVersion">\KOMAScriptVersion</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.KOMAScriptVersion">365</a></li>
+<li><a name="cmd.KOMAoption"></a><a href="#cmd.KOMAoption">\KOMAoption</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.KOMAoption">171</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.KOMAoption">253</a>, <a href="scrguide.pdf#desc:scrextend.cmd.KOMAoption">294</a>, <a href="scrguide.pdf#desc:scrjura.cmd.KOMAoption">316</a>, <a href="scrguide.pdf#desc:typearea.cmd.KOMAoption">32</a>, <a href="scrguide.pdf#desc:scrhack.cmd.KOMAoption">422</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.KOMAoption">427</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.KOMAoption">475</a>, <a href="scrguide.pdf#desc:maincls.cmd.KOMAoption">57</a></li>
+<li><a name="cmd.KOMAoptions"></a><a href="#cmd.KOMAoptions">\KOMAoptions</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.KOMAoptions">171</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.KOMAoptions">253</a>, <a href="scrguide.pdf#desc:scrextend.cmd.KOMAoptions">294</a>, <a href="scrguide.pdf#desc:scrjura.cmd.KOMAoptions">316</a>, <a href="scrguide.pdf#desc:typearea.cmd.KOMAoptions">32</a>, <a href="scrguide.pdf#desc:scrhack.cmd.KOMAoptions">422</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.KOMAoptions">427</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.KOMAoptions">475</a>, <a href="scrguide.pdf#desc:maincls.cmd.KOMAoptions">57</a></li>
+<li><a name="cmd.LastName"></a><a href="#cmd.LastName">\LastName</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.LastName">289</a></li>
+<li><a name="cmd.LastTOCLevelWasHigher"></a><a href="#cmd.LastTOCLevelWasHigher">\LastTOCLevelWasHigher</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.LastTOCLevelWasHigher">407</a></li>
+<li><a name="cmd.LastTOCLevelWasLower"></a><a href="#cmd.LastTOCLevelWasLower">\LastTOCLevelWasLower</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.LastTOCLevelWasLower">407</a></li>
+<li><a name="cmd.LastTOCLevelWasSame"></a><a href="#cmd.LastTOCLevelWasSame">\LastTOCLevelWasSame</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.LastTOCLevelWasSame">407</a></li>
+<li><a name="cmd.LenToUnit"></a><a href="#cmd.LenToUnit">\LenToUnit</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.LenToUnit">440</a></li>
+<li><a name="cmd.MakeMarkcase"></a><a href="#cmd.MakeMarkcase">\MakeMarkcase</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.MakeMarkcase">272</a>, <a href="scrguide.pdf#desc:tocbasic.cmd.MakeMarkcase">391</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.MakeMarkcase">455</a></li>
+<li><a name="cmd.ModifyLayer"></a><a href="#cmd.ModifyLayer">\ModifyLayer</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.ModifyLayer">431</a></li>
+<li><a name="cmd.ModifyLayerPageStyleOptions"></a><a href="#cmd.ModifyLayerPageStyleOptions">\ModifyLayerPageStyleOptions</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.ModifyLayerPageStyleOptions">451</a></li>
+<li><a name="cmd.Name"></a><a href="#cmd.Name">\Name</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.Name">289</a></li>
+<li><a name="cmd.PackageInfoNoLine"></a><a href="#cmd.PackageInfoNoLine">\PackageInfoNoLine</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.PackageInfoNoLine">365</a></li>
+<li><a name="cmd.PreventPackageFromLoading*"></a><a href="#cmd.PreventPackageFromLoading*">\PreventPackageFromLoading*</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.PreventPackageFromLoading*">376</a></li>
+<li><a name="cmd.PreventPackageFromLoading"></a><a href="#cmd.PreventPackageFromLoading">\PreventPackageFromLoading</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.PreventPackageFromLoading">376</a></li>
+<li><a name="cmd.ProvideLayer"></a><a href="#cmd.ProvideLayer">\ProvideLayer</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.ProvideLayer">431</a></li>
+<li><a name="cmd.ProvideNoteColumn"></a><a href="#cmd.ProvideNoteColumn">\ProvideNoteColumn</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.ProvideNoteColumn">477</a></li>
+<li><a name="cmd.ProvidePageStyleAlias"></a><a href="#cmd.ProvidePageStyleAlias">\ProvidePageStyleAlias</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.ProvidePageStyleAlias">444</a></li>
+<li><a name="cmd.ProvidePageStyleByLayers"></a><a href="#cmd.ProvidePageStyleByLayers">\ProvidePageStyleByLayers</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.ProvidePageStyleByLayers">445</a></li>
+<li><a name="cmd.ProvideSectionCommand"></a><a href="#cmd.ProvideSectionCommand">\ProvideSectionCommand</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.ProvideSectionCommand">497</a></li>
+<li><a name="cmd.ProvideSectionCommands"></a><a href="#cmd.ProvideSectionCommands">\ProvideSectionCommands</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.ProvideSectionCommands">507</a></li>
+<li><a name="cmd.RedeclareLayer"></a><a href="#cmd.RedeclareLayer">\RedeclareLayer</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.RedeclareLayer">431</a></li>
+<li><a name="cmd.RedeclareNoteColumn"></a><a href="#cmd.RedeclareNoteColumn">\RedeclareNoteColumn</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.RedeclareNoteColumn">477</a></li>
+<li><a name="cmd.RedeclarePageStyleAlias"></a><a href="#cmd.RedeclarePageStyleAlias">\RedeclarePageStyleAlias</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.RedeclarePageStyleAlias">444</a></li>
+<li><a name="cmd.RedeclarePageStyleByLayers"></a><a href="#cmd.RedeclarePageStyleByLayers">\RedeclarePageStyleByLayers</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.RedeclarePageStyleByLayers">445</a></li>
+<li><a name="cmd.RedeclareSectionCommand"></a><a href="#cmd.RedeclareSectionCommand">\RedeclareSectionCommand</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.RedeclareSectionCommand">497</a></li>
+<li><a name="cmd.RedeclareSectionCommands"></a><a href="#cmd.RedeclareSectionCommands">\RedeclareSectionCommands</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.RedeclareSectionCommands">507</a></li>
+<li><a name="cmd.RelaxFamilyKey"></a><a href="#cmd.RelaxFamilyKey">\RelaxFamilyKey</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.RelaxFamilyKey">343</a></li>
+<li><a name="cmd.RemoveLayersFromPageStyle"></a><a href="#cmd.RemoveLayersFromPageStyle">\RemoveLayersFromPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.RemoveLayersFromPageStyle">450</a></li>
+<li><a name="cmd.ReplaceClass"></a><a href="#cmd.ReplaceClass">\ReplaceClass</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.ReplaceClass">374</a></li>
+<li><a name="cmd.ReplaceInput"></a><a href="#cmd.ReplaceInput">\ReplaceInput</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.ReplaceInput">373</a></li>
+<li><a name="cmd.ReplacePackage"></a><a href="#cmd.ReplacePackage">\ReplacePackage</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.ReplacePackage">374</a></li>
+<li><a name="cmd.ResetPreventPackageFromLoading"></a><a href="#cmd.ResetPreventPackageFromLoading">\ResetPreventPackageFromLoading</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.ResetPreventPackageFromLoading">377</a></li>
+<li><a name="cmd.SecDef"></a><a href="#cmd.SecDef">\SecDef</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.SecDef">516</a></li>
+<li><a name="cmd.Sentence"></a><a href="#cmd.Sentence">\Sentence</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.Sentence">325</a></li>
+<li><a name="cmd.StorePreventPackageFromLoading"></a><a href="#cmd.StorePreventPackageFromLoading">\StorePreventPackageFromLoading</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.StorePreventPackageFromLoading">377</a></li>
+<li><a name="cmd.SubClause"></a><a href="#cmd.SubClause">\SubClause</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.SubClause">320</a></li>
+<li><a name="cmd.TOCEntryStyleInitCode"></a><a href="#cmd.TOCEntryStyleInitCode">\TOCEntryStyleInitCode</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.TOCEntryStyleInitCode">406</a></li>
+<li><a name="cmd.TOCEntryStyleStartInitCode"></a><a href="#cmd.TOCEntryStyleStartInitCode">\TOCEntryStyleStartInitCode</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.TOCEntryStyleStartInitCode">406</a></li>
+<li><a name="cmd.TOCLineLeaderFill"></a><a href="#cmd.TOCLineLeaderFill">\TOCLineLeaderFill</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.TOCLineLeaderFill">407</a></li>
+<li><a name="cmd.TOCclone"></a><a href="#cmd.TOCclone">\TOCclone</a> --&gt; <a href="scrguide.pdf#desc:scrwfile.cmd.TOCclone">381</a></li>
+<li><a name="cmd.Telephone"></a><a href="#cmd.Telephone">\Telephone</a> --&gt; <a href="scrguide.pdf#desc:scraddr.cmd.Telephone">289</a></li>
+<li><a name="cmd.UnPreventPackageFromLoading*"></a><a href="#cmd.UnPreventPackageFromLoading*">\UnPreventPackageFromLoading*</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.UnPreventPackageFromLoading*">378</a></li>
+<li><a name="cmd.UnPreventPackageFromLoading"></a><a href="#cmd.UnPreventPackageFromLoading">\UnPreventPackageFromLoading</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.UnPreventPackageFromLoading">378</a></li>
+<li><a name="cmd.UnReplaceClass"></a><a href="#cmd.UnReplaceClass">\UnReplaceClass</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.UnReplaceClass">376</a></li>
+<li><a name="cmd.UnReplaceInput"></a><a href="#cmd.UnReplaceInput">\UnReplaceInput</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.UnReplaceInput">376</a></li>
+<li><a name="cmd.UnReplacePackage"></a><a href="#cmd.UnReplacePackage">\UnReplacePackage</a> --&gt; <a href="scrguide.pdf#desc:scrlfile.cmd.UnReplacePackage">376</a></li>
+<li><a name="cmd.UnifyLayersAtPageStyle"></a><a href="#cmd.UnifyLayersAtPageStyle">\UnifyLayersAtPageStyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.UnifyLayersAtPageStyle">450</a></li>
+<li><a name="cmd.XdivY"></a><a href="#cmd.XdivY">\XdivY</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.XdivY">366</a></li>
+<li><a name="cmd.XmodY"></a><a href="#cmd.XmodY">\XmodY</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.XmodY">366</a></li>
+<li><a name="cmd.activateareas"></a><a href="#cmd.activateareas">\activateareas</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.activateareas">489</a></li>
+<li><a name="cmd.addchap*"></a><a href="#cmd.addchap*">\addchap*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.addchap*">113</a></li>
+<li><a name="cmd.addchap"></a><a href="#cmd.addchap">\addchap</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.addchap">113</a></li>
+<li><a name="cmd.addchapmark"></a><a href="#cmd.addchapmark">\addchapmark</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.addchapmark">119</a></li>
+<li><a name="cmd.addchaptertocentry"></a><a href="#cmd.addchaptertocentry">\addchaptertocentry</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addchaptertocentry">494</a></li>
+<li><a name="cmd.addcontentslinetoeachtocfile"></a><a href="#cmd.addcontentslinetoeachtocfile">\addcontentslinetoeachtocfile</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.addcontentslinetoeachtocfile">389</a></li>
+<li><a name="cmd.addparagraphtocentry"></a><a href="#cmd.addparagraphtocentry">\addparagraphtocentry</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addparagraphtocentry">494</a></li>
+<li><a name="cmd.addpart*"></a><a href="#cmd.addpart*">\addpart*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.addpart*">113</a></li>
+<li><a name="cmd.addpart"></a><a href="#cmd.addpart">\addpart</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.addpart">113</a></li>
+<li><a name="cmd.addparttocentry"></a><a href="#cmd.addparttocentry">\addparttocentry</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addparttocentry">494</a></li>
+<li><a name="cmd.addrchar"></a><a href="#cmd.addrchar">\addrchar</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.addrchar">250</a>, <a href="scrguide.pdf#desc:scraddr.cmd.addrchar">288</a></li>
+<li><a name="cmd.addrentry"></a><a href="#cmd.addrentry">\addrentry</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.addrentry">249</a>, <a href="scrguide.pdf#desc:scraddr.cmd.addrentry">288</a></li>
+<li><a name="cmd.addsec*"></a><a href="#cmd.addsec*">\addsec*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.addsec*">113</a></li>
+<li><a name="cmd.addsec"></a><a href="#cmd.addsec">\addsec</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.addsec">113</a></li>
+<li><a name="cmd.addsecmark"></a><a href="#cmd.addsecmark">\addsecmark</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.addsecmark">119</a></li>
+<li><a name="cmd.addsectiontocentry"></a><a href="#cmd.addsectiontocentry">\addsectiontocentry</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addsectiontocentry">494</a></li>
+<li><a name="cmd.addsubparagraphtocentry"></a><a href="#cmd.addsubparagraphtocentry">\addsubparagraphtocentry</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addsubparagraphtocentry">494</a></li>
+<li><a name="cmd.addsubsectiontocentry"></a><a href="#cmd.addsubsectiontocentry">\addsubsectiontocentry</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addsubsectiontocentry">494</a></li>
+<li><a name="cmd.addsubsubsectiontocentry"></a><a href="#cmd.addsubsubsectiontocentry">\addsubsubsectiontocentry</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addsubsubsectiontocentry">494</a></li>
+<li><a name="cmd.addtocentrydefault"></a><a href="#cmd.addtocentrydefault">\addtocentrydefault</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addtocentrydefault">493</a></li>
+<li><a name="cmd.addtoeachtocfile"></a><a href="#cmd.addtoeachtocfile">\addtoeachtocfile</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.addtoeachtocfile">388</a></li>
+<li><a name="cmd.addtokomafont"></a><a href="#cmd.addtokomafont">\addtokomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.addtokomafont">188</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.addtokomafont">255</a>, <a href="scrguide.pdf#desc:scrextend.cmd.addtokomafont">298</a>, <a href="scrguide.pdf#desc:scrjura.cmd.addtokomafont">317</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.addtokomafont">476</a>, <a href="scrguide.pdf#desc:maincls.cmd.addtokomafont">62</a></li>
+<li><a name="cmd.addtokomafontgobblelist"></a><a href="#cmd.addtokomafontgobblelist">\addtokomafontgobblelist</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addtokomafontgobblelist">495</a></li>
+<li><a name="cmd.addtokomafontonearglist"></a><a href="#cmd.addtokomafontonearglist">\addtokomafontonearglist</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addtokomafontonearglist">495</a></li>
+<li><a name="cmd.addtokomafontrelaxlist"></a><a href="#cmd.addtokomafontrelaxlist">\addtokomafontrelaxlist</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.addtokomafontrelaxlist">495</a></li>
+<li><a name="cmd.addtolengthplength"></a><a href="#cmd.addtolengthplength">\addtolengthplength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.addtolengthplength">170</a></li>
+<li><a name="cmd.addtoreffields"></a><a href="#cmd.addtoreffields">\addtoreffields</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.addtoreffields">536</a></li>
+<li><a name="cmd.addtotoclist"></a><a href="#cmd.addtotoclist">\addtotoclist</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.addtotoclist">384</a></li>
+<li><a name="cmd.addxcontentsline"></a><a href="#cmd.addxcontentsline">\addxcontentsline</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.addxcontentsline">388</a></li>
+<li><a name="cmd.addxcontentslinetoeachtocfile"></a><a href="#cmd.addxcontentslinetoeachtocfile">\addxcontentslinetoeachtocfile</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.addxcontentslinetoeachtocfile">389</a></li>
+<li><a name="cmd.adrchar"></a><a href="#cmd.adrchar">\adrchar</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.adrchar">250</a>, <a href="scrguide.pdf#desc:scraddr.cmd.adrchar">288</a></li>
+<li><a name="cmd.adrentry"></a><a href="#cmd.adrentry">\adrentry</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.adrentry">248</a>, <a href="scrguide.pdf#desc:scraddr.cmd.adrentry">288</a></li>
+<li><a name="cmd.aliaskomafont"></a><a href="#cmd.aliaskomafont">\aliaskomafont</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.aliaskomafont">495</a></li>
+<li><a name="cmd.and"></a><a href="#cmd.and">\and</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.and">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.and">71</a></li>
+<li><a name="cmd.appendix"></a><a href="#cmd.appendix">\appendix</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.appendix">158</a></li>
+<li><a name="cmd.appendixmore"></a><a href="#cmd.appendixmore">\appendixmore</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.appendixmore">517</a></li>
+<li><a name="cmd.areaset"></a><a href="#cmd.areaset">\areaset</a> --&gt; <a href="scrguide.pdf#desc:typearea.cmd.areaset">48</a>, <a href="scrguide.pdf#desc:typearea-experts.cmd.areaset">489</a></li>
+<li><a name="cmd.author"></a><a href="#cmd.author">\author</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.author">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.author">71</a></li>
+<li><a name="cmd.autodot"></a><a href="#cmd.autodot">\autodot</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.autodot">117</a></li>
+<li><a name="cmd.automark*"></a><a href="#cmd.automark*">\automark*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.automark*">269</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.automark*">453</a></li>
+<li><a name="cmd.automark"></a><a href="#cmd.automark">\automark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.automark">269</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.automark">453</a></li>
+<li><a name="cmd.backmatter"></a><a href="#cmd.backmatter">\backmatter</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.backmatter">100</a></li>
+<li><a name="cmd.bankname"></a><a href="#cmd.bankname">\bankname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.bankname">543</a></li>
+<li><a name="cmd.bib@beginhook"></a><a href="#cmd.bib@beginhook">\bib@beginhook</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.bib@beginhook">518</a></li>
+<li><a name="cmd.bib@endhook"></a><a href="#cmd.bib@endhook">\bib@endhook</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.bib@endhook">518</a></li>
+<li><a name="cmd.caption"></a><a href="#cmd.caption">\caption</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.caption">140</a></li>
+<li><a name="cmd.captionabove"></a><a href="#cmd.captionabove">\captionabove</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.captionabove">140</a></li>
+<li><a name="cmd.captionaboveof"></a><a href="#cmd.captionaboveof">\captionaboveof</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.captionaboveof">142</a></li>
+<li><a name="cmd.captionbelow"></a><a href="#cmd.captionbelow">\captionbelow</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.captionbelow">140</a></li>
+<li><a name="cmd.captionbelowof"></a><a href="#cmd.captionbelowof">\captionbelowof</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.captionbelowof">142</a></li>
+<li><a name="cmd.captionformat"></a><a href="#cmd.captionformat">\captionformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.captionformat">147</a></li>
+<li><a name="cmd.captionof"></a><a href="#cmd.captionof">\captionof</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.captionof">142</a></li>
+<li><a name="cmd.captionsUKenglish"></a><a href="#cmd.captionsUKenglish">\captionsUKenglish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsUKenglish">544</a></li>
+<li><a name="cmd.captionsUSenglish"></a><a href="#cmd.captionsUSenglish">\captionsUSenglish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsUSenglish">544</a></li>
+<li><a name="cmd.captionsacadian"></a><a href="#cmd.captionsacadian">\captionsacadian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsacadian">544</a></li>
+<li><a name="cmd.captionsamerican"></a><a href="#cmd.captionsamerican">\captionsamerican</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsamerican">544</a></li>
+<li><a name="cmd.captionsaustralien"></a><a href="#cmd.captionsaustralien">\captionsaustralien</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsaustralien">544</a></li>
+<li><a name="cmd.captionsaustrian"></a><a href="#cmd.captionsaustrian">\captionsaustrian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsaustrian">544</a></li>
+<li><a name="cmd.captionsbritish"></a><a href="#cmd.captionsbritish">\captionsbritish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsbritish">544</a></li>
+<li><a name="cmd.captionscanadian"></a><a href="#cmd.captionscanadian">\captionscanadian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionscanadian">544</a></li>
+<li><a name="cmd.captionscanadien"></a><a href="#cmd.captionscanadien">\captionscanadien</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionscanadien">544</a></li>
+<li><a name="cmd.captionscroatian"></a><a href="#cmd.captionscroatian">\captionscroatian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionscroatian">544</a></li>
+<li><a name="cmd.captionsczech"></a><a href="#cmd.captionsczech">\captionsczech</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsczech">544</a></li>
+<li><a name="cmd.captionsdutch"></a><a href="#cmd.captionsdutch">\captionsdutch</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsdutch">544</a></li>
+<li><a name="cmd.captionsenglish"></a><a href="#cmd.captionsenglish">\captionsenglish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsenglish">544</a></li>
+<li><a name="cmd.captionsfinnish"></a><a href="#cmd.captionsfinnish">\captionsfinnish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsfinnish">544</a></li>
+<li><a name="cmd.captionsfrancais"></a><a href="#cmd.captionsfrancais">\captionsfrancais</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsfrancais">544</a></li>
+<li><a name="cmd.captionsfrench"></a><a href="#cmd.captionsfrench">\captionsfrench</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsfrench">544</a></li>
+<li><a name="cmd.captionsgerman"></a><a href="#cmd.captionsgerman">\captionsgerman</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsgerman">544</a></li>
+<li><a name="cmd.captionsitalian"></a><a href="#cmd.captionsitalian">\captionsitalian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsitalian">544</a></li>
+<li><a name="cmd.captionsnaustrian"></a><a href="#cmd.captionsnaustrian">\captionsnaustrian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsnaustrian">544</a></li>
+<li><a name="cmd.captionsnewzealand"></a><a href="#cmd.captionsnewzealand">\captionsnewzealand</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsnewzealand">544</a></li>
+<li><a name="cmd.captionsngerman"></a><a href="#cmd.captionsngerman">\captionsngerman</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsngerman">544</a></li>
+<li><a name="cmd.captionsnorsk"></a><a href="#cmd.captionsnorsk">\captionsnorsk</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsnorsk">544</a></li>
+<li><a name="cmd.captionsnswissgerman"></a><a href="#cmd.captionsnswissgerman">\captionsnswissgerman</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsnswissgerman">544</a></li>
+<li><a name="cmd.captionspolish"></a><a href="#cmd.captionspolish">\captionspolish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionspolish">544</a></li>
+<li><a name="cmd.captionsslovak"></a><a href="#cmd.captionsslovak">\captionsslovak</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsslovak">544</a></li>
+<li><a name="cmd.captionsspanish"></a><a href="#cmd.captionsspanish">\captionsspanish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsspanish">544</a></li>
+<li><a name="cmd.captionsswedish"></a><a href="#cmd.captionsswedish">\captionsswedish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsswedish">544</a></li>
+<li><a name="cmd.captionsswissgerman"></a><a href="#cmd.captionsswissgerman">\captionsswissgerman</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.captionsswissgerman">544</a></li>
+<li><a name="cmd.cc"></a><a href="#cmd.cc">\cc</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cc">182</a></li>
+<li><a name="cmd.ccname"></a><a href="#cmd.ccname">\ccname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.ccname">543</a></li>
+<li><a name="cmd.cefoot*"></a><a href="#cmd.cefoot*">\cefoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cefoot*">265</a></li>
+<li><a name="cmd.cefoot"></a><a href="#cmd.cefoot">\cefoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cefoot">262</a></li>
+<li><a name="cmd.cehead*"></a><a href="#cmd.cehead*">\cehead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cehead*">261</a></li>
+<li><a name="cmd.cehead"></a><a href="#cmd.cehead">\cehead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cehead">258</a></li>
+<li><a name="cmd.cfoot*"></a><a href="#cmd.cfoot*">\cfoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cfoot*">267</a></li>
+<li><a name="cmd.cfoot"></a><a href="#cmd.cfoot">\cfoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cfoot">266</a></li>
+<li><a name="cmd.changefontsizes"></a><a href="#cmd.changefontsizes">\changefontsizes</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.changefontsizes">494</a></li>
+<li><a name="cmd.chapapp"></a><a href="#cmd.chapapp">\chapapp</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chapapp">119</a></li>
+<li><a name="cmd.chapappifchapterprefix"></a><a href="#cmd.chapappifchapterprefix">\chapappifchapterprefix</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chapappifchapterprefix">119</a></li>
+<li><a name="cmd.chapter*"></a><a href="#cmd.chapter*">\chapter*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chapter*">112</a></li>
+<li><a name="cmd.chapter"></a><a href="#cmd.chapter">\chapter</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chapter">107</a></li>
+<li><a name="cmd.chapterformat"></a><a href="#cmd.chapterformat">\chapterformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chapterformat">117</a></li>
+<li><a name="cmd.chapterheadendvskip"></a><a href="#cmd.chapterheadendvskip">\chapterheadendvskip</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.chapterheadendvskip">509</a></li>
+<li><a name="cmd.chapterheadmidvskip"></a><a href="#cmd.chapterheadmidvskip">\chapterheadmidvskip</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.chapterheadmidvskip">509</a></li>
+<li><a name="cmd.chapterheadstartvskip"></a><a href="#cmd.chapterheadstartvskip">\chapterheadstartvskip</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.chapterheadstartvskip">509</a></li>
+<li><a name="cmd.chapterlinesformat"></a><a href="#cmd.chapterlinesformat">\chapterlinesformat</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.chapterlinesformat">512</a></li>
+<li><a name="cmd.chapterlineswithprefixformat"></a><a href="#cmd.chapterlineswithprefixformat">\chapterlineswithprefixformat</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.chapterlineswithprefixformat">512</a></li>
+<li><a name="cmd.chaptermark"></a><a href="#cmd.chaptermark">\chaptermark</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chaptermark">119</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.chaptermark">275</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.chaptermark">457</a></li>
+<li><a name="cmd.chaptermarkformat"></a><a href="#cmd.chaptermarkformat">\chaptermarkformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chaptermarkformat">119</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.chaptermarkformat">274</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.chaptermarkformat">456</a></li>
+<li><a name="cmd.chapternumdepth"></a><a href="#cmd.chapternumdepth">\chapternumdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chapternumdepth">121</a></li>
<li><a name="cmd.chapterpagestyle"></a><a href="#cmd.chapterpagestyle">\chapterpagestyle</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.chapterpagestyle">88</a></li>
-<li><a name="cmd.chead*"></a><a href="#cmd.chead*">\chead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.chead*">262</a></li>
-<li><a name="cmd.chead"></a><a href="#cmd.chead">\chead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.chead">261</a></li>
-<li><a name="cmd.cleardoubleemptypage"></a><a href="#cmd.cleardoubleemptypage">\cleardoubleemptypage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleemptypage">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleemptypage">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleemptypage">91</a></li>
-<li><a name="cmd.cleardoubleevenemptypage"></a><a href="#cmd.cleardoubleevenemptypage">\cleardoubleevenemptypage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleevenemptypage">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleevenemptypage">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleevenemptypage">91</a></li>
-<li><a name="cmd.cleardoubleevenpage"></a><a href="#cmd.cleardoubleevenpage">\cleardoubleevenpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleevenpage">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleevenpage">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleevenpage">91</a></li>
-<li><a name="cmd.cleardoubleevenpageusingstyle"></a><a href="#cmd.cleardoubleevenpageusingstyle">\cleardoubleevenpageusingstyle</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleevenpageusingstyle">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleevenpageusingstyle">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleevenpageusingstyle">91</a></li>
-<li><a name="cmd.cleardoubleevenplainpage"></a><a href="#cmd.cleardoubleevenplainpage">\cleardoubleevenplainpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleevenplainpage">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleevenplainpage">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleevenplainpage">91</a></li>
-<li><a name="cmd.cleardoubleevenstandardpage"></a><a href="#cmd.cleardoubleevenstandardpage">\cleardoubleevenstandardpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleevenstandardpage">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleevenstandardpage">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleevenstandardpage">91</a></li>
-<li><a name="cmd.cleardoubleoddemptypage"></a><a href="#cmd.cleardoubleoddemptypage">\cleardoubleoddemptypage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleoddemptypage">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleoddemptypage">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleoddemptypage">91</a></li>
-<li><a name="cmd.cleardoubleoddpage"></a><a href="#cmd.cleardoubleoddpage">\cleardoubleoddpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleoddpage">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleoddpage">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleoddpage">91</a></li>
-<li><a name="cmd.cleardoubleoddpageusingstyle"></a><a href="#cmd.cleardoubleoddpageusingstyle">\cleardoubleoddpageusingstyle</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleoddpageusingstyle">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleoddpageusingstyle">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleoddpageusingstyle">91</a></li>
-<li><a name="cmd.cleardoubleoddplainpage"></a><a href="#cmd.cleardoubleoddplainpage">\cleardoubleoddplainpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleoddplainpage">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleoddplainpage">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleoddplainpage">91</a></li>
-<li><a name="cmd.cleardoubleoddstandardpage"></a><a href="#cmd.cleardoubleoddstandardpage">\cleardoubleoddstandardpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleoddstandardpage">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleoddstandardpage">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleoddstandardpage">91</a></li>
-<li><a name="cmd.cleardoublepage"></a><a href="#cmd.cleardoublepage">\cleardoublepage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoublepage">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoublepage">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoublepage">91</a></li>
-<li><a name="cmd.cleardoublepageusingstyle"></a><a href="#cmd.cleardoublepageusingstyle">\cleardoublepageusingstyle</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoublepageusingstyle">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoublepageusingstyle">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoublepageusingstyle">91</a></li>
-<li><a name="cmd.cleardoubleplainpage"></a><a href="#cmd.cleardoubleplainpage">\cleardoubleplainpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleplainpage">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleplainpage">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleplainpage">91</a></li>
-<li><a name="cmd.cleardoublestandardpage"></a><a href="#cmd.cleardoublestandardpage">\cleardoublestandardpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoublestandardpage">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoublestandardpage">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoublestandardpage">91</a></li>
-<li><a name="cmd.clearmainofpairofpagestyles"></a><a href="#cmd.clearmainofpairofpagestyles">\clearmainofpairofpagestyles</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.clearmainofpairofpagestyles">462</a></li>
-<li><a name="cmd.clearnotecolumn"></a><a href="#cmd.clearnotecolumn">\clearnotecolumn</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.clearnotecolumn">481</a></li>
-<li><a name="cmd.clearnotecolumns"></a><a href="#cmd.clearnotecolumns">\clearnotecolumns</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.clearnotecolumns">481</a></li>
-<li><a name="cmd.clearpage"></a><a href="#cmd.clearpage">\clearpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.clearpage">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.clearpage">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.clearpage">91</a></li>
-<li><a name="cmd.clearpairofpagestyles"></a><a href="#cmd.clearpairofpagestyles">\clearpairofpagestyles</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.clearpairofpagestyles">462</a></li>
-<li><a name="cmd.clearplainofpairofpagestyles"></a><a href="#cmd.clearplainofpairofpagestyles">\clearplainofpairofpagestyles</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.clearplainofpairofpagestyles">462</a></li>
-<li><a name="cmd.closing"></a><a href="#cmd.closing">\closing</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.closing">174</a></li>
-<li><a name="cmd.cofoot*"></a><a href="#cmd.cofoot*">\cofoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cofoot*">260</a></li>
-<li><a name="cmd.cofoot"></a><a href="#cmd.cofoot">\cofoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cofoot">257</a></li>
-<li><a name="cmd.cohead*"></a><a href="#cmd.cohead*">\cohead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cohead*">256</a></li>
-<li><a name="cmd.cohead"></a><a href="#cmd.cohead">\cohead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cohead">254</a></li>
-<li><a name="cmd.currentpagestyle"></a><a href="#cmd.currentpagestyle">\currentpagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.currentpagestyle">437</a></li>
-<li><a name="cmd.customername"></a><a href="#cmd.customername">\customername</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.customername">542</a></li>
-<li><a name="cmd.date"></a><a href="#cmd.date">\date</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.date">298</a>, <a href="scrguide.pdf#desc:maincls.cmd.date">71</a></li>
-<li><a name="cmd.dateUKenglish"></a><a href="#cmd.dateUKenglish">\dateUKenglish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateUKenglish">540</a></li>
-<li><a name="cmd.dateUSenglish"></a><a href="#cmd.dateUSenglish">\dateUSenglish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateUSenglish">540</a></li>
-<li><a name="cmd.dateacadian"></a><a href="#cmd.dateacadian">\dateacadian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateacadian">540</a></li>
-<li><a name="cmd.dateamerican"></a><a href="#cmd.dateamerican">\dateamerican</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateamerican">540</a></li>
-<li><a name="cmd.dateaustralien"></a><a href="#cmd.dateaustralien">\dateaustralien</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateaustralien">540</a></li>
-<li><a name="cmd.dateaustrian"></a><a href="#cmd.dateaustrian">\dateaustrian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateaustrian">540</a></li>
-<li><a name="cmd.datebritish"></a><a href="#cmd.datebritish">\datebritish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datebritish">540</a></li>
-<li><a name="cmd.datecanadian"></a><a href="#cmd.datecanadian">\datecanadian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datecanadian">540</a></li>
-<li><a name="cmd.datecanadien"></a><a href="#cmd.datecanadien">\datecanadien</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datecanadien">540</a></li>
-<li><a name="cmd.datecroatian"></a><a href="#cmd.datecroatian">\datecroatian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datecroatian">540</a></li>
-<li><a name="cmd.dateczech"></a><a href="#cmd.dateczech">\dateczech</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateczech">540</a></li>
-<li><a name="cmd.datedutch"></a><a href="#cmd.datedutch">\datedutch</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datedutch">540</a></li>
-<li><a name="cmd.dateenglish"></a><a href="#cmd.dateenglish">\dateenglish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateenglish">540</a></li>
-<li><a name="cmd.datefinnish"></a><a href="#cmd.datefinnish">\datefinnish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datefinnish">540</a></li>
-<li><a name="cmd.datefrancais"></a><a href="#cmd.datefrancais">\datefrancais</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datefrancais">540</a></li>
-<li><a name="cmd.datefrench"></a><a href="#cmd.datefrench">\datefrench</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datefrench">540</a></li>
-<li><a name="cmd.dategerman"></a><a href="#cmd.dategerman">\dategerman</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dategerman">540</a></li>
-<li><a name="cmd.dateitalian"></a><a href="#cmd.dateitalian">\dateitalian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateitalian">540</a></li>
-<li><a name="cmd.datename"></a><a href="#cmd.datename">\datename</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datename">542</a></li>
-<li><a name="cmd.datenaustrian"></a><a href="#cmd.datenaustrian">\datenaustrian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datenaustrian">540</a></li>
-<li><a name="cmd.datenewzealand"></a><a href="#cmd.datenewzealand">\datenewzealand</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datenewzealand">540</a></li>
-<li><a name="cmd.datengerman"></a><a href="#cmd.datengerman">\datengerman</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datengerman">540</a></li>
-<li><a name="cmd.datenorsk"></a><a href="#cmd.datenorsk">\datenorsk</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datenorsk">540</a></li>
-<li><a name="cmd.datenswissgerman"></a><a href="#cmd.datenswissgerman">\datenswissgerman</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datenswissgerman">540</a></li>
-<li><a name="cmd.datepolish"></a><a href="#cmd.datepolish">\datepolish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datepolish">540</a></li>
-<li><a name="cmd.dateslovak"></a><a href="#cmd.dateslovak">\dateslovak</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateslovak">540</a></li>
-<li><a name="cmd.datespanish"></a><a href="#cmd.datespanish">\datespanish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datespanish">540</a></li>
-<li><a name="cmd.dateswedish"></a><a href="#cmd.dateswedish">\dateswedish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateswedish">540</a></li>
-<li><a name="cmd.dateswissgerman"></a><a href="#cmd.dateswissgerman">\dateswissgerman</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateswissgerman">540</a></li>
-<li><a name="cmd.dedication"></a><a href="#cmd.dedication">\dedication</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.dedication">300</a>, <a href="scrguide.pdf#desc:maincls.cmd.dedication">74</a></li>
-<li><a name="cmd.defaultreffields"></a><a href="#cmd.defaultreffields">\defaultreffields</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.defaultreffields">530</a></li>
-<li><a name="cmd.defcaptionname*"></a><a href="#cmd.defcaptionname*">\defcaptionname*</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.defcaptionname*">356</a></li>
-<li><a name="cmd.defcaptionname"></a><a href="#cmd.defcaptionname">\defcaptionname</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.defcaptionname">356</a></li>
-<li><a name="cmd.deffootnote"></a><a href="#cmd.deffootnote">\deffootnote</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.deffootnote">227</a>, <a href="scrguide.pdf#desc:scrextend.cmd.deffootnote">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.deffootnote">95</a></li>
-<li><a name="cmd.deffootnotemark"></a><a href="#cmd.deffootnotemark">\deffootnotemark</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.deffootnotemark">227</a>, <a href="scrguide.pdf#desc:scrextend.cmd.deffootnotemark">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.deffootnotemark">95</a></li>
-<li><a name="cmd.defpagestyle"></a><a href="#cmd.defpagestyle">\defpagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.defpagestyle">465</a></li>
-<li><a name="cmd.defpairofpagestyles"></a><a href="#cmd.defpairofpagestyles">\defpairofpagestyles</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.defpairofpagestyles">461</a></li>
-<li><a name="cmd.deftocheading"></a><a href="#cmd.deftocheading">\deftocheading</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.deftocheading">387</a></li>
-<li><a name="cmd.deftriplepagestyle"></a><a href="#cmd.deftriplepagestyle">\deftriplepagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.deftriplepagestyle">463</a></li>
-<li><a name="cmd.dictum"></a><a href="#cmd.dictum">\dictum</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.dictum">121</a>, <a href="scrguide.pdf#desc:scrextend.cmd.dictum">309</a></li>
-<li><a name="cmd.dictumauthorformat"></a><a href="#cmd.dictumauthorformat">\dictumauthorformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.dictumauthorformat">121</a>, <a href="scrguide.pdf#desc:scrextend.cmd.dictumauthorformat">309</a></li>
-<li><a name="cmd.dictumrule"></a><a href="#cmd.dictumrule">\dictumrule</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.dictumrule">121</a>, <a href="scrguide.pdf#desc:scrextend.cmd.dictumrule">309</a></li>
-<li><a name="cmd.dictumwidth"></a><a href="#cmd.dictumwidth">\dictumwidth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.dictumwidth">121</a>, <a href="scrguide.pdf#desc:scrextend.cmd.dictumwidth">309</a></li>
-<li><a name="cmd.documentclass"></a><a href="#cmd.documentclass">\documentclass</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.documentclass">166</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.documentclass">248</a>, <a href="scrguide.pdf#desc:scrextend.cmd.documentclass">290</a>, <a href="scrguide.pdf#desc:scrjura.cmd.documentclass">313</a>, <a href="scrguide.pdf#desc:typearea.cmd.documentclass">32</a>, <a href="scrguide.pdf#desc:scrhack.cmd.documentclass">416</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.documentclass">421</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.documentclass">470</a>, <a href="scrguide.pdf#desc:maincls.cmd.documentclass">57</a></li>
-<li><a name="cmd.doforeachtocfile"></a><a href="#cmd.doforeachtocfile">\doforeachtocfile</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.doforeachtocfile">381</a></li>
-<li><a name="cmd.edgesize"></a><a href="#cmd.edgesize">\edgesize</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.edgesize">536</a></li>
-<li><a name="cmd.ellipsispar"></a><a href="#cmd.ellipsispar">\ellipsispar</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.ellipsispar">322</a></li>
-<li><a name="cmd.emailname"></a><a href="#cmd.emailname">\emailname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.emailname">542</a></li>
-<li><a name="cmd.encl"></a><a href="#cmd.encl">\encl</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.encl">177</a></li>
-<li><a name="cmd.enclname"></a><a href="#cmd.enclname">\enclname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.enclname">542</a></li>
-<li><a name="cmd.extratitle"></a><a href="#cmd.extratitle">\extratitle</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.extratitle">297</a>, <a href="scrguide.pdf#desc:maincls.cmd.extratitle">70</a></li>
-<li><a name="cmd.faxname"></a><a href="#cmd.faxname">\faxname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.faxname">542</a></li>
-<li><a name="cmd.figureformat"></a><a href="#cmd.figureformat">\figureformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.figureformat">145</a></li>
+<li><a name="cmd.chead*"></a><a href="#cmd.chead*">\chead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.chead*">267</a></li>
+<li><a name="cmd.chead"></a><a href="#cmd.chead">\chead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.chead">266</a></li>
+<li><a name="cmd.cleardoubleemptypage"></a><a href="#cmd.cleardoubleemptypage">\cleardoubleemptypage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleemptypage">230</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleemptypage">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleemptypage">93</a></li>
+<li><a name="cmd.cleardoubleevenemptypage"></a><a href="#cmd.cleardoubleevenemptypage">\cleardoubleevenemptypage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleevenemptypage">230</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleevenemptypage">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleevenemptypage">93</a></li>
+<li><a name="cmd.cleardoubleevenpage"></a><a href="#cmd.cleardoubleevenpage">\cleardoubleevenpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleevenpage">230</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleevenpage">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleevenpage">93</a></li>
+<li><a name="cmd.cleardoubleevenpageusingstyle"></a><a href="#cmd.cleardoubleevenpageusingstyle">\cleardoubleevenpageusingstyle</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleevenpageusingstyle">230</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleevenpageusingstyle">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleevenpageusingstyle">93</a></li>
+<li><a name="cmd.cleardoubleevenplainpage"></a><a href="#cmd.cleardoubleevenplainpage">\cleardoubleevenplainpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleevenplainpage">230</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleevenplainpage">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleevenplainpage">93</a></li>
+<li><a name="cmd.cleardoubleevenstandardpage"></a><a href="#cmd.cleardoubleevenstandardpage">\cleardoubleevenstandardpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleevenstandardpage">230</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleevenstandardpage">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleevenstandardpage">93</a></li>
+<li><a name="cmd.cleardoubleoddemptypage"></a><a href="#cmd.cleardoubleoddemptypage">\cleardoubleoddemptypage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleoddemptypage">230</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleoddemptypage">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleoddemptypage">93</a></li>
+<li><a name="cmd.cleardoubleoddpage"></a><a href="#cmd.cleardoubleoddpage">\cleardoubleoddpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleoddpage">230</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleoddpage">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleoddpage">93</a></li>
+<li><a name="cmd.cleardoubleoddpageusingstyle"></a><a href="#cmd.cleardoubleoddpageusingstyle">\cleardoubleoddpageusingstyle</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleoddpageusingstyle">230</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleoddpageusingstyle">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleoddpageusingstyle">93</a></li>
+<li><a name="cmd.cleardoubleoddplainpage"></a><a href="#cmd.cleardoubleoddplainpage">\cleardoubleoddplainpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleoddplainpage">230</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleoddplainpage">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleoddplainpage">93</a></li>
+<li><a name="cmd.cleardoubleoddstandardpage"></a><a href="#cmd.cleardoubleoddstandardpage">\cleardoubleoddstandardpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleoddstandardpage">230</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleoddstandardpage">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleoddstandardpage">93</a></li>
+<li><a name="cmd.cleardoublepage"></a><a href="#cmd.cleardoublepage">\cleardoublepage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoublepage">230</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoublepage">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoublepage">93</a></li>
+<li><a name="cmd.cleardoublepageusingstyle"></a><a href="#cmd.cleardoublepageusingstyle">\cleardoublepageusingstyle</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoublepageusingstyle">230</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoublepageusingstyle">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoublepageusingstyle">93</a></li>
+<li><a name="cmd.cleardoubleplainpage"></a><a href="#cmd.cleardoubleplainpage">\cleardoubleplainpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoubleplainpage">230</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoubleplainpage">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoubleplainpage">93</a></li>
+<li><a name="cmd.cleardoublestandardpage"></a><a href="#cmd.cleardoublestandardpage">\cleardoublestandardpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.cleardoublestandardpage">230</a>, <a href="scrguide.pdf#desc:scrextend.cmd.cleardoublestandardpage">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.cleardoublestandardpage">93</a></li>
+<li><a name="cmd.clearmainofpairofpagestyles"></a><a href="#cmd.clearmainofpairofpagestyles">\clearmainofpairofpagestyles</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.clearmainofpairofpagestyles">468</a></li>
+<li><a name="cmd.clearnotecolumn"></a><a href="#cmd.clearnotecolumn">\clearnotecolumn</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.clearnotecolumn">485</a></li>
+<li><a name="cmd.clearnotecolumns"></a><a href="#cmd.clearnotecolumns">\clearnotecolumns</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.clearnotecolumns">486</a></li>
+<li><a name="cmd.clearpage"></a><a href="#cmd.clearpage">\clearpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.clearpage">230</a>, <a href="scrguide.pdf#desc:scrextend.cmd.clearpage">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.clearpage">93</a></li>
+<li><a name="cmd.clearpairofpagestyles"></a><a href="#cmd.clearpairofpagestyles">\clearpairofpagestyles</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.clearpairofpagestyles">468</a></li>
+<li><a name="cmd.clearplainofpairofpagestyles"></a><a href="#cmd.clearplainofpairofpagestyles">\clearplainofpairofpagestyles</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.clearplainofpairofpagestyles">468</a></li>
+<li><a name="cmd.closing"></a><a href="#cmd.closing">\closing</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.closing">180</a></li>
+<li><a name="cmd.cofoot*"></a><a href="#cmd.cofoot*">\cofoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cofoot*">265</a></li>
+<li><a name="cmd.cofoot"></a><a href="#cmd.cofoot">\cofoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cofoot">262</a></li>
+<li><a name="cmd.cohead*"></a><a href="#cmd.cohead*">\cohead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cohead*">261</a></li>
+<li><a name="cmd.cohead"></a><a href="#cmd.cohead">\cohead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.cohead">258</a></li>
+<li><a name="cmd.coverpagebottommargin"></a><a href="#cmd.coverpagebottommargin">\coverpagebottommargin</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.coverpagebottommargin">300</a>, <a href="scrguide.pdf#desc:maincls.cmd.coverpagebottommargin">68</a></li>
+<li><a name="cmd.coverpageleftmargin"></a><a href="#cmd.coverpageleftmargin">\coverpageleftmargin</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.coverpageleftmargin">300</a>, <a href="scrguide.pdf#desc:maincls.cmd.coverpageleftmargin">68</a></li>
+<li><a name="cmd.coverpagerightmargin"></a><a href="#cmd.coverpagerightmargin">\coverpagerightmargin</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.coverpagerightmargin">300</a>, <a href="scrguide.pdf#desc:maincls.cmd.coverpagerightmargin">68</a></li>
+<li><a name="cmd.coverpagetopmargin"></a><a href="#cmd.coverpagetopmargin">\coverpagetopmargin</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.coverpagetopmargin">300</a>, <a href="scrguide.pdf#desc:maincls.cmd.coverpagetopmargin">68</a></li>
+<li><a name="cmd.currentpagestyle"></a><a href="#cmd.currentpagestyle">\currentpagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.currentpagestyle">443</a></li>
+<li><a name="cmd.customername"></a><a href="#cmd.customername">\customername</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.customername">543</a></li>
+<li><a name="cmd.date"></a><a href="#cmd.date">\date</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.date">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.date">71</a></li>
+<li><a name="cmd.dateUKenglish"></a><a href="#cmd.dateUKenglish">\dateUKenglish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateUKenglish">545</a></li>
+<li><a name="cmd.dateUSenglish"></a><a href="#cmd.dateUSenglish">\dateUSenglish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateUSenglish">545</a></li>
+<li><a name="cmd.dateacadian"></a><a href="#cmd.dateacadian">\dateacadian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateacadian">545</a></li>
+<li><a name="cmd.dateamerican"></a><a href="#cmd.dateamerican">\dateamerican</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateamerican">545</a></li>
+<li><a name="cmd.dateaustralien"></a><a href="#cmd.dateaustralien">\dateaustralien</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateaustralien">545</a></li>
+<li><a name="cmd.dateaustrian"></a><a href="#cmd.dateaustrian">\dateaustrian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateaustrian">545</a></li>
+<li><a name="cmd.datebritish"></a><a href="#cmd.datebritish">\datebritish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datebritish">545</a></li>
+<li><a name="cmd.datecanadian"></a><a href="#cmd.datecanadian">\datecanadian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datecanadian">545</a></li>
+<li><a name="cmd.datecanadien"></a><a href="#cmd.datecanadien">\datecanadien</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datecanadien">545</a></li>
+<li><a name="cmd.datecroatian"></a><a href="#cmd.datecroatian">\datecroatian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datecroatian">545</a></li>
+<li><a name="cmd.dateczech"></a><a href="#cmd.dateczech">\dateczech</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateczech">545</a></li>
+<li><a name="cmd.datedutch"></a><a href="#cmd.datedutch">\datedutch</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datedutch">545</a></li>
+<li><a name="cmd.dateenglish"></a><a href="#cmd.dateenglish">\dateenglish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateenglish">545</a></li>
+<li><a name="cmd.datefinnish"></a><a href="#cmd.datefinnish">\datefinnish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datefinnish">545</a></li>
+<li><a name="cmd.datefrancais"></a><a href="#cmd.datefrancais">\datefrancais</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datefrancais">545</a></li>
+<li><a name="cmd.datefrench"></a><a href="#cmd.datefrench">\datefrench</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datefrench">545</a></li>
+<li><a name="cmd.dategerman"></a><a href="#cmd.dategerman">\dategerman</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dategerman">545</a></li>
+<li><a name="cmd.dateitalian"></a><a href="#cmd.dateitalian">\dateitalian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateitalian">545</a></li>
+<li><a name="cmd.datename"></a><a href="#cmd.datename">\datename</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datename">543</a></li>
+<li><a name="cmd.datenaustrian"></a><a href="#cmd.datenaustrian">\datenaustrian</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datenaustrian">545</a></li>
+<li><a name="cmd.datenewzealand"></a><a href="#cmd.datenewzealand">\datenewzealand</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datenewzealand">545</a></li>
+<li><a name="cmd.datengerman"></a><a href="#cmd.datengerman">\datengerman</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datengerman">545</a></li>
+<li><a name="cmd.datenorsk"></a><a href="#cmd.datenorsk">\datenorsk</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datenorsk">545</a></li>
+<li><a name="cmd.datenswissgerman"></a><a href="#cmd.datenswissgerman">\datenswissgerman</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datenswissgerman">545</a></li>
+<li><a name="cmd.datepolish"></a><a href="#cmd.datepolish">\datepolish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datepolish">545</a></li>
+<li><a name="cmd.dateslovak"></a><a href="#cmd.dateslovak">\dateslovak</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateslovak">545</a></li>
+<li><a name="cmd.datespanish"></a><a href="#cmd.datespanish">\datespanish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.datespanish">545</a></li>
+<li><a name="cmd.dateswedish"></a><a href="#cmd.dateswedish">\dateswedish</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateswedish">545</a></li>
+<li><a name="cmd.dateswissgerman"></a><a href="#cmd.dateswissgerman">\dateswissgerman</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.dateswissgerman">545</a></li>
+<li><a name="cmd.dedication"></a><a href="#cmd.dedication">\dedication</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.dedication">304</a>, <a href="scrguide.pdf#desc:maincls.cmd.dedication">74</a></li>
+<li><a name="cmd.defaultreffields"></a><a href="#cmd.defaultreffields">\defaultreffields</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.defaultreffields">536</a></li>
+<li><a name="cmd.defcaptionname*"></a><a href="#cmd.defcaptionname*">\defcaptionname*</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.defcaptionname*">361</a></li>
+<li><a name="cmd.defcaptionname"></a><a href="#cmd.defcaptionname">\defcaptionname</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.defcaptionname">361</a></li>
+<li><a name="cmd.deffootnote"></a><a href="#cmd.deffootnote">\deffootnote</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.deffootnote">233</a>, <a href="scrguide.pdf#desc:scrextend.cmd.deffootnote">310</a>, <a href="scrguide.pdf#desc:maincls.cmd.deffootnote">97</a></li>
+<li><a name="cmd.deffootnotemark"></a><a href="#cmd.deffootnotemark">\deffootnotemark</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.deffootnotemark">233</a>, <a href="scrguide.pdf#desc:scrextend.cmd.deffootnotemark">310</a>, <a href="scrguide.pdf#desc:maincls.cmd.deffootnotemark">97</a></li>
+<li><a name="cmd.defpagestyle"></a><a href="#cmd.defpagestyle">\defpagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.defpagestyle">469</a></li>
+<li><a name="cmd.defpairofpagestyles"></a><a href="#cmd.defpairofpagestyles">\defpairofpagestyles</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.defpairofpagestyles">467</a></li>
+<li><a name="cmd.deftocheading"></a><a href="#cmd.deftocheading">\deftocheading</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.deftocheading">392</a></li>
+<li><a name="cmd.dictum"></a><a href="#cmd.dictum">\dictum</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.dictum">124</a>, <a href="scrguide.pdf#desc:scrextend.cmd.dictum">311</a></li>
+<li><a name="cmd.dictumauthorformat"></a><a href="#cmd.dictumauthorformat">\dictumauthorformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.dictumauthorformat">124</a>, <a href="scrguide.pdf#desc:scrextend.cmd.dictumauthorformat">311</a></li>
+<li><a name="cmd.dictumrule"></a><a href="#cmd.dictumrule">\dictumrule</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.dictumrule">124</a>, <a href="scrguide.pdf#desc:scrextend.cmd.dictumrule">311</a></li>
+<li><a name="cmd.dictumwidth"></a><a href="#cmd.dictumwidth">\dictumwidth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.dictumwidth">124</a>, <a href="scrguide.pdf#desc:scrextend.cmd.dictumwidth">311</a></li>
+<li><a name="cmd.documentclass"></a><a href="#cmd.documentclass">\documentclass</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.documentclass">171</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.documentclass">253</a>, <a href="scrguide.pdf#desc:scrextend.cmd.documentclass">294</a>, <a href="scrguide.pdf#desc:scrjura.cmd.documentclass">315</a>, <a href="scrguide.pdf#desc:typearea.cmd.documentclass">32</a>, <a href="scrguide.pdf#desc:scrhack.cmd.documentclass">421</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.documentclass">426</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.documentclass">474</a>, <a href="scrguide.pdf#desc:maincls.cmd.documentclass">57</a></li>
+<li><a name="cmd.doforeachtocfile"></a><a href="#cmd.doforeachtocfile">\doforeachtocfile</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.doforeachtocfile">386</a></li>
+<li><a name="cmd.ellipsispar"></a><a href="#cmd.ellipsispar">\ellipsispar</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.ellipsispar">324</a></li>
+<li><a name="cmd.emailname"></a><a href="#cmd.emailname">\emailname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.emailname">543</a></li>
+<li><a name="cmd.encl"></a><a href="#cmd.encl">\encl</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.encl">183</a></li>
+<li><a name="cmd.enclname"></a><a href="#cmd.enclname">\enclname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.enclname">543</a></li>
+<li><a name="cmd.extratitle"></a><a href="#cmd.extratitle">\extratitle</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.extratitle">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.extratitle">70</a></li>
+<li><a name="cmd.faxname"></a><a href="#cmd.faxname">\faxname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.faxname">543</a></li>
+<li><a name="cmd.figureformat"></a><a href="#cmd.figureformat">\figureformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.figureformat">148</a></li>
<li><a name="cmd.flushbottom"></a><a href="#cmd.flushbottom">\flushbottom</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.flushbottom">60</a></li>
-<li><a name="cmd.footnote"></a><a href="#cmd.footnote">\footnote</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.footnote">226</a>, <a href="scrguide.pdf#desc:scrextend.cmd.footnote">305</a>, <a href="scrguide.pdf#desc:maincls.cmd.footnote">93</a></li>
-<li><a name="cmd.footnotemark"></a><a href="#cmd.footnotemark">\footnotemark</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.footnotemark">226</a>, <a href="scrguide.pdf#desc:scrextend.cmd.footnotemark">305</a>, <a href="scrguide.pdf#desc:maincls.cmd.footnotemark">93</a></li>
-<li><a name="cmd.footnotetext"></a><a href="#cmd.footnotetext">\footnotetext</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.footnotetext">226</a>, <a href="scrguide.pdf#desc:scrextend.cmd.footnotetext">305</a>, <a href="scrguide.pdf#desc:maincls.cmd.footnotetext">93</a></li>
-<li><a name="cmd.footref"></a><a href="#cmd.footref">\footref</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.footref">226</a>, <a href="scrguide.pdf#desc:scrextend.cmd.footref">306</a>, <a href="scrguide.pdf#desc:maincls.cmd.footref">95</a></li>
-<li><a name="cmd.frontmatter"></a><a href="#cmd.frontmatter">\frontmatter</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.frontmatter">98</a></li>
-<li><a name="cmd.headfromname"></a><a href="#cmd.headfromname">\headfromname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.headfromname">542</a></li>
-<li><a name="cmd.headmark"></a><a href="#cmd.headmark">\headmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.headmark">268</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.headmark">450</a></li>
-<li><a name="cmd.headtoname"></a><a href="#cmd.headtoname">\headtoname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.headtoname">542</a></li>
-<li><a name="cmd.if@atdocument"></a><a href="#cmd.if@atdocument">\if@atdocument</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.if@atdocument">355</a></li>
-<li><a name="cmd.if@chapter"></a><a href="#cmd.if@chapter">\if@chapter</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.if@chapter">422</a></li>
-<li><a name="cmd.if@mainmatter"></a><a href="#cmd.if@mainmatter">\if@mainmatter</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.if@mainmatter">422</a></li>
-<li><a name="cmd.ifVTeX"></a><a href="#cmd.ifVTeX">\ifVTeX</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifVTeX">352</a></li>
-<li><a name="cmd.ifattoclist"></a><a href="#cmd.ifattoclist">\ifattoclist</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.ifattoclist">378</a></li>
-<li><a name="cmd.ifdimen"></a><a href="#cmd.ifdimen">\ifdimen</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifdimen">355</a></li>
-<li><a name="cmd.ifdvioutput"></a><a href="#cmd.ifdvioutput">\ifdvioutput</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifdvioutput">352</a></li>
-<li><a name="cmd.ifiscount"></a><a href="#cmd.ifiscount">\ifiscount</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifiscount">354</a></li>
-<li><a name="cmd.ifiscounter"></a><a href="#cmd.ifiscounter">\ifiscounter</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifiscounter">354</a></li>
-<li><a name="cmd.ifisdimen"></a><a href="#cmd.ifisdimen">\ifisdimen</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifisdimen">353</a></li>
-<li><a name="cmd.ifisdimension"></a><a href="#cmd.ifisdimension">\ifisdimension</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifisdimension">353</a></li>
-<li><a name="cmd.ifisdimexpr"></a><a href="#cmd.ifisdimexpr">\ifisdimexpr</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifisdimexpr">353</a></li>
-<li><a name="cmd.ifisglue"></a><a href="#cmd.ifisglue">\ifisglue</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifisglue">353</a></li>
-<li><a name="cmd.ifisglueexpr"></a><a href="#cmd.ifisglueexpr">\ifisglueexpr</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifisglueexpr">354</a></li>
-<li><a name="cmd.ifisinteger"></a><a href="#cmd.ifisinteger">\ifisinteger</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifisinteger">354</a></li>
-<li><a name="cmd.ifisnumexpr"></a><a href="#cmd.ifisnumexpr">\ifisnumexpr</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifisnumexpr">354</a></li>
-<li><a name="cmd.ifisskip"></a><a href="#cmd.ifisskip">\ifisskip</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifisskip">353</a></li>
-<li><a name="cmd.ifkomavar"></a><a href="#cmd.ifkomavar">\ifkomavar</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.ifkomavar">164</a></li>
-<li><a name="cmd.ifkomavarempty*"></a><a href="#cmd.ifkomavarempty*">\ifkomavarempty*</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.ifkomavarempty*">164</a>, <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.ifkomavarempty*">532</a></li>
-<li><a name="cmd.ifkomavarempty"></a><a href="#cmd.ifkomavarempty">\ifkomavarempty</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.ifkomavarempty">164</a>, <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.ifkomavarempty">532</a></li>
-<li><a name="cmd.ifnotundefined"></a><a href="#cmd.ifnotundefined">\ifnotundefined</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifnotundefined">352</a></li>
-<li><a name="cmd.ifnumber"></a><a href="#cmd.ifnumber">\ifnumber</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifnumber">354</a></li>
-<li><a name="cmd.ifnumbered"></a><a href="#cmd.ifnumbered">\ifnumbered</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.ifnumbered">119</a></li>
-<li><a name="cmd.ifoot*"></a><a href="#cmd.ifoot*">\ifoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.ifoot*">262</a></li>
-<li><a name="cmd.ifoot"></a><a href="#cmd.ifoot">\ifoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.ifoot">261</a></li>
-<li><a name="cmd.ifpdfoutput"></a><a href="#cmd.ifpdfoutput">\ifpdfoutput</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifpdfoutput">352</a></li>
-<li><a name="cmd.ifpdftex"></a><a href="#cmd.ifpdftex">\ifpdftex</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifpdftex">351</a></li>
-<li><a name="cmd.ifpsoutput"></a><a href="#cmd.ifpsoutput">\ifpsoutput</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifpsoutput">352</a></li>
-<li><a name="cmd.ifstr"></a><a href="#cmd.ifstr">\ifstr</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifstr">352</a></li>
-<li><a name="cmd.ifstrstart"></a><a href="#cmd.ifstrstart">\ifstrstart</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifstrstart">353</a></li>
-<li><a name="cmd.ifthispageodd"></a><a href="#cmd.ifthispageodd">\ifthispageodd</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.ifthispageodd">218</a>, <a href="scrguide.pdf#desc:scrextend.cmd.ifthispageodd">300</a>, <a href="scrguide.pdf#desc:maincls.cmd.ifthispageodd">84</a></li>
-<li><a name="cmd.iftocfeature"></a><a href="#cmd.iftocfeature">\iftocfeature</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.iftocfeature">390</a></li>
-<li><a name="cmd.ifundefinedorrelax"></a><a href="#cmd.ifundefinedorrelax">\ifundefinedorrelax</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifundefinedorrelax">351</a></li>
-<li><a name="cmd.ifunnumbered"></a><a href="#cmd.ifunnumbered">\ifunnumbered</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.ifunnumbered">119</a></li>
-<li><a name="cmd.ihead*"></a><a href="#cmd.ihead*">\ihead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.ihead*">262</a></li>
-<li><a name="cmd.ihead"></a><a href="#cmd.ihead">\ihead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.ihead">261</a></li>
+<li><a name="cmd.footnote"></a><a href="#cmd.footnote">\footnote</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.footnote">232</a>, <a href="scrguide.pdf#desc:scrextend.cmd.footnote">309</a>, <a href="scrguide.pdf#desc:maincls.cmd.footnote">95</a></li>
+<li><a name="cmd.footnotemark"></a><a href="#cmd.footnotemark">\footnotemark</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.footnotemark">232</a>, <a href="scrguide.pdf#desc:scrextend.cmd.footnotemark">309</a>, <a href="scrguide.pdf#desc:maincls.cmd.footnotemark">95</a></li>
+<li><a name="cmd.footnotetext"></a><a href="#cmd.footnotetext">\footnotetext</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.footnotetext">232</a>, <a href="scrguide.pdf#desc:scrextend.cmd.footnotetext">309</a>, <a href="scrguide.pdf#desc:maincls.cmd.footnotetext">95</a></li>
+<li><a name="cmd.footref"></a><a href="#cmd.footref">\footref</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.footref">232</a>, <a href="scrguide.pdf#desc:scrextend.cmd.footref">309</a>, <a href="scrguide.pdf#desc:maincls.cmd.footref">97</a></li>
+<li><a name="cmd.frontispiece"></a><a href="#cmd.frontispiece">\frontispiece</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.frontispiece">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.frontispiece">70</a></li>
+<li><a name="cmd.frontmatter"></a><a href="#cmd.frontmatter">\frontmatter</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.frontmatter">100</a></li>
+<li><a name="cmd.headfromname"></a><a href="#cmd.headfromname">\headfromname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.headfromname">543</a></li>
+<li><a name="cmd.headmark"></a><a href="#cmd.headmark">\headmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.headmark">273</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.headmark">456</a></li>
+<li><a name="cmd.headtoname"></a><a href="#cmd.headtoname">\headtoname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.headtoname">543</a></li>
+<li><a name="cmd.if@atdocument"></a><a href="#cmd.if@atdocument">\if@atdocument</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.if@atdocument">358</a></li>
+<li><a name="cmd.if@chapter"></a><a href="#cmd.if@chapter">\if@chapter</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.if@chapter">428</a></li>
+<li><a name="cmd.if@mainmatter"></a><a href="#cmd.if@mainmatter">\if@mainmatter</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.if@mainmatter">428</a></li>
+<li><a name="cmd.ifVTeX"></a><a href="#cmd.ifVTeX">\ifVTeX</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifVTeX">357</a></li>
+<li><a name="cmd.ifattoclist"></a><a href="#cmd.ifattoclist">\ifattoclist</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.ifattoclist">383</a></li>
+<li><a name="cmd.ifdimen"></a><a href="#cmd.ifdimen">\ifdimen</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifdimen">359</a></li>
+<li><a name="cmd.ifdvioutput"></a><a href="#cmd.ifdvioutput">\ifdvioutput</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifdvioutput">358</a></li>
+<li><a name="cmd.ifiscount"></a><a href="#cmd.ifiscount">\ifiscount</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifiscount">360</a></li>
+<li><a name="cmd.ifiscounter"></a><a href="#cmd.ifiscounter">\ifiscounter</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifiscounter">360</a></li>
+<li><a name="cmd.ifisdimen"></a><a href="#cmd.ifisdimen">\ifisdimen</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifisdimen">358</a></li>
+<li><a name="cmd.ifisdimension"></a><a href="#cmd.ifisdimension">\ifisdimension</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifisdimension">359</a></li>
+<li><a name="cmd.ifisdimexpr"></a><a href="#cmd.ifisdimexpr">\ifisdimexpr</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifisdimexpr">359</a></li>
+<li><a name="cmd.ifisglue"></a><a href="#cmd.ifisglue">\ifisglue</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifisglue">359</a></li>
+<li><a name="cmd.ifisglueexpr"></a><a href="#cmd.ifisglueexpr">\ifisglueexpr</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifisglueexpr">359</a></li>
+<li><a name="cmd.ifisinteger"></a><a href="#cmd.ifisinteger">\ifisinteger</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifisinteger">360</a></li>
+<li><a name="cmd.ifisnumexpr"></a><a href="#cmd.ifisnumexpr">\ifisnumexpr</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifisnumexpr">360</a></li>
+<li><a name="cmd.ifisskip"></a><a href="#cmd.ifisskip">\ifisskip</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifisskip">359</a></li>
+<li><a name="cmd.ifkomavar"></a><a href="#cmd.ifkomavar">\ifkomavar</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.ifkomavar">169</a></li>
+<li><a name="cmd.ifkomavarempty*"></a><a href="#cmd.ifkomavarempty*">\ifkomavarempty*</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.ifkomavarempty*">169</a>, <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.ifkomavarempty*">538</a></li>
+<li><a name="cmd.ifkomavarempty"></a><a href="#cmd.ifkomavarempty">\ifkomavarempty</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.ifkomavarempty">169</a>, <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.ifkomavarempty">538</a></li>
+<li><a name="cmd.ifnotundefined"></a><a href="#cmd.ifnotundefined">\ifnotundefined</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifnotundefined">357</a></li>
+<li><a name="cmd.ifnumber"></a><a href="#cmd.ifnumber">\ifnumber</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifnumber">360</a></li>
+<li><a name="cmd.ifnumbered"></a><a href="#cmd.ifnumbered">\ifnumbered</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.ifnumbered">121</a></li>
+<li><a name="cmd.ifoot*"></a><a href="#cmd.ifoot*">\ifoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.ifoot*">267</a></li>
+<li><a name="cmd.ifoot"></a><a href="#cmd.ifoot">\ifoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.ifoot">266</a></li>
+<li><a name="cmd.ifpdfoutput"></a><a href="#cmd.ifpdfoutput">\ifpdfoutput</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifpdfoutput">357</a></li>
+<li><a name="cmd.ifpdftex"></a><a href="#cmd.ifpdftex">\ifpdftex</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifpdftex">357</a></li>
+<li><a name="cmd.ifpsoutput"></a><a href="#cmd.ifpsoutput">\ifpsoutput</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifpsoutput">358</a></li>
+<li><a name="cmd.ifstr"></a><a href="#cmd.ifstr">\ifstr</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifstr">358</a></li>
+<li><a name="cmd.ifstrstart"></a><a href="#cmd.ifstrstart">\ifstrstart</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifstrstart">358</a></li>
+<li><a name="cmd.ifthispageodd"></a><a href="#cmd.ifthispageodd">\ifthispageodd</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.ifthispageodd">224</a>, <a href="scrguide.pdf#desc:scrextend.cmd.ifthispageodd">305</a>, <a href="scrguide.pdf#desc:maincls.cmd.ifthispageodd">84</a></li>
+<li><a name="cmd.iftocfeature"></a><a href="#cmd.iftocfeature">\iftocfeature</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.iftocfeature">395</a></li>
+<li><a name="cmd.ifundefinedorrelax"></a><a href="#cmd.ifundefinedorrelax">\ifundefinedorrelax</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.ifundefinedorrelax">356</a></li>
+<li><a name="cmd.ifunnumbered"></a><a href="#cmd.ifunnumbered">\ifunnumbered</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.ifunnumbered">121</a></li>
+<li><a name="cmd.ihead*"></a><a href="#cmd.ihead*">\ihead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.ihead*">267</a></li>
+<li><a name="cmd.ihead"></a><a href="#cmd.ihead">\ihead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.ihead">266</a></li>
<li><a name="cmd.indexpagestyle"></a><a href="#cmd.indexpagestyle">\indexpagestyle</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.indexpagestyle">88</a></li>
-<li><a name="cmd.invoicename"></a><a href="#cmd.invoicename">\invoicename</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.invoicename">542</a></li>
-<li><a name="cmd.item"></a><a href="#cmd.item">\item</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.item">123</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.item">229</a></li>
-<li><a name="cmd.l@addto@macro"></a><a href="#cmd.l@addto@macro">\l@addto@macro</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.l@addto@macro">360</a></li>
-<li><a name="cmd.labelenumi"></a><a href="#cmd.labelenumi">\labelenumi</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.labelenumi">125</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.labelenumi">229</a></li>
-<li><a name="cmd.labelenumii"></a><a href="#cmd.labelenumii">\labelenumii</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.labelenumii">125</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.labelenumii">229</a></li>
-<li><a name="cmd.labelenumiii"></a><a href="#cmd.labelenumiii">\labelenumiii</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.labelenumiii">125</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.labelenumiii">229</a></li>
-<li><a name="cmd.labelenumiv"></a><a href="#cmd.labelenumiv">\labelenumiv</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.labelenumiv">125</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.labelenumiv">229</a></li>
-<li><a name="cmd.labelitemi"></a><a href="#cmd.labelitemi">\labelitemi</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.labelitemi">123</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.labelitemi">229</a></li>
-<li><a name="cmd.labelitemii"></a><a href="#cmd.labelitemii">\labelitemii</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.labelitemii">123</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.labelitemii">229</a></li>
-<li><a name="cmd.labelitemiii"></a><a href="#cmd.labelitemiii">\labelitemiii</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.labelitemiii">123</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.labelitemiii">229</a></li>
-<li><a name="cmd.labelitemiv"></a><a href="#cmd.labelitemiv">\labelitemiv</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.labelitemiv">123</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.labelitemiv">229</a></li>
-<li><a name="cmd.layercontentsmeasure"></a><a href="#cmd.layercontentsmeasure">\layercontentsmeasure</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.layercontentsmeasure">436</a></li>
-<li><a name="cmd.layerhalign"></a><a href="#cmd.layerhalign">\layerhalign</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.layerhalign">433</a></li>
-<li><a name="cmd.layerheight"></a><a href="#cmd.layerheight">\layerheight</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.layerheight">433</a></li>
-<li><a name="cmd.layervalign"></a><a href="#cmd.layervalign">\layervalign</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.layervalign">433</a></li>
-<li><a name="cmd.layerwidth"></a><a href="#cmd.layerwidth">\layerwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.layerwidth">433</a></li>
-<li><a name="cmd.layerxoffset"></a><a href="#cmd.layerxoffset">\layerxoffset</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.layerxoffset">433</a></li>
-<li><a name="cmd.layeryoffset"></a><a href="#cmd.layeryoffset">\layeryoffset</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.layeryoffset">433</a></li>
-<li><a name="cmd.lefoot*"></a><a href="#cmd.lefoot*">\lefoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.lefoot*">260</a></li>
-<li><a name="cmd.lefoot"></a><a href="#cmd.lefoot">\lefoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.lefoot">257</a></li>
-<li><a name="cmd.leftbotmark"></a><a href="#cmd.leftbotmark">\leftbotmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.leftbotmark">453</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.leftbotmark">459</a></li>
-<li><a name="cmd.leftfirstmark"></a><a href="#cmd.leftfirstmark">\leftfirstmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.leftfirstmark">453</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.leftfirstmark">459</a></li>
-<li><a name="cmd.leftmark"></a><a href="#cmd.leftmark">\leftmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.leftmark">268</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.leftmark">450</a></li>
-<li><a name="cmd.lefttopmark"></a><a href="#cmd.lefttopmark">\lefttopmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.lefttopmark">453</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.lefttopmark">459</a></li>
-<li><a name="cmd.lehead*"></a><a href="#cmd.lehead*">\lehead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.lehead*">256</a></li>
-<li><a name="cmd.lehead"></a><a href="#cmd.lehead">\lehead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.lehead">254</a></li>
-<li><a name="cmd.letterlastpage"></a><a href="#cmd.letterlastpage">\letterlastpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.letterlastpage">172</a></li>
-<li><a name="cmd.letterpagemark"></a><a href="#cmd.letterpagemark">\letterpagemark</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.letterpagemark">533</a></li>
-<li><a name="cmd.letterpagestyle"></a><a href="#cmd.letterpagestyle">\letterpagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.letterpagestyle">219</a></li>
-<li><a name="cmd.listof/Dateierweiterung/name"></a><a href="#cmd.listof/Dateierweiterung/name">\listof/Dateierweiterung/name</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.listof/Dateierweiterung/name">384</a></li>
-<li><a name="cmd.listof/Zielendung/"></a><a href="#cmd.listof/Zielendung/">\listof/Zielendung/</a> --&gt; <a href="scrguide.pdf#desc:scrwfile.cmd.listof/Zielendung/">375</a></li>
-<li><a name="cmd.listofeachtoc"></a><a href="#cmd.listofeachtoc">\listofeachtoc</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.listofeachtoc">384</a></li>
-<li><a name="cmd.listoffigures"></a><a href="#cmd.listoffigures">\listoffigures</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.listoffigures">152</a></li>
-<li><a name="cmd.listoftables"></a><a href="#cmd.listoftables">\listoftables</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.listoftables">152</a></li>
-<li><a name="cmd.listoftoc*"></a><a href="#cmd.listoftoc*">\listoftoc*</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.listoftoc*">384</a></li>
-<li><a name="cmd.listoftoc"></a><a href="#cmd.listoftoc">\listoftoc</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.listoftoc">384</a></li>
-<li><a name="cmd.lofoot*"></a><a href="#cmd.lofoot*">\lofoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.lofoot*">260</a></li>
-<li><a name="cmd.lofoot"></a><a href="#cmd.lofoot">\lofoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.lofoot">257</a></li>
-<li><a name="cmd.lohead*"></a><a href="#cmd.lohead*">\lohead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.lohead*">256</a></li>
-<li><a name="cmd.lohead"></a><a href="#cmd.lohead">\lohead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.lohead">254</a></li>
-<li><a name="cmd.lowertitleback"></a><a href="#cmd.lowertitleback">\lowertitleback</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.lowertitleback">300</a>, <a href="scrguide.pdf#desc:maincls.cmd.lowertitleback">73</a></li>
-<li><a name="cmd.mainmatter"></a><a href="#cmd.mainmatter">\mainmatter</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.mainmatter">98</a></li>
-<li><a name="cmd.makenote*"></a><a href="#cmd.makenote*">\makenote*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.makenote*">477</a></li>
-<li><a name="cmd.makenote"></a><a href="#cmd.makenote">\makenote</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.makenote">477</a></li>
-<li><a name="cmd.maketitle"></a><a href="#cmd.maketitle">\maketitle</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.maketitle">297</a>, <a href="scrguide.pdf#desc:maincls.cmd.maketitle">69</a></li>
-<li><a name="cmd.manualmark"></a><a href="#cmd.manualmark">\manualmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.manualmark">264</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.manualmark">448</a></li>
-<li><a name="cmd.marginline"></a><a href="#cmd.marginline">\marginline</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.marginline">152</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.marginline">232</a>, <a href="scrguide.pdf#desc:scrextend.cmd.marginline">312</a></li>
-<li><a name="cmd.marginpar"></a><a href="#cmd.marginpar">\marginpar</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.marginpar">152</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.marginpar">232</a>, <a href="scrguide.pdf#desc:scrextend.cmd.marginpar">312</a></li>
-<li><a name="cmd.markboth"></a><a href="#cmd.markboth">\markboth</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.markboth">222</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.markboth">271</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.markboth">452</a>, <a href="scrguide.pdf#desc:maincls.cmd.markboth">87</a></li>
-<li><a name="cmd.markleft"></a><a href="#cmd.markleft">\markleft</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.markleft">271</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.markleft">452</a></li>
-<li><a name="cmd.markright"></a><a href="#cmd.markright">\markright</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.markright">222</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.markright">271</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.markright">452</a>, <a href="scrguide.pdf#desc:maincls.cmd.markright">87</a></li>
-<li><a name="cmd.minisec"></a><a href="#cmd.minisec">\minisec</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.minisec">111</a></li>
-<li><a name="cmd.mobilephonename"></a><a href="#cmd.mobilephonename">\mobilephonename</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.mobilephonename">542</a></li>
-<li><a name="cmd.multfootsep"></a><a href="#cmd.multfootsep">\multfootsep</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.multfootsep">226</a>, <a href="scrguide.pdf#desc:scrextend.cmd.multfootsep">305</a>, <a href="scrguide.pdf#desc:maincls.cmd.multfootsep">93</a></li>
-<li><a name="cmd.multiplefootnoteseparator"></a><a href="#cmd.multiplefootnoteseparator">\multiplefootnoteseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.multiplefootnoteseparator">226</a>, <a href="scrguide.pdf#desc:scrextend.cmd.multiplefootnoteseparator">305</a>, <a href="scrguide.pdf#desc:maincls.cmd.multiplefootnoteseparator">93</a></li>
-<li><a name="cmd.myrefname"></a><a href="#cmd.myrefname">\myrefname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.myrefname">542</a></li>
-<li><a name="cmd.nameday"></a><a href="#cmd.nameday">\nameday</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.nameday">280</a></li>
-<li><a name="cmd.newbibstyle"></a><a href="#cmd.newbibstyle">\newbibstyle</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.newbibstyle">512</a></li>
-<li><a name="cmd.newblock"></a><a href="#cmd.newblock">\newblock</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.newblock">512</a></li>
-<li><a name="cmd.newcaptionname*"></a><a href="#cmd.newcaptionname*">\newcaptionname*</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.newcaptionname*">356</a></li>
-<li><a name="cmd.newcaptionname"></a><a href="#cmd.newcaptionname">\newcaptionname</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.newcaptionname">356</a></li>
-<li><a name="cmd.newdaylanguage"></a><a href="#cmd.newdaylanguage">\newdaylanguage</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.newdaylanguage">280</a></li>
-<li><a name="cmd.newkomafont"></a><a href="#cmd.newkomafont">\newkomafont</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.newkomafont">491</a></li>
-<li><a name="cmd.newkomavar*"></a><a href="#cmd.newkomavar*">\newkomavar*</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.newkomavar*">530</a></li>
-<li><a name="cmd.newkomavar"></a><a href="#cmd.newkomavar">\newkomavar</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.newkomavar">530</a></li>
-<li><a name="cmd.newpagestyle"></a><a href="#cmd.newpagestyle">\newpagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.newpagestyle">465</a></li>
-<li><a name="cmd.newpairofpagestyles"></a><a href="#cmd.newpairofpagestyles">\newpairofpagestyles</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.newpairofpagestyles">461</a></li>
-<li><a name="cmd.newtriplepagestyle"></a><a href="#cmd.newtriplepagestyle">\newtriplepagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.newtriplepagestyle">463</a></li>
-<li><a name="cmd.nonumberline"></a><a href="#cmd.nonumberline">\nonumberline</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.nonumberline">404</a></li>
-<li><a name="cmd.numberline"></a><a href="#cmd.numberline">\numberline</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.numberline">390</a></li>
-<li><a name="cmd.ofoot*"></a><a href="#cmd.ofoot*">\ofoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.ofoot*">262</a></li>
-<li><a name="cmd.ofoot"></a><a href="#cmd.ofoot">\ofoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.ofoot">261</a></li>
-<li><a name="cmd.ohead*"></a><a href="#cmd.ohead*">\ohead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.ohead*">262</a></li>
-<li><a name="cmd.ohead"></a><a href="#cmd.ohead">\ohead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.ohead">261</a></li>
-<li><a name="cmd.opening"></a><a href="#cmd.opening">\opening</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.opening">173</a></li>
-<li><a name="cmd.othersectionlevelsformat"></a><a href="#cmd.othersectionlevelsformat">\othersectionlevelsformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.othersectionlevelsformat">115</a></li>
-<li><a name="cmd.pagemark"></a><a href="#cmd.pagemark">\pagemark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.pagemark">268</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.pagemark">450</a>, <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.pagemark">533</a></li>
-<li><a name="cmd.pagename"></a><a href="#cmd.pagename">\pagename</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.pagename">542</a></li>
-<li><a name="cmd.pagenumbering"></a><a href="#cmd.pagenumbering">\pagenumbering</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.pagenumbering">89</a></li>
-<li><a name="cmd.pagestyle"></a><a href="#cmd.pagestyle">\pagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.pagestyle">220</a>, <a href="scrguide.pdf#desc:maincls.cmd.pagestyle">85</a></li>
-<li><a name="cmd.paragraph*"></a><a href="#cmd.paragraph*">\paragraph*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.paragraph*">110</a></li>
-<li><a name="cmd.paragraph"></a><a href="#cmd.paragraph">\paragraph</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.paragraph">105</a></li>
-<li><a name="cmd.paragraphformat"></a><a href="#cmd.paragraphformat">\paragraphformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.paragraphformat">115</a></li>
-<li><a name="cmd.paragraphmark"></a><a href="#cmd.paragraphmark">\paragraphmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.paragraphmark">271</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.paragraphmark">451</a></li>
-<li><a name="cmd.paragraphmarkformat"></a><a href="#cmd.paragraphmarkformat">\paragraphmarkformat</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.paragraphmarkformat">270</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.paragraphmarkformat">451</a></li>
-<li><a name="cmd.paragraphnumdepth"></a><a href="#cmd.paragraphnumdepth">\paragraphnumdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.paragraphnumdepth">118</a></li>
-<li><a name="cmd.parellipsis"></a><a href="#cmd.parellipsis">\parellipsis</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.parellipsis">322</a></li>
-<li><a name="cmd.parformat"></a><a href="#cmd.parformat">\parformat</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.parformat">321</a></li>
-<li><a name="cmd.parformatseparation"></a><a href="#cmd.parformatseparation">\parformatseparation</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.parformatseparation">321</a></li>
-<li><a name="cmd.parname"></a><a href="#cmd.parname">\parname</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.parname">328</a></li>
-<li><a name="cmd.parshortname"></a><a href="#cmd.parshortname">\parshortname</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.parshortname">328</a></li>
-<li><a name="cmd.part*"></a><a href="#cmd.part*">\part*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.part*">110</a></li>
-<li><a name="cmd.part"></a><a href="#cmd.part">\part</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.part">105</a></li>
-<li><a name="cmd.partformat"></a><a href="#cmd.partformat">\partformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.partformat">115</a></li>
-<li><a name="cmd.partheademptypage"></a><a href="#cmd.partheademptypage">\partheademptypage</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.partheademptypage">504</a></li>
-<li><a name="cmd.partheadendvskip"></a><a href="#cmd.partheadendvskip">\partheadendvskip</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.partheadendvskip">504</a></li>
-<li><a name="cmd.partheadmidvskip"></a><a href="#cmd.partheadmidvskip">\partheadmidvskip</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.partheadmidvskip">504</a></li>
-<li><a name="cmd.partheadstartvskip"></a><a href="#cmd.partheadstartvskip">\partheadstartvskip</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.partheadstartvskip">504</a></li>
-<li><a name="cmd.partmark"></a><a href="#cmd.partmark">\partmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.partmark">271</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.partmark">451</a></li>
-<li><a name="cmd.partmarkformat"></a><a href="#cmd.partmarkformat">\partmarkformat</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.partmarkformat">270</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.partmarkformat">451</a></li>
-<li><a name="cmd.partnumdepth"></a><a href="#cmd.partnumdepth">\partnumdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.partnumdepth">118</a></li>
+<li><a name="cmd.invoicename"></a><a href="#cmd.invoicename">\invoicename</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.invoicename">543</a></li>
+<li><a name="cmd.item"></a><a href="#cmd.item">\item</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.item">126</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.item">235</a></li>
+<li><a name="cmd.l@addto@macro"></a><a href="#cmd.l@addto@macro">\l@addto@macro</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.l@addto@macro">366</a></li>
+<li><a name="cmd.labelenumi"></a><a href="#cmd.labelenumi">\labelenumi</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.labelenumi">128</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.labelenumi">235</a></li>
+<li><a name="cmd.labelenumii"></a><a href="#cmd.labelenumii">\labelenumii</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.labelenumii">128</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.labelenumii">235</a></li>
+<li><a name="cmd.labelenumiii"></a><a href="#cmd.labelenumiii">\labelenumiii</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.labelenumiii">128</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.labelenumiii">235</a></li>
+<li><a name="cmd.labelenumiv"></a><a href="#cmd.labelenumiv">\labelenumiv</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.labelenumiv">128</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.labelenumiv">235</a></li>
+<li><a name="cmd.labelitemi"></a><a href="#cmd.labelitemi">\labelitemi</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.labelitemi">126</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.labelitemi">235</a></li>
+<li><a name="cmd.labelitemii"></a><a href="#cmd.labelitemii">\labelitemii</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.labelitemii">126</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.labelitemii">235</a></li>
+<li><a name="cmd.labelitemiii"></a><a href="#cmd.labelitemiii">\labelitemiii</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.labelitemiii">126</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.labelitemiii">235</a></li>
+<li><a name="cmd.labelitemiv"></a><a href="#cmd.labelitemiv">\labelitemiv</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.labelitemiv">126</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.labelitemiv">235</a></li>
+<li><a name="cmd.layercontentsmeasure"></a><a href="#cmd.layercontentsmeasure">\layercontentsmeasure</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.layercontentsmeasure">442</a></li>
+<li><a name="cmd.layerhalign"></a><a href="#cmd.layerhalign">\layerhalign</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.layerhalign">439</a></li>
+<li><a name="cmd.layerheight"></a><a href="#cmd.layerheight">\layerheight</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.layerheight">439</a></li>
+<li><a name="cmd.layervalign"></a><a href="#cmd.layervalign">\layervalign</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.layervalign">439</a></li>
+<li><a name="cmd.layerwidth"></a><a href="#cmd.layerwidth">\layerwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.layerwidth">439</a></li>
+<li><a name="cmd.layerxoffset"></a><a href="#cmd.layerxoffset">\layerxoffset</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.layerxoffset">439</a></li>
+<li><a name="cmd.layeryoffset"></a><a href="#cmd.layeryoffset">\layeryoffset</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.layeryoffset">439</a></li>
+<li><a name="cmd.lefoot*"></a><a href="#cmd.lefoot*">\lefoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.lefoot*">265</a></li>
+<li><a name="cmd.lefoot"></a><a href="#cmd.lefoot">\lefoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.lefoot">262</a></li>
+<li><a name="cmd.leftbotmark"></a><a href="#cmd.leftbotmark">\leftbotmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.leftbotmark">458</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.leftbotmark">465</a></li>
+<li><a name="cmd.leftfirstmark"></a><a href="#cmd.leftfirstmark">\leftfirstmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.leftfirstmark">458</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.leftfirstmark">465</a></li>
+<li><a name="cmd.leftmark"></a><a href="#cmd.leftmark">\leftmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.leftmark">273</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.leftmark">456</a></li>
+<li><a name="cmd.lefttopmark"></a><a href="#cmd.lefttopmark">\lefttopmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.lefttopmark">458</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.lefttopmark">465</a></li>
+<li><a name="cmd.lehead*"></a><a href="#cmd.lehead*">\lehead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.lehead*">261</a></li>
+<li><a name="cmd.lehead"></a><a href="#cmd.lehead">\lehead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.lehead">258</a></li>
+<li><a name="cmd.letterlastpage"></a><a href="#cmd.letterlastpage">\letterlastpage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.letterlastpage">178</a></li>
+<li><a name="cmd.letterpagestyle"></a><a href="#cmd.letterpagestyle">\letterpagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.letterpagestyle">225</a></li>
+<li><a name="cmd.listof/Dateierweiterung/name"></a><a href="#cmd.listof/Dateierweiterung/name">\listof/Dateierweiterung/name</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.listof/Dateierweiterung/name">389</a></li>
+<li><a name="cmd.listof/Zielendung/"></a><a href="#cmd.listof/Zielendung/">\listof/Zielendung/</a> --&gt; <a href="scrguide.pdf#desc:scrwfile.cmd.listof/Zielendung/">381</a></li>
+<li><a name="cmd.listofeachtoc"></a><a href="#cmd.listofeachtoc">\listofeachtoc</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.listofeachtoc">389</a></li>
+<li><a name="cmd.listoffigures"></a><a href="#cmd.listoffigures">\listoffigures</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.listoffigures">156</a></li>
+<li><a name="cmd.listoftables"></a><a href="#cmd.listoftables">\listoftables</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.listoftables">156</a></li>
+<li><a name="cmd.listoftoc*"></a><a href="#cmd.listoftoc*">\listoftoc*</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.listoftoc*">389</a></li>
+<li><a name="cmd.listoftoc"></a><a href="#cmd.listoftoc">\listoftoc</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.listoftoc">389</a></li>
+<li><a name="cmd.lofoot*"></a><a href="#cmd.lofoot*">\lofoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.lofoot*">265</a></li>
+<li><a name="cmd.lofoot"></a><a href="#cmd.lofoot">\lofoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.lofoot">262</a></li>
+<li><a name="cmd.lohead*"></a><a href="#cmd.lohead*">\lohead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.lohead*">261</a></li>
+<li><a name="cmd.lohead"></a><a href="#cmd.lohead">\lohead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.lohead">258</a></li>
+<li><a name="cmd.lowertitleback"></a><a href="#cmd.lowertitleback">\lowertitleback</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.lowertitleback">304</a>, <a href="scrguide.pdf#desc:maincls.cmd.lowertitleback">74</a></li>
+<li><a name="cmd.mainmatter"></a><a href="#cmd.mainmatter">\mainmatter</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.mainmatter">100</a></li>
+<li><a name="cmd.makenote*"></a><a href="#cmd.makenote*">\makenote*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.makenote*">482</a></li>
+<li><a name="cmd.makenote"></a><a href="#cmd.makenote">\makenote</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.makenote">482</a></li>
+<li><a name="cmd.maketitle"></a><a href="#cmd.maketitle">\maketitle</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.maketitle">301</a>, <a href="scrguide.pdf#desc:maincls.cmd.maketitle">69</a></li>
+<li><a name="cmd.manualmark"></a><a href="#cmd.manualmark">\manualmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.manualmark">269</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.manualmark">453</a></li>
+<li><a name="cmd.marginline"></a><a href="#cmd.marginline">\marginline</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.marginline">157</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.marginline">238</a>, <a href="scrguide.pdf#desc:scrextend.cmd.marginline">314</a></li>
+<li><a name="cmd.marginpar"></a><a href="#cmd.marginpar">\marginpar</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.marginpar">157</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.marginpar">238</a>, <a href="scrguide.pdf#desc:scrextend.cmd.marginpar">314</a></li>
+<li><a name="cmd.markboth"></a><a href="#cmd.markboth">\markboth</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.markboth">229</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.markboth">275</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.markboth">457</a>, <a href="scrguide.pdf#desc:maincls.cmd.markboth">88</a></li>
+<li><a name="cmd.markleft"></a><a href="#cmd.markleft">\markleft</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.markleft">275</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.markleft">457</a></li>
+<li><a name="cmd.markright"></a><a href="#cmd.markright">\markright</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.markright">229</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.markright">275</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.markright">457</a>, <a href="scrguide.pdf#desc:maincls.cmd.markright">88</a></li>
+<li><a name="cmd.minisec"></a><a href="#cmd.minisec">\minisec</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.minisec">113</a></li>
+<li><a name="cmd.mobilephonename"></a><a href="#cmd.mobilephonename">\mobilephonename</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.mobilephonename">543</a></li>
+<li><a name="cmd.multfootsep"></a><a href="#cmd.multfootsep">\multfootsep</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.multfootsep">231</a>, <a href="scrguide.pdf#desc:scrextend.cmd.multfootsep">308</a>, <a href="scrguide.pdf#desc:maincls.cmd.multfootsep">95</a></li>
+<li><a name="cmd.multiplefootnoteseparator"></a><a href="#cmd.multiplefootnoteseparator">\multiplefootnoteseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.multiplefootnoteseparator">232</a>, <a href="scrguide.pdf#desc:scrextend.cmd.multiplefootnoteseparator">309</a>, <a href="scrguide.pdf#desc:maincls.cmd.multiplefootnoteseparator">95</a></li>
+<li><a name="cmd.myrefname"></a><a href="#cmd.myrefname">\myrefname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.myrefname">543</a></li>
+<li><a name="cmd.nameday"></a><a href="#cmd.nameday">\nameday</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.nameday">284</a></li>
+<li><a name="cmd.newbibstyle"></a><a href="#cmd.newbibstyle">\newbibstyle</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.newbibstyle">518</a></li>
+<li><a name="cmd.newblock"></a><a href="#cmd.newblock">\newblock</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.newblock">518</a></li>
+<li><a name="cmd.newcaptionname*"></a><a href="#cmd.newcaptionname*">\newcaptionname*</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.newcaptionname*">361</a></li>
+<li><a name="cmd.newcaptionname"></a><a href="#cmd.newcaptionname">\newcaptionname</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.newcaptionname">361</a></li>
+<li><a name="cmd.newdaylanguage"></a><a href="#cmd.newdaylanguage">\newdaylanguage</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.newdaylanguage">284</a></li>
+<li><a name="cmd.newkomafont"></a><a href="#cmd.newkomafont">\newkomafont</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.newkomafont">495</a></li>
+<li><a name="cmd.newkomavar*"></a><a href="#cmd.newkomavar*">\newkomavar*</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.newkomavar*">536</a></li>
+<li><a name="cmd.newkomavar"></a><a href="#cmd.newkomavar">\newkomavar</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.newkomavar">536</a></li>
+<li><a name="cmd.newpagestyle"></a><a href="#cmd.newpagestyle">\newpagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.newpagestyle">469</a></li>
+<li><a name="cmd.newpairofpagestyles"></a><a href="#cmd.newpairofpagestyles">\newpairofpagestyles</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.newpairofpagestyles">467</a></li>
+<li><a name="cmd.nonumberline"></a><a href="#cmd.nonumberline">\nonumberline</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.nonumberline">410</a></li>
+<li><a name="cmd.numberline"></a><a href="#cmd.numberline">\numberline</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.numberline">396</a></li>
+<li><a name="cmd.ofoot*"></a><a href="#cmd.ofoot*">\ofoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.ofoot*">267</a></li>
+<li><a name="cmd.ofoot"></a><a href="#cmd.ofoot">\ofoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.ofoot">266</a></li>
+<li><a name="cmd.ohead*"></a><a href="#cmd.ohead*">\ohead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.ohead*">267</a></li>
+<li><a name="cmd.ohead"></a><a href="#cmd.ohead">\ohead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.ohead">266</a></li>
+<li><a name="cmd.opening"></a><a href="#cmd.opening">\opening</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.opening">178</a></li>
+<li><a name="cmd.othersectionlevelsformat"></a><a href="#cmd.othersectionlevelsformat">\othersectionlevelsformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.othersectionlevelsformat">117</a></li>
+<li><a name="cmd.pagemark"></a><a href="#cmd.pagemark">\pagemark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.pagemark">273</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.pagemark">456</a></li>
+<li><a name="cmd.pagename"></a><a href="#cmd.pagename">\pagename</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.pagename">543</a></li>
+<li><a name="cmd.pagenumbering"></a><a href="#cmd.pagenumbering">\pagenumbering</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.pagenumbering">90</a></li>
+<li><a name="cmd.pagestyle"></a><a href="#cmd.pagestyle">\pagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.pagestyle">226</a>, <a href="scrguide.pdf#desc:maincls.cmd.pagestyle">86</a></li>
+<li><a name="cmd.paragraph*"></a><a href="#cmd.paragraph*">\paragraph*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.paragraph*">112</a></li>
+<li><a name="cmd.paragraph"></a><a href="#cmd.paragraph">\paragraph</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.paragraph">107</a></li>
+<li><a name="cmd.paragraphformat"></a><a href="#cmd.paragraphformat">\paragraphformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.paragraphformat">117</a></li>
+<li><a name="cmd.paragraphmark"></a><a href="#cmd.paragraphmark">\paragraphmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.paragraphmark">275</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.paragraphmark">457</a></li>
+<li><a name="cmd.paragraphmarkformat"></a><a href="#cmd.paragraphmarkformat">\paragraphmarkformat</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.paragraphmarkformat">274</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.paragraphmarkformat">456</a></li>
+<li><a name="cmd.paragraphnumdepth"></a><a href="#cmd.paragraphnumdepth">\paragraphnumdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.paragraphnumdepth">121</a></li>
+<li><a name="cmd.paragraphtocdepth"></a><a href="#cmd.paragraphtocdepth">\paragraphtocdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.paragraphtocdepth">81</a></li>
+<li><a name="cmd.parellipsis"></a><a href="#cmd.parellipsis">\parellipsis</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.parellipsis">324</a></li>
+<li><a name="cmd.parformat"></a><a href="#cmd.parformat">\parformat</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.parformat">324</a></li>
+<li><a name="cmd.parformatseparation"></a><a href="#cmd.parformatseparation">\parformatseparation</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.parformatseparation">324</a></li>
+<li><a name="cmd.parname"></a><a href="#cmd.parname">\parname</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.parname">331</a></li>
+<li><a name="cmd.parshortname"></a><a href="#cmd.parshortname">\parshortname</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.parshortname">331</a></li>
+<li><a name="cmd.part*"></a><a href="#cmd.part*">\part*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.part*">112</a></li>
+<li><a name="cmd.part"></a><a href="#cmd.part">\part</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.part">107</a></li>
+<li><a name="cmd.partformat"></a><a href="#cmd.partformat">\partformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.partformat">117</a></li>
+<li><a name="cmd.partheademptypage"></a><a href="#cmd.partheademptypage">\partheademptypage</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.partheademptypage">509</a></li>
+<li><a name="cmd.partheadendvskip"></a><a href="#cmd.partheadendvskip">\partheadendvskip</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.partheadendvskip">509</a></li>
+<li><a name="cmd.partheadmidvskip"></a><a href="#cmd.partheadmidvskip">\partheadmidvskip</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.partheadmidvskip">509</a></li>
+<li><a name="cmd.partheadstartvskip"></a><a href="#cmd.partheadstartvskip">\partheadstartvskip</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.partheadstartvskip">509</a></li>
+<li><a name="cmd.partlineswithprefixformat"></a><a href="#cmd.partlineswithprefixformat">\partlineswithprefixformat</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.partlineswithprefixformat">510</a></li>
+<li><a name="cmd.partmark"></a><a href="#cmd.partmark">\partmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.partmark">275</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.partmark">457</a></li>
+<li><a name="cmd.partmarkformat"></a><a href="#cmd.partmarkformat">\partmarkformat</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.partmarkformat">274</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.partmarkformat">456</a></li>
+<li><a name="cmd.partnumdepth"></a><a href="#cmd.partnumdepth">\partnumdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.partnumdepth">121</a></li>
<li><a name="cmd.partpagestyle"></a><a href="#cmd.partpagestyle">\partpagestyle</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.partpagestyle">88</a></li>
-<li><a name="cmd.phonename"></a><a href="#cmd.phonename">\phonename</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.phonename">542</a></li>
-<li><a name="cmd.providecaptionname*"></a><a href="#cmd.providecaptionname*">\providecaptionname*</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.providecaptionname*">356</a></li>
-<li><a name="cmd.providecaptionname"></a><a href="#cmd.providecaptionname">\providecaptionname</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.providecaptionname">356</a></li>
-<li><a name="cmd.providepagestyle"></a><a href="#cmd.providepagestyle">\providepagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.providepagestyle">465</a></li>
-<li><a name="cmd.providepairofpagestyles"></a><a href="#cmd.providepairofpagestyles">\providepairofpagestyles</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.providepairofpagestyles">461</a></li>
-<li><a name="cmd.providetriplepagestyle"></a><a href="#cmd.providetriplepagestyle">\providetriplepagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.providetriplepagestyle">463</a></li>
-<li><a name="cmd.ps"></a><a href="#cmd.ps">\ps</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.ps">175</a></li>
-<li><a name="cmd.publishers"></a><a href="#cmd.publishers">\publishers</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.publishers">298</a>, <a href="scrguide.pdf#desc:maincls.cmd.publishers">71</a></li>
-<li><a name="cmd.putC"></a><a href="#cmd.putC">\putC</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.putC">434</a></li>
-<li><a name="cmd.putLL"></a><a href="#cmd.putLL">\putLL</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.putLL">434</a></li>
-<li><a name="cmd.putLR"></a><a href="#cmd.putLR">\putLR</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.putLR">434</a></li>
-<li><a name="cmd.putUL"></a><a href="#cmd.putUL">\putUL</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.putUL">434</a></li>
-<li><a name="cmd.putUR"></a><a href="#cmd.putUR">\putUR</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.putUR">434</a></li>
+<li><a name="cmd.parttocdepth"></a><a href="#cmd.parttocdepth">\parttocdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.parttocdepth">81</a></li>
+<li><a name="cmd.phonename"></a><a href="#cmd.phonename">\phonename</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.phonename">543</a></li>
+<li><a name="cmd.providecaptionname*"></a><a href="#cmd.providecaptionname*">\providecaptionname*</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.providecaptionname*">361</a></li>
+<li><a name="cmd.providecaptionname"></a><a href="#cmd.providecaptionname">\providecaptionname</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.providecaptionname">361</a></li>
+<li><a name="cmd.providepagestyle"></a><a href="#cmd.providepagestyle">\providepagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.providepagestyle">469</a></li>
+<li><a name="cmd.providepairofpagestyles"></a><a href="#cmd.providepairofpagestyles">\providepairofpagestyles</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.providepairofpagestyles">467</a></li>
+<li><a name="cmd.ps"></a><a href="#cmd.ps">\ps</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.ps">180</a></li>
+<li><a name="cmd.publishers"></a><a href="#cmd.publishers">\publishers</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.publishers">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.publishers">71</a></li>
+<li><a name="cmd.putC"></a><a href="#cmd.putC">\putC</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.putC">440</a></li>
+<li><a name="cmd.putLL"></a><a href="#cmd.putLL">\putLL</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.putLL">440</a></li>
+<li><a name="cmd.putLR"></a><a href="#cmd.putLR">\putLR</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.putLR">440</a></li>
+<li><a name="cmd.putUL"></a><a href="#cmd.putUL">\putUL</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.putUL">440</a></li>
+<li><a name="cmd.putUR"></a><a href="#cmd.putUR">\putUR</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.putUR">440</a></li>
<li><a name="cmd.raggedbottom"></a><a href="#cmd.raggedbottom">\raggedbottom</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.raggedbottom">60</a></li>
-<li><a name="cmd.raggedchapter"></a><a href="#cmd.raggedchapter">\raggedchapter</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.raggedchapter">113</a></li>
-<li><a name="cmd.raggedchapterentry"></a><a href="#cmd.raggedchapterentry">\raggedchapterentry</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.raggedchapterentry">490</a></li>
-<li><a name="cmd.raggeddictum"></a><a href="#cmd.raggeddictum">\raggeddictum</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.raggeddictum">121</a>, <a href="scrguide.pdf#desc:scrextend.cmd.raggeddictum">309</a></li>
-<li><a name="cmd.raggeddictumauthor"></a><a href="#cmd.raggeddictumauthor">\raggeddictumauthor</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.raggeddictumauthor">121</a>, <a href="scrguide.pdf#desc:scrextend.cmd.raggeddictumauthor">309</a></li>
-<li><a name="cmd.raggeddictumtext"></a><a href="#cmd.raggeddictumtext">\raggeddictumtext</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.raggeddictumtext">121</a>, <a href="scrguide.pdf#desc:scrextend.cmd.raggeddictumtext">309</a></li>
-<li><a name="cmd.raggedfootnote"></a><a href="#cmd.raggedfootnote">\raggedfootnote</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.raggedfootnote">228</a>, <a href="scrguide.pdf#desc:scrextend.cmd.raggedfootnote">309</a>, <a href="scrguide.pdf#desc:maincls.cmd.raggedfootnote">97</a></li>
-<li><a name="cmd.raggedpart"></a><a href="#cmd.raggedpart">\raggedpart</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.raggedpart">113</a></li>
-<li><a name="cmd.raggedsection"></a><a href="#cmd.raggedsection">\raggedsection</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.raggedsection">113</a></li>
-<li><a name="cmd.raggedsignature"></a><a href="#cmd.raggedsignature">\raggedsignature</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.raggedsignature">233</a></li>
+<li><a name="cmd.raggedchapter"></a><a href="#cmd.raggedchapter">\raggedchapter</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.raggedchapter">115</a></li>
+<li><a name="cmd.raggedchapterentry"></a><a href="#cmd.raggedchapterentry">\raggedchapterentry</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.raggedchapterentry">494</a></li>
+<li><a name="cmd.raggeddictum"></a><a href="#cmd.raggeddictum">\raggeddictum</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.raggeddictum">124</a>, <a href="scrguide.pdf#desc:scrextend.cmd.raggeddictum">311</a></li>
+<li><a name="cmd.raggeddictumauthor"></a><a href="#cmd.raggeddictumauthor">\raggeddictumauthor</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.raggeddictumauthor">124</a>, <a href="scrguide.pdf#desc:scrextend.cmd.raggeddictumauthor">311</a></li>
+<li><a name="cmd.raggeddictumtext"></a><a href="#cmd.raggeddictumtext">\raggeddictumtext</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.raggeddictumtext">124</a>, <a href="scrguide.pdf#desc:scrextend.cmd.raggeddictumtext">311</a></li>
+<li><a name="cmd.raggedfootnote"></a><a href="#cmd.raggedfootnote">\raggedfootnote</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.raggedfootnote">234</a>, <a href="scrguide.pdf#desc:scrextend.cmd.raggedfootnote">311</a>, <a href="scrguide.pdf#desc:maincls.cmd.raggedfootnote">99</a></li>
+<li><a name="cmd.raggedpart"></a><a href="#cmd.raggedpart">\raggedpart</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.raggedpart">115</a></li>
+<li><a name="cmd.raggedsection"></a><a href="#cmd.raggedsection">\raggedsection</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.raggedsection">115</a></li>
+<li><a name="cmd.raggedsignature"></a><a href="#cmd.raggedsignature">\raggedsignature</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.raggedsignature">239</a></li>
<li><a name="cmd.recalctypearea"></a><a href="#cmd.recalctypearea">\recalctypearea</a> --&gt; <a href="scrguide.pdf#desc:typearea.cmd.recalctypearea">41</a></li>
-<li><a name="cmd.ref"></a><a href="#cmd.ref">\ref</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.ref">323</a></li>
-<li><a name="cmd.refClause"></a><a href="#cmd.refClause">\refClause</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refClause">324</a></li>
-<li><a name="cmd.refClauseN"></a><a href="#cmd.refClauseN">\refClauseN</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refClauseN">324</a></li>
-<li><a name="cmd.refL"></a><a href="#cmd.refL">\refL</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refL">323</a></li>
-<li><a name="cmd.refN"></a><a href="#cmd.refN">\refN</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refN">323</a></li>
-<li><a name="cmd.refPar"></a><a href="#cmd.refPar">\refPar</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refPar">324</a></li>
-<li><a name="cmd.refParL"></a><a href="#cmd.refParL">\refParL</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refParL">324</a></li>
-<li><a name="cmd.refParN"></a><a href="#cmd.refParN">\refParN</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refParN">324</a></li>
-<li><a name="cmd.refParS"></a><a href="#cmd.refParS">\refParS</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refParS">324</a></li>
-<li><a name="cmd.refS"></a><a href="#cmd.refS">\refS</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refS">323</a></li>
-<li><a name="cmd.refSentence"></a><a href="#cmd.refSentence">\refSentence</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refSentence">324</a></li>
-<li><a name="cmd.refSentenceL"></a><a href="#cmd.refSentenceL">\refSentenceL</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refSentenceL">324</a></li>
-<li><a name="cmd.refSentenceN"></a><a href="#cmd.refSentenceN">\refSentenceN</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refSentenceN">324</a></li>
-<li><a name="cmd.refSentenceS"></a><a href="#cmd.refSentenceS">\refSentenceS</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refSentenceS">324</a></li>
-<li><a name="cmd.refoot*"></a><a href="#cmd.refoot*">\refoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.refoot*">260</a></li>
-<li><a name="cmd.refoot"></a><a href="#cmd.refoot">\refoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.refoot">257</a></li>
-<li><a name="cmd.rehead*"></a><a href="#cmd.rehead*">\rehead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.rehead*">256</a></li>
-<li><a name="cmd.rehead"></a><a href="#cmd.rehead">\rehead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.rehead">254</a></li>
-<li><a name="cmd.removefromtoclist"></a><a href="#cmd.removefromtoclist">\removefromtoclist</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.removefromtoclist">381</a></li>
-<li><a name="cmd.removereffields"></a><a href="#cmd.removereffields">\removereffields</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.removereffields">530</a></li>
-<li><a name="cmd.renewcaptionname*"></a><a href="#cmd.renewcaptionname*">\renewcaptionname*</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.renewcaptionname*">356</a></li>
-<li><a name="cmd.renewcaptionname"></a><a href="#cmd.renewcaptionname">\renewcaptionname</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.renewcaptionname">356</a></li>
-<li><a name="cmd.renewpagestyle"></a><a href="#cmd.renewpagestyle">\renewpagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.renewpagestyle">465</a></li>
-<li><a name="cmd.renewpairofpagestyles"></a><a href="#cmd.renewpairofpagestyles">\renewpairofpagestyles</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.renewpairofpagestyles">461</a></li>
-<li><a name="cmd.renewtriplepagestyle"></a><a href="#cmd.renewtriplepagestyle">\renewtriplepagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.renewtriplepagestyle">463</a></li>
-<li><a name="cmd.rightbotmark"></a><a href="#cmd.rightbotmark">\rightbotmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.rightbotmark">453</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.rightbotmark">459</a></li>
-<li><a name="cmd.rightfirstmark"></a><a href="#cmd.rightfirstmark">\rightfirstmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.rightfirstmark">453</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.rightfirstmark">459</a></li>
-<li><a name="cmd.rightmark"></a><a href="#cmd.rightmark">\rightmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.rightmark">268</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.rightmark">450</a></li>
-<li><a name="cmd.righttopmark"></a><a href="#cmd.righttopmark">\righttopmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.righttopmark">453</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.righttopmark">459</a></li>
-<li><a name="cmd.rofoot*"></a><a href="#cmd.rofoot*">\rofoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.rofoot*">260</a></li>
-<li><a name="cmd.rofoot"></a><a href="#cmd.rofoot">\rofoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.rofoot">257</a></li>
-<li><a name="cmd.rohead*"></a><a href="#cmd.rohead*">\rohead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.rohead*">256</a></li>
-<li><a name="cmd.rohead"></a><a href="#cmd.rohead">\rohead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.rohead">254</a></li>
-<li><a name="cmd.scr@ifVTeX"></a><a href="#cmd.scr@ifVTeX">\scr@ifVTeX</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.scr@ifVTeX">352</a></li>
-<li><a name="cmd.scr@ifdvioutput"></a><a href="#cmd.scr@ifdvioutput">\scr@ifdvioutput</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.scr@ifdvioutput">352</a></li>
-<li><a name="cmd.scr@ifpdfoutput"></a><a href="#cmd.scr@ifpdfoutput">\scr@ifpdfoutput</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.scr@ifpdfoutput">352</a></li>
-<li><a name="cmd.scr@ifpdftex"></a><a href="#cmd.scr@ifpdftex">\scr@ifpdftex</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.scr@ifpdftex">351</a></li>
-<li><a name="cmd.scr@ifpsoutput"></a><a href="#cmd.scr@ifpsoutput">\scr@ifpsoutput</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.scr@ifpsoutput">352</a></li>
-<li><a name="cmd.scr@ifundefinedorrelax"></a><a href="#cmd.scr@ifundefinedorrelax">\scr@ifundefinedorrelax</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.scr@ifundefinedorrelax">351</a></li>
-<li><a name="cmd.scr@startsection"></a><a href="#cmd.scr@startsection">\scr@startsection</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.scr@startsection">510</a></li>
-<li><a name="cmd.scrlayerAddCsToInterface"></a><a href="#cmd.scrlayerAddCsToInterface">\scrlayerAddCsToInterface</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.scrlayerAddCsToInterface">455</a></li>
-<li><a name="cmd.scrlayerAddToInterface"></a><a href="#cmd.scrlayerAddToInterface">\scrlayerAddToInterface</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.scrlayerAddToInterface">455</a></li>
-<li><a name="cmd.scrlayerInitInterface"></a><a href="#cmd.scrlayerInitInterface">\scrlayerInitInterface</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.scrlayerInitInterface">455</a></li>
-<li><a name="cmd.scrlayerOnAutoRemoveInterface"></a><a href="#cmd.scrlayerOnAutoRemoveInterface">\scrlayerOnAutoRemoveInterface</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.scrlayerOnAutoRemoveInterface">456</a></li>
-<li><a name="cmd.section*"></a><a href="#cmd.section*">\section*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.section*">110</a></li>
-<li><a name="cmd.section"></a><a href="#cmd.section">\section</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.section">105</a></li>
-<li><a name="cmd.sectioncatchphraseformat"></a><a href="#cmd.sectioncatchphraseformat">\sectioncatchphraseformat</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.sectioncatchphraseformat">508</a></li>
-<li><a name="cmd.sectionformat"></a><a href="#cmd.sectionformat">\sectionformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.sectionformat">115</a></li>
-<li><a name="cmd.sectionlinesformat"></a><a href="#cmd.sectionlinesformat">\sectionlinesformat</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.sectionlinesformat">508</a></li>
-<li><a name="cmd.sectionmark"></a><a href="#cmd.sectionmark">\sectionmark</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.sectionmark">117</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.sectionmark">271</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.sectionmark">451</a></li>
-<li><a name="cmd.sectionmarkformat"></a><a href="#cmd.sectionmarkformat">\sectionmarkformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.sectionmarkformat">117</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.sectionmarkformat">270</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.sectionmarkformat">451</a></li>
-<li><a name="cmd.sectionnumdepth"></a><a href="#cmd.sectionnumdepth">\sectionnumdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.sectionnumdepth">118</a></li>
-<li><a name="cmd.sentencename"></a><a href="#cmd.sentencename">\sentencename</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.sentencename">328</a></li>
-<li><a name="cmd.sentenceshortname"></a><a href="#cmd.sentenceshortname">\sentenceshortname</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.sentenceshortname">328</a></li>
-<li><a name="cmd.setbibpreamble"></a><a href="#cmd.setbibpreamble">\setbibpreamble</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setbibpreamble">155</a></li>
-<li><a name="cmd.setcapdynwidth"></a><a href="#cmd.setcapdynwidth">\setcapdynwidth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setcapdynwidth">147</a></li>
-<li><a name="cmd.setcaphanging"></a><a href="#cmd.setcaphanging">\setcaphanging</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setcaphanging">146</a></li>
-<li><a name="cmd.setcapindent*"></a><a href="#cmd.setcapindent*">\setcapindent*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setcapindent*">146</a></li>
-<li><a name="cmd.setcapindent"></a><a href="#cmd.setcapindent">\setcapindent</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setcapindent">146</a></li>
-<li><a name="cmd.setcapmargin*"></a><a href="#cmd.setcapmargin*">\setcapmargin*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setcapmargin*">147</a></li>
-<li><a name="cmd.setcapmargin"></a><a href="#cmd.setcapmargin">\setcapmargin</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setcapmargin">147</a></li>
-<li><a name="cmd.setcapwidth"></a><a href="#cmd.setcapwidth">\setcapwidth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setcapwidth">147</a></li>
-<li><a name="cmd.setchapterpreamble"></a><a href="#cmd.setchapterpreamble">\setchapterpreamble</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setchapterpreamble">119</a></li>
-<li><a name="cmd.setfootnoterule"></a><a href="#cmd.setfootnoterule">\setfootnoterule</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.setfootnoterule">228</a>, <a href="scrguide.pdf#desc:scrextend.cmd.setfootnoterule">308</a>, <a href="scrguide.pdf#desc:maincls.cmd.setfootnoterule">97</a></li>
-<li><a name="cmd.setindexpreamble"></a><a href="#cmd.setindexpreamble">\setindexpreamble</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setindexpreamble">157</a></li>
-<li><a name="cmd.setkomafont"></a><a href="#cmd.setkomafont">\setkomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.setkomafont">182</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.setkomafont">250</a>, <a href="scrguide.pdf#desc:scrextend.cmd.setkomafont">294</a>, <a href="scrguide.pdf#desc:scrjura.cmd.setkomafont">315</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.setkomafont">471</a>, <a href="scrguide.pdf#desc:maincls.cmd.setkomafont">62</a></li>
-<li><a name="cmd.setkomavar*"></a><a href="#cmd.setkomavar*">\setkomavar*</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.setkomavar*">163</a></li>
-<li><a name="cmd.setkomavar"></a><a href="#cmd.setkomavar">\setkomavar</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.setkomavar">163</a></li>
-<li><a name="cmd.setlengthtoplength"></a><a href="#cmd.setlengthtoplength">\setlengthtoplength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.setlengthtoplength">165</a></li>
-<li><a name="cmd.setparsizes"></a><a href="#cmd.setparsizes">\setparsizes</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.setparsizes">493</a></li>
-<li><a name="cmd.setpartpreamble"></a><a href="#cmd.setpartpreamble">\setpartpreamble</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setpartpreamble">119</a></li>
-<li><a name="cmd.setshowstyle"></a><a href="#cmd.setshowstyle">\setshowstyle</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.setshowstyle">536</a></li>
-<li><a name="cmd.settime"></a><a href="#cmd.settime">\settime</a> --&gt; <a href="scrguide.pdf#desc:scrtime.cmd.settime">283</a></li>
-<li><a name="cmd.setuptoc"></a><a href="#cmd.setuptoc">\setuptoc</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.setuptoc">387</a></li>
-<li><a name="cmd.showISOenvelope"></a><a href="#cmd.showISOenvelope">\showISOenvelope</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.showISOenvelope">536</a></li>
-<li><a name="cmd.showUScheck"></a><a href="#cmd.showUScheck">\showUScheck</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.showUScheck">536</a></li>
-<li><a name="cmd.showUScommercial"></a><a href="#cmd.showUScommercial">\showUScommercial</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.showUScommercial">536</a></li>
-<li><a name="cmd.showenvelope"></a><a href="#cmd.showenvelope">\showenvelope</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.showenvelope">536</a></li>
-<li><a name="cmd.showfields"></a><a href="#cmd.showfields">\showfields</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.showfields">535</a></li>
-<li><a name="cmd.storeareas"></a><a href="#cmd.storeareas">\storeareas</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.storeareas">486</a></li>
-<li><a name="cmd.subject"></a><a href="#cmd.subject">\subject</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.subject">298</a>, <a href="scrguide.pdf#desc:maincls.cmd.subject">71</a></li>
-<li><a name="cmd.subjectname"></a><a href="#cmd.subjectname">\subjectname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.subjectname">542</a></li>
-<li><a name="cmd.subparagraph*"></a><a href="#cmd.subparagraph*">\subparagraph*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subparagraph*">110</a></li>
-<li><a name="cmd.subparagraph"></a><a href="#cmd.subparagraph">\subparagraph</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subparagraph">105</a></li>
-<li><a name="cmd.subparagraphformat"></a><a href="#cmd.subparagraphformat">\subparagraphformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subparagraphformat">115</a></li>
-<li><a name="cmd.subparagraphmark"></a><a href="#cmd.subparagraphmark">\subparagraphmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.subparagraphmark">271</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.subparagraphmark">451</a></li>
-<li><a name="cmd.subparagraphmarkformat"></a><a href="#cmd.subparagraphmarkformat">\subparagraphmarkformat</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.subparagraphmarkformat">270</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.subparagraphmarkformat">451</a></li>
-<li><a name="cmd.subparagraphnumdepth"></a><a href="#cmd.subparagraphnumdepth">\subparagraphnumdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subparagraphnumdepth">118</a></li>
-<li><a name="cmd.subsection*"></a><a href="#cmd.subsection*">\subsection*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsection*">110</a></li>
-<li><a name="cmd.subsection"></a><a href="#cmd.subsection">\subsection</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsection">105</a></li>
-<li><a name="cmd.subsectionformat"></a><a href="#cmd.subsectionformat">\subsectionformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsectionformat">115</a></li>
-<li><a name="cmd.subsectionmark"></a><a href="#cmd.subsectionmark">\subsectionmark</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsectionmark">117</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.subsectionmark">271</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.subsectionmark">451</a></li>
-<li><a name="cmd.subsectionmarkformat"></a><a href="#cmd.subsectionmarkformat">\subsectionmarkformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsectionmarkformat">117</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.subsectionmarkformat">270</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.subsectionmarkformat">451</a></li>
-<li><a name="cmd.subsectionnumdepth"></a><a href="#cmd.subsectionnumdepth">\subsectionnumdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsectionnumdepth">118</a></li>
-<li><a name="cmd.subsubsection*"></a><a href="#cmd.subsubsection*">\subsubsection*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsubsection*">110</a></li>
-<li><a name="cmd.subsubsection"></a><a href="#cmd.subsubsection">\subsubsection</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsubsection">105</a></li>
-<li><a name="cmd.subsubsectionformat"></a><a href="#cmd.subsubsectionformat">\subsubsectionformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsubsectionformat">115</a></li>
-<li><a name="cmd.subsubsectionmark"></a><a href="#cmd.subsubsectionmark">\subsubsectionmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.subsubsectionmark">271</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.subsubsectionmark">451</a></li>
-<li><a name="cmd.subsubsectionmarkformat"></a><a href="#cmd.subsubsectionmarkformat">\subsubsectionmarkformat</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.subsubsectionmarkformat">270</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.subsubsectionmarkformat">451</a></li>
-<li><a name="cmd.subsubsectionnumdepth"></a><a href="#cmd.subsubsectionnumdepth">\subsubsectionnumdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsubsectionnumdepth">118</a></li>
-<li><a name="cmd.subtitle"></a><a href="#cmd.subtitle">\subtitle</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.subtitle">298</a>, <a href="scrguide.pdf#desc:maincls.cmd.subtitle">71</a></li>
-<li><a name="cmd.syncwithnotecolumn"></a><a href="#cmd.syncwithnotecolumn">\syncwithnotecolumn</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.syncwithnotecolumn">478</a></li>
-<li><a name="cmd.syncwithnotecolumns"></a><a href="#cmd.syncwithnotecolumns">\syncwithnotecolumns</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.syncwithnotecolumns">480</a></li>
-<li><a name="cmd.tableformat"></a><a href="#cmd.tableformat">\tableformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.tableformat">145</a></li>
-<li><a name="cmd.tableofcontents"></a><a href="#cmd.tableofcontents">\tableofcontents</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.tableofcontents">79</a></li>
-<li><a name="cmd.tb@/Dateierweiterung/@after@hook"></a><a href="#cmd.tb@/Dateierweiterung/@after@hook">\tb@/Dateierweiterung/@after@hook</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tb@/Dateierweiterung/@after@hook">404</a></li>
-<li><a name="cmd.tb@/Dateierweiterung/@before@hook"></a><a href="#cmd.tb@/Dateierweiterung/@before@hook">\tb@/Dateierweiterung/@before@hook</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tb@/Dateierweiterung/@before@hook">404</a></li>
-<li><a name="cmd.textsubscript"></a><a href="#cmd.textsubscript">\textsubscript</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.textsubscript">181</a>, <a href="scrguide.pdf#desc:scrextend.cmd.textsubscript">294</a>, <a href="scrguide.pdf#desc:maincls.cmd.textsubscript">61</a></li>
-<li><a name="cmd.textsuperscript"></a><a href="#cmd.textsuperscript">\textsuperscript</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.textsuperscript">181</a>, <a href="scrguide.pdf#desc:scrextend.cmd.textsuperscript">294</a>, <a href="scrguide.pdf#desc:maincls.cmd.textsuperscript">61</a></li>
-<li><a name="cmd.thanks"></a><a href="#cmd.thanks">\thanks</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.thanks">298</a>, <a href="scrguide.pdf#desc:maincls.cmd.thanks">71</a></li>
-<li><a name="cmd.theenumi"></a><a href="#cmd.theenumi">\theenumi</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.theenumi">125</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.theenumi">229</a></li>
-<li><a name="cmd.theenumii"></a><a href="#cmd.theenumii">\theenumii</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.theenumii">125</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.theenumii">229</a></li>
-<li><a name="cmd.theenumiii"></a><a href="#cmd.theenumiii">\theenumiii</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.theenumiii">125</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.theenumiii">229</a></li>
-<li><a name="cmd.theenumiv"></a><a href="#cmd.theenumiv">\theenumiv</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.theenumiv">125</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.theenumiv">229</a></li>
-<li><a name="cmd.thefootnotemark"></a><a href="#cmd.thefootnotemark">\thefootnotemark</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.thefootnotemark">227</a>, <a href="scrguide.pdf#desc:scrextend.cmd.thefootnotemark">307</a>, <a href="scrguide.pdf#desc:maincls.cmd.thefootnotemark">95</a></li>
-<li><a name="cmd.thepar"></a><a href="#cmd.thepar">\thepar</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.thepar">321</a></li>
-<li><a name="cmd.thesentence"></a><a href="#cmd.thesentence">\thesentence</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.thesentence">323</a></li>
-<li><a name="cmd.thisletter"></a><a href="#cmd.thisletter">\thisletter</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.thisletter">172</a></li>
-<li><a name="cmd.thispagestyle"></a><a href="#cmd.thispagestyle">\thispagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.thispagestyle">220</a>, <a href="scrguide.pdf#desc:maincls.cmd.thispagestyle">85</a></li>
-<li><a name="cmd.thistime*"></a><a href="#cmd.thistime*">\thistime*</a> --&gt; <a href="scrguide.pdf#desc:scrtime.cmd.thistime*">282</a></li>
-<li><a name="cmd.thistime"></a><a href="#cmd.thistime">\thistime</a> --&gt; <a href="scrguide.pdf#desc:scrtime.cmd.thistime">282</a></li>
-<li><a name="cmd.title"></a><a href="#cmd.title">\title</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.title">298</a>, <a href="scrguide.pdf#desc:maincls.cmd.title">71</a></li>
-<li><a name="cmd.titlehead"></a><a href="#cmd.titlehead">\titlehead</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.titlehead">298</a>, <a href="scrguide.pdf#desc:maincls.cmd.titlehead">71</a></li>
-<li><a name="cmd.titlepagestyle"></a><a href="#cmd.titlepagestyle">\titlepagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.titlepagestyle">301</a>, <a href="scrguide.pdf#desc:maincls.cmd.titlepagestyle">88</a></li>
-<li><a name="cmd.tocbasic@@after@hook"></a><a href="#cmd.tocbasic@@after@hook">\tocbasic@@after@hook</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@@after@hook">403</a></li>
-<li><a name="cmd.tocbasic@@before@hook"></a><a href="#cmd.tocbasic@@before@hook">\tocbasic@@before@hook</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@@before@hook">403</a></li>
-<li><a name="cmd.tocbasic@DependOnPenaltyAndTOCLevel"></a><a href="#cmd.tocbasic@DependOnPenaltyAndTOCLevel">\tocbasic@DependOnPenaltyAndTOCLevel</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@DependOnPenaltyAndTOCLevel">405</a></li>
-<li><a name="cmd.tocbasic@SetPenaltyByTOCLevel"></a><a href="#cmd.tocbasic@SetPenaltyByTOCLevel">\tocbasic@SetPenaltyByTOCLevel</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@SetPenaltyByTOCLevel">405</a></li>
-<li><a name="cmd.tocbasic@addxcontentsline"></a><a href="#cmd.tocbasic@addxcontentsline">\tocbasic@addxcontentsline</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@addxcontentsline">404</a></li>
-<li><a name="cmd.tocbasic@extend@babel"></a><a href="#cmd.tocbasic@extend@babel">\tocbasic@extend@babel</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@extend@babel">402</a></li>
-<li><a name="cmd.tocbasic@listhead"></a><a href="#cmd.tocbasic@listhead">\tocbasic@listhead</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@listhead">404</a></li>
-<li><a name="cmd.tocbasic@listhead@/Dateierweiterung/"></a><a href="#cmd.tocbasic@listhead@/Dateierweiterung/">\tocbasic@listhead@/Dateierweiterung/</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@listhead@/Dateierweiterung/">404</a></li>
-<li><a name="cmd.tocbasic@starttoc"></a><a href="#cmd.tocbasic@starttoc">\tocbasic@starttoc</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@starttoc">403</a></li>
-<li><a name="cmd.tocbasicautomode"></a><a href="#cmd.tocbasicautomode">\tocbasicautomode</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasicautomode">382</a></li>
-<li><a name="cmd.todaysname"></a><a href="#cmd.todaysname">\todaysname</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.todaysname">279</a></li>
-<li><a name="cmd.todaysnumber"></a><a href="#cmd.todaysnumber">\todaysnumber</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.todaysnumber">279</a></li>
+<li><a name="cmd.ref"></a><a href="#cmd.ref">\ref</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.ref">326</a></li>
+<li><a name="cmd.refClause"></a><a href="#cmd.refClause">\refClause</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refClause">326</a></li>
+<li><a name="cmd.refClauseN"></a><a href="#cmd.refClauseN">\refClauseN</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refClauseN">326</a></li>
+<li><a name="cmd.refL"></a><a href="#cmd.refL">\refL</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refL">326</a></li>
+<li><a name="cmd.refN"></a><a href="#cmd.refN">\refN</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refN">326</a></li>
+<li><a name="cmd.refPar"></a><a href="#cmd.refPar">\refPar</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refPar">326</a></li>
+<li><a name="cmd.refParL"></a><a href="#cmd.refParL">\refParL</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refParL">326</a></li>
+<li><a name="cmd.refParN"></a><a href="#cmd.refParN">\refParN</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refParN">326</a></li>
+<li><a name="cmd.refParS"></a><a href="#cmd.refParS">\refParS</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refParS">326</a></li>
+<li><a name="cmd.refS"></a><a href="#cmd.refS">\refS</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refS">326</a></li>
+<li><a name="cmd.refSentence"></a><a href="#cmd.refSentence">\refSentence</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refSentence">327</a></li>
+<li><a name="cmd.refSentenceL"></a><a href="#cmd.refSentenceL">\refSentenceL</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refSentenceL">327</a></li>
+<li><a name="cmd.refSentenceN"></a><a href="#cmd.refSentenceN">\refSentenceN</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refSentenceN">327</a></li>
+<li><a name="cmd.refSentenceS"></a><a href="#cmd.refSentenceS">\refSentenceS</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.refSentenceS">327</a></li>
+<li><a name="cmd.refoot*"></a><a href="#cmd.refoot*">\refoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.refoot*">265</a></li>
+<li><a name="cmd.refoot"></a><a href="#cmd.refoot">\refoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.refoot">262</a></li>
+<li><a name="cmd.rehead*"></a><a href="#cmd.rehead*">\rehead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.rehead*">261</a></li>
+<li><a name="cmd.rehead"></a><a href="#cmd.rehead">\rehead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.rehead">258</a></li>
+<li><a name="cmd.removefromtoclist"></a><a href="#cmd.removefromtoclist">\removefromtoclist</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.removefromtoclist">386</a></li>
+<li><a name="cmd.removereffields"></a><a href="#cmd.removereffields">\removereffields</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.removereffields">536</a></li>
+<li><a name="cmd.renewcaptionname*"></a><a href="#cmd.renewcaptionname*">\renewcaptionname*</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.renewcaptionname*">361</a></li>
+<li><a name="cmd.renewcaptionname"></a><a href="#cmd.renewcaptionname">\renewcaptionname</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.renewcaptionname">361</a></li>
+<li><a name="cmd.renewpagestyle"></a><a href="#cmd.renewpagestyle">\renewpagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.renewpagestyle">469</a></li>
+<li><a name="cmd.renewpairofpagestyles"></a><a href="#cmd.renewpairofpagestyles">\renewpairofpagestyles</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.renewpairofpagestyles">467</a></li>
+<li><a name="cmd.rightbotmark"></a><a href="#cmd.rightbotmark">\rightbotmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.rightbotmark">458</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.rightbotmark">465</a></li>
+<li><a name="cmd.rightfirstmark"></a><a href="#cmd.rightfirstmark">\rightfirstmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.rightfirstmark">458</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.rightfirstmark">465</a></li>
+<li><a name="cmd.rightmark"></a><a href="#cmd.rightmark">\rightmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.rightmark">273</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.rightmark">456</a></li>
+<li><a name="cmd.righttopmark"></a><a href="#cmd.righttopmark">\righttopmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.righttopmark">458</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage-experts.cmd.righttopmark">465</a></li>
+<li><a name="cmd.rofoot*"></a><a href="#cmd.rofoot*">\rofoot*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.rofoot*">265</a></li>
+<li><a name="cmd.rofoot"></a><a href="#cmd.rofoot">\rofoot</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.rofoot">262</a></li>
+<li><a name="cmd.rohead*"></a><a href="#cmd.rohead*">\rohead*</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.rohead*">261</a></li>
+<li><a name="cmd.rohead"></a><a href="#cmd.rohead">\rohead</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.rohead">258</a></li>
+<li><a name="cmd.scr@ifVTeX"></a><a href="#cmd.scr@ifVTeX">\scr@ifVTeX</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.scr@ifVTeX">357</a></li>
+<li><a name="cmd.scr@ifdvioutput"></a><a href="#cmd.scr@ifdvioutput">\scr@ifdvioutput</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.scr@ifdvioutput">358</a></li>
+<li><a name="cmd.scr@ifluatex"></a><a href="#cmd.scr@ifluatex">\scr@ifluatex</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.scr@ifluatex">357</a></li>
+<li><a name="cmd.scr@ifpdfoutput"></a><a href="#cmd.scr@ifpdfoutput">\scr@ifpdfoutput</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.scr@ifpdfoutput">357</a></li>
+<li><a name="cmd.scr@ifpdftex"></a><a href="#cmd.scr@ifpdftex">\scr@ifpdftex</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.scr@ifpdftex">357</a></li>
+<li><a name="cmd.scr@ifpsoutput"></a><a href="#cmd.scr@ifpsoutput">\scr@ifpsoutput</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.scr@ifpsoutput">358</a></li>
+<li><a name="cmd.scr@ifundefinedorrelax"></a><a href="#cmd.scr@ifundefinedorrelax">\scr@ifundefinedorrelax</a> --&gt; <a href="scrguide.pdf#desc:scrbase.cmd.scr@ifundefinedorrelax">356</a></li>
+<li><a name="cmd.scr@startsection"></a><a href="#cmd.scr@startsection">\scr@startsection</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.scr@startsection">516</a></li>
+<li><a name="cmd.scrlayerAddCsToInterface"></a><a href="#cmd.scrlayerAddCsToInterface">\scrlayerAddCsToInterface</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.scrlayerAddCsToInterface">461</a></li>
+<li><a name="cmd.scrlayerAddToInterface"></a><a href="#cmd.scrlayerAddToInterface">\scrlayerAddToInterface</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.scrlayerAddToInterface">461</a></li>
+<li><a name="cmd.scrlayerInitInterface"></a><a href="#cmd.scrlayerInitInterface">\scrlayerInitInterface</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.scrlayerInitInterface">460</a></li>
+<li><a name="cmd.scrlayerOnAutoRemoveInterface"></a><a href="#cmd.scrlayerOnAutoRemoveInterface">\scrlayerOnAutoRemoveInterface</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.cmd.scrlayerOnAutoRemoveInterface">462</a></li>
+<li><a name="cmd.section*"></a><a href="#cmd.section*">\section*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.section*">112</a></li>
+<li><a name="cmd.section"></a><a href="#cmd.section">\section</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.section">107</a></li>
+<li><a name="cmd.sectioncatchphraseformat"></a><a href="#cmd.sectioncatchphraseformat">\sectioncatchphraseformat</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.sectioncatchphraseformat">514</a></li>
+<li><a name="cmd.sectionformat"></a><a href="#cmd.sectionformat">\sectionformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.sectionformat">117</a></li>
+<li><a name="cmd.sectionlinesformat"></a><a href="#cmd.sectionlinesformat">\sectionlinesformat</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.sectionlinesformat">514</a></li>
+<li><a name="cmd.sectionmark"></a><a href="#cmd.sectionmark">\sectionmark</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.sectionmark">119</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.sectionmark">275</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.sectionmark">457</a></li>
+<li><a name="cmd.sectionmarkformat"></a><a href="#cmd.sectionmarkformat">\sectionmarkformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.sectionmarkformat">119</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.sectionmarkformat">274</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.sectionmarkformat">456</a></li>
+<li><a name="cmd.sectionnumdepth"></a><a href="#cmd.sectionnumdepth">\sectionnumdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.sectionnumdepth">121</a></li>
+<li><a name="cmd.sectiontocdepth"></a><a href="#cmd.sectiontocdepth">\sectiontocdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.sectiontocdepth">81</a></li>
+<li><a name="cmd.sentencename"></a><a href="#cmd.sentencename">\sentencename</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.sentencename">331</a></li>
+<li><a name="cmd.sentenceshortname"></a><a href="#cmd.sentenceshortname">\sentenceshortname</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.sentenceshortname">331</a></li>
+<li><a name="cmd.setbibpreamble"></a><a href="#cmd.setbibpreamble">\setbibpreamble</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setbibpreamble">160</a></li>
+<li><a name="cmd.setcapdynwidth"></a><a href="#cmd.setcapdynwidth">\setcapdynwidth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setcapdynwidth">150</a></li>
+<li><a name="cmd.setcaphanging"></a><a href="#cmd.setcaphanging">\setcaphanging</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setcaphanging">149</a></li>
+<li><a name="cmd.setcapindent*"></a><a href="#cmd.setcapindent*">\setcapindent*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setcapindent*">149</a></li>
+<li><a name="cmd.setcapindent"></a><a href="#cmd.setcapindent">\setcapindent</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setcapindent">149</a></li>
+<li><a name="cmd.setcapmargin*"></a><a href="#cmd.setcapmargin*">\setcapmargin*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setcapmargin*">150</a></li>
+<li><a name="cmd.setcapmargin"></a><a href="#cmd.setcapmargin">\setcapmargin</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setcapmargin">150</a></li>
+<li><a name="cmd.setcaptionalignment"></a><a href="#cmd.setcaptionalignment">\setcaptionalignment</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setcaptionalignment">151</a></li>
+<li><a name="cmd.setcapwidth"></a><a href="#cmd.setcapwidth">\setcapwidth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setcapwidth">150</a></li>
+<li><a name="cmd.setchapterpreamble"></a><a href="#cmd.setchapterpreamble">\setchapterpreamble</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setchapterpreamble">122</a></li>
+<li><a name="cmd.setfootnoterule"></a><a href="#cmd.setfootnoterule">\setfootnoterule</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.setfootnoterule">234</a>, <a href="scrguide.pdf#desc:maincls.cmd.setfootnoterule">99</a></li>
+<li><a name="cmd.setindexpreamble"></a><a href="#cmd.setindexpreamble">\setindexpreamble</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setindexpreamble">163</a></li>
+<li><a name="cmd.setkomafont"></a><a href="#cmd.setkomafont">\setkomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.setkomafont">188</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.setkomafont">255</a>, <a href="scrguide.pdf#desc:scrextend.cmd.setkomafont">298</a>, <a href="scrguide.pdf#desc:scrjura.cmd.setkomafont">317</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.setkomafont">476</a>, <a href="scrguide.pdf#desc:maincls.cmd.setkomafont">62</a></li>
+<li><a name="cmd.setkomavar*"></a><a href="#cmd.setkomavar*">\setkomavar*</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.setkomavar*">168</a></li>
+<li><a name="cmd.setkomavar"></a><a href="#cmd.setkomavar">\setkomavar</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.setkomavar">168</a></li>
+<li><a name="cmd.setlengthtoplength"></a><a href="#cmd.setlengthtoplength">\setlengthtoplength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.setlengthtoplength">170</a></li>
+<li><a name="cmd.setparsizes"></a><a href="#cmd.setparsizes">\setparsizes</a> --&gt; <a href="scrguide.pdf#desc:maincls-experts.cmd.setparsizes">497</a></li>
+<li><a name="cmd.setpartpreamble"></a><a href="#cmd.setpartpreamble">\setpartpreamble</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.setpartpreamble">122</a></li>
+<li><a name="cmd.settime"></a><a href="#cmd.settime">\settime</a> --&gt; <a href="scrguide.pdf#desc:scrtime.cmd.settime">287</a></li>
+<li><a name="cmd.setuptoc"></a><a href="#cmd.setuptoc">\setuptoc</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.setuptoc">392</a></li>
+<li><a name="cmd.storeareas"></a><a href="#cmd.storeareas">\storeareas</a> --&gt; <a href="scrguide.pdf#desc:typearea-experts.cmd.storeareas">490</a></li>
+<li><a name="cmd.subject"></a><a href="#cmd.subject">\subject</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.subject">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.subject">71</a></li>
+<li><a name="cmd.subjectname"></a><a href="#cmd.subjectname">\subjectname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.subjectname">543</a></li>
+<li><a name="cmd.subparagraph*"></a><a href="#cmd.subparagraph*">\subparagraph*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subparagraph*">112</a></li>
+<li><a name="cmd.subparagraph"></a><a href="#cmd.subparagraph">\subparagraph</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subparagraph">107</a></li>
+<li><a name="cmd.subparagraphformat"></a><a href="#cmd.subparagraphformat">\subparagraphformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subparagraphformat">117</a></li>
+<li><a name="cmd.subparagraphmark"></a><a href="#cmd.subparagraphmark">\subparagraphmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.subparagraphmark">275</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.subparagraphmark">457</a></li>
+<li><a name="cmd.subparagraphmarkformat"></a><a href="#cmd.subparagraphmarkformat">\subparagraphmarkformat</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.subparagraphmarkformat">274</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.subparagraphmarkformat">456</a></li>
+<li><a name="cmd.subparagraphnumdepth"></a><a href="#cmd.subparagraphnumdepth">\subparagraphnumdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subparagraphnumdepth">121</a></li>
+<li><a name="cmd.subparagraphtocdepth"></a><a href="#cmd.subparagraphtocdepth">\subparagraphtocdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subparagraphtocdepth">81</a></li>
+<li><a name="cmd.subsection*"></a><a href="#cmd.subsection*">\subsection*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsection*">112</a></li>
+<li><a name="cmd.subsection"></a><a href="#cmd.subsection">\subsection</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsection">107</a></li>
+<li><a name="cmd.subsectionformat"></a><a href="#cmd.subsectionformat">\subsectionformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsectionformat">117</a></li>
+<li><a name="cmd.subsectionmark"></a><a href="#cmd.subsectionmark">\subsectionmark</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsectionmark">119</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.subsectionmark">275</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.subsectionmark">457</a></li>
+<li><a name="cmd.subsectionmarkformat"></a><a href="#cmd.subsectionmarkformat">\subsectionmarkformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsectionmarkformat">119</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.subsectionmarkformat">274</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.subsectionmarkformat">456</a></li>
+<li><a name="cmd.subsectionnumdepth"></a><a href="#cmd.subsectionnumdepth">\subsectionnumdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsectionnumdepth">121</a></li>
+<li><a name="cmd.subsectiontocdepth"></a><a href="#cmd.subsectiontocdepth">\subsectiontocdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsectiontocdepth">81</a></li>
+<li><a name="cmd.subsubsection*"></a><a href="#cmd.subsubsection*">\subsubsection*</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsubsection*">112</a></li>
+<li><a name="cmd.subsubsection"></a><a href="#cmd.subsubsection">\subsubsection</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsubsection">107</a></li>
+<li><a name="cmd.subsubsectionformat"></a><a href="#cmd.subsubsectionformat">\subsubsectionformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsubsectionformat">117</a></li>
+<li><a name="cmd.subsubsectionmark"></a><a href="#cmd.subsubsectionmark">\subsubsectionmark</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.subsubsectionmark">275</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.subsubsectionmark">457</a></li>
+<li><a name="cmd.subsubsectionmarkformat"></a><a href="#cmd.subsubsectionmarkformat">\subsubsectionmarkformat</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.subsubsectionmarkformat">274</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.subsubsectionmarkformat">456</a></li>
+<li><a name="cmd.subsubsectionnumdepth"></a><a href="#cmd.subsubsectionnumdepth">\subsubsectionnumdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsubsectionnumdepth">121</a></li>
+<li><a name="cmd.subsubsectiontocdepth"></a><a href="#cmd.subsubsectiontocdepth">\subsubsectiontocdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.subsubsectiontocdepth">81</a></li>
+<li><a name="cmd.subtitle"></a><a href="#cmd.subtitle">\subtitle</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.subtitle">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.subtitle">71</a></li>
+<li><a name="cmd.syncwithnotecolumn"></a><a href="#cmd.syncwithnotecolumn">\syncwithnotecolumn</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.syncwithnotecolumn">483</a></li>
+<li><a name="cmd.syncwithnotecolumns"></a><a href="#cmd.syncwithnotecolumns">\syncwithnotecolumns</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.syncwithnotecolumns">485</a></li>
+<li><a name="cmd.tableformat"></a><a href="#cmd.tableformat">\tableformat</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.tableformat">148</a></li>
+<li><a name="cmd.tableofcontents"></a><a href="#cmd.tableofcontents">\tableofcontents</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.tableofcontents">80</a></li>
+<li><a name="cmd.tb@/Dateierweiterung/@after@hook"></a><a href="#cmd.tb@/Dateierweiterung/@after@hook">\tb@/Dateierweiterung/@after@hook</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tb@/Dateierweiterung/@after@hook">409</a></li>
+<li><a name="cmd.tb@/Dateierweiterung/@before@hook"></a><a href="#cmd.tb@/Dateierweiterung/@before@hook">\tb@/Dateierweiterung/@before@hook</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tb@/Dateierweiterung/@before@hook">409</a></li>
+<li><a name="cmd.textsubscript"></a><a href="#cmd.textsubscript">\textsubscript</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.textsubscript">188</a>, <a href="scrguide.pdf#desc:scrextend.cmd.textsubscript">298</a>, <a href="scrguide.pdf#desc:maincls.cmd.textsubscript">61</a></li>
+<li><a name="cmd.textsuperscript"></a><a href="#cmd.textsuperscript">\textsuperscript</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.textsuperscript">188</a>, <a href="scrguide.pdf#desc:scrextend.cmd.textsuperscript">298</a>, <a href="scrguide.pdf#desc:maincls.cmd.textsuperscript">61</a></li>
+<li><a name="cmd.thanks"></a><a href="#cmd.thanks">\thanks</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.thanks">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.thanks">71</a></li>
+<li><a name="cmd.theenumi"></a><a href="#cmd.theenumi">\theenumi</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.theenumi">128</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.theenumi">235</a></li>
+<li><a name="cmd.theenumii"></a><a href="#cmd.theenumii">\theenumii</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.theenumii">128</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.theenumii">235</a></li>
+<li><a name="cmd.theenumiii"></a><a href="#cmd.theenumiii">\theenumiii</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.theenumiii">128</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.theenumiii">235</a></li>
+<li><a name="cmd.theenumiv"></a><a href="#cmd.theenumiv">\theenumiv</a> --&gt; <a href="scrguide.pdf#desc:maincls.cmd.theenumiv">128</a>, <a href="scrguide.pdf#desc:scrlttr2.cmd.theenumiv">235</a></li>
+<li><a name="cmd.thefootnotemark"></a><a href="#cmd.thefootnotemark">\thefootnotemark</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.thefootnotemark">233</a>, <a href="scrguide.pdf#desc:scrextend.cmd.thefootnotemark">310</a>, <a href="scrguide.pdf#desc:maincls.cmd.thefootnotemark">97</a></li>
+<li><a name="cmd.thepar"></a><a href="#cmd.thepar">\thepar</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.thepar">324</a></li>
+<li><a name="cmd.thesentence"></a><a href="#cmd.thesentence">\thesentence</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.thesentence">325</a></li>
+<li><a name="cmd.thisletter"></a><a href="#cmd.thisletter">\thisletter</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.thisletter">178</a></li>
+<li><a name="cmd.thispagestyle"></a><a href="#cmd.thispagestyle">\thispagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.thispagestyle">226</a>, <a href="scrguide.pdf#desc:maincls.cmd.thispagestyle">86</a></li>
+<li><a name="cmd.thistime*"></a><a href="#cmd.thistime*">\thistime*</a> --&gt; <a href="scrguide.pdf#desc:scrtime.cmd.thistime*">286</a></li>
+<li><a name="cmd.thistime"></a><a href="#cmd.thistime">\thistime</a> --&gt; <a href="scrguide.pdf#desc:scrtime.cmd.thistime">286</a></li>
+<li><a name="cmd.title"></a><a href="#cmd.title">\title</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.title">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.title">71</a></li>
+<li><a name="cmd.titlehead"></a><a href="#cmd.titlehead">\titlehead</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.titlehead">302</a>, <a href="scrguide.pdf#desc:maincls.cmd.titlehead">71</a></li>
+<li><a name="cmd.titlepagestyle"></a><a href="#cmd.titlepagestyle">\titlepagestyle</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.titlepagestyle">305</a>, <a href="scrguide.pdf#desc:maincls.cmd.titlepagestyle">88</a></li>
+<li><a name="cmd.tocbasic@@after@hook"></a><a href="#cmd.tocbasic@@after@hook">\tocbasic@@after@hook</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@@after@hook">409</a></li>
+<li><a name="cmd.tocbasic@@before@hook"></a><a href="#cmd.tocbasic@@before@hook">\tocbasic@@before@hook</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@@before@hook">409</a></li>
+<li><a name="cmd.tocbasic@DependOnPenaltyAndTOCLevel"></a><a href="#cmd.tocbasic@DependOnPenaltyAndTOCLevel">\tocbasic@DependOnPenaltyAndTOCLevel</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@DependOnPenaltyAndTOCLevel">410</a></li>
+<li><a name="cmd.tocbasic@SetPenaltyByTOCLevel"></a><a href="#cmd.tocbasic@SetPenaltyByTOCLevel">\tocbasic@SetPenaltyByTOCLevel</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@SetPenaltyByTOCLevel">410</a></li>
+<li><a name="cmd.tocbasic@addxcontentsline"></a><a href="#cmd.tocbasic@addxcontentsline">\tocbasic@addxcontentsline</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@addxcontentsline">410</a></li>
+<li><a name="cmd.tocbasic@extend@babel"></a><a href="#cmd.tocbasic@extend@babel">\tocbasic@extend@babel</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@extend@babel">408</a></li>
+<li><a name="cmd.tocbasic@listhead"></a><a href="#cmd.tocbasic@listhead">\tocbasic@listhead</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@listhead">410</a></li>
+<li><a name="cmd.tocbasic@listhead@/Dateierweiterung/"></a><a href="#cmd.tocbasic@listhead@/Dateierweiterung/">\tocbasic@listhead@/Dateierweiterung/</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@listhead@/Dateierweiterung/">410</a></li>
+<li><a name="cmd.tocbasic@starttoc"></a><a href="#cmd.tocbasic@starttoc">\tocbasic@starttoc</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasic@starttoc">408</a></li>
+<li><a name="cmd.tocbasicautomode"></a><a href="#cmd.tocbasicautomode">\tocbasicautomode</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.tocbasicautomode">387</a></li>
+<li><a name="cmd.todaysname"></a><a href="#cmd.todaysname">\todaysname</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.todaysname">283</a></li>
+<li><a name="cmd.todaysnumber"></a><a href="#cmd.todaysnumber">\todaysnumber</a> --&gt; <a href="scrguide.pdf#desc:scrdate.cmd.todaysnumber">283</a></li>
<li><a name="cmd.typearea"></a><a href="#cmd.typearea">\typearea</a> --&gt; <a href="scrguide.pdf#desc:typearea.cmd.typearea">41</a></li>
-<li><a name="cmd.unitfactor"></a><a href="#cmd.unitfactor">\unitfactor</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.unitfactor">536</a></li>
-<li><a name="cmd.unsettoc"></a><a href="#cmd.unsettoc">\unsettoc</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.unsettoc">387</a></li>
-<li><a name="cmd.uppertitleback"></a><a href="#cmd.uppertitleback">\uppertitleback</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.uppertitleback">300</a>, <a href="scrguide.pdf#desc:maincls.cmd.uppertitleback">73</a></li>
-<li><a name="cmd.useencodingofkomafont"></a><a href="#cmd.useencodingofkomafont">\useencodingofkomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.useencodingofkomafont">185</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.useencodingofkomafont">252</a>, <a href="scrguide.pdf#desc:scrextend.cmd.useencodingofkomafont">295</a>, <a href="scrguide.pdf#desc:scrjura.cmd.useencodingofkomafont">315</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.useencodingofkomafont">472</a>, <a href="scrguide.pdf#desc:maincls.cmd.useencodingofkomafont">67</a></li>
-<li><a name="cmd.usefamilyofkomafont"></a><a href="#cmd.usefamilyofkomafont">\usefamilyofkomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.usefamilyofkomafont">185</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.usefamilyofkomafont">252</a>, <a href="scrguide.pdf#desc:scrextend.cmd.usefamilyofkomafont">295</a>, <a href="scrguide.pdf#desc:scrjura.cmd.usefamilyofkomafont">315</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.usefamilyofkomafont">472</a>, <a href="scrguide.pdf#desc:maincls.cmd.usefamilyofkomafont">67</a></li>
-<li><a name="cmd.usefontofkomafont"></a><a href="#cmd.usefontofkomafont">\usefontofkomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.usefontofkomafont">185</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.usefontofkomafont">252</a>, <a href="scrguide.pdf#desc:scrextend.cmd.usefontofkomafont">295</a>, <a href="scrguide.pdf#desc:scrjura.cmd.usefontofkomafont">315</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.usefontofkomafont">472</a>, <a href="scrguide.pdf#desc:maincls.cmd.usefontofkomafont">67</a></li>
-<li><a name="cmd.usekomafont"></a><a href="#cmd.usekomafont">\usekomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.usekomafont">182</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.usekomafont">250</a>, <a href="scrguide.pdf#desc:scrextend.cmd.usekomafont">294</a>, <a href="scrguide.pdf#desc:scrjura.cmd.usekomafont">315</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.usekomafont">471</a>, <a href="scrguide.pdf#desc:maincls.cmd.usekomafont">62</a></li>
-<li><a name="cmd.usekomavar*"></a><a href="#cmd.usekomavar*">\usekomavar*</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.usekomavar*">164</a>, <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.usekomavar*">531</a></li>
-<li><a name="cmd.usekomavar"></a><a href="#cmd.usekomavar">\usekomavar</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.usekomavar">164</a>, <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.usekomavar">531</a></li>
-<li><a name="cmd.usepackage"></a><a href="#cmd.usepackage">\usepackage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.usepackage">166</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.usepackage">248</a>, <a href="scrguide.pdf#desc:scrextend.cmd.usepackage">290</a>, <a href="scrguide.pdf#desc:scrjura.cmd.usepackage">313</a>, <a href="scrguide.pdf#desc:typearea.cmd.usepackage">32</a>, <a href="scrguide.pdf#desc:scrhack.cmd.usepackage">416</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.usepackage">421</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.usepackage">470</a>, <a href="scrguide.pdf#desc:maincls.cmd.usepackage">57</a></li>
-<li><a name="cmd.useplength"></a><a href="#cmd.useplength">\useplength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.useplength">165</a></li>
-<li><a name="cmd.useseriesofkomafont"></a><a href="#cmd.useseriesofkomafont">\useseriesofkomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.useseriesofkomafont">185</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.useseriesofkomafont">252</a>, <a href="scrguide.pdf#desc:scrextend.cmd.useseriesofkomafont">295</a>, <a href="scrguide.pdf#desc:scrjura.cmd.useseriesofkomafont">315</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.useseriesofkomafont">472</a>, <a href="scrguide.pdf#desc:maincls.cmd.useseriesofkomafont">67</a></li>
-<li><a name="cmd.useshapeofkomafont"></a><a href="#cmd.useshapeofkomafont">\useshapeofkomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.useshapeofkomafont">185</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.useshapeofkomafont">252</a>, <a href="scrguide.pdf#desc:scrextend.cmd.useshapeofkomafont">295</a>, <a href="scrguide.pdf#desc:scrjura.cmd.useshapeofkomafont">315</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.useshapeofkomafont">472</a>, <a href="scrguide.pdf#desc:maincls.cmd.useshapeofkomafont">67</a></li>
-<li><a name="cmd.usesizeofkomafont"></a><a href="#cmd.usesizeofkomafont">\usesizeofkomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.usesizeofkomafont">185</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.usesizeofkomafont">252</a>, <a href="scrguide.pdf#desc:scrextend.cmd.usesizeofkomafont">295</a>, <a href="scrguide.pdf#desc:scrjura.cmd.usesizeofkomafont">315</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.usesizeofkomafont">472</a>, <a href="scrguide.pdf#desc:maincls.cmd.usesizeofkomafont">67</a></li>
-<li><a name="cmd.usetocbasicnumberline"></a><a href="#cmd.usetocbasicnumberline">\usetocbasicnumberline</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.usetocbasicnumberline">390</a></li>
-<li><a name="cmd.wwwname"></a><a href="#cmd.wwwname">\wwwname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.wwwname">542</a></li>
-<li><a name="cmd.yourmailname"></a><a href="#cmd.yourmailname">\yourmailname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.yourmailname">542</a></li>
-<li><a name="cmd.yourrefname"></a><a href="#cmd.yourrefname">\yourrefname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.yourrefname">542</a></li>
+<li><a name="cmd.unsettoc"></a><a href="#cmd.unsettoc">\unsettoc</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.unsettoc">392</a></li>
+<li><a name="cmd.uppertitleback"></a><a href="#cmd.uppertitleback">\uppertitleback</a> --&gt; <a href="scrguide.pdf#desc:scrextend.cmd.uppertitleback">304</a>, <a href="scrguide.pdf#desc:maincls.cmd.uppertitleback">74</a></li>
+<li><a name="cmd.useencodingofkomafont"></a><a href="#cmd.useencodingofkomafont">\useencodingofkomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.useencodingofkomafont">191</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.useencodingofkomafont">257</a>, <a href="scrguide.pdf#desc:scrextend.cmd.useencodingofkomafont">299</a>, <a href="scrguide.pdf#desc:scrjura.cmd.useencodingofkomafont">317</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.useencodingofkomafont">476</a>, <a href="scrguide.pdf#desc:maincls.cmd.useencodingofkomafont">67</a></li>
+<li><a name="cmd.usefamilyofkomafont"></a><a href="#cmd.usefamilyofkomafont">\usefamilyofkomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.usefamilyofkomafont">191</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.usefamilyofkomafont">257</a>, <a href="scrguide.pdf#desc:scrextend.cmd.usefamilyofkomafont">299</a>, <a href="scrguide.pdf#desc:scrjura.cmd.usefamilyofkomafont">317</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.usefamilyofkomafont">476</a>, <a href="scrguide.pdf#desc:maincls.cmd.usefamilyofkomafont">67</a></li>
+<li><a name="cmd.usefontofkomafont"></a><a href="#cmd.usefontofkomafont">\usefontofkomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.usefontofkomafont">191</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.usefontofkomafont">257</a>, <a href="scrguide.pdf#desc:scrextend.cmd.usefontofkomafont">299</a>, <a href="scrguide.pdf#desc:scrjura.cmd.usefontofkomafont">317</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.usefontofkomafont">476</a>, <a href="scrguide.pdf#desc:maincls.cmd.usefontofkomafont">67</a></li>
+<li><a name="cmd.usekomafont"></a><a href="#cmd.usekomafont">\usekomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.usekomafont">188</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.usekomafont">255</a>, <a href="scrguide.pdf#desc:scrextend.cmd.usekomafont">298</a>, <a href="scrguide.pdf#desc:scrjura.cmd.usekomafont">317</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.usekomafont">476</a>, <a href="scrguide.pdf#desc:maincls.cmd.usekomafont">62</a></li>
+<li><a name="cmd.usekomavar*"></a><a href="#cmd.usekomavar*">\usekomavar*</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.usekomavar*">169</a>, <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.usekomavar*">537</a></li>
+<li><a name="cmd.usekomavar"></a><a href="#cmd.usekomavar">\usekomavar</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.usekomavar">169</a>, <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.usekomavar">537</a></li>
+<li><a name="cmd.usepackage"></a><a href="#cmd.usepackage">\usepackage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.usepackage">171</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.usepackage">253</a>, <a href="scrguide.pdf#desc:scrextend.cmd.usepackage">294</a>, <a href="scrguide.pdf#desc:scrjura.cmd.usepackage">315</a>, <a href="scrguide.pdf#desc:typearea.cmd.usepackage">32</a>, <a href="scrguide.pdf#desc:scrhack.cmd.usepackage">421</a>, <a href="scrguide.pdf#desc:scrlayer.cmd.usepackage">426</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.usepackage">474</a>, <a href="scrguide.pdf#desc:maincls.cmd.usepackage">57</a></li>
+<li><a name="cmd.useplength"></a><a href="#cmd.useplength">\useplength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.useplength">170</a></li>
+<li><a name="cmd.useseriesofkomafont"></a><a href="#cmd.useseriesofkomafont">\useseriesofkomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.useseriesofkomafont">191</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.useseriesofkomafont">257</a>, <a href="scrguide.pdf#desc:scrextend.cmd.useseriesofkomafont">299</a>, <a href="scrguide.pdf#desc:scrjura.cmd.useseriesofkomafont">317</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.useseriesofkomafont">476</a>, <a href="scrguide.pdf#desc:maincls.cmd.useseriesofkomafont">67</a></li>
+<li><a name="cmd.useshapeofkomafont"></a><a href="#cmd.useshapeofkomafont">\useshapeofkomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.useshapeofkomafont">191</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.useshapeofkomafont">257</a>, <a href="scrguide.pdf#desc:scrextend.cmd.useshapeofkomafont">299</a>, <a href="scrguide.pdf#desc:scrjura.cmd.useshapeofkomafont">317</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.useshapeofkomafont">476</a>, <a href="scrguide.pdf#desc:maincls.cmd.useshapeofkomafont">67</a></li>
+<li><a name="cmd.usesizeofkomafont"></a><a href="#cmd.usesizeofkomafont">\usesizeofkomafont</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.cmd.usesizeofkomafont">191</a>, <a href="scrguide.pdf#desc:scrlayer-scrpage.cmd.usesizeofkomafont">257</a>, <a href="scrguide.pdf#desc:scrextend.cmd.usesizeofkomafont">299</a>, <a href="scrguide.pdf#desc:scrjura.cmd.usesizeofkomafont">317</a>, <a href="scrguide.pdf#desc:scrlayer-notecolumn.cmd.usesizeofkomafont">476</a>, <a href="scrguide.pdf#desc:maincls.cmd.usesizeofkomafont">67</a></li>
+<li><a name="cmd.usetocbasicnumberline"></a><a href="#cmd.usetocbasicnumberline">\usetocbasicnumberline</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.cmd.usetocbasicnumberline">396</a></li>
+<li><a name="cmd.withoutparnumber"></a><a href="#cmd.withoutparnumber">\withoutparnumber</a> --&gt; <a href="scrguide.pdf#desc:scrjura.cmd.withoutparnumber">324</a></li>
+<li><a name="cmd.wwwname"></a><a href="#cmd.wwwname">\wwwname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.wwwname">543</a></li>
+<li><a name="cmd.yourmailname"></a><a href="#cmd.yourmailname">\yourmailname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.yourmailname">543</a></li>
+<li><a name="cmd.yourrefname"></a><a href="#cmd.yourrefname">\yourrefname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.cmd.yourrefname">543</a></li>
</ul>
<h2><a name="environment">Umgebungen</a></h2>
<ul>
<li><a name="env.abstract"></a><a href="#env.abstract">abstract</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.abstract">75</a></li>
-<li><a name="env.addmargin*"></a><a href="#env.addmargin*">addmargin*</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.addmargin*">131</a>, <a href="scrguide.pdf#desc:scrlttr2.env.addmargin*">231</a>, <a href="scrguide.pdf#desc:scrextend.env.addmargin*">311</a></li>
-<li><a name="env.addmargin"></a><a href="#env.addmargin">addmargin</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.addmargin">131</a>, <a href="scrguide.pdf#desc:scrlttr2.env.addmargin">231</a>, <a href="scrguide.pdf#desc:scrextend.env.addmargin">311</a></li>
-<li><a name="env.captionbeside"></a><a href="#env.captionbeside">captionbeside</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.captionbeside">141</a></li>
-<li><a name="env.captionofbeside"></a><a href="#env.captionofbeside">captionofbeside</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.captionofbeside">144</a></li>
-<li><a name="env.contract"></a><a href="#env.contract">contract</a> --&gt; <a href="scrguide.pdf#desc:scrjura.env.contract">317</a></li>
-<li><a name="env.description"></a><a href="#env.description">description</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.description">126</a>, <a href="scrguide.pdf#desc:scrlttr2.env.description">230</a></li>
-<li><a name="env.enumerate"></a><a href="#env.enumerate">enumerate</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.enumerate">125</a>, <a href="scrguide.pdf#desc:scrlttr2.env.enumerate">229</a></li>
-<li><a name="env.itemize"></a><a href="#env.itemize">itemize</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.itemize">123</a>, <a href="scrguide.pdf#desc:scrlttr2.env.itemize">229</a></li>
-<li><a name="env.labeling"></a><a href="#env.labeling">labeling</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.labeling">127</a>, <a href="scrguide.pdf#desc:scrlttr2.env.labeling">230</a>, <a href="scrguide.pdf#desc:scrextend.env.labeling">311</a></li>
-<li><a name="env.letter"></a><a href="#env.letter">letter</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.env.letter">171</a></li>
-<li><a name="env.quotation"></a><a href="#env.quotation">quotation</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.quotation">130</a>, <a href="scrguide.pdf#desc:scrlttr2.env.quotation">231</a></li>
-<li><a name="env.quote"></a><a href="#env.quote">quote</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.quote">130</a>, <a href="scrguide.pdf#desc:scrlttr2.env.quote">231</a></li>
-<li><a name="env.titlepage"></a><a href="#env.titlepage">titlepage</a> --&gt; <a href="scrguide.pdf#desc:scrextend.env.titlepage">296</a>, <a href="scrguide.pdf#desc:maincls.env.titlepage">69</a></li>
-<li><a name="env.verse"></a><a href="#env.verse">verse</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.verse">128</a>, <a href="scrguide.pdf#desc:scrlttr2.env.verse">230</a></li>
+<li><a name="env.addmargin*"></a><a href="#env.addmargin*">addmargin*</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.addmargin*">134</a>, <a href="scrguide.pdf#desc:scrlttr2.env.addmargin*">237</a>, <a href="scrguide.pdf#desc:scrextend.env.addmargin*">313</a></li>
+<li><a name="env.addmargin"></a><a href="#env.addmargin">addmargin</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.addmargin">134</a>, <a href="scrguide.pdf#desc:scrlttr2.env.addmargin">237</a>, <a href="scrguide.pdf#desc:scrextend.env.addmargin">313</a></li>
+<li><a name="env.captionbeside"></a><a href="#env.captionbeside">captionbeside</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.captionbeside">144</a></li>
+<li><a name="env.captionofbeside"></a><a href="#env.captionofbeside">captionofbeside</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.captionofbeside">147</a></li>
+<li><a name="env.contract"></a><a href="#env.contract">contract</a> --&gt; <a href="scrguide.pdf#desc:scrjura.env.contract">319</a></li>
+<li><a name="env.description"></a><a href="#env.description">description</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.description">129</a>, <a href="scrguide.pdf#desc:scrlttr2.env.description">236</a></li>
+<li><a name="env.enumerate"></a><a href="#env.enumerate">enumerate</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.enumerate">128</a>, <a href="scrguide.pdf#desc:scrlttr2.env.enumerate">235</a></li>
+<li><a name="env.itemize"></a><a href="#env.itemize">itemize</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.itemize">126</a>, <a href="scrguide.pdf#desc:scrlttr2.env.itemize">235</a></li>
+<li><a name="env.labeling"></a><a href="#env.labeling">labeling</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.labeling">130</a>, <a href="scrguide.pdf#desc:scrlttr2.env.labeling">236</a>, <a href="scrguide.pdf#desc:scrextend.env.labeling">312</a></li>
+<li><a name="env.letter"></a><a href="#env.letter">letter</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.env.letter">176</a></li>
+<li><a name="env.quotation"></a><a href="#env.quotation">quotation</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.quotation">132</a>, <a href="scrguide.pdf#desc:scrlttr2.env.quotation">237</a></li>
+<li><a name="env.quote"></a><a href="#env.quote">quote</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.quote">132</a>, <a href="scrguide.pdf#desc:scrlttr2.env.quote">237</a></li>
+<li><a name="env.titlepage"></a><a href="#env.titlepage">titlepage</a> --&gt; <a href="scrguide.pdf#desc:scrextend.env.titlepage">301</a>, <a href="scrguide.pdf#desc:maincls.env.titlepage">69</a></li>
+<li><a name="env.verse"></a><a href="#env.verse">verse</a> --&gt; <a href="scrguide.pdf#desc:maincls.env.verse">131</a>, <a href="scrguide.pdf#desc:scrlttr2.env.verse">236</a></li>
</ul>
<h2><a name="length">Längen</a></h2>
<ul>
-<li><a name="length.footheight"></a><a href="#length.footheight">footheight</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.length.footheight">249</a>, <a href="scrguide.pdf#desc:scrlayer.length.footheight">447</a>, <a href="scrguide.pdf#desc:typearea.length.footheight">47</a></li>
-<li><a name="length.headheight"></a><a href="#length.headheight">headheight</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.length.headheight">249</a>, <a href="scrguide.pdf#desc:scrlayer.length.headheight">447</a></li>
+<li><a name="length.footheight"></a><a href="#length.footheight">footheight</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.length.footheight">254</a>, <a href="scrguide.pdf#desc:scrlayer.length.footheight">453</a>, <a href="scrguide.pdf#desc:typearea.length.footheight">47</a></li>
+<li><a name="length.headheight"></a><a href="#length.headheight">headheight</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.length.headheight">254</a>, <a href="scrguide.pdf#desc:scrlayer.length.headheight">453</a></li>
</ul>
<h2><a name="plength">Pseudolängen</a></h2>
<ul>
-<li><a name="plength.PPdatamatrixvskip"></a><a href="#plength.PPdatamatrixvskip">PPdatamatrixvskip</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.PPdatamatrixvskip">526</a></li>
-<li><a name="plength.PPheadheight"></a><a href="#plength.PPheadheight">PPheadheight</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.PPheadheight">526</a></li>
-<li><a name="plength.PPheadwidth"></a><a href="#plength.PPheadwidth">PPheadwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.PPheadwidth">526</a></li>
-<li><a name="plength.backaddrheight"></a><a href="#plength.backaddrheight">backaddrheight</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.backaddrheight">525</a></li>
-<li><a name="plength.bfoldmarklength"></a><a href="#plength.bfoldmarklength">bfoldmarklength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.bfoldmarklength">521</a></li>
-<li><a name="plength.bfoldmarkvpos"></a><a href="#plength.bfoldmarkvpos">bfoldmarkvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.bfoldmarkvpos">521</a></li>
-<li><a name="plength.firstfoothpos"></a><a href="#plength.firstfoothpos">firstfoothpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.firstfoothpos">530</a></li>
-<li><a name="plength.firstfootvpos"></a><a href="#plength.firstfootvpos">firstfootvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.firstfootvpos">529</a></li>
-<li><a name="plength.firstfootwidth"></a><a href="#plength.firstfootwidth">firstfootwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.firstfootwidth">530</a></li>
-<li><a name="plength.firstheadhpos"></a><a href="#plength.firstheadhpos">firstheadhpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.firstheadhpos">523</a></li>
-<li><a name="plength.firstheadvpos"></a><a href="#plength.firstheadvpos">firstheadvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.firstheadvpos">523</a></li>
-<li><a name="plength.firstheadwidth"></a><a href="#plength.firstheadwidth">firstheadwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.firstheadwidth">523</a></li>
-<li><a name="plength.foldmarkhpos"></a><a href="#plength.foldmarkhpos">foldmarkhpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.foldmarkhpos">522</a></li>
-<li><a name="plength.foldmarkthickness"></a><a href="#plength.foldmarkthickness">foldmarkthickness</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.foldmarkthickness">522</a></li>
-<li><a name="plength.foldmarkvpos"></a><a href="#plength.foldmarkvpos">foldmarkvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.foldmarkvpos">522</a></li>
-<li><a name="plength.fromrulethickness"></a><a href="#plength.fromrulethickness">fromrulethickness</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.fromrulethickness">523</a></li>
-<li><a name="plength.fromrulewidth"></a><a href="#plength.fromrulewidth">fromrulewidth</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.fromrulewidth">523</a></li>
-<li><a name="plength.lfoldmarkhpos"></a><a href="#plength.lfoldmarkhpos">lfoldmarkhpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.lfoldmarkhpos">522</a></li>
-<li><a name="plength.lfoldmarklength"></a><a href="#plength.lfoldmarklength">lfoldmarklength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.lfoldmarklength">522</a></li>
-<li><a name="plength.locheight"></a><a href="#plength.locheight">locheight</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.locheight">526</a></li>
-<li><a name="plength.lochpos"></a><a href="#plength.lochpos">lochpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.lochpos">526</a></li>
-<li><a name="plength.locvpos"></a><a href="#plength.locvpos">locvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.locvpos">526</a></li>
-<li><a name="plength.locwidth"></a><a href="#plength.locwidth">locwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.locwidth">526</a></li>
-<li><a name="plength.mfoldmarklength"></a><a href="#plength.mfoldmarklength">mfoldmarklength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.mfoldmarklength">521</a></li>
-<li><a name="plength.mfoldmarkvpos"></a><a href="#plength.mfoldmarkvpos">mfoldmarkvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.mfoldmarkvpos">521</a></li>
-<li><a name="plength.pfoldmarklength"></a><a href="#plength.pfoldmarklength">pfoldmarklength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.pfoldmarklength">521</a></li>
-<li><a name="plength.refaftervskip"></a><a href="#plength.refaftervskip">refaftervskip</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.refaftervskip">528</a></li>
-<li><a name="plength.refhpos"></a><a href="#plength.refhpos">refhpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.refhpos">527</a></li>
-<li><a name="plength.refvpos"></a><a href="#plength.refvpos">refvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.refvpos">527</a></li>
-<li><a name="plength.refwidth"></a><a href="#plength.refwidth">refwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.refwidth">527</a></li>
-<li><a name="plength.sigbeforevskip"></a><a href="#plength.sigbeforevskip">sigbeforevskip</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.sigbeforevskip">529</a></li>
-<li><a name="plength.sigindent"></a><a href="#plength.sigindent">sigindent</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.sigindent">529</a></li>
-<li><a name="plength.specialmailindent"></a><a href="#plength.specialmailindent">specialmailindent</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.specialmailindent">525</a></li>
-<li><a name="plength.specialmailrightindent"></a><a href="#plength.specialmailrightindent">specialmailrightindent</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.specialmailrightindent">525</a></li>
-<li><a name="plength.subjectaftervskip"></a><a href="#plength.subjectaftervskip">subjectaftervskip</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.subjectaftervskip">528</a></li>
-<li><a name="plength.subjectbeforevskip"></a><a href="#plength.subjectbeforevskip">subjectbeforevskip</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.subjectbeforevskip">528</a></li>
-<li><a name="plength.subjectvpos"></a><a href="#plength.subjectvpos">subjectvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.subjectvpos">528</a></li>
-<li><a name="plength.tfoldmarklength"></a><a href="#plength.tfoldmarklength">tfoldmarklength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.tfoldmarklength">521</a></li>
-<li><a name="plength.tfoldmarkvpos"></a><a href="#plength.tfoldmarkvpos">tfoldmarkvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.tfoldmarkvpos">521</a></li>
-<li><a name="plength.toaddrheight"></a><a href="#plength.toaddrheight">toaddrheight</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.toaddrheight">524</a></li>
-<li><a name="plength.toaddrhpos"></a><a href="#plength.toaddrhpos">toaddrhpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.toaddrhpos">524</a></li>
-<li><a name="plength.toaddrindent"></a><a href="#plength.toaddrindent">toaddrindent</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.toaddrindent">525</a></li>
-<li><a name="plength.toaddrvpos"></a><a href="#plength.toaddrvpos">toaddrvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.toaddrvpos">524</a></li>
-<li><a name="plength.toaddrwidth"></a><a href="#plength.toaddrwidth">toaddrwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.toaddrwidth">524</a></li>
+<li><a name="plength.PPdatamatrixvskip"></a><a href="#plength.PPdatamatrixvskip">PPdatamatrixvskip</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.PPdatamatrixvskip">532</a></li>
+<li><a name="plength.PPheadheight"></a><a href="#plength.PPheadheight">PPheadheight</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.PPheadheight">532</a></li>
+<li><a name="plength.PPheadwidth"></a><a href="#plength.PPheadwidth">PPheadwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.PPheadwidth">532</a></li>
+<li><a name="plength.backaddrheight"></a><a href="#plength.backaddrheight">backaddrheight</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.backaddrheight">531</a></li>
+<li><a name="plength.bfoldmarklength"></a><a href="#plength.bfoldmarklength">bfoldmarklength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.bfoldmarklength">527</a></li>
+<li><a name="plength.bfoldmarkvpos"></a><a href="#plength.bfoldmarkvpos">bfoldmarkvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.bfoldmarkvpos">527</a></li>
+<li><a name="plength.firstfoothpos"></a><a href="#plength.firstfoothpos">firstfoothpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.firstfoothpos">536</a></li>
+<li><a name="plength.firstfootvpos"></a><a href="#plength.firstfootvpos">firstfootvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.firstfootvpos">535</a></li>
+<li><a name="plength.firstfootwidth"></a><a href="#plength.firstfootwidth">firstfootwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.firstfootwidth">536</a></li>
+<li><a name="plength.firstheadhpos"></a><a href="#plength.firstheadhpos">firstheadhpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.firstheadhpos">529</a></li>
+<li><a name="plength.firstheadvpos"></a><a href="#plength.firstheadvpos">firstheadvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.firstheadvpos">529</a></li>
+<li><a name="plength.firstheadwidth"></a><a href="#plength.firstheadwidth">firstheadwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.firstheadwidth">529</a></li>
+<li><a name="plength.foldmarkhpos"></a><a href="#plength.foldmarkhpos">foldmarkhpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.foldmarkhpos">528</a></li>
+<li><a name="plength.foldmarkthickness"></a><a href="#plength.foldmarkthickness">foldmarkthickness</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.foldmarkthickness">528</a></li>
+<li><a name="plength.foldmarkvpos"></a><a href="#plength.foldmarkvpos">foldmarkvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.foldmarkvpos">528</a></li>
+<li><a name="plength.fromrulethickness"></a><a href="#plength.fromrulethickness">fromrulethickness</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.fromrulethickness">529</a></li>
+<li><a name="plength.fromrulewidth"></a><a href="#plength.fromrulewidth">fromrulewidth</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.fromrulewidth">529</a></li>
+<li><a name="plength.lfoldmarkhpos"></a><a href="#plength.lfoldmarkhpos">lfoldmarkhpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.lfoldmarkhpos">528</a></li>
+<li><a name="plength.lfoldmarklength"></a><a href="#plength.lfoldmarklength">lfoldmarklength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.lfoldmarklength">528</a></li>
+<li><a name="plength.locheight"></a><a href="#plength.locheight">locheight</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.locheight">532</a></li>
+<li><a name="plength.lochpos"></a><a href="#plength.lochpos">lochpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.lochpos">532</a></li>
+<li><a name="plength.locvpos"></a><a href="#plength.locvpos">locvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.locvpos">532</a></li>
+<li><a name="plength.locwidth"></a><a href="#plength.locwidth">locwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.locwidth">532</a></li>
+<li><a name="plength.mfoldmarklength"></a><a href="#plength.mfoldmarklength">mfoldmarklength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.mfoldmarklength">527</a></li>
+<li><a name="plength.mfoldmarkvpos"></a><a href="#plength.mfoldmarkvpos">mfoldmarkvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.mfoldmarkvpos">527</a></li>
+<li><a name="plength.pfoldmarklength"></a><a href="#plength.pfoldmarklength">pfoldmarklength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.pfoldmarklength">527</a></li>
+<li><a name="plength.refaftervskip"></a><a href="#plength.refaftervskip">refaftervskip</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.refaftervskip">533</a></li>
+<li><a name="plength.refhpos"></a><a href="#plength.refhpos">refhpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.refhpos">533</a></li>
+<li><a name="plength.refvpos"></a><a href="#plength.refvpos">refvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.refvpos">533</a></li>
+<li><a name="plength.refwidth"></a><a href="#plength.refwidth">refwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.refwidth">533</a></li>
+<li><a name="plength.sigbeforevskip"></a><a href="#plength.sigbeforevskip">sigbeforevskip</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.sigbeforevskip">535</a></li>
+<li><a name="plength.sigindent"></a><a href="#plength.sigindent">sigindent</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.sigindent">535</a></li>
+<li><a name="plength.specialmailindent"></a><a href="#plength.specialmailindent">specialmailindent</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.specialmailindent">531</a></li>
+<li><a name="plength.specialmailrightindent"></a><a href="#plength.specialmailrightindent">specialmailrightindent</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.specialmailrightindent">531</a></li>
+<li><a name="plength.subjectaftervskip"></a><a href="#plength.subjectaftervskip">subjectaftervskip</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.subjectaftervskip">534</a></li>
+<li><a name="plength.subjectbeforevskip"></a><a href="#plength.subjectbeforevskip">subjectbeforevskip</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.subjectbeforevskip">534</a></li>
+<li><a name="plength.subjectvpos"></a><a href="#plength.subjectvpos">subjectvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.subjectvpos">534</a></li>
+<li><a name="plength.tfoldmarklength"></a><a href="#plength.tfoldmarklength">tfoldmarklength</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.tfoldmarklength">527</a></li>
+<li><a name="plength.tfoldmarkvpos"></a><a href="#plength.tfoldmarkvpos">tfoldmarkvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.tfoldmarkvpos">527</a></li>
+<li><a name="plength.toaddrheight"></a><a href="#plength.toaddrheight">toaddrheight</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.toaddrheight">530</a></li>
+<li><a name="plength.toaddrhpos"></a><a href="#plength.toaddrhpos">toaddrhpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.toaddrhpos">530</a></li>
+<li><a name="plength.toaddrindent"></a><a href="#plength.toaddrindent">toaddrindent</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.toaddrindent">531</a></li>
+<li><a name="plength.toaddrvpos"></a><a href="#plength.toaddrvpos">toaddrvpos</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.toaddrvpos">530</a></li>
+<li><a name="plength.toaddrwidth"></a><a href="#plength.toaddrwidth">toaddrwidth</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.plength.toaddrwidth">530</a></li>
</ul>
<h2><a name="variable">Variablen</a></h2>
<ul>
-<li><a name="variable.PPcode"></a><a href="#variable.PPcode">PPcode</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.PPcode">202</a></li>
-<li><a name="variable.PPdatamatrix"></a><a href="#variable.PPdatamatrix">PPdatamatrix</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.PPdatamatrix">202</a></li>
-<li><a name="variable.addresseeimage"></a><a href="#variable.addresseeimage">addresseeimage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.addresseeimage">202</a></li>
-<li><a name="variable.backaddress"></a><a href="#variable.backaddress">backaddress</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.backaddress">202</a></li>
-<li><a name="variable.backaddressseparator"></a><a href="#variable.backaddressseparator">backaddressseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.backaddressseparator">202</a></li>
-<li><a name="variable.ccseparator"></a><a href="#variable.ccseparator">ccseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.ccseparator">177</a></li>
-<li><a name="variable.customer"></a><a href="#variable.customer">customer</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.customer">209</a></li>
-<li><a name="variable.date"></a><a href="#variable.date">date</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.date">208</a></li>
-<li><a name="variable.emailseparator"></a><a href="#variable.emailseparator">emailseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.emailseparator">195</a></li>
-<li><a name="variable.enclseparator"></a><a href="#variable.enclseparator">enclseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.enclseparator">177</a></li>
-<li><a name="variable.faxseparator"></a><a href="#variable.faxseparator">faxseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.faxseparator">195</a></li>
-<li><a name="variable.firstfoot"></a><a href="#variable.firstfoot">firstfoot</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.firstfoot">215</a></li>
-<li><a name="variable.firsthead"></a><a href="#variable.firsthead">firsthead</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.firsthead">200</a></li>
-<li><a name="variable.fromaddress"></a><a href="#variable.fromaddress">fromaddress</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.fromaddress">190</a></li>
-<li><a name="variable.frombank"></a><a href="#variable.frombank">frombank</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.frombank">216</a></li>
-<li><a name="variable.fromemail"></a><a href="#variable.fromemail">fromemail</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.fromemail">195</a></li>
-<li><a name="variable.fromfax"></a><a href="#variable.fromfax">fromfax</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.fromfax">195</a></li>
-<li><a name="variable.fromlogo"></a><a href="#variable.fromlogo">fromlogo</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.fromlogo">198</a></li>
-<li><a name="variable.frommobilephone"></a><a href="#variable.frommobilephone">frommobilephone</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.frommobilephone">195</a></li>
-<li><a name="variable.fromname"></a><a href="#variable.fromname">fromname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.fromname">190</a></li>
-<li><a name="variable.fromphone"></a><a href="#variable.fromphone">fromphone</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.fromphone">195</a></li>
-<li><a name="variable.fromurl"></a><a href="#variable.fromurl">fromurl</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.fromurl">195</a></li>
-<li><a name="variable.fromzipcode"></a><a href="#variable.fromzipcode">fromzipcode</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.fromzipcode">202</a></li>
-<li><a name="variable.invoice"></a><a href="#variable.invoice">invoice</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.invoice">209</a></li>
-<li><a name="variable.location"></a><a href="#variable.location">location</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.location">206</a></li>
-<li><a name="variable.mobilephoneseparator"></a><a href="#variable.mobilephoneseparator">mobilephoneseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.mobilephoneseparator">195</a></li>
-<li><a name="variable.myref"></a><a href="#variable.myref">myref</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.myref">209</a></li>
-<li><a name="variable.nextfoot"></a><a href="#variable.nextfoot">nextfoot</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.nextfoot">222</a>, <a href="scrguide.pdf#desc:scrlttr2-experts.variable.nextfoot">532</a></li>
-<li><a name="variable.nexthead"></a><a href="#variable.nexthead">nexthead</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.nexthead">222</a>, <a href="scrguide.pdf#desc:scrlttr2-experts.variable.nexthead">532</a></li>
-<li><a name="variable.phoneseparator"></a><a href="#variable.phoneseparator">phoneseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.phoneseparator">195</a></li>
-<li><a name="variable.place"></a><a href="#variable.place">place</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.place">202</a></li>
-<li><a name="variable.placeseparator"></a><a href="#variable.placeseparator">placeseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.placeseparator">209</a></li>
-<li><a name="variable.signature"></a><a href="#variable.signature">signature</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.signature">233</a></li>
-<li><a name="variable.specialmail"></a><a href="#variable.specialmail">specialmail</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.specialmail">202</a></li>
-<li><a name="variable.subject"></a><a href="#variable.subject">subject</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.subject">212</a></li>
-<li><a name="variable.subjectseparator"></a><a href="#variable.subjectseparator">subjectseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.subjectseparator">212</a></li>
-<li><a name="variable.title"></a><a href="#variable.title">title</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.title">211</a></li>
-<li><a name="variable.toaddress"></a><a href="#variable.toaddress">toaddress</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.toaddress">202</a></li>
-<li><a name="variable.toname"></a><a href="#variable.toname">toname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.toname">202</a></li>
-<li><a name="variable.urlseparator"></a><a href="#variable.urlseparator">urlseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.urlseparator">195</a></li>
-<li><a name="variable.yourmail"></a><a href="#variable.yourmail">yourmail</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.yourmail">209</a></li>
-<li><a name="variable.yourref"></a><a href="#variable.yourref">yourref</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.yourref">209</a></li>
-<li><a name="variable.zipcodeseparator"></a><a href="#variable.zipcodeseparator">zipcodeseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.zipcodeseparator">202</a></li>
+<li><a name="variable.PPcode"></a><a href="#variable.PPcode">PPcode</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.PPcode">208</a></li>
+<li><a name="variable.PPdatamatrix"></a><a href="#variable.PPdatamatrix">PPdatamatrix</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.PPdatamatrix">208</a></li>
+<li><a name="variable.addresseeimage"></a><a href="#variable.addresseeimage">addresseeimage</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.addresseeimage">208</a></li>
+<li><a name="variable.backaddress"></a><a href="#variable.backaddress">backaddress</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.backaddress">208</a></li>
+<li><a name="variable.backaddressseparator"></a><a href="#variable.backaddressseparator">backaddressseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.backaddressseparator">208</a></li>
+<li><a name="variable.ccseparator"></a><a href="#variable.ccseparator">ccseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.ccseparator">182</a></li>
+<li><a name="variable.customer"></a><a href="#variable.customer">customer</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.customer">215</a></li>
+<li><a name="variable.date"></a><a href="#variable.date">date</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.date">214</a></li>
+<li><a name="variable.emailseparator"></a><a href="#variable.emailseparator">emailseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.emailseparator">201</a></li>
+<li><a name="variable.enclseparator"></a><a href="#variable.enclseparator">enclseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.enclseparator">183</a></li>
+<li><a name="variable.faxseparator"></a><a href="#variable.faxseparator">faxseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.faxseparator">201</a></li>
+<li><a name="variable.firstfoot"></a><a href="#variable.firstfoot">firstfoot</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.firstfoot">221</a></li>
+<li><a name="variable.firsthead"></a><a href="#variable.firsthead">firsthead</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.firsthead">206</a></li>
+<li><a name="variable.fromaddress"></a><a href="#variable.fromaddress">fromaddress</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.fromaddress">196</a></li>
+<li><a name="variable.frombank"></a><a href="#variable.frombank">frombank</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.frombank">222</a></li>
+<li><a name="variable.fromemail"></a><a href="#variable.fromemail">fromemail</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.fromemail">201</a></li>
+<li><a name="variable.fromfax"></a><a href="#variable.fromfax">fromfax</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.fromfax">201</a></li>
+<li><a name="variable.fromlogo"></a><a href="#variable.fromlogo">fromlogo</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.fromlogo">204</a></li>
+<li><a name="variable.frommobilephone"></a><a href="#variable.frommobilephone">frommobilephone</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.frommobilephone">201</a></li>
+<li><a name="variable.fromname"></a><a href="#variable.fromname">fromname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.fromname">196</a></li>
+<li><a name="variable.fromphone"></a><a href="#variable.fromphone">fromphone</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.fromphone">201</a></li>
+<li><a name="variable.fromurl"></a><a href="#variable.fromurl">fromurl</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.fromurl">201</a></li>
+<li><a name="variable.fromzipcode"></a><a href="#variable.fromzipcode">fromzipcode</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.fromzipcode">208</a></li>
+<li><a name="variable.invoice"></a><a href="#variable.invoice">invoice</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.invoice">215</a></li>
+<li><a name="variable.location"></a><a href="#variable.location">location</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.location">212</a></li>
+<li><a name="variable.mobilephoneseparator"></a><a href="#variable.mobilephoneseparator">mobilephoneseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.mobilephoneseparator">201</a></li>
+<li><a name="variable.myref"></a><a href="#variable.myref">myref</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.myref">215</a></li>
+<li><a name="variable.nextfoot"></a><a href="#variable.nextfoot">nextfoot</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.nextfoot">229</a></li>
+<li><a name="variable.nexthead"></a><a href="#variable.nexthead">nexthead</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.nexthead">229</a></li>
+<li><a name="variable.phoneseparator"></a><a href="#variable.phoneseparator">phoneseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.phoneseparator">201</a></li>
+<li><a name="variable.place"></a><a href="#variable.place">place</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.place">208</a></li>
+<li><a name="variable.placeseparator"></a><a href="#variable.placeseparator">placeseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.placeseparator">215</a></li>
+<li><a name="variable.signature"></a><a href="#variable.signature">signature</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.signature">239</a></li>
+<li><a name="variable.specialmail"></a><a href="#variable.specialmail">specialmail</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.specialmail">208</a></li>
+<li><a name="variable.subject"></a><a href="#variable.subject">subject</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.subject">218</a></li>
+<li><a name="variable.subjectseparator"></a><a href="#variable.subjectseparator">subjectseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.subjectseparator">218</a></li>
+<li><a name="variable.title"></a><a href="#variable.title">title</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.title">217</a></li>
+<li><a name="variable.toaddress"></a><a href="#variable.toaddress">toaddress</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.toaddress">208</a></li>
+<li><a name="variable.toname"></a><a href="#variable.toname">toname</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.toname">208</a></li>
+<li><a name="variable.urlseparator"></a><a href="#variable.urlseparator">urlseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.urlseparator">201</a></li>
+<li><a name="variable.yourmail"></a><a href="#variable.yourmail">yourmail</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.yourmail">215</a></li>
+<li><a name="variable.yourref"></a><a href="#variable.yourref">yourref</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.yourref">215</a></li>
+<li><a name="variable.zipcodeseparator"></a><a href="#variable.zipcodeseparator">zipcodeseparator</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.variable.zipcodeseparator">208</a></li>
</ul>
<h2><a name="pagestyle">Seitenstile</a></h2>
<ul>
-<li><a name="pagestyle.@everystyle@"></a><a href="#pagestyle.@everystyle@">@everystyle@</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.pagestyle.@everystyle@">442</a></li>
-<li><a name="pagestyle.empty"></a><a href="#pagestyle.empty">empty</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.pagestyle.empty">442</a></li>
-<li><a name="pagestyle.letter"></a><a href="#pagestyle.letter">letter</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2-experts.pagestyle.letter">532</a></li>
-<li><a name="pagestyle.scrheadings"></a><a href="#pagestyle.scrheadings">scrheadings</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.pagestyle.scrheadings">253</a></li>
+<li><a name="pagestyle.@everystyle@"></a><a href="#pagestyle.@everystyle@">@everystyle@</a> --&gt; <a href="scrguide.pdf#desc:scrlayer.pagestyle.@everystyle@">447</a></li>
+<li><a name="pagestyle.empty"></a><a href="#pagestyle.empty">empty</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.pagestyle.empty">226</a>, <a href="scrguide.pdf#desc:scrlayer.pagestyle.empty">447</a></li>
+<li><a name="pagestyle.headings"></a><a href="#pagestyle.headings">headings</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.pagestyle.headings">226</a></li>
+<li><a name="pagestyle.letter"></a><a href="#pagestyle.letter">letter</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.pagestyle.letter">227</a></li>
+<li><a name="pagestyle.myheadings"></a><a href="#pagestyle.myheadings">myheadings</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.pagestyle.myheadings">228</a></li>
+<li><a name="pagestyle.plain"></a><a href="#pagestyle.plain">plain</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.pagestyle.plain">228</a></li>
+<li><a name="pagestyle.scrheadings"></a><a href="#pagestyle.scrheadings">scrheadings</a> --&gt; <a href="scrguide.pdf#desc:scrlayer-scrpage.pagestyle.scrheadings">258</a></li>
</ul>
<h2><a name="counter">Zähler</a></h2>
<ul>
-<li><a name="counter.letter"></a><a href="#counter.letter">letter</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.counter.letter">172</a></li>
-<li><a name="counter.par"></a><a href="#counter.par">par</a> --&gt; <a href="scrguide.pdf#desc:scrjura.counter.par">321</a></li>
-<li><a name="counter.secnumdepth"></a><a href="#counter.secnumdepth">secnumdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.counter.secnumdepth">118</a></li>
-<li><a name="counter.sentence"></a><a href="#counter.sentence">sentence</a> --&gt; <a href="scrguide.pdf#desc:scrjura.counter.sentence">323</a></li>
-<li><a name="counter.tocdepth"></a><a href="#counter.tocdepth">tocdepth</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.counter.tocdepth">390</a>, <a href="scrguide.pdf#desc:maincls.counter.tocdepth">80</a></li>
+<li><a name="counter.letter"></a><a href="#counter.letter">letter</a> --&gt; <a href="scrguide.pdf#desc:scrlttr2.counter.letter">178</a></li>
+<li><a name="counter.par"></a><a href="#counter.par">par</a> --&gt; <a href="scrguide.pdf#desc:scrjura.counter.par">324</a></li>
+<li><a name="counter.secnumdepth"></a><a href="#counter.secnumdepth">secnumdepth</a> --&gt; <a href="scrguide.pdf#desc:maincls.counter.secnumdepth">121</a></li>
+<li><a name="counter.sentence"></a><a href="#counter.sentence">sentence</a> --&gt; <a href="scrguide.pdf#desc:scrjura.counter.sentence">325</a></li>
+<li><a name="counter.tocdepth"></a><a href="#counter.tocdepth">tocdepth</a> --&gt; <a href="scrguide.pdf#desc:tocbasic.counter.tocdepth">395</a>, <a href="scrguide.pdf#desc:maincls.counter.tocdepth">81</a></li>
</ul>
<h2><a name="floatstyle">Stile für das float-Paket</a></h2>
<ul>
-<li><a name="floatstyle.komaabove"></a><a href="#floatstyle.komaabove">komaabove</a> --&gt; <a href="scrguide.pdf#desc:maincls.floatstyle.komaabove">144</a></li>
-<li><a name="floatstyle.komabelow"></a><a href="#floatstyle.komabelow">komabelow</a> --&gt; <a href="scrguide.pdf#desc:maincls.floatstyle.komabelow">144</a></li>
+<li><a name="floatstyle.komaabove"></a><a href="#floatstyle.komaabove">komaabove</a> --&gt; <a href="scrguide.pdf#desc:maincls.floatstyle.komaabove">147</a></li>
+<li><a name="floatstyle.komabelow"></a><a href="#floatstyle.komabelow">komabelow</a> --&gt; <a href="scrguide.pdf#desc:maincls.floatstyle.komabelow">147</a></li>
</ul>
<p>
<a href="http://validator.w3.org/check?uri=referer"><img
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/scrguide.pdf b/Master/texmf-dist/source/latex/koma-script/doc/scrguide.pdf
index db6ea8ec9a5..5a852b638e4 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/scrguide.pdf
+++ b/Master/texmf-dist/source/latex/koma-script/doc/scrguide.pdf
Binary files differ
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/scrguien.html b/Master/texmf-dist/source/latex/koma-script/doc/scrguien.html
index 3339628f11d..acd2f860916 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/scrguien.html
+++ b/Master/texmf-dist/source/latex/koma-script/doc/scrguien.html
@@ -10,941 +10,972 @@
<li><a href="#option">Options</a></li><li><a href="#macro">Commands</a></li><li><a href="#environment">Environments</a></li><li><a href="#length">Lengths</a></li><li><a href="#plength">Pseudolengths</a></li><li><a href="#variable">Variables</a></li><li><a href="#pagestyle">Page Styles</a></li><li><a href="#counter">Counter</a></li><li><a href="#floatstyle">Styles for the float Package</a></li></ul>
<h2><a name="option">Options</a></h2>
<ul>
-<li><a name="option.12h"></a><a href="#option.12h">12h</a> --&gt; <a href="scrguien.pdf#desc:scrtime.option.12h">259</a></li>
-<li><a name="option.BCOR"></a><a href="#option.BCOR">BCOR</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.BCOR">31</a></li>
-<li><a name="option.DIV"></a><a href="#option.DIV">DIV</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.DIV">32</a></li>
-<li><a name="option.abstract"></a><a href="#option.abstract">abstract</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.abstract">68</a></li>
-<li><a name="option.addrfield"></a><a href="#option.addrfield">addrfield</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.addrfield">183</a></li>
-<li><a name="option.adrFreeIVempty"></a><a href="#option.adrFreeIVempty">adrFreeIVempty</a> --&gt; <a href="scrguien.pdf#desc:scraddr.option.adrFreeIVempty">263</a></li>
-<li><a name="option.adrFreeIVshow"></a><a href="#option.adrFreeIVshow">adrFreeIVshow</a> --&gt; <a href="scrguien.pdf#desc:scraddr.option.adrFreeIVshow">263</a></li>
-<li><a name="option.adrFreeIVstop"></a><a href="#option.adrFreeIVstop">adrFreeIVstop</a> --&gt; <a href="scrguien.pdf#desc:scraddr.option.adrFreeIVstop">263</a></li>
-<li><a name="option.adrFreeIVwarn"></a><a href="#option.adrFreeIVwarn">adrFreeIVwarn</a> --&gt; <a href="scrguien.pdf#desc:scraddr.option.adrFreeIVwarn">263</a></li>
-<li><a name="option.appendixprefix"></a><a href="#option.appendixprefix">appendixprefix</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.appendixprefix">90</a></li>
-<li><a name="option.areasetadvanced"></a><a href="#option.areasetadvanced">areasetadvanced</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.option.areasetadvanced">440</a></li>
-<li><a name="option.autoclearnotecolumns"></a><a href="#option.autoclearnotecolumns">autoclearnotecolumns</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.option.autoclearnotecolumns">437</a></li>
-<li><a name="option.automark"></a><a href="#option.automark">automark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.automark">242</a>, <a href="scrguien.pdf#desc:scrlayer.option.automark">406</a></li>
-<li><a name="option.autooneside"></a><a href="#option.autooneside">autooneside</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.autooneside">242</a>, <a href="scrguien.pdf#desc:scrlayer.option.autooneside">406</a></li>
-<li><a name="option.autoremoveinterfaces"></a><a href="#option.autoremoveinterfaces">autoremoveinterfaces</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.autoremoveinterfaces">413</a></li>
-<li><a name="option.backaddress"></a><a href="#option.backaddress">backaddress</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.backaddress">183</a></li>
-<li><a name="option.bibliography"></a><a href="#option.bibliography">bibliography</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.bibliography">139</a></li>
-<li><a name="option.captions"></a><a href="#option.captions">captions</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.captions">121</a></li>
-<li><a name="option.chapteratlists"></a><a href="#option.chapteratlists">chapteratlists</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.chapteratlists">94</a></li>
-<li><a name="option.chapterentrydots"></a><a href="#option.chapterentrydots">chapterentrydots</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.chapterentrydots">72</a></li>
-<li><a name="option.chapterprefix"></a><a href="#option.chapterprefix">chapterprefix</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.chapterprefix">90</a></li>
-<li><a name="option.clausemark"></a><a href="#option.clausemark">clausemark</a> --&gt; <a href="scrguien.pdf#desc:scrjura.option.clausemark">293</a></li>
-<li><a name="option.cleardoublepage"></a><a href="#option.cleardoublepage">cleardoublepage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.cleardoublepage">205</a>, <a href="scrguien.pdf#desc:scrextend.option.cleardoublepage">277</a>, <a href="scrguien.pdf#desc:maincls.option.cleardoublepage">82</a></li>
-<li><a name="option.clines"></a><a href="#option.clines">clines</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.clines">252</a></li>
-<li><a name="option.contract"></a><a href="#option.contract">contract</a> --&gt; <a href="scrguien.pdf#desc:scrjura.option.contract">290</a></li>
-<li><a name="option.deactivatepagestylelayers"></a><a href="#option.deactivatepagestylelayers">deactivatepagestylelayers</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.deactivatepagestylelayers">402</a></li>
-<li><a name="option.draft"></a><a href="#option.draft">draft</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.draft">151</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.option.draft">244</a>, <a href="scrguien.pdf#desc:scrextend.option.draft">268</a>, <a href="scrguien.pdf#desc:scrlayer.option.draft">407</a>, <a href="scrguien.pdf#desc:maincls.option.draft">54</a></li>
-<li><a name="option.enlargefirstpage"></a><a href="#option.enlargefirstpage">enlargefirstpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.enlargefirstpage">171</a></li>
-<li><a name="option.extendedfeature"></a><a href="#option.extendedfeature">extendedfeature</a> --&gt; <a href="scrguien.pdf#desc:scrextend.option.extendedfeature">268</a></li>
-<li><a name="option.firstfoot"></a><a href="#option.firstfoot">firstfoot</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.firstfoot">196</a></li>
-<li><a name="option.firsthead"></a><a href="#option.firsthead">firsthead</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.firsthead">172</a></li>
-<li><a name="option.fleqn"></a><a href="#option.fleqn">fleqn</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.fleqn">121</a></li>
-<li><a name="option.foldmarks"></a><a href="#option.foldmarks">foldmarks</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.foldmarks">169</a></li>
-<li><a name="option.fontsize"></a><a href="#option.fontsize">fontsize</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.fontsize">163</a>, <a href="scrguien.pdf#desc:scrextend.option.fontsize">269</a>, <a href="scrguien.pdf#desc:maincls.option.fontsize">55</a></li>
-<li><a name="option.footbotline"></a><a href="#option.footbotline">footbotline</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.footbotline">250</a></li>
-<li><a name="option.footheight"></a><a href="#option.footheight">footheight</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.footheight">43</a></li>
-<li><a name="option.footinclude"></a><a href="#option.footinclude">footinclude</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.footinclude">40</a></li>
-<li><a name="option.footlines"></a><a href="#option.footlines">footlines</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.footlines">43</a></li>
-<li><a name="option.footnotes"></a><a href="#option.footnotes">footnotes</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.footnotes">206</a>, <a href="scrguien.pdf#desc:scrextend.option.footnotes">279</a>, <a href="scrguien.pdf#desc:maincls.option.footnotes">85</a></li>
-<li><a name="option.footsepline"></a><a href="#option.footsepline">footsepline</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.footsepline">201</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.option.footsepline">250</a>, <a href="scrguien.pdf#desc:scrlttr2-experts.option.footsepline">485</a>, <a href="scrguien.pdf#desc:maincls.option.footsepline">77</a></li>
-<li><a name="option.footwidth"></a><a href="#option.footwidth">footwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.footwidth">250</a></li>
-<li><a name="option.forceoverwrite"></a><a href="#option.forceoverwrite">forceoverwrite</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.forceoverwrite">413</a></li>
-<li><a name="option.fromalign"></a><a href="#option.fromalign">fromalign</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.fromalign">172</a></li>
-<li><a name="option.fromemail"></a><a href="#option.fromemail">fromemail</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.fromemail">177</a></li>
-<li><a name="option.fromfax"></a><a href="#option.fromfax">fromfax</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.fromfax">177</a></li>
-<li><a name="option.fromlogo"></a><a href="#option.fromlogo">fromlogo</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.fromlogo">181</a></li>
-<li><a name="option.frommobilephone"></a><a href="#option.frommobilephone">frommobilephone</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.frommobilephone">177</a></li>
-<li><a name="option.fromphone"></a><a href="#option.fromphone">fromphone</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.fromphone">177</a></li>
-<li><a name="option.fromrule"></a><a href="#option.fromrule">fromrule</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.fromrule">173</a></li>
-<li><a name="option.fromurl"></a><a href="#option.fromurl">fromurl</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.fromurl">177</a></li>
-<li><a name="option.headheight"></a><a href="#option.headheight">headheight</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.headheight">42</a></li>
-<li><a name="option.headinclude"></a><a href="#option.headinclude">headinclude</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.headinclude">40</a></li>
-<li><a name="option.headings"></a><a href="#option.headings">headings</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.headings">92</a></li>
-<li><a name="option.headlines"></a><a href="#option.headlines">headlines</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.headlines">42</a></li>
-<li><a name="option.headsepline"></a><a href="#option.headsepline">headsepline</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.headsepline">201</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.option.headsepline">250</a>, <a href="scrguien.pdf#desc:scrlttr2-experts.option.headsepline">485</a>, <a href="scrguien.pdf#desc:maincls.option.headsepline">77</a></li>
-<li><a name="option.headtopline"></a><a href="#option.headtopline">headtopline</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.headtopline">250</a></li>
-<li><a name="option.headwidth"></a><a href="#option.headwidth">headwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.headwidth">250</a></li>
-<li><a name="option.ilines"></a><a href="#option.ilines">ilines</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.ilines">252</a></li>
-<li><a name="option.index"></a><a href="#option.index">index</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.index">142</a></li>
-<li><a name="option.internalonly"></a><a href="#option.internalonly">internalonly</a> --&gt; <a href="scrguien.pdf#desc:scrbase.option.internalonly">308</a></li>
-<li><a name="option.juratitlepagebreak"></a><a href="#option.juratitlepagebreak">juratitlepagebreak</a> --&gt; <a href="scrguien.pdf#desc:scrjura.option.juratitlepagebreak">293</a></li>
-<li><a name="option.juratocindent"></a><a href="#option.juratocindent">juratocindent</a> --&gt; <a href="scrguien.pdf#desc:scrjura.option.juratocindent">290</a></li>
-<li><a name="option.juratocnumberwidth"></a><a href="#option.juratocnumberwidth">juratocnumberwidth</a> --&gt; <a href="scrguien.pdf#desc:scrjura.option.juratocnumberwidth">290</a></li>
-<li><a name="option.juratotoc"></a><a href="#option.juratotoc">juratotoc</a> --&gt; <a href="scrguien.pdf#desc:scrjura.option.juratotoc">289</a></li>
-<li><a name="option.leqno"></a><a href="#option.leqno">leqno</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.leqno">120</a></li>
-<li><a name="option.listof"></a><a href="#option.listof">listof</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.listof">134</a></li>
-<li><a name="option.locfield"></a><a href="#option.locfield">locfield</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.locfield">188</a></li>
-<li><a name="option.manualmark"></a><a href="#option.manualmark">manualmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.manualmark">242</a>, <a href="scrguien.pdf#desc:scrlayer.option.manualmark">406</a></li>
-<li><a name="option.markcase"></a><a href="#option.markcase">markcase</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.markcase">245</a>, <a href="scrguien.pdf#desc:scrlayer.option.markcase">408</a></li>
-<li><a name="option.mpinclude"></a><a href="#option.mpinclude">mpinclude</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.mpinclude">41</a></li>
-<li><a name="option.numbers"></a><a href="#option.numbers">numbers</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.numbers">94</a></li>
-<li><a name="option.numericaldate"></a><a href="#option.numericaldate">numericaldate</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.numericaldate">190</a></li>
-<li><a name="option.olines"></a><a href="#option.olines">olines</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.olines">252</a></li>
-<li><a name="option.onpsbackground"></a><a href="#option.onpsbackground">onpsbackground</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsbackground">402</a></li>
-<li><a name="option.onpsevenpage"></a><a href="#option.onpsevenpage">onpsevenpage</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsevenpage">402</a></li>
-<li><a name="option.onpsfloatpage"></a><a href="#option.onpsfloatpage">onpsfloatpage</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsfloatpage">402</a></li>
-<li><a name="option.onpsforeground"></a><a href="#option.onpsforeground">onpsforeground</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsforeground">402</a></li>
-<li><a name="option.onpsinit"></a><a href="#option.onpsinit">onpsinit</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsinit">402</a></li>
-<li><a name="option.onpsnonfloatpage"></a><a href="#option.onpsnonfloatpage">onpsnonfloatpage</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsnonfloatpage">402</a></li>
-<li><a name="option.onpsoddpage"></a><a href="#option.onpsoddpage">onpsoddpage</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsoddpage">402</a></li>
-<li><a name="option.onpsoneside"></a><a href="#option.onpsoneside">onpsoneside</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsoneside">402</a></li>
-<li><a name="option.onpsselect"></a><a href="#option.onpsselect">onpsselect</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsselect">402</a></li>
-<li><a name="option.onpstwoside"></a><a href="#option.onpstwoside">onpstwoside</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpstwoside">402</a></li>
-<li><a name="option.open"></a><a href="#option.open">open</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.open">90</a></li>
-<li><a name="option.origlongtable"></a><a href="#option.origlongtable">origlongtable</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.origlongtable">134</a></li>
-<li><a name="option.pagenumber"></a><a href="#option.pagenumber">pagenumber</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.pagenumber">201</a></li>
-<li><a name="option.pagesize"></a><a href="#option.pagesize">pagesize</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.pagesize">47</a></li>
-<li><a name="option.pagestyleset"></a><a href="#option.pagestyleset">pagestyleset</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.pagestyleset">240</a></li>
-<li><a name="option.paper"></a><a href="#option.paper">paper</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.paper">46</a></li>
-<li><a name="option.parnumber"></a><a href="#option.parnumber">parnumber</a> --&gt; <a href="scrguien.pdf#desc:scrjura.option.parnumber">294</a></li>
-<li><a name="option.parskip"></a><a href="#option.parskip">parskip</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.parskip">198</a>, <a href="scrguien.pdf#desc:maincls.option.parskip">74</a></li>
-<li><a name="option.plainfootbotline"></a><a href="#option.plainfootbotline">plainfootbotline</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.plainfootbotline">252</a></li>
-<li><a name="option.plainfootsepline"></a><a href="#option.plainfootsepline">plainfootsepline</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.plainfootsepline">252</a></li>
-<li><a name="option.plainheadsepline"></a><a href="#option.plainheadsepline">plainheadsepline</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.plainheadsepline">252</a></li>
-<li><a name="option.plainheadtopline"></a><a href="#option.plainheadtopline">plainheadtopline</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.plainheadtopline">252</a></li>
-<li><a name="option.priority"></a><a href="#option.priority">priority</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.priority">183</a></li>
-<li><a name="option.ref"></a><a href="#option.ref">ref</a> --&gt; <a href="scrguien.pdf#desc:scrjura.option.ref">298</a></li>
-<li><a name="option.refline"></a><a href="#option.refline">refline</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.refline">190</a></li>
-<li><a name="option.sectionentrydots"></a><a href="#option.sectionentrydots">sectionentrydots</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.sectionentrydots">72</a></li>
-<li><a name="option.singlespacing"></a><a href="#option.singlespacing">singlespacing</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.singlespacing">402</a></li>
-<li><a name="option.subject"></a><a href="#option.subject">subject</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.subject">194</a></li>
-<li><a name="option.symbolicnames"></a><a href="#option.symbolicnames">symbolicnames</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.symbolicnames">177</a></li>
-<li><a name="option.titlepage"></a><a href="#option.titlepage">titlepage</a> --&gt; <a href="scrguien.pdf#desc:scrextend.option.titlepage">272</a>, <a href="scrguien.pdf#desc:maincls.option.titlepage">62</a></li>
-<li><a name="option.toc"></a><a href="#option.toc">toc</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.toc">69</a></li>
-<li><a name="option.twocolumn"></a><a href="#option.twocolumn">twocolumn</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.twocolumn">39</a></li>
-<li><a name="option.twoside"></a><a href="#option.twoside">twoside</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.twoside">39</a></li>
-<li><a name="option.usegeometry"></a><a href="#option.usegeometry">usegeometry</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.option.usegeometry">439</a></li>
-<li><a name="option.version"></a><a href="#option.version">version</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.version">150</a>, <a href="scrguien.pdf#desc:scrextend.option.version">267</a>, <a href="scrguien.pdf#desc:typearea.option.version">30</a>, <a href="scrguien.pdf#desc:maincls.option.version">53</a></li>
+<li><a name="option.12h"></a><a href="#option.12h">12h</a> --&gt; <a href="scrguien.pdf#desc:scrtime.option.12h">268</a></li>
+<li><a name="option.BCOR"></a><a href="#option.BCOR">BCOR</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.BCOR">33</a></li>
+<li><a name="option.DIV"></a><a href="#option.DIV">DIV</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.DIV">34</a></li>
+<li><a name="option.abstract"></a><a href="#option.abstract">abstract</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.abstract">71</a></li>
+<li><a name="option.addrfield"></a><a href="#option.addrfield">addrfield</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.addrfield">194</a></li>
+<li><a name="option.adrFreeIVempty"></a><a href="#option.adrFreeIVempty">adrFreeIVempty</a> --&gt; <a href="scrguien.pdf#desc:scraddr.option.adrFreeIVempty">272</a></li>
+<li><a name="option.adrFreeIVshow"></a><a href="#option.adrFreeIVshow">adrFreeIVshow</a> --&gt; <a href="scrguien.pdf#desc:scraddr.option.adrFreeIVshow">272</a></li>
+<li><a name="option.adrFreeIVstop"></a><a href="#option.adrFreeIVstop">adrFreeIVstop</a> --&gt; <a href="scrguien.pdf#desc:scraddr.option.adrFreeIVstop">272</a></li>
+<li><a name="option.adrFreeIVwarn"></a><a href="#option.adrFreeIVwarn">adrFreeIVwarn</a> --&gt; <a href="scrguien.pdf#desc:scraddr.option.adrFreeIVwarn">272</a></li>
+<li><a name="option.appendixprefix"></a><a href="#option.appendixprefix">appendixprefix</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.appendixprefix">95</a></li>
+<li><a name="option.areasetadvanced"></a><a href="#option.areasetadvanced">areasetadvanced</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.option.areasetadvanced">450</a></li>
+<li><a name="option.autoclearnotecolumns"></a><a href="#option.autoclearnotecolumns">autoclearnotecolumns</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.option.autoclearnotecolumns">447</a></li>
+<li><a name="option.autoenlargeheadfoot"></a><a href="#option.autoenlargeheadfoot">autoenlargeheadfoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.autoenlargeheadfoot">238</a></li>
+<li><a name="option.automark"></a><a href="#option.automark">automark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.automark">253</a>, <a href="scrguien.pdf#desc:scrlayer.option.automark">419</a></li>
+<li><a name="option.autooneside"></a><a href="#option.autooneside">autooneside</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.autooneside">253</a>, <a href="scrguien.pdf#desc:scrlayer.option.autooneside">419</a></li>
+<li><a name="option.autoremoveinterfaces"></a><a href="#option.autoremoveinterfaces">autoremoveinterfaces</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.autoremoveinterfaces">425</a></li>
+<li><a name="option.backaddress"></a><a href="#option.backaddress">backaddress</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.backaddress">194</a></li>
+<li><a name="option.bibliography"></a><a href="#option.bibliography">bibliography</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.bibliography">146</a></li>
+<li><a name="option.captions"></a><a href="#option.captions">captions</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.captions">126</a></li>
+<li><a name="option.chapteratlists"></a><a href="#option.chapteratlists">chapteratlists</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.chapteratlists">99</a></li>
+<li><a name="option.chapterentrydots"></a><a href="#option.chapterentrydots">chapterentrydots</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.chapterentrydots">74</a></li>
+<li><a name="option.chapterprefix"></a><a href="#option.chapterprefix">chapterprefix</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.chapterprefix">95</a></li>
+<li><a name="option.clausemark"></a><a href="#option.clausemark">clausemark</a> --&gt; <a href="scrguien.pdf#desc:scrjura.option.clausemark">300</a></li>
+<li><a name="option.cleardoublepage"></a><a href="#option.cleardoublepage">cleardoublepage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.cleardoublepage">215</a>, <a href="scrguien.pdf#desc:scrextend.option.cleardoublepage">286</a>, <a href="scrguien.pdf#desc:maincls.option.cleardoublepage">86</a></li>
+<li><a name="option.clines"></a><a href="#option.clines">clines</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.clines">261</a></li>
+<li><a name="option.contract"></a><a href="#option.contract">contract</a> --&gt; <a href="scrguien.pdf#desc:scrjura.option.contract">298</a></li>
+<li><a name="option.deactivatepagestylelayers"></a><a href="#option.deactivatepagestylelayers">deactivatepagestylelayers</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.deactivatepagestylelayers">414</a></li>
+<li><a name="option.draft"></a><a href="#option.draft">draft</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.draft">160</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.option.draft">254</a>, <a href="scrguien.pdf#desc:scrextend.option.draft">277</a>, <a href="scrguien.pdf#desc:scrlayer.option.draft">419</a>, <a href="scrguien.pdf#desc:maincls.option.draft">56</a></li>
+<li><a name="option.enlargefirstpage"></a><a href="#option.enlargefirstpage">enlargefirstpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.enlargefirstpage">181</a></li>
+<li><a name="option.extendedfeature"></a><a href="#option.extendedfeature">extendedfeature</a> --&gt; <a href="scrguien.pdf#desc:scrextend.option.extendedfeature">277</a></li>
+<li><a name="option.firstfoot"></a><a href="#option.firstfoot">firstfoot</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.firstfoot">206</a></li>
+<li><a name="option.firsthead"></a><a href="#option.firsthead">firsthead</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.firsthead">181</a></li>
+<li><a name="option.fleqn"></a><a href="#option.fleqn">fleqn</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.fleqn">126</a></li>
+<li><a name="option.foldmarks"></a><a href="#option.foldmarks">foldmarks</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.foldmarks">177</a></li>
+<li><a name="option.fontsize"></a><a href="#option.fontsize">fontsize</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.fontsize">171</a>, <a href="scrguien.pdf#desc:scrextend.option.fontsize">278</a>, <a href="scrguien.pdf#desc:maincls.option.fontsize">57</a></li>
+<li><a name="option.footbotline"></a><a href="#option.footbotline">footbotline</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.footbotline">259</a></li>
+<li><a name="option.footheight"></a><a href="#option.footheight">footheight</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.footheight">45</a></li>
+<li><a name="option.footinclude"></a><a href="#option.footinclude">footinclude</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.footinclude">42</a></li>
+<li><a name="option.footlines"></a><a href="#option.footlines">footlines</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.footlines">45</a></li>
+<li><a name="option.footnotes"></a><a href="#option.footnotes">footnotes</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.footnotes">216</a>, <a href="scrguien.pdf#desc:scrextend.option.footnotes">288</a>, <a href="scrguien.pdf#desc:maincls.option.footnotes">89</a></li>
+<li><a name="option.footsepline"></a><a href="#option.footsepline">footsepline</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.footsepline">210</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.option.footsepline">259</a>, <a href="scrguien.pdf#desc:maincls.option.footsepline">80</a></li>
+<li><a name="option.footwidth"></a><a href="#option.footwidth">footwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.footwidth">259</a></li>
+<li><a name="option.forceoverwrite"></a><a href="#option.forceoverwrite">forceoverwrite</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.forceoverwrite">425</a></li>
+<li><a name="option.fromalign"></a><a href="#option.fromalign">fromalign</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.fromalign">181</a></li>
+<li><a name="option.fromemail"></a><a href="#option.fromemail">fromemail</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.fromemail">186</a></li>
+<li><a name="option.fromfax"></a><a href="#option.fromfax">fromfax</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.fromfax">186</a></li>
+<li><a name="option.fromlogo"></a><a href="#option.fromlogo">fromlogo</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.fromlogo">190</a></li>
+<li><a name="option.frommobilephone"></a><a href="#option.frommobilephone">frommobilephone</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.frommobilephone">186</a></li>
+<li><a name="option.fromphone"></a><a href="#option.fromphone">fromphone</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.fromphone">186</a></li>
+<li><a name="option.fromrule"></a><a href="#option.fromrule">fromrule</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.fromrule">181</a></li>
+<li><a name="option.fromurl"></a><a href="#option.fromurl">fromurl</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.fromurl">186</a></li>
+<li><a name="option.headheight"></a><a href="#option.headheight">headheight</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.headheight">44</a></li>
+<li><a name="option.headinclude"></a><a href="#option.headinclude">headinclude</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.headinclude">42</a></li>
+<li><a name="option.headings"></a><a href="#option.headings">headings</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.headings">96</a></li>
+<li><a name="option.headlines"></a><a href="#option.headlines">headlines</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.headlines">44</a></li>
+<li><a name="option.headsepline"></a><a href="#option.headsepline">headsepline</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.headsepline">210</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.option.headsepline">259</a>, <a href="scrguien.pdf#desc:maincls.option.headsepline">80</a></li>
+<li><a name="option.headtopline"></a><a href="#option.headtopline">headtopline</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.headtopline">259</a></li>
+<li><a name="option.headwidth"></a><a href="#option.headwidth">headwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.headwidth">259</a></li>
+<li><a name="option.ilines"></a><a href="#option.ilines">ilines</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.ilines">261</a></li>
+<li><a name="option.index"></a><a href="#option.index">index</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.index">149</a></li>
+<li><a name="option.internalonly"></a><a href="#option.internalonly">internalonly</a> --&gt; <a href="scrguien.pdf#desc:scrbase.option.internalonly">331</a></li>
+<li><a name="option.juratitlepagebreak"></a><a href="#option.juratitlepagebreak">juratitlepagebreak</a> --&gt; <a href="scrguien.pdf#desc:scrjura.option.juratitlepagebreak">300</a></li>
+<li><a name="option.juratocindent"></a><a href="#option.juratocindent">juratocindent</a> --&gt; <a href="scrguien.pdf#desc:scrjura.option.juratocindent">297</a></li>
+<li><a name="option.juratocnumberwidth"></a><a href="#option.juratocnumberwidth">juratocnumberwidth</a> --&gt; <a href="scrguien.pdf#desc:scrjura.option.juratocnumberwidth">297</a></li>
+<li><a name="option.juratotoc"></a><a href="#option.juratotoc">juratotoc</a> --&gt; <a href="scrguien.pdf#desc:scrjura.option.juratotoc">297</a></li>
+<li><a name="option.leqno"></a><a href="#option.leqno">leqno</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.leqno">126</a></li>
+<li><a name="option.listof"></a><a href="#option.listof">listof</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.listof">141</a></li>
+<li><a name="option.locfield"></a><a href="#option.locfield">locfield</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.locfield">197</a></li>
+<li><a name="option.manualmark"></a><a href="#option.manualmark">manualmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.manualmark">253</a>, <a href="scrguien.pdf#desc:scrlayer.option.manualmark">419</a></li>
+<li><a name="option.markcase"></a><a href="#option.markcase">markcase</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.markcase">254</a>, <a href="scrguien.pdf#desc:scrlayer.option.markcase">420</a></li>
+<li><a name="option.mpinclude"></a><a href="#option.mpinclude">mpinclude</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.mpinclude">43</a></li>
+<li><a name="option.numbers"></a><a href="#option.numbers">numbers</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.numbers">98</a></li>
+<li><a name="option.numericaldate"></a><a href="#option.numericaldate">numericaldate</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.numericaldate">199</a></li>
+<li><a name="option.olines"></a><a href="#option.olines">olines</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.olines">261</a></li>
+<li><a name="option.onpsbackground"></a><a href="#option.onpsbackground">onpsbackground</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsbackground">414</a></li>
+<li><a name="option.onpsevenpage"></a><a href="#option.onpsevenpage">onpsevenpage</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsevenpage">414</a></li>
+<li><a name="option.onpsfloatpage"></a><a href="#option.onpsfloatpage">onpsfloatpage</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsfloatpage">414</a></li>
+<li><a name="option.onpsforeground"></a><a href="#option.onpsforeground">onpsforeground</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsforeground">414</a></li>
+<li><a name="option.onpsinit"></a><a href="#option.onpsinit">onpsinit</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsinit">414</a></li>
+<li><a name="option.onpsnonfloatpage"></a><a href="#option.onpsnonfloatpage">onpsnonfloatpage</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsnonfloatpage">414</a></li>
+<li><a name="option.onpsoddpage"></a><a href="#option.onpsoddpage">onpsoddpage</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsoddpage">414</a></li>
+<li><a name="option.onpsoneside"></a><a href="#option.onpsoneside">onpsoneside</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsoneside">414</a></li>
+<li><a name="option.onpsselect"></a><a href="#option.onpsselect">onpsselect</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpsselect">414</a></li>
+<li><a name="option.onpstwoside"></a><a href="#option.onpstwoside">onpstwoside</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.onpstwoside">414</a></li>
+<li><a name="option.open"></a><a href="#option.open">open</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.open">94</a></li>
+<li><a name="option.origlongtable"></a><a href="#option.origlongtable">origlongtable</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.origlongtable">141</a></li>
+<li><a name="option.overfullrule"></a><a href="#option.overfullrule">overfullrule</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.overfullrule">160</a>, <a href="scrguien.pdf#desc:scrextend.option.overfullrule">277</a>, <a href="scrguien.pdf#desc:maincls.option.overfullrule">56</a></li>
+<li><a name="option.pagenumber"></a><a href="#option.pagenumber">pagenumber</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.pagenumber">211</a></li>
+<li><a name="option.pagesize"></a><a href="#option.pagesize">pagesize</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.pagesize">49</a></li>
+<li><a name="option.pagestyleset"></a><a href="#option.pagestyleset">pagestyleset</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.pagestyleset">250</a></li>
+<li><a name="option.paper"></a><a href="#option.paper">paper</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.paper">48</a></li>
+<li><a name="option.parnumber"></a><a href="#option.parnumber">parnumber</a> --&gt; <a href="scrguien.pdf#desc:scrjura.option.parnumber">301</a></li>
+<li><a name="option.parskip"></a><a href="#option.parskip">parskip</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.parskip">208</a>, <a href="scrguien.pdf#desc:maincls.option.parskip">77</a></li>
+<li><a name="option.plainfootbotline"></a><a href="#option.plainfootbotline">plainfootbotline</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.plainfootbotline">261</a></li>
+<li><a name="option.plainfootsepline"></a><a href="#option.plainfootsepline">plainfootsepline</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.plainfootsepline">261</a></li>
+<li><a name="option.plainheadsepline"></a><a href="#option.plainheadsepline">plainheadsepline</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.plainheadsepline">261</a></li>
+<li><a name="option.plainheadtopline"></a><a href="#option.plainheadtopline">plainheadtopline</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.option.plainheadtopline">261</a></li>
+<li><a name="option.priority"></a><a href="#option.priority">priority</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.priority">194</a></li>
+<li><a name="option.ref"></a><a href="#option.ref">ref</a> --&gt; <a href="scrguien.pdf#desc:scrjura.option.ref">305</a></li>
+<li><a name="option.refline"></a><a href="#option.refline">refline</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.refline">200</a></li>
+<li><a name="option.sectionentrydots"></a><a href="#option.sectionentrydots">sectionentrydots</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.sectionentrydots">74</a></li>
+<li><a name="option.singlespacing"></a><a href="#option.singlespacing">singlespacing</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.option.singlespacing">414</a></li>
+<li><a name="option.subject"></a><a href="#option.subject">subject</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.subject">203</a></li>
+<li><a name="option.symbolicnames"></a><a href="#option.symbolicnames">symbolicnames</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.symbolicnames">186</a></li>
+<li><a name="option.titlepage"></a><a href="#option.titlepage">titlepage</a> --&gt; <a href="scrguien.pdf#desc:scrextend.option.titlepage">281</a>, <a href="scrguien.pdf#desc:maincls.option.titlepage">65</a></li>
+<li><a name="option.toc"></a><a href="#option.toc">toc</a> --&gt; <a href="scrguien.pdf#desc:maincls.option.toc">72</a></li>
+<li><a name="option.twocolumn"></a><a href="#option.twocolumn">twocolumn</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.twocolumn">41</a></li>
+<li><a name="option.twoside"></a><a href="#option.twoside">twoside</a> --&gt; <a href="scrguien.pdf#desc:typearea.option.twoside">41</a></li>
+<li><a name="option.usegeometry"></a><a href="#option.usegeometry">usegeometry</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.option.usegeometry">449</a></li>
+<li><a name="option.version"></a><a href="#option.version">version</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.option.version">159</a>, <a href="scrguien.pdf#desc:scrextend.option.version">276</a>, <a href="scrguien.pdf#desc:typearea.option.version">32</a>, <a href="scrguien.pdf#desc:maincls.option.version">55</a></li>
</ul>
<h2><a name="macro">Commands</a></h2>
<ul>
-<li><a name="cmd.@addtoplength"></a><a href="#cmd.@addtoplength">\@addtoplength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.@addtoplength">473</a></li>
-<li><a name="cmd.@fontsizefilebase"></a><a href="#cmd.@fontsizefilebase">\@fontsizefilebase</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.@fontsizefilebase">445</a></li>
-<li><a name="cmd.@mkboth"></a><a href="#cmd.@mkboth">\@mkboth</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.@mkboth">411</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.@mkboth">417</a></li>
-<li><a name="cmd.@mkdouble"></a><a href="#cmd.@mkdouble">\@mkdouble</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.@mkdouble">411</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.@mkdouble">417</a></li>
-<li><a name="cmd.@mkleft"></a><a href="#cmd.@mkleft">\@mkleft</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.@mkleft">411</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.@mkleft">417</a></li>
-<li><a name="cmd.@mkright"></a><a href="#cmd.@mkright">\@mkright</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.@mkright">411</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.@mkright">417</a></li>
-<li><a name="cmd.@newplength"></a><a href="#cmd.@newplength">\@newplength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.@newplength">471</a></li>
-<li><a name="cmd.@openbib@code"></a><a href="#cmd.@openbib@code">\@openbib@code</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.@openbib@code">465</a></li>
-<li><a name="cmd.@setplength"></a><a href="#cmd.@setplength">\@setplength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.@setplength">473</a></li>
-<li><a name="cmd.AddLayersAtBeginOfPageStyle"></a><a href="#cmd.AddLayersAtBeginOfPageStyle">\AddLayersAtBeginOfPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.AddLayersAtBeginOfPageStyle">403</a></li>
-<li><a name="cmd.AddLayersAtEndOfPageStyle"></a><a href="#cmd.AddLayersAtEndOfPageStyle">\AddLayersAtEndOfPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.AddLayersAtEndOfPageStyle">403</a></li>
-<li><a name="cmd.AddLayersToPageStyle"></a><a href="#cmd.AddLayersToPageStyle">\AddLayersToPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.AddLayersToPageStyle">403</a></li>
-<li><a name="cmd.AddLayersToPageStyleAfterLayer"></a><a href="#cmd.AddLayersToPageStyleAfterLayer">\AddLayersToPageStyleAfterLayer</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.AddLayersToPageStyleAfterLayer">404</a></li>
-<li><a name="cmd.AddLayersToPageStyleBeforeLayer"></a><a href="#cmd.AddLayersToPageStyleBeforeLayer">\AddLayersToPageStyleBeforeLayer</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.AddLayersToPageStyleBeforeLayer">404</a></li>
-<li><a name="cmd.AddToLayerPageStyleOptions"></a><a href="#cmd.AddToLayerPageStyleOptions">\AddToLayerPageStyleOptions</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.AddToLayerPageStyleOptions">404</a></li>
-<li><a name="cmd.Address"></a><a href="#cmd.Address">\Address</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.Address">261</a></li>
-<li><a name="cmd.AfterAtEndOfClass"></a><a href="#cmd.AfterAtEndOfClass">\AfterAtEndOfClass</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterAtEndOfClass">333</a></li>
-<li><a name="cmd.AfterAtEndOfPackage"></a><a href="#cmd.AfterAtEndOfPackage">\AfterAtEndOfPackage</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterAtEndOfPackage">333</a></li>
-<li><a name="cmd.AfterBibliographyPreamble"></a><a href="#cmd.AfterBibliographyPreamble">\AfterBibliographyPreamble</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.AfterBibliographyPreamble">141</a></li>
-<li><a name="cmd.AfterCalculatingTypearea*"></a><a href="#cmd.AfterCalculatingTypearea*">\AfterCalculatingTypearea*</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.AfterCalculatingTypearea*">441</a></li>
-<li><a name="cmd.AfterCalculatingTypearea"></a><a href="#cmd.AfterCalculatingTypearea">\AfterCalculatingTypearea</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.AfterCalculatingTypearea">441</a></li>
-<li><a name="cmd.AfterClass!"></a><a href="#cmd.AfterClass!">\AfterClass!</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterClass!">333</a></li>
-<li><a name="cmd.AfterClass*"></a><a href="#cmd.AfterClass*">\AfterClass*</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterClass*">333</a></li>
-<li><a name="cmd.AfterClass+"></a><a href="#cmd.AfterClass+">\AfterClass+</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterClass+">333</a></li>
-<li><a name="cmd.AfterClass"></a><a href="#cmd.AfterClass">\AfterClass</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterClass">333</a></li>
-<li><a name="cmd.AfterFile"></a><a href="#cmd.AfterFile">\AfterFile</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterFile">332</a></li>
-<li><a name="cmd.AfterPackage!"></a><a href="#cmd.AfterPackage!">\AfterPackage!</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterPackage!">333</a></li>
-<li><a name="cmd.AfterPackage*"></a><a href="#cmd.AfterPackage*">\AfterPackage*</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterPackage*">333</a></li>
-<li><a name="cmd.AfterPackage+"></a><a href="#cmd.AfterPackage+">\AfterPackage+</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterPackage+">333</a></li>
-<li><a name="cmd.AfterPackage"></a><a href="#cmd.AfterPackage">\AfterPackage</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterPackage">333</a></li>
-<li><a name="cmd.AfterReadingMainAux"></a><a href="#cmd.AfterReadingMainAux">\AfterReadingMainAux</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterReadingMainAux">335</a></li>
-<li><a name="cmd.AfterRestoreareas*"></a><a href="#cmd.AfterRestoreareas*">\AfterRestoreareas*</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.AfterRestoreareas*">440</a></li>
-<li><a name="cmd.AfterRestoreareas"></a><a href="#cmd.AfterRestoreareas">\AfterRestoreareas</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.AfterRestoreareas">440</a></li>
-<li><a name="cmd.AfterSelectAnyPageStyle"></a><a href="#cmd.AfterSelectAnyPageStyle">\AfterSelectAnyPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.AfterSelectAnyPageStyle">398</a></li>
-<li><a name="cmd.AfterSettingArea*"></a><a href="#cmd.AfterSettingArea*">\AfterSettingArea*</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.AfterSettingArea*">441</a></li>
-<li><a name="cmd.AfterSettingArea"></a><a href="#cmd.AfterSettingArea">\AfterSettingArea</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.AfterSettingArea">441</a></li>
-<li><a name="cmd.AfterStartingTOC"></a><a href="#cmd.AfterStartingTOC">\AfterStartingTOC</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.AfterStartingTOC">353</a></li>
-<li><a name="cmd.AfterTOCHead"></a><a href="#cmd.AfterTOCHead">\AfterTOCHead</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.AfterTOCHead">353</a></li>
-<li><a name="cmd.At@startsection"></a><a href="#cmd.At@startsection">\At@startsection</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.At@startsection">463</a></li>
-<li><a name="cmd.AtAddToTocList"></a><a href="#cmd.AtAddToTocList">\AtAddToTocList</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.AtAddToTocList">348</a></li>
-<li><a name="cmd.AtBeginLetter"></a><a href="#cmd.AtBeginLetter">\AtBeginLetter</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.AtBeginLetter">155</a></li>
-<li><a name="cmd.AtEndBibliography"></a><a href="#cmd.AtEndBibliography">\AtEndBibliography</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.AtEndBibliography">141</a></li>
-<li><a name="cmd.AtEndLetter"></a><a href="#cmd.AtEndLetter">\AtEndLetter</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.AtEndLetter">155</a></li>
-<li><a name="cmd.AtEndOfFamilyOptions*"></a><a href="#cmd.AtEndOfFamilyOptions*">\AtEndOfFamilyOptions*</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.AtEndOfFamilyOptions*">315</a></li>
-<li><a name="cmd.AtEndOfFamilyOptions"></a><a href="#cmd.AtEndOfFamilyOptions">\AtEndOfFamilyOptions</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.AtEndOfFamilyOptions">315</a></li>
-<li><a name="cmd.Before@sect"></a><a href="#cmd.Before@sect">\Before@sect</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.Before@sect">463</a></li>
-<li><a name="cmd.Before@ssect"></a><a href="#cmd.Before@ssect">\Before@ssect</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.Before@ssect">463</a></li>
-<li><a name="cmd.BeforeClass"></a><a href="#cmd.BeforeClass">\BeforeClass</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.BeforeClass">332</a></li>
-<li><a name="cmd.BeforeClosingMainAux"></a><a href="#cmd.BeforeClosingMainAux">\BeforeClosingMainAux</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.BeforeClosingMainAux">335</a></li>
-<li><a name="cmd.BeforeFamilyProcessOptions"></a><a href="#cmd.BeforeFamilyProcessOptions">\BeforeFamilyProcessOptions</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.BeforeFamilyProcessOptions">312</a></li>
-<li><a name="cmd.BeforeFile"></a><a href="#cmd.BeforeFile">\BeforeFile</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.BeforeFile">332</a></li>
-<li><a name="cmd.BeforePackage"></a><a href="#cmd.BeforePackage">\BeforePackage</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.BeforePackage">332</a></li>
-<li><a name="cmd.BeforeRestoreareas*"></a><a href="#cmd.BeforeRestoreareas*">\BeforeRestoreareas*</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.BeforeRestoreareas*">440</a></li>
-<li><a name="cmd.BeforeRestoreareas"></a><a href="#cmd.BeforeRestoreareas">\BeforeRestoreareas</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.BeforeRestoreareas">440</a></li>
-<li><a name="cmd.BeforeSelectAnyPageStyle"></a><a href="#cmd.BeforeSelectAnyPageStyle">\BeforeSelectAnyPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.BeforeSelectAnyPageStyle">398</a></li>
-<li><a name="cmd.BeforeStartingTOC"></a><a href="#cmd.BeforeStartingTOC">\BeforeStartingTOC</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.BeforeStartingTOC">353</a></li>
-<li><a name="cmd.BeforeTOCHead"></a><a href="#cmd.BeforeTOCHead">\BeforeTOCHead</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.BeforeTOCHead">353</a></li>
-<li><a name="cmd.BreakBibliography"></a><a href="#cmd.BreakBibliography">\BreakBibliography</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.BreakBibliography">141</a></li>
-<li><a name="cmd.CenturyPart"></a><a href="#cmd.CenturyPart">\CenturyPart</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.CenturyPart">253</a></li>
-<li><a name="cmd.ClassName"></a><a href="#cmd.ClassName">\ClassName</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.ClassName">443</a></li>
-<li><a name="cmd.Clause"></a><a href="#cmd.Clause">\Clause</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.Clause">291</a></li>
-<li><a name="cmd.Clauseformat"></a><a href="#cmd.Clauseformat">\Clauseformat</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.Clauseformat">292</a></li>
-<li><a name="cmd.CloneTOCEntryStyle"></a><a href="#cmd.CloneTOCEntryStyle">\CloneTOCEntryStyle</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.CloneTOCEntryStyle">366</a></li>
-<li><a name="cmd.Comment"></a><a href="#cmd.Comment">\Comment</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.Comment">261</a></li>
-<li><a name="cmd.DayName"></a><a href="#cmd.DayName">\DayName</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.DayName">254</a></li>
-<li><a name="cmd.DayNameByNumber"></a><a href="#cmd.DayNameByNumber">\DayNameByNumber</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.DayNameByNumber">254</a></li>
-<li><a name="cmd.DayNumber"></a><a href="#cmd.DayNumber">\DayNumber</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.DayNumber">253</a></li>
-<li><a name="cmd.DecadePart"></a><a href="#cmd.DecadePart">\DecadePart</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.DecadePart">253</a></li>
-<li><a name="cmd.DeclareLayer"></a><a href="#cmd.DeclareLayer">\DeclareLayer</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DeclareLayer">387</a></li>
-<li><a name="cmd.DeclareNewJuraEnvironment"></a><a href="#cmd.DeclareNewJuraEnvironment">\DeclareNewJuraEnvironment</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.DeclareNewJuraEnvironment">299</a></li>
-<li><a name="cmd.DeclareNewLayer"></a><a href="#cmd.DeclareNewLayer">\DeclareNewLayer</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DeclareNewLayer">387</a></li>
-<li><a name="cmd.DeclareNewNoteColumn"></a><a href="#cmd.DeclareNewNoteColumn">\DeclareNewNoteColumn</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.DeclareNewNoteColumn">429</a></li>
-<li><a name="cmd.DeclareNewPageStyleAlias"></a><a href="#cmd.DeclareNewPageStyleAlias">\DeclareNewPageStyleAlias</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DeclareNewPageStyleAlias">398</a></li>
-<li><a name="cmd.DeclareNewPageStyleByLayers"></a><a href="#cmd.DeclareNewPageStyleByLayers">\DeclareNewPageStyleByLayers</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DeclareNewPageStyleByLayers">399</a></li>
-<li><a name="cmd.DeclareNewSectionCommand"></a><a href="#cmd.DeclareNewSectionCommand">\DeclareNewSectionCommand</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.DeclareNewSectionCommand">448</a></li>
-<li><a name="cmd.DeclareNewSectionCommands"></a><a href="#cmd.DeclareNewSectionCommands">\DeclareNewSectionCommands</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.DeclareNewSectionCommands">457</a></li>
-<li><a name="cmd.DeclareNewTOC"></a><a href="#cmd.DeclareNewTOC">\DeclareNewTOC</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DeclareNewTOC">373</a></li>
-<li><a name="cmd.DeclareNoteColumn"></a><a href="#cmd.DeclareNoteColumn">\DeclareNoteColumn</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.DeclareNoteColumn">429</a></li>
-<li><a name="cmd.DeclarePageStyleAlias"></a><a href="#cmd.DeclarePageStyleAlias">\DeclarePageStyleAlias</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DeclarePageStyleAlias">398</a></li>
-<li><a name="cmd.DeclarePageStyleByLayers"></a><a href="#cmd.DeclarePageStyleByLayers">\DeclarePageStyleByLayers</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DeclarePageStyleByLayers">399</a></li>
-<li><a name="cmd.DeclareSectionCommand"></a><a href="#cmd.DeclareSectionCommand">\DeclareSectionCommand</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.DeclareSectionCommand">448</a></li>
-<li><a name="cmd.DeclareSectionCommands"></a><a href="#cmd.DeclareSectionCommands">\DeclareSectionCommands</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.DeclareSectionCommands">457</a></li>
-<li><a name="cmd.DeclareSectionNumberDepth"></a><a href="#cmd.DeclareSectionNumberDepth">\DeclareSectionNumberDepth</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DeclareSectionNumberDepth">385</a></li>
-<li><a name="cmd.DeclareTOCEntryStyle"></a><a href="#cmd.DeclareTOCEntryStyle">\DeclareTOCEntryStyle</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DeclareTOCEntryStyle">365</a></li>
-<li><a name="cmd.DeclareTOCStyleEntry"></a><a href="#cmd.DeclareTOCStyleEntry">\DeclareTOCStyleEntry</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DeclareTOCStyleEntry">357</a></li>
-<li><a name="cmd.DefineFamily"></a><a href="#cmd.DefineFamily">\DefineFamily</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.DefineFamily">309</a></li>
-<li><a name="cmd.DefineFamilyKey"></a><a href="#cmd.DefineFamilyKey">\DefineFamilyKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.DefineFamilyKey">310</a></li>
-<li><a name="cmd.DefineFamilyMember"></a><a href="#cmd.DefineFamilyMember">\DefineFamilyMember</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.DefineFamilyMember">309</a></li>
-<li><a name="cmd.DefineTOCEntryBooleanOption"></a><a href="#cmd.DefineTOCEntryBooleanOption">\DefineTOCEntryBooleanOption</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DefineTOCEntryBooleanOption">365</a></li>
-<li><a name="cmd.DefineTOCEntryCommandOption"></a><a href="#cmd.DefineTOCEntryCommandOption">\DefineTOCEntryCommandOption</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DefineTOCEntryCommandOption">365</a></li>
-<li><a name="cmd.DefineTOCEntryIfOption"></a><a href="#cmd.DefineTOCEntryIfOption">\DefineTOCEntryIfOption</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DefineTOCEntryIfOption">365</a></li>
-<li><a name="cmd.DefineTOCEntryLengthOption"></a><a href="#cmd.DefineTOCEntryLengthOption">\DefineTOCEntryLengthOption</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DefineTOCEntryLengthOption">365</a></li>
-<li><a name="cmd.DefineTOCEntryNumberOption"></a><a href="#cmd.DefineTOCEntryNumberOption">\DefineTOCEntryNumberOption</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DefineTOCEntryNumberOption">365</a></li>
-<li><a name="cmd.DefineTOCEntryOption"></a><a href="#cmd.DefineTOCEntryOption">\DefineTOCEntryOption</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DefineTOCEntryOption">365</a></li>
-<li><a name="cmd.DestroyLayer"></a><a href="#cmd.DestroyLayer">\DestroyLayer</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DestroyLayer">396</a></li>
-<li><a name="cmd.DestroyPageStyleAlias"></a><a href="#cmd.DestroyPageStyleAlias">\DestroyPageStyleAlias</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DestroyPageStyleAlias">399</a></li>
-<li><a name="cmd.DestroyRealLayerPageStyle"></a><a href="#cmd.DestroyRealLayerPageStyle">\DestroyRealLayerPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DestroyRealLayerPageStyle">405</a></li>
-<li><a name="cmd.FamilyBoolKey"></a><a href="#cmd.FamilyBoolKey">\FamilyBoolKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyBoolKey">315</a></li>
-<li><a name="cmd.FamilyCounterKey"></a><a href="#cmd.FamilyCounterKey">\FamilyCounterKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyCounterKey">318</a></li>
-<li><a name="cmd.FamilyCounterMacroKey"></a><a href="#cmd.FamilyCounterMacroKey">\FamilyCounterMacroKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyCounterMacroKey">318</a></li>
-<li><a name="cmd.FamilyElseValues"></a><a href="#cmd.FamilyElseValues">\FamilyElseValues</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyElseValues">321</a></li>
-<li><a name="cmd.FamilyExecuteOptions"></a><a href="#cmd.FamilyExecuteOptions">\FamilyExecuteOptions</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyExecuteOptions">313</a></li>
-<li><a name="cmd.FamilyKeyState"></a><a href="#cmd.FamilyKeyState">\FamilyKeyState</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyKeyState">310</a></li>
-<li><a name="cmd.FamilyKeyStateNeedValue"></a><a href="#cmd.FamilyKeyStateNeedValue">\FamilyKeyStateNeedValue</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyKeyStateNeedValue">310</a></li>
-<li><a name="cmd.FamilyKeyStateProcessed"></a><a href="#cmd.FamilyKeyStateProcessed">\FamilyKeyStateProcessed</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyKeyStateProcessed">310</a></li>
-<li><a name="cmd.FamilyKeyStateUnknown"></a><a href="#cmd.FamilyKeyStateUnknown">\FamilyKeyStateUnknown</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyKeyStateUnknown">310</a></li>
-<li><a name="cmd.FamilyKeyStateUnknownValue"></a><a href="#cmd.FamilyKeyStateUnknownValue">\FamilyKeyStateUnknownValue</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyKeyStateUnknownValue">310</a></li>
-<li><a name="cmd.FamilyLengthKey"></a><a href="#cmd.FamilyLengthKey">\FamilyLengthKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyLengthKey">319</a></li>
-<li><a name="cmd.FamilyLengthMacroKey"></a><a href="#cmd.FamilyLengthMacroKey">\FamilyLengthMacroKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyLengthMacroKey">319</a></li>
-<li><a name="cmd.FamilyNumericalKey"></a><a href="#cmd.FamilyNumericalKey">\FamilyNumericalKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyNumericalKey">317</a></li>
-<li><a name="cmd.FamilyOption"></a><a href="#cmd.FamilyOption">\FamilyOption</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyOption">314</a></li>
-<li><a name="cmd.FamilyOptions"></a><a href="#cmd.FamilyOptions">\FamilyOptions</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyOptions">313</a></li>
-<li><a name="cmd.FamilyProcessOptions"></a><a href="#cmd.FamilyProcessOptions">\FamilyProcessOptions</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyProcessOptions">311</a></li>
-<li><a name="cmd.FamilySetBool"></a><a href="#cmd.FamilySetBool">\FamilySetBool</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilySetBool">315</a></li>
-<li><a name="cmd.FamilySetCounter"></a><a href="#cmd.FamilySetCounter">\FamilySetCounter</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilySetCounter">318</a></li>
-<li><a name="cmd.FamilySetCounterMacro"></a><a href="#cmd.FamilySetCounterMacro">\FamilySetCounterMacro</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilySetCounterMacro">318</a></li>
-<li><a name="cmd.FamilySetLength"></a><a href="#cmd.FamilySetLength">\FamilySetLength</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilySetLength">319</a></li>
-<li><a name="cmd.FamilySetLengthMacro"></a><a href="#cmd.FamilySetLengthMacro">\FamilySetLengthMacro</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilySetLengthMacro">319</a></li>
-<li><a name="cmd.FamilySetNumerical"></a><a href="#cmd.FamilySetNumerical">\FamilySetNumerical</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilySetNumerical">317</a></li>
-<li><a name="cmd.FamilyStringKey"></a><a href="#cmd.FamilyStringKey">\FamilyStringKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyStringKey">319</a></li>
-<li><a name="cmd.FamilyUnknownKeyValue"></a><a href="#cmd.FamilyUnknownKeyValue">\FamilyUnknownKeyValue</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyUnknownKeyValue">320</a></li>
-<li><a name="cmd.FirstName"></a><a href="#cmd.FirstName">\FirstName</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.FirstName">261</a></li>
-<li><a name="cmd.ForEachLayerOfPageStyle*"></a><a href="#cmd.ForEachLayerOfPageStyle*">\ForEachLayerOfPageStyle*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.ForEachLayerOfPageStyle*">402</a></li>
-<li><a name="cmd.ForEachLayerOfPageStyle"></a><a href="#cmd.ForEachLayerOfPageStyle">\ForEachLayerOfPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.ForEachLayerOfPageStyle">402</a></li>
-<li><a name="cmd.FreeI"></a><a href="#cmd.FreeI">\FreeI</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.FreeI">261</a></li>
-<li><a name="cmd.FreeII"></a><a href="#cmd.FreeII">\FreeII</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.FreeII">261</a></li>
-<li><a name="cmd.FreeIII"></a><a href="#cmd.FreeIII">\FreeIII</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.FreeIII">261</a></li>
-<li><a name="cmd.FreeIV"></a><a href="#cmd.FreeIV">\FreeIV</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.FreeIV">261</a></li>
-<li><a name="cmd.GenericMarkFormat"></a><a href="#cmd.GenericMarkFormat">\GenericMarkFormat</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.GenericMarkFormat">410</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.GenericMarkFormat">414</a></li>
-<li><a name="cmd.GetLayerContents"></a><a href="#cmd.GetLayerContents">\GetLayerContents</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.GetLayerContents">396</a></li>
-<li><a name="cmd.GetRealPageStyle"></a><a href="#cmd.GetRealPageStyle">\GetRealPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.GetRealPageStyle">399</a></li>
-<li><a name="cmd.ISODayName"></a><a href="#cmd.ISODayName">\ISODayName</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.ISODayName">254</a></li>
-<li><a name="cmd.ISODayNumber"></a><a href="#cmd.ISODayNumber">\ISODayNumber</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.ISODayNumber">253</a></li>
-<li><a name="cmd.ISOToday"></a><a href="#cmd.ISOToday">\ISOToday</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.ISOToday">255</a></li>
-<li><a name="cmd.IfChapterUsesPrefixLine"></a><a href="#cmd.IfChapterUsesPrefixLine">\IfChapterUsesPrefixLine</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.IfChapterUsesPrefixLine">90</a></li>
-<li><a name="cmd.IfExistskomafont"></a><a href="#cmd.IfExistskomafont">\IfExistskomafont</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.IfExistskomafont">447</a></li>
-<li><a name="cmd.IfLayerAtPageStyle"></a><a href="#cmd.IfLayerAtPageStyle">\IfLayerAtPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.IfLayerAtPageStyle">405</a></li>
-<li><a name="cmd.IfLayerExists"></a><a href="#cmd.IfLayerExists">\IfLayerExists</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.IfLayerExists">396</a></li>
-<li><a name="cmd.IfLayerPageStyleExists"></a><a href="#cmd.IfLayerPageStyleExists">\IfLayerPageStyleExists</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.IfLayerPageStyleExists">404</a></li>
-<li><a name="cmd.IfLayersAtPageStyle"></a><a href="#cmd.IfLayersAtPageStyle">\IfLayersAtPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.IfLayersAtPageStyle">405</a></li>
-<li><a name="cmd.IfRealLayerPageStyleExists"></a><a href="#cmd.IfRealLayerPageStyleExists">\IfRealLayerPageStyleExists</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.IfRealLayerPageStyleExists">404</a></li>
-<li><a name="cmd.IfSomeLayerAtPageStyle"></a><a href="#cmd.IfSomeLayerAtPageStyle">\IfSomeLayerAtPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.IfSomeLayerAtPageStyle">405</a></li>
-<li><a name="cmd.IfUsePrefixLine"></a><a href="#cmd.IfUsePrefixLine">\IfUsePrefixLine</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.IfUsePrefixLine">103</a></li>
-<li><a name="cmd.InputAddressFile"></a><a href="#cmd.InputAddressFile">\InputAddressFile</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.InputAddressFile">260</a></li>
-<li><a name="cmd.IsoToday"></a><a href="#cmd.IsoToday">\IsoToday</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.IsoToday">255</a></li>
-<li><a name="cmd.KOMAClassName"></a><a href="#cmd.KOMAClassName">\KOMAClassName</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.KOMAClassName">443</a></li>
-<li><a name="cmd.KOMAScript"></a><a href="#cmd.KOMAScript">\KOMAScript</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.KOMAScript">329</a></li>
-<li><a name="cmd.KOMAScriptVersion"></a><a href="#cmd.KOMAScriptVersion">\KOMAScriptVersion</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.KOMAScriptVersion">329</a></li>
-<li><a name="cmd.KOMAoption"></a><a href="#cmd.KOMAoption">\KOMAoption</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.KOMAoption">150</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.KOMAoption">227</a>, <a href="scrguien.pdf#desc:scrextend.cmd.KOMAoption">266</a>, <a href="scrguien.pdf#desc:scrjura.cmd.KOMAoption">288</a>, <a href="scrguien.pdf#desc:typearea.cmd.KOMAoption">30</a>, <a href="scrguien.pdf#desc:scrhack.cmd.KOMAoption">379</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.KOMAoption">384</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.KOMAoption">427</a>, <a href="scrguien.pdf#desc:maincls.cmd.KOMAoption">52</a></li>
-<li><a name="cmd.KOMAoptions"></a><a href="#cmd.KOMAoptions">\KOMAoptions</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.KOMAoptions">150</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.KOMAoptions">227</a>, <a href="scrguien.pdf#desc:scrextend.cmd.KOMAoptions">266</a>, <a href="scrguien.pdf#desc:scrjura.cmd.KOMAoptions">288</a>, <a href="scrguien.pdf#desc:typearea.cmd.KOMAoptions">30</a>, <a href="scrguien.pdf#desc:scrhack.cmd.KOMAoptions">379</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.KOMAoptions">384</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.KOMAoptions">427</a>, <a href="scrguien.pdf#desc:maincls.cmd.KOMAoptions">52</a></li>
-<li><a name="cmd.LastName"></a><a href="#cmd.LastName">\LastName</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.LastName">261</a></li>
-<li><a name="cmd.LastTOCLevelWasHigher"></a><a href="#cmd.LastTOCLevelWasHigher">\LastTOCLevelWasHigher</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.LastTOCLevelWasHigher">367</a></li>
-<li><a name="cmd.LastTOCLevelWasLower"></a><a href="#cmd.LastTOCLevelWasLower">\LastTOCLevelWasLower</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.LastTOCLevelWasLower">367</a></li>
-<li><a name="cmd.LastTOCLevelWasSame"></a><a href="#cmd.LastTOCLevelWasSame">\LastTOCLevelWasSame</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.LastTOCLevelWasSame">367</a></li>
-<li><a name="cmd.LenToUnit"></a><a href="#cmd.LenToUnit">\LenToUnit</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.LenToUnit">395</a></li>
-<li><a name="cmd.LetterOptionNeedsPapersize"></a><a href="#cmd.LetterOptionNeedsPapersize">\LetterOptionNeedsPapersize</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.LetterOptionNeedsPapersize">486</a></li>
-<li><a name="cmd.LoadLetterOption"></a><a href="#cmd.LoadLetterOption">\LoadLetterOption</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.LoadLetterOption">216</a></li>
-<li><a name="cmd.LoadLetterOptions"></a><a href="#cmd.LoadLetterOptions">\LoadLetterOptions</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.LoadLetterOptions">216</a></li>
-<li><a name="cmd.MakeMarkcase"></a><a href="#cmd.MakeMarkcase">\MakeMarkcase</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.MakeMarkcase">245</a>, <a href="scrguien.pdf#desc:tocbasic.cmd.MakeMarkcase">353</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.MakeMarkcase">407</a></li>
-<li><a name="cmd.ModifyLayer"></a><a href="#cmd.ModifyLayer">\ModifyLayer</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.ModifyLayer">387</a></li>
-<li><a name="cmd.ModifyLayerPageStyleOptions"></a><a href="#cmd.ModifyLayerPageStyleOptions">\ModifyLayerPageStyleOptions</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.ModifyLayerPageStyleOptions">404</a></li>
-<li><a name="cmd.Name"></a><a href="#cmd.Name">\Name</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.Name">261</a></li>
-<li><a name="cmd.PreventPackageFromLoading*"></a><a href="#cmd.PreventPackageFromLoading*">\PreventPackageFromLoading*</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.PreventPackageFromLoading*">339</a></li>
-<li><a name="cmd.PreventPackageFromLoading"></a><a href="#cmd.PreventPackageFromLoading">\PreventPackageFromLoading</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.PreventPackageFromLoading">339</a></li>
-<li><a name="cmd.ProvideLayer"></a><a href="#cmd.ProvideLayer">\ProvideLayer</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.ProvideLayer">387</a></li>
-<li><a name="cmd.ProvideNoteColumn"></a><a href="#cmd.ProvideNoteColumn">\ProvideNoteColumn</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.ProvideNoteColumn">429</a></li>
-<li><a name="cmd.ProvidePageStyleAlias"></a><a href="#cmd.ProvidePageStyleAlias">\ProvidePageStyleAlias</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.ProvidePageStyleAlias">398</a></li>
-<li><a name="cmd.ProvidePageStyleByLayers"></a><a href="#cmd.ProvidePageStyleByLayers">\ProvidePageStyleByLayers</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.ProvidePageStyleByLayers">399</a></li>
-<li><a name="cmd.ProvideSectionCommand"></a><a href="#cmd.ProvideSectionCommand">\ProvideSectionCommand</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.ProvideSectionCommand">448</a></li>
-<li><a name="cmd.ProvideSectionCommands"></a><a href="#cmd.ProvideSectionCommands">\ProvideSectionCommands</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.ProvideSectionCommands">457</a></li>
-<li><a name="cmd.RedeclareLayer"></a><a href="#cmd.RedeclareLayer">\RedeclareLayer</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.RedeclareLayer">387</a></li>
-<li><a name="cmd.RedeclareNoteColumn"></a><a href="#cmd.RedeclareNoteColumn">\RedeclareNoteColumn</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.RedeclareNoteColumn">429</a></li>
-<li><a name="cmd.RedeclarePageStyleAlias"></a><a href="#cmd.RedeclarePageStyleAlias">\RedeclarePageStyleAlias</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.RedeclarePageStyleAlias">398</a></li>
-<li><a name="cmd.RedeclarePageStyleByLayers"></a><a href="#cmd.RedeclarePageStyleByLayers">\RedeclarePageStyleByLayers</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.RedeclarePageStyleByLayers">399</a></li>
-<li><a name="cmd.RedeclareSectionCommand"></a><a href="#cmd.RedeclareSectionCommand">\RedeclareSectionCommand</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.RedeclareSectionCommand">448</a></li>
-<li><a name="cmd.RedeclareSectionCommands"></a><a href="#cmd.RedeclareSectionCommands">\RedeclareSectionCommands</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.RedeclareSectionCommands">457</a></li>
-<li><a name="cmd.RelaxFamilyKey"></a><a href="#cmd.RelaxFamilyKey">\RelaxFamilyKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.RelaxFamilyKey">311</a></li>
-<li><a name="cmd.RemoveLayersFromPageStyle"></a><a href="#cmd.RemoveLayersFromPageStyle">\RemoveLayersFromPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.RemoveLayersFromPageStyle">403</a></li>
-<li><a name="cmd.ReplaceClass"></a><a href="#cmd.ReplaceClass">\ReplaceClass</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.ReplaceClass">337</a></li>
-<li><a name="cmd.ReplaceInput"></a><a href="#cmd.ReplaceInput">\ReplaceInput</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.ReplaceInput">337</a></li>
-<li><a name="cmd.ReplacePackage"></a><a href="#cmd.ReplacePackage">\ReplacePackage</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.ReplacePackage">337</a></li>
-<li><a name="cmd.ResetPreventPackageFromLoading"></a><a href="#cmd.ResetPreventPackageFromLoading">\ResetPreventPackageFromLoading</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.ResetPreventPackageFromLoading">340</a></li>
-<li><a name="cmd.SecDef"></a><a href="#cmd.SecDef">\SecDef</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.SecDef">463</a></li>
-<li><a name="cmd.Sentence"></a><a href="#cmd.Sentence">\Sentence</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.Sentence">295</a></li>
-<li><a name="cmd.StorePreventPackageFromLoading"></a><a href="#cmd.StorePreventPackageFromLoading">\StorePreventPackageFromLoading</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.StorePreventPackageFromLoading">340</a></li>
-<li><a name="cmd.SubClause"></a><a href="#cmd.SubClause">\SubClause</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.SubClause">291</a></li>
-<li><a name="cmd.TOCEntryStyleInitCode"></a><a href="#cmd.TOCEntryStyleInitCode">\TOCEntryStyleInitCode</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.TOCEntryStyleInitCode">366</a></li>
-<li><a name="cmd.TOCEntryStyleStartInitCode"></a><a href="#cmd.TOCEntryStyleStartInitCode">\TOCEntryStyleStartInitCode</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.TOCEntryStyleStartInitCode">366</a></li>
-<li><a name="cmd.TOCLineLeaderFill"></a><a href="#cmd.TOCLineLeaderFill">\TOCLineLeaderFill</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.TOCLineLeaderFill">367</a></li>
-<li><a name="cmd.TOCclone"></a><a href="#cmd.TOCclone">\TOCclone</a> --&gt; <a href="scrguien.pdf#desc:scrwfile.cmd.TOCclone">343</a></li>
-<li><a name="cmd.Telephone"></a><a href="#cmd.Telephone">\Telephone</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.Telephone">261</a></li>
-<li><a name="cmd.UnPreventPackageFromLoading*"></a><a href="#cmd.UnPreventPackageFromLoading*">\UnPreventPackageFromLoading*</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.UnPreventPackageFromLoading*">341</a></li>
-<li><a name="cmd.UnPreventPackageFromLoading"></a><a href="#cmd.UnPreventPackageFromLoading">\UnPreventPackageFromLoading</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.UnPreventPackageFromLoading">341</a></li>
-<li><a name="cmd.UnReplaceClass"></a><a href="#cmd.UnReplaceClass">\UnReplaceClass</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.UnReplaceClass">339</a></li>
-<li><a name="cmd.UnReplaceInput"></a><a href="#cmd.UnReplaceInput">\UnReplaceInput</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.UnReplaceInput">339</a></li>
-<li><a name="cmd.UnReplacePackage"></a><a href="#cmd.UnReplacePackage">\UnReplacePackage</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.UnReplacePackage">339</a></li>
-<li><a name="cmd.UnifyLayersAtPageStyle"></a><a href="#cmd.UnifyLayersAtPageStyle">\UnifyLayersAtPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.UnifyLayersAtPageStyle">404</a></li>
-<li><a name="cmd.XdivY"></a><a href="#cmd.XdivY">\XdivY</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.XdivY">330</a></li>
-<li><a name="cmd.XmodY"></a><a href="#cmd.XmodY">\XmodY</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.XmodY">330</a></li>
-<li><a name="cmd.activateareas"></a><a href="#cmd.activateareas">\activateareas</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.activateareas">440</a></li>
-<li><a name="cmd.addchap*"></a><a href="#cmd.addchap*">\addchap*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.addchap*">100</a></li>
-<li><a name="cmd.addchap"></a><a href="#cmd.addchap">\addchap</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.addchap">100</a></li>
-<li><a name="cmd.addchapmark"></a><a href="#cmd.addchapmark">\addchapmark</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.addchapmark">105</a></li>
-<li><a name="cmd.addchaptertocentry"></a><a href="#cmd.addchaptertocentry">\addchaptertocentry</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addchaptertocentry">445</a></li>
-<li><a name="cmd.addcontentslinetoeachtocfile"></a><a href="#cmd.addcontentslinetoeachtocfile">\addcontentslinetoeachtocfile</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.addcontentslinetoeachtocfile">351</a></li>
-<li><a name="cmd.addparagraphtocentry"></a><a href="#cmd.addparagraphtocentry">\addparagraphtocentry</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addparagraphtocentry">445</a></li>
-<li><a name="cmd.addpart*"></a><a href="#cmd.addpart*">\addpart*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.addpart*">100</a></li>
-<li><a name="cmd.addpart"></a><a href="#cmd.addpart">\addpart</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.addpart">100</a></li>
-<li><a name="cmd.addparttocentry"></a><a href="#cmd.addparttocentry">\addparttocentry</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addparttocentry">445</a></li>
-<li><a name="cmd.addrchar"></a><a href="#cmd.addrchar">\addrchar</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.addrchar">224</a>, <a href="scrguien.pdf#desc:scraddr.cmd.addrchar">260</a></li>
-<li><a name="cmd.addrentry"></a><a href="#cmd.addrentry">\addrentry</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.addrentry">222</a>, <a href="scrguien.pdf#desc:scraddr.cmd.addrentry">260</a></li>
-<li><a name="cmd.addsec*"></a><a href="#cmd.addsec*">\addsec*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.addsec*">100</a></li>
-<li><a name="cmd.addsec"></a><a href="#cmd.addsec">\addsec</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.addsec">100</a></li>
-<li><a name="cmd.addsecmark"></a><a href="#cmd.addsecmark">\addsecmark</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.addsecmark">105</a></li>
-<li><a name="cmd.addsectiontocentry"></a><a href="#cmd.addsectiontocentry">\addsectiontocentry</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addsectiontocentry">445</a></li>
-<li><a name="cmd.addsubparagraphtocentry"></a><a href="#cmd.addsubparagraphtocentry">\addsubparagraphtocentry</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addsubparagraphtocentry">445</a></li>
-<li><a name="cmd.addsubsectiontocentry"></a><a href="#cmd.addsubsectiontocentry">\addsubsectiontocentry</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addsubsectiontocentry">445</a></li>
-<li><a name="cmd.addsubsubsectiontocentry"></a><a href="#cmd.addsubsubsectiontocentry">\addsubsubsectiontocentry</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addsubsubsectiontocentry">445</a></li>
-<li><a name="cmd.addtocentrydefault"></a><a href="#cmd.addtocentrydefault">\addtocentrydefault</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addtocentrydefault">444</a></li>
-<li><a name="cmd.addtoeachtocfile"></a><a href="#cmd.addtoeachtocfile">\addtoeachtocfile</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.addtoeachtocfile">350</a></li>
-<li><a name="cmd.addtokomafont"></a><a href="#cmd.addtokomafont">\addtokomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.addtokomafont">165</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.addtokomafont">229</a>, <a href="scrguien.pdf#desc:scrextend.cmd.addtokomafont">270</a>, <a href="scrguien.pdf#desc:scrjura.cmd.addtokomafont">288</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.addtokomafont">427</a>, <a href="scrguien.pdf#desc:maincls.cmd.addtokomafont">57</a></li>
-<li><a name="cmd.addtokomafontgobblelist"></a><a href="#cmd.addtokomafontgobblelist">\addtokomafontgobblelist</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addtokomafontgobblelist">446</a></li>
-<li><a name="cmd.addtokomafontonearglist"></a><a href="#cmd.addtokomafontonearglist">\addtokomafontonearglist</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addtokomafontonearglist">446</a></li>
-<li><a name="cmd.addtokomafontrelaxlist"></a><a href="#cmd.addtokomafontrelaxlist">\addtokomafontrelaxlist</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addtokomafontrelaxlist">446</a></li>
-<li><a name="cmd.addtolengthplength"></a><a href="#cmd.addtolengthplength">\addtolengthplength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.addtolengthplength">148</a></li>
-<li><a name="cmd.addtoreffields"></a><a href="#cmd.addtoreffields">\addtoreffields</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.addtoreffields">483</a></li>
-<li><a name="cmd.addtotoclist"></a><a href="#cmd.addtotoclist">\addtotoclist</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.addtotoclist">347</a></li>
-<li><a name="cmd.addxcontentsline"></a><a href="#cmd.addxcontentsline">\addxcontentsline</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.addxcontentsline">350</a></li>
-<li><a name="cmd.addxcontentslinetoeachtocfile"></a><a href="#cmd.addxcontentslinetoeachtocfile">\addxcontentslinetoeachtocfile</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.addxcontentslinetoeachtocfile">351</a></li>
-<li><a name="cmd.adrchar"></a><a href="#cmd.adrchar">\adrchar</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.adrchar">224</a>, <a href="scrguien.pdf#desc:scraddr.cmd.adrchar">260</a></li>
-<li><a name="cmd.adrentry"></a><a href="#cmd.adrentry">\adrentry</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.adrentry">222</a>, <a href="scrguien.pdf#desc:scraddr.cmd.adrentry">260</a></li>
-<li><a name="cmd.aliaskomafont"></a><a href="#cmd.aliaskomafont">\aliaskomafont</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.aliaskomafont">446</a></li>
-<li><a name="cmd.and"></a><a href="#cmd.and">\and</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.and">273</a>, <a href="scrguien.pdf#desc:maincls.cmd.and">65</a></li>
-<li><a name="cmd.appendix"></a><a href="#cmd.appendix">\appendix</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.appendix">138</a></li>
-<li><a name="cmd.appendixmore"></a><a href="#cmd.appendixmore">\appendixmore</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.appendixmore">464</a></li>
-<li><a name="cmd.areaset"></a><a href="#cmd.areaset">\areaset</a> --&gt; <a href="scrguien.pdf#desc:typearea.cmd.areaset">44</a>, <a href="scrguien.pdf#desc:typearea-experts.cmd.areaset">440</a></li>
-<li><a name="cmd.author"></a><a href="#cmd.author">\author</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.author">273</a>, <a href="scrguien.pdf#desc:maincls.cmd.author">65</a></li>
-<li><a name="cmd.autodot"></a><a href="#cmd.autodot">\autodot</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.autodot">103</a></li>
-<li><a name="cmd.automark*"></a><a href="#cmd.automark*">\automark*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.automark*">242</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.automark*">406</a></li>
-<li><a name="cmd.automark"></a><a href="#cmd.automark">\automark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.automark">242</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.automark">406</a></li>
-<li><a name="cmd.backmatter"></a><a href="#cmd.backmatter">\backmatter</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.backmatter">89</a></li>
-<li><a name="cmd.bankname"></a><a href="#cmd.bankname">\bankname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.bankname">492</a></li>
-<li><a name="cmd.bib@beginhook"></a><a href="#cmd.bib@beginhook">\bib@beginhook</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.bib@beginhook">465</a></li>
-<li><a name="cmd.bib@endhook"></a><a href="#cmd.bib@endhook">\bib@endhook</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.bib@endhook">465</a></li>
-<li><a name="cmd.caption"></a><a href="#cmd.caption">\caption</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.caption">124</a></li>
-<li><a name="cmd.captionabove"></a><a href="#cmd.captionabove">\captionabove</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.captionabove">124</a></li>
-<li><a name="cmd.captionaboveof"></a><a href="#cmd.captionaboveof">\captionaboveof</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.captionaboveof">126</a></li>
-<li><a name="cmd.captionbelow"></a><a href="#cmd.captionbelow">\captionbelow</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.captionbelow">124</a></li>
-<li><a name="cmd.captionbelowof"></a><a href="#cmd.captionbelowof">\captionbelowof</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.captionbelowof">126</a></li>
-<li><a name="cmd.captionformat"></a><a href="#cmd.captionformat">\captionformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.captionformat">131</a></li>
-<li><a name="cmd.captionof"></a><a href="#cmd.captionof">\captionof</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.captionof">126</a></li>
-<li><a name="cmd.captionsUKenglish"></a><a href="#cmd.captionsUKenglish">\captionsUKenglish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsUKenglish">490</a></li>
-<li><a name="cmd.captionsUSenglish"></a><a href="#cmd.captionsUSenglish">\captionsUSenglish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsUSenglish">490</a></li>
-<li><a name="cmd.captionsamerican"></a><a href="#cmd.captionsamerican">\captionsamerican</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsamerican">490</a></li>
-<li><a name="cmd.captionsaustrian"></a><a href="#cmd.captionsaustrian">\captionsaustrian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsaustrian">490</a></li>
-<li><a name="cmd.captionsbritish"></a><a href="#cmd.captionsbritish">\captionsbritish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsbritish">490</a></li>
-<li><a name="cmd.captionscroatian"></a><a href="#cmd.captionscroatian">\captionscroatian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionscroatian">490</a></li>
-<li><a name="cmd.captionsdutch"></a><a href="#cmd.captionsdutch">\captionsdutch</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsdutch">490</a></li>
-<li><a name="cmd.captionsenglish"></a><a href="#cmd.captionsenglish">\captionsenglish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsenglish">490</a></li>
-<li><a name="cmd.captionsfinnish"></a><a href="#cmd.captionsfinnish">\captionsfinnish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsfinnish">490</a></li>
-<li><a name="cmd.captionsfrench"></a><a href="#cmd.captionsfrench">\captionsfrench</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsfrench">490</a></li>
-<li><a name="cmd.captionsgerman"></a><a href="#cmd.captionsgerman">\captionsgerman</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsgerman">490</a></li>
-<li><a name="cmd.captionsitalian"></a><a href="#cmd.captionsitalian">\captionsitalian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsitalian">490</a></li>
-<li><a name="cmd.captionsnaustrian"></a><a href="#cmd.captionsnaustrian">\captionsnaustrian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsnaustrian">490</a></li>
-<li><a name="cmd.captionsngerman"></a><a href="#cmd.captionsngerman">\captionsngerman</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsngerman">490</a></li>
-<li><a name="cmd.captionsnorsk"></a><a href="#cmd.captionsnorsk">\captionsnorsk</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsnorsk">490</a></li>
-<li><a name="cmd.captionsspanish"></a><a href="#cmd.captionsspanish">\captionsspanish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsspanish">490</a></li>
-<li><a name="cmd.captionsswedish"></a><a href="#cmd.captionsswedish">\captionsswedish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsswedish">490</a></li>
-<li><a name="cmd.cc"></a><a href="#cmd.cc">\cc</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cc">160</a></li>
-<li><a name="cmd.ccname"></a><a href="#cmd.ccname">\ccname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.ccname">492</a></li>
-<li><a name="cmd.cefoot*"></a><a href="#cmd.cefoot*">\cefoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cefoot*">238</a></li>
-<li><a name="cmd.cefoot"></a><a href="#cmd.cefoot">\cefoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cefoot">235</a></li>
-<li><a name="cmd.cehead*"></a><a href="#cmd.cehead*">\cehead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cehead*">234</a></li>
-<li><a name="cmd.cehead"></a><a href="#cmd.cehead">\cehead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cehead">232</a></li>
-<li><a name="cmd.cfoot*"></a><a href="#cmd.cfoot*">\cfoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cfoot*">240</a></li>
-<li><a name="cmd.cfoot"></a><a href="#cmd.cfoot">\cfoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cfoot">239</a></li>
-<li><a name="cmd.changefontsizes"></a><a href="#cmd.changefontsizes">\changefontsizes</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.changefontsizes">445</a></li>
-<li><a name="cmd.chapapp"></a><a href="#cmd.chapapp">\chapapp</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chapapp">105</a></li>
-<li><a name="cmd.chapappifchapterprefix"></a><a href="#cmd.chapappifchapterprefix">\chapappifchapterprefix</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chapappifchapterprefix">105</a></li>
-<li><a name="cmd.chapter*"></a><a href="#cmd.chapter*">\chapter*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chapter*">100</a></li>
-<li><a name="cmd.chapter"></a><a href="#cmd.chapter">\chapter</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chapter">95</a></li>
-<li><a name="cmd.chapterformat"></a><a href="#cmd.chapterformat">\chapterformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chapterformat">103</a></li>
-<li><a name="cmd.chapterheadendvskip"></a><a href="#cmd.chapterheadendvskip">\chapterheadendvskip</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.chapterheadendvskip">458</a></li>
-<li><a name="cmd.chapterheadmidvskip"></a><a href="#cmd.chapterheadmidvskip">\chapterheadmidvskip</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.chapterheadmidvskip">458</a></li>
-<li><a name="cmd.chapterheadstartvskip"></a><a href="#cmd.chapterheadstartvskip">\chapterheadstartvskip</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.chapterheadstartvskip">458</a></li>
-<li><a name="cmd.chapterlinesformat"></a><a href="#cmd.chapterlinesformat">\chapterlinesformat</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.chapterlinesformat">459</a></li>
-<li><a name="cmd.chapterlineswithprefixformat"></a><a href="#cmd.chapterlineswithprefixformat">\chapterlineswithprefixformat</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.chapterlineswithprefixformat">459</a></li>
-<li><a name="cmd.chaptermark"></a><a href="#cmd.chaptermark">\chaptermark</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chaptermark">105</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.chaptermark">248</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.chaptermark">409</a></li>
-<li><a name="cmd.chaptermarkformat"></a><a href="#cmd.chaptermarkformat">\chaptermarkformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chaptermarkformat">105</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.chaptermarkformat">247</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.chaptermarkformat">409</a></li>
-<li><a name="cmd.chapternumdepth"></a><a href="#cmd.chapternumdepth">\chapternumdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chapternumdepth">107</a></li>
-<li><a name="cmd.chapterpagestyle"></a><a href="#cmd.chapterpagestyle">\chapterpagestyle</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chapterpagestyle">79</a></li>
-<li><a name="cmd.chead*"></a><a href="#cmd.chead*">\chead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.chead*">240</a></li>
-<li><a name="cmd.chead"></a><a href="#cmd.chead">\chead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.chead">239</a></li>
-<li><a name="cmd.cleardoubleemptypage"></a><a href="#cmd.cleardoubleemptypage">\cleardoubleemptypage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleemptypage">205</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleemptypage">277</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleemptypage">83</a></li>
-<li><a name="cmd.cleardoubleevenemptypage"></a><a href="#cmd.cleardoubleevenemptypage">\cleardoubleevenemptypage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleevenemptypage">205</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleevenemptypage">277</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleevenemptypage">83</a></li>
-<li><a name="cmd.cleardoubleevenpage"></a><a href="#cmd.cleardoubleevenpage">\cleardoubleevenpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleevenpage">205</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleevenpage">277</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleevenpage">83</a></li>
-<li><a name="cmd.cleardoubleevenpageusingstyle"></a><a href="#cmd.cleardoubleevenpageusingstyle">\cleardoubleevenpageusingstyle</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleevenpageusingstyle">205</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleevenpageusingstyle">277</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleevenpageusingstyle">83</a></li>
-<li><a name="cmd.cleardoubleevenplainpage"></a><a href="#cmd.cleardoubleevenplainpage">\cleardoubleevenplainpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleevenplainpage">205</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleevenplainpage">277</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleevenplainpage">83</a></li>
-<li><a name="cmd.cleardoubleevenstandardpage"></a><a href="#cmd.cleardoubleevenstandardpage">\cleardoubleevenstandardpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleevenstandardpage">205</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleevenstandardpage">277</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleevenstandardpage">83</a></li>
-<li><a name="cmd.cleardoubleoddemptypage"></a><a href="#cmd.cleardoubleoddemptypage">\cleardoubleoddemptypage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleoddemptypage">205</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleoddemptypage">277</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleoddemptypage">83</a></li>
-<li><a name="cmd.cleardoubleoddpage"></a><a href="#cmd.cleardoubleoddpage">\cleardoubleoddpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleoddpage">205</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleoddpage">277</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleoddpage">83</a></li>
-<li><a name="cmd.cleardoubleoddpageusingstyle"></a><a href="#cmd.cleardoubleoddpageusingstyle">\cleardoubleoddpageusingstyle</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleoddpageusingstyle">205</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleoddpageusingstyle">277</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleoddpageusingstyle">83</a></li>
-<li><a name="cmd.cleardoubleoddplainpage"></a><a href="#cmd.cleardoubleoddplainpage">\cleardoubleoddplainpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleoddplainpage">205</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleoddplainpage">277</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleoddplainpage">83</a></li>
-<li><a name="cmd.cleardoubleoddstandardpage"></a><a href="#cmd.cleardoubleoddstandardpage">\cleardoubleoddstandardpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleoddstandardpage">205</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleoddstandardpage">277</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleoddstandardpage">83</a></li>
-<li><a name="cmd.cleardoublepage"></a><a href="#cmd.cleardoublepage">\cleardoublepage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoublepage">205</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoublepage">277</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoublepage">83</a></li>
-<li><a name="cmd.cleardoublepageusingstyle"></a><a href="#cmd.cleardoublepageusingstyle">\cleardoublepageusingstyle</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoublepageusingstyle">205</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoublepageusingstyle">277</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoublepageusingstyle">83</a></li>
-<li><a name="cmd.cleardoubleplainpage"></a><a href="#cmd.cleardoubleplainpage">\cleardoubleplainpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleplainpage">205</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleplainpage">277</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleplainpage">83</a></li>
-<li><a name="cmd.cleardoublestandardpage"></a><a href="#cmd.cleardoublestandardpage">\cleardoublestandardpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoublestandardpage">205</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoublestandardpage">277</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoublestandardpage">83</a></li>
-<li><a name="cmd.clearmainofpairofpagestyles"></a><a href="#cmd.clearmainofpairofpagestyles">\clearmainofpairofpagestyles</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.clearmainofpairofpagestyles">419</a></li>
-<li><a name="cmd.clearnotecolumn"></a><a href="#cmd.clearnotecolumn">\clearnotecolumn</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.clearnotecolumn">436</a></li>
-<li><a name="cmd.clearnotecolumns"></a><a href="#cmd.clearnotecolumns">\clearnotecolumns</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.clearnotecolumns">436</a></li>
-<li><a name="cmd.clearpage"></a><a href="#cmd.clearpage">\clearpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.clearpage">205</a>, <a href="scrguien.pdf#desc:scrextend.cmd.clearpage">277</a>, <a href="scrguien.pdf#desc:maincls.cmd.clearpage">83</a></li>
-<li><a name="cmd.clearpairofpagestyles"></a><a href="#cmd.clearpairofpagestyles">\clearpairofpagestyles</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.clearpairofpagestyles">419</a></li>
-<li><a name="cmd.clearplainofpairofpagestyles"></a><a href="#cmd.clearplainofpairofpagestyles">\clearplainofpairofpagestyles</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.clearplainofpairofpagestyles">419</a></li>
-<li><a name="cmd.closing"></a><a href="#cmd.closing">\closing</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.closing">157</a></li>
-<li><a name="cmd.cofoot*"></a><a href="#cmd.cofoot*">\cofoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cofoot*">238</a></li>
-<li><a name="cmd.cofoot"></a><a href="#cmd.cofoot">\cofoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cofoot">235</a></li>
-<li><a name="cmd.cohead*"></a><a href="#cmd.cohead*">\cohead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cohead*">234</a></li>
-<li><a name="cmd.cohead"></a><a href="#cmd.cohead">\cohead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cohead">232</a></li>
-<li><a name="cmd.currentpagestyle"></a><a href="#cmd.currentpagestyle">\currentpagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.currentpagestyle">397</a></li>
-<li><a name="cmd.customername"></a><a href="#cmd.customername">\customername</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.customername">492</a></li>
-<li><a name="cmd.date"></a><a href="#cmd.date">\date</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.date">273</a>, <a href="scrguien.pdf#desc:maincls.cmd.date">65</a></li>
-<li><a name="cmd.dateUKenglish"></a><a href="#cmd.dateUKenglish">\dateUKenglish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateUKenglish">491</a></li>
-<li><a name="cmd.dateUSenglish"></a><a href="#cmd.dateUSenglish">\dateUSenglish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateUSenglish">491</a></li>
-<li><a name="cmd.dateamerican"></a><a href="#cmd.dateamerican">\dateamerican</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateamerican">491</a></li>
-<li><a name="cmd.dateaustrian"></a><a href="#cmd.dateaustrian">\dateaustrian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateaustrian">491</a></li>
-<li><a name="cmd.datebritish"></a><a href="#cmd.datebritish">\datebritish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datebritish">491</a></li>
-<li><a name="cmd.datecroatian"></a><a href="#cmd.datecroatian">\datecroatian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datecroatian">491</a></li>
-<li><a name="cmd.datedutch"></a><a href="#cmd.datedutch">\datedutch</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datedutch">491</a></li>
-<li><a name="cmd.dateenglish"></a><a href="#cmd.dateenglish">\dateenglish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateenglish">491</a></li>
-<li><a name="cmd.datefinnish"></a><a href="#cmd.datefinnish">\datefinnish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datefinnish">491</a></li>
-<li><a name="cmd.datefrench"></a><a href="#cmd.datefrench">\datefrench</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datefrench">491</a></li>
-<li><a name="cmd.dategerman"></a><a href="#cmd.dategerman">\dategerman</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dategerman">491</a></li>
-<li><a name="cmd.dateitalian"></a><a href="#cmd.dateitalian">\dateitalian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateitalian">491</a></li>
-<li><a name="cmd.datename"></a><a href="#cmd.datename">\datename</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datename">492</a></li>
-<li><a name="cmd.datenaustrian"></a><a href="#cmd.datenaustrian">\datenaustrian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datenaustrian">491</a></li>
-<li><a name="cmd.datengerman"></a><a href="#cmd.datengerman">\datengerman</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datengerman">491</a></li>
-<li><a name="cmd.datenorsk"></a><a href="#cmd.datenorsk">\datenorsk</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datenorsk">491</a></li>
-<li><a name="cmd.datespanish"></a><a href="#cmd.datespanish">\datespanish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datespanish">491</a></li>
-<li><a name="cmd.dateswedish"></a><a href="#cmd.dateswedish">\dateswedish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateswedish">491</a></li>
-<li><a name="cmd.dedication"></a><a href="#cmd.dedication">\dedication</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.dedication">275</a>, <a href="scrguien.pdf#desc:maincls.cmd.dedication">67</a></li>
-<li><a name="cmd.defaultreffields"></a><a href="#cmd.defaultreffields">\defaultreffields</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.defaultreffields">483</a></li>
-<li><a name="cmd.defcaptionname*"></a><a href="#cmd.defcaptionname*">\defcaptionname*</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.defcaptionname*">326</a></li>
-<li><a name="cmd.defcaptionname"></a><a href="#cmd.defcaptionname">\defcaptionname</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.defcaptionname">326</a></li>
-<li><a name="cmd.deffootnote"></a><a href="#cmd.deffootnote">\deffootnote</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.deffootnote">208</a>, <a href="scrguien.pdf#desc:scrextend.cmd.deffootnote">281</a>, <a href="scrguien.pdf#desc:maincls.cmd.deffootnote">87</a></li>
-<li><a name="cmd.deffootnotemark"></a><a href="#cmd.deffootnotemark">\deffootnotemark</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.deffootnotemark">208</a>, <a href="scrguien.pdf#desc:scrextend.cmd.deffootnotemark">281</a>, <a href="scrguien.pdf#desc:maincls.cmd.deffootnotemark">87</a></li>
-<li><a name="cmd.defpagestyle"></a><a href="#cmd.defpagestyle">\defpagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.defpagestyle">422</a></li>
-<li><a name="cmd.defpairofpagestyles"></a><a href="#cmd.defpairofpagestyles">\defpairofpagestyles</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.defpairofpagestyles">418</a></li>
-<li><a name="cmd.deftocheading"></a><a href="#cmd.deftocheading">\deftocheading</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.deftocheading">354</a></li>
-<li><a name="cmd.deftriplepagestyle"></a><a href="#cmd.deftriplepagestyle">\deftriplepagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.deftriplepagestyle">420</a></li>
-<li><a name="cmd.dictum"></a><a href="#cmd.dictum">\dictum</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.dictum">110</a>, <a href="scrguien.pdf#desc:scrextend.cmd.dictum">284</a></li>
-<li><a name="cmd.dictumauthorformat"></a><a href="#cmd.dictumauthorformat">\dictumauthorformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.dictumauthorformat">110</a>, <a href="scrguien.pdf#desc:scrextend.cmd.dictumauthorformat">284</a></li>
-<li><a name="cmd.dictumrule"></a><a href="#cmd.dictumrule">\dictumrule</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.dictumrule">110</a>, <a href="scrguien.pdf#desc:scrextend.cmd.dictumrule">284</a></li>
-<li><a name="cmd.dictumwidth"></a><a href="#cmd.dictumwidth">\dictumwidth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.dictumwidth">110</a>, <a href="scrguien.pdf#desc:scrextend.cmd.dictumwidth">284</a></li>
-<li><a name="cmd.documentclass"></a><a href="#cmd.documentclass">\documentclass</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.documentclass">149</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.documentclass">227</a>, <a href="scrguien.pdf#desc:scrextend.cmd.documentclass">266</a>, <a href="scrguien.pdf#desc:scrjura.cmd.documentclass">287</a>, <a href="scrguien.pdf#desc:typearea.cmd.documentclass">29</a>, <a href="scrguien.pdf#desc:scrhack.cmd.documentclass">379</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.documentclass">384</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.documentclass">426</a>, <a href="scrguien.pdf#desc:maincls.cmd.documentclass">52</a></li>
-<li><a name="cmd.doforeachtocfile"></a><a href="#cmd.doforeachtocfile">\doforeachtocfile</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.doforeachtocfile">349</a></li>
-<li><a name="cmd.edgesize"></a><a href="#cmd.edgesize">\edgesize</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.edgesize">487</a></li>
-<li><a name="cmd.ellipsispar"></a><a href="#cmd.ellipsispar">\ellipsispar</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.ellipsispar">294</a></li>
-<li><a name="cmd.emailname"></a><a href="#cmd.emailname">\emailname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.emailname">492</a></li>
-<li><a name="cmd.encl"></a><a href="#cmd.encl">\encl</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.encl">160</a></li>
-<li><a name="cmd.enclname"></a><a href="#cmd.enclname">\enclname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.enclname">492</a></li>
-<li><a name="cmd.extratitle"></a><a href="#cmd.extratitle">\extratitle</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.extratitle">273</a>, <a href="scrguien.pdf#desc:maincls.cmd.extratitle">64</a></li>
-<li><a name="cmd.faxname"></a><a href="#cmd.faxname">\faxname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.faxname">492</a></li>
-<li><a name="cmd.figureformat"></a><a href="#cmd.figureformat">\figureformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.figureformat">132</a></li>
-<li><a name="cmd.flushbottom"></a><a href="#cmd.flushbottom">\flushbottom</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.flushbottom">54</a></li>
-<li><a name="cmd.footnote"></a><a href="#cmd.footnote">\footnote</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.footnote">207</a>, <a href="scrguien.pdf#desc:scrextend.cmd.footnote">280</a>, <a href="scrguien.pdf#desc:maincls.cmd.footnote">85</a></li>
-<li><a name="cmd.footnotemark"></a><a href="#cmd.footnotemark">\footnotemark</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.footnotemark">207</a>, <a href="scrguien.pdf#desc:scrextend.cmd.footnotemark">280</a>, <a href="scrguien.pdf#desc:maincls.cmd.footnotemark">85</a></li>
-<li><a name="cmd.footnotetext"></a><a href="#cmd.footnotetext">\footnotetext</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.footnotetext">207</a>, <a href="scrguien.pdf#desc:scrextend.cmd.footnotetext">280</a>, <a href="scrguien.pdf#desc:maincls.cmd.footnotetext">85</a></li>
-<li><a name="cmd.footref"></a><a href="#cmd.footref">\footref</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.footref">207</a>, <a href="scrguien.pdf#desc:scrextend.cmd.footref">281</a>, <a href="scrguien.pdf#desc:maincls.cmd.footref">86</a></li>
-<li><a name="cmd.frontmatter"></a><a href="#cmd.frontmatter">\frontmatter</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.frontmatter">89</a></li>
-<li><a name="cmd.headfromname"></a><a href="#cmd.headfromname">\headfromname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.headfromname">492</a></li>
-<li><a name="cmd.headmark"></a><a href="#cmd.headmark">\headmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.headmark">245</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.headmark">408</a></li>
-<li><a name="cmd.headtoname"></a><a href="#cmd.headtoname">\headtoname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.headtoname">492</a></li>
-<li><a name="cmd.if@atdocument"></a><a href="#cmd.if@atdocument">\if@atdocument</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.if@atdocument">325</a></li>
-<li><a name="cmd.if@chapter"></a><a href="#cmd.if@chapter">\if@chapter</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.if@chapter">385</a></li>
-<li><a name="cmd.if@mainmatter"></a><a href="#cmd.if@mainmatter">\if@mainmatter</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.if@mainmatter">385</a></li>
-<li><a name="cmd.ifVTeX"></a><a href="#cmd.ifVTeX">\ifVTeX</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifVTeX">322</a></li>
-<li><a name="cmd.ifattoclist"></a><a href="#cmd.ifattoclist">\ifattoclist</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.ifattoclist">346</a></li>
-<li><a name="cmd.ifdimen"></a><a href="#cmd.ifdimen">\ifdimen</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifdimen">325</a></li>
-<li><a name="cmd.ifdvioutput"></a><a href="#cmd.ifdvioutput">\ifdvioutput</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifdvioutput">323</a></li>
-<li><a name="cmd.ifiscount"></a><a href="#cmd.ifiscount">\ifiscount</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifiscount">324</a></li>
-<li><a name="cmd.ifiscounter"></a><a href="#cmd.ifiscounter">\ifiscounter</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifiscounter">325</a></li>
-<li><a name="cmd.ifisdimen"></a><a href="#cmd.ifisdimen">\ifisdimen</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifisdimen">323</a></li>
-<li><a name="cmd.ifisdimension"></a><a href="#cmd.ifisdimension">\ifisdimension</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifisdimension">323</a></li>
-<li><a name="cmd.ifisdimexpr"></a><a href="#cmd.ifisdimexpr">\ifisdimexpr</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifisdimexpr">324</a></li>
-<li><a name="cmd.ifisglue"></a><a href="#cmd.ifisglue">\ifisglue</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifisglue">324</a></li>
-<li><a name="cmd.ifisglueexpr"></a><a href="#cmd.ifisglueexpr">\ifisglueexpr</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifisglueexpr">324</a></li>
-<li><a name="cmd.ifisinteger"></a><a href="#cmd.ifisinteger">\ifisinteger</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifisinteger">324</a></li>
-<li><a name="cmd.ifisnumexpr"></a><a href="#cmd.ifisnumexpr">\ifisnumexpr</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifisnumexpr">325</a></li>
-<li><a name="cmd.ifisskip"></a><a href="#cmd.ifisskip">\ifisskip</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifisskip">324</a></li>
-<li><a name="cmd.ifkomavar"></a><a href="#cmd.ifkomavar">\ifkomavar</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.ifkomavar">147</a></li>
-<li><a name="cmd.ifkomavarempty*"></a><a href="#cmd.ifkomavarempty*">\ifkomavarempty*</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.ifkomavarempty*">148</a>, <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.ifkomavarempty*">484</a></li>
-<li><a name="cmd.ifkomavarempty"></a><a href="#cmd.ifkomavarempty">\ifkomavarempty</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.ifkomavarempty">148</a>, <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.ifkomavarempty">484</a></li>
-<li><a name="cmd.ifnotundefined"></a><a href="#cmd.ifnotundefined">\ifnotundefined</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifnotundefined">323</a></li>
-<li><a name="cmd.ifnumber"></a><a href="#cmd.ifnumber">\ifnumber</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifnumber">325</a></li>
-<li><a name="cmd.ifnumbered"></a><a href="#cmd.ifnumbered">\ifnumbered</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.ifnumbered">107</a></li>
-<li><a name="cmd.ifoot*"></a><a href="#cmd.ifoot*">\ifoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.ifoot*">240</a></li>
-<li><a name="cmd.ifoot"></a><a href="#cmd.ifoot">\ifoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.ifoot">239</a></li>
-<li><a name="cmd.ifpdfoutput"></a><a href="#cmd.ifpdfoutput">\ifpdfoutput</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifpdfoutput">322</a></li>
-<li><a name="cmd.ifpdftex"></a><a href="#cmd.ifpdftex">\ifpdftex</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifpdftex">322</a></li>
-<li><a name="cmd.ifpsoutput"></a><a href="#cmd.ifpsoutput">\ifpsoutput</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifpsoutput">322</a></li>
-<li><a name="cmd.ifstr"></a><a href="#cmd.ifstr">\ifstr</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifstr">323</a></li>
-<li><a name="cmd.ifstrstart"></a><a href="#cmd.ifstrstart">\ifstrstart</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifstrstart">323</a></li>
-<li><a name="cmd.ifthispageodd"></a><a href="#cmd.ifthispageodd">\ifthispageodd</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.ifthispageodd">199</a>, <a href="scrguien.pdf#desc:scrextend.cmd.ifthispageodd">275</a>, <a href="scrguien.pdf#desc:maincls.cmd.ifthispageodd">76</a></li>
-<li><a name="cmd.iftocfeature"></a><a href="#cmd.iftocfeature">\iftocfeature</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.iftocfeature">356</a></li>
-<li><a name="cmd.ifundefinedorrelax"></a><a href="#cmd.ifundefinedorrelax">\ifundefinedorrelax</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifundefinedorrelax">322</a></li>
-<li><a name="cmd.ifunnumbered"></a><a href="#cmd.ifunnumbered">\ifunnumbered</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.ifunnumbered">107</a></li>
-<li><a name="cmd.ihead*"></a><a href="#cmd.ihead*">\ihead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.ihead*">240</a></li>
-<li><a name="cmd.ihead"></a><a href="#cmd.ihead">\ihead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.ihead">239</a></li>
-<li><a name="cmd.indexpagestyle"></a><a href="#cmd.indexpagestyle">\indexpagestyle</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.indexpagestyle">79</a></li>
-<li><a name="cmd.invoicename"></a><a href="#cmd.invoicename">\invoicename</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.invoicename">492</a></li>
-<li><a name="cmd.labelenumi"></a><a href="#cmd.labelenumi">\labelenumi</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.labelenumi">113</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.labelenumi">210</a></li>
-<li><a name="cmd.labelenumii"></a><a href="#cmd.labelenumii">\labelenumii</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.labelenumii">113</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.labelenumii">210</a></li>
-<li><a name="cmd.labelenumiii"></a><a href="#cmd.labelenumiii">\labelenumiii</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.labelenumiii">113</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.labelenumiii">210</a></li>
-<li><a name="cmd.labelenumiv"></a><a href="#cmd.labelenumiv">\labelenumiv</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.labelenumiv">113</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.labelenumiv">210</a></li>
-<li><a name="cmd.labelitemi"></a><a href="#cmd.labelitemi">\labelitemi</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.labelitemi">112</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.labelitemi">210</a></li>
-<li><a name="cmd.labelitemii"></a><a href="#cmd.labelitemii">\labelitemii</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.labelitemii">112</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.labelitemii">210</a></li>
-<li><a name="cmd.labelitemiii"></a><a href="#cmd.labelitemiii">\labelitemiii</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.labelitemiii">112</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.labelitemiii">210</a></li>
-<li><a name="cmd.labelitemiv"></a><a href="#cmd.labelitemiv">\labelitemiv</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.labelitemiv">112</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.labelitemiv">210</a></li>
-<li><a name="cmd.layercontentsmeasure"></a><a href="#cmd.layercontentsmeasure">\layercontentsmeasure</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.layercontentsmeasure">397</a></li>
-<li><a name="cmd.layerhalign"></a><a href="#cmd.layerhalign">\layerhalign</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.layerhalign">394</a></li>
-<li><a name="cmd.layerheight"></a><a href="#cmd.layerheight">\layerheight</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.layerheight">394</a></li>
-<li><a name="cmd.layervalign"></a><a href="#cmd.layervalign">\layervalign</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.layervalign">394</a></li>
-<li><a name="cmd.layerwidth"></a><a href="#cmd.layerwidth">\layerwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.layerwidth">394</a></li>
-<li><a name="cmd.layerxoffset"></a><a href="#cmd.layerxoffset">\layerxoffset</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.layerxoffset">394</a></li>
-<li><a name="cmd.layeryoffset"></a><a href="#cmd.layeryoffset">\layeryoffset</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.layeryoffset">394</a></li>
-<li><a name="cmd.lefoot*"></a><a href="#cmd.lefoot*">\lefoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.lefoot*">238</a></li>
-<li><a name="cmd.lefoot"></a><a href="#cmd.lefoot">\lefoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.lefoot">235</a></li>
-<li><a name="cmd.leftbotmark"></a><a href="#cmd.leftbotmark">\leftbotmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.leftbotmark">410</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.leftbotmark">416</a></li>
-<li><a name="cmd.leftfirstmark"></a><a href="#cmd.leftfirstmark">\leftfirstmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.leftfirstmark">410</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.leftfirstmark">416</a></li>
-<li><a name="cmd.leftmark"></a><a href="#cmd.leftmark">\leftmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.leftmark">245</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.leftmark">408</a></li>
-<li><a name="cmd.lefttopmark"></a><a href="#cmd.lefttopmark">\lefttopmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.lefttopmark">410</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.lefttopmark">416</a></li>
-<li><a name="cmd.lehead*"></a><a href="#cmd.lehead*">\lehead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.lehead*">234</a></li>
-<li><a name="cmd.lehead"></a><a href="#cmd.lehead">\lehead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.lehead">232</a></li>
-<li><a name="cmd.letterlastpage"></a><a href="#cmd.letterlastpage">\letterlastpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.letterlastpage">155</a></li>
-<li><a name="cmd.letterpagemark"></a><a href="#cmd.letterpagemark">\letterpagemark</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.letterpagemark">485</a></li>
-<li><a name="cmd.letterpagestyle"></a><a href="#cmd.letterpagestyle">\letterpagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.letterpagestyle">200</a></li>
-<li><a name="cmd.listof/extension/name"></a><a href="#cmd.listof/extension/name">\listof/extension/name</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.listof/extension/name">351</a></li>
-<li><a name="cmd.listofeachtoc"></a><a href="#cmd.listofeachtoc">\listofeachtoc</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.listofeachtoc">351</a></li>
-<li><a name="cmd.listoffigures"></a><a href="#cmd.listoffigures">\listoffigures</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.listoffigures">137</a></li>
-<li><a name="cmd.listoftables"></a><a href="#cmd.listoftables">\listoftables</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.listoftables">137</a></li>
-<li><a name="cmd.listoftoc*"></a><a href="#cmd.listoftoc*">\listoftoc*</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.listoftoc*">351</a></li>
-<li><a name="cmd.listoftoc"></a><a href="#cmd.listoftoc">\listoftoc</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.listoftoc">351</a></li>
-<li><a name="cmd.lofoot*"></a><a href="#cmd.lofoot*">\lofoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.lofoot*">238</a></li>
-<li><a name="cmd.lofoot"></a><a href="#cmd.lofoot">\lofoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.lofoot">235</a></li>
-<li><a name="cmd.lohead*"></a><a href="#cmd.lohead*">\lohead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.lohead*">234</a></li>
-<li><a name="cmd.lohead"></a><a href="#cmd.lohead">\lohead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.lohead">232</a></li>
-<li><a name="cmd.lowertitleback"></a><a href="#cmd.lowertitleback">\lowertitleback</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.lowertitleback">275</a>, <a href="scrguien.pdf#desc:maincls.cmd.lowertitleback">67</a></li>
-<li><a name="cmd.mainmatter"></a><a href="#cmd.mainmatter">\mainmatter</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.mainmatter">89</a></li>
-<li><a name="cmd.makenote*"></a><a href="#cmd.makenote*">\makenote*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.makenote*">433</a></li>
-<li><a name="cmd.makenote"></a><a href="#cmd.makenote">\makenote</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.makenote">433</a></li>
-<li><a name="cmd.maketitle"></a><a href="#cmd.maketitle">\maketitle</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.maketitle">272</a>, <a href="scrguien.pdf#desc:maincls.cmd.maketitle">63</a></li>
-<li><a name="cmd.manualmark"></a><a href="#cmd.manualmark">\manualmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.manualmark">242</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.manualmark">406</a></li>
-<li><a name="cmd.marginline"></a><a href="#cmd.marginline">\marginline</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.marginline">138</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.marginline">213</a>, <a href="scrguien.pdf#desc:scrextend.cmd.marginline">286</a></li>
-<li><a name="cmd.marginpar"></a><a href="#cmd.marginpar">\marginpar</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.marginpar">138</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.marginpar">213</a>, <a href="scrguien.pdf#desc:scrextend.cmd.marginpar">286</a></li>
-<li><a name="cmd.markboth"></a><a href="#cmd.markboth">\markboth</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.markboth">203</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.markboth">248</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.markboth">409</a>, <a href="scrguien.pdf#desc:maincls.cmd.markboth">79</a></li>
-<li><a name="cmd.markleft"></a><a href="#cmd.markleft">\markleft</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.markleft">248</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.markleft">409</a></li>
-<li><a name="cmd.markright"></a><a href="#cmd.markright">\markright</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.markright">203</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.markright">248</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.markright">409</a>, <a href="scrguien.pdf#desc:maincls.cmd.markright">79</a></li>
-<li><a name="cmd.minisec"></a><a href="#cmd.minisec">\minisec</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.minisec">101</a></li>
-<li><a name="cmd.mobilephonename"></a><a href="#cmd.mobilephonename">\mobilephonename</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.mobilephonename">492</a></li>
-<li><a name="cmd.multfootsep"></a><a href="#cmd.multfootsep">\multfootsep</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.multfootsep">207</a>, <a href="scrguien.pdf#desc:scrextend.cmd.multfootsep">280</a>, <a href="scrguien.pdf#desc:maincls.cmd.multfootsep">85</a></li>
-<li><a name="cmd.multiplefootnoteseparator"></a><a href="#cmd.multiplefootnoteseparator">\multiplefootnoteseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.multiplefootnoteseparator">207</a>, <a href="scrguien.pdf#desc:scrextend.cmd.multiplefootnoteseparator">280</a>, <a href="scrguien.pdf#desc:maincls.cmd.multiplefootnoteseparator">85</a></li>
-<li><a name="cmd.myrefname"></a><a href="#cmd.myrefname">\myrefname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.myrefname">492</a></li>
-<li><a name="cmd.nameday"></a><a href="#cmd.nameday">\nameday</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.nameday">256</a></li>
-<li><a name="cmd.newbibstyle"></a><a href="#cmd.newbibstyle">\newbibstyle</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.newbibstyle">465</a></li>
-<li><a name="cmd.newblock"></a><a href="#cmd.newblock">\newblock</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.newblock">465</a></li>
-<li><a name="cmd.newcaptionname*"></a><a href="#cmd.newcaptionname*">\newcaptionname*</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.newcaptionname*">326</a></li>
-<li><a name="cmd.newcaptionname"></a><a href="#cmd.newcaptionname">\newcaptionname</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.newcaptionname">326</a></li>
-<li><a name="cmd.newdaylanguage"></a><a href="#cmd.newdaylanguage">\newdaylanguage</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.newdaylanguage">256</a></li>
-<li><a name="cmd.newkomafont"></a><a href="#cmd.newkomafont">\newkomafont</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.newkomafont">446</a></li>
-<li><a name="cmd.newkomavar*"></a><a href="#cmd.newkomavar*">\newkomavar*</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.newkomavar*">483</a></li>
-<li><a name="cmd.newkomavar"></a><a href="#cmd.newkomavar">\newkomavar</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.newkomavar">483</a></li>
-<li><a name="cmd.newpagestyle"></a><a href="#cmd.newpagestyle">\newpagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.newpagestyle">422</a></li>
-<li><a name="cmd.newpairofpagestyles"></a><a href="#cmd.newpairofpagestyles">\newpairofpagestyles</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.newpairofpagestyles">418</a></li>
-<li><a name="cmd.newtriplepagestyle"></a><a href="#cmd.newtriplepagestyle">\newtriplepagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.newtriplepagestyle">420</a></li>
-<li><a name="cmd.nonumberline"></a><a href="#cmd.nonumberline">\nonumberline</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.nonumberline">370</a></li>
-<li><a name="cmd.numberline"></a><a href="#cmd.numberline">\numberline</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.numberline">357</a></li>
-<li><a name="cmd.ofoot*"></a><a href="#cmd.ofoot*">\ofoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.ofoot*">240</a></li>
-<li><a name="cmd.ofoot"></a><a href="#cmd.ofoot">\ofoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.ofoot">239</a></li>
-<li><a name="cmd.ohead*"></a><a href="#cmd.ohead*">\ohead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.ohead*">240</a></li>
-<li><a name="cmd.ohead"></a><a href="#cmd.ohead">\ohead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.ohead">239</a></li>
-<li><a name="cmd.opening"></a><a href="#cmd.opening">\opening</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.opening">156</a></li>
-<li><a name="cmd.othersectionlevelsformat"></a><a href="#cmd.othersectionlevelsformat">\othersectionlevelsformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.othersectionlevelsformat">103</a></li>
-<li><a name="cmd.pagemark"></a><a href="#cmd.pagemark">\pagemark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.pagemark">245</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.pagemark">408</a>, <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.pagemark">485</a></li>
-<li><a name="cmd.pagename"></a><a href="#cmd.pagename">\pagename</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.pagename">492</a></li>
-<li><a name="cmd.pagenumbering"></a><a href="#cmd.pagenumbering">\pagenumbering</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.pagenumbering">81</a></li>
-<li><a name="cmd.pagestyle"></a><a href="#cmd.pagestyle">\pagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.pagestyle">201</a>, <a href="scrguien.pdf#desc:maincls.cmd.pagestyle">77</a></li>
-<li><a name="cmd.paragraph*"></a><a href="#cmd.paragraph*">\paragraph*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.paragraph*">100</a></li>
-<li><a name="cmd.paragraph"></a><a href="#cmd.paragraph">\paragraph</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.paragraph">95</a></li>
-<li><a name="cmd.paragraphformat"></a><a href="#cmd.paragraphformat">\paragraphformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.paragraphformat">103</a></li>
-<li><a name="cmd.paragraphmark"></a><a href="#cmd.paragraphmark">\paragraphmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.paragraphmark">248</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.paragraphmark">409</a></li>
-<li><a name="cmd.paragraphmarkformat"></a><a href="#cmd.paragraphmarkformat">\paragraphmarkformat</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.paragraphmarkformat">247</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.paragraphmarkformat">409</a></li>
-<li><a name="cmd.paragraphnumdepth"></a><a href="#cmd.paragraphnumdepth">\paragraphnumdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.paragraphnumdepth">107</a></li>
-<li><a name="cmd.parellipsis"></a><a href="#cmd.parellipsis">\parellipsis</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.parellipsis">294</a></li>
-<li><a name="cmd.parformat"></a><a href="#cmd.parformat">\parformat</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.parformat">294</a></li>
-<li><a name="cmd.parformatseparation"></a><a href="#cmd.parformatseparation">\parformatseparation</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.parformatseparation">294</a></li>
-<li><a name="cmd.parname"></a><a href="#cmd.parname">\parname</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.parname">300</a></li>
-<li><a name="cmd.parshortname"></a><a href="#cmd.parshortname">\parshortname</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.parshortname">300</a></li>
-<li><a name="cmd.part*"></a><a href="#cmd.part*">\part*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.part*">100</a></li>
-<li><a name="cmd.part"></a><a href="#cmd.part">\part</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.part">95</a></li>
-<li><a name="cmd.partformat"></a><a href="#cmd.partformat">\partformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.partformat">103</a></li>
-<li><a name="cmd.partheademptypage"></a><a href="#cmd.partheademptypage">\partheademptypage</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.partheademptypage">458</a></li>
-<li><a name="cmd.partheadendvskip"></a><a href="#cmd.partheadendvskip">\partheadendvskip</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.partheadendvskip">458</a></li>
-<li><a name="cmd.partheadmidvskip"></a><a href="#cmd.partheadmidvskip">\partheadmidvskip</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.partheadmidvskip">458</a></li>
-<li><a name="cmd.partheadstartvskip"></a><a href="#cmd.partheadstartvskip">\partheadstartvskip</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.partheadstartvskip">458</a></li>
-<li><a name="cmd.partmark"></a><a href="#cmd.partmark">\partmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.partmark">248</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.partmark">409</a></li>
-<li><a name="cmd.partmarkformat"></a><a href="#cmd.partmarkformat">\partmarkformat</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.partmarkformat">247</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.partmarkformat">409</a></li>
-<li><a name="cmd.partnumdepth"></a><a href="#cmd.partnumdepth">\partnumdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.partnumdepth">107</a></li>
-<li><a name="cmd.partpagestyle"></a><a href="#cmd.partpagestyle">\partpagestyle</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.partpagestyle">79</a></li>
-<li><a name="cmd.phonename"></a><a href="#cmd.phonename">\phonename</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.phonename">492</a></li>
-<li><a name="cmd.providecaptionname*"></a><a href="#cmd.providecaptionname*">\providecaptionname*</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.providecaptionname*">326</a></li>
-<li><a name="cmd.providecaptionname"></a><a href="#cmd.providecaptionname">\providecaptionname</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.providecaptionname">326</a></li>
-<li><a name="cmd.providepagestyle"></a><a href="#cmd.providepagestyle">\providepagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.providepagestyle">422</a></li>
-<li><a name="cmd.providepairofpagestyles"></a><a href="#cmd.providepairofpagestyles">\providepairofpagestyles</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.providepairofpagestyles">418</a></li>
-<li><a name="cmd.providetriplepagestyle"></a><a href="#cmd.providetriplepagestyle">\providetriplepagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.providetriplepagestyle">420</a></li>
-<li><a name="cmd.ps"></a><a href="#cmd.ps">\ps</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.ps">158</a></li>
-<li><a name="cmd.publishers"></a><a href="#cmd.publishers">\publishers</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.publishers">273</a>, <a href="scrguien.pdf#desc:maincls.cmd.publishers">65</a></li>
-<li><a name="cmd.putC"></a><a href="#cmd.putC">\putC</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.putC">395</a></li>
-<li><a name="cmd.putLL"></a><a href="#cmd.putLL">\putLL</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.putLL">395</a></li>
-<li><a name="cmd.putLR"></a><a href="#cmd.putLR">\putLR</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.putLR">395</a></li>
-<li><a name="cmd.putUL"></a><a href="#cmd.putUL">\putUL</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.putUL">395</a></li>
-<li><a name="cmd.putUR"></a><a href="#cmd.putUR">\putUR</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.putUR">395</a></li>
-<li><a name="cmd.raggedbottom"></a><a href="#cmd.raggedbottom">\raggedbottom</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.raggedbottom">54</a></li>
-<li><a name="cmd.raggedchapter"></a><a href="#cmd.raggedchapter">\raggedchapter</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.raggedchapter">102</a></li>
-<li><a name="cmd.raggedchapterentry"></a><a href="#cmd.raggedchapterentry">\raggedchapterentry</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.raggedchapterentry">445</a></li>
-<li><a name="cmd.raggeddictum"></a><a href="#cmd.raggeddictum">\raggeddictum</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.raggeddictum">110</a>, <a href="scrguien.pdf#desc:scrextend.cmd.raggeddictum">284</a></li>
-<li><a name="cmd.raggeddictumauthor"></a><a href="#cmd.raggeddictumauthor">\raggeddictumauthor</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.raggeddictumauthor">110</a>, <a href="scrguien.pdf#desc:scrextend.cmd.raggeddictumauthor">284</a></li>
-<li><a name="cmd.raggeddictumtext"></a><a href="#cmd.raggeddictumtext">\raggeddictumtext</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.raggeddictumtext">110</a>, <a href="scrguien.pdf#desc:scrextend.cmd.raggeddictumtext">284</a></li>
-<li><a name="cmd.raggedfootnote"></a><a href="#cmd.raggedfootnote">\raggedfootnote</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.raggedfootnote">209</a>, <a href="scrguien.pdf#desc:scrextend.cmd.raggedfootnote">283</a>, <a href="scrguien.pdf#desc:maincls.cmd.raggedfootnote">89</a></li>
-<li><a name="cmd.raggedpart"></a><a href="#cmd.raggedpart">\raggedpart</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.raggedpart">102</a></li>
-<li><a name="cmd.raggedsection"></a><a href="#cmd.raggedsection">\raggedsection</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.raggedsection">102</a></li>
-<li><a name="cmd.raggedsignature"></a><a href="#cmd.raggedsignature">\raggedsignature</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.raggedsignature">214</a></li>
-<li><a name="cmd.recalctypearea"></a><a href="#cmd.recalctypearea">\recalctypearea</a> --&gt; <a href="scrguien.pdf#desc:typearea.cmd.recalctypearea">38</a></li>
-<li><a name="cmd.ref"></a><a href="#cmd.ref">\ref</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.ref">296</a></li>
-<li><a name="cmd.refClause"></a><a href="#cmd.refClause">\refClause</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refClause">296</a></li>
-<li><a name="cmd.refClauseN"></a><a href="#cmd.refClauseN">\refClauseN</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refClauseN">296</a></li>
-<li><a name="cmd.refL"></a><a href="#cmd.refL">\refL</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refL">296</a></li>
-<li><a name="cmd.refN"></a><a href="#cmd.refN">\refN</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refN">296</a></li>
-<li><a name="cmd.refPar"></a><a href="#cmd.refPar">\refPar</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refPar">296</a></li>
-<li><a name="cmd.refParL"></a><a href="#cmd.refParL">\refParL</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refParL">296</a></li>
-<li><a name="cmd.refParN"></a><a href="#cmd.refParN">\refParN</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refParN">296</a></li>
-<li><a name="cmd.refParS"></a><a href="#cmd.refParS">\refParS</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refParS">296</a></li>
-<li><a name="cmd.refS"></a><a href="#cmd.refS">\refS</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refS">296</a></li>
-<li><a name="cmd.refSentence"></a><a href="#cmd.refSentence">\refSentence</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refSentence">296</a></li>
-<li><a name="cmd.refSentenceL"></a><a href="#cmd.refSentenceL">\refSentenceL</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refSentenceL">296</a></li>
-<li><a name="cmd.refSentenceN"></a><a href="#cmd.refSentenceN">\refSentenceN</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refSentenceN">296</a></li>
-<li><a name="cmd.refSentenceS"></a><a href="#cmd.refSentenceS">\refSentenceS</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refSentenceS">296</a></li>
-<li><a name="cmd.refoot*"></a><a href="#cmd.refoot*">\refoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.refoot*">238</a></li>
-<li><a name="cmd.refoot"></a><a href="#cmd.refoot">\refoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.refoot">235</a></li>
-<li><a name="cmd.rehead*"></a><a href="#cmd.rehead*">\rehead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.rehead*">234</a></li>
-<li><a name="cmd.rehead"></a><a href="#cmd.rehead">\rehead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.rehead">232</a></li>
-<li><a name="cmd.removefromtoclist"></a><a href="#cmd.removefromtoclist">\removefromtoclist</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.removefromtoclist">349</a></li>
-<li><a name="cmd.removereffields"></a><a href="#cmd.removereffields">\removereffields</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.removereffields">483</a></li>
-<li><a name="cmd.renewcaptionname*"></a><a href="#cmd.renewcaptionname*">\renewcaptionname*</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.renewcaptionname*">326</a></li>
-<li><a name="cmd.renewcaptionname"></a><a href="#cmd.renewcaptionname">\renewcaptionname</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.renewcaptionname">326</a></li>
-<li><a name="cmd.renewpagestyle"></a><a href="#cmd.renewpagestyle">\renewpagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.renewpagestyle">422</a></li>
-<li><a name="cmd.renewpairofpagestyles"></a><a href="#cmd.renewpairofpagestyles">\renewpairofpagestyles</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.renewpairofpagestyles">418</a></li>
-<li><a name="cmd.renewtriplepagestyle"></a><a href="#cmd.renewtriplepagestyle">\renewtriplepagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.renewtriplepagestyle">420</a></li>
-<li><a name="cmd.rightbotmark"></a><a href="#cmd.rightbotmark">\rightbotmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.rightbotmark">410</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.rightbotmark">416</a></li>
-<li><a name="cmd.rightfirstmark"></a><a href="#cmd.rightfirstmark">\rightfirstmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.rightfirstmark">410</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.rightfirstmark">416</a></li>
-<li><a name="cmd.rightmark"></a><a href="#cmd.rightmark">\rightmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.rightmark">245</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.rightmark">408</a></li>
-<li><a name="cmd.righttopmark"></a><a href="#cmd.righttopmark">\righttopmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.righttopmark">410</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.righttopmark">416</a></li>
-<li><a name="cmd.rofoot*"></a><a href="#cmd.rofoot*">\rofoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.rofoot*">238</a></li>
-<li><a name="cmd.rofoot"></a><a href="#cmd.rofoot">\rofoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.rofoot">235</a></li>
-<li><a name="cmd.rohead*"></a><a href="#cmd.rohead*">\rohead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.rohead*">234</a></li>
-<li><a name="cmd.rohead"></a><a href="#cmd.rohead">\rohead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.rohead">232</a></li>
-<li><a name="cmd.scr@ifVTeX"></a><a href="#cmd.scr@ifVTeX">\scr@ifVTeX</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.scr@ifVTeX">322</a></li>
-<li><a name="cmd.scr@ifdvioutput"></a><a href="#cmd.scr@ifdvioutput">\scr@ifdvioutput</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.scr@ifdvioutput">323</a></li>
-<li><a name="cmd.scr@ifpdfoutput"></a><a href="#cmd.scr@ifpdfoutput">\scr@ifpdfoutput</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.scr@ifpdfoutput">322</a></li>
-<li><a name="cmd.scr@ifpdftex"></a><a href="#cmd.scr@ifpdftex">\scr@ifpdftex</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.scr@ifpdftex">322</a></li>
-<li><a name="cmd.scr@ifpsoutput"></a><a href="#cmd.scr@ifpsoutput">\scr@ifpsoutput</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.scr@ifpsoutput">322</a></li>
-<li><a name="cmd.scr@ifundefinedorrelax"></a><a href="#cmd.scr@ifundefinedorrelax">\scr@ifundefinedorrelax</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.scr@ifundefinedorrelax">322</a></li>
-<li><a name="cmd.scr@startsection"></a><a href="#cmd.scr@startsection">\scr@startsection</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.scr@startsection">463</a></li>
-<li><a name="cmd.scrlayerAddCsToInterface"></a><a href="#cmd.scrlayerAddCsToInterface">\scrlayerAddCsToInterface</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.scrlayerAddCsToInterface">413</a></li>
-<li><a name="cmd.scrlayerAddToInterface"></a><a href="#cmd.scrlayerAddToInterface">\scrlayerAddToInterface</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.scrlayerAddToInterface">413</a></li>
-<li><a name="cmd.scrlayerInitInterface"></a><a href="#cmd.scrlayerInitInterface">\scrlayerInitInterface</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.scrlayerInitInterface">412</a></li>
-<li><a name="cmd.scrlayerOnAutoRemoveInterface"></a><a href="#cmd.scrlayerOnAutoRemoveInterface">\scrlayerOnAutoRemoveInterface</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.scrlayerOnAutoRemoveInterface">413</a></li>
-<li><a name="cmd.section*"></a><a href="#cmd.section*">\section*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.section*">100</a></li>
-<li><a name="cmd.section"></a><a href="#cmd.section">\section</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.section">95</a></li>
-<li><a name="cmd.sectioncatchphraseformat"></a><a href="#cmd.sectioncatchphraseformat">\sectioncatchphraseformat</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.sectioncatchphraseformat">461</a></li>
-<li><a name="cmd.sectionformat"></a><a href="#cmd.sectionformat">\sectionformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.sectionformat">103</a></li>
-<li><a name="cmd.sectionlinesformat"></a><a href="#cmd.sectionlinesformat">\sectionlinesformat</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.sectionlinesformat">461</a></li>
-<li><a name="cmd.sectionmark"></a><a href="#cmd.sectionmark">\sectionmark</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.sectionmark">105</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.sectionmark">248</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.sectionmark">409</a></li>
-<li><a name="cmd.sectionmarkformat"></a><a href="#cmd.sectionmarkformat">\sectionmarkformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.sectionmarkformat">105</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.sectionmarkformat">247</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.sectionmarkformat">409</a></li>
-<li><a name="cmd.sectionnumdepth"></a><a href="#cmd.sectionnumdepth">\sectionnumdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.sectionnumdepth">107</a></li>
-<li><a name="cmd.sentencename"></a><a href="#cmd.sentencename">\sentencename</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.sentencename">300</a></li>
-<li><a name="cmd.sentenceshortname"></a><a href="#cmd.sentenceshortname">\sentenceshortname</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.sentenceshortname">300</a></li>
-<li><a name="cmd.setbibpreamble"></a><a href="#cmd.setbibpreamble">\setbibpreamble</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setbibpreamble">140</a></li>
-<li><a name="cmd.setcapdynwidth"></a><a href="#cmd.setcapdynwidth">\setcapdynwidth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setcapdynwidth">133</a></li>
-<li><a name="cmd.setcaphanging"></a><a href="#cmd.setcaphanging">\setcaphanging</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setcaphanging">132</a></li>
-<li><a name="cmd.setcapindent*"></a><a href="#cmd.setcapindent*">\setcapindent*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setcapindent*">132</a></li>
-<li><a name="cmd.setcapindent"></a><a href="#cmd.setcapindent">\setcapindent</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setcapindent">132</a></li>
-<li><a name="cmd.setcapmargin*"></a><a href="#cmd.setcapmargin*">\setcapmargin*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setcapmargin*">133</a></li>
-<li><a name="cmd.setcapmargin"></a><a href="#cmd.setcapmargin">\setcapmargin</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setcapmargin">133</a></li>
-<li><a name="cmd.setcapwidth"></a><a href="#cmd.setcapwidth">\setcapwidth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setcapwidth">133</a></li>
-<li><a name="cmd.setchapterpreamble"></a><a href="#cmd.setchapterpreamble">\setchapterpreamble</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setchapterpreamble">108</a></li>
-<li><a name="cmd.setfootnoterule"></a><a href="#cmd.setfootnoterule">\setfootnoterule</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.setfootnoterule">208</a>, <a href="scrguien.pdf#desc:scrextend.cmd.setfootnoterule">283</a>, <a href="scrguien.pdf#desc:maincls.cmd.setfootnoterule">88</a></li>
-<li><a name="cmd.setindexpreamble"></a><a href="#cmd.setindexpreamble">\setindexpreamble</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setindexpreamble">142</a></li>
-<li><a name="cmd.setkomafont"></a><a href="#cmd.setkomafont">\setkomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.setkomafont">165</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.setkomafont">229</a>, <a href="scrguien.pdf#desc:scrextend.cmd.setkomafont">270</a>, <a href="scrguien.pdf#desc:scrjura.cmd.setkomafont">288</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.setkomafont">427</a>, <a href="scrguien.pdf#desc:maincls.cmd.setkomafont">57</a></li>
-<li><a name="cmd.setkomavar*"></a><a href="#cmd.setkomavar*">\setkomavar*</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.setkomavar*">146</a></li>
-<li><a name="cmd.setkomavar"></a><a href="#cmd.setkomavar">\setkomavar</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.setkomavar">146</a></li>
-<li><a name="cmd.setlengthtoplength"></a><a href="#cmd.setlengthtoplength">\setlengthtoplength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.setlengthtoplength">148</a></li>
-<li><a name="cmd.setparsizes"></a><a href="#cmd.setparsizes">\setparsizes</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.setparsizes">447</a></li>
-<li><a name="cmd.setpartpreamble"></a><a href="#cmd.setpartpreamble">\setpartpreamble</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setpartpreamble">108</a></li>
-<li><a name="cmd.setshowstyle"></a><a href="#cmd.setshowstyle">\setshowstyle</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.setshowstyle">487</a></li>
-<li><a name="cmd.settime"></a><a href="#cmd.settime">\settime</a> --&gt; <a href="scrguien.pdf#desc:scrtime.cmd.settime">258</a></li>
-<li><a name="cmd.setuptoc"></a><a href="#cmd.setuptoc">\setuptoc</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.setuptoc">354</a></li>
-<li><a name="cmd.showISOenvelope"></a><a href="#cmd.showISOenvelope">\showISOenvelope</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.showISOenvelope">488</a></li>
-<li><a name="cmd.showUScheck"></a><a href="#cmd.showUScheck">\showUScheck</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.showUScheck">488</a></li>
-<li><a name="cmd.showUScommercial"></a><a href="#cmd.showUScommercial">\showUScommercial</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.showUScommercial">488</a></li>
-<li><a name="cmd.showenvelope"></a><a href="#cmd.showenvelope">\showenvelope</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.showenvelope">488</a></li>
-<li><a name="cmd.showfields"></a><a href="#cmd.showfields">\showfields</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.showfields">487</a></li>
-<li><a name="cmd.storeareas"></a><a href="#cmd.storeareas">\storeareas</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.storeareas">440</a></li>
-<li><a name="cmd.subject"></a><a href="#cmd.subject">\subject</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.subject">273</a>, <a href="scrguien.pdf#desc:maincls.cmd.subject">65</a></li>
-<li><a name="cmd.subjectname"></a><a href="#cmd.subjectname">\subjectname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.subjectname">492</a></li>
-<li><a name="cmd.subparagraph*"></a><a href="#cmd.subparagraph*">\subparagraph*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subparagraph*">100</a></li>
-<li><a name="cmd.subparagraph"></a><a href="#cmd.subparagraph">\subparagraph</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subparagraph">95</a></li>
-<li><a name="cmd.subparagraphformat"></a><a href="#cmd.subparagraphformat">\subparagraphformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subparagraphformat">103</a></li>
-<li><a name="cmd.subparagraphmark"></a><a href="#cmd.subparagraphmark">\subparagraphmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.subparagraphmark">248</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.subparagraphmark">409</a></li>
-<li><a name="cmd.subparagraphmarkformat"></a><a href="#cmd.subparagraphmarkformat">\subparagraphmarkformat</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.subparagraphmarkformat">247</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.subparagraphmarkformat">409</a></li>
-<li><a name="cmd.subparagraphnumdepth"></a><a href="#cmd.subparagraphnumdepth">\subparagraphnumdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subparagraphnumdepth">107</a></li>
-<li><a name="cmd.subsection*"></a><a href="#cmd.subsection*">\subsection*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsection*">100</a></li>
-<li><a name="cmd.subsection"></a><a href="#cmd.subsection">\subsection</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsection">95</a></li>
-<li><a name="cmd.subsectionformat"></a><a href="#cmd.subsectionformat">\subsectionformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsectionformat">103</a></li>
-<li><a name="cmd.subsectionmark"></a><a href="#cmd.subsectionmark">\subsectionmark</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsectionmark">105</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.subsectionmark">248</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.subsectionmark">409</a></li>
-<li><a name="cmd.subsectionmarkformat"></a><a href="#cmd.subsectionmarkformat">\subsectionmarkformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsectionmarkformat">105</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.subsectionmarkformat">247</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.subsectionmarkformat">409</a></li>
-<li><a name="cmd.subsectionnumdepth"></a><a href="#cmd.subsectionnumdepth">\subsectionnumdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsectionnumdepth">107</a></li>
-<li><a name="cmd.subsubsection*"></a><a href="#cmd.subsubsection*">\subsubsection*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsubsection*">100</a></li>
-<li><a name="cmd.subsubsection"></a><a href="#cmd.subsubsection">\subsubsection</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsubsection">95</a></li>
-<li><a name="cmd.subsubsectionformat"></a><a href="#cmd.subsubsectionformat">\subsubsectionformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsubsectionformat">103</a></li>
-<li><a name="cmd.subsubsectionmark"></a><a href="#cmd.subsubsectionmark">\subsubsectionmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.subsubsectionmark">248</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.subsubsectionmark">409</a></li>
-<li><a name="cmd.subsubsectionmarkformat"></a><a href="#cmd.subsubsectionmarkformat">\subsubsectionmarkformat</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.subsubsectionmarkformat">247</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.subsubsectionmarkformat">409</a></li>
-<li><a name="cmd.subsubsectionnumdepth"></a><a href="#cmd.subsubsectionnumdepth">\subsubsectionnumdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsubsectionnumdepth">107</a></li>
-<li><a name="cmd.subtitle"></a><a href="#cmd.subtitle">\subtitle</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.subtitle">273</a>, <a href="scrguien.pdf#desc:maincls.cmd.subtitle">65</a></li>
-<li><a name="cmd.syncwithnotecolumn"></a><a href="#cmd.syncwithnotecolumn">\syncwithnotecolumn</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.syncwithnotecolumn">434</a></li>
-<li><a name="cmd.syncwithnotecolumns"></a><a href="#cmd.syncwithnotecolumns">\syncwithnotecolumns</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.syncwithnotecolumns">436</a></li>
-<li><a name="cmd.tableformat"></a><a href="#cmd.tableformat">\tableformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.tableformat">132</a></li>
-<li><a name="cmd.tableofcontents"></a><a href="#cmd.tableofcontents">\tableofcontents</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.tableofcontents">72</a></li>
-<li><a name="cmd.textsubscript"></a><a href="#cmd.textsubscript">\textsubscript</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.textsubscript">165</a>, <a href="scrguien.pdf#desc:scrextend.cmd.textsubscript">269</a>, <a href="scrguien.pdf#desc:maincls.cmd.textsubscript">56</a></li>
-<li><a name="cmd.textsuperscript"></a><a href="#cmd.textsuperscript">\textsuperscript</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.textsuperscript">165</a>, <a href="scrguien.pdf#desc:scrextend.cmd.textsuperscript">269</a>, <a href="scrguien.pdf#desc:maincls.cmd.textsuperscript">56</a></li>
-<li><a name="cmd.thanks"></a><a href="#cmd.thanks">\thanks</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.thanks">273</a>, <a href="scrguien.pdf#desc:maincls.cmd.thanks">65</a></li>
-<li><a name="cmd.theenumi"></a><a href="#cmd.theenumi">\theenumi</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.theenumi">113</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.theenumi">210</a></li>
-<li><a name="cmd.theenumii"></a><a href="#cmd.theenumii">\theenumii</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.theenumii">113</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.theenumii">210</a></li>
-<li><a name="cmd.theenumiii"></a><a href="#cmd.theenumiii">\theenumiii</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.theenumiii">113</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.theenumiii">210</a></li>
-<li><a name="cmd.theenumiv"></a><a href="#cmd.theenumiv">\theenumiv</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.theenumiv">113</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.theenumiv">210</a></li>
-<li><a name="cmd.thefootnotemark"></a><a href="#cmd.thefootnotemark">\thefootnotemark</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.thefootnotemark">208</a>, <a href="scrguien.pdf#desc:scrextend.cmd.thefootnotemark">281</a>, <a href="scrguien.pdf#desc:maincls.cmd.thefootnotemark">87</a></li>
-<li><a name="cmd.thepar"></a><a href="#cmd.thepar">\thepar</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.thepar">294</a></li>
-<li><a name="cmd.thesentence"></a><a href="#cmd.thesentence">\thesentence</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.thesentence">295</a></li>
-<li><a name="cmd.thisletter"></a><a href="#cmd.thisletter">\thisletter</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.thisletter">155</a></li>
-<li><a name="cmd.thispagestyle"></a><a href="#cmd.thispagestyle">\thispagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.thispagestyle">201</a>, <a href="scrguien.pdf#desc:maincls.cmd.thispagestyle">77</a></li>
-<li><a name="cmd.thistime*"></a><a href="#cmd.thistime*">\thistime*</a> --&gt; <a href="scrguien.pdf#desc:scrtime.cmd.thistime*">258</a></li>
-<li><a name="cmd.thistime"></a><a href="#cmd.thistime">\thistime</a> --&gt; <a href="scrguien.pdf#desc:scrtime.cmd.thistime">258</a></li>
-<li><a name="cmd.title"></a><a href="#cmd.title">\title</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.title">273</a>, <a href="scrguien.pdf#desc:maincls.cmd.title">65</a></li>
-<li><a name="cmd.titlehead"></a><a href="#cmd.titlehead">\titlehead</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.titlehead">273</a>, <a href="scrguien.pdf#desc:maincls.cmd.titlehead">65</a></li>
-<li><a name="cmd.titlepagestyle"></a><a href="#cmd.titlepagestyle">\titlepagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.titlepagestyle">276</a>, <a href="scrguien.pdf#desc:maincls.cmd.titlepagestyle">79</a></li>
-<li><a name="cmd.tocbasic@/extension/@after@hook"></a><a href="#cmd.tocbasic@/extension/@after@hook">\tocbasic@/extension/@after@hook</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@/extension/@after@hook">369</a></li>
-<li><a name="cmd.tocbasic@/extension/@before@hook"></a><a href="#cmd.tocbasic@/extension/@before@hook">\tocbasic@/extension/@before@hook</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@/extension/@before@hook">369</a></li>
-<li><a name="cmd.tocbasic@@after@hook"></a><a href="#cmd.tocbasic@@after@hook">\tocbasic@@after@hook</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@@after@hook">369</a></li>
-<li><a name="cmd.tocbasic@@before@hook"></a><a href="#cmd.tocbasic@@before@hook">\tocbasic@@before@hook</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@@before@hook">369</a></li>
-<li><a name="cmd.tocbasic@DependOnPenaltyAndTOCLevel"></a><a href="#cmd.tocbasic@DependOnPenaltyAndTOCLevel">\tocbasic@DependOnPenaltyAndTOCLevel</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@DependOnPenaltyAndTOCLevel">370</a></li>
-<li><a name="cmd.tocbasic@SetPenaltyByTOCLevel"></a><a href="#cmd.tocbasic@SetPenaltyByTOCLevel">\tocbasic@SetPenaltyByTOCLevel</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@SetPenaltyByTOCLevel">370</a></li>
-<li><a name="cmd.tocbasic@addxcontentsline"></a><a href="#cmd.tocbasic@addxcontentsline">\tocbasic@addxcontentsline</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@addxcontentsline">370</a></li>
-<li><a name="cmd.tocbasic@extend@babel"></a><a href="#cmd.tocbasic@extend@babel">\tocbasic@extend@babel</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@extend@babel">368</a></li>
-<li><a name="cmd.tocbasic@listhead"></a><a href="#cmd.tocbasic@listhead">\tocbasic@listhead</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@listhead">369</a></li>
-<li><a name="cmd.tocbasic@listhead@/extension/"></a><a href="#cmd.tocbasic@listhead@/extension/">\tocbasic@listhead@/extension/</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@listhead@/extension/">369</a></li>
-<li><a name="cmd.tocbasic@starttoc"></a><a href="#cmd.tocbasic@starttoc">\tocbasic@starttoc</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@starttoc">368</a></li>
-<li><a name="cmd.tocbasicautomode"></a><a href="#cmd.tocbasicautomode">\tocbasicautomode</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasicautomode">349</a></li>
-<li><a name="cmd.todaysname"></a><a href="#cmd.todaysname">\todaysname</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.todaysname">255</a></li>
-<li><a name="cmd.todaysnumber"></a><a href="#cmd.todaysnumber">\todaysnumber</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.todaysnumber">255</a></li>
-<li><a name="cmd.typearea"></a><a href="#cmd.typearea">\typearea</a> --&gt; <a href="scrguien.pdf#desc:typearea.cmd.typearea">38</a></li>
-<li><a name="cmd.unitfactor"></a><a href="#cmd.unitfactor">\unitfactor</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.unitfactor">488</a></li>
-<li><a name="cmd.unsettoc"></a><a href="#cmd.unsettoc">\unsettoc</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.unsettoc">354</a></li>
-<li><a name="cmd.uppertitleback"></a><a href="#cmd.uppertitleback">\uppertitleback</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.uppertitleback">275</a>, <a href="scrguien.pdf#desc:maincls.cmd.uppertitleback">67</a></li>
-<li><a name="cmd.useencodingofkomafont"></a><a href="#cmd.useencodingofkomafont">\useencodingofkomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.useencodingofkomafont">168</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.useencodingofkomafont">231</a>, <a href="scrguien.pdf#desc:scrextend.cmd.useencodingofkomafont">271</a>, <a href="scrguien.pdf#desc:scrjura.cmd.useencodingofkomafont">289</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.useencodingofkomafont">428</a>, <a href="scrguien.pdf#desc:maincls.cmd.useencodingofkomafont">62</a></li>
-<li><a name="cmd.usefamilyofkomafont"></a><a href="#cmd.usefamilyofkomafont">\usefamilyofkomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.usefamilyofkomafont">168</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.usefamilyofkomafont">231</a>, <a href="scrguien.pdf#desc:scrextend.cmd.usefamilyofkomafont">271</a>, <a href="scrguien.pdf#desc:scrjura.cmd.usefamilyofkomafont">289</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.usefamilyofkomafont">428</a>, <a href="scrguien.pdf#desc:maincls.cmd.usefamilyofkomafont">62</a></li>
-<li><a name="cmd.usefontofkomafont"></a><a href="#cmd.usefontofkomafont">\usefontofkomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.usefontofkomafont">168</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.usefontofkomafont">231</a>, <a href="scrguien.pdf#desc:scrextend.cmd.usefontofkomafont">271</a>, <a href="scrguien.pdf#desc:scrjura.cmd.usefontofkomafont">289</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.usefontofkomafont">428</a>, <a href="scrguien.pdf#desc:maincls.cmd.usefontofkomafont">62</a></li>
-<li><a name="cmd.usekomafont"></a><a href="#cmd.usekomafont">\usekomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.usekomafont">165</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.usekomafont">229</a>, <a href="scrguien.pdf#desc:scrextend.cmd.usekomafont">270</a>, <a href="scrguien.pdf#desc:scrjura.cmd.usekomafont">288</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.usekomafont">427</a>, <a href="scrguien.pdf#desc:maincls.cmd.usekomafont">57</a></li>
-<li><a name="cmd.usekomavar*"></a><a href="#cmd.usekomavar*">\usekomavar*</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.usekomavar*">147</a>, <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.usekomavar*">483</a></li>
-<li><a name="cmd.usekomavar"></a><a href="#cmd.usekomavar">\usekomavar</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.usekomavar">147</a>, <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.usekomavar">483</a></li>
-<li><a name="cmd.usepackage"></a><a href="#cmd.usepackage">\usepackage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.usepackage">149</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.usepackage">227</a>, <a href="scrguien.pdf#desc:scrextend.cmd.usepackage">266</a>, <a href="scrguien.pdf#desc:scrjura.cmd.usepackage">287</a>, <a href="scrguien.pdf#desc:typearea.cmd.usepackage">29</a>, <a href="scrguien.pdf#desc:scrhack.cmd.usepackage">379</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.usepackage">384</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.usepackage">426</a>, <a href="scrguien.pdf#desc:maincls.cmd.usepackage">52</a></li>
-<li><a name="cmd.useplength"></a><a href="#cmd.useplength">\useplength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.useplength">148</a></li>
-<li><a name="cmd.useseriesofkomafont"></a><a href="#cmd.useseriesofkomafont">\useseriesofkomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.useseriesofkomafont">168</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.useseriesofkomafont">231</a>, <a href="scrguien.pdf#desc:scrextend.cmd.useseriesofkomafont">271</a>, <a href="scrguien.pdf#desc:scrjura.cmd.useseriesofkomafont">289</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.useseriesofkomafont">428</a>, <a href="scrguien.pdf#desc:maincls.cmd.useseriesofkomafont">62</a></li>
-<li><a name="cmd.useshapeofkomafont"></a><a href="#cmd.useshapeofkomafont">\useshapeofkomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.useshapeofkomafont">168</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.useshapeofkomafont">231</a>, <a href="scrguien.pdf#desc:scrextend.cmd.useshapeofkomafont">271</a>, <a href="scrguien.pdf#desc:scrjura.cmd.useshapeofkomafont">289</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.useshapeofkomafont">428</a>, <a href="scrguien.pdf#desc:maincls.cmd.useshapeofkomafont">62</a></li>
-<li><a name="cmd.usesizeofkomafont"></a><a href="#cmd.usesizeofkomafont">\usesizeofkomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.usesizeofkomafont">168</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.usesizeofkomafont">231</a>, <a href="scrguien.pdf#desc:scrextend.cmd.usesizeofkomafont">271</a>, <a href="scrguien.pdf#desc:scrjura.cmd.usesizeofkomafont">289</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.usesizeofkomafont">428</a>, <a href="scrguien.pdf#desc:maincls.cmd.usesizeofkomafont">62</a></li>
-<li><a name="cmd.usetocbasicnumberline"></a><a href="#cmd.usetocbasicnumberline">\usetocbasicnumberline</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.usetocbasicnumberline">357</a></li>
-<li><a name="cmd.wwwname"></a><a href="#cmd.wwwname">\wwwname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.wwwname">492</a></li>
-<li><a name="cmd.yourmailname"></a><a href="#cmd.yourmailname">\yourmailname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.yourmailname">492</a></li>
-<li><a name="cmd.yourrefname"></a><a href="#cmd.yourrefname">\yourrefname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.yourrefname">492</a></li>
+<li><a name="cmd.@addtoplength"></a><a href="#cmd.@addtoplength">\@addtoplength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.@addtoplength">483</a></li>
+<li><a name="cmd.@fontsizefilebase"></a><a href="#cmd.@fontsizefilebase">\@fontsizefilebase</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.@fontsizefilebase">455</a></li>
+<li><a name="cmd.@mkboth"></a><a href="#cmd.@mkboth">\@mkboth</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.@mkboth">424</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.@mkboth">430</a></li>
+<li><a name="cmd.@mkdouble"></a><a href="#cmd.@mkdouble">\@mkdouble</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.@mkdouble">424</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.@mkdouble">430</a></li>
+<li><a name="cmd.@mkleft"></a><a href="#cmd.@mkleft">\@mkleft</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.@mkleft">424</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.@mkleft">430</a></li>
+<li><a name="cmd.@mkright"></a><a href="#cmd.@mkright">\@mkright</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.@mkright">424</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.@mkright">430</a></li>
+<li><a name="cmd.@newplength"></a><a href="#cmd.@newplength">\@newplength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.@newplength">483</a></li>
+<li><a name="cmd.@openbib@code"></a><a href="#cmd.@openbib@code">\@openbib@code</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.@openbib@code">476</a></li>
+<li><a name="cmd.@setplength"></a><a href="#cmd.@setplength">\@setplength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.@setplength">483</a></li>
+<li><a name="cmd.AddLayersAtBeginOfPageStyle"></a><a href="#cmd.AddLayersAtBeginOfPageStyle">\AddLayersAtBeginOfPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.AddLayersAtBeginOfPageStyle">415</a></li>
+<li><a name="cmd.AddLayersAtEndOfPageStyle"></a><a href="#cmd.AddLayersAtEndOfPageStyle">\AddLayersAtEndOfPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.AddLayersAtEndOfPageStyle">415</a></li>
+<li><a name="cmd.AddLayersToPageStyle"></a><a href="#cmd.AddLayersToPageStyle">\AddLayersToPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.AddLayersToPageStyle">415</a></li>
+<li><a name="cmd.AddLayersToPageStyleAfterLayer"></a><a href="#cmd.AddLayersToPageStyleAfterLayer">\AddLayersToPageStyleAfterLayer</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.AddLayersToPageStyleAfterLayer">415</a></li>
+<li><a name="cmd.AddLayersToPageStyleBeforeLayer"></a><a href="#cmd.AddLayersToPageStyleBeforeLayer">\AddLayersToPageStyleBeforeLayer</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.AddLayersToPageStyleBeforeLayer">415</a></li>
+<li><a name="cmd.AddToLayerPageStyleOptions"></a><a href="#cmd.AddToLayerPageStyleOptions">\AddToLayerPageStyleOptions</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.AddToLayerPageStyleOptions">416</a></li>
+<li><a name="cmd.Address"></a><a href="#cmd.Address">\Address</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.Address">270</a></li>
+<li><a name="cmd.AfterAtEndOfClass"></a><a href="#cmd.AfterAtEndOfClass">\AfterAtEndOfClass</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterAtEndOfClass">343</a></li>
+<li><a name="cmd.AfterAtEndOfPackage"></a><a href="#cmd.AfterAtEndOfPackage">\AfterAtEndOfPackage</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterAtEndOfPackage">343</a></li>
+<li><a name="cmd.AfterBibliographyPreamble"></a><a href="#cmd.AfterBibliographyPreamble">\AfterBibliographyPreamble</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.AfterBibliographyPreamble">148</a></li>
+<li><a name="cmd.AfterCalculatingTypearea*"></a><a href="#cmd.AfterCalculatingTypearea*">\AfterCalculatingTypearea*</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.AfterCalculatingTypearea*">451</a></li>
+<li><a name="cmd.AfterCalculatingTypearea"></a><a href="#cmd.AfterCalculatingTypearea">\AfterCalculatingTypearea</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.AfterCalculatingTypearea">451</a></li>
+<li><a name="cmd.AfterClass!"></a><a href="#cmd.AfterClass!">\AfterClass!</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterClass!">343</a></li>
+<li><a name="cmd.AfterClass*"></a><a href="#cmd.AfterClass*">\AfterClass*</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterClass*">343</a></li>
+<li><a name="cmd.AfterClass+"></a><a href="#cmd.AfterClass+">\AfterClass+</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterClass+">343</a></li>
+<li><a name="cmd.AfterClass"></a><a href="#cmd.AfterClass">\AfterClass</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterClass">343</a></li>
+<li><a name="cmd.AfterFile"></a><a href="#cmd.AfterFile">\AfterFile</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterFile">342</a></li>
+<li><a name="cmd.AfterPackage!"></a><a href="#cmd.AfterPackage!">\AfterPackage!</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterPackage!">343</a></li>
+<li><a name="cmd.AfterPackage*"></a><a href="#cmd.AfterPackage*">\AfterPackage*</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterPackage*">343</a></li>
+<li><a name="cmd.AfterPackage+"></a><a href="#cmd.AfterPackage+">\AfterPackage+</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterPackage+">343</a></li>
+<li><a name="cmd.AfterPackage"></a><a href="#cmd.AfterPackage">\AfterPackage</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterPackage">343</a></li>
+<li><a name="cmd.AfterReadingMainAux"></a><a href="#cmd.AfterReadingMainAux">\AfterReadingMainAux</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.AfterReadingMainAux">345</a></li>
+<li><a name="cmd.AfterRestoreareas*"></a><a href="#cmd.AfterRestoreareas*">\AfterRestoreareas*</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.AfterRestoreareas*">450</a></li>
+<li><a name="cmd.AfterRestoreareas"></a><a href="#cmd.AfterRestoreareas">\AfterRestoreareas</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.AfterRestoreareas">450</a></li>
+<li><a name="cmd.AfterSelectAnyPageStyle"></a><a href="#cmd.AfterSelectAnyPageStyle">\AfterSelectAnyPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.AfterSelectAnyPageStyle">410</a></li>
+<li><a name="cmd.AfterSettingArea*"></a><a href="#cmd.AfterSettingArea*">\AfterSettingArea*</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.AfterSettingArea*">451</a></li>
+<li><a name="cmd.AfterSettingArea"></a><a href="#cmd.AfterSettingArea">\AfterSettingArea</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.AfterSettingArea">451</a></li>
+<li><a name="cmd.AfterStartingTOC"></a><a href="#cmd.AfterStartingTOC">\AfterStartingTOC</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.AfterStartingTOC">363</a></li>
+<li><a name="cmd.AfterTOCHead"></a><a href="#cmd.AfterTOCHead">\AfterTOCHead</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.AfterTOCHead">364</a></li>
+<li><a name="cmd.At@startsection"></a><a href="#cmd.At@startsection">\At@startsection</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.At@startsection">474</a></li>
+<li><a name="cmd.AtAddToTocList"></a><a href="#cmd.AtAddToTocList">\AtAddToTocList</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.AtAddToTocList">358</a></li>
+<li><a name="cmd.AtBeginLetter"></a><a href="#cmd.AtBeginLetter">\AtBeginLetter</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.AtBeginLetter">163</a></li>
+<li><a name="cmd.AtEndBibliography"></a><a href="#cmd.AtEndBibliography">\AtEndBibliography</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.AtEndBibliography">148</a></li>
+<li><a name="cmd.AtEndLetter"></a><a href="#cmd.AtEndLetter">\AtEndLetter</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.AtEndLetter">163</a></li>
+<li><a name="cmd.AtEndOfFamilyOptions*"></a><a href="#cmd.AtEndOfFamilyOptions*">\AtEndOfFamilyOptions*</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.AtEndOfFamilyOptions*">324</a></li>
+<li><a name="cmd.AtEndOfFamilyOptions"></a><a href="#cmd.AtEndOfFamilyOptions">\AtEndOfFamilyOptions</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.AtEndOfFamilyOptions">324</a></li>
+<li><a name="cmd.Before@sect"></a><a href="#cmd.Before@sect">\Before@sect</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.Before@sect">474</a></li>
+<li><a name="cmd.Before@ssect"></a><a href="#cmd.Before@ssect">\Before@ssect</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.Before@ssect">474</a></li>
+<li><a name="cmd.BeforeClass"></a><a href="#cmd.BeforeClass">\BeforeClass</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.BeforeClass">342</a></li>
+<li><a name="cmd.BeforeClosingMainAux"></a><a href="#cmd.BeforeClosingMainAux">\BeforeClosingMainAux</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.BeforeClosingMainAux">345</a></li>
+<li><a name="cmd.BeforeFamilyProcessOptions"></a><a href="#cmd.BeforeFamilyProcessOptions">\BeforeFamilyProcessOptions</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.BeforeFamilyProcessOptions">321</a></li>
+<li><a name="cmd.BeforeFile"></a><a href="#cmd.BeforeFile">\BeforeFile</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.BeforeFile">342</a></li>
+<li><a name="cmd.BeforePackage"></a><a href="#cmd.BeforePackage">\BeforePackage</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.BeforePackage">342</a></li>
+<li><a name="cmd.BeforeRestoreareas*"></a><a href="#cmd.BeforeRestoreareas*">\BeforeRestoreareas*</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.BeforeRestoreareas*">450</a></li>
+<li><a name="cmd.BeforeRestoreareas"></a><a href="#cmd.BeforeRestoreareas">\BeforeRestoreareas</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.BeforeRestoreareas">450</a></li>
+<li><a name="cmd.BeforeSelectAnyPageStyle"></a><a href="#cmd.BeforeSelectAnyPageStyle">\BeforeSelectAnyPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.BeforeSelectAnyPageStyle">410</a></li>
+<li><a name="cmd.BeforeStartingTOC"></a><a href="#cmd.BeforeStartingTOC">\BeforeStartingTOC</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.BeforeStartingTOC">363</a></li>
+<li><a name="cmd.BeforeTOCHead"></a><a href="#cmd.BeforeTOCHead">\BeforeTOCHead</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.BeforeTOCHead">364</a></li>
+<li><a name="cmd.BreakBibliography"></a><a href="#cmd.BreakBibliography">\BreakBibliography</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.BreakBibliography">148</a></li>
+<li><a name="cmd.CenturyPart"></a><a href="#cmd.CenturyPart">\CenturyPart</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.CenturyPart">262</a></li>
+<li><a name="cmd.ClassName"></a><a href="#cmd.ClassName">\ClassName</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.ClassName">453</a></li>
+<li><a name="cmd.Clause"></a><a href="#cmd.Clause">\Clause</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.Clause">298</a></li>
+<li><a name="cmd.Clauseformat"></a><a href="#cmd.Clauseformat">\Clauseformat</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.Clauseformat">300</a></li>
+<li><a name="cmd.CloneTOCEntryStyle"></a><a href="#cmd.CloneTOCEntryStyle">\CloneTOCEntryStyle</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.CloneTOCEntryStyle">378</a></li>
+<li><a name="cmd.Comment"></a><a href="#cmd.Comment">\Comment</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.Comment">270</a></li>
+<li><a name="cmd.DayName"></a><a href="#cmd.DayName">\DayName</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.DayName">263</a></li>
+<li><a name="cmd.DayNameByNumber"></a><a href="#cmd.DayNameByNumber">\DayNameByNumber</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.DayNameByNumber">263</a></li>
+<li><a name="cmd.DayNumber"></a><a href="#cmd.DayNumber">\DayNumber</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.DayNumber">262</a></li>
+<li><a name="cmd.DecadePart"></a><a href="#cmd.DecadePart">\DecadePart</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.DecadePart">262</a></li>
+<li><a name="cmd.DeclareLayer"></a><a href="#cmd.DeclareLayer">\DeclareLayer</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DeclareLayer">399</a></li>
+<li><a name="cmd.DeclareNewJuraEnvironment"></a><a href="#cmd.DeclareNewJuraEnvironment">\DeclareNewJuraEnvironment</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.DeclareNewJuraEnvironment">305</a></li>
+<li><a name="cmd.DeclareNewLayer"></a><a href="#cmd.DeclareNewLayer">\DeclareNewLayer</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DeclareNewLayer">399</a></li>
+<li><a name="cmd.DeclareNewNoteColumn"></a><a href="#cmd.DeclareNewNoteColumn">\DeclareNewNoteColumn</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.DeclareNewNoteColumn">440</a></li>
+<li><a name="cmd.DeclareNewPageStyleAlias"></a><a href="#cmd.DeclareNewPageStyleAlias">\DeclareNewPageStyleAlias</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DeclareNewPageStyleAlias">410</a></li>
+<li><a name="cmd.DeclareNewPageStyleByLayers"></a><a href="#cmd.DeclareNewPageStyleByLayers">\DeclareNewPageStyleByLayers</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DeclareNewPageStyleByLayers">411</a></li>
+<li><a name="cmd.DeclareNewSectionCommand"></a><a href="#cmd.DeclareNewSectionCommand">\DeclareNewSectionCommand</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.DeclareNewSectionCommand">458</a></li>
+<li><a name="cmd.DeclareNewSectionCommands"></a><a href="#cmd.DeclareNewSectionCommands">\DeclareNewSectionCommands</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.DeclareNewSectionCommands">467</a></li>
+<li><a name="cmd.DeclareNewTOC"></a><a href="#cmd.DeclareNewTOC">\DeclareNewTOC</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DeclareNewTOC">384</a></li>
+<li><a name="cmd.DeclareNoteColumn"></a><a href="#cmd.DeclareNoteColumn">\DeclareNoteColumn</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.DeclareNoteColumn">440</a></li>
+<li><a name="cmd.DeclarePageStyleAlias"></a><a href="#cmd.DeclarePageStyleAlias">\DeclarePageStyleAlias</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DeclarePageStyleAlias">410</a></li>
+<li><a name="cmd.DeclarePageStyleByLayers"></a><a href="#cmd.DeclarePageStyleByLayers">\DeclarePageStyleByLayers</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DeclarePageStyleByLayers">411</a></li>
+<li><a name="cmd.DeclareSectionCommand"></a><a href="#cmd.DeclareSectionCommand">\DeclareSectionCommand</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.DeclareSectionCommand">458</a></li>
+<li><a name="cmd.DeclareSectionCommands"></a><a href="#cmd.DeclareSectionCommands">\DeclareSectionCommands</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.DeclareSectionCommands">467</a></li>
+<li><a name="cmd.DeclareSectionNumberDepth"></a><a href="#cmd.DeclareSectionNumberDepth">\DeclareSectionNumberDepth</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DeclareSectionNumberDepth">397</a></li>
+<li><a name="cmd.DeclareTOCEntryStyle"></a><a href="#cmd.DeclareTOCEntryStyle">\DeclareTOCEntryStyle</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DeclareTOCEntryStyle">376</a></li>
+<li><a name="cmd.DeclareTOCStyleEntry"></a><a href="#cmd.DeclareTOCStyleEntry">\DeclareTOCStyleEntry</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DeclareTOCStyleEntry">368</a></li>
+<li><a name="cmd.DefineFamily"></a><a href="#cmd.DefineFamily">\DefineFamily</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.DefineFamily">317</a></li>
+<li><a name="cmd.DefineFamilyKey"></a><a href="#cmd.DefineFamilyKey">\DefineFamilyKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.DefineFamilyKey">318</a></li>
+<li><a name="cmd.DefineFamilyMember"></a><a href="#cmd.DefineFamilyMember">\DefineFamilyMember</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.DefineFamilyMember">317</a></li>
+<li><a name="cmd.DefineTOCEntryBooleanOption"></a><a href="#cmd.DefineTOCEntryBooleanOption">\DefineTOCEntryBooleanOption</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DefineTOCEntryBooleanOption">376</a></li>
+<li><a name="cmd.DefineTOCEntryCommandOption"></a><a href="#cmd.DefineTOCEntryCommandOption">\DefineTOCEntryCommandOption</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DefineTOCEntryCommandOption">376</a></li>
+<li><a name="cmd.DefineTOCEntryIfOption"></a><a href="#cmd.DefineTOCEntryIfOption">\DefineTOCEntryIfOption</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DefineTOCEntryIfOption">376</a></li>
+<li><a name="cmd.DefineTOCEntryLengthOption"></a><a href="#cmd.DefineTOCEntryLengthOption">\DefineTOCEntryLengthOption</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DefineTOCEntryLengthOption">376</a></li>
+<li><a name="cmd.DefineTOCEntryNumberOption"></a><a href="#cmd.DefineTOCEntryNumberOption">\DefineTOCEntryNumberOption</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DefineTOCEntryNumberOption">376</a></li>
+<li><a name="cmd.DefineTOCEntryOption"></a><a href="#cmd.DefineTOCEntryOption">\DefineTOCEntryOption</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.DefineTOCEntryOption">376</a></li>
+<li><a name="cmd.DestroyLayer"></a><a href="#cmd.DestroyLayer">\DestroyLayer</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DestroyLayer">408</a></li>
+<li><a name="cmd.DestroyPageStyleAlias"></a><a href="#cmd.DestroyPageStyleAlias">\DestroyPageStyleAlias</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DestroyPageStyleAlias">410</a></li>
+<li><a name="cmd.DestroyRealLayerPageStyle"></a><a href="#cmd.DestroyRealLayerPageStyle">\DestroyRealLayerPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.DestroyRealLayerPageStyle">417</a></li>
+<li><a name="cmd.FamilyBoolKey"></a><a href="#cmd.FamilyBoolKey">\FamilyBoolKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyBoolKey">324</a></li>
+<li><a name="cmd.FamilyCSKey"></a><a href="#cmd.FamilyCSKey">\FamilyCSKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyCSKey">328</a></li>
+<li><a name="cmd.FamilyCounterKey"></a><a href="#cmd.FamilyCounterKey">\FamilyCounterKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyCounterKey">327</a></li>
+<li><a name="cmd.FamilyCounterMacroKey"></a><a href="#cmd.FamilyCounterMacroKey">\FamilyCounterMacroKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyCounterMacroKey">327</a></li>
+<li><a name="cmd.FamilyElseValues"></a><a href="#cmd.FamilyElseValues">\FamilyElseValues</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyElseValues">330</a></li>
+<li><a name="cmd.FamilyExecuteOptions"></a><a href="#cmd.FamilyExecuteOptions">\FamilyExecuteOptions</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyExecuteOptions">321</a></li>
+<li><a name="cmd.FamilyKeyState"></a><a href="#cmd.FamilyKeyState">\FamilyKeyState</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyKeyState">318</a></li>
+<li><a name="cmd.FamilyKeyStateNeedValue"></a><a href="#cmd.FamilyKeyStateNeedValue">\FamilyKeyStateNeedValue</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyKeyStateNeedValue">318</a></li>
+<li><a name="cmd.FamilyKeyStateProcessed"></a><a href="#cmd.FamilyKeyStateProcessed">\FamilyKeyStateProcessed</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyKeyStateProcessed">318</a></li>
+<li><a name="cmd.FamilyKeyStateUnknown"></a><a href="#cmd.FamilyKeyStateUnknown">\FamilyKeyStateUnknown</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyKeyStateUnknown">318</a></li>
+<li><a name="cmd.FamilyKeyStateUnknownValue"></a><a href="#cmd.FamilyKeyStateUnknownValue">\FamilyKeyStateUnknownValue</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyKeyStateUnknownValue">318</a></li>
+<li><a name="cmd.FamilyLengthKey"></a><a href="#cmd.FamilyLengthKey">\FamilyLengthKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyLengthKey">328</a></li>
+<li><a name="cmd.FamilyLengthMacroKey"></a><a href="#cmd.FamilyLengthMacroKey">\FamilyLengthMacroKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyLengthMacroKey">328</a></li>
+<li><a name="cmd.FamilyNumericalKey"></a><a href="#cmd.FamilyNumericalKey">\FamilyNumericalKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyNumericalKey">326</a></li>
+<li><a name="cmd.FamilyOption"></a><a href="#cmd.FamilyOption">\FamilyOption</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyOption">323</a></li>
+<li><a name="cmd.FamilyOptions"></a><a href="#cmd.FamilyOptions">\FamilyOptions</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyOptions">322</a></li>
+<li><a name="cmd.FamilyProcessOptions"></a><a href="#cmd.FamilyProcessOptions">\FamilyProcessOptions</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyProcessOptions">320</a></li>
+<li><a name="cmd.FamilySetBool"></a><a href="#cmd.FamilySetBool">\FamilySetBool</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilySetBool">324</a></li>
+<li><a name="cmd.FamilySetCounter"></a><a href="#cmd.FamilySetCounter">\FamilySetCounter</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilySetCounter">327</a></li>
+<li><a name="cmd.FamilySetCounterMacro"></a><a href="#cmd.FamilySetCounterMacro">\FamilySetCounterMacro</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilySetCounterMacro">327</a></li>
+<li><a name="cmd.FamilySetLength"></a><a href="#cmd.FamilySetLength">\FamilySetLength</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilySetLength">328</a></li>
+<li><a name="cmd.FamilySetLengthMacro"></a><a href="#cmd.FamilySetLengthMacro">\FamilySetLengthMacro</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilySetLengthMacro">328</a></li>
+<li><a name="cmd.FamilySetNumerical"></a><a href="#cmd.FamilySetNumerical">\FamilySetNumerical</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilySetNumerical">326</a></li>
+<li><a name="cmd.FamilyStringKey"></a><a href="#cmd.FamilyStringKey">\FamilyStringKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyStringKey">328</a></li>
+<li><a name="cmd.FamilyUnknownKeyValue"></a><a href="#cmd.FamilyUnknownKeyValue">\FamilyUnknownKeyValue</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.FamilyUnknownKeyValue">329</a></li>
+<li><a name="cmd.FirstName"></a><a href="#cmd.FirstName">\FirstName</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.FirstName">270</a></li>
+<li><a name="cmd.ForEachLayerOfPageStyle*"></a><a href="#cmd.ForEachLayerOfPageStyle*">\ForEachLayerOfPageStyle*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.ForEachLayerOfPageStyle*">414</a></li>
+<li><a name="cmd.ForEachLayerOfPageStyle"></a><a href="#cmd.ForEachLayerOfPageStyle">\ForEachLayerOfPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.ForEachLayerOfPageStyle">414</a></li>
+<li><a name="cmd.FreeI"></a><a href="#cmd.FreeI">\FreeI</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.FreeI">270</a></li>
+<li><a name="cmd.FreeII"></a><a href="#cmd.FreeII">\FreeII</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.FreeII">270</a></li>
+<li><a name="cmd.FreeIII"></a><a href="#cmd.FreeIII">\FreeIII</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.FreeIII">270</a></li>
+<li><a name="cmd.FreeIV"></a><a href="#cmd.FreeIV">\FreeIV</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.FreeIV">270</a></li>
+<li><a name="cmd.GenericMarkFormat"></a><a href="#cmd.GenericMarkFormat">\GenericMarkFormat</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.GenericMarkFormat">422</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.GenericMarkFormat">427</a></li>
+<li><a name="cmd.GetLayerContents"></a><a href="#cmd.GetLayerContents">\GetLayerContents</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.GetLayerContents">408</a></li>
+<li><a name="cmd.GetRealPageStyle"></a><a href="#cmd.GetRealPageStyle">\GetRealPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.GetRealPageStyle">411</a></li>
+<li><a name="cmd.ISODayName"></a><a href="#cmd.ISODayName">\ISODayName</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.ISODayName">263</a></li>
+<li><a name="cmd.ISODayNumber"></a><a href="#cmd.ISODayNumber">\ISODayNumber</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.ISODayNumber">262</a></li>
+<li><a name="cmd.ISOToday"></a><a href="#cmd.ISOToday">\ISOToday</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.ISOToday">264</a></li>
+<li><a name="cmd.IfChapterUsesPrefixLine"></a><a href="#cmd.IfChapterUsesPrefixLine">\IfChapterUsesPrefixLine</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.IfChapterUsesPrefixLine">95</a></li>
+<li><a name="cmd.IfExistskomafont"></a><a href="#cmd.IfExistskomafont">\IfExistskomafont</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.IfExistskomafont">457</a></li>
+<li><a name="cmd.IfIsAliaskomafont"></a><a href="#cmd.IfIsAliaskomafont">\IfIsAliaskomafont</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.IfIsAliaskomafont">457</a></li>
+<li><a name="cmd.IfLayerAtPageStyle"></a><a href="#cmd.IfLayerAtPageStyle">\IfLayerAtPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.IfLayerAtPageStyle">417</a></li>
+<li><a name="cmd.IfLayerExists"></a><a href="#cmd.IfLayerExists">\IfLayerExists</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.IfLayerExists">408</a></li>
+<li><a name="cmd.IfLayerPageStyleExists"></a><a href="#cmd.IfLayerPageStyleExists">\IfLayerPageStyleExists</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.IfLayerPageStyleExists">416</a></li>
+<li><a name="cmd.IfLayersAtPageStyle"></a><a href="#cmd.IfLayersAtPageStyle">\IfLayersAtPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.IfLayersAtPageStyle">417</a></li>
+<li><a name="cmd.IfRealLayerPageStyleExists"></a><a href="#cmd.IfRealLayerPageStyleExists">\IfRealLayerPageStyleExists</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.IfRealLayerPageStyleExists">416</a></li>
+<li><a name="cmd.IfSomeLayerAtPageStyle"></a><a href="#cmd.IfSomeLayerAtPageStyle">\IfSomeLayerAtPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.IfSomeLayerAtPageStyle">417</a></li>
+<li><a name="cmd.IfUsePrefixLine"></a><a href="#cmd.IfUsePrefixLine">\IfUsePrefixLine</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.IfUsePrefixLine">108</a></li>
+<li><a name="cmd.InputAddressFile"></a><a href="#cmd.InputAddressFile">\InputAddressFile</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.InputAddressFile">269</a></li>
+<li><a name="cmd.IsoToday"></a><a href="#cmd.IsoToday">\IsoToday</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.IsoToday">264</a></li>
+<li><a name="cmd.KOMAClassName"></a><a href="#cmd.KOMAClassName">\KOMAClassName</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.KOMAClassName">453</a></li>
+<li><a name="cmd.KOMAScript"></a><a href="#cmd.KOMAScript">\KOMAScript</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.KOMAScript">339</a></li>
+<li><a name="cmd.KOMAScriptVersion"></a><a href="#cmd.KOMAScriptVersion">\KOMAScriptVersion</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.KOMAScriptVersion">339</a></li>
+<li><a name="cmd.KOMAoption"></a><a href="#cmd.KOMAoption">\KOMAoption</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.KOMAoption">158</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.KOMAoption">237</a>, <a href="scrguien.pdf#desc:scrextend.cmd.KOMAoption">275</a>, <a href="scrguien.pdf#desc:scrjura.cmd.KOMAoption">295</a>, <a href="scrguien.pdf#desc:typearea.cmd.KOMAoption">32</a>, <a href="scrguien.pdf#desc:scrhack.cmd.KOMAoption">392</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.KOMAoption">396</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.KOMAoption">437</a>, <a href="scrguien.pdf#desc:maincls.cmd.KOMAoption">54</a></li>
+<li><a name="cmd.KOMAoptions"></a><a href="#cmd.KOMAoptions">\KOMAoptions</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.KOMAoptions">158</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.KOMAoptions">237</a>, <a href="scrguien.pdf#desc:scrextend.cmd.KOMAoptions">275</a>, <a href="scrguien.pdf#desc:scrjura.cmd.KOMAoptions">295</a>, <a href="scrguien.pdf#desc:typearea.cmd.KOMAoptions">32</a>, <a href="scrguien.pdf#desc:scrhack.cmd.KOMAoptions">392</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.KOMAoptions">396</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.KOMAoptions">437</a>, <a href="scrguien.pdf#desc:maincls.cmd.KOMAoptions">54</a></li>
+<li><a name="cmd.LastName"></a><a href="#cmd.LastName">\LastName</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.LastName">270</a></li>
+<li><a name="cmd.LastTOCLevelWasHigher"></a><a href="#cmd.LastTOCLevelWasHigher">\LastTOCLevelWasHigher</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.LastTOCLevelWasHigher">379</a></li>
+<li><a name="cmd.LastTOCLevelWasLower"></a><a href="#cmd.LastTOCLevelWasLower">\LastTOCLevelWasLower</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.LastTOCLevelWasLower">379</a></li>
+<li><a name="cmd.LastTOCLevelWasSame"></a><a href="#cmd.LastTOCLevelWasSame">\LastTOCLevelWasSame</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.LastTOCLevelWasSame">379</a></li>
+<li><a name="cmd.LenToUnit"></a><a href="#cmd.LenToUnit">\LenToUnit</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.LenToUnit">407</a></li>
+<li><a name="cmd.LoadLetterOption"></a><a href="#cmd.LoadLetterOption">\LoadLetterOption</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.LoadLetterOption">226</a></li>
+<li><a name="cmd.LoadLetterOptions"></a><a href="#cmd.LoadLetterOptions">\LoadLetterOptions</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.LoadLetterOptions">226</a></li>
+<li><a name="cmd.MakeMarkcase"></a><a href="#cmd.MakeMarkcase">\MakeMarkcase</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.MakeMarkcase">254</a>, <a href="scrguien.pdf#desc:tocbasic.cmd.MakeMarkcase">364</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.MakeMarkcase">420</a></li>
+<li><a name="cmd.ModifyLayer"></a><a href="#cmd.ModifyLayer">\ModifyLayer</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.ModifyLayer">399</a></li>
+<li><a name="cmd.ModifyLayerPageStyleOptions"></a><a href="#cmd.ModifyLayerPageStyleOptions">\ModifyLayerPageStyleOptions</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.ModifyLayerPageStyleOptions">416</a></li>
+<li><a name="cmd.Name"></a><a href="#cmd.Name">\Name</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.Name">270</a></li>
+<li><a name="cmd.PreventPackageFromLoading*"></a><a href="#cmd.PreventPackageFromLoading*">\PreventPackageFromLoading*</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.PreventPackageFromLoading*">349</a></li>
+<li><a name="cmd.PreventPackageFromLoading"></a><a href="#cmd.PreventPackageFromLoading">\PreventPackageFromLoading</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.PreventPackageFromLoading">349</a></li>
+<li><a name="cmd.ProvideLayer"></a><a href="#cmd.ProvideLayer">\ProvideLayer</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.ProvideLayer">399</a></li>
+<li><a name="cmd.ProvideNoteColumn"></a><a href="#cmd.ProvideNoteColumn">\ProvideNoteColumn</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.ProvideNoteColumn">440</a></li>
+<li><a name="cmd.ProvidePageStyleAlias"></a><a href="#cmd.ProvidePageStyleAlias">\ProvidePageStyleAlias</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.ProvidePageStyleAlias">410</a></li>
+<li><a name="cmd.ProvidePageStyleByLayers"></a><a href="#cmd.ProvidePageStyleByLayers">\ProvidePageStyleByLayers</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.ProvidePageStyleByLayers">411</a></li>
+<li><a name="cmd.ProvideSectionCommand"></a><a href="#cmd.ProvideSectionCommand">\ProvideSectionCommand</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.ProvideSectionCommand">458</a></li>
+<li><a name="cmd.ProvideSectionCommands"></a><a href="#cmd.ProvideSectionCommands">\ProvideSectionCommands</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.ProvideSectionCommands">467</a></li>
+<li><a name="cmd.RedeclareLayer"></a><a href="#cmd.RedeclareLayer">\RedeclareLayer</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.RedeclareLayer">399</a></li>
+<li><a name="cmd.RedeclareNoteColumn"></a><a href="#cmd.RedeclareNoteColumn">\RedeclareNoteColumn</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.RedeclareNoteColumn">440</a></li>
+<li><a name="cmd.RedeclarePageStyleAlias"></a><a href="#cmd.RedeclarePageStyleAlias">\RedeclarePageStyleAlias</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.RedeclarePageStyleAlias">410</a></li>
+<li><a name="cmd.RedeclarePageStyleByLayers"></a><a href="#cmd.RedeclarePageStyleByLayers">\RedeclarePageStyleByLayers</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.RedeclarePageStyleByLayers">411</a></li>
+<li><a name="cmd.RedeclareSectionCommand"></a><a href="#cmd.RedeclareSectionCommand">\RedeclareSectionCommand</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.RedeclareSectionCommand">458</a></li>
+<li><a name="cmd.RedeclareSectionCommands"></a><a href="#cmd.RedeclareSectionCommands">\RedeclareSectionCommands</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.RedeclareSectionCommands">467</a></li>
+<li><a name="cmd.RelaxFamilyKey"></a><a href="#cmd.RelaxFamilyKey">\RelaxFamilyKey</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.RelaxFamilyKey">320</a></li>
+<li><a name="cmd.RemoveLayersFromPageStyle"></a><a href="#cmd.RemoveLayersFromPageStyle">\RemoveLayersFromPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.RemoveLayersFromPageStyle">415</a></li>
+<li><a name="cmd.ReplaceClass"></a><a href="#cmd.ReplaceClass">\ReplaceClass</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.ReplaceClass">347</a></li>
+<li><a name="cmd.ReplaceInput"></a><a href="#cmd.ReplaceInput">\ReplaceInput</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.ReplaceInput">346</a></li>
+<li><a name="cmd.ReplacePackage"></a><a href="#cmd.ReplacePackage">\ReplacePackage</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.ReplacePackage">347</a></li>
+<li><a name="cmd.ResetPreventPackageFromLoading"></a><a href="#cmd.ResetPreventPackageFromLoading">\ResetPreventPackageFromLoading</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.ResetPreventPackageFromLoading">350</a></li>
+<li><a name="cmd.SecDef"></a><a href="#cmd.SecDef">\SecDef</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.SecDef">474</a></li>
+<li><a name="cmd.Sentence"></a><a href="#cmd.Sentence">\Sentence</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.Sentence">303</a></li>
+<li><a name="cmd.StorePreventPackageFromLoading"></a><a href="#cmd.StorePreventPackageFromLoading">\StorePreventPackageFromLoading</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.StorePreventPackageFromLoading">350</a></li>
+<li><a name="cmd.SubClause"></a><a href="#cmd.SubClause">\SubClause</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.SubClause">298</a></li>
+<li><a name="cmd.TOCEntryStyleInitCode"></a><a href="#cmd.TOCEntryStyleInitCode">\TOCEntryStyleInitCode</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.TOCEntryStyleInitCode">378</a></li>
+<li><a name="cmd.TOCEntryStyleStartInitCode"></a><a href="#cmd.TOCEntryStyleStartInitCode">\TOCEntryStyleStartInitCode</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.TOCEntryStyleStartInitCode">378</a></li>
+<li><a name="cmd.TOCLineLeaderFill"></a><a href="#cmd.TOCLineLeaderFill">\TOCLineLeaderFill</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.TOCLineLeaderFill">379</a></li>
+<li><a name="cmd.TOCclone"></a><a href="#cmd.TOCclone">\TOCclone</a> --&gt; <a href="scrguien.pdf#desc:scrwfile.cmd.TOCclone">353</a></li>
+<li><a name="cmd.Telephone"></a><a href="#cmd.Telephone">\Telephone</a> --&gt; <a href="scrguien.pdf#desc:scraddr.cmd.Telephone">270</a></li>
+<li><a name="cmd.UnPreventPackageFromLoading*"></a><a href="#cmd.UnPreventPackageFromLoading*">\UnPreventPackageFromLoading*</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.UnPreventPackageFromLoading*">351</a></li>
+<li><a name="cmd.UnPreventPackageFromLoading"></a><a href="#cmd.UnPreventPackageFromLoading">\UnPreventPackageFromLoading</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.UnPreventPackageFromLoading">351</a></li>
+<li><a name="cmd.UnReplaceClass"></a><a href="#cmd.UnReplaceClass">\UnReplaceClass</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.UnReplaceClass">349</a></li>
+<li><a name="cmd.UnReplaceInput"></a><a href="#cmd.UnReplaceInput">\UnReplaceInput</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.UnReplaceInput">349</a></li>
+<li><a name="cmd.UnReplacePackage"></a><a href="#cmd.UnReplacePackage">\UnReplacePackage</a> --&gt; <a href="scrguien.pdf#desc:scrlfile.cmd.UnReplacePackage">349</a></li>
+<li><a name="cmd.UnifyLayersAtPageStyle"></a><a href="#cmd.UnifyLayersAtPageStyle">\UnifyLayersAtPageStyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.UnifyLayersAtPageStyle">416</a></li>
+<li><a name="cmd.XdivY"></a><a href="#cmd.XdivY">\XdivY</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.XdivY">340</a></li>
+<li><a name="cmd.XmodY"></a><a href="#cmd.XmodY">\XmodY</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.XmodY">340</a></li>
+<li><a name="cmd.activateareas"></a><a href="#cmd.activateareas">\activateareas</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.activateareas">450</a></li>
+<li><a name="cmd.addchap*"></a><a href="#cmd.addchap*">\addchap*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.addchap*">105</a></li>
+<li><a name="cmd.addchap"></a><a href="#cmd.addchap">\addchap</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.addchap">105</a></li>
+<li><a name="cmd.addchapmark"></a><a href="#cmd.addchapmark">\addchapmark</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.addchapmark">111</a></li>
+<li><a name="cmd.addchaptertocentry"></a><a href="#cmd.addchaptertocentry">\addchaptertocentry</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addchaptertocentry">455</a></li>
+<li><a name="cmd.addcontentslinetoeachtocfile"></a><a href="#cmd.addcontentslinetoeachtocfile">\addcontentslinetoeachtocfile</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.addcontentslinetoeachtocfile">361</a></li>
+<li><a name="cmd.addparagraphtocentry"></a><a href="#cmd.addparagraphtocentry">\addparagraphtocentry</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addparagraphtocentry">455</a></li>
+<li><a name="cmd.addpart*"></a><a href="#cmd.addpart*">\addpart*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.addpart*">105</a></li>
+<li><a name="cmd.addpart"></a><a href="#cmd.addpart">\addpart</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.addpart">105</a></li>
+<li><a name="cmd.addparttocentry"></a><a href="#cmd.addparttocentry">\addparttocentry</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addparttocentry">455</a></li>
+<li><a name="cmd.addrchar"></a><a href="#cmd.addrchar">\addrchar</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.addrchar">234</a>, <a href="scrguien.pdf#desc:scraddr.cmd.addrchar">269</a></li>
+<li><a name="cmd.addrentry"></a><a href="#cmd.addrentry">\addrentry</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.addrentry">233</a>, <a href="scrguien.pdf#desc:scraddr.cmd.addrentry">269</a></li>
+<li><a name="cmd.addsec*"></a><a href="#cmd.addsec*">\addsec*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.addsec*">105</a></li>
+<li><a name="cmd.addsec"></a><a href="#cmd.addsec">\addsec</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.addsec">105</a></li>
+<li><a name="cmd.addsecmark"></a><a href="#cmd.addsecmark">\addsecmark</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.addsecmark">111</a></li>
+<li><a name="cmd.addsectiontocentry"></a><a href="#cmd.addsectiontocentry">\addsectiontocentry</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addsectiontocentry">455</a></li>
+<li><a name="cmd.addsubparagraphtocentry"></a><a href="#cmd.addsubparagraphtocentry">\addsubparagraphtocentry</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addsubparagraphtocentry">455</a></li>
+<li><a name="cmd.addsubsectiontocentry"></a><a href="#cmd.addsubsectiontocentry">\addsubsectiontocentry</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addsubsectiontocentry">455</a></li>
+<li><a name="cmd.addsubsubsectiontocentry"></a><a href="#cmd.addsubsubsectiontocentry">\addsubsubsectiontocentry</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addsubsubsectiontocentry">455</a></li>
+<li><a name="cmd.addtocentrydefault"></a><a href="#cmd.addtocentrydefault">\addtocentrydefault</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addtocentrydefault">454</a></li>
+<li><a name="cmd.addtoeachtocfile"></a><a href="#cmd.addtoeachtocfile">\addtoeachtocfile</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.addtoeachtocfile">360</a></li>
+<li><a name="cmd.addtokomafont"></a><a href="#cmd.addtokomafont">\addtokomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.addtokomafont">174</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.addtokomafont">239</a>, <a href="scrguien.pdf#desc:scrextend.cmd.addtokomafont">279</a>, <a href="scrguien.pdf#desc:scrjura.cmd.addtokomafont">295</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.addtokomafont">438</a>, <a href="scrguien.pdf#desc:maincls.cmd.addtokomafont">59</a></li>
+<li><a name="cmd.addtokomafontgobblelist"></a><a href="#cmd.addtokomafontgobblelist">\addtokomafontgobblelist</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addtokomafontgobblelist">456</a></li>
+<li><a name="cmd.addtokomafontonearglist"></a><a href="#cmd.addtokomafontonearglist">\addtokomafontonearglist</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addtokomafontonearglist">456</a></li>
+<li><a name="cmd.addtokomafontrelaxlist"></a><a href="#cmd.addtokomafontrelaxlist">\addtokomafontrelaxlist</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.addtokomafontrelaxlist">456</a></li>
+<li><a name="cmd.addtolengthplength"></a><a href="#cmd.addtolengthplength">\addtolengthplength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.addtolengthplength">157</a></li>
+<li><a name="cmd.addtoreffields"></a><a href="#cmd.addtoreffields">\addtoreffields</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.addtoreffields">494</a></li>
+<li><a name="cmd.addtotoclist"></a><a href="#cmd.addtotoclist">\addtotoclist</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.addtotoclist">357</a></li>
+<li><a name="cmd.addxcontentsline"></a><a href="#cmd.addxcontentsline">\addxcontentsline</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.addxcontentsline">361</a></li>
+<li><a name="cmd.addxcontentslinetoeachtocfile"></a><a href="#cmd.addxcontentslinetoeachtocfile">\addxcontentslinetoeachtocfile</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.addxcontentslinetoeachtocfile">361</a></li>
+<li><a name="cmd.adrchar"></a><a href="#cmd.adrchar">\adrchar</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.adrchar">234</a>, <a href="scrguien.pdf#desc:scraddr.cmd.adrchar">269</a></li>
+<li><a name="cmd.adrentry"></a><a href="#cmd.adrentry">\adrentry</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.adrentry">232</a>, <a href="scrguien.pdf#desc:scraddr.cmd.adrentry">269</a></li>
+<li><a name="cmd.aliaskomafont"></a><a href="#cmd.aliaskomafont">\aliaskomafont</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.aliaskomafont">456</a></li>
+<li><a name="cmd.and"></a><a href="#cmd.and">\and</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.and">283</a>, <a href="scrguien.pdf#desc:maincls.cmd.and">67</a></li>
+<li><a name="cmd.appendix"></a><a href="#cmd.appendix">\appendix</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.appendix">146</a></li>
+<li><a name="cmd.appendixmore"></a><a href="#cmd.appendixmore">\appendixmore</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.appendixmore">475</a></li>
+<li><a name="cmd.areaset"></a><a href="#cmd.areaset">\areaset</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.areaset">450</a>, <a href="scrguien.pdf#desc:typearea.cmd.areaset">46</a></li>
+<li><a name="cmd.author"></a><a href="#cmd.author">\author</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.author">283</a>, <a href="scrguien.pdf#desc:maincls.cmd.author">67</a></li>
+<li><a name="cmd.autodot"></a><a href="#cmd.autodot">\autodot</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.autodot">108</a></li>
+<li><a name="cmd.automark*"></a><a href="#cmd.automark*">\automark*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.automark*">251</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.automark*">418</a></li>
+<li><a name="cmd.automark"></a><a href="#cmd.automark">\automark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.automark">251</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.automark">418</a></li>
+<li><a name="cmd.backmatter"></a><a href="#cmd.backmatter">\backmatter</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.backmatter">93</a></li>
+<li><a name="cmd.bankname"></a><a href="#cmd.bankname">\bankname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.bankname">500</a></li>
+<li><a name="cmd.bib@beginhook"></a><a href="#cmd.bib@beginhook">\bib@beginhook</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.bib@beginhook">476</a></li>
+<li><a name="cmd.bib@endhook"></a><a href="#cmd.bib@endhook">\bib@endhook</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.bib@endhook">476</a></li>
+<li><a name="cmd.caption"></a><a href="#cmd.caption">\caption</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.caption">129</a></li>
+<li><a name="cmd.captionabove"></a><a href="#cmd.captionabove">\captionabove</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.captionabove">129</a></li>
+<li><a name="cmd.captionaboveof"></a><a href="#cmd.captionaboveof">\captionaboveof</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.captionaboveof">131</a></li>
+<li><a name="cmd.captionbelow"></a><a href="#cmd.captionbelow">\captionbelow</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.captionbelow">129</a></li>
+<li><a name="cmd.captionbelowof"></a><a href="#cmd.captionbelowof">\captionbelowof</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.captionbelowof">131</a></li>
+<li><a name="cmd.captionformat"></a><a href="#cmd.captionformat">\captionformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.captionformat">136</a></li>
+<li><a name="cmd.captionof"></a><a href="#cmd.captionof">\captionof</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.captionof">131</a></li>
+<li><a name="cmd.captionsUKenglish"></a><a href="#cmd.captionsUKenglish">\captionsUKenglish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsUKenglish">501</a></li>
+<li><a name="cmd.captionsUSenglish"></a><a href="#cmd.captionsUSenglish">\captionsUSenglish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsUSenglish">501</a></li>
+<li><a name="cmd.captionsacadian"></a><a href="#cmd.captionsacadian">\captionsacadian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsacadian">501</a></li>
+<li><a name="cmd.captionsamerican"></a><a href="#cmd.captionsamerican">\captionsamerican</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsamerican">501</a></li>
+<li><a name="cmd.captionsaustralien"></a><a href="#cmd.captionsaustralien">\captionsaustralien</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsaustralien">501</a></li>
+<li><a name="cmd.captionsaustrian"></a><a href="#cmd.captionsaustrian">\captionsaustrian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsaustrian">501</a></li>
+<li><a name="cmd.captionsbritish"></a><a href="#cmd.captionsbritish">\captionsbritish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsbritish">501</a></li>
+<li><a name="cmd.captionscanadian"></a><a href="#cmd.captionscanadian">\captionscanadian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionscanadian">501</a></li>
+<li><a name="cmd.captionscanadien"></a><a href="#cmd.captionscanadien">\captionscanadien</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionscanadien">501</a></li>
+<li><a name="cmd.captionscroatian"></a><a href="#cmd.captionscroatian">\captionscroatian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionscroatian">501</a></li>
+<li><a name="cmd.captionsczech"></a><a href="#cmd.captionsczech">\captionsczech</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsczech">501</a></li>
+<li><a name="cmd.captionsdutch"></a><a href="#cmd.captionsdutch">\captionsdutch</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsdutch">501</a></li>
+<li><a name="cmd.captionsenglish"></a><a href="#cmd.captionsenglish">\captionsenglish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsenglish">501</a></li>
+<li><a name="cmd.captionsfinnish"></a><a href="#cmd.captionsfinnish">\captionsfinnish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsfinnish">501</a></li>
+<li><a name="cmd.captionsfrancais"></a><a href="#cmd.captionsfrancais">\captionsfrancais</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsfrancais">501</a></li>
+<li><a name="cmd.captionsfrench"></a><a href="#cmd.captionsfrench">\captionsfrench</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsfrench">501</a></li>
+<li><a name="cmd.captionsgerman"></a><a href="#cmd.captionsgerman">\captionsgerman</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsgerman">501</a></li>
+<li><a name="cmd.captionsitalian"></a><a href="#cmd.captionsitalian">\captionsitalian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsitalian">501</a></li>
+<li><a name="cmd.captionsnaustrian"></a><a href="#cmd.captionsnaustrian">\captionsnaustrian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsnaustrian">501</a></li>
+<li><a name="cmd.captionsnewzealand"></a><a href="#cmd.captionsnewzealand">\captionsnewzealand</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsnewzealand">501</a></li>
+<li><a name="cmd.captionsngerman"></a><a href="#cmd.captionsngerman">\captionsngerman</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsngerman">501</a></li>
+<li><a name="cmd.captionsnorsk"></a><a href="#cmd.captionsnorsk">\captionsnorsk</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsnorsk">501</a></li>
+<li><a name="cmd.captionsnswissgerman"></a><a href="#cmd.captionsnswissgerman">\captionsnswissgerman</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsnswissgerman">501</a></li>
+<li><a name="cmd.captionspolish"></a><a href="#cmd.captionspolish">\captionspolish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionspolish">501</a></li>
+<li><a name="cmd.captionsslovak"></a><a href="#cmd.captionsslovak">\captionsslovak</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsslovak">501</a></li>
+<li><a name="cmd.captionsspanish"></a><a href="#cmd.captionsspanish">\captionsspanish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsspanish">501</a></li>
+<li><a name="cmd.captionsswedish"></a><a href="#cmd.captionsswedish">\captionsswedish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsswedish">501</a></li>
+<li><a name="cmd.captionsswissgerman"></a><a href="#cmd.captionsswissgerman">\captionsswissgerman</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.captionsswissgerman">501</a></li>
+<li><a name="cmd.cc"></a><a href="#cmd.cc">\cc</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cc">168</a></li>
+<li><a name="cmd.ccname"></a><a href="#cmd.ccname">\ccname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.ccname">500</a></li>
+<li><a name="cmd.cefoot*"></a><a href="#cmd.cefoot*">\cefoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cefoot*">247</a></li>
+<li><a name="cmd.cefoot"></a><a href="#cmd.cefoot">\cefoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cefoot">245</a></li>
+<li><a name="cmd.cehead*"></a><a href="#cmd.cehead*">\cehead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cehead*">244</a></li>
+<li><a name="cmd.cehead"></a><a href="#cmd.cehead">\cehead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cehead">242</a></li>
+<li><a name="cmd.cfoot*"></a><a href="#cmd.cfoot*">\cfoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cfoot*">249</a></li>
+<li><a name="cmd.cfoot"></a><a href="#cmd.cfoot">\cfoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cfoot">248</a></li>
+<li><a name="cmd.changefontsizes"></a><a href="#cmd.changefontsizes">\changefontsizes</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.changefontsizes">455</a></li>
+<li><a name="cmd.chapapp"></a><a href="#cmd.chapapp">\chapapp</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chapapp">110</a></li>
+<li><a name="cmd.chapappifchapterprefix"></a><a href="#cmd.chapappifchapterprefix">\chapappifchapterprefix</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chapappifchapterprefix">110</a></li>
+<li><a name="cmd.chapter*"></a><a href="#cmd.chapter*">\chapter*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chapter*">104</a></li>
+<li><a name="cmd.chapter"></a><a href="#cmd.chapter">\chapter</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chapter">100</a></li>
+<li><a name="cmd.chapterformat"></a><a href="#cmd.chapterformat">\chapterformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chapterformat">108</a></li>
+<li><a name="cmd.chapterheadendvskip"></a><a href="#cmd.chapterheadendvskip">\chapterheadendvskip</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.chapterheadendvskip">468</a></li>
+<li><a name="cmd.chapterheadmidvskip"></a><a href="#cmd.chapterheadmidvskip">\chapterheadmidvskip</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.chapterheadmidvskip">468</a></li>
+<li><a name="cmd.chapterheadstartvskip"></a><a href="#cmd.chapterheadstartvskip">\chapterheadstartvskip</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.chapterheadstartvskip">468</a></li>
+<li><a name="cmd.chapterlinesformat"></a><a href="#cmd.chapterlinesformat">\chapterlinesformat</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.chapterlinesformat">471</a></li>
+<li><a name="cmd.chapterlineswithprefixformat"></a><a href="#cmd.chapterlineswithprefixformat">\chapterlineswithprefixformat</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.chapterlineswithprefixformat">471</a></li>
+<li><a name="cmd.chaptermark"></a><a href="#cmd.chaptermark">\chaptermark</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chaptermark">111</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.chaptermark">257</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.chaptermark">421</a></li>
+<li><a name="cmd.chaptermarkformat"></a><a href="#cmd.chaptermarkformat">\chaptermarkformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chaptermarkformat">111</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.chaptermarkformat">256</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.chaptermarkformat">421</a></li>
+<li><a name="cmd.chapternumdepth"></a><a href="#cmd.chapternumdepth">\chapternumdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chapternumdepth">112</a></li>
+<li><a name="cmd.chapterpagestyle"></a><a href="#cmd.chapterpagestyle">\chapterpagestyle</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.chapterpagestyle">83</a></li>
+<li><a name="cmd.chead*"></a><a href="#cmd.chead*">\chead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.chead*">249</a></li>
+<li><a name="cmd.chead"></a><a href="#cmd.chead">\chead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.chead">248</a></li>
+<li><a name="cmd.cleardoubleemptypage"></a><a href="#cmd.cleardoubleemptypage">\cleardoubleemptypage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleemptypage">215</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleemptypage">287</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleemptypage">87</a></li>
+<li><a name="cmd.cleardoubleevenemptypage"></a><a href="#cmd.cleardoubleevenemptypage">\cleardoubleevenemptypage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleevenemptypage">215</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleevenemptypage">287</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleevenemptypage">87</a></li>
+<li><a name="cmd.cleardoubleevenpage"></a><a href="#cmd.cleardoubleevenpage">\cleardoubleevenpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleevenpage">215</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleevenpage">287</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleevenpage">87</a></li>
+<li><a name="cmd.cleardoubleevenpageusingstyle"></a><a href="#cmd.cleardoubleevenpageusingstyle">\cleardoubleevenpageusingstyle</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleevenpageusingstyle">215</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleevenpageusingstyle">287</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleevenpageusingstyle">87</a></li>
+<li><a name="cmd.cleardoubleevenplainpage"></a><a href="#cmd.cleardoubleevenplainpage">\cleardoubleevenplainpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleevenplainpage">215</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleevenplainpage">287</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleevenplainpage">87</a></li>
+<li><a name="cmd.cleardoubleevenstandardpage"></a><a href="#cmd.cleardoubleevenstandardpage">\cleardoubleevenstandardpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleevenstandardpage">215</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleevenstandardpage">287</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleevenstandardpage">87</a></li>
+<li><a name="cmd.cleardoubleoddemptypage"></a><a href="#cmd.cleardoubleoddemptypage">\cleardoubleoddemptypage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleoddemptypage">215</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleoddemptypage">287</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleoddemptypage">87</a></li>
+<li><a name="cmd.cleardoubleoddpage"></a><a href="#cmd.cleardoubleoddpage">\cleardoubleoddpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleoddpage">215</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleoddpage">287</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleoddpage">87</a></li>
+<li><a name="cmd.cleardoubleoddpageusingstyle"></a><a href="#cmd.cleardoubleoddpageusingstyle">\cleardoubleoddpageusingstyle</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleoddpageusingstyle">215</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleoddpageusingstyle">287</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleoddpageusingstyle">87</a></li>
+<li><a name="cmd.cleardoubleoddplainpage"></a><a href="#cmd.cleardoubleoddplainpage">\cleardoubleoddplainpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleoddplainpage">215</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleoddplainpage">287</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleoddplainpage">87</a></li>
+<li><a name="cmd.cleardoubleoddstandardpage"></a><a href="#cmd.cleardoubleoddstandardpage">\cleardoubleoddstandardpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleoddstandardpage">215</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleoddstandardpage">287</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleoddstandardpage">87</a></li>
+<li><a name="cmd.cleardoublepage"></a><a href="#cmd.cleardoublepage">\cleardoublepage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoublepage">215</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoublepage">287</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoublepage">87</a></li>
+<li><a name="cmd.cleardoublepageusingstyle"></a><a href="#cmd.cleardoublepageusingstyle">\cleardoublepageusingstyle</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoublepageusingstyle">215</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoublepageusingstyle">287</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoublepageusingstyle">87</a></li>
+<li><a name="cmd.cleardoubleplainpage"></a><a href="#cmd.cleardoubleplainpage">\cleardoubleplainpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoubleplainpage">215</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoubleplainpage">287</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoubleplainpage">87</a></li>
+<li><a name="cmd.cleardoublestandardpage"></a><a href="#cmd.cleardoublestandardpage">\cleardoublestandardpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.cleardoublestandardpage">215</a>, <a href="scrguien.pdf#desc:scrextend.cmd.cleardoublestandardpage">287</a>, <a href="scrguien.pdf#desc:maincls.cmd.cleardoublestandardpage">87</a></li>
+<li><a name="cmd.clearmainofpairofpagestyles"></a><a href="#cmd.clearmainofpairofpagestyles">\clearmainofpairofpagestyles</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.clearmainofpairofpagestyles">432</a></li>
+<li><a name="cmd.clearnotecolumn"></a><a href="#cmd.clearnotecolumn">\clearnotecolumn</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.clearnotecolumn">447</a></li>
+<li><a name="cmd.clearnotecolumns"></a><a href="#cmd.clearnotecolumns">\clearnotecolumns</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.clearnotecolumns">447</a></li>
+<li><a name="cmd.clearpage"></a><a href="#cmd.clearpage">\clearpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.clearpage">215</a>, <a href="scrguien.pdf#desc:scrextend.cmd.clearpage">287</a>, <a href="scrguien.pdf#desc:maincls.cmd.clearpage">87</a></li>
+<li><a name="cmd.clearpairofpagestyles"></a><a href="#cmd.clearpairofpagestyles">\clearpairofpagestyles</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.clearpairofpagestyles">432</a></li>
+<li><a name="cmd.clearplainofpairofpagestyles"></a><a href="#cmd.clearplainofpairofpagestyles">\clearplainofpairofpagestyles</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.clearplainofpairofpagestyles">432</a></li>
+<li><a name="cmd.closing"></a><a href="#cmd.closing">\closing</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.closing">165</a></li>
+<li><a name="cmd.cofoot*"></a><a href="#cmd.cofoot*">\cofoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cofoot*">247</a></li>
+<li><a name="cmd.cofoot"></a><a href="#cmd.cofoot">\cofoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cofoot">245</a></li>
+<li><a name="cmd.cohead*"></a><a href="#cmd.cohead*">\cohead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cohead*">244</a></li>
+<li><a name="cmd.cohead"></a><a href="#cmd.cohead">\cohead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.cohead">242</a></li>
+<li><a name="cmd.coverpagebottommargin"></a><a href="#cmd.coverpagebottommargin">\coverpagebottommargin</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.coverpagebottommargin">281</a>, <a href="scrguien.pdf#desc:maincls.cmd.coverpagebottommargin">65</a></li>
+<li><a name="cmd.coverpageleftmargin"></a><a href="#cmd.coverpageleftmargin">\coverpageleftmargin</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.coverpageleftmargin">281</a>, <a href="scrguien.pdf#desc:maincls.cmd.coverpageleftmargin">65</a></li>
+<li><a name="cmd.coverpagerightmargin"></a><a href="#cmd.coverpagerightmargin">\coverpagerightmargin</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.coverpagerightmargin">281</a>, <a href="scrguien.pdf#desc:maincls.cmd.coverpagerightmargin">65</a></li>
+<li><a name="cmd.coverpagetopmargin"></a><a href="#cmd.coverpagetopmargin">\coverpagetopmargin</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.coverpagetopmargin">281</a>, <a href="scrguien.pdf#desc:maincls.cmd.coverpagetopmargin">65</a></li>
+<li><a name="cmd.currentpagestyle"></a><a href="#cmd.currentpagestyle">\currentpagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.currentpagestyle">409</a></li>
+<li><a name="cmd.customername"></a><a href="#cmd.customername">\customername</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.customername">500</a></li>
+<li><a name="cmd.date"></a><a href="#cmd.date">\date</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.date">283</a>, <a href="scrguien.pdf#desc:maincls.cmd.date">67</a></li>
+<li><a name="cmd.dateUKenglish"></a><a href="#cmd.dateUKenglish">\dateUKenglish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateUKenglish">502</a></li>
+<li><a name="cmd.dateUSenglish"></a><a href="#cmd.dateUSenglish">\dateUSenglish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateUSenglish">502</a></li>
+<li><a name="cmd.dateacadian"></a><a href="#cmd.dateacadian">\dateacadian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateacadian">502</a></li>
+<li><a name="cmd.dateamerican"></a><a href="#cmd.dateamerican">\dateamerican</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateamerican">502</a></li>
+<li><a name="cmd.dateaustralien"></a><a href="#cmd.dateaustralien">\dateaustralien</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateaustralien">502</a></li>
+<li><a name="cmd.dateaustrian"></a><a href="#cmd.dateaustrian">\dateaustrian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateaustrian">502</a></li>
+<li><a name="cmd.datebritish"></a><a href="#cmd.datebritish">\datebritish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datebritish">502</a></li>
+<li><a name="cmd.datecanadian"></a><a href="#cmd.datecanadian">\datecanadian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datecanadian">502</a></li>
+<li><a name="cmd.datecanadien"></a><a href="#cmd.datecanadien">\datecanadien</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datecanadien">502</a></li>
+<li><a name="cmd.datecroatian"></a><a href="#cmd.datecroatian">\datecroatian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datecroatian">502</a></li>
+<li><a name="cmd.dateczech"></a><a href="#cmd.dateczech">\dateczech</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateczech">502</a></li>
+<li><a name="cmd.datedutch"></a><a href="#cmd.datedutch">\datedutch</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datedutch">502</a></li>
+<li><a name="cmd.dateenglish"></a><a href="#cmd.dateenglish">\dateenglish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateenglish">502</a></li>
+<li><a name="cmd.datefinnish"></a><a href="#cmd.datefinnish">\datefinnish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datefinnish">502</a></li>
+<li><a name="cmd.datefrancais"></a><a href="#cmd.datefrancais">\datefrancais</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datefrancais">502</a></li>
+<li><a name="cmd.datefrench"></a><a href="#cmd.datefrench">\datefrench</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datefrench">502</a></li>
+<li><a name="cmd.dategerman"></a><a href="#cmd.dategerman">\dategerman</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dategerman">502</a></li>
+<li><a name="cmd.dateitalian"></a><a href="#cmd.dateitalian">\dateitalian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateitalian">502</a></li>
+<li><a name="cmd.datename"></a><a href="#cmd.datename">\datename</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datename">500</a></li>
+<li><a name="cmd.datenaustrian"></a><a href="#cmd.datenaustrian">\datenaustrian</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datenaustrian">502</a></li>
+<li><a name="cmd.datenewzealand"></a><a href="#cmd.datenewzealand">\datenewzealand</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datenewzealand">502</a></li>
+<li><a name="cmd.datengerman"></a><a href="#cmd.datengerman">\datengerman</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datengerman">502</a></li>
+<li><a name="cmd.datenorsk"></a><a href="#cmd.datenorsk">\datenorsk</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datenorsk">502</a></li>
+<li><a name="cmd.datenswissgerman"></a><a href="#cmd.datenswissgerman">\datenswissgerman</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datenswissgerman">502</a></li>
+<li><a name="cmd.datepolish"></a><a href="#cmd.datepolish">\datepolish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datepolish">502</a></li>
+<li><a name="cmd.dateslovak"></a><a href="#cmd.dateslovak">\dateslovak</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateslovak">502</a></li>
+<li><a name="cmd.datespanish"></a><a href="#cmd.datespanish">\datespanish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.datespanish">502</a></li>
+<li><a name="cmd.dateswedish"></a><a href="#cmd.dateswedish">\dateswedish</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateswedish">502</a></li>
+<li><a name="cmd.dateswissgerman"></a><a href="#cmd.dateswissgerman">\dateswissgerman</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.dateswissgerman">502</a></li>
+<li><a name="cmd.dedication"></a><a href="#cmd.dedication">\dedication</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.dedication">285</a>, <a href="scrguien.pdf#desc:maincls.cmd.dedication">70</a></li>
+<li><a name="cmd.defaultreffields"></a><a href="#cmd.defaultreffields">\defaultreffields</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.defaultreffields">494</a></li>
+<li><a name="cmd.defcaptionname*"></a><a href="#cmd.defcaptionname*">\defcaptionname*</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.defcaptionname*">336</a></li>
+<li><a name="cmd.defcaptionname"></a><a href="#cmd.defcaptionname">\defcaptionname</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.defcaptionname">336</a></li>
+<li><a name="cmd.deffootnote"></a><a href="#cmd.deffootnote">\deffootnote</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.deffootnote">218</a>, <a href="scrguien.pdf#desc:scrextend.cmd.deffootnote">289</a>, <a href="scrguien.pdf#desc:maincls.cmd.deffootnote">91</a></li>
+<li><a name="cmd.deffootnotemark"></a><a href="#cmd.deffootnotemark">\deffootnotemark</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.deffootnotemark">218</a>, <a href="scrguien.pdf#desc:scrextend.cmd.deffootnotemark">289</a>, <a href="scrguien.pdf#desc:maincls.cmd.deffootnotemark">91</a></li>
+<li><a name="cmd.defpagestyle"></a><a href="#cmd.defpagestyle">\defpagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.defpagestyle">432</a></li>
+<li><a name="cmd.defpairofpagestyles"></a><a href="#cmd.defpairofpagestyles">\defpairofpagestyles</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.defpairofpagestyles">431</a></li>
+<li><a name="cmd.deftocheading"></a><a href="#cmd.deftocheading">\deftocheading</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.deftocheading">364</a></li>
+<li><a name="cmd.dictum"></a><a href="#cmd.dictum">\dictum</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.dictum">115</a>, <a href="scrguien.pdf#desc:scrextend.cmd.dictum">291</a></li>
+<li><a name="cmd.dictumauthorformat"></a><a href="#cmd.dictumauthorformat">\dictumauthorformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.dictumauthorformat">115</a>, <a href="scrguien.pdf#desc:scrextend.cmd.dictumauthorformat">291</a></li>
+<li><a name="cmd.dictumrule"></a><a href="#cmd.dictumrule">\dictumrule</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.dictumrule">115</a>, <a href="scrguien.pdf#desc:scrextend.cmd.dictumrule">291</a></li>
+<li><a name="cmd.dictumwidth"></a><a href="#cmd.dictumwidth">\dictumwidth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.dictumwidth">115</a>, <a href="scrguien.pdf#desc:scrextend.cmd.dictumwidth">291</a></li>
+<li><a name="cmd.documentclass"></a><a href="#cmd.documentclass">\documentclass</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.documentclass">157</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.documentclass">237</a>, <a href="scrguien.pdf#desc:scrextend.cmd.documentclass">275</a>, <a href="scrguien.pdf#desc:scrjura.cmd.documentclass">294</a>, <a href="scrguien.pdf#desc:typearea.cmd.documentclass">31</a>, <a href="scrguien.pdf#desc:scrhack.cmd.documentclass">391</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.documentclass">395</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.documentclass">437</a>, <a href="scrguien.pdf#desc:maincls.cmd.documentclass">54</a></li>
+<li><a name="cmd.doforeachtocfile"></a><a href="#cmd.doforeachtocfile">\doforeachtocfile</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.doforeachtocfile">359</a></li>
+<li><a name="cmd.ellipsispar"></a><a href="#cmd.ellipsispar">\ellipsispar</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.ellipsispar">302</a></li>
+<li><a name="cmd.emailname"></a><a href="#cmd.emailname">\emailname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.emailname">500</a></li>
+<li><a name="cmd.encl"></a><a href="#cmd.encl">\encl</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.encl">170</a></li>
+<li><a name="cmd.enclname"></a><a href="#cmd.enclname">\enclname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.enclname">500</a></li>
+<li><a name="cmd.extratitle"></a><a href="#cmd.extratitle">\extratitle</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.extratitle">282</a>, <a href="scrguien.pdf#desc:maincls.cmd.extratitle">66</a></li>
+<li><a name="cmd.faxname"></a><a href="#cmd.faxname">\faxname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.faxname">500</a></li>
+<li><a name="cmd.figureformat"></a><a href="#cmd.figureformat">\figureformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.figureformat">137</a></li>
+<li><a name="cmd.flushbottom"></a><a href="#cmd.flushbottom">\flushbottom</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.flushbottom">57</a></li>
+<li><a name="cmd.footnote"></a><a href="#cmd.footnote">\footnote</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.footnote">217</a>, <a href="scrguien.pdf#desc:scrextend.cmd.footnote">289</a>, <a href="scrguien.pdf#desc:maincls.cmd.footnote">89</a></li>
+<li><a name="cmd.footnotemark"></a><a href="#cmd.footnotemark">\footnotemark</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.footnotemark">217</a>, <a href="scrguien.pdf#desc:scrextend.cmd.footnotemark">289</a>, <a href="scrguien.pdf#desc:maincls.cmd.footnotemark">89</a></li>
+<li><a name="cmd.footnotetext"></a><a href="#cmd.footnotetext">\footnotetext</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.footnotetext">217</a>, <a href="scrguien.pdf#desc:scrextend.cmd.footnotetext">289</a>, <a href="scrguien.pdf#desc:maincls.cmd.footnotetext">89</a></li>
+<li><a name="cmd.footref"></a><a href="#cmd.footref">\footref</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.footref">217</a>, <a href="scrguien.pdf#desc:scrextend.cmd.footref">289</a>, <a href="scrguien.pdf#desc:maincls.cmd.footref">90</a></li>
+<li><a name="cmd.frontispiece"></a><a href="#cmd.frontispiece">\frontispiece</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.frontispiece">282</a>, <a href="scrguien.pdf#desc:maincls.cmd.frontispiece">66</a></li>
+<li><a name="cmd.frontmatter"></a><a href="#cmd.frontmatter">\frontmatter</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.frontmatter">93</a></li>
+<li><a name="cmd.headfromname"></a><a href="#cmd.headfromname">\headfromname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.headfromname">500</a></li>
+<li><a name="cmd.headmark"></a><a href="#cmd.headmark">\headmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.headmark">255</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.headmark">420</a></li>
+<li><a name="cmd.headtoname"></a><a href="#cmd.headtoname">\headtoname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.headtoname">500</a></li>
+<li><a name="cmd.if@atdocument"></a><a href="#cmd.if@atdocument">\if@atdocument</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.if@atdocument">333</a></li>
+<li><a name="cmd.if@chapter"></a><a href="#cmd.if@chapter">\if@chapter</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.if@chapter">396</a></li>
+<li><a name="cmd.if@mainmatter"></a><a href="#cmd.if@mainmatter">\if@mainmatter</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.if@mainmatter">397</a></li>
+<li><a name="cmd.ifVTeX"></a><a href="#cmd.ifVTeX">\ifVTeX</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifVTeX">332</a></li>
+<li><a name="cmd.ifattoclist"></a><a href="#cmd.ifattoclist">\ifattoclist</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.ifattoclist">356</a></li>
+<li><a name="cmd.ifdimen"></a><a href="#cmd.ifdimen">\ifdimen</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifdimen">333</a></li>
+<li><a name="cmd.ifdvioutput"></a><a href="#cmd.ifdvioutput">\ifdvioutput</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifdvioutput">332</a></li>
+<li><a name="cmd.ifiscount"></a><a href="#cmd.ifiscount">\ifiscount</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifiscount">334</a></li>
+<li><a name="cmd.ifiscounter"></a><a href="#cmd.ifiscounter">\ifiscounter</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifiscounter">334</a></li>
+<li><a name="cmd.ifisdimen"></a><a href="#cmd.ifisdimen">\ifisdimen</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifisdimen">333</a></li>
+<li><a name="cmd.ifisdimension"></a><a href="#cmd.ifisdimension">\ifisdimension</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifisdimension">333</a></li>
+<li><a name="cmd.ifisdimexpr"></a><a href="#cmd.ifisdimexpr">\ifisdimexpr</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifisdimexpr">334</a></li>
+<li><a name="cmd.ifisglue"></a><a href="#cmd.ifisglue">\ifisglue</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifisglue">334</a></li>
+<li><a name="cmd.ifisglueexpr"></a><a href="#cmd.ifisglueexpr">\ifisglueexpr</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifisglueexpr">334</a></li>
+<li><a name="cmd.ifisinteger"></a><a href="#cmd.ifisinteger">\ifisinteger</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifisinteger">335</a></li>
+<li><a name="cmd.ifisnumexpr"></a><a href="#cmd.ifisnumexpr">\ifisnumexpr</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifisnumexpr">335</a></li>
+<li><a name="cmd.ifisskip"></a><a href="#cmd.ifisskip">\ifisskip</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifisskip">334</a></li>
+<li><a name="cmd.ifkomavar"></a><a href="#cmd.ifkomavar">\ifkomavar</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.ifkomavar">156</a></li>
+<li><a name="cmd.ifkomavarempty*"></a><a href="#cmd.ifkomavarempty*">\ifkomavarempty*</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.ifkomavarempty*">156</a>, <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.ifkomavarempty*">495</a></li>
+<li><a name="cmd.ifkomavarempty"></a><a href="#cmd.ifkomavarempty">\ifkomavarempty</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.ifkomavarempty">156</a>, <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.ifkomavarempty">495</a></li>
+<li><a name="cmd.ifnotundefined"></a><a href="#cmd.ifnotundefined">\ifnotundefined</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifnotundefined">331</a></li>
+<li><a name="cmd.ifnumber"></a><a href="#cmd.ifnumber">\ifnumber</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifnumber">335</a></li>
+<li><a name="cmd.ifnumbered"></a><a href="#cmd.ifnumbered">\ifnumbered</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.ifnumbered">112</a></li>
+<li><a name="cmd.ifoot*"></a><a href="#cmd.ifoot*">\ifoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.ifoot*">249</a></li>
+<li><a name="cmd.ifoot"></a><a href="#cmd.ifoot">\ifoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.ifoot">248</a></li>
+<li><a name="cmd.ifpdfoutput"></a><a href="#cmd.ifpdfoutput">\ifpdfoutput</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifpdfoutput">332</a></li>
+<li><a name="cmd.ifpdftex"></a><a href="#cmd.ifpdftex">\ifpdftex</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifpdftex">332</a></li>
+<li><a name="cmd.ifpsoutput"></a><a href="#cmd.ifpsoutput">\ifpsoutput</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifpsoutput">332</a></li>
+<li><a name="cmd.ifstr"></a><a href="#cmd.ifstr">\ifstr</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifstr">333</a></li>
+<li><a name="cmd.ifstrstart"></a><a href="#cmd.ifstrstart">\ifstrstart</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifstrstart">333</a></li>
+<li><a name="cmd.ifthispageodd"></a><a href="#cmd.ifthispageodd">\ifthispageodd</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.ifthispageodd">209</a>, <a href="scrguien.pdf#desc:scrextend.cmd.ifthispageodd">285</a>, <a href="scrguien.pdf#desc:maincls.cmd.ifthispageodd">79</a></li>
+<li><a name="cmd.iftocfeature"></a><a href="#cmd.iftocfeature">\iftocfeature</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.iftocfeature">367</a></li>
+<li><a name="cmd.ifundefinedorrelax"></a><a href="#cmd.ifundefinedorrelax">\ifundefinedorrelax</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.ifundefinedorrelax">331</a></li>
+<li><a name="cmd.ifunnumbered"></a><a href="#cmd.ifunnumbered">\ifunnumbered</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.ifunnumbered">112</a></li>
+<li><a name="cmd.ihead*"></a><a href="#cmd.ihead*">\ihead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.ihead*">249</a></li>
+<li><a name="cmd.ihead"></a><a href="#cmd.ihead">\ihead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.ihead">248</a></li>
+<li><a name="cmd.indexpagestyle"></a><a href="#cmd.indexpagestyle">\indexpagestyle</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.indexpagestyle">83</a></li>
+<li><a name="cmd.invoicename"></a><a href="#cmd.invoicename">\invoicename</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.invoicename">500</a></li>
+<li><a name="cmd.item"></a><a href="#cmd.item">\item</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.item">117</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.item">220</a></li>
+<li><a name="cmd.labelenumi"></a><a href="#cmd.labelenumi">\labelenumi</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.labelenumi">118</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.labelenumi">220</a></li>
+<li><a name="cmd.labelenumii"></a><a href="#cmd.labelenumii">\labelenumii</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.labelenumii">118</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.labelenumii">220</a></li>
+<li><a name="cmd.labelenumiii"></a><a href="#cmd.labelenumiii">\labelenumiii</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.labelenumiii">118</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.labelenumiii">220</a></li>
+<li><a name="cmd.labelenumiv"></a><a href="#cmd.labelenumiv">\labelenumiv</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.labelenumiv">118</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.labelenumiv">220</a></li>
+<li><a name="cmd.labelitemi"></a><a href="#cmd.labelitemi">\labelitemi</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.labelitemi">117</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.labelitemi">220</a></li>
+<li><a name="cmd.labelitemii"></a><a href="#cmd.labelitemii">\labelitemii</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.labelitemii">117</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.labelitemii">220</a></li>
+<li><a name="cmd.labelitemiii"></a><a href="#cmd.labelitemiii">\labelitemiii</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.labelitemiii">117</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.labelitemiii">220</a></li>
+<li><a name="cmd.labelitemiv"></a><a href="#cmd.labelitemiv">\labelitemiv</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.labelitemiv">117</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.labelitemiv">220</a></li>
+<li><a name="cmd.layercontentsmeasure"></a><a href="#cmd.layercontentsmeasure">\layercontentsmeasure</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.layercontentsmeasure">408</a></li>
+<li><a name="cmd.layerhalign"></a><a href="#cmd.layerhalign">\layerhalign</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.layerhalign">406</a></li>
+<li><a name="cmd.layerheight"></a><a href="#cmd.layerheight">\layerheight</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.layerheight">406</a></li>
+<li><a name="cmd.layervalign"></a><a href="#cmd.layervalign">\layervalign</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.layervalign">406</a></li>
+<li><a name="cmd.layerwidth"></a><a href="#cmd.layerwidth">\layerwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.layerwidth">406</a></li>
+<li><a name="cmd.layerxoffset"></a><a href="#cmd.layerxoffset">\layerxoffset</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.layerxoffset">406</a></li>
+<li><a name="cmd.layeryoffset"></a><a href="#cmd.layeryoffset">\layeryoffset</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.layeryoffset">406</a></li>
+<li><a name="cmd.lefoot*"></a><a href="#cmd.lefoot*">\lefoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.lefoot*">247</a></li>
+<li><a name="cmd.lefoot"></a><a href="#cmd.lefoot">\lefoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.lefoot">245</a></li>
+<li><a name="cmd.leftbotmark"></a><a href="#cmd.leftbotmark">\leftbotmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.leftbotmark">423</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.leftbotmark">429</a></li>
+<li><a name="cmd.leftfirstmark"></a><a href="#cmd.leftfirstmark">\leftfirstmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.leftfirstmark">423</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.leftfirstmark">429</a></li>
+<li><a name="cmd.leftmark"></a><a href="#cmd.leftmark">\leftmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.leftmark">255</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.leftmark">420</a></li>
+<li><a name="cmd.lefttopmark"></a><a href="#cmd.lefttopmark">\lefttopmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.lefttopmark">423</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.lefttopmark">429</a></li>
+<li><a name="cmd.lehead*"></a><a href="#cmd.lehead*">\lehead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.lehead*">244</a></li>
+<li><a name="cmd.lehead"></a><a href="#cmd.lehead">\lehead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.lehead">242</a></li>
+<li><a name="cmd.letterlastpage"></a><a href="#cmd.letterlastpage">\letterlastpage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.letterlastpage">164</a></li>
+<li><a name="cmd.letterpagestyle"></a><a href="#cmd.letterpagestyle">\letterpagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.letterpagestyle">210</a></li>
+<li><a name="cmd.listof/extension/name"></a><a href="#cmd.listof/extension/name">\listof/extension/name</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.listof/extension/name">362</a></li>
+<li><a name="cmd.listofeachtoc"></a><a href="#cmd.listofeachtoc">\listofeachtoc</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.listofeachtoc">362</a></li>
+<li><a name="cmd.listoffigures"></a><a href="#cmd.listoffigures">\listoffigures</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.listoffigures">144</a></li>
+<li><a name="cmd.listoftables"></a><a href="#cmd.listoftables">\listoftables</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.listoftables">144</a></li>
+<li><a name="cmd.listoftoc*"></a><a href="#cmd.listoftoc*">\listoftoc*</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.listoftoc*">362</a></li>
+<li><a name="cmd.listoftoc"></a><a href="#cmd.listoftoc">\listoftoc</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.listoftoc">362</a></li>
+<li><a name="cmd.lofoot*"></a><a href="#cmd.lofoot*">\lofoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.lofoot*">247</a></li>
+<li><a name="cmd.lofoot"></a><a href="#cmd.lofoot">\lofoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.lofoot">245</a></li>
+<li><a name="cmd.lohead*"></a><a href="#cmd.lohead*">\lohead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.lohead*">244</a></li>
+<li><a name="cmd.lohead"></a><a href="#cmd.lohead">\lohead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.lohead">242</a></li>
+<li><a name="cmd.lowertitleback"></a><a href="#cmd.lowertitleback">\lowertitleback</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.lowertitleback">284</a>, <a href="scrguien.pdf#desc:maincls.cmd.lowertitleback">70</a></li>
+<li><a name="cmd.mainmatter"></a><a href="#cmd.mainmatter">\mainmatter</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.mainmatter">93</a></li>
+<li><a name="cmd.makenote*"></a><a href="#cmd.makenote*">\makenote*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.makenote*">444</a></li>
+<li><a name="cmd.makenote"></a><a href="#cmd.makenote">\makenote</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.makenote">444</a></li>
+<li><a name="cmd.maketitle"></a><a href="#cmd.maketitle">\maketitle</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.maketitle">282</a>, <a href="scrguien.pdf#desc:maincls.cmd.maketitle">66</a></li>
+<li><a name="cmd.manualmark"></a><a href="#cmd.manualmark">\manualmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.manualmark">251</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.manualmark">418</a></li>
+<li><a name="cmd.marginline"></a><a href="#cmd.marginline">\marginline</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.marginline">145</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.marginline">223</a>, <a href="scrguien.pdf#desc:scrextend.cmd.marginline">293</a></li>
+<li><a name="cmd.marginpar"></a><a href="#cmd.marginpar">\marginpar</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.marginpar">145</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.marginpar">223</a>, <a href="scrguien.pdf#desc:scrextend.cmd.marginpar">293</a></li>
+<li><a name="cmd.markboth"></a><a href="#cmd.markboth">\markboth</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.markboth">214</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.markboth">257</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.markboth">422</a>, <a href="scrguien.pdf#desc:maincls.cmd.markboth">82</a></li>
+<li><a name="cmd.markleft"></a><a href="#cmd.markleft">\markleft</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.markleft">257</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.markleft">422</a></li>
+<li><a name="cmd.markright"></a><a href="#cmd.markright">\markright</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.markright">214</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.markright">257</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.markright">422</a>, <a href="scrguien.pdf#desc:maincls.cmd.markright">82</a></li>
+<li><a name="cmd.minisec"></a><a href="#cmd.minisec">\minisec</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.minisec">105</a></li>
+<li><a name="cmd.mobilephonename"></a><a href="#cmd.mobilephonename">\mobilephonename</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.mobilephonename">500</a></li>
+<li><a name="cmd.multfootsep"></a><a href="#cmd.multfootsep">\multfootsep</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.multfootsep">216</a>, <a href="scrguien.pdf#desc:scrextend.cmd.multfootsep">288</a>, <a href="scrguien.pdf#desc:maincls.cmd.multfootsep">89</a></li>
+<li><a name="cmd.multiplefootnoteseparator"></a><a href="#cmd.multiplefootnoteseparator">\multiplefootnoteseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.multiplefootnoteseparator">217</a>, <a href="scrguien.pdf#desc:scrextend.cmd.multiplefootnoteseparator">289</a>, <a href="scrguien.pdf#desc:maincls.cmd.multiplefootnoteseparator">89</a></li>
+<li><a name="cmd.myrefname"></a><a href="#cmd.myrefname">\myrefname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.myrefname">500</a></li>
+<li><a name="cmd.nameday"></a><a href="#cmd.nameday">\nameday</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.nameday">265</a></li>
+<li><a name="cmd.newbibstyle"></a><a href="#cmd.newbibstyle">\newbibstyle</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.newbibstyle">476</a></li>
+<li><a name="cmd.newblock"></a><a href="#cmd.newblock">\newblock</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.newblock">476</a></li>
+<li><a name="cmd.newcaptionname*"></a><a href="#cmd.newcaptionname*">\newcaptionname*</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.newcaptionname*">336</a></li>
+<li><a name="cmd.newcaptionname"></a><a href="#cmd.newcaptionname">\newcaptionname</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.newcaptionname">336</a></li>
+<li><a name="cmd.newdaylanguage"></a><a href="#cmd.newdaylanguage">\newdaylanguage</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.newdaylanguage">265</a></li>
+<li><a name="cmd.newkomafont"></a><a href="#cmd.newkomafont">\newkomafont</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.newkomafont">456</a></li>
+<li><a name="cmd.newkomavar*"></a><a href="#cmd.newkomavar*">\newkomavar*</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.newkomavar*">494</a></li>
+<li><a name="cmd.newkomavar"></a><a href="#cmd.newkomavar">\newkomavar</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.newkomavar">494</a></li>
+<li><a name="cmd.newpagestyle"></a><a href="#cmd.newpagestyle">\newpagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.newpagestyle">432</a></li>
+<li><a name="cmd.newpairofpagestyles"></a><a href="#cmd.newpairofpagestyles">\newpairofpagestyles</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.newpairofpagestyles">431</a></li>
+<li><a name="cmd.nonumberline"></a><a href="#cmd.nonumberline">\nonumberline</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.nonumberline">381</a></li>
+<li><a name="cmd.numberline"></a><a href="#cmd.numberline">\numberline</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.numberline">368</a></li>
+<li><a name="cmd.ofoot*"></a><a href="#cmd.ofoot*">\ofoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.ofoot*">249</a></li>
+<li><a name="cmd.ofoot"></a><a href="#cmd.ofoot">\ofoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.ofoot">248</a></li>
+<li><a name="cmd.ohead*"></a><a href="#cmd.ohead*">\ohead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.ohead*">249</a></li>
+<li><a name="cmd.ohead"></a><a href="#cmd.ohead">\ohead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.ohead">248</a></li>
+<li><a name="cmd.opening"></a><a href="#cmd.opening">\opening</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.opening">165</a></li>
+<li><a name="cmd.othersectionlevelsformat"></a><a href="#cmd.othersectionlevelsformat">\othersectionlevelsformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.othersectionlevelsformat">108</a></li>
+<li><a name="cmd.pagemark"></a><a href="#cmd.pagemark">\pagemark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.pagemark">255</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.pagemark">420</a></li>
+<li><a name="cmd.pagename"></a><a href="#cmd.pagename">\pagename</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.pagename">500</a></li>
+<li><a name="cmd.pagenumbering"></a><a href="#cmd.pagenumbering">\pagenumbering</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.pagenumbering">84</a></li>
+<li><a name="cmd.pagestyle"></a><a href="#cmd.pagestyle">\pagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.pagestyle">211</a>, <a href="scrguien.pdf#desc:maincls.cmd.pagestyle">80</a></li>
+<li><a name="cmd.paragraph*"></a><a href="#cmd.paragraph*">\paragraph*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.paragraph*">104</a></li>
+<li><a name="cmd.paragraph"></a><a href="#cmd.paragraph">\paragraph</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.paragraph">100</a></li>
+<li><a name="cmd.paragraphformat"></a><a href="#cmd.paragraphformat">\paragraphformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.paragraphformat">108</a></li>
+<li><a name="cmd.paragraphmark"></a><a href="#cmd.paragraphmark">\paragraphmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.paragraphmark">257</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.paragraphmark">421</a></li>
+<li><a name="cmd.paragraphmarkformat"></a><a href="#cmd.paragraphmarkformat">\paragraphmarkformat</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.paragraphmarkformat">256</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.paragraphmarkformat">421</a></li>
+<li><a name="cmd.paragraphnumdepth"></a><a href="#cmd.paragraphnumdepth">\paragraphnumdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.paragraphnumdepth">112</a></li>
+<li><a name="cmd.paragraphtocdepth"></a><a href="#cmd.paragraphtocdepth">\paragraphtocdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.paragraphtocdepth">76</a></li>
+<li><a name="cmd.parellipsis"></a><a href="#cmd.parellipsis">\parellipsis</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.parellipsis">302</a></li>
+<li><a name="cmd.parformat"></a><a href="#cmd.parformat">\parformat</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.parformat">302</a></li>
+<li><a name="cmd.parformatseparation"></a><a href="#cmd.parformatseparation">\parformatseparation</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.parformatseparation">302</a></li>
+<li><a name="cmd.parname"></a><a href="#cmd.parname">\parname</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.parname">309</a></li>
+<li><a name="cmd.parshortname"></a><a href="#cmd.parshortname">\parshortname</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.parshortname">309</a></li>
+<li><a name="cmd.part*"></a><a href="#cmd.part*">\part*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.part*">104</a></li>
+<li><a name="cmd.part"></a><a href="#cmd.part">\part</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.part">100</a></li>
+<li><a name="cmd.partformat"></a><a href="#cmd.partformat">\partformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.partformat">108</a></li>
+<li><a name="cmd.partheademptypage"></a><a href="#cmd.partheademptypage">\partheademptypage</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.partheademptypage">468</a></li>
+<li><a name="cmd.partheadendvskip"></a><a href="#cmd.partheadendvskip">\partheadendvskip</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.partheadendvskip">468</a></li>
+<li><a name="cmd.partheadmidvskip"></a><a href="#cmd.partheadmidvskip">\partheadmidvskip</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.partheadmidvskip">468</a></li>
+<li><a name="cmd.partheadstartvskip"></a><a href="#cmd.partheadstartvskip">\partheadstartvskip</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.partheadstartvskip">468</a></li>
+<li><a name="cmd.partlineswithprefixformat"></a><a href="#cmd.partlineswithprefixformat">\partlineswithprefixformat</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.partlineswithprefixformat">469</a></li>
+<li><a name="cmd.partmark"></a><a href="#cmd.partmark">\partmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.partmark">257</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.partmark">421</a></li>
+<li><a name="cmd.partmarkformat"></a><a href="#cmd.partmarkformat">\partmarkformat</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.partmarkformat">256</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.partmarkformat">421</a></li>
+<li><a name="cmd.partnumdepth"></a><a href="#cmd.partnumdepth">\partnumdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.partnumdepth">112</a></li>
+<li><a name="cmd.partpagestyle"></a><a href="#cmd.partpagestyle">\partpagestyle</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.partpagestyle">83</a></li>
+<li><a name="cmd.parttocdepth"></a><a href="#cmd.parttocdepth">\parttocdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.parttocdepth">76</a></li>
+<li><a name="cmd.phonename"></a><a href="#cmd.phonename">\phonename</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.phonename">500</a></li>
+<li><a name="cmd.providecaptionname*"></a><a href="#cmd.providecaptionname*">\providecaptionname*</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.providecaptionname*">336</a></li>
+<li><a name="cmd.providecaptionname"></a><a href="#cmd.providecaptionname">\providecaptionname</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.providecaptionname">336</a></li>
+<li><a name="cmd.providepagestyle"></a><a href="#cmd.providepagestyle">\providepagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.providepagestyle">432</a></li>
+<li><a name="cmd.providepairofpagestyles"></a><a href="#cmd.providepairofpagestyles">\providepairofpagestyles</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.providepairofpagestyles">431</a></li>
+<li><a name="cmd.ps"></a><a href="#cmd.ps">\ps</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.ps">166</a></li>
+<li><a name="cmd.publishers"></a><a href="#cmd.publishers">\publishers</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.publishers">283</a>, <a href="scrguien.pdf#desc:maincls.cmd.publishers">67</a></li>
+<li><a name="cmd.putC"></a><a href="#cmd.putC">\putC</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.putC">407</a></li>
+<li><a name="cmd.putLL"></a><a href="#cmd.putLL">\putLL</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.putLL">407</a></li>
+<li><a name="cmd.putLR"></a><a href="#cmd.putLR">\putLR</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.putLR">407</a></li>
+<li><a name="cmd.putUL"></a><a href="#cmd.putUL">\putUL</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.putUL">407</a></li>
+<li><a name="cmd.putUR"></a><a href="#cmd.putUR">\putUR</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.putUR">407</a></li>
+<li><a name="cmd.raggedbottom"></a><a href="#cmd.raggedbottom">\raggedbottom</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.raggedbottom">57</a></li>
+<li><a name="cmd.raggedchapter"></a><a href="#cmd.raggedchapter">\raggedchapter</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.raggedchapter">107</a></li>
+<li><a name="cmd.raggedchapterentry"></a><a href="#cmd.raggedchapterentry">\raggedchapterentry</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.raggedchapterentry">455</a></li>
+<li><a name="cmd.raggeddictum"></a><a href="#cmd.raggeddictum">\raggeddictum</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.raggeddictum">115</a>, <a href="scrguien.pdf#desc:scrextend.cmd.raggeddictum">291</a></li>
+<li><a name="cmd.raggeddictumauthor"></a><a href="#cmd.raggeddictumauthor">\raggeddictumauthor</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.raggeddictumauthor">115</a>, <a href="scrguien.pdf#desc:scrextend.cmd.raggeddictumauthor">291</a></li>
+<li><a name="cmd.raggeddictumtext"></a><a href="#cmd.raggeddictumtext">\raggeddictumtext</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.raggeddictumtext">115</a>, <a href="scrguien.pdf#desc:scrextend.cmd.raggeddictumtext">291</a></li>
+<li><a name="cmd.raggedfootnote"></a><a href="#cmd.raggedfootnote">\raggedfootnote</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.raggedfootnote">219</a>, <a href="scrguien.pdf#desc:scrextend.cmd.raggedfootnote">290</a>, <a href="scrguien.pdf#desc:maincls.cmd.raggedfootnote">93</a></li>
+<li><a name="cmd.raggedpart"></a><a href="#cmd.raggedpart">\raggedpart</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.raggedpart">107</a></li>
+<li><a name="cmd.raggedsection"></a><a href="#cmd.raggedsection">\raggedsection</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.raggedsection">107</a></li>
+<li><a name="cmd.raggedsignature"></a><a href="#cmd.raggedsignature">\raggedsignature</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.raggedsignature">224</a></li>
+<li><a name="cmd.recalctypearea"></a><a href="#cmd.recalctypearea">\recalctypearea</a> --&gt; <a href="scrguien.pdf#desc:typearea.cmd.recalctypearea">40</a></li>
+<li><a name="cmd.ref"></a><a href="#cmd.ref">\ref</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.ref">304</a></li>
+<li><a name="cmd.refClause"></a><a href="#cmd.refClause">\refClause</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refClause">304</a></li>
+<li><a name="cmd.refClauseN"></a><a href="#cmd.refClauseN">\refClauseN</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refClauseN">304</a></li>
+<li><a name="cmd.refL"></a><a href="#cmd.refL">\refL</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refL">304</a></li>
+<li><a name="cmd.refN"></a><a href="#cmd.refN">\refN</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refN">304</a></li>
+<li><a name="cmd.refPar"></a><a href="#cmd.refPar">\refPar</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refPar">304</a></li>
+<li><a name="cmd.refParL"></a><a href="#cmd.refParL">\refParL</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refParL">304</a></li>
+<li><a name="cmd.refParN"></a><a href="#cmd.refParN">\refParN</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refParN">304</a></li>
+<li><a name="cmd.refParS"></a><a href="#cmd.refParS">\refParS</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refParS">304</a></li>
+<li><a name="cmd.refS"></a><a href="#cmd.refS">\refS</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refS">304</a></li>
+<li><a name="cmd.refSentence"></a><a href="#cmd.refSentence">\refSentence</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refSentence">304</a></li>
+<li><a name="cmd.refSentenceL"></a><a href="#cmd.refSentenceL">\refSentenceL</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refSentenceL">304</a></li>
+<li><a name="cmd.refSentenceN"></a><a href="#cmd.refSentenceN">\refSentenceN</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refSentenceN">304</a></li>
+<li><a name="cmd.refSentenceS"></a><a href="#cmd.refSentenceS">\refSentenceS</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.refSentenceS">304</a></li>
+<li><a name="cmd.refoot*"></a><a href="#cmd.refoot*">\refoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.refoot*">247</a></li>
+<li><a name="cmd.refoot"></a><a href="#cmd.refoot">\refoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.refoot">245</a></li>
+<li><a name="cmd.rehead*"></a><a href="#cmd.rehead*">\rehead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.rehead*">244</a></li>
+<li><a name="cmd.rehead"></a><a href="#cmd.rehead">\rehead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.rehead">242</a></li>
+<li><a name="cmd.removefromtoclist"></a><a href="#cmd.removefromtoclist">\removefromtoclist</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.removefromtoclist">359</a></li>
+<li><a name="cmd.removereffields"></a><a href="#cmd.removereffields">\removereffields</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.removereffields">494</a></li>
+<li><a name="cmd.renewcaptionname*"></a><a href="#cmd.renewcaptionname*">\renewcaptionname*</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.renewcaptionname*">336</a></li>
+<li><a name="cmd.renewcaptionname"></a><a href="#cmd.renewcaptionname">\renewcaptionname</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.renewcaptionname">336</a></li>
+<li><a name="cmd.renewpagestyle"></a><a href="#cmd.renewpagestyle">\renewpagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.renewpagestyle">432</a></li>
+<li><a name="cmd.renewpairofpagestyles"></a><a href="#cmd.renewpairofpagestyles">\renewpairofpagestyles</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.renewpairofpagestyles">431</a></li>
+<li><a name="cmd.rightbotmark"></a><a href="#cmd.rightbotmark">\rightbotmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.rightbotmark">423</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.rightbotmark">429</a></li>
+<li><a name="cmd.rightfirstmark"></a><a href="#cmd.rightfirstmark">\rightfirstmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.rightfirstmark">423</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.rightfirstmark">429</a></li>
+<li><a name="cmd.rightmark"></a><a href="#cmd.rightmark">\rightmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.rightmark">255</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.rightmark">420</a></li>
+<li><a name="cmd.righttopmark"></a><a href="#cmd.righttopmark">\righttopmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.righttopmark">423</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage-experts.cmd.righttopmark">429</a></li>
+<li><a name="cmd.rofoot*"></a><a href="#cmd.rofoot*">\rofoot*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.rofoot*">247</a></li>
+<li><a name="cmd.rofoot"></a><a href="#cmd.rofoot">\rofoot</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.rofoot">245</a></li>
+<li><a name="cmd.rohead*"></a><a href="#cmd.rohead*">\rohead*</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.rohead*">244</a></li>
+<li><a name="cmd.rohead"></a><a href="#cmd.rohead">\rohead</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.rohead">242</a></li>
+<li><a name="cmd.scr@ifVTeX"></a><a href="#cmd.scr@ifVTeX">\scr@ifVTeX</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.scr@ifVTeX">332</a></li>
+<li><a name="cmd.scr@ifdvioutput"></a><a href="#cmd.scr@ifdvioutput">\scr@ifdvioutput</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.scr@ifdvioutput">332</a></li>
+<li><a name="cmd.scr@ifluatex"></a><a href="#cmd.scr@ifluatex">\scr@ifluatex</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.scr@ifluatex">332</a></li>
+<li><a name="cmd.scr@ifpdfoutput"></a><a href="#cmd.scr@ifpdfoutput">\scr@ifpdfoutput</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.scr@ifpdfoutput">332</a></li>
+<li><a name="cmd.scr@ifpdftex"></a><a href="#cmd.scr@ifpdftex">\scr@ifpdftex</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.scr@ifpdftex">332</a></li>
+<li><a name="cmd.scr@ifpsoutput"></a><a href="#cmd.scr@ifpsoutput">\scr@ifpsoutput</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.scr@ifpsoutput">332</a></li>
+<li><a name="cmd.scr@ifundefinedorrelax"></a><a href="#cmd.scr@ifundefinedorrelax">\scr@ifundefinedorrelax</a> --&gt; <a href="scrguien.pdf#desc:scrbase.cmd.scr@ifundefinedorrelax">331</a></li>
+<li><a name="cmd.scr@startsection"></a><a href="#cmd.scr@startsection">\scr@startsection</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.scr@startsection">474</a></li>
+<li><a name="cmd.scrlayerAddCsToInterface"></a><a href="#cmd.scrlayerAddCsToInterface">\scrlayerAddCsToInterface</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.scrlayerAddCsToInterface">425</a></li>
+<li><a name="cmd.scrlayerAddToInterface"></a><a href="#cmd.scrlayerAddToInterface">\scrlayerAddToInterface</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.scrlayerAddToInterface">425</a></li>
+<li><a name="cmd.scrlayerInitInterface"></a><a href="#cmd.scrlayerInitInterface">\scrlayerInitInterface</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.scrlayerInitInterface">425</a></li>
+<li><a name="cmd.scrlayerOnAutoRemoveInterface"></a><a href="#cmd.scrlayerOnAutoRemoveInterface">\scrlayerOnAutoRemoveInterface</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.cmd.scrlayerOnAutoRemoveInterface">426</a></li>
+<li><a name="cmd.section*"></a><a href="#cmd.section*">\section*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.section*">104</a></li>
+<li><a name="cmd.section"></a><a href="#cmd.section">\section</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.section">100</a></li>
+<li><a name="cmd.sectioncatchphraseformat"></a><a href="#cmd.sectioncatchphraseformat">\sectioncatchphraseformat</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.sectioncatchphraseformat">473</a></li>
+<li><a name="cmd.sectionformat"></a><a href="#cmd.sectionformat">\sectionformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.sectionformat">108</a></li>
+<li><a name="cmd.sectionlinesformat"></a><a href="#cmd.sectionlinesformat">\sectionlinesformat</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.sectionlinesformat">473</a></li>
+<li><a name="cmd.sectionmark"></a><a href="#cmd.sectionmark">\sectionmark</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.sectionmark">111</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.sectionmark">257</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.sectionmark">421</a></li>
+<li><a name="cmd.sectionmarkformat"></a><a href="#cmd.sectionmarkformat">\sectionmarkformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.sectionmarkformat">111</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.sectionmarkformat">256</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.sectionmarkformat">421</a></li>
+<li><a name="cmd.sectionnumdepth"></a><a href="#cmd.sectionnumdepth">\sectionnumdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.sectionnumdepth">112</a></li>
+<li><a name="cmd.sectiontocdepth"></a><a href="#cmd.sectiontocdepth">\sectiontocdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.sectiontocdepth">76</a></li>
+<li><a name="cmd.sentencename"></a><a href="#cmd.sentencename">\sentencename</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.sentencename">309</a></li>
+<li><a name="cmd.sentenceshortname"></a><a href="#cmd.sentenceshortname">\sentenceshortname</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.sentenceshortname">309</a></li>
+<li><a name="cmd.setbibpreamble"></a><a href="#cmd.setbibpreamble">\setbibpreamble</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setbibpreamble">147</a></li>
+<li><a name="cmd.setcapdynwidth"></a><a href="#cmd.setcapdynwidth">\setcapdynwidth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setcapdynwidth">139</a></li>
+<li><a name="cmd.setcaphanging"></a><a href="#cmd.setcaphanging">\setcaphanging</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setcaphanging">137</a></li>
+<li><a name="cmd.setcapindent*"></a><a href="#cmd.setcapindent*">\setcapindent*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setcapindent*">137</a></li>
+<li><a name="cmd.setcapindent"></a><a href="#cmd.setcapindent">\setcapindent</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setcapindent">137</a></li>
+<li><a name="cmd.setcapmargin*"></a><a href="#cmd.setcapmargin*">\setcapmargin*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setcapmargin*">139</a></li>
+<li><a name="cmd.setcapmargin"></a><a href="#cmd.setcapmargin">\setcapmargin</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setcapmargin">139</a></li>
+<li><a name="cmd.setcaptionalignment"></a><a href="#cmd.setcaptionalignment">\setcaptionalignment</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setcaptionalignment">140</a></li>
+<li><a name="cmd.setcapwidth"></a><a href="#cmd.setcapwidth">\setcapwidth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setcapwidth">139</a></li>
+<li><a name="cmd.setchapterpreamble"></a><a href="#cmd.setchapterpreamble">\setchapterpreamble</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setchapterpreamble">113</a></li>
+<li><a name="cmd.setfootnoterule"></a><a href="#cmd.setfootnoterule">\setfootnoterule</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.setfootnoterule">218</a>, <a href="scrguien.pdf#desc:maincls.cmd.setfootnoterule">92</a></li>
+<li><a name="cmd.setindexpreamble"></a><a href="#cmd.setindexpreamble">\setindexpreamble</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setindexpreamble">149</a></li>
+<li><a name="cmd.setkomafont"></a><a href="#cmd.setkomafont">\setkomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.setkomafont">174</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.setkomafont">239</a>, <a href="scrguien.pdf#desc:scrextend.cmd.setkomafont">279</a>, <a href="scrguien.pdf#desc:scrjura.cmd.setkomafont">295</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.setkomafont">438</a>, <a href="scrguien.pdf#desc:maincls.cmd.setkomafont">59</a></li>
+<li><a name="cmd.setkomavar*"></a><a href="#cmd.setkomavar*">\setkomavar*</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.setkomavar*">155</a></li>
+<li><a name="cmd.setkomavar"></a><a href="#cmd.setkomavar">\setkomavar</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.setkomavar">155</a></li>
+<li><a name="cmd.setlengthtoplength"></a><a href="#cmd.setlengthtoplength">\setlengthtoplength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.setlengthtoplength">157</a></li>
+<li><a name="cmd.setparsizes"></a><a href="#cmd.setparsizes">\setparsizes</a> --&gt; <a href="scrguien.pdf#desc:maincls-experts.cmd.setparsizes">457</a></li>
+<li><a name="cmd.setpartpreamble"></a><a href="#cmd.setpartpreamble">\setpartpreamble</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.setpartpreamble">113</a></li>
+<li><a name="cmd.settime"></a><a href="#cmd.settime">\settime</a> --&gt; <a href="scrguien.pdf#desc:scrtime.cmd.settime">267</a></li>
+<li><a name="cmd.setuptoc"></a><a href="#cmd.setuptoc">\setuptoc</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.setuptoc">365</a></li>
+<li><a name="cmd.storeareas"></a><a href="#cmd.storeareas">\storeareas</a> --&gt; <a href="scrguien.pdf#desc:typearea-experts.cmd.storeareas">450</a></li>
+<li><a name="cmd.subject"></a><a href="#cmd.subject">\subject</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.subject">283</a>, <a href="scrguien.pdf#desc:maincls.cmd.subject">67</a></li>
+<li><a name="cmd.subjectname"></a><a href="#cmd.subjectname">\subjectname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.subjectname">500</a></li>
+<li><a name="cmd.subparagraph*"></a><a href="#cmd.subparagraph*">\subparagraph*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subparagraph*">104</a></li>
+<li><a name="cmd.subparagraph"></a><a href="#cmd.subparagraph">\subparagraph</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subparagraph">100</a></li>
+<li><a name="cmd.subparagraphformat"></a><a href="#cmd.subparagraphformat">\subparagraphformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subparagraphformat">108</a></li>
+<li><a name="cmd.subparagraphmark"></a><a href="#cmd.subparagraphmark">\subparagraphmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.subparagraphmark">257</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.subparagraphmark">421</a></li>
+<li><a name="cmd.subparagraphmarkformat"></a><a href="#cmd.subparagraphmarkformat">\subparagraphmarkformat</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.subparagraphmarkformat">256</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.subparagraphmarkformat">421</a></li>
+<li><a name="cmd.subparagraphnumdepth"></a><a href="#cmd.subparagraphnumdepth">\subparagraphnumdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subparagraphnumdepth">112</a></li>
+<li><a name="cmd.subparagraphtocdepth"></a><a href="#cmd.subparagraphtocdepth">\subparagraphtocdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subparagraphtocdepth">76</a></li>
+<li><a name="cmd.subsection*"></a><a href="#cmd.subsection*">\subsection*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsection*">104</a></li>
+<li><a name="cmd.subsection"></a><a href="#cmd.subsection">\subsection</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsection">100</a></li>
+<li><a name="cmd.subsectionformat"></a><a href="#cmd.subsectionformat">\subsectionformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsectionformat">108</a></li>
+<li><a name="cmd.subsectionmark"></a><a href="#cmd.subsectionmark">\subsectionmark</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsectionmark">111</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.subsectionmark">257</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.subsectionmark">421</a></li>
+<li><a name="cmd.subsectionmarkformat"></a><a href="#cmd.subsectionmarkformat">\subsectionmarkformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsectionmarkformat">111</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.subsectionmarkformat">256</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.subsectionmarkformat">421</a></li>
+<li><a name="cmd.subsectionnumdepth"></a><a href="#cmd.subsectionnumdepth">\subsectionnumdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsectionnumdepth">112</a></li>
+<li><a name="cmd.subsectiontocdepth"></a><a href="#cmd.subsectiontocdepth">\subsectiontocdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsectiontocdepth">76</a></li>
+<li><a name="cmd.subsubsection*"></a><a href="#cmd.subsubsection*">\subsubsection*</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsubsection*">104</a></li>
+<li><a name="cmd.subsubsection"></a><a href="#cmd.subsubsection">\subsubsection</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsubsection">100</a></li>
+<li><a name="cmd.subsubsectionformat"></a><a href="#cmd.subsubsectionformat">\subsubsectionformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsubsectionformat">108</a></li>
+<li><a name="cmd.subsubsectionmark"></a><a href="#cmd.subsubsectionmark">\subsubsectionmark</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.subsubsectionmark">257</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.subsubsectionmark">421</a></li>
+<li><a name="cmd.subsubsectionmarkformat"></a><a href="#cmd.subsubsectionmarkformat">\subsubsectionmarkformat</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.subsubsectionmarkformat">256</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.subsubsectionmarkformat">421</a></li>
+<li><a name="cmd.subsubsectionnumdepth"></a><a href="#cmd.subsubsectionnumdepth">\subsubsectionnumdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsubsectionnumdepth">112</a></li>
+<li><a name="cmd.subsubsectiontocdepth"></a><a href="#cmd.subsubsectiontocdepth">\subsubsectiontocdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.subsubsectiontocdepth">76</a></li>
+<li><a name="cmd.subtitle"></a><a href="#cmd.subtitle">\subtitle</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.subtitle">283</a>, <a href="scrguien.pdf#desc:maincls.cmd.subtitle">67</a></li>
+<li><a name="cmd.syncwithnotecolumn"></a><a href="#cmd.syncwithnotecolumn">\syncwithnotecolumn</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.syncwithnotecolumn">445</a></li>
+<li><a name="cmd.syncwithnotecolumns"></a><a href="#cmd.syncwithnotecolumns">\syncwithnotecolumns</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.syncwithnotecolumns">446</a></li>
+<li><a name="cmd.tableformat"></a><a href="#cmd.tableformat">\tableformat</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.tableformat">137</a></li>
+<li><a name="cmd.tableofcontents"></a><a href="#cmd.tableofcontents">\tableofcontents</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.tableofcontents">75</a></li>
+<li><a name="cmd.textsubscript"></a><a href="#cmd.textsubscript">\textsubscript</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.textsubscript">174</a>, <a href="scrguien.pdf#desc:scrextend.cmd.textsubscript">278</a>, <a href="scrguien.pdf#desc:maincls.cmd.textsubscript">58</a></li>
+<li><a name="cmd.textsuperscript"></a><a href="#cmd.textsuperscript">\textsuperscript</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.textsuperscript">174</a>, <a href="scrguien.pdf#desc:scrextend.cmd.textsuperscript">278</a>, <a href="scrguien.pdf#desc:maincls.cmd.textsuperscript">58</a></li>
+<li><a name="cmd.thanks"></a><a href="#cmd.thanks">\thanks</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.thanks">283</a>, <a href="scrguien.pdf#desc:maincls.cmd.thanks">67</a></li>
+<li><a name="cmd.theenumi"></a><a href="#cmd.theenumi">\theenumi</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.theenumi">118</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.theenumi">220</a></li>
+<li><a name="cmd.theenumii"></a><a href="#cmd.theenumii">\theenumii</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.theenumii">118</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.theenumii">220</a></li>
+<li><a name="cmd.theenumiii"></a><a href="#cmd.theenumiii">\theenumiii</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.theenumiii">118</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.theenumiii">220</a></li>
+<li><a name="cmd.theenumiv"></a><a href="#cmd.theenumiv">\theenumiv</a> --&gt; <a href="scrguien.pdf#desc:maincls.cmd.theenumiv">118</a>, <a href="scrguien.pdf#desc:scrlttr2.cmd.theenumiv">220</a></li>
+<li><a name="cmd.thefootnotemark"></a><a href="#cmd.thefootnotemark">\thefootnotemark</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.thefootnotemark">218</a>, <a href="scrguien.pdf#desc:scrextend.cmd.thefootnotemark">289</a>, <a href="scrguien.pdf#desc:maincls.cmd.thefootnotemark">91</a></li>
+<li><a name="cmd.thepar"></a><a href="#cmd.thepar">\thepar</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.thepar">302</a></li>
+<li><a name="cmd.thesentence"></a><a href="#cmd.thesentence">\thesentence</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.thesentence">303</a></li>
+<li><a name="cmd.thisletter"></a><a href="#cmd.thisletter">\thisletter</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.thisletter">164</a></li>
+<li><a name="cmd.thispagestyle"></a><a href="#cmd.thispagestyle">\thispagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.thispagestyle">211</a>, <a href="scrguien.pdf#desc:maincls.cmd.thispagestyle">80</a></li>
+<li><a name="cmd.thistime*"></a><a href="#cmd.thistime*">\thistime*</a> --&gt; <a href="scrguien.pdf#desc:scrtime.cmd.thistime*">267</a></li>
+<li><a name="cmd.thistime"></a><a href="#cmd.thistime">\thistime</a> --&gt; <a href="scrguien.pdf#desc:scrtime.cmd.thistime">267</a></li>
+<li><a name="cmd.title"></a><a href="#cmd.title">\title</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.title">283</a>, <a href="scrguien.pdf#desc:maincls.cmd.title">67</a></li>
+<li><a name="cmd.titlehead"></a><a href="#cmd.titlehead">\titlehead</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.titlehead">283</a>, <a href="scrguien.pdf#desc:maincls.cmd.titlehead">67</a></li>
+<li><a name="cmd.titlepagestyle"></a><a href="#cmd.titlepagestyle">\titlepagestyle</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.titlepagestyle">286</a>, <a href="scrguien.pdf#desc:maincls.cmd.titlepagestyle">83</a></li>
+<li><a name="cmd.tocbasic@/extension/@after@hook"></a><a href="#cmd.tocbasic@/extension/@after@hook">\tocbasic@/extension/@after@hook</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@/extension/@after@hook">381</a></li>
+<li><a name="cmd.tocbasic@/extension/@before@hook"></a><a href="#cmd.tocbasic@/extension/@before@hook">\tocbasic@/extension/@before@hook</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@/extension/@before@hook">381</a></li>
+<li><a name="cmd.tocbasic@@after@hook"></a><a href="#cmd.tocbasic@@after@hook">\tocbasic@@after@hook</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@@after@hook">380</a></li>
+<li><a name="cmd.tocbasic@@before@hook"></a><a href="#cmd.tocbasic@@before@hook">\tocbasic@@before@hook</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@@before@hook">380</a></li>
+<li><a name="cmd.tocbasic@DependOnPenaltyAndTOCLevel"></a><a href="#cmd.tocbasic@DependOnPenaltyAndTOCLevel">\tocbasic@DependOnPenaltyAndTOCLevel</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@DependOnPenaltyAndTOCLevel">381</a></li>
+<li><a name="cmd.tocbasic@SetPenaltyByTOCLevel"></a><a href="#cmd.tocbasic@SetPenaltyByTOCLevel">\tocbasic@SetPenaltyByTOCLevel</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@SetPenaltyByTOCLevel">381</a></li>
+<li><a name="cmd.tocbasic@addxcontentsline"></a><a href="#cmd.tocbasic@addxcontentsline">\tocbasic@addxcontentsline</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@addxcontentsline">381</a></li>
+<li><a name="cmd.tocbasic@extend@babel"></a><a href="#cmd.tocbasic@extend@babel">\tocbasic@extend@babel</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@extend@babel">379</a></li>
+<li><a name="cmd.tocbasic@listhead"></a><a href="#cmd.tocbasic@listhead">\tocbasic@listhead</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@listhead">381</a></li>
+<li><a name="cmd.tocbasic@listhead@/extension/"></a><a href="#cmd.tocbasic@listhead@/extension/">\tocbasic@listhead@/extension/</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@listhead@/extension/">381</a></li>
+<li><a name="cmd.tocbasic@starttoc"></a><a href="#cmd.tocbasic@starttoc">\tocbasic@starttoc</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasic@starttoc">380</a></li>
+<li><a name="cmd.tocbasicautomode"></a><a href="#cmd.tocbasicautomode">\tocbasicautomode</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.tocbasicautomode">360</a></li>
+<li><a name="cmd.todaysname"></a><a href="#cmd.todaysname">\todaysname</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.todaysname">264</a></li>
+<li><a name="cmd.todaysnumber"></a><a href="#cmd.todaysnumber">\todaysnumber</a> --&gt; <a href="scrguien.pdf#desc:scrdate.cmd.todaysnumber">264</a></li>
+<li><a name="cmd.typearea"></a><a href="#cmd.typearea">\typearea</a> --&gt; <a href="scrguien.pdf#desc:typearea.cmd.typearea">40</a></li>
+<li><a name="cmd.unsettoc"></a><a href="#cmd.unsettoc">\unsettoc</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.unsettoc">365</a></li>
+<li><a name="cmd.uppertitleback"></a><a href="#cmd.uppertitleback">\uppertitleback</a> --&gt; <a href="scrguien.pdf#desc:scrextend.cmd.uppertitleback">284</a>, <a href="scrguien.pdf#desc:maincls.cmd.uppertitleback">70</a></li>
+<li><a name="cmd.useencodingofkomafont"></a><a href="#cmd.useencodingofkomafont">\useencodingofkomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.useencodingofkomafont">177</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.useencodingofkomafont">241</a>, <a href="scrguien.pdf#desc:scrextend.cmd.useencodingofkomafont">280</a>, <a href="scrguien.pdf#desc:scrjura.cmd.useencodingofkomafont">296</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.useencodingofkomafont">439</a>, <a href="scrguien.pdf#desc:maincls.cmd.useencodingofkomafont">64</a></li>
+<li><a name="cmd.usefamilyofkomafont"></a><a href="#cmd.usefamilyofkomafont">\usefamilyofkomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.usefamilyofkomafont">177</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.usefamilyofkomafont">241</a>, <a href="scrguien.pdf#desc:scrextend.cmd.usefamilyofkomafont">280</a>, <a href="scrguien.pdf#desc:scrjura.cmd.usefamilyofkomafont">296</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.usefamilyofkomafont">439</a>, <a href="scrguien.pdf#desc:maincls.cmd.usefamilyofkomafont">64</a></li>
+<li><a name="cmd.usefontofkomafont"></a><a href="#cmd.usefontofkomafont">\usefontofkomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.usefontofkomafont">177</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.usefontofkomafont">241</a>, <a href="scrguien.pdf#desc:scrextend.cmd.usefontofkomafont">280</a>, <a href="scrguien.pdf#desc:scrjura.cmd.usefontofkomafont">296</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.usefontofkomafont">439</a>, <a href="scrguien.pdf#desc:maincls.cmd.usefontofkomafont">64</a></li>
+<li><a name="cmd.usekomafont"></a><a href="#cmd.usekomafont">\usekomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.usekomafont">174</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.usekomafont">239</a>, <a href="scrguien.pdf#desc:scrextend.cmd.usekomafont">279</a>, <a href="scrguien.pdf#desc:scrjura.cmd.usekomafont">295</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.usekomafont">438</a>, <a href="scrguien.pdf#desc:maincls.cmd.usekomafont">59</a></li>
+<li><a name="cmd.usekomavar*"></a><a href="#cmd.usekomavar*">\usekomavar*</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.usekomavar*">156</a>, <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.usekomavar*">494</a></li>
+<li><a name="cmd.usekomavar"></a><a href="#cmd.usekomavar">\usekomavar</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.usekomavar">156</a>, <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.usekomavar">494</a></li>
+<li><a name="cmd.usepackage"></a><a href="#cmd.usepackage">\usepackage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.usepackage">157</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.usepackage">237</a>, <a href="scrguien.pdf#desc:scrextend.cmd.usepackage">275</a>, <a href="scrguien.pdf#desc:scrjura.cmd.usepackage">294</a>, <a href="scrguien.pdf#desc:typearea.cmd.usepackage">31</a>, <a href="scrguien.pdf#desc:scrhack.cmd.usepackage">391</a>, <a href="scrguien.pdf#desc:scrlayer.cmd.usepackage">395</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.usepackage">437</a>, <a href="scrguien.pdf#desc:maincls.cmd.usepackage">54</a></li>
+<li><a name="cmd.useplength"></a><a href="#cmd.useplength">\useplength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.useplength">157</a></li>
+<li><a name="cmd.useseriesofkomafont"></a><a href="#cmd.useseriesofkomafont">\useseriesofkomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.useseriesofkomafont">177</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.useseriesofkomafont">241</a>, <a href="scrguien.pdf#desc:scrextend.cmd.useseriesofkomafont">280</a>, <a href="scrguien.pdf#desc:scrjura.cmd.useseriesofkomafont">296</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.useseriesofkomafont">439</a>, <a href="scrguien.pdf#desc:maincls.cmd.useseriesofkomafont">64</a></li>
+<li><a name="cmd.useshapeofkomafont"></a><a href="#cmd.useshapeofkomafont">\useshapeofkomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.useshapeofkomafont">177</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.useshapeofkomafont">241</a>, <a href="scrguien.pdf#desc:scrextend.cmd.useshapeofkomafont">280</a>, <a href="scrguien.pdf#desc:scrjura.cmd.useshapeofkomafont">296</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.useshapeofkomafont">439</a>, <a href="scrguien.pdf#desc:maincls.cmd.useshapeofkomafont">64</a></li>
+<li><a name="cmd.usesizeofkomafont"></a><a href="#cmd.usesizeofkomafont">\usesizeofkomafont</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.cmd.usesizeofkomafont">177</a>, <a href="scrguien.pdf#desc:scrlayer-scrpage.cmd.usesizeofkomafont">241</a>, <a href="scrguien.pdf#desc:scrextend.cmd.usesizeofkomafont">280</a>, <a href="scrguien.pdf#desc:scrjura.cmd.usesizeofkomafont">296</a>, <a href="scrguien.pdf#desc:scrlayer-notecolumn.cmd.usesizeofkomafont">439</a>, <a href="scrguien.pdf#desc:maincls.cmd.usesizeofkomafont">64</a></li>
+<li><a name="cmd.usetocbasicnumberline"></a><a href="#cmd.usetocbasicnumberline">\usetocbasicnumberline</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.cmd.usetocbasicnumberline">368</a></li>
+<li><a name="cmd.withoutparnumber"></a><a href="#cmd.withoutparnumber">\withoutparnumber</a> --&gt; <a href="scrguien.pdf#desc:scrjura.cmd.withoutparnumber">302</a></li>
+<li><a name="cmd.wwwname"></a><a href="#cmd.wwwname">\wwwname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.wwwname">500</a></li>
+<li><a name="cmd.yourmailname"></a><a href="#cmd.yourmailname">\yourmailname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.yourmailname">500</a></li>
+<li><a name="cmd.yourrefname"></a><a href="#cmd.yourrefname">\yourrefname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.cmd.yourrefname">500</a></li>
</ul>
<h2><a name="environment">Environments</a></h2>
<ul>
-<li><a name="env.abstract"></a><a href="#env.abstract">abstract</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.abstract">69</a></li>
-<li><a name="env.addmargin*"></a><a href="#env.addmargin*">addmargin*</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.addmargin*">119</a>, <a href="scrguien.pdf#desc:scrlttr2.env.addmargin*">212</a>, <a href="scrguien.pdf#desc:scrextend.env.addmargin*">285</a></li>
-<li><a name="env.addmargin"></a><a href="#env.addmargin">addmargin</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.addmargin">119</a>, <a href="scrguien.pdf#desc:scrlttr2.env.addmargin">212</a>, <a href="scrguien.pdf#desc:scrextend.env.addmargin">285</a></li>
-<li><a name="env.captionbeside"></a><a href="#env.captionbeside">captionbeside</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.captionbeside">128</a></li>
-<li><a name="env.captionofbeside"></a><a href="#env.captionofbeside">captionofbeside</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.captionofbeside">131</a></li>
-<li><a name="env.contract"></a><a href="#env.contract">contract</a> --&gt; <a href="scrguien.pdf#desc:scrjura.env.contract">290</a></li>
-<li><a name="env.description"></a><a href="#env.description">description</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.description">114</a>, <a href="scrguien.pdf#desc:scrlttr2.env.description">210</a></li>
-<li><a name="env.enumerate"></a><a href="#env.enumerate">enumerate</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.enumerate">113</a>, <a href="scrguien.pdf#desc:scrlttr2.env.enumerate">210</a></li>
-<li><a name="env.itemize"></a><a href="#env.itemize">itemize</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.itemize">112</a>, <a href="scrguien.pdf#desc:scrlttr2.env.itemize">210</a></li>
-<li><a name="env.labeling"></a><a href="#env.labeling">labeling</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.labeling">115</a>, <a href="scrguien.pdf#desc:scrlttr2.env.labeling">211</a>, <a href="scrguien.pdf#desc:scrextend.env.labeling">285</a></li>
-<li><a name="env.letter"></a><a href="#env.letter">letter</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.env.letter">154</a></li>
-<li><a name="env.quotation"></a><a href="#env.quotation">quotation</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.quotation">118</a>, <a href="scrguien.pdf#desc:scrlttr2.env.quotation">211</a></li>
-<li><a name="env.quote"></a><a href="#env.quote">quote</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.quote">118</a>, <a href="scrguien.pdf#desc:scrlttr2.env.quote">211</a></li>
-<li><a name="env.titlepage"></a><a href="#env.titlepage">titlepage</a> --&gt; <a href="scrguien.pdf#desc:scrextend.env.titlepage">272</a>, <a href="scrguien.pdf#desc:maincls.env.titlepage">63</a></li>
-<li><a name="env.verse"></a><a href="#env.verse">verse</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.verse">116</a>, <a href="scrguien.pdf#desc:scrlttr2.env.verse">211</a></li>
+<li><a name="env.abstract"></a><a href="#env.abstract">abstract</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.abstract">71</a></li>
+<li><a name="env.addmargin*"></a><a href="#env.addmargin*">addmargin*</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.addmargin*">124</a>, <a href="scrguien.pdf#desc:scrlttr2.env.addmargin*">222</a>, <a href="scrguien.pdf#desc:scrextend.env.addmargin*">292</a></li>
+<li><a name="env.addmargin"></a><a href="#env.addmargin">addmargin</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.addmargin">124</a>, <a href="scrguien.pdf#desc:scrlttr2.env.addmargin">222</a>, <a href="scrguien.pdf#desc:scrextend.env.addmargin">292</a></li>
+<li><a name="env.captionbeside"></a><a href="#env.captionbeside">captionbeside</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.captionbeside">133</a></li>
+<li><a name="env.captionofbeside"></a><a href="#env.captionofbeside">captionofbeside</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.captionofbeside">136</a></li>
+<li><a name="env.contract"></a><a href="#env.contract">contract</a> --&gt; <a href="scrguien.pdf#desc:scrjura.env.contract">297</a></li>
+<li><a name="env.description"></a><a href="#env.description">description</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.description">119</a>, <a href="scrguien.pdf#desc:scrlttr2.env.description">220</a></li>
+<li><a name="env.enumerate"></a><a href="#env.enumerate">enumerate</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.enumerate">118</a>, <a href="scrguien.pdf#desc:scrlttr2.env.enumerate">220</a></li>
+<li><a name="env.itemize"></a><a href="#env.itemize">itemize</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.itemize">117</a>, <a href="scrguien.pdf#desc:scrlttr2.env.itemize">220</a></li>
+<li><a name="env.labeling"></a><a href="#env.labeling">labeling</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.labeling">120</a>, <a href="scrguien.pdf#desc:scrlttr2.env.labeling">221</a>, <a href="scrguien.pdf#desc:scrextend.env.labeling">292</a></li>
+<li><a name="env.letter"></a><a href="#env.letter">letter</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.env.letter">162</a></li>
+<li><a name="env.quotation"></a><a href="#env.quotation">quotation</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.quotation">123</a>, <a href="scrguien.pdf#desc:scrlttr2.env.quotation">221</a></li>
+<li><a name="env.quote"></a><a href="#env.quote">quote</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.quote">123</a>, <a href="scrguien.pdf#desc:scrlttr2.env.quote">221</a></li>
+<li><a name="env.titlepage"></a><a href="#env.titlepage">titlepage</a> --&gt; <a href="scrguien.pdf#desc:scrextend.env.titlepage">281</a>, <a href="scrguien.pdf#desc:maincls.env.titlepage">65</a></li>
+<li><a name="env.verse"></a><a href="#env.verse">verse</a> --&gt; <a href="scrguien.pdf#desc:maincls.env.verse">121</a>, <a href="scrguien.pdf#desc:scrlttr2.env.verse">221</a></li>
</ul>
<h2><a name="length">Lengths</a></h2>
<ul>
-<li><a name="length.footheight"></a><a href="#length.footheight">footheight</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.length.footheight">228</a>, <a href="scrguien.pdf#desc:scrlayer.length.footheight">406</a>, <a href="scrguien.pdf#desc:typearea.length.footheight">43</a></li>
-<li><a name="length.headheight"></a><a href="#length.headheight">headheight</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.length.headheight">228</a>, <a href="scrguien.pdf#desc:scrlayer.length.headheight">406</a></li>
+<li><a name="length.footheight"></a><a href="#length.footheight">footheight</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.length.footheight">238</a>, <a href="scrguien.pdf#desc:scrlayer.length.footheight">418</a>, <a href="scrguien.pdf#desc:typearea.length.footheight">45</a></li>
+<li><a name="length.headheight"></a><a href="#length.headheight">headheight</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.length.headheight">238</a>, <a href="scrguien.pdf#desc:scrlayer.length.headheight">418</a></li>
</ul>
<h2><a name="plength">Pseudolengths</a></h2>
<ul>
-<li><a name="plength.PPdatamatrixvskip"></a><a href="#plength.PPdatamatrixvskip">PPdatamatrixvskip</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.PPdatamatrixvskip">478</a></li>
-<li><a name="plength.PPheadheight"></a><a href="#plength.PPheadheight">PPheadheight</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.PPheadheight">478</a></li>
-<li><a name="plength.PPheadwidth"></a><a href="#plength.PPheadwidth">PPheadwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.PPheadwidth">478</a></li>
-<li><a name="plength.backaddrheight"></a><a href="#plength.backaddrheight">backaddrheight</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.backaddrheight">478</a></li>
-<li><a name="plength.bfoldmarklength"></a><a href="#plength.bfoldmarklength">bfoldmarklength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.bfoldmarklength">474</a></li>
-<li><a name="plength.bfoldmarkvpos"></a><a href="#plength.bfoldmarkvpos">bfoldmarkvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.bfoldmarkvpos">473</a></li>
-<li><a name="plength.firstfoothpos"></a><a href="#plength.firstfoothpos">firstfoothpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.firstfoothpos">482</a></li>
-<li><a name="plength.firstfootvpos"></a><a href="#plength.firstfootvpos">firstfootvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.firstfootvpos">482</a></li>
-<li><a name="plength.firstfootwidth"></a><a href="#plength.firstfootwidth">firstfootwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.firstfootwidth">482</a></li>
-<li><a name="plength.firstheadhpos"></a><a href="#plength.firstheadhpos">firstheadhpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.firstheadhpos">475</a></li>
-<li><a name="plength.firstheadvpos"></a><a href="#plength.firstheadvpos">firstheadvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.firstheadvpos">475</a></li>
-<li><a name="plength.firstheadwidth"></a><a href="#plength.firstheadwidth">firstheadwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.firstheadwidth">476</a></li>
-<li><a name="plength.foldmarkhpos"></a><a href="#plength.foldmarkhpos">foldmarkhpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.foldmarkhpos">474</a></li>
-<li><a name="plength.foldmarkthickness"></a><a href="#plength.foldmarkthickness">foldmarkthickness</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.foldmarkthickness">475</a></li>
-<li><a name="plength.foldmarkvpos"></a><a href="#plength.foldmarkvpos">foldmarkvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.foldmarkvpos">475</a></li>
-<li><a name="plength.fromrulethickness"></a><a href="#plength.fromrulethickness">fromrulethickness</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.fromrulethickness">476</a></li>
-<li><a name="plength.fromrulewidth"></a><a href="#plength.fromrulewidth">fromrulewidth</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.fromrulewidth">476</a></li>
-<li><a name="plength.lfoldmarkhpos"></a><a href="#plength.lfoldmarkhpos">lfoldmarkhpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.lfoldmarkhpos">474</a></li>
-<li><a name="plength.lfoldmarklength"></a><a href="#plength.lfoldmarklength">lfoldmarklength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.lfoldmarklength">474</a></li>
-<li><a name="plength.locheight"></a><a href="#plength.locheight">locheight</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.locheight">479</a></li>
-<li><a name="plength.lochpos"></a><a href="#plength.lochpos">lochpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.lochpos">479</a></li>
-<li><a name="plength.locvpos"></a><a href="#plength.locvpos">locvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.locvpos">479</a></li>
-<li><a name="plength.locwidth"></a><a href="#plength.locwidth">locwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.locwidth">479</a></li>
-<li><a name="plength.mfoldmarklength"></a><a href="#plength.mfoldmarklength">mfoldmarklength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.mfoldmarklength">474</a></li>
-<li><a name="plength.mfoldmarkvpos"></a><a href="#plength.mfoldmarkvpos">mfoldmarkvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.mfoldmarkvpos">473</a></li>
-<li><a name="plength.pfoldmarklength"></a><a href="#plength.pfoldmarklength">pfoldmarklength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.pfoldmarklength">474</a></li>
-<li><a name="plength.refaftervskip"></a><a href="#plength.refaftervskip">refaftervskip</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.refaftervskip">480</a></li>
-<li><a name="plength.refhpos"></a><a href="#plength.refhpos">refhpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.refhpos">480</a></li>
-<li><a name="plength.refvpos"></a><a href="#plength.refvpos">refvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.refvpos">479</a></li>
-<li><a name="plength.refwidth"></a><a href="#plength.refwidth">refwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.refwidth">480</a></li>
-<li><a name="plength.sigbeforevskip"></a><a href="#plength.sigbeforevskip">sigbeforevskip</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.sigbeforevskip">481</a></li>
-<li><a name="plength.sigindent"></a><a href="#plength.sigindent">sigindent</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.sigindent">481</a></li>
-<li><a name="plength.specialmailindent"></a><a href="#plength.specialmailindent">specialmailindent</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.specialmailindent">478</a></li>
-<li><a name="plength.specialmailrightindent"></a><a href="#plength.specialmailrightindent">specialmailrightindent</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.specialmailrightindent">478</a></li>
-<li><a name="plength.subjectaftervskip"></a><a href="#plength.subjectaftervskip">subjectaftervskip</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.subjectaftervskip">481</a></li>
-<li><a name="plength.subjectbeforevskip"></a><a href="#plength.subjectbeforevskip">subjectbeforevskip</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.subjectbeforevskip">481</a></li>
-<li><a name="plength.subjectvpos"></a><a href="#plength.subjectvpos">subjectvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.subjectvpos">480</a></li>
-<li><a name="plength.tfoldmarklength"></a><a href="#plength.tfoldmarklength">tfoldmarklength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.tfoldmarklength">474</a></li>
-<li><a name="plength.tfoldmarkvpos"></a><a href="#plength.tfoldmarkvpos">tfoldmarkvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.tfoldmarkvpos">473</a></li>
-<li><a name="plength.toaddrheight"></a><a href="#plength.toaddrheight">toaddrheight</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.toaddrheight">477</a></li>
-<li><a name="plength.toaddrhpos"></a><a href="#plength.toaddrhpos">toaddrhpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.toaddrhpos">476</a></li>
-<li><a name="plength.toaddrindent"></a><a href="#plength.toaddrindent">toaddrindent</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.toaddrindent">477</a></li>
-<li><a name="plength.toaddrvpos"></a><a href="#plength.toaddrvpos">toaddrvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.toaddrvpos">476</a></li>
-<li><a name="plength.toaddrwidth"></a><a href="#plength.toaddrwidth">toaddrwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.toaddrwidth">477</a></li>
+<li><a name="plength.PPdatamatrixvskip"></a><a href="#plength.PPdatamatrixvskip">PPdatamatrixvskip</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.PPdatamatrixvskip">490</a></li>
+<li><a name="plength.PPheadheight"></a><a href="#plength.PPheadheight">PPheadheight</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.PPheadheight">489</a></li>
+<li><a name="plength.PPheadwidth"></a><a href="#plength.PPheadwidth">PPheadwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.PPheadwidth">489</a></li>
+<li><a name="plength.backaddrheight"></a><a href="#plength.backaddrheight">backaddrheight</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.backaddrheight">489</a></li>
+<li><a name="plength.bfoldmarklength"></a><a href="#plength.bfoldmarklength">bfoldmarklength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.bfoldmarklength">485</a></li>
+<li><a name="plength.bfoldmarkvpos"></a><a href="#plength.bfoldmarkvpos">bfoldmarkvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.bfoldmarkvpos">485</a></li>
+<li><a name="plength.firstfoothpos"></a><a href="#plength.firstfoothpos">firstfoothpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.firstfoothpos">493</a></li>
+<li><a name="plength.firstfootvpos"></a><a href="#plength.firstfootvpos">firstfootvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.firstfootvpos">493</a></li>
+<li><a name="plength.firstfootwidth"></a><a href="#plength.firstfootwidth">firstfootwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.firstfootwidth">493</a></li>
+<li><a name="plength.firstheadhpos"></a><a href="#plength.firstheadhpos">firstheadhpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.firstheadhpos">487</a></li>
+<li><a name="plength.firstheadvpos"></a><a href="#plength.firstheadvpos">firstheadvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.firstheadvpos">487</a></li>
+<li><a name="plength.firstheadwidth"></a><a href="#plength.firstheadwidth">firstheadwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.firstheadwidth">487</a></li>
+<li><a name="plength.foldmarkhpos"></a><a href="#plength.foldmarkhpos">foldmarkhpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.foldmarkhpos">485</a></li>
+<li><a name="plength.foldmarkthickness"></a><a href="#plength.foldmarkthickness">foldmarkthickness</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.foldmarkthickness">486</a></li>
+<li><a name="plength.foldmarkvpos"></a><a href="#plength.foldmarkvpos">foldmarkvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.foldmarkvpos">486</a></li>
+<li><a name="plength.fromrulethickness"></a><a href="#plength.fromrulethickness">fromrulethickness</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.fromrulethickness">487</a></li>
+<li><a name="plength.fromrulewidth"></a><a href="#plength.fromrulewidth">fromrulewidth</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.fromrulewidth">487</a></li>
+<li><a name="plength.lfoldmarkhpos"></a><a href="#plength.lfoldmarkhpos">lfoldmarkhpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.lfoldmarkhpos">486</a></li>
+<li><a name="plength.lfoldmarklength"></a><a href="#plength.lfoldmarklength">lfoldmarklength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.lfoldmarklength">486</a></li>
+<li><a name="plength.locheight"></a><a href="#plength.locheight">locheight</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.locheight">490</a></li>
+<li><a name="plength.lochpos"></a><a href="#plength.lochpos">lochpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.lochpos">490</a></li>
+<li><a name="plength.locvpos"></a><a href="#plength.locvpos">locvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.locvpos">490</a></li>
+<li><a name="plength.locwidth"></a><a href="#plength.locwidth">locwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.locwidth">490</a></li>
+<li><a name="plength.mfoldmarklength"></a><a href="#plength.mfoldmarklength">mfoldmarklength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.mfoldmarklength">485</a></li>
+<li><a name="plength.mfoldmarkvpos"></a><a href="#plength.mfoldmarkvpos">mfoldmarkvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.mfoldmarkvpos">485</a></li>
+<li><a name="plength.pfoldmarklength"></a><a href="#plength.pfoldmarklength">pfoldmarklength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.pfoldmarklength">485</a></li>
+<li><a name="plength.refaftervskip"></a><a href="#plength.refaftervskip">refaftervskip</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.refaftervskip">491</a></li>
+<li><a name="plength.refhpos"></a><a href="#plength.refhpos">refhpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.refhpos">491</a></li>
+<li><a name="plength.refvpos"></a><a href="#plength.refvpos">refvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.refvpos">491</a></li>
+<li><a name="plength.refwidth"></a><a href="#plength.refwidth">refwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.refwidth">491</a></li>
+<li><a name="plength.sigbeforevskip"></a><a href="#plength.sigbeforevskip">sigbeforevskip</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.sigbeforevskip">492</a></li>
+<li><a name="plength.sigindent"></a><a href="#plength.sigindent">sigindent</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.sigindent">492</a></li>
+<li><a name="plength.specialmailindent"></a><a href="#plength.specialmailindent">specialmailindent</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.specialmailindent">489</a></li>
+<li><a name="plength.specialmailrightindent"></a><a href="#plength.specialmailrightindent">specialmailrightindent</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.specialmailrightindent">489</a></li>
+<li><a name="plength.subjectaftervskip"></a><a href="#plength.subjectaftervskip">subjectaftervskip</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.subjectaftervskip">492</a></li>
+<li><a name="plength.subjectbeforevskip"></a><a href="#plength.subjectbeforevskip">subjectbeforevskip</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.subjectbeforevskip">492</a></li>
+<li><a name="plength.subjectvpos"></a><a href="#plength.subjectvpos">subjectvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.subjectvpos">492</a></li>
+<li><a name="plength.tfoldmarklength"></a><a href="#plength.tfoldmarklength">tfoldmarklength</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.tfoldmarklength">485</a></li>
+<li><a name="plength.tfoldmarkvpos"></a><a href="#plength.tfoldmarkvpos">tfoldmarkvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.tfoldmarkvpos">485</a></li>
+<li><a name="plength.toaddrheight"></a><a href="#plength.toaddrheight">toaddrheight</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.toaddrheight">488</a></li>
+<li><a name="plength.toaddrhpos"></a><a href="#plength.toaddrhpos">toaddrhpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.toaddrhpos">488</a></li>
+<li><a name="plength.toaddrindent"></a><a href="#plength.toaddrindent">toaddrindent</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.toaddrindent">489</a></li>
+<li><a name="plength.toaddrvpos"></a><a href="#plength.toaddrvpos">toaddrvpos</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.toaddrvpos">488</a></li>
+<li><a name="plength.toaddrwidth"></a><a href="#plength.toaddrwidth">toaddrwidth</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.plength.toaddrwidth">488</a></li>
</ul>
<h2><a name="variable">Variables</a></h2>
<ul>
-<li><a name="variable.PPcode"></a><a href="#variable.PPcode">PPcode</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.PPcode">183</a></li>
-<li><a name="variable.PPdatamatrix"></a><a href="#variable.PPdatamatrix">PPdatamatrix</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.PPdatamatrix">183</a></li>
-<li><a name="variable.addresseeimage"></a><a href="#variable.addresseeimage">addresseeimage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.addresseeimage">183</a></li>
-<li><a name="variable.backaddress"></a><a href="#variable.backaddress">backaddress</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.backaddress">183</a></li>
-<li><a name="variable.backaddressseparator"></a><a href="#variable.backaddressseparator">backaddressseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.backaddressseparator">183</a></li>
-<li><a name="variable.ccseparator"></a><a href="#variable.ccseparator">ccseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.ccseparator">160</a></li>
-<li><a name="variable.customer"></a><a href="#variable.customer">customer</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.customer">190</a></li>
-<li><a name="variable.date"></a><a href="#variable.date">date</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.date">190</a></li>
-<li><a name="variable.emailseparator"></a><a href="#variable.emailseparator">emailseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.emailseparator">177</a></li>
-<li><a name="variable.enclseparator"></a><a href="#variable.enclseparator">enclseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.enclseparator">160</a></li>
-<li><a name="variable.faxseparator"></a><a href="#variable.faxseparator">faxseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.faxseparator">177</a></li>
-<li><a name="variable.firstfoot"></a><a href="#variable.firstfoot">firstfoot</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.firstfoot">197</a></li>
-<li><a name="variable.firsthead"></a><a href="#variable.firsthead">firsthead</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.firsthead">183</a></li>
-<li><a name="variable.fromaddress"></a><a href="#variable.fromaddress">fromaddress</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.fromaddress">173</a></li>
-<li><a name="variable.frombank"></a><a href="#variable.frombank">frombank</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.frombank">197</a></li>
-<li><a name="variable.fromemail"></a><a href="#variable.fromemail">fromemail</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.fromemail">177</a></li>
-<li><a name="variable.fromfax"></a><a href="#variable.fromfax">fromfax</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.fromfax">177</a></li>
-<li><a name="variable.fromlogo"></a><a href="#variable.fromlogo">fromlogo</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.fromlogo">181</a></li>
-<li><a name="variable.frommobilephone"></a><a href="#variable.frommobilephone">frommobilephone</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.frommobilephone">177</a></li>
-<li><a name="variable.fromname"></a><a href="#variable.fromname">fromname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.fromname">173</a></li>
-<li><a name="variable.fromphone"></a><a href="#variable.fromphone">fromphone</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.fromphone">177</a></li>
-<li><a name="variable.fromurl"></a><a href="#variable.fromurl">fromurl</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.fromurl">177</a></li>
-<li><a name="variable.fromzipcode"></a><a href="#variable.fromzipcode">fromzipcode</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.fromzipcode">183</a></li>
-<li><a name="variable.invoice"></a><a href="#variable.invoice">invoice</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.invoice">190</a></li>
-<li><a name="variable.location"></a><a href="#variable.location">location</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.location">188</a></li>
-<li><a name="variable.mobilephoneseparator"></a><a href="#variable.mobilephoneseparator">mobilephoneseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.mobilephoneseparator">177</a></li>
-<li><a name="variable.myref"></a><a href="#variable.myref">myref</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.myref">190</a></li>
-<li><a name="variable.nextfoot"></a><a href="#variable.nextfoot">nextfoot</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.nextfoot">204</a>, <a href="scrguien.pdf#desc:scrlttr2-experts.variable.nextfoot">484</a></li>
-<li><a name="variable.nexthead"></a><a href="#variable.nexthead">nexthead</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.nexthead">204</a>, <a href="scrguien.pdf#desc:scrlttr2-experts.variable.nexthead">484</a></li>
-<li><a name="variable.phoneseparator"></a><a href="#variable.phoneseparator">phoneseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.phoneseparator">177</a></li>
-<li><a name="variable.place"></a><a href="#variable.place">place</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.place">183</a></li>
-<li><a name="variable.placeseparator"></a><a href="#variable.placeseparator">placeseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.placeseparator">191</a></li>
-<li><a name="variable.signature"></a><a href="#variable.signature">signature</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.signature">213</a></li>
-<li><a name="variable.specialmail"></a><a href="#variable.specialmail">specialmail</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.specialmail">183</a></li>
-<li><a name="variable.subject"></a><a href="#variable.subject">subject</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.subject">194</a></li>
-<li><a name="variable.subjectseparator"></a><a href="#variable.subjectseparator">subjectseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.subjectseparator">194</a></li>
-<li><a name="variable.title"></a><a href="#variable.title">title</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.title">193</a></li>
-<li><a name="variable.toaddress"></a><a href="#variable.toaddress">toaddress</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.toaddress">183</a></li>
-<li><a name="variable.toname"></a><a href="#variable.toname">toname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.toname">183</a></li>
-<li><a name="variable.urlseparator"></a><a href="#variable.urlseparator">urlseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.urlseparator">177</a></li>
-<li><a name="variable.yourmail"></a><a href="#variable.yourmail">yourmail</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.yourmail">190</a></li>
-<li><a name="variable.yourref"></a><a href="#variable.yourref">yourref</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.yourref">190</a></li>
-<li><a name="variable.zipcodeseparator"></a><a href="#variable.zipcodeseparator">zipcodeseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.zipcodeseparator">183</a></li>
+<li><a name="variable.PPcode"></a><a href="#variable.PPcode">PPcode</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.PPcode">194</a></li>
+<li><a name="variable.PPdatamatrix"></a><a href="#variable.PPdatamatrix">PPdatamatrix</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.PPdatamatrix">194</a></li>
+<li><a name="variable.addresseeimage"></a><a href="#variable.addresseeimage">addresseeimage</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.addresseeimage">194</a></li>
+<li><a name="variable.backaddress"></a><a href="#variable.backaddress">backaddress</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.backaddress">194</a></li>
+<li><a name="variable.backaddressseparator"></a><a href="#variable.backaddressseparator">backaddressseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.backaddressseparator">194</a></li>
+<li><a name="variable.ccseparator"></a><a href="#variable.ccseparator">ccseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.ccseparator">168</a></li>
+<li><a name="variable.customer"></a><a href="#variable.customer">customer</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.customer">200</a></li>
+<li><a name="variable.date"></a><a href="#variable.date">date</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.date">199</a></li>
+<li><a name="variable.emailseparator"></a><a href="#variable.emailseparator">emailseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.emailseparator">186</a></li>
+<li><a name="variable.enclseparator"></a><a href="#variable.enclseparator">enclseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.enclseparator">170</a></li>
+<li><a name="variable.faxseparator"></a><a href="#variable.faxseparator">faxseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.faxseparator">186</a></li>
+<li><a name="variable.firstfoot"></a><a href="#variable.firstfoot">firstfoot</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.firstfoot">206</a></li>
+<li><a name="variable.firsthead"></a><a href="#variable.firsthead">firsthead</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.firsthead">192</a></li>
+<li><a name="variable.fromaddress"></a><a href="#variable.fromaddress">fromaddress</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.fromaddress">181</a></li>
+<li><a name="variable.frombank"></a><a href="#variable.frombank">frombank</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.frombank">208</a></li>
+<li><a name="variable.fromemail"></a><a href="#variable.fromemail">fromemail</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.fromemail">186</a></li>
+<li><a name="variable.fromfax"></a><a href="#variable.fromfax">fromfax</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.fromfax">186</a></li>
+<li><a name="variable.fromlogo"></a><a href="#variable.fromlogo">fromlogo</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.fromlogo">190</a></li>
+<li><a name="variable.frommobilephone"></a><a href="#variable.frommobilephone">frommobilephone</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.frommobilephone">186</a></li>
+<li><a name="variable.fromname"></a><a href="#variable.fromname">fromname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.fromname">181</a></li>
+<li><a name="variable.fromphone"></a><a href="#variable.fromphone">fromphone</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.fromphone">186</a></li>
+<li><a name="variable.fromurl"></a><a href="#variable.fromurl">fromurl</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.fromurl">186</a></li>
+<li><a name="variable.fromzipcode"></a><a href="#variable.fromzipcode">fromzipcode</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.fromzipcode">194</a></li>
+<li><a name="variable.invoice"></a><a href="#variable.invoice">invoice</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.invoice">200</a></li>
+<li><a name="variable.location"></a><a href="#variable.location">location</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.location">198</a></li>
+<li><a name="variable.mobilephoneseparator"></a><a href="#variable.mobilephoneseparator">mobilephoneseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.mobilephoneseparator">186</a></li>
+<li><a name="variable.myref"></a><a href="#variable.myref">myref</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.myref">200</a></li>
+<li><a name="variable.nextfoot"></a><a href="#variable.nextfoot">nextfoot</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.nextfoot">214</a></li>
+<li><a name="variable.nexthead"></a><a href="#variable.nexthead">nexthead</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.nexthead">214</a></li>
+<li><a name="variable.phoneseparator"></a><a href="#variable.phoneseparator">phoneseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.phoneseparator">186</a></li>
+<li><a name="variable.place"></a><a href="#variable.place">place</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.place">194</a></li>
+<li><a name="variable.placeseparator"></a><a href="#variable.placeseparator">placeseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.placeseparator">201</a></li>
+<li><a name="variable.signature"></a><a href="#variable.signature">signature</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.signature">223</a></li>
+<li><a name="variable.specialmail"></a><a href="#variable.specialmail">specialmail</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.specialmail">194</a></li>
+<li><a name="variable.subject"></a><a href="#variable.subject">subject</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.subject">203</a></li>
+<li><a name="variable.subjectseparator"></a><a href="#variable.subjectseparator">subjectseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.subjectseparator">203</a></li>
+<li><a name="variable.title"></a><a href="#variable.title">title</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.title">202</a></li>
+<li><a name="variable.toaddress"></a><a href="#variable.toaddress">toaddress</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.toaddress">194</a></li>
+<li><a name="variable.toname"></a><a href="#variable.toname">toname</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.toname">194</a></li>
+<li><a name="variable.urlseparator"></a><a href="#variable.urlseparator">urlseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.urlseparator">186</a></li>
+<li><a name="variable.yourmail"></a><a href="#variable.yourmail">yourmail</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.yourmail">200</a></li>
+<li><a name="variable.yourref"></a><a href="#variable.yourref">yourref</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.yourref">200</a></li>
+<li><a name="variable.zipcodeseparator"></a><a href="#variable.zipcodeseparator">zipcodeseparator</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.variable.zipcodeseparator">194</a></li>
</ul>
<h2><a name="pagestyle">Page Styles</a></h2>
<ul>
-<li><a name="pagestyle.@everystyle@"></a><a href="#pagestyle.@everystyle@">@everystyle@</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.pagestyle.@everystyle@">401</a></li>
-<li><a name="pagestyle.empty"></a><a href="#pagestyle.empty">empty</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.pagestyle.empty">401</a></li>
-<li><a name="pagestyle.letter"></a><a href="#pagestyle.letter">letter</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2-experts.pagestyle.letter">484</a></li>
-<li><a name="pagestyle.scrheadings"></a><a href="#pagestyle.scrheadings">scrheadings</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.pagestyle.scrheadings">231</a></li>
+<li><a name="pagestyle.@everystyle@"></a><a href="#pagestyle.@everystyle@">@everystyle@</a> --&gt; <a href="scrguien.pdf#desc:scrlayer.pagestyle.@everystyle@">413</a></li>
+<li><a name="pagestyle.empty"></a><a href="#pagestyle.empty">empty</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.pagestyle.empty">211</a>, <a href="scrguien.pdf#desc:scrlayer.pagestyle.empty">413</a></li>
+<li><a name="pagestyle.headings"></a><a href="#pagestyle.headings">headings</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.pagestyle.headings">211</a></li>
+<li><a name="pagestyle.letter"></a><a href="#pagestyle.letter">letter</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.pagestyle.letter">213</a></li>
+<li><a name="pagestyle.myheadings"></a><a href="#pagestyle.myheadings">myheadings</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.pagestyle.myheadings">213</a></li>
+<li><a name="pagestyle.plain"></a><a href="#pagestyle.plain">plain</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.pagestyle.plain">213</a></li>
+<li><a name="pagestyle.scrheadings"></a><a href="#pagestyle.scrheadings">scrheadings</a> --&gt; <a href="scrguien.pdf#desc:scrlayer-scrpage.pagestyle.scrheadings">241</a></li>
</ul>
<h2><a name="counter">Counter</a></h2>
<ul>
-<li><a name="counter.letter"></a><a href="#counter.letter">letter</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.counter.letter">155</a></li>
-<li><a name="counter.par"></a><a href="#counter.par">par</a> --&gt; <a href="scrguien.pdf#desc:scrjura.counter.par">294</a></li>
-<li><a name="counter.secnumdepth"></a><a href="#counter.secnumdepth">secnumdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.counter.secnumdepth">107</a></li>
-<li><a name="counter.sentence"></a><a href="#counter.sentence">sentence</a> --&gt; <a href="scrguien.pdf#desc:scrjura.counter.sentence">295</a></li>
-<li><a name="counter.tocdepth"></a><a href="#counter.tocdepth">tocdepth</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.counter.tocdepth">357</a>, <a href="scrguien.pdf#desc:maincls.counter.tocdepth">72</a></li>
+<li><a name="counter.letter"></a><a href="#counter.letter">letter</a> --&gt; <a href="scrguien.pdf#desc:scrlttr2.counter.letter">164</a></li>
+<li><a name="counter.par"></a><a href="#counter.par">par</a> --&gt; <a href="scrguien.pdf#desc:scrjura.counter.par">302</a></li>
+<li><a name="counter.secnumdepth"></a><a href="#counter.secnumdepth">secnumdepth</a> --&gt; <a href="scrguien.pdf#desc:maincls.counter.secnumdepth">112</a></li>
+<li><a name="counter.sentence"></a><a href="#counter.sentence">sentence</a> --&gt; <a href="scrguien.pdf#desc:scrjura.counter.sentence">303</a></li>
+<li><a name="counter.tocdepth"></a><a href="#counter.tocdepth">tocdepth</a> --&gt; <a href="scrguien.pdf#desc:tocbasic.counter.tocdepth">367</a>, <a href="scrguien.pdf#desc:maincls.counter.tocdepth">76</a></li>
</ul>
<h2><a name="floatstyle">Styles for the float Package</a></h2>
<ul>
-<li><a name="floatstyle.komaabove"></a><a href="#floatstyle.komaabove">komaabove</a> --&gt; <a href="scrguien.pdf#desc:maincls.floatstyle.komaabove">131</a></li>
-<li><a name="floatstyle.komabelow"></a><a href="#floatstyle.komabelow">komabelow</a> --&gt; <a href="scrguien.pdf#desc:maincls.floatstyle.komabelow">131</a></li>
+<li><a name="floatstyle.komaabove"></a><a href="#floatstyle.komaabove">komaabove</a> --&gt; <a href="scrguien.pdf#desc:maincls.floatstyle.komaabove">136</a></li>
+<li><a name="floatstyle.komabelow"></a><a href="#floatstyle.komabelow">komabelow</a> --&gt; <a href="scrguien.pdf#desc:maincls.floatstyle.komabelow">136</a></li>
</ul>
<p>
<a href="http://validator.w3.org/check?uri=referer"><img
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/scrguien.pdf b/Master/texmf-dist/source/latex/koma-script/doc/scrguien.pdf
index 81fdfe4d18a..3e0c5641a57 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/scrguien.pdf
+++ b/Master/texmf-dist/source/latex/koma-script/doc/scrguien.pdf
Binary files differ
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/scrpage2.tex b/Master/texmf-dist/source/latex/koma-script/doc/scrpage2.tex
index bf984d06154..ce59a85ff34 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/scrpage2.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/scrpage2.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrpage2.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrpage2.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -178,7 +178,7 @@
\title{The Obsolete Package \Package{scrpage2}}
\subtitle{Extract from former versions of the \KOMAScript{} Manual}
\author{Markus Kohm\and Jens-Uwe-Morakswi}
-\date{2017-08-10}
+\date{2018-02-07}
\maketitle
\tableofcontents
@@ -1548,7 +1548,7 @@ styles which many projects can share.
\selectlanguage{ngerman}
\let\savednewcommand\newcommand
\let\newcommand\renewcommand
-\input{ngerman/guide-ngerman.tex}
+\input{\jobname-ngerman.tex}
\let\newcommand\savednewcommand
\def\theHchapter{D.\thechapter}
\setcounter{chapter}{0}