summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/ngerman
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/ngerman')
-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
45 files changed, 7671 insertions, 5681 deletions
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