summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle-experts.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle-experts.tex')
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle-experts.tex814
1 files changed, 490 insertions, 324 deletions
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