% ======================================================================
% common.tex
% Copyright (c) Markus Kohm, 2001-2008
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
% This work may be distributed and/or modified under the conditions of
% the LaTeX Project Public License, version 1.3b of the license.
% The latest version of this license is in
%   http://www.latex-project.org/lppl.txt
% and version 1.3b or later is part of all distributions of LaTeX 
% version 2005/12/01 or later and of this work.
%
% This work has the LPPL maintenance status "author-maintained".
%
% The Current Maintainer and author of this work is Markus Kohm.
%
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common.tex
% Copyright (c) Markus Kohm, 2001-2008
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3b, verteilt und/oder veraendert werden.
% Die neuste Version dieser Lizenz ist
%   http://www.latex-project.org/lppl.txt
% und Version 1.3b ist Teil aller Verteilungen von LaTeX
% Version 2005/12/01 oder spaeter und dieses Werks.
%
% Dieses Werk hat den LPPL-Verwaltungs-Status "author-maintained"
% (allein durch den Autor verwaltet).
%
% Der Aktuelle Verwalter und Autor dieses Werkes ist Markus Kohm.
% 
% Dieses Werk besteht aus den in manifest.txt aufgefuehrten Dateien.
% ======================================================================
%
% Paragraphs that are common for several chapters of the KOMA-Script guide
% Maintained by Markus Kohm
%
% ----------------------------------------------------------------------
%
% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind
% Verwaltet von Markus Kohm
%
% ======================================================================

\ProvidesFile{common.tex}[2008/11/11 KOMA-Script guide (common paragraphs)]

\makeatletter
\@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}%
\@ifundefined{ifCommonscrextend}{\newif\ifCommonscrextend}{}%
\@ifundefined{ifCommonscrlttr}{\newif\ifCommonscrlttr}{}%
\@ifundefined{ifIgnoreThis}{\newif\ifIgnoreThis}{}%
\makeatother

\ifcase \value{commonpar} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<0>>

\section{Frühe oder späte Optionenwahl}
\label{sec:\csname label@base\endcsname.options}
\ifshortversion\IgnoreThisfalse\IfNotCommon{typearea}{\IgnoreThistrue}\fi
\ifIgnoreThis
Es gilt sinngemäß, was in \autoref{sec:typearea.options} geschrieben wurde.
\else

\BeginIndex{}{Optionen}%

In diesem Abschnitt wird eine Besonderheit von \KOMAScript{} vorgestellt, die
neben %
\IfCommon{typearea}{\Package{typearea} auch andere \KOMAScript-Pakete und
  "~Klassen }%
\IfCommon{maincls}{den Klassen \Class{scrbook}, \Class{scrreprt} und
  \Class{scrartcl} auch andere \KOMAScript-Klassen und "~Pakete }%
\IfCommon{scrlttr2}{der Klasse \Class{scrlttr2} auch andere
  \KOMAScript-Klassen und "~Pakete }%
\IfCommon{scrextend}{den Klassen und \Package{scrextend} auch einige andere
  \KOMAScript-Pakete }%
betrifft. 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 beim weiteren
Studium der Anleitung dann überspringen.

\begin{Declaration}
  \Macro{documentclass}\OParameter{Optionenliste}%
  \Parameter{\KOMAScript-Klasse}\\
  \Macro{usepackage}\OParameter{Optionenliste}%
  \Parameter{Paket-Liste}
\end{Declaration}
\BeginIndex{Cmd}{documentclass}%
\BeginIndex{Cmd}{usepackage}%
Bei \LaTeX{} ist vorgesehen, dass Anwender 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
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{scrextend}\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.%
%
\IfNotCommon{scrextend}{\par%
  Bei Verwendung einer \KOMAScript-Klasse sollten im Übrigen beim
% Die Alternativen an dieser Stelle dienen der Verbesserung des Umbruchs
\IfCommon{typearea}{überflüssigen, expliziten }%
Laden des Pakets \Package{typearea} oder \Package{scrbase} 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.%
\IfCommon{maincls}{\ Überhaupt ist es bei Verwendung einer \KOMAScript-Klasse
  nicht notwendig, eines dieser Pakete auch noch explizit zu laden.}%
\IfCommon{scrlttr2}{\ Überhaupt ist es bei Verwendung einer \KOMAScript-Klasse
  nicht notwendig, eines dieser Pakete auch noch explizit zu laden.}}%
%
\EndIndex{Cmd}{usepackage}%
\EndIndex{Cmd}{documentclass}%


\BeginIndex{Cmd}{KOMAoptions}%
\BeginIndex{Cmd}{KOMAoption}%
\begin{Declaration}
  \Macro{KOMAoptions}\Parameter{Optionenliste}\\
  \Macro{KOMAoption}\Parameter{Option}\Parameter{Werteliste}
\end{Declaration}
\KOMAScript{}\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}\and \Package{scrextend}\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}. 

Einige Optionen besitzen auch einen Säumniswert (engl. \emph{default
  value}). Versäumt man die Angabe eines Wertes, verwendet man die Option also
einfach in der Form \PName{Option}, so wird automatisch dieser Säumniswert
angenommen.

Manche Optionen können %
\IfCommon{maincls}{auch }% Umbruchkorrektur
\IfCommon{scrlttr2}{auch }% Umbruchkorrektur
gleichzeitig mehrere Werte besitzen. Für solche Optionen besteht die
Möglichkeit, mit Hilfe von \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.

\begin{Explain}
  Falls man in der \PName{Optionenliste} eine Option auf einen unzulässigen
  Wert setzt oder die \PName{Werteliste} einen unzulässigen Wert enthält, so
  wird ein Fehler gemeldet. Wird \LaTeX{} in einem Modus verwendet, in dem im
  Fehlerfall Interaktionen möglich sind, so stoppt \LaTeX{} in diesem
  Fall. Durch Eingabe von »\texttt{h}« erhält man dann eine Hilfe, in der
  auch die möglichen Werte für die entsprechende Option angegeben sind.

  Soll in einem \PName{Wert} ein Gleichheitszeichen oder ein Komma vorkommen,
  so ist der \PName{Wert} in geschweifte Klammern zu setzen.

  \KOMAScript{} bedient sich für die Realisierung dieser Möglichkeit der
  Anweisungen \Macro{FamilyOptions} und \Macro{FamilyOption} mit der Familie
  »\PValue{KOMA}«. Näheres zu diesen Anweisungen ist %
  \IfCommon{maincls}{für Experten }%
  \IfCommon{scrlttr2}{für Experten }%
  in \autoref{sec:scrbase.keyvalue},
  \autopageref{desc:scrbase.cmd.FamilyOptions} zu finden.
\end{Explain}
%
\EndIndex{Cmd}{KOMAoption}%
\EndIndex{Cmd}{KOMAoptions}%
%
\EndIndex{}{Optionen}%

\fi % IgnoreThis

\or %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<1>>

\section{Kompatibilität zu früheren Versionen von \KOMAScript}
\label{sec:\csname label@base\endcsname.compatibilityOptions}
\ifshortversion\IgnoreThisfalse\IfNotCommon{maincls}{\IgnoreThistrue}\fi%
\ifIgnoreThis%
Es gilt sinngemäß, was in \autoref{sec:maincls.compatibilityOptions}
geschrieben wurde. \IfCommon{scrlttr2}{Allerdings existiert diese Möglichkeit
  bei \Class{scrlttr2} bereits seit Version~2.9t}.  
\else
\BeginIndex{}{Kompatibilität}

\IfCommon{maincls}{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.}%
\IfCommon{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.}%
\IfCommon{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.}%


\begin{Declaration}
  \KOption{version}\PName{Wert}\\
  \OptionValue{version}{first}\\
  \OptionValue{version}{last}
\end{Declaration}
\BeginIndex{Option}{version}%
\BeginIndex{Option}{version~=\PName{Wert}}%
\BeginIndex{Option}{version~=last}%
\BeginIndex{Option}{version~=first}%
\IfCommon{maincls}{\ChangedAt{v2.96a}{\Class{scrbook}\and \Class{scrreprt}\and
    \Class{scrartcl}}Seit Version~2.96a besteht bei \KOMAScript\ }%
\IfCommon{scrlttr2}{\ChangedAt{v2.9t}{Seit \Class{scrlttr2}} Version~2.9t
  besteht bei \Class{scrlttr2} }%
\IfCommon{scrextend}{Bei \Package{scrextend} besteht }%
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
entsprechend der Anpassungen der neusten Version der Klasse zu setzen ist. Zu
welcher Version Kompatibilität herzustellen ist, wird dabei über die Option
\Option{version} festgelegt. Voreingestellt ist Version~2.9t. Dasselbe
Ergebnis kann mit
% Umbruchkorrektur: Unterlängenproblem in listings!
\begin{lstcode}[belowskip=\dp\strutbox]
  version=first
\end{lstcode}
oder
\begin{lstcode}[belowskip=\dp\strutbox]
  version=2.9
\end{lstcode}
oder
\begin{lstcode}[belowskip=\dp\strutbox]
  version=2.9t
\end{lstcode}
erreicht werden. Bei Angabe einer unbekannten Version als \PName{Wert} wird
eine Warnung ausgegeben und sicherheitshalber \Option{version=}\PValue{first}
angenommen. Mit
\begin{lstcode}[belowskip=\dp\strutbox]
  version=last
\end{lstcode}
kann die jeweils neuste Version ausgewählt werden. In diesem Fall wird also
auf zukünftige Kompatibilität verzichtet. Wird die Option ohne Wertangabe
verwendet, so wird ebenfalls \PValue{last} angenommen.

Die Frage der Kompatibilität betrifft in erster Linie Fragen des Umbruchs. Neue
Möglichkeiten, die sich nicht auf den Umbruch auswirken, sind auch dann
verfügbar, wenn man per Option die Kompatibilität zu einer älteren Version
ausgewählt hat. Die Option hat keine Auswirkungen auf Umbruchänderungen, die
bei Verwendung einer neueren Version durch Beseitigung eindeutiger Fehler
entstehen. Wer auch im Fehlerfall unbedingte Umbruchkompatibilität benötigt,
sollte stattdessen mit dem Dokument auch die verwendete \KOMAScript-Version
archivieren.

\IfCommon{scrlttr2}{\begin{Example}
  Die Beispielbriefe dieses Kapitels sollen alle Möglichkeiten nutzen, die in
  der neusten Version von \KOMAScript{} zur Verfügung stehen. Dazu muss beim
  Laden der Klasse die Kompatibilität entsprechend gesetzt werden:%
  \lstinputcode[xleftmargin=1em,lastline=1]{letter-0.tex}%
  \iftrue% Umbruchkorrektur
    Hier wurde einfach mit dem symbolischen Wert \PValue{last} die neuste
    Version gewählt.%
  \else%
    Um nicht bei jeder neuen Version eine neue Versionsnummer angeben zu
    müssen, wurde hier die Möglichkeit des symbolischen Wertes \PValue{last}
    gewählt.%
  \fi
\end{Example}}

Es ist zu beachten, dass die Option \Option{version} nach dem Laden %
\IfCommon{maincls}{der Klasse }%
\IfCommon{scrlttr2}{der Klasse }%
\IfCommon{scrextend}{des Pakets \Package{scrextend} }%
nicht mehr verändert werden kann.%
%
\EndIndex{Option}{version~=\PName{Wert}}%
\EndIndex{Option}{version~=first}%
\EndIndex{Option}{version~=last}%
\EndIndex{Option}{version}%
%
\EndIndex{}{Kompatibilität}

\fi % IgnoreThis

\or %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<2>>

\section{Entwurfsmodus}
\label{sec:\csname label@base\endcsname.draft}%
\ifshortversion\IgnoreThisfalse\IfNotCommon{maincls}{\IgnoreThistrue}\fi%
\ifIgnoreThis%
Es gilt sinngemäß, was in \autoref{sec:maincls.draft} geschrieben wurde.
\else
\BeginIndex{}{Entwurf}%

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.

\begin{Declaration}
  \KOption{draft}\PName{Ein-Aus-Wert}
\end{Declaration}%
\BeginIndex{Option}{draft~=\PName{Ein-Aus-Wert}}%
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
\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet
werden. Bei Aktivierung der Option werden im Falle überlanger Zeilen am
Zeilenende kleine, schwarze Kästchen ausgegeben. Diese Kästchen erleichtern
dem ungeübten Auge, Absätze ausfindig zu machen, die manueller Nachbearbeitung
bedürfen. Demgegenüber erscheinen in der Standardeinstellung
\OptionValue{draft}{false} keine solchen Kästchen.%
%
\EndIndex{Option}{draft~=\PName{Ein-Aus-Wert}}%
%
\EndIndex{}{Entwurf}

\fi % IgnoreThis

\or %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<3>>

\section{\texorpdfstring{Seitenauf"|teilung}{Seitenaufteilung}}
\label{sec:\csname label@base\endcsname.typearea}
\BeginIndex{}{Seitenaufteilung=Seitenauf~"~|teilung}

Eine Dokumentseite besteht aus unterschiedlichen Teilen, wie den Rändern, dem
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}.

Einige Einstellungen der \KOMAScript{}-Klassen haben auch Auswirkungen auf die
Seitenauf"|teilung und umgekehrt. Diese Auswirkungen werden bei den
entsprechenden Einstellungen dokumentiert.

Für die weitere Erklärung zur Wahl des Papierformats, der Auf"|teilung der Seite
in Ränder und Satzspiegel und die Wahl von ein- oder zweispaltigem Satz sei
auf die Anleitung des Pakets \Package{typearea} verwiesen. Diese ist in
\autoref{cha:typearea} ab \autopageref{cha:typearea} zu finden.


\or %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<4>>

\label{sec:\csname label@base\endcsname.fontOptions}
\ifshortversion\IgnoreThisfalse\IfCommon{scrextend}{\IgnoreThistrue}\fi%
\ifIgnoreThis%
Es gilt sinngemäß, was in \autoref{sec:maincls.fontOptions} geschrieben
wurde.
\else
\BeginIndex{}{Schrift>Groesse=Größe}

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}
  \KOption{fontsize}\PName{Größe}
\end{Declaration}
\BeginIndex{Option}{fontsize~=\PName{Größe}}%
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
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,
so wird \PValue{pt} als Einheit angenommen. \iffree{}{Das genaue Verfahren,
  nach dem die Schriftgröße dann eingestellt wird, ist für Experten und
  interessierte Anwender in \autoref{sec:maincls-experts.addInfos},
  \autopageref{desc: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 %
\IfCommon{maincls}{der Anhang }%
\IfCommon{scrlttr2}{ein weiterer Brief }%
\IfCommon{scrextend}{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
\Macro{recalctypearea}\IndexCmd{recalctypearea},
\autoref{sec:typearea.options},
\autopageref{desc: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 %
\IfCommon{scrextend}{oder die verwendete Klasse }%
sind von diesen Paketen %
\IfCommon{scrextend}{und der Klasse }%
abhängig. %
\IfCommon{maincls}{Es können also Fehler auf"|treten, die nicht als Fehler von
  \KOMAScript{} angesehen werden.}%
\IfCommon{scrlttr2}{Dabei sind Fehler möglich, die nicht als Fehler von
  \KOMAScript{} betrachtet werden.}%
\IfCommon{scrextend}{Es können also Fehler auf"|treten, die nicht als Fehler von
  \KOMAScript{} angesehen werden.}%

Die 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!%
\IfCommon{scrlttr2}{\ Voreingestellt ist bei \Class{scrlttr2}
  \OptionValue{fontsize}{12pt}.}

\fi % IgnoreThis

\or %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<5>>

\section{Textauszeichnungen}
\label{sec:\csname label@base\endcsname.textmarkup}%
\ifshortversion\IgnoreThisfalse\IfCommon{scrlttr2}{\IgnoreThistrue}\fi%
\ifIgnoreThis%
Es gilt sinngemäß, was in \autoref{sec:maincls.textmarkup} geschrieben
wurde. Dabei sind Namen und Bedeutung der einzelnen Elemente in 
\else
\BeginIndex{}{Text>Auszeichnung}%
\BeginIndex{}{Schriftart}%

\LaTeX{} verfügt über eine ganze Reihe von Anweisungen zur
Textauszeichnung. 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.


\begin{Declaration}
  \Macro{textsuperscript}\Parameter{Text}\\
  \Macro{textsubscript}\Parameter{Text}
\end{Declaration}
\BeginIndex{Cmd}{textsubscript}%
\BeginIndex{Cmd}{textsuperscript}%
Im \LaTeX-Kern ist bereits die Anweisung
\Macro{textsuperscript}\IndexCmd{textsuperscript} definiert, mit der
\PName{Text} höher gestellt werden kann.  Leider bietet \LaTeX{} selbst keine
entsprechende Anweisung, um Text tief\Index{Tiefstellung} statt
hoch\Index{Hochstellung} zu stellen. \KOMAScript{} definiert dafür
\Macro{textsubscript}. %
\IfCommon{scrlttr2}{Ein Anwendungsbeispiel finden Sie in
  \autoref{sec:maincls.textmarkup},
  \autopageref{desc:maincls.textsubscript.example}.}
\IfCommon{scrextend}{Ein Anwendungsbeispiel finden Sie in
  \autoref{sec:maincls.textmarkup},
  \autopageref{desc:maincls.textsubscript.example}.}
%
\ifCommonmaincls
\begin{Example}
  \phantomsection\label{desc:maincls.textsubscript.example}%
  Sie schreiben einen Text über den menschlichen Stoffwechsel. Darin kommen
  hin und wieder einfache chemische Summenformeln vor. Dabei sind einzelne
  Ziffern tief zu stellen. Im Sinne des logischen Markups definieren Sie
  zunächst in der Dokumentpräambel oder einem eigenen Paket:
  \begin{lstcode}
  \newcommand*{\Molek}[2]{#1\textsubscript{#2}}
  \end{lstcode}
  \newcommand*{\Molek}[2]{#1\textsubscript{#2}}%
  Damit schreiben Sie dann:
  \begin{lstcode}
  Die Zelle bezieht ihre Energie unter anderem aus der
  Reaktion von \Molek C6\Molek H{12}\Molek O6 und
  \Molek O2 zu \Molek H2\Molek O{} und 
  \Molek C{}\Molek O2. Arsen (\Molek{As}{}) wirkt sich
  allerdings auf den Stoffwechsel sehr nachteilig aus.
  \end{lstcode}
  Das Ergebnis sieht daraufhin so aus:
  \begin{ShowOutput}
    Die Zelle bezieht ihre Energie unter anderem aus der Reaktion von
    \Molek C6\Molek H{12}\Molek O6 und \Molek O2 zu \Molek H2\Molek
    O{} und \Molek C{}\Molek O2.  Arsen (\Molek{As}{}) wirkt sich
    allerdings auf den Stoffwechsel sehr nachteilig aus.
  \end{ShowOutput}
  Etwas später entscheiden Sie, dass Summenformeln grundsätzlich serifenlos
  geschrieben werden sollen. Nun zeigt sich, wie gut die Entscheidung für
  konsequentes logisches Markup war. Sie müssen nur die
  \Macro{Molek}-Anweisung umdefinieren:
  \begin{lstcode}
  \newcommand*{\Molek}[2]{%
    \textsf{#1\textsubscript{#2}}%
  }
  \end{lstcode}
  \renewcommand*{\Molek}[2]{\textsf{#1\textsubscript{#2}}}%
  Schon ändert sich die Ausgabe im gesamten Dokument:
  \begin{ShowOutput}
    Die Zelle bezieht ihr Energie unter anderem aus der Reaktion von
    \Molek C6\Molek H{12}\Molek O6 und \Molek O2 zu \Molek H2\Molek
    O{} und \Molek C{}\Molek O2.  Arsen (\Molek{As}{}) wirkt sich
    allerdings auf den Stoffwechsel sehr nachteilig aus.
  \end{ShowOutput}
\end{Example}
\iffalse % vielleicht in einer späteren Auf-lage
Für Experten ist in \autoref{sec:experts.knowhow},
\autopageref{desc:experts.macroargs} dokumentiert, warum das Beispiel
funktioniert, obwohl teilweise die Argumente von \Macro{Molek} nicht in
geschweifte Klammern gesetzt wurden.%
\fi
\fi% \ifCommonmaincls
%
\EndIndex{Cmd}{textsuperscript}%
\EndIndex{Cmd}{textsubscript}%


\begin{Declaration}
  \Macro{setkomafont}\Parameter{Element}\Parameter{Befehle}\\
  \Macro{addtokomafont}\Parameter{Element}\Parameter{Befehle}\\
  \Macro{usekomafont}\Parameter{Element}
\end{Declaration}%
\BeginIndex{Cmd}{setkomafont}%
\BeginIndex{Cmd}{addtokomafont}%
\BeginIndex{Cmd}{usekomafont}%
Mit\ChangedAt{v2.8p}{%
  \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} Hilfe der beiden
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
sollten sich jedoch unbedingt auf solche Anweisungen beschränken, mit denen
wirklich nur ein Schriftattribut umgeschaltet wird. In der Regel werden dies
die Befehle \Macro{normalfont}, \Macro{rmfamily}, \Macro{sffamily},
\Macro{ttfamily}, \Macro{mdseries}, \Macro{bfseries}, \Macro{upshape},
\Macro{itshape}, \Macro{slshape}, \Macro{scshape} sowie die Größenbefehle
\Macro{Huge}, \Macro{huge}, \Macro{LARGE}, \Macro{Large}, \Macro{large},
\Macro{normalsize}, \Macro{small}, \Macro{footnotesize} und \Macro{tiny}
sein. Die Erklärung zu diesen Befehlen entnehmen Sie bitte \cite{l2kurz},
\cite{latex:usrguide} oder \cite{latex:fntguide}. Auch Farbumschaltungen wie
\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.
\fi

Mit \Macro{setkomafont} wird die Schriftumschaltung eines Elements mit einer
völlig neuen Definition versehen. Demgegenüber wird mit \Macro{addtokomafont}
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. Namen und Bedeutung der einzelnen Elemente sind
in %
\fi % IgnoreThis
\IfNotCommon{scrextend}{\autoref{tab:\csname
    label@base\endcsname.elementsWithoutText} }%
\IfCommon{scrextend}{\autoref{tab:maincls.elementsWithoutText},
  \autopageref{tab:maincls.elementsWithoutText} }%
aufgelistet. %
\IfCommon{scrextend}{Allerdings werden davon in \Package{scrextend} nur die
  Elemente für den Dokumenttitel, den schlauen Spruch und die Fußnoten
  behandelt.  Das Element \FontElement{disposition} ist zwar auch verfügbar,
  wird jedoch von \Package{scrextend} ebenfalls nur für den Dokumenttitel
  verwendet. }%
Die Voreinstellungen sind den jeweiligen Abschnitten zu entnehmen.

\or %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<6>>

\section{Absatzauszeichnung}
\label{sec:\csname label@base\endcsname.parmarkup}%
\ifshortversion\IgnoreThisfalse\IfNotCommon{maincls}{\IgnoreThistrue}\fi%
\ifIgnoreThis\else
\BeginIndex{}{Absatz>Auszeichnung}%

\IfCommon{maincls}{%
  Die Standardklassen setzen Absätze\Index[indexmain]{Absatz} normalerweise
  mit Absatzeinzug und ohne Absatzabstand. Bei Verwendung eines normalen
  Satzspiegels, wie ihn \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 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 Nachteil, dass er in verschiedenem Zusammenhang leicht verloren geht. So
  wäre nach einer abgesetzten Formel nicht mehr festzustellen, ob der Absatz
  fortgesetzt wird oder ein neuer beginnt. Auch am Seitenanfang müsste
  zurückgeblättert werden, um feststellen zu können, ob mit der Seite auch ein
  neuer Absatz beginnt. All diese Probleme sind beim Absatzeinzug nicht
  gegeben.  Eine Kombination von Absatzeinzug und Absatzabstand ist wegen der
  übertriebenen Redundanz abzulehnen. Der Einzug\Index[indexmain]{Einzug}
  alleine ist deutlich genug. Der einzige Nachteil des Absatzeinzugs liegt in
  der Verkürzung der Zeile. Damit gewinnt der
  Absatzabstand\Index{Absatz>Abstand} bei ohnehin kurzen Zeilen, etwa im
  Zeitungssatz, seine Berechtigung.}%
\fi% IgnoreThis
\IfCommon{scrlttr2}{%
  In der Einleitung zu \autoref{sec:maincls.parmarkup} ab
  \autopageref{sec:maincls.parmarkup} wird dargelegt, warum der Absatzeinzug
  gegenüber dem Absatzabstand vorzuziehen ist. Die Elemente, auf die sich
  diese Argumente beziehen, beispielsweise Abbildungen, Tabellen, Listen,
  abgesetzte Formeln und auch neue Seiten, sind in Standardbriefen eher
  selten. Auch sind Briefe normalerweise nicht so umfänglich, dass ein nicht
  erkannter Absatz sich schwerwiegend auf die Lesbarkeit auswirkt. Die
  Argumente sind daher bei Standardbriefen eher schwach. Dies dürfte ein Grund
  dafür sein, dass der Absatzabstand bei Briefen eher gebräuchlich ist. Es
  bleiben damit für Standardbriefe im Wesentlichen zwei Vorteile des
  Absatzeinzugs. Zum einen hebt sich ein solcher Brief aus der Masse hervor
  und zum anderen durchbricht man damit nicht nur für Briefe das einheitliche
  Erscheinungsbild aller Dokumente aus einer Quelle, die so genannte
  \emph{Corporate Identity}.}%
\ifIgnoreThis%
\IfCommon{scrlttr2}{\ Von dieser Unterscheidung gegenüber den anderen
  \KOMAScript-Klassen abgesehen gilt, was in \autoref{sec:maincls.parmarkup}
  geschrieben wurde.}
\else

\begin{Declaration}
  \KOption{parskip}\PName{Abstandsart}
\end{Declaration}
\BeginIndex{Option}{parskip~=\PName{Methode}}%
\IfCommon{maincls}{%
  Hin und wieder wird ein Layout mit Absatzabstand an Stelle des
  voreingestellten Absatzeinzugs gefordert. Die \KOMAScript-Klassen bietet mit
  der Option \Option{parskip}\ChangedAt{v3.00}{\Class{scrbook}\and
    \Class{scrreprt}\and \Class{scrartcl}} }%
\IfCommon{scrlttr2}{Bei Briefen findet man häufiger ein Layout mit
  Absatzabstand an Stelle des voreingestellten Absatzeinzugs. Die
  \KOMAScript-Klasse \Class{scrlttr2} bietet mit der Option \Option{parskip}
}%
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.

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
\autoref{tab:maincls.parskip}%
\IfCommon{scrlttr2}{auf \autopageref{tab:maincls.parskip}}%
.

\IfCommon{maincls}{%
\begin{desctable}
  \caption[{Mögliche Werte für Option \Option{parskip}}]{Mögliche Werte für
    Option \Option{parskip} zur Auswahl der Kennzeichnung von
    Absätzen\label{tab:maincls.parskip}}\\
  \Endfirsthead%
  \caption[]{Mögliche Werte für Option \Option{parskip}
    (\emph{Fortsetzung})}\\
  \Endhead%
  \standardfoot%
  \entry{\PValue{false}, \PValue{off}, \PValue{no}%
    \IndexOption{parskip~=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~=full}%
  }{%
    Absätze werden durch einen vertikalen Abstand von einer Zeile
    gekennzeichnet, Absatzenden durch einen Leerraum von mind. ein
    Geviert (1\Unit{em}) der Grundschrift am Ende der letzten Zeile.}%
  \pventry{full-}{%
    Absätze werden durch einen vertikalen Abstand von einer Zeile
    gekennzeichnet. Absatzenden werden nicht
    gekennzeichnet.\IndexOption{parskip~=full-}}%
  \pventry{full+}{%
    \looseness=-1
    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~=full+}}%
  \pventry{full*}{%
    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~=full*}}%
  \pventry{half}{%
    Absätze werden durch einen vertikalen Abstand von einer halben Zeile
    gekennzeichnet. Absatzenden durch einen Leerraum von mind. ein Geviert
    (1\Unit{em}) der normalen Schrift am Ende
    gekennzeichnet.\IndexOption{parskip~=half}}%
  \pventry{half-}{%
    Absätze werden durch einen vertikalen Abstand von einer halben Zeile
    gekennzeichnet. Absatzenden werden nicht
    gekennzeichnet.\IndexOption{parskip~=half-}}%
  \pventry{half+}{%
    Absätze werden durch einen vertikalen Abstand von einer halben Zeile
    gekennzeichnet. Absatzenden werden durch einen Leerraum von mind. einem
    Viertel einer normalen Zeile gekennzeichnet.\IndexOption{parskip~=half+}}%
  \pventry{half*}{%
    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~=half*}}%
\end{desctable}}

Wird ein Absatzabstand verwendet, so verändert sich auch der Abstand vor, nach
und innerhalb von Listenumgebungen.  Dadurch wird verhindert, dass diese
Umgebungen oder Absätze innerhalb dieser Umgebungen stärker vom Text abgesetzt
werden als die Absätze des normalen Textes voneinander.%
\IfCommon{maincls}{ Inhalts"~, Abbildungs"~ und Tabellenverzeichnis werden
  immer ohne zusätzlichen Absatzabstand gesetzt.}%
\IfCommon{scrlttr2}{% Umbruchkorrekturtext
  \iffalse%
    \ Verschiedene Elemente des Briefbogens werden immer ohne Absatzabstand
    gesetzt.%
  \fi}%

Voreingestellt ist bei \KOMAScript{} das Verhalten
\OptionValue{parskip}{false}. Hierbei gibt es keinen Absatzabstand, sondern
einen Absatzeinzug von 1\Unit{em}.%
%
\EndIndex{Option}{parskip~=\PName{Methode}}%
%
\EndIndex{}{Absatz>Auszeichnung}
\fi % IgnoreThis

\or %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<7>>

\section{Erkennung von rechten und linken Seiten}
\label{sec:\csname label@base\endcsname.oddOrEven}%
\ifshortversion\IgnoreThisfalse\IfNotCommon{maincls}{\IgnoreThistrue}\fi%
\ifIgnoreThis%
Es gilt sinngemäß, was in \autoref{sec:maincls.oddOrEven} geschrieben
wurde.
\else
\BeginIndex{}{Seite>gerade}%
\BeginIndex{}{Seite>ungerade}%

Bei doppelseitigen Dokumenten wird zwischen linken und rechten Seiten
unterschieden. Dabei hat eine linke Seite immer eine gerade Nummer und eine
rechte Seite immer eine ungerade Nummer. %
\IfCommon{maincls}{Die Erkennung von rechten und linken Seiten ist damit
  gleichbedeutend mit der Erkennung von Seiten mit gerader oder ungerader
  Nummer. In \iffree{dieser Anleitung}{diesem Buch} ist vereinfachend von
  ungeraden und geraden Seiten die Rede.%

% Umbruchkorrekturtext
  \iftrue%
  Bei einseitigen Dokumenten existiert die Unterscheidung zwischen linken und
  rechten Seiten nicht. Dennoch gibt es natürlich auch bei einseitigen
  Dokumenten sowohl Seiten mit gerader als auch Seiten mit ungerader Nummer.%
  \fi}%
\IfCommon{scrlttr2}{In der Regel werden Briefe einseitig
gesetzt. Sollen Briefe mit 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.}%

\begin{Declaration}
  \Macro{ifthispageodd}\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
\end{Declaration}%
\BeginIndex{Cmd}{ifthispageodd}%
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
befindet. Anderenfalls kommt das Argument \PName{Sonst-Teil} zur Anwendung.

\begin{Example}
  Angenommen, Sie wollen einfach nur ausgeben, ob ein Text auf einer geraden
  oder ungeraden Seite ausgegeben wird. Sie könnten dann beispielsweise mit
  der Eingabe
  \begin{lstcode}
  Dies ist eine Seite mit \ifthispageodd{un}{}gerader
  Seitenzahl.
  \end{lstcode}
  die Ausgabe
  \begin{quote}
    Dies ist eine Seite mit \ifthispageodd{un}{}gerader Seitenzahl.
  \end{quote}
  erhalten. Beachten Sie, dass in diesem Beispiel das Argument
  \PName{Sonst-Teil} leer geblieben ist.
\end{Example}

Da die Anweisung \Macro{ifthispageodd} mit einem Mechanismus arbeitet, der
einem Label und einer Referenz darauf sehr ähnlich ist, werden nach jeder
Textänderung mindestens zwei \LaTeX-Durchläufe benötigt. Erst dann ist die
Entscheidung korrekt. Im ersten Durchlauf wird eine Heuristik für die
Entscheidung verwendet.

Näheres zur Problematik der Erkennung von linken und rechten Seiten oder
geraden und ungeraden Seitennummern ist für Experten in
\autoref{sec:maincls-experts.addInfos},
\autopageref{desc:maincls-experts.cmd.ifthispageodd} zu finden.%
%
\EndIndex{Cmd}{ifthispageodd}%
%
\EndIndex{}{Seite>ungerade}%
\EndIndex{}{Seite>gerade}
\fi % IgnoreThis

\or %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<8>>

\section{Vakatseiten}
\label{sec:\csname label@base\endcsname.emptypage}%
\ifshortversion\IgnoreThisfalse\IfNotCommon{maincls}{\IgnoreThistrue}\fi%
\ifIgnoreThis
Es gilt sinngemäß, was in \autoref{sec:maincls.emptypage} geschrieben
wurde.
\else
\BeginIndex{}{Vakatseite}%%
\BeginIndex{}{Seitenstil}%

\IfNotCommon{scrlttr2}{Vakatseiten sind Seiten, die beim Satz eines Dokuments
  absichtlich leer bleiben. Ursprünglich sind diese Seiten wirklich komplett
  leer. Bei \LaTeX{} werden sie jedoch in der Voreinstellung mit dem aktuell
  gültigen Seitenstil gesetzt. \KOMAScript{} bietet hier diverse
  Erweiterungen.

  Vakatseiten findet man hauptsächlich in Büchern. Da es bei Büchern üblich
  ist, dass Kapitel auf einer rechten Seite beginnen, muss in dem Fall, dass
  das vorherigen Kapitel ebenfalls auf einer rechten Seite endet, eine leere
  linke Seite eingefügt werden. Aus dieser Erklärung ergibt sich auch, dass
  Vakatseiten normalerweise nur im doppelseitigen Satz existieren. Die leeren
  Rückseiten im einseitigen Druck werden eher nicht als Vakatseiten
  bezeichnet, obwohl sie auf Druckbögen im Ergebnis als solche erscheinen.}%
\fi
\ifIgnoreThis
\IfCommon{scrlttr2}{Aber}
\fi
\IfCommon{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
  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
  \autopageref{sec:maincls.emptypage}.}%
\ifIgnoreThis\else

\begin{Declaration}
  \KOption{cleardoublepage}\PName{Seitenstil}\\
  \OptionValue{cleardoublepage}{current}
\end{Declaration}%
\BeginIndex{Option}{cleardoublepage~=\PName{Seitenstil}}%
\BeginIndex{Option}{cleardoublepage~=current}%
Mit Hilfe dieser Option\ChangedAt{v3.00}{\Class{scrbook}\and
  \Class{scrreprt}\and \Class{scrartcl}\and \Class{scrlttr2}} kann man den
\PName{Seitenstil} der Vakatseite bestimmen, die gegebenenfalls von der
Anweisung \Macro{cleardoublepage} eingefügt wird, um bis zur gewünschten Seite
zu umbrechen. Als \PName{Seitenstil} sind alle bereits definierten Seitenstile
(siehe \autoref{sec:\csname label@base\endcsname.pagestyle} ab
\autopageref{sec:\csname label@base\endcsname.pagestyle} und
\autoref{cha:scrpage} ab \autopageref{cha:scrpage}) verwendbar. Daneben ist
auch \OptionValue{cleardoublepage}{current} möglich. Dieser Fall entspricht
der Voreinstellung von \KOMAScript{} bis Version~2.98c und führt dazu, dass
die Vakatseite mit dem Seitenstil erzeugt wird, der beim Einfügen gerade
aktuell ist. Ab Version~3.00\ChangedAt{v3.00}{\Class{scrbook}\and
  \Class{scrreprt}\and \Class{scrartcl}\and \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 \Option{version},
\autoref{sec:\csname label@base\endcsname.compatibilityOptions},
\autopageref{desc:\csname label@base\endcsname.option.version}).
\ifCommonmaincls
\begin{Example}
  \phantomsection\label{desc:maincls.option.cleardoublepage.example}
  Angenommen Sie wollen, dass die Vakatseiten bis auf die Paginierung leer
  sind, also mit Seitenstil \Pagestyle{plain} erzeugt werden. Dies erreichen
  Sie beispielsweise mit
  \begin{lstcode}
  \KOMAoption{cleardoublepage=plain}
  \end{lstcode}
  Näheres zum Seitenstil \Pagestyle{plain} ist in
  \autoref{sec:maincls.pagestyle}, \autopageref{desc:maincls.pagestyle.plain}
  zu finden.
\end{Example}
\fi
\ifCommonscrextend
\begin{Example}
  \phantomsection\label{desc:scrextend.option.cleardoublepage.example}
  Angenommen Sie wollen, dass die Vakatseiten bis auf die Paginierung leer
  sind, also mit Seitenstil \Pagestyle{plain} erzeugt werden. Dies erreichen
  Sie beispielsweise mit
  \begin{lstcode}
  \KOMAoption{cleardoublepage=plain}
  \end{lstcode}
  Näheres zum Seitenstil \Pagestyle{plain} ist in
  \autoref{sec:maincls.pagestyle}, \autopageref{desc:maincls.pagestyle.plain}
  zu finden.
\end{Example}
\fi
\EndIndex{Option}{cleardoublepage~=current}%
\EndIndex{Option}{cleardoublepage~=\PName{Seitenstil}}


\begin{Declaration}
  \Macro{clearpage}\\
  \Macro{cleardoublepage}\\
  \Macro{cleardoublepageusingstyle}\Parameter{Seitenstil}\\
  \Macro{cleardoubleemptypage}\\
  \Macro{cleardoubleplainpage}\\
  \Macro{cleardoublestandardpage}\\
  \Macro{cleardoubleoddusingstyle}\Parameter{Seitenstil}\\
  \Macro{cleardoubleoddemptypage}\\
  \Macro{cleardoubleoddplainpage}\\
  \Macro{cleardoubleoddstandardpage}\\
  \Macro{cleardoubleevenusingstyle}\Parameter{Seitenstil}\\
  \Macro{cleardoubleevenemptypage}\\
  \Macro{cleardoubleevenplainpage}\\
  \Macro{cleardoubleevenstandardpage}
\end{Declaration}%
\BeginIndex{Cmd}{clearpage}%
\BeginIndex{Cmd}{cleardoublepage}%
\BeginIndex{Cmd}{cleardoublepageusingstyle}%
\BeginIndex{Cmd}{cleardoublestandardpage}%
\BeginIndex{Cmd}{cleardoubleplainpage}%
\BeginIndex{Cmd}{cleardoubleemptypage}%
\BeginIndex{Cmd}{cleardoubleoddusingstyle}%
\BeginIndex{Cmd}{cleardoubleoddstandardpage}%
\BeginIndex{Cmd}{cleardoubleoddplainpage}%
\BeginIndex{Cmd}{cleardoubleoddemptypage}%
\BeginIndex{Cmd}{cleardoubleevenusingstyle}%
\BeginIndex{Cmd}{cleardoubleevenstandardpage}%
\BeginIndex{Cmd}{cleardoubleevenplainpage}%
\BeginIndex{Cmd}{cleardoubleevenemptypage}%
Im \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 \Macro{clearpage} arbeitet, durch die aber im
doppelseitigen Layout (siehe Option \Option{twoside} in
\autoref{sec:typearea.options}, \autopageref{desc:typearea.option.twoside})
eine neue rechte Seite begonnen wird. Dazu wird gegebenenfalls eine linke
Vakatseite im aktuellen Seitenstil ausgegeben.

Bei {\KOMAScript} arbeitet
\Macro{cleardoubleoddstandardpage}\ChangedAt{v3.00}{\Class{scrbook}\and
  \Class{scrreprt}\and \Class{scrartcl}\and \Class{scrlttr2}} 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 %
\IfCommon{maincls}{Kolumnentitel}%
\IfCommon{scrlttr2}{Seitenkopf}%
\ zu unterdrücken. Analog dazu wird bei der Anweisung
\Macro{cleardoubleoddemptypage} der Seitenstil
\Pagestyle{empty}\IndexPagestyle{empty} verwendet, um sowohl %
\IfCommon{maincls}{Kolumnentitel als auch Seitenzahl}%
\IfCommon{scrlttr2}{Seitenkopf als auch Seitenfuß}%
\ 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{cleardoubleoddusingstyle}
anzugeben. Dabei kann jeder bereits definierte Seitenstil (siehe auch
\autoref{cha:scrpage}) verwendet werden.

\IfNotCommon{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 zu
  \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 \Macro{cleardoubleevenusingstyle}.}

Die Arbeitsweise der neuen Anweisungen \Macro{cleardoublestandardpage},
\Macro{cleardoubleemptypage}, \Macro{cleardoubleplainpage} und der ein
Argument erwartenden Anweisung \Macro{cleardoublepageusingstyle} ist %
\IfCommon{scrlttr2}{bei \Class{scrlttr2} }%
\IfCommon{scrextend}{bei \Package{scrextend} }%
ebenso wie die Standard-Anweisung \Macro{cleardoublepage} von der zuvor
erklärten Option \Option{cleardoublepage} abhängig und entspricht je nach
Einstellung einer der in den vorherigen Absätzen erläuterten Anweisungen.

\IfCommon{scrlttr2}{%
  Die übrigen Anweisungen sind bei \Class{scrlttr2} nur aus Gründen der
  Vollständigkeit definiert. Näheres zu diesen Anweisungen ist bei Bedarf
  \autoref{sec:maincls.emptypage},
  \autopageref{desc:maincls.cmd.cleardoublepage} zu entnehmen.}%
\ifCommonscrlttr2\else
\begin{Example}
  \label{desc:maincls.cmd.cleardoublepage.example}%
  Angenommen Sie wollen innerhalb eines Dokuments als nächstes eine
  Doppelseite setzen, bei der auf der linken Seite eine Abbildung in Größe des
  Satzspiegels platziert wird und rechts ein neues Kapitel 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
  \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 \Macro{documentclass} angegeben werden.

  An der gewünschten Stelle im Dokument schreiben Sie nun:
  \begin{lstcode}
  \cleardoubleevenemptypage
  \thispagestyle{empty}
  \includegraphics[width=\textwidth,%
                   height=\textheight,%
                   keepaspectratio]%
                  {bild}
  \chapter{Kapitelüberschrift}
  \end{lstcode}
  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
  \cite{package:graphics}). Die letzte Zeile beginnt auf der nächsten -- dann
  rechten -- Seite ein neues Kapitel.
\end{Example}%
\fi
%
\EndIndex{Cmd}{clearpage}%
\EndIndex{Cmd}{cleardoublepage}%
\EndIndex{Cmd}{cleardoublepageusingstyle}%
\EndIndex{Cmd}{cleardoublestandardpage}%
\EndIndex{Cmd}{cleardoubleplainpage}%
\EndIndex{Cmd}{cleardoubleemptypage}%
\EndIndex{Cmd}{cleardoubleoddusingstyle}%
\EndIndex{Cmd}{cleardoubleoddstandardpage}%
\EndIndex{Cmd}{cleardoubleoddplainpage}%
\EndIndex{Cmd}{cleardoubleoddemptypage}%
\EndIndex{Cmd}{cleardoubleevenusingstyle}%
\EndIndex{Cmd}{cleardoubleevenstandardpage}%
\EndIndex{Cmd}{cleardoubleevenplainpage}%
\EndIndex{Cmd}{cleardoubleevenemptypage}%
%
\EndIndex{}{Seitenstil}%
\EndIndex{}{Vakatseite}%
\fi% IgnoreThis

\or %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<9>>

\section{Fußnoten}
\label{sec:\csname label@base\endcsname.footnotes}%
\ifshortversion\IgnoreThisfalse\IfNotCommon{maincls}{\IgnoreThistrue}\fi%
\ifIgnoreThis
\IfNotCommon{scrextend}{Es gilt sinngemäß, was in
  \autoref{sec:maincls.footnotes} geschrieben wurde.}
\else
\BeginIndex{}{Fussnoten=Fußnoten}%

\iffalse% Umbruchkorrekturtext
Selbstverständlich beherrscht \LaTeX{} auch Fußnoten. %
\fi%
\IfCommon{maincls}{Im Unterschied zu den Standardklassen bietet \KOMAScript{}
  die Möglichkeit, die Form von Fußnoten zu konfigurieren.}%
\IfCommon{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.}%
\fi
\IfCommon{scrextend}{Die Fußnoten-Möglichkeiten der \KOMAScript-Klassen% 
\ifIgnoreThis
  , die in \autoref{sec:maincls.footnotes} beschrieben sind,%
\fi
  \ werden
  von \Package{scrextend} ebenfalls bereitgestellt. In der Voreinstellung wird
  die Formatierung der Fußnoten jedoch der verwendeten Klasse überlassen. Dies
  ändert sich, sobald die Anweisung \Macro{deffootnote} verwendet wird, die
  auf
  \autopageref{desc:\ifIgnoreThis maincls\else scrextend\fi.cmd.deffootnote}
  näher erläutert wird.}%
\ifIgnoreThis\else

\begin{Declaration}
  \KOption{footnotes}\PName{Einstellung}
\end{Declaration}
\BeginIndex{Option}{footnotes~=\PName{Einstellung}}%
\IfCommon{scrextend}{Bei vielen Klassen werden Fußnoten }%
\IfNotCommon{scrextend}{ \ChangedAt{v3.00}{\Class{scrbook}\and
    \Class{scrreprt}\and \Class{scrartcl}\and \Class{scrlttr2}}Fußnoten 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.  Mit der Einstellung
\OptionValue{footnotes}{multiple}\IndexOption{footnotes=~multiple} werden
Fußnoten, die unmittelbar aufeinander folgen, stattdessen mit Trennzeichen
aneinander gereiht. Das in \Macro{multfootsep}\IndexCmd{multfootsep}
definierte Trennzeichen ist mit einem Komma vorbelegt. Der gesamte Mechanismus
ist kompatibel zu \Package{footmisc}\IndexPackage{footmisc}, Version~5.3d
(siehe \cite{package:footmisc}) implementiert. Er wirkt sich sowohl auf
Fußnotenmarkierungen aus, die mit \Macro{footnote}\IndexCmd{footnote} gesetzt
wurden, als auch auf solche, die direkt mit
\Macro{footnotemark}\IndexCmd{footnotemark} ausgegeben werden.

Es ist jederzeit möglich, auf die Voreinstellung
\OptionValue{footnotes}{nomultiple} zurückzuschalten. Bei Problemen mit
anderen Paketen, die Einfluss auf die Fußnoten nehmen, sollte die Option
jedoch nicht verwendet und die Einstellung auch nicht innerhalb des Dokuments
umgeschaltet werden.

Eine Zusammenfassung der möglichen Werte für die \PName{Einstellung} von
\Option{footnotes} bietet \autoref{tab:maincls.footnotes}%
\IfNotCommon{maincl}{, \autopageref{tab:maincls.footnotes}}%
.%
\IfCommon{maincls}{%
\begin{table}
  \caption[{Mögliche Werte für Option \Option{footnotes}}]{Mögliche Werte für
    Option \Option{footnotes} zur Einstellung der Fußnoten}
  \label{tab:maincls.footnotes}
  \begin{desctabular}
    \pventry{multiple}{%
      Unmittelbar aufeinander folgende Fußnotenmarkierungen werden durch
      \Macro{multfootsep}\IndexCmd{multfootsep} voneinander getrennt
      ausgegeben.%
      \IndexOption{footnotes~=multiple}}%
    \pventry{nomultiple}{%
      Unmittelbar aufeinander folgende Fußnotenmarkierungen werden auch
      unmittelbar aufeinander folgend ausgegeben.%
      \IndexOption{footnotes~=nomultiple}}%
  \end{desctabular}
\end{table}}%
%
\EndIndex{Option}{footnotes~=\PName{Einstellung}}


\begin{Declaration}
  \Macro{footnote}\OParameter{Nummer}\Parameter{Text}\\
  \Macro{footnotemark}\OParameter{Nummer}\\
  \Macro{footnotetext}\OParameter{Nummer}\Parameter{Text}\\
  \Macro{multiplefootnoteseparator}\\
  \Macro{multfootsep}
\end{Declaration}%
\BeginIndex{Cmd}{footnote}%
\BeginIndex{Cmd}{footnotemark}%
\BeginIndex{Cmd}{footnotetext}%
\BeginIndex{Cmd}{multiplefootnoteseparator}%
\BeginIndex{Cmd}{multfootsep}%
Fußnoten werden bei {\KOMAScript} genau wie bei den Standardklassen mit der
Anweisung \Macro{footnote} oder den paarweise zu verwendenden Anweisungen
\Macro{footnotemark} und \Macro{footnotetext} erzeugt.  Genau wie bei den
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\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}\and \Class{scrlttr2}} 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 hierzu die zuvor dokumentierte Option
\Option{footnotes}.

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
% Umbruchkorrektur: listings korrigieren!
\begin{lstcode}[belowskip=\dp\strutbox]
  \newcommand*{\multfootsep}{,}
\end{lstcode}
definiert. Dieses kann umdefiniert werden.

\ifCommonscrlttr\else
\begin{Example}
  \phantomsection\label{desc:maincls.cmd.footnote.example}%
  Angenommen, Sie wollen zu einem Wort zwei Fußnoten setzen. Im ersten Ansatz
  schreiben Sie dafür
  \begin{lstcode}
  Wort\footnote{erste Fußnote}\footnote{zweite Fußnote}.
  \end{lstcode}
  Nehmen wir weiter an, dass die Fußnoten mit 1 und 2 nummeriert werden. Da
  die beiden Fußnotennummern direkt aufeinander folgen, entsteht jedoch der
  Eindruck, dass das Wort nur eine Fußnote mit der Nummer 12 besitzt. Sie
  könnten dies nun dadurch ändern, dass Sie mit
  \begin{lstcode}
  \KOMAoptions{footnotes=multiple}
  \end{lstcode}
  die automatische Erkennung von Fußnotenhäufungen aktivieren. Stattdessen
  können Sie aber auch
  \begin{lstcode}
  Wort\footnote{erste Fußnote}\multiplefootnoteseparator
  \footnote{zweite Fußnote}
  \end{lstcode}
  verwenden. Das sollte auch dann noch funktionieren, wenn die automatische
  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
  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
  Reihung der Fußnotenzeichen kein Absatz- oder Seitenumbruch erfolgen kann.
\end{Example}%
\fi%
\IfCommon{scrlttr2}{Beispiele und ergänzende Hinweise sind
  \autoref{sec:maincls.footnotes} ab
  \autopageref{desc:maincls.cmd.footnote.example} zu entnehmen.}%
\EndIndex{Cmd}{footnote}%
\EndIndex{Cmd}{footnotemark}%
\EndIndex{Cmd}{footnotetext}%
\EndIndex{Cmd}{multiplefootnoteseparator}%
\EndIndex{Cmd}{multfootsep}%
\fi% IgnoreThis

\or %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<10>>

\ifIgnoreThis\else
\begin{Declaration}
  \Macro{footref}\Parameter{Referenz}
\end{Declaration}
\BeginIndex{Cmd}{footref}%
Manchmal\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}\and \Class{scrlttr2}} hat man in einem Dokument eine
Fußnote, zu der es im Text mehrere Verweise geben soll. Die ungünstige Lösung
dafür wäre die Verwendung von \Macro{footnotemark} unter Angabe der
gewünschten Nummer. Ungünstig an dieser Lösung ist, dass man die Nummer kennen
muss und sich diese jederzeit ändern kann. \KOMAScript{} bietet deshalb die
Möglichkeit, den \Macro{label}-Mechanismus auch für 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.
\begin{Example}
  Sie schreiben einen Text, in dem sie bei jedem Auf"|treten eines Markennamens
  eine Fußnote setzen müssen, die darauf hinweist, dass es sich um einen
  geschützten Markennamen handelt. Sie schreiben beispielsweise:
\ifCommonmaincls
  \begin{lstcode}
  Die Firma SplischSplasch\footnote{Bei diesem Namen
    handelt es sich um eine registrierte Marke. Alle
    Rechte daran sind dem Markeninhaber 
    vorbehalten.\label{refnote}} stellt neben 
  SplischPlumps\footref{refnote} auch noch die 
  verbesserte Version SplischPlatsch\footref{refnote}
  her.
  \end{lstcode}
  Es wird dann dreimal eine Marke auf dieselbe Fußnote gesetzt, einmal mit
  \Macro{footnote} direkt und zweimal mit \Macro{footref}.
\else
  \begin{lstcode}
  Die Firma SplischSplasch\footnote{Bei diesem Namen 
    handelt es sich um eine registrierte Marke. Alle 
    Rechte daran sind dem Markeninhaber, der Firma 
    SplischSplasch, vorbehalten.\label{refnote}}
  stellt neben SplischPlumps\footref{refnote} auch noch 
  die verbesserte Version SplischPlatsch\footref{refnote} 
  und das sehr beliebte 
  SplischSplaschPlumps\footref{refnote} her.
  \end{lstcode}
  Es wird dann vier Mal eine Marke auf dieselbe Fußnote gesetzt, einmal mit
  \Macro{footnote} direkt und drei Mal mit \Macro{footref}.
\fi
\end{Example}
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.%
%
\EndIndex{Cmd}{footref}%
\IfCommon{scrlttr2}{\EndIndex{}{Fussnoten=Fußnoten}}
\fi% IgnoreThis

\or %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<11>>

\ifIgnoreThis\else
\begin{Declaration}
  \Macro{deffootnote}\OParameter{Markenbreite}\Parameter{Einzug}%
                     \Parameter{Absatzeinzug}\Parameter{Markendefinition}\\
  \Macro{deffootnotemark}\Parameter{Markendefinition}\\
  \Macro{thefootnotemark}
\end{Declaration}%
\BeginIndex{Cmd}{deffootnote}%
\BeginIndex{Cmd}{deffootnotemark}%
\BeginIndex{Cmd}{thefootnotemark}%
Die \KOMAScript-Klassen setzen 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
rechtsbündig in einem Feld der Breite \PName{Markenbreite} gesetzt. Die erste
Zeile der Fußnote schließt direkt an das Feld der Markierung an.

Alle weiteren Zeilen werden um den Betrag von \PName{Einzug} eingezogen
ausgegeben. Wird der optionale Parameter \PName{Markenbreite} nicht angegeben,
dann entspricht er dem Wert von \PName{Einzug}.  Sollte die Fußnote aus
mehreren Absätzen bestehen, dann wird die erste Zeile eines Absatzes
zusätzlich mit dem Einzug der Größe \PName{Absatzeinzug} versehen.

\IfCommon{maincls}{%
\begin{figure}
  \centering\setlength{\unitlength}{1mm}
  \begin{picture}(100,22)
    \thinlines
    % frame of following paragraph
    \put(5,0){\line(1,0){90}}
    \put(5,0){\line(0,1){5}}
    \put(10,5){\line(0,1){5}}\put(5,5){\line(1,0){5}}
    \put(95,0){\line(0,1){10}}
    \put(10,10){\line(1,0){85}}
    % frame of first paragraph
    \put(5,11){\line(1,0){90}}
    \put(5,11){\line(0,1){5}}
    \put(15,16){\line(0,1){5}}\put(5,16){\line(1,0){10}}
    \put(95,11){\line(0,1){10}}
    \put(15,21){\line(1,0){80}}
    % box of the footnote mark
    \put(0,16.5){\framebox(14.5,4.5){\mbox{}}}
    % description of paragraphs
    \put(45,16){\makebox(0,0)[l]{\small\textsf{erster Absatz einer Fußnote}}}
    \put(45,5){\makebox(0,0)[l]{\small\textsf{folgender Absatz einer Fußnote}}}
    % help lines
    \thicklines
    \multiput(0,0)(0,3){7}{\line(0,1){2}}
    \multiput(5,0)(0,3){3}{\line(0,1){2}}
    % parameters
    \put(2,7){\vector(1,0){3}}
    \put(5,7){\line(1,0){5}}
    \put(15,7){\vector(-1,0){5}}
    \put(15,7){\makebox(0,0)[l]{\small\PName{Absatzeinzug}}}
    %
    \put(-3,13){\vector(1,0){3}}
    \put(0,13){\line(1,0){5}}
    \put(10,13){\vector(-1,0){5}}
    \put(10,13){\makebox(0,0)[l]{\small\PName{Einzug}}}
    %
    \put(-3,19){\vector(1,0){3}}
    \put(0,19){\line(1,0){14.5}}
    \put(19.5,19){\vector(-1,0){5}}
    \put(19.5,19){\makebox(0,0)[l]{\small\PName{Markenbreite}}}
  \end{picture}
  \caption{Parameter für die Darstellung der Fußnoten}
  \label{fig:maincls.deffootnote}
\end{figure}}

\autoref{fig:maincls.deffootnote} %
\IfCommon{scrlttr2}{auf \autopageref{fig:maincls.deffootnote} }%
veranschaulicht die verschiedenen Parameter%
\IfCommon{maincls}{ nochmals}%
. Die Voreinstellung in den \KOMAScript-Klassen entspricht folgender
Definition:
% Umbruchkorrektur: listings korrigieren!
\begin{lstcode}[belowskip=\dp\strutbox]
  \deffootnote[1em]{1.5em}{1em}{\textsuperscript{\thefootnotemark}}
\end{lstcode}
Dabei wird mit Hilfe von \Macro{textsuperscript} sowohl die Hochstellung als
auch die Wahl einer kleineren Schrift erreicht. \Macro{thefootnotemark} ist
die aktuelle Fußnotenmarke ohne jegliche Formatierung.%
\IfCommon{scrextend}{ Das Paket \Package{scrextend} überlässt hingegen in der
  Voreinstellung das Setzen der Fußnoten der verwendeten Klasse. Das Laden des
  Pakets allein 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 Laden von \Package{scrextend} eingefügt werden.}%

\BeginIndex{FontElement}{footnote}%
\BeginIndex{FontElement}{footnotelabel}%
Auf\ChangedAt{v2.8q}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}\and \Class{scrlttr2}} die Fußnote einschließlich der
Markierung findet außerdem die für das Element \FontElement{footnote}
eingestellte Schriftart Anwendung. Die % Umbruchkorrekturvarianten
\IfCommon{maincls}{davon abweichende }%
Schriftart der Markierung kann %
\IfNotCommon{maincls}{jedoch }%
mit Hilfe der Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} (siehe
\autoref{sec:\csname label@base\endcsname.textmarkup},
\autopageref{desc:\csname label@base\endcsname.cmd.setkomafont}) für das
Element \FontElement{footnotelabel} %
\IfCommon{scrlttr2}{davon abweichend }%
eingestellt werden. Siehe hierzu auch %
\IfNotCommon{scrextend}{\autoref{tab:\csname
    label@base\endcsname.elementsWithoutText}, \autopageref{tab:\csname
    label@base\endcsname.elementsWithoutText}}%
\IfCommon{scrextend}{\autoref{tab:maincls.elementsWithoutText},
  \autopageref{tab:maincls.elementsWithoutText}}%
. Voreingestellt ist jeweils keine Umschaltung der Schrift.%
\IfCommon{scrextend}{ Die Elemente finden bei scrextend jedoch nur dann
  Anwendung, wenn die Fußnoten mit diesem Paket gesetzt werden, also
  \Macro{deffootnote} verwendet wurde.}%
\EndIndex{FontElement}{footnotelabel}%
\EndIndex{FontElement}{footnote}%

Die Fußnotenmarkierung im Text wird getrennt von der Markierung vor der
Fußnote definiert. Dies geschieht mit der Anweisung
\Macro{deffootnotemark}. Voreingestellt ist hier:
% Umbruchkorrektur: listings korrigieren!
\begin{lstcode}[belowskip=\dp\strutbox]
  \deffootnotemark{\textsuperscript{\thefootnotemark}}
\end{lstcode}
Dabei findet\ChangedAt{v2.8q}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}} die Schriftart für das Element
\FontElement{footnotereference}\IndexFontElement{footnotereference} Anwendung
(siehe %
\IfNotCommon{scrextend}{\autoref{tab:\csname
    label@base\endcsname.elementsWithoutText}, \autopageref{tab:\csname
    label@base\endcsname.elementsWithoutText}}%
\IfCommon{scrextend}{\autoref{tab:maincls.elementsWithoutText},
  \autopageref{tab:maincls.elementsWithoutText}}%
). Die Markierungen im Text und in der Fußnote selbst sind also identisch. Die
Schriftart kann mit Hilfe der Anweisungen \Macro{setkomafont} und
\Macro{addtokomafont} (siehe \autoref{sec:\csname
  label@base\endcsname.textmarkup}, \autopageref{desc:\csname
  label@base\endcsname.cmd.setkomafont}) jedoch geändert werden%
\IfCommon{scrextend}{, sobald die Anweisung \Macro{deffootnotemark} verwendet
  wird}%
.

\ifCommonscrlttr\else
\begin{Example}
  \phantomsection\label{desc:maincls.cmd.deffootnote.example}%
  Relativ häufig wird gewünscht, dass die Markierung in der Fußnote selbst
  weder hochgestellt noch kleiner gesetzt wird. Dabei soll sie aber nicht
  direkt am Text kleben, sondern geringfügig davor stehen. Dies kann zum einen
  wie folgt erreicht werden:
  \begin{lstcode}
  \deffootnote{1em}{1em}{\thefootnotemark\ }
  \end{lstcode}
  Die Fußnotenmarkierung einschließlich dem folgenden Leerzeichen wird also
  rechtsbündig in eine Box der Breite 1\Unit{em} gesetzt.  Die folgenden
  Zeilen der Fußnote werden gegenüber dem linken Rand ebenfalls um 1\Unit{em}
  eingezogen.
  
  Eine weitere, oft gefragte Formatierung sind linksbündige
  Fußnotenmarkierungen in der Fußnote. Diese können mit folgender Definition
  erhalten werden:
  \begin{lstcode}
  \deffootnote{1.5em}{1em}{%
      \makebox[1.5em][l]{\thefootnotemark}}
  \end{lstcode}
  
  Sollen jedoch die Fußnoten insgesamt lediglich in einer anderen Schriftart,
  beispielsweise serifenlos gesetzt werden, so ist dies ganz einfach mit Hilfe
  der Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} (siehe
  \autoref{sec:maincls.textmarkup},
  \autopageref{desc:maincls.cmd.setkomafont}) zu lösen:
  \begin{lstcode}
  \setkomafont{footnote}{\sffamily}
  \end{lstcode}
\end{Example}
Wie die Beispiele zeigen, ermöglicht {\KOMAScript} mit dieser einfachen
Benutzerschnittstelle eine große Vielfalt unterschiedlicher
Fußnotenformatierungen.%
\fi%
\IfCommon{scrlttr2}{Beispiele finden Sie in \autoref{sec:maincls.footnotes},
  \autopageref{desc:maincls.cmd.deffootnote}.}%
%
\EndIndex{Cmd}{deffootnote}%
\EndIndex{Cmd}{deffootnotemark}%
\EndIndex{Cmd}{thefootnotemark}%
\IfNotCommon{scrlttr2}{\EndIndex{}{Fussnoten=Fußnoten}}
\fi% IgnoreThis

\or %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<12>>

\section{Listen}
\label{sec:\csname label@base\endcsname.lists}%
\ifshortversion\IgnoreThisfalse\IfNotCommon{maincls}{\IgnoreThistrue}\fi%
\ifIgnoreThis
Es gilt sinngemäß, was in \autoref{sec:maincls.footnotes} geschrieben
wurde. \IfCommon{scrextend}{Allerdings werden vom Paket \Package{scrextend}
  nur die Umgebungen \Environment{labeling}, \Environment{addmargin} und
  \Environment{addmargin*} definiert. Alle anderen Listenumgebungen bleiben
  der Verantwortung und Kontrolle der verwendeten Klasse überlassen.}
\else
\BeginIndex{}{Listen}%

{\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 in solchen Fällen,
die eine große Liste in mehrere kleinere Listen aufzuteilen.

\IfCommon{scrlttr2}{Da Listen zu den Standardelementen von \LaTeX{} gehören,
  wurde in diesem Abschnitt auf Beispiele verzichtet. Sie finden solche in
  \autoref{sec:maincls.lists} ab \autopageref{sec:maincls.lists} oder in jeder
  \LaTeX-Einführung.}

\ifCommonscrextend\else
\begin{Declaration}
  \XMacro{begin}\PParameter{\Environment{itemize}}\\
  \quad\Macro{item}\\
  \quad\dots\\
  \XMacro{end}\PParameter{itemize}\\
  \Macro{labelitemi}\\
  \Macro{labelitemii}\\
  \Macro{labelitemiii}\\
  \Macro{labelitemiv}
\end{Declaration}%
\BeginIndex{Env}{itemize}%
\BeginIndex{Cmd}{item}%
\BeginIndex{Cmd}{labelitemi}%
\BeginIndex{Cmd}{labelitemii}%
\BeginIndex{Cmd}{labelitemiii}%
\BeginIndex{Cmd}{labelitemiv}%
Die einfachste Form einer Liste ist die Stichpunkt- oder
\Environment{itemize}-Liste. 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. Bei den
\KOMAScript-Klassen werden je nach Ebene folgende Zeichen verwendet:
»{\labelitemi}«, »{\labelitemii}«, »{\labelitemiii}« und »{\labelitemiv}«. Die
Definition der Zeichen für die einzelnen Ebenen sind in den Makros
\Macro{labelitemi}, \Macro{labelitemii}, \Macro{labelitemiii} und
\Macro{labelitemiv} abgelegt. Sie können mit \Macro{renewcommand} umdefiniert
werden. Die einzelnen Stichpunkte werden mit \Macro{item} eingeleitet.%
%
\ifCommonmaincls
\begin{Example}
  \phantomsection\label{desc:maincls.env.itemize.example}%
  Sie haben eine einfache Aufzählung, die in mehreren Ebenen geschachtelt
  ist. Sie schreiben beispielsweise:
  \begin{lstcode}
  \minisec{Die Fahrzeuge im Spiel}
  \begin{itemize}
    \item Flugzeuge
    \begin{itemize}
      \item Doppeldecker
      \item Jets
      \item Transportmaschinen
      \begin{itemize}
        \item einmotorig
        \begin{itemize}
          \item{düsengetrieben}
          \item{propellergetrieben}
        \end{itemize}
        \item mehrmotorig
      \end{itemize}
      \item Drehflügler
    \end{itemize}
    \item Motorräder
    \begin{itemize}
      \item historisch korrekt
      \item futurisch nicht real
    \end{itemize}
    \item Automobile
  \end{itemize}
  \end{lstcode}
  Anschließend erhalten Sie:
  \begin{ShowOutput}[\baselineskip]
    \minisec{Die Fahrzeuge im Spiel}
    \begin{itemize}
    \item Flugzeuge
      \begin{itemize}
      \item Doppeldecker
      \item Jets
      \item Transportmaschinen
        \begin{itemize}
        \item einmotorig
          \begin{itemize}
          \item{düsengetrieben}
          \item{propellergetrieben}
          \end{itemize}
        \item mehrmotorig
        \end{itemize}
      \item Drehflügler
      \end{itemize}
    \item Motorräder
      \begin{itemize}
      \item historisch korrekt
      \item futurisch nicht real
      \end{itemize}
    \item Automobile
%      \begin{itemize}
%      \item Rennwagen
%      \item Personenwagen
%      \item Lastwagen
%      \end{itemize}
%     \item Fahrräder
    \end{itemize}
  \end{ShowOutput}
\end{Example}%
\fi
%
\EndIndex{Env}{itemize}%
\EndIndex{Cmd}{item}%
\EndIndex{Cmd}{labelitemi}%
\EndIndex{Cmd}{labelitemii}%
\EndIndex{Cmd}{labelitemiii}%
\EndIndex{Cmd}{labelitemiv}%


\begin{Declaration}
  \XMacro{begin}\PParameter{\Environment{enumerate}}\\
  \quad\XMacro{item}\\
  \quad\dots\\
  \XMacro{end}\PParameter{enumerate}\\
  \Macro{theenumi}\\
  \Macro{theenumii}\\
  \Macro{theenumiii}\\
  \Macro{theenumiv}\\
  \Macro{labelenumi}\\
  \Macro{labelenumii}\\
  \Macro{labelenumiii}\\
  \Macro{labelenumiv}
\end{Declaration}%
\BeginIndex{Env}{enumerate}%
\BeginIndex{Cmd}{item}%
\BeginIndex{Cmd}{theenumi}%
\BeginIndex{Cmd}{theenumii}%
\BeginIndex{Cmd}{theenumiii}%
\BeginIndex{Cmd}{theenumiv}%
\BeginIndex{Cmd}{labelenumi}%
\BeginIndex{Cmd}{labelenumii}%
\BeginIndex{Cmd}{labelenumiii}%
\BeginIndex{Cmd}{labelenumiv}%
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 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 \Macro{labelenumi} bis
\Macro{labelenumiv} bestimmt. Dabei folgt auf den Wert der zweiten Ebene, der
in Kleinbuchstaben ausgegeben wird, eine runde Klammer, während die Werte
aller anderen Ebenen von einem Punkt gefolgt werden.  Die einzelnen
Stichpunkte werden wieder mit \Macro{item} eingeleitet.%
\ifCommonmaincls
\begin{Example}
  \phantomsection\label{desc:maincls.env.enumerate.example}%
  Verkürzen wir das vorherige Beispiel und verwenden statt der
  \Environment{itemize}- eine
  \Environment{enumerate}-Umgebung:
%  Übernehmen wir das Beispiel der \Environment{itemize}-Umgebung,
%  wobei wir jede \Environment{itemize}-Umgebung durch eine
%  \Environment{enumerate}-Umgebung ersetzen. Das Ergebnis wäre dann:
  \begin{ShowOutput}[\baselineskip]
  \minisec{Die Fahrzeuge im Spiel}
  \begin{enumerate}
    \item Flugzeuge
    \begin{enumerate}
      \item Doppeldecker
%      \item Jets
      \item Transportmaschinen
      \begin{enumerate}
        \item einmotorig
        \begin{enumerate}
          \item{düsengetrieben}\label{xmp:maincls.jets}
          \item{propellergetrieben}
        \end{enumerate}
        \item mehrmotorig
      \end{enumerate}
%      \item Drehflügler
    \end{enumerate}
    \item Motorräder
    \begin{enumerate}
      \item historisch korrekt
      \item futurisch nicht real
    \end{enumerate}
%    \item Automobile
%    \begin{enumerate}
%      \item Rennwagen
%      \item Personenwagen
%      \item Lastwagen
%    \end{enumerate}
%    \item Fahrräder
  \end{enumerate}
  \end{ShowOutput}
  Innerhalb der Aufzählung können ganz normal mit \Macro{label} Marken
  gesetzt werden, auf die dann mit \Macro{ref} zugegriffen werden
  kann. So wurde oben hinter den düsengetriebenen, einmotorigen
  Flugzeugen mit »\Macro{label}\PParameter{bsp:duesen}« ein Label
  gesetzt. Der \Macro{ref}-Wert ist dann »\ref{xmp:maincls.jets}«.
\end{Example}%
\fi
%
\EndIndex{Env}{enumerate}%
\EndIndex{Cmd}{item}%
\EndIndex{Cmd}{theenumi}%
\EndIndex{Cmd}{theenumii}%
\EndIndex{Cmd}{theenumiii}%
\EndIndex{Cmd}{theenumiv}%
\EndIndex{Cmd}{labelenumi}%
\EndIndex{Cmd}{labelenumii}%
\EndIndex{Cmd}{labelenumiii}%
\EndIndex{Cmd}{labelenumiv}%


\begin{Declaration}
  \XMacro{begin}\PParameter{\Environment{description}}\\
  \quad\XMacro{item}\OParameter{Stichwort}\\
  \quad\dots\\
  \XMacro{end}\PParameter{description}
\end{Declaration}%
\BeginIndex{Env}{description}%
\BeginIndex{Cmd}{item}%
Eine weitere Listenform ist die Stichwortliste. Sie dient in erster Linie der
Beschreibung einzelner Begriffe. Diese werden als optionale Parameter bei
\Macro{item} angegeben. Die
Schriftart\Index{Schriftart}\ChangedAt{v2.8p}{\Class{scrbook}\and
  \Class{scrreprt}\and \Class{scrartcl}}, die für die Hervorhebung des
Stichworts verwendet wird, kann außerdem bei den \KOMAScript-Klassen mit Hilfe
der Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} (siehe
\autoref{sec:\csname label@base\endcsname.textmarkup},
\autopageref{desc:\csname label@base\endcsname.cmd.setkomafont}) für das
Element \FontElement{descriptionlabel}\IndexFontElement{descriptionlabel}
(siehe \autoref{tab:\csname label@base\endcsname.elementsWithoutText},
\autopageref{tab:\csname label@base\endcsname.elementsWithoutText}) geändert
werden. In der Voreinstellung wird \Macro{sffamily}""\Macro{bfseries}
verwendet.%
\ifCommonmaincls
\begin{Example}
  \phantomsection\label{desc:maincls.env.description.example}%
  Sie wollen, dass die Stichworte statt serifenlos und fett lediglich
  fett, aber in der Standardschriftart ausgegeben werden. Mit
\begin{lstcode}
  \setkomafont{descriptionlabel}{\normalfont\bfseries}
\end{lstcode}
  definieren Sie daher die Schrift entsprechend um.

  Ein Beispiel für die Ausgabe einer Stichwortliste ist eine Aufzählung der
  Seitenstile. Der Quelltext dazu lautet beispielsweise:
\begin{lstcode}
  \begin{description}
    \item[empty] ist der Seitenstil, bei dem Kopf- und
         Fußzeile vollständig leer bleiben.
    \item[plain] ist der Seitenstil, bei dem keinerlei
         Kolumnentitel verwendet wird.
    \item[headings] ist der Seitenstil für 
         automatische Kolumnentitel.
    \item[myheadings] ist der Seitenstil für manuelle
         Kolumnentitel.
  \end{description}
\end{lstcode}
  Diese ergibt:
  \begin{ShowOutput}
    \begin{description}
    \item[empty] ist der Seitenstil, bei dem Kopf- und
         Fußzeile vollständig leer bleiben.
    \item[plain] ist der Seitenstil, bei dem keinerlei
         Kolumnentitel verwendet wird.
    \item[headings] ist der Seitenstil für automatische
         Kolumnentitel.
    \item[myheadings] ist der Seitenstil für manuelle
         Kolumnentitel.
    \end{description}
  \end{ShowOutput}
\end{Example}%
\fi
%
\EndIndex{Env}{description}%
\EndIndex{Cmd}{item}%
\fi % \ifCommonscrextend\else

\begin{Declaration}
  \XMacro{begin}\PParameter{\Environment{labeling}}%
  \OParameter{Trennzeichen}\Parameter{längstes
    Muster}\\
  \quad\XMacro{item}\OParameter{Schlüsselwort}\\
  \quad\dots\\
  \XMacro{end}\PParameter{labeling}
\end{Declaration}%
\BeginIndex{Env}{labeling}%
\BeginIndex{Cmd}{item}%
Eine andere Form der %
\IfCommon{scrextend}{in vielen Klassen als \Environment{description}-Umgebung
vorhandenen }%
Stichwortliste ist nur bei den {\KOMAScript}-Klassen %
\IfCommon{scrextend}{und \Package{scrextend} }%
vorhanden: die \Environment{labeling}-Umgebung. Im Unterschied zur zuvor
vorgestellten Umgebung \Environment{description} kann bei
\Environment{labeling} ein Muster angegeben werden, dessen Länge die
Einrücktiefe bei allen Stichpunkten ergibt. Darüber hinaus kann zwischen
Stichpunkt und Beschreibungstext ein optionales \PName{Trennzeichen}
festgelegt werden.%
\ifCommonscrlttr\else
\begin{Example}
  \phantomsection\label{desc:\csname
    label@base\endcsname.env.labeling.example}%
  \IfCommon{maincls}{Wir schreiben das Beispiel der
    \Environment{description}-Umgebung etwas um:}%
  \IfCommon{scrextend}{Eine einfache Liste könnte beispielsweise wie folgt
    definiert werden:}%
  \begin{lstcode}
  \begin{labeling}[~--]{%
      \usekomafont{descriptionlabel}myheadings}
    \item[\usekomafont{descriptionlabel}empty] 
      Seitenstil für leere Seiten ohne Kopf und Fuß
    \item[\usekomafont{descriptionlabel}plain] 
      Seitenstil für Kapitelanfänge ganz ohne 
      Kolumnentitel
    \item[\usekomafont{descriptionlabel}headings] 
      Seitenstil für automatische Kolumnentitel
    \item[\usekomafont{descriptionlabel}myheadings]
      Seitenstil für manuelle Kolumnentitel
  \end{labeling}
  \end{lstcode}
  Als Ergebnis erhalten wir dann:
  \begin{ShowOutput}
    \begin{labeling}[~--]{\usekomafont{descriptionlabel}myheadings}
      \item[\usekomafont{descriptionlabel}empty] Seitenstil für leere
           Seiten ohne Kopf und Fuß
      \item[\usekomafont{descriptionlabel}plain] Seitenstil für 
           Kapitelanfänge ganz ohne Kolumnentitel
      \item[\usekomafont{descriptionlabel}headings] Seitenstil für 
           automatische Kolumnentitel
      \item[\usekomafont{descriptionlabel}myheadings] Seitenstil für
           manuelle Kolumnentitel
    \end{labeling}
  \end{ShowOutput}
  Wie in diesem Beispiel zu sehen ist, muss eine eventuell geforderte
  Schriftumschaltung bei dieser Umgebung sowohl im Muster als auch im
  optionalen Parameter jeder \Macro{item}-Anweisung wiederholt werden.
\end{Example}
Gedacht war die Umgebung ursprünglich für Strukturen wie »Voraussetzung,
Aussage, Beweis« oder »Gegeben, Gesucht, Lösung«, wie man sie in
Vorlesungsskripten häufiger findet. Inzwischen findet die Umgebung aber ganz
unterschiedliche Anwendungen. So wurde die Umgebung für Beispiele in dieser
Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.%
\fi
%
\EndIndex{Env}{labeling}%
\EndIndex{Cmd}{item}%


\ifCommonscrextend\else
\begin{Declaration}
  \XMacro{begin}\PParameter{\Environment{verse}}\\
  \quad\dots\\
  \XMacro{end}\PParameter{verse}
\end{Declaration}%
\BeginIndex{Env}{verse}%
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.

Die \Environment{verse}-Umgebung findet hauptsächlich für
Gedichte\Index{Gedichte} Anwendung. Dabei werden die Zeilen links und rechts
eingezogen. Einzelne Verse werden mit einem festen Zeilenumbruch, also mit
\verb|\\| beendet. Strophen werden ganz normal als 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|\\*| an Stelle von \verb|\\|.%
\ifCommonmaincls
\begin{Example}
  \phantomsection\label{desc:maincls.env.verse.example}%
  Als Beispiel ein kurzes Gedicht von Wilhelm Busch:
  \begin{lstcode}
  \begin{verse}
    Wenn einer, der mit Mühe kaum\\*
    Gekrochen ist auf einen Baum,\\*
    Schon meint, dass er ein Vogel wär,\\*
    So irrt sich der.
  \end{verse}
  \end{lstcode}
  Mit dem Resultat:
  \begin{ShowOutput}
  \vskip-.8\baselineskip% Umbruchkorrektur
  \begin{verse}
    Wenn einer, der mit Mühe kaum\\*
    Gekrochen ist auf einen Baum,\\*
    Schon meint, dass er ein Vogel wär,\\*
    So irrt sich der.
  \end{verse}
  \end{ShowOutput}
  Bei einem sehr langen Vers wie:
  \begin{lstcode}
  \begin{verse}
    Der Philosoph wie der Hausbesitzer hat 
    immer Reparaturen.\\* 
    \bigskip
    Wer dir sagt, er hätte noch nie gelogen, 
    dem traue nicht, mein Sohn.
  \end{verse}
  \end{lstcode}
  bei dem ein Zeilenumbruch innerhalb des Verses erfolgt:
  \begin{ShowOutput}
  \vskip-.8\baselineskip% Umbruchkorrektur
  \begin{verse}
    Der Philosoph wie der Hausbesitzer hat immer Reparaturen.\\
    \bigskip
    Wer dir sagt, er hätte noch nie gelogen, dem traue nicht, mein
    Sohn.
  \end{verse}
  \end{ShowOutput}
  kann mit \verb|\\*| allerdings nicht verhindert werden, dass am
  Zeilenumbruch auch ein Seitenumbruch erfolgt. Um dies zu erreichen, müsste
  innerhalb der ersten Zeile zusätzlich ein
  \Macro{nopagebreak}\IndexCmd{nopagebreak} eingefügt werden:
  \begin{lstcode}
  \begin{verse}
    Der Philosoph wie der Hausbesitzer\nopagebreak
    hat immer Reparaturen.\\
    \bigskip
    Wer dir sagt, er hätte noch nie\nopagebreak
    gelogen, dem traue nicht, mein Sohn.
  \end{verse}
  \end{lstcode}
\iftrue% Umbruchkorrekturtext
  Hier noch zwei Sprüche, die man immer bedenken sollte, wenn man mit
  scheinbar seltsamen Fragen zu {\LaTeX} oder den dazugehörigen Antworten
  konfrontiert ist:
  \begin{ShowOutput}
  \vskip-.8\baselineskip% Umbruchkorrektur
  \begin{verse}
    Wir mögen's keinem gerne gönnen,\\*
    Dass er was kann, was wir nicht können.\\
    \bigskip
    Wie klein ist das, was einer ist,\\*
    Wenn man's mit seinem Dünkel misst.
  \end{verse}
  \end{ShowOutput}
\fi
  In diesen Beispielen wurde übrigens jeweils \Macro{bigskip} verwendet, um
  zwei Sprüche voneinander zu trennen.
\end{Example}%
\fi
%
\EndIndex{Env}{verse}%


\iffalse% Umbruchkorrekturvarianten
\begin{Declaration}
  \XMacro{begin}\PParameter{\Environment{quote}}\\
  \quad\dots\\
  \XMacro{end}\PParameter{quote}
\end{Declaration}%
\BeginIndex{Env}{quote}%
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.%
\EndIndex{Env}{quote}%

\begin{Declaration}
  \XMacro{begin}\PParameter{\Environment{quotation}}\\
  \quad\dots\\
  \XMacro{end}\PParameter{quotation}
\end{Declaration}%
\BeginIndex{Env}{quotation}%
Diese Umgebung ist mit \Environment{quote} vergleichbar. Während bei
\Environment{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.%
\EndIndex{Env}{quotation}%

\else

\begin{Declaration}
  \XMacro{begin}\PParameter{\Environment{quote}}\\
  \quad\dots\\
  \XMacro{end}\PParameter{quote}\\
  \XMacro{begin}\PParameter{\Environment{quotation}}\\
  \quad\dots\\
  \XMacro{end}\PParameter{quotation}
\end{Declaration}%
\BeginIndex{Env}{quote}%
\BeginIndex{Env}{quotation}%
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 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 \Environment{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% Umbruchkorrektur
\IfCommon{maincls}{, außer es wird \Macro{noindent}\IndexCmd{noindent}
  vorangestellt.}%
\IfCommon{scrlttr2}{. Wollen Sie dort den Einzug verhindern, müssen Sie die
  \Macro{noindent}-Anweisung\IndexCmd{noindent} voranstellen.}%
\ifCommonmaincls
\begin{Example}
  \phantomsection\label{desc:maincls.env.quote.example}%
  Sie wollen eine kleine Anekdote hervorheben. Also schreiben Sie
  folgende \Environment{quotation}-Umgebung:
  %
\begin{lstcode}
  \begin{quotation}
    Es klingelt an der Tür eines Pfarrhauses in Stuttgart. 
    Als die Haushälterin öffnet, steht ein unrasierter 
    Mann in einem reichlich schäbigen Mantel vor der Tür
    und hält seine Strickmütze in der Hand.

    "`Gute Frau,"' verkündet der Mann in gequältem Ton,
    doch bestem Hochdeutsch, während er verlegen von einem
    Bein auf das andere wechselt, "`ich habe seit drei 
    Tagen nichts mehr gegessen."'

    Die Frau schüttelt mitleidig den Kopf und 
    entgegnet im Brustton vollster Überzeugung:

    "`Guda Moh, Sie missat sich halt zwinga!"'
  \end{quotation}
\end{lstcode}
  Das Ergebnis ist dann:
  \begin{ShowOutput}
\iffalse% Umbruchkorrekturtext
    Ein kleines Beispiel für eine Anekdote, die sich einst
    in Schwaben zugetragen haben soll:
\fi
    \begin{quotation}
    Es klingelt an der Tür eines Pfarrhauses in 
    Stuttgart. Als die Haushälterin öffnet, steht ein 
    unrasierter Mann in einem reichlich schäbigen
    Mantel vor der Tür und hält seine Strickmütze in
    der Hand.

    "`Gute Frau,"' verkündet der Mann in gequältem Ton,
    doch bestem Hochdeutsch, 
\iftrue% Umbruchkorrekturtext
    während er verlegen von einem Bein auf das andere wechselt, 
\fi
    "`ich habe 
    seit drei Tagen nichts mehr gegessen."'

    Die Frau schüttelt mitleidig den Kopf und entgegnet
    im Brustton vollster Überzeugung:

    "`Guda Moh, Sie missat sich halt zwinga!"'
    \end{quotation}
  \end{ShowOutput}
  %
  Wenn Sie stattdessen eine \Environment{quote}-Umgebung
  verwenden, sieht das Ganze so aus:
  %
  \begin{ShowOutput}
\iffalse% Umbruchkorrekturtext
    Ein kleines Beispiel für eine Anekdote, die sich einst
    in Schwaben zugetragen haben soll:
\fi
    \begin{quote}\setlength{\parskip}{4pt plus 2pt minus 2pt}
      Es klingelt an der Tür eines Pfarrhauses in Stuttgart. Als die
      Haushälterin öffnet, steht ein unrasierter Mann in einem reichlich
      schäbigen Mantel vor der Tür und hält seine Strickmütze in der Hand.

      "`Gute Frau,"' verkündet der Mann in gequältem Ton, doch bestem
      Hochdeutsch, 
\iftrue% Umbruchkorrekturtext
     während er verlegen von einem Bein auf das andere wechselt,
\fi
      "`ich habe seit drei Tagen nichts mehr gegessen."'

      Die Frau schüttelt mitleidig den Kopf und entgegnet im Brustton vollster
      Überzeugung:

      "`Guda Moh, Sie missat sich halt zwinga!"'
    \end{quote}
  \end{ShowOutput}
  %
\end{Example}%
\fi
%
\EndIndex{Env}{quote}%
\EndIndex{Env}{quotation}%
\fi % Umbruchkorrekturvarianten
\fi % \ifCommonscrextend\else

\begin{Declaration}
  \XMacro{begin}\PParameter{\Environment{addmargin}}%
  \OParameter{linker Einzug}\Parameter{Einzug}\\
  \quad\dots\\
  \XMacro{end}\PParameter{addmargin}\\
  \XMacro{begin}\PParameter{\Environment{addmargin*}}%
  \OParameter{innerer Einzug}\Parameter{Einzug}\\
  \quad\dots\\
  \XMacro{end}\PParameter{addmargin*}
\end{Declaration}
\BeginIndex{Env}{addmargin}%
\BeginIndex{Env}{addmargin*}%
Wie bei %
\IfCommon{scrextend}{den in den Standardklassen und den \KOMAScript-Klassen
  vorhandenen Umgebungen }%
\Environment{quote} und \Environment{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.

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.

Bei beiden Varianten der Umgebung sind für alle Parameter auch negative Werte
erlaubt. % Umbruchkorrektur
\IfNotCommon{scrextend}{Damit kann man erreichen, dass die Umgebung in den
  Rand hineinragt.}%
\IfCommon{scrextend}{Die Umgebung ragt dann entsprechend in den Rand hinein.}%
\ifCommonscrlttr\else
\begin{Example}
  \phantomsection\label{desc:maincls.env.addmargin.example}%
  Angenommen, Sie schreiben eine Anleitung mit kurzen
  Quellcode-Beispielen. Um diese sehr stark hervorzuheben, sollen sie mit
  horizontalen Linien vom Text abgesetzt und leicht in den äußeren Rand
  verschoben werden. Sie definieren sich dafür zunächst eine Umgebung:
  \begin{lstcode}
  \newenvironment{QuellcodeRahmen}{%
    \begin{addmargin*}[1em]{-1em}%
      \begin{minipage}{\linewidth}%
        \rule{\linewidth}{2pt}%
  }{%
      \rule[.25\baselineskip]{\linewidth}{2pt}%
      \end{minipage}%
    \end{addmargin*}%
  }
  \end{lstcode}
  \begin{ShowOutput}
  \newenvironment{QuellcodeRahmen}{%
    \begin{addmargin*}[1em]{-1em}%
      \begin{minipage}{\linewidth}%
        \rule{\linewidth}{2pt}%
  }{%
      \rule[.25\baselineskip]{\linewidth}{2pt}%
      \end{minipage}%
    \end{addmargin*}%
  }
  Die Umgebung in sich selbst gesetzt ergibt:
  \begin{QuellcodeRahmen}
\begin{lstcode}
\newenvironment{\QuellcodeRahmen}{%
  \begin{addmargin*}[1em]{-1em}%
    \begin{minipage}{\linewidth}%
      \rule{\linewidth}{2pt}%
}{%
    \rule[.25\baselineskip]{\linewidth}{2pt}%
    \end{minipage}%
  \end{addmargin*}%
}
\end{lstcode}
  \end{QuellcodeRahmen}
  Das mag praktisch sein oder unpraktisch, zumindest jedoch zeigt es,
  wie die Umgebung verwendet werden kann.
  \end{ShowOutput}
  Das optionale Argument der \Environment{addmargin*}-Umgebung sorgt
  dafür, dass der innere Rand um den Wert
  1\Unit{em} vergrößert wird. Dafür wird der äußere
  Rand um den negativen Wert vergrößert, also in Wirklichkeit um
  1\Unit{em} verkleinert. Dies resultiert in einer
  Verschiebung um 1\Unit{em} nach außen. Selbstverständlich kann statt
  \PValue{1em} auch eine Länge, beispielsweise
  \PValue{2\Macro{parindent}}, verwendet werden.
\end{Example}

Ob eine Seite eine linke oder eine rechte Seite ist, kann übrigens beim ersten
\LaTeX-Durchlauf nicht zuverlässig festgestellt werden. Siehe dazu die
Erklärungen zu den Anweisungen \Macro{ifthispageodd} (\autoref{sec:\csname
  label@base\endcsname.oddOrEven}, \autopageref{desc:\csname
  label@base\endcsname.cmd.ifthispageodd}) und \Macro{ifthispagewasodd}
(\autoref{sec:maincls-experts.addInfos},
\autopageref{desc:maincls-experts.cmd.ifthispageodd}).

\begin{Explain}
  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 \Option{parskip} in \autoref{sec:maincls-experts.addInfos},
  \autopageref{desc:maincls-experts.option.parskip} auch diesem
  Thema. Ebenfalls im Expertenteil in \autoref{sec:maincls-experts.addInfos},
  \autopageref{desc:maincls-experts.env.addmargin*} wird die
  Problematik von mehrseitigen \Environment{addmargin*}-Umgebungen behandelt.
\end{Explain}%
\fi% \ifCommonmaincls
%
\EndIndex{Env}{addmargin}%
\EndIndex{Env}{addmargin*}%
%
\EndIndex{}{Listen}
\fi% IgnoreThis

\or %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<13>>

\section{Randnotizen}
\label{sec:\csname label@base\endcsname.marginNotes}%
\ifshortversion\IgnoreThisfalse\IfNotCommon{maincls}{\IgnoreThistrue}\fi%
\ifIgnoreThis
Es gilt sinngemäß, was in \autoref{sec:maincls.marginNotes} geschrieben
wurde.
\else
\BeginIndex{}{Randnotizen}%

Außer dem eigentlichen Textbereich, der normalerweise den Satzspiegel
ausfüllt, existiert in Dokumenten noch die so genannte Marginalienspalte. In
dieser können Randnotizen gesetzt werden. % Umbruchkorrekturtext
\IfNotCommon{scrlttr2}{In diesem \iffree{Dokument}{Buch} wird davon ebenfalls
  Gebrauch gemacht.}%
\fi
\IfCommon{scrlttr2}{Bei Briefen sind Randnotizen allerdings eher unüblich und
  sollten äußerst sparsam eingesetzt werden.}%
\ifIgnoreThis\else


\begin{Declaration}
  \Macro{marginpar}\OParameter{Randnotiz links}\Parameter{Randnotiz}\\
  \Macro{marginline}\Parameter{Randnotiz}
\end{Declaration}%
\BeginIndex{Cmd}{marginpar}%
\BeginIndex{Cmd}{marginline}%
Für Randnotizen\Index[indexmain]{Randnotizen} ist bei {\LaTeX} normalerweise die
Anweisung \Macro{marginpar} vorgesehen. Die Randnotizen werden dabei im
äußeren Rand gesetzt. Bei einseitigen Dokumenten wird der rechte Rand
verwendet. Zwar kann bei \Macro{marginpar} optional eine abweichende Randnotiz
angegeben werden, falls die Randnotiz im linken Rand landet, jedoch werden
Randnotizen immer im Blocksatz ausgegeben. Die Erfahrung zeigt, dass bei
Randnotizen statt des Blocksatzes oft je nach Rand linksbündiger oder
rechtsbündiger Flattersatz zu bevorzugen ist. {\KOMAScript} bietet hierfür
die Anweisung \Macro{marginline}.

\ifCommonscrlttr\else
\begin{Example}
  \phantomsection\label{desc:\csname
    label@base\endcsname.cmd.marginline.example}%
  In diesem Kapitel ist an einigen Stellen die %
  \IfCommon{maincls}{Klassenangabe \Class{scrartcl} }%
  \IfCommon{scrextend}{Paketangabe \Package{scrextend} }%
  im Rand zu finden. Diese kann mit:
\ifCommonmaincls
  \begin{lstcode}
  \marginline{\texttt{scrartcl}}
  \end{lstcode}
\else
  \begin{lstcode}
  \marginline{\texttt{scrextend}}
  \end{lstcode}
\fi
  erreicht werden.%
\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.}%
\fi

  Statt \Macro{marginline} wäre auch die Verwendung von \Macro{marginpar}
  möglich gewesen. Tatsächlich wird bei obiger Anweisung intern nichts anders
  gemacht als:
\ifCommonmaincls
  \begin{lstcode}
  \marginpar[\raggedleft\texttt{scrartcl}]
    {\raggedright\texttt{scrartcl}}
  \end{lstcode}
\else
  \begin{lstcode}
  \marginpar[\raggedleft\texttt{scrextend}]
    {\raggedright\texttt{scrextend}}
  \end{lstcode}
\fi
  Letztlich ist \Macro{marginline} also nur eine abkürzende Schreibweise.
\end{Example}

Für Experten sind in \autoref{sec:maincls-experts.addInfos},
\autopageref{desc:maincls-experts.cmd.marginpar} Probleme bei der Verwendung
von \Macro{marginpar} dokumentiert. Diese gelten ebenso für
\Macro{marginline}.%
\fi%
\IfCommon{scrlttr2}{Ein ausführliches Beispiel hierzu finden Sie in
  \autoref{sec:maincls.marginNotes},
  \autopageref{desc:maincls.cmd.marginline.example}.}%
%
\EndIndex{Cmd}{marginpar}%
\EndIndex{Cmd}{marginline}%
%
\EndIndex{}{Randnotizen}%
\fi% IgnoreThis

\or %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<14>>

\section{Dokumenttitel}
\label{sec:\csname label@base\endcsname.titlepage}%
\ifshortversion\IgnoreThisfalse\IfNotCommon{maincls}{\IgnoreThistrue}\fi%
\ifIgnoreThis
Es gilt sinngemäß, was in \autoref{sec:maincls.titlepage} geschrieben
wurde. \IfCommon{scrextend}{Es gibt jedoch einen Unterschied:}
\else
\BeginIndex{}{Titel}%

Bei Dokumenten wird zwischen zwei verschiedenen Arten von Titeln 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 Titelseiten, etwa Schmutztitel, Verlagsinformationen, Widmung oder
ähnliche, geben. Zum anderen gibt es den Titelkopf. Dabei erscheint der Titel
lediglich am Anfang einer neuen -- in der Regel der ersten -- Seite. Unterhalb
dieser Titelzeilen\Index{Titel>-Zeilen} wird das Dokument beispielsweise mit
der Zusammenfassung, einem Vorwort oder dem Inhaltsverzeichnis fortgesetzt.
\fi

\IfCommon{scrextend}{%
  Die Möglichkeiten von \Package{scrextend} zum Dokumenttitel gehören zu den
  optionalen, erweiterten Möglichkeiten und stehen daher nur zur Verfügung,
  wenn zuvor beim Laden des Pakets \OptionValue{extendedfeature}{title}
  gewählt wurde (siehe \autoref{sec:scrextend.optionalFeatures},
  \autopageref{desc:scrextend.option.extendedfeature}). Dies gilt auch für die
  Paketoptionen aus diesem Abschnitt.}
\ifIgnoreThis
Darüber hinaus kann \Package{scrextend} nicht mit einer \KOMAScript-Klasse
zusammen verwendet werden. In allen Beispielen aus
\autoref{sec:maincls.titlepage} muss daher bei Verwendung von
\Package{scrextend}
  \begin{lstcode}
  \documentclass{scrbook}
  \end{lstcode}
durch
  \begin{lstcode}
  \documentclass{book}
  \usepackage[extendedfeature=title]{scrextend}
  \end{lstcode}
ersetzt werden.
\else

\begin{Declaration}
  \KOption{titlepage}\PName{Ein-Aus-Wert}
\end{Declaration}%
\BeginIndex{Option}{titlepage~=\PName{Ein-Aus-Wert}}%
Mit dieser Option\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}} wird ausgewählt, ob für die gesamte mit \Macro{maketitle}
(siehe \autopageref{desc:\csname label@base\endcsname.cmd.maketitle}) gesetzte
Titelei eigene Seiten\Index{Titel>-Seite} verwendet werden, oder stattdessen
die Titelei von \Macro{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}, \autopageref{tab:truefalseswitch}
verwendet werden.

Mit \OptionValue{titlepage}{true} oder \Option{titlepage} wird die Titelei in
Form von Titelseiten ausgewählt. Die Anweisung \Macro{maketitle} verwendet
\Environment{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.

Demgegenüber wird mit \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 dem Titel kann aber
nachfolgend weiteres Material, beispielsweise eine Zusammenfassung oder ein
Abschnitt gesetzt werden.

\IfCommon{maincls}{Bei den Klassen \Class{scrbook} und \Class{scrreprt} sind
  Titelseiten voreingestellt. Demgegenüber verwendet \Class{scrartcl} in der
  Voreinstellung einen Titelkopf.}%
\IfCommon{scrextend}{Die Voreinstellung ist von der verwendeten Klasse
  abhängig und wird von \Package{scrextend} kompatibel zu den Standardklassen
  erkannt. Setzt eine Klasse keine entsprechende Voreinstellung, so ist der
  Titelkopf voreingestellt.}%
%
\EndIndex{Option}{titlepage~=\PName{Ein-Aus-Wert}}


\begin{Declaration}
  \XMacro{begin}\PParameter{\Environment{titlepage}}\\
  \quad\dots\\
  \XMacro{end}\PParameter{titlepage}
\end{Declaration}%
\BeginIndex{Env}{titlepage}%
Grundsätzlich werden bei den Standardklassen und bei {\KOMAScript} alle
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
\Macro{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 automatische Layout der Titelei,
wie es das nachfolgend beschriebene \Macro{maketitle} bietet, verwenden
können, ist zu empfehlen, eine eigene Titelei mit Hilfe dieser Umgebung zu
entwerfen.

\begin{Example}
  Angenommen, Sie wollen eine Titelseite, auf der lediglich oben links
  möglichst groß und fett das Wort »Me« steht -- kein Autor, kein Datum,
  nichts weiter. Folgendes Dokument ermöglicht das:
\ifCommonmaincls
\begin{lstcode}
  \documentclass{scrbook}
  \begin{document}
    \begin{titlepage}
      \textbf{\Huge Me}
    \end{titlepage}
  \end{document}
\end{lstcode}
\else
\begin{lstcode}
  \documentclass{book}
  \usepackage[extendedfeature=title]{scrextend}
  \begin{document}
    \begin{titlepage}
      \textbf{\Huge Me}
    \end{titlepage}
  \end{document}
\end{lstcode}
\fi
  Einfach? Stimmt.
\end{Example}
%
\EndIndex{Env}{titlepage}


\begin{Declaration}
  \Macro{maketitle}\OParameter{Seitenzahl}
\end{Declaration}%
\BeginIndex{Cmd}{maketitle}%
Während bei den Standardklassen nur maximal eine Titelseite mit den 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 \Macro{titlepagestyle} (siehe
\autoref{sec:maincls.pagestyle},
\autopageref{desc:maincls.cmd.titlepagestyle}) verändert werden.

Die folgenden Anweisungen führen nicht unmittelbar zum Setzen der Titelei. Das
Setzen der Titelei erfolgt immer mit \Macro{maketitle}. Es sei an dieser
Stelle auch darauf hingewiesen, dass \Macro{maketitle} nicht innerhalb einer
\Environment{titlepage}-Umgebung zu verwenden ist. Wie in den Beispielen
angegeben, sollte man nur entweder \Macro{maketitle} oder
\Environment{titlepage} verwenden.

Mit den nachfolgend erklärten Anweisungen werden lediglich die Inhalte der
Titelei festgelegt. Sie müssen daher auch unbedingt vor \Macro{maketitle}
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.


\begin{Declaration}
  \Macro{extratitle}\Parameter{Schmutztitel}
\end{Declaration}%
\BeginIndex{Cmd}{extratitle}%
\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
  heute noch wird diese Extraseite vor dem eigentlichen Haupttitel gerne
  verwendet und enthält dann Verlagsangaben, Buchreihennummer und ähnliche
  Angaben.
\end{Explain}
Bei {\KOMAScript} ist es möglich, vor der eigentlichen Titelseite eine weitere
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
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 \Macro{maketitle}.

\begin{Example}
  Kommen wir auf das Beispiel von oben zurück und gehen davon aus, dass das
  spartanische »Me« nur den Schmutztitel darstellt. Nach dem Schmutztitel soll
  noch der Haupttitel folgen. Dann kann wie folgt verfahren werden:
\ifCommonmaincls
  \begin{lstcode}
  \documentclass{scrbook}
  \begin{document}
    \extratitle{\textbf{\Huge Me}}
    \title{It's me}
    \maketitle
  \end{document}
  \end{lstcode}
\else
  \begin{lstcode}
  \documentclass{book}
  \usepackage[extendedfeature=title]{scrextend}
  \begin{document}
    \extratitle{%
      \textbf{\Huge Me}%
    }
    \title{It's me}
    \maketitle
  \end{document}
  \end{lstcode}
\fi
  Sie können den Schmutztitel aber auch horizontal zentriert und etwas
  tiefer setzen:
\ifCommonmaincls
  \begin{lstcode}
  \documentclass{scrbook}
  \begin{document}
    \extratitle{\vspace*{4\baselineskip}
      \begin{center}\textbf{\Huge Me}\end{center}}
    \title{It's me}
    \maketitle
  \end{document}
  \end{lstcode}
\else
  \begin{lstcode}
  \documentclass{book}
  \usepackage[extendedfeature=title]{scrextend}
  \begin{document}
    \extratitle{%
      \vspace*{4\baselineskip}
      \begin{center}
        \textbf{\Huge Me}
      \end{center}%
    }
    \title{It's me}
    \maketitle
  \end{document}
  \end{lstcode}
\fi
  Die Anweisung \Macro{title} ist grundsätzlich notwendig, damit die Beispiele
  fehlerfrei sind. Sie wird nachfolgend erklärt.
\end{Example}
%
\EndIndex{Cmd}{extratitle}


\begin{Declaration}
  \Macro{titlehead}\Parameter{Kopf}\\
  \Macro{subject}\Parameter{Typisierung}\\
  \Macro{title}\Parameter{Titel}\\
  \Macro{subtitle}\Parameter{Untertitel}\\
  \Macro{author}\Parameter{Autor}\\
  \Macro{date}\Parameter{Datum}\\
  \Macro{publishers}\Parameter{Herausgeber}\\
  \Macro{and}\\
  \Macro{thanks}\Parameter{Fußnote}
\end{Declaration}%
\BeginIndex{Cmd}{titlehead}%
\BeginIndex{Cmd}{subject}%
\BeginIndex{Cmd}{title}%
\BeginIndex{Cmd}{subtitle}%
\BeginIndex{Cmd}{author}%
\BeginIndex{Cmd}{date}%
\BeginIndex{Cmd}{publishers}%
\BeginIndex{Cmd}{and}%
\BeginIndex{Cmd}{thanks}%
Für den Inhalt der Haupttitelseite stehen sieben Elemente zur Verfügung. Die
Ausgabe der Haupttitelseite erfolgt als Bestandteil der Titelei mit
\Macro{maketitle}, während die hier aufgeführten Anweisungen lediglich der
Definition der entsprechenden Elemente dienen.

Der \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.

Die \PName{Typisierung}\Index[indexmain]{Typisierung} wird unmittelbar über
dem \PName{Titel} ausgegeben. Dabei\ChangedAt{v2.95}{\Class{scrbook}\and
  \Class{scrreprt}\and \Class{scrartcl}} findet die Schriftumschaltung für das
Element \FontElement{subject}\IndexFontElement{subject} Anwendung. Die
Voreinstellung, die in \autoref{tab:maincls.titlefonts}%
\IfNotCommon{maincls}{, \autopageref{tab:maincls.titlefonts} }%
\ zu finden ist, kann mit Hilfe der Anweisungen \Macro{setkomafont} und
\Macro{addtokomafont} (siehe \autoref{sec:\csname
  label@base\endcsname.textmarkup}, \autopageref{desc:\csname
  label@base\endcsname.cmd.setkomafont}) verändert werden.

Der \PName{Titel} wird in einer sehr großen Schrift ausgegeben.
Dabei\ChangedAt{v2.8p}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}} findet abgesehen von der Größe auch die Schriftumschaltung
für das Element \FontElement{title}\IndexFontElement{title} Anwendung.
Voreingestellt ist die gleiche Schrift, die für das Element
\FontElement{disposition}\IndexFontElement{disposition} verwendet wird (siehe
\autoref{tab:maincls.elementsWithoutText},
\autopageref{tab:maincls.elementsWithoutText}). Die Voreinstellungen können
mit Hilfe der Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} (siehe
\autoref{sec:\csname label@base\endcsname.textmarkup},
\autopageref{desc:\csname label@base\endcsname.cmd.setkomafont}) verändert
werden. Die Größe ist jedoch davon unabhängig (siehe
\autoref{tab:maincls.mainTitle}, \autopageref{tab:maincls.mainTitle}).

Der \PName{Untertitel}\ChangedAt{v2.97c}{\Class{scrbook}\and
  \Class{scrreprt}\and \Class{scrartcl}} wird in der über das Element
\FontElement{subtitle}\IndexFontElement{subtitle} eingestellten Schrift knapp
unter dem Titel ausgegeben. Die Voreinstellung, die
\autoref{tab:maincls.titlefonts}%
\IfNotCommon{maincls}{, \autopageref{tab:maincls.titlefonts}}%
\ zu entnehmen ist, kann mit Hilfe der Anweisungen \Macro{setkomafont} und
\Macro{addtokomafont} (siehe \autoref{sec:\csname
  label@base\endcsname.textmarkup}, \autopageref{desc:\csname
  label@base\endcsname.cmd.setkomafont}) verändert werden.

\IfCommon{maincls}{%
\begin{table}
  \centering
  \caption{Schriftvoreinstellungen für die Elemente des Titels}
  \begin{tabular}{ll}
    \toprule
    Element-Name & Voreinstellung \\
    \midrule
    \FontElement{subject} &
    \Macro{normalfont}\Macro{normalcolor}\Macro{bfseries}\Macro{Large} \\
    \FontElement{title} & \Macro{usekomafont}\PParameter{disposition} \\
    \FontElement{subtitle} &
    \Macro{usekomafont}\PParameter{title}\Macro{large} \\
    \bottomrule
  \end{tabular}
  \label{tab:maincls.titlefonts}
\end{table}}

Unter 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.

Unter 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.

Als Letztes folgt schließlich der
\PName{Herausgeber}\Index[indexmain]{Herausgeber}. Selbstverständlich
kann diese Anweisung auch für andere Angaben geringer Wichtigkeit
verwendet 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.

Fußnoten\Index{Fussnoten=Fußnoten} werden auf der Titelseite nicht mit
\Macro{footnote}, sondern mit der Anweisung \Macro{thanks} erzeugt. Sie dienen
in der Regel für Anmerkungen bei den Autoren. Als Fußnotenzeichen werden dabei
Symbole statt Zahlen verwendet. Es ist zu beachten, dass \Macro{thanks}
innerhalb des Arguments einer der übrigen Anweisungen, beispielsweise im
Argument \PName{Autor} der Anweisung \Macro{author} zu verwenden ist.

Bis auf den \PName{Kopf} und eventuelle Fußnoten werden alle Ausgaben
horizontal zentriert. Diese Angaben sind noch einmal kurz zusammengefasst in
\autoref{tab:maincls.mainTitle}%
\IfNotCommon{maincls}{, \autopageref{tab:maincls.mainTitle} }%
\ zu finden.

\IfCommon{maincls}{\begin{table}
  \centering
  \caption[Der Haupttitel]{Schriftgröße und horizontale
    Ausrichtung der Elemente der Haupttitelseite in der Reihenfolge
    ihrer vertikalen Position von oben nach unten bei Verwendung von
    \Macro{maketitle}}
  \begin{tabular}{llll}
    \toprule
    Element     & Anweisung          & Schrift            & Satz \\
    \midrule
    Seitenkopf  & \Macro{titlehead}  & \Macro{normalsize} & Blocksatz   \\
    Typisierung & \Macro{subject}    & \Macro{usekomafont}\PParameter{subject}
    & zentriert   \\
    Titel       & \Macro{title}      &
    \Macro{huge}\Macro{usekomafont}\PParameter{title} & zentriert   \\
    Untertitel  & \Macro{subtitle}   &
    \Macro{usekomafont}\PParameter{subtitle} & zentriert \\
    Autoren     & \Macro{author}     & \Macro{Large}      & zentriert   \\
    Datum       & \Macro{date}       & \Macro{Large}      & zentriert   \\
    Herausgeber & \Macro{publishers} & \Macro{Large}      & zentriert   \\
    \bottomrule
  \end{tabular}
  \label{tab:maincls.mainTitle}
\end{table}}

\begin{Example}
  Nehmen wir nun einmal an, Sie schreiben eine Diplomarbeit. Dabei sei
  vorgegeben, dass die Titelseite oben linksbündig das Institut
  einschließlich Adresse und rechtsbündig das Semester wiedergibt. Wie
  üblich ist ein Titel einschließlich Autor und Abgabedatum zu setzen.
  Außerdem soll der Betreuer angegeben und zu erkennen sein, dass es
  sich um eine Diplomarbeit handelt. Sie könnten das wie folgt
  erreichen:
\ifCommonmaincls
  \iffree{}{\newpage}% Umbruchkorrektur
\begin{lstcode}
  \documentclass{scrbook}
  \usepackage{ngerman}
  \begin{document}
  \titlehead{{\Large Universit"at Schlauenheim
      \hfill SS~2001\\}
    Institut f"ur Raumkr"ummung\\
    Hochschulstra"se~12\\
    34567 Schlauenheim}
  \subject{Diplomarbeit}
  \title{Digitale Raumsimulation mit dem DSP\,56004}
  \subtitle{Klein aber fein?}
  \author{cand. stup. Uli Ungenau}
  \date{30. Februar 2001}
  \publishers{Betreut durch Prof. Dr. rer. stup. Naseweis}
  \maketitle
  \end{document}
\end{lstcode}
\else
\begin{lstcode}
  \documentclass{book}
  \usepackage[extendedfeature=title]{scrextend}
  \usepackage{ngerman}
  \begin{document}
  \titlehead{{\Large Universit"at Schlauenheim
      \hfill SS~2001\\}
    Institut f"ur Raumkr"ummung\\
    Hochschulstra"se~12\\
    34567 Schlauenheim}
  \subject{Diplomarbeit}
  \title{Digitale Raumsimulation mit dem DSP\,56004}
  \subtitle{Klein aber fein?}
  \author{cand. stup. Uli Ungenau}
  \date{30. Februar 2001}
  \publishers{Betreut durch Prof. Dr. rer. stup. 
    Naseweis}
  \maketitle
  \end{document}
\end{lstcode}
\fi
\end{Example}

\begin{Explain}
  Ein häufiges Missverständnis betrifft die Bedeutung der
  Haupttitelseite. Irrtümlich wird oft angenommen, es handle sich dabei um den
  Buchumschlag oder Buchdeckel. Daher wird häufig erwartet, dass die
  Titelseite nicht den Randvorgaben für 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 unter dem Buchdeckel innerhalb des so genannten
  Buchblocks. Genau diese Titelseiten werden mit \Macro{maketitle}
  gesetzt. Wie beim Schmutztitel handelt es sich also auch bei der
  Haupttitelseite um eine Seite innerhalb des Buchblocks, die deshalb dem
  Satzspiegel des gesamten Dokuments gehorcht. Überhaupt ist ein Buchdeckel,
  das \emph{Cover}, etwas, was man in einem getrennten Dokument
  erstellt. Schließlich hat er oft eine sehr individuelle Gestalt. Es spricht
  auch nichts dagegen, hierfür ein Grafik- oder DTP-Programm zu Hilfe zu
  nehmen. Ein getrenntes Dokument sollte auch deshalb verwendet werden, weil
  es später auf ein anderes Druckmedium, etwa Karton, und möglicherweise mit
  einem anderen Drucker ausgegeben werden soll.
\end{Explain}
%
\EndIndex{Cmd}{titlehead}%
\EndIndex{Cmd}{subject}%
\EndIndex{Cmd}{title}%
\EndIndex{Cmd}{subtitle}%
\EndIndex{Cmd}{author}%
\EndIndex{Cmd}{date}%
\EndIndex{Cmd}{publishers}%
\EndIndex{Cmd}{and}%
\EndIndex{Cmd}{thanks}%


\begin{Declaration}
  \Macro{uppertitleback}\Parameter{Titelrückseitenkopf}\\
  \Macro{lowertitleback}\Parameter{Titelrückseitenfuß}
\end{Declaration}%
\BeginIndex{Cmd}{uppertitleback}%
\BeginIndex{Cmd}{lowertitleback}%
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
\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
  Haftungsausschluss mit Hilfe von \Macro{uppertitleback}
  gesetzt.}{Beispielsweise hätte man die Verlagsinformationen zu diesem Buch
  wahlweise mit \Macro{uppertitleback} oder \Macro{lowertitleback} setzen
  können.}%
%
\EndIndex{Cmd}{uppertitleback}%
\EndIndex{Cmd}{lowertitleback}%


\begin{Declaration}
  \Macro{dedication}\Parameter{Widmung}
\end{Declaration}%
\BeginIndex{Cmd}{dedication}%
{\KOMAScript} bietet eine eigene Widmungsseite. Diese
Widmung\Index{Widmung} wird zentriert und in etwas größerer Schrift
gesetzt. Die Rückseite ist wie bei der Seite mit dem Schmutztitel
grundsätzlich leer. Die Widmungsseite wird zusammen mit der restlichen
Titelei mit \Macro{maketitle} ausgegeben und muss daher vor dieser
Anweisung definiert sein.

\begin{Example}
  Nehmen wir dieses Mal an, dass Sie einen Gedichtband schreiben, den
  Sie Ihrer Frau widmen wollen. Das könnte wie folgt aussehen:
\ifCommonmaincls
\begin{lstcode}
  \documentclass{scrbook}
  \usepackage{ngerman}
  \begin{document}
  \extratitle{\textbf{\Huge In Liebe}}
  \title{In Liebe}
  \author{Prinz Eisenherz}
  \date{1412}
  \lowertitleback{Dieser Gedichtband wurde mit Hilfe 
    von {\KOMAScript} und {\LaTeX} gesetzt.}
  \uppertitleback{Selbstverlach\par
    Auf"|lage: 1 Exemplar}
  \dedication{Meinem Schnuckelchen\\
    in ewiger Liebe\\
    von Deinem Hasenboppelchen.}
  \maketitle
  \end{document}
\end{lstcode}
\else
\begin{lstcode}
  \documentclass{book}
  \usepackage[extendedfeature=title]{scrextend}
  \usepackage{ngerman}
  \begin{document}
  \extratitle{%
    \textbf{\Huge In Liebe}}
  \title{In Liebe}
  \author{Prinz Eisenherz}
  \date{1412}
  \lowertitleback{%
    Dieser Gedichtband wurde mit Hilfe von 
    {\KOMAScript} und {\LaTeX} gesetzt.}
  \uppertitleback{%
    Selbstverlach\par
    Auf"|lage: 1 Exemplar}
  \dedication{%
    Meinem Schnuckelchen\\
    in ewiger Liebe\\
    von Deinem Hasenboppelchen.}
  \maketitle
  \end{document}
\end{lstcode}
\fi
  Ich bitte, die Kosenamen entsprechend Ihren Vorlieben zu ersetzen.
\end{Example}
%
\EndIndex{Cmd}{dedication}%
%
\EndIndex{Cmd}{maketitle}%
%
\EndIndex{}{Titel}
\fi% IgnoreThis

\or %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<15>>

\section{Schlauer Spruch}
\label{sec:\csname label@base\endcsname.dictum}%
\ifshortversion\IgnoreThisfalse\IfNotCommon{maincls}{\IgnoreThistrue}\fi%
\ifIgnoreThis
Es gilt sinngemäß, was in \autoref{sec:maincls.dictum} geschrieben
wurde. \IfCommon{scrextend}{Allerdings werden von \Package{scrextend} die
  Anweisungen \Macro{setchapterpreamble} und \Macro{setpartpreamble} nicht
  definiert. Ob die verwendete Klasse eine entsprechende Anweisung bietet, ist
  der Anleitung zur jeweiligen Klasse zu entnehmen.}
\else
\BeginIndex{}{Spruch}%
\BeginIndex{}{Zitat}%
\BeginIndex{}{Redewendung}%

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.


\begin{Declaration}
  \Macro{dictum}\OParameter{Urheber}\Parameter{Spruch}\\
  \Macro{dictumwidth}\\
  \Macro{dictumauthorformat}\Parameter{Urheber}\\
  \Macro{raggeddictum}\\
  \Macro{raggeddictumtext}\\
  \Macro{raggeddictumauthor}
\end{Declaration}%
\BeginIndex{Cmd}{dictum}%
\BeginIndex{Cmd}{dictumwidth}%
\BeginIndex{Cmd}{dictumauthorformat}%
\BeginIndex{Cmd}{raggeddictum}%
\BeginIndex{Cmd}{raggeddictumtext}%
\BeginIndex{Cmd}{raggeddictumauthor}%
Ein solcher Spruch kann mit der Anweisung \Macro{dictum} gesetzt werden. %
\IfCommon{maincls}{Bei \KOMAScript-Klassen wird für Kapitel oder die Teile
  empfohlen, \Macro{dictum} als obligatorisches Argument einer der Anweisungen
  \Macro{setchapterpreamble} oder \Macro{setpartpreamble} (siehe
  \autoref{sec:maincls.structure},
  \autopageref{desc:maincls.cmd.setchapterpreamble}) zu verwenden. Dies ist
  jedoch nicht zwingend.\par}%
Der Spruch wird 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
\lstinline;0.3333\textwidth;, also ein Drittel der jeweiligen Textbreite. Die
Box selbst wird mit der Anweisung \Macro{raggeddictum}
ausgerichtet. Voreingestellt ist dabei
\Macro{raggedleft}\IndexCmd{raggedleft}, also rechtsbündig.
\Macro{raggeddictum} kann mit Hilfe von \Macro{renewcommand} umdefiniert
werden.

Innerhalb der Box wird der \PName{Spruch} mit \Macro{raggeddictumtext}
angeordnet. Voreingestellt ist hier \Macro{raggedright}\IndexCmd{raggedright},
also linksbündig. Eine Umdefinierung ist auch hier mit \Macro{renewcommand}
möglich. Die Ausgabe erfolgt in der für Element \FontElement{dictumtext}
eingestellten Schriftart, die mit den Anweisungen \Macro{setkomafont} und
\Macro{addtokomafont} (siehe \autoref{sec:\csname
  label@base\endcsname.textmarkup}, \autopageref{desc:\csname
  label@base\endcsname.cmd.setkomafont}) geändert werden kann. Die
Voreinstellung entnehmen Sie bitte \autoref{tab:maincls.dictumfont}%
\IfNotCommon{maincls}{, \autopageref{tab:maincls.dictumfont}}%
.

Ist ein \PName{Urheber} angegeben, so wird dieser mit einer Linie über die
gesamte Breite der \Macro{parbox} vom \PName{Spruch} abgetrennt.  Mit
\Macro{raggeddictumauthor} wird die Ausrichtung 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
\Macro{Urheber} als Argument. In der Voreinstellung ist
\Macro{dictumauthorformat} als
\begin{lstcode}[aboveskip={1ex plus 2ex},belowskip={1ex plus 2ex}]
  \newcommand*{\dictumauthorformat}[1]{(#1)}
\end{lstcode}
definiert. Der \PName{Urheber} wird also in runde Klammern gesetzt. Für das
Element \PName{dictumauthor} kann dabei eine Abweichung der Schrift von der
des Elementes \PName{dictumtext} definiert werden. Die Voreinstellung
entnehmen Sie bitte \autoref{tab:maincls.dictumfont}. Eine Änderung ist mit
Hilfe der Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} (siehe
\autoref{sec:\csname label@base\endcsname.textmarkup},
\autopageref{desc:\csname label@base\endcsname.cmd.setkomafont}) möglich.%
%
\ifCommonmaincls
\begin{table}
  \centering%
  \caption{Schriftvoreinstellungen für die Elemente des Spruchs}
  \begin{tabular}{ll}
    \toprule
    Element & Voreinstellung \\
    \midrule
    \FontElement{dictumtext} & 
    \Macro{normalfont}\Macro{normalcolor}\Macro{sffamily}\Macro{small}\\
    \FontElement{dictumauthor} &
    \Macro{itshape}\\
    \bottomrule
  \end{tabular}
  \label{tab:maincls.dictumfont}
\end{table}

Wird \Macro{dictum} innerhalb der Anweisung \Macro{setchapterpreamble} oder
\Macro{setpartpreamble} (siehe \autoref{sec:maincls.structure},
\autopageref{desc:maincls.cmd.setchapterpreamble}) verwendet, so ist
Folgendes zu beachten: Die horizontale Anordnung erfolgt immer mit
\Macro{raggeddictum}. Das optionale Argument zur horizontalen Anordnung, das
die beiden Anweisungen vorsehen, bleibt daher ohne Wirkung. \Macro{textwidth}
ist nicht die Breite des gesamten Textkörpers, sondern die aktuelle
Textbreite. Ist also die Breite \Macro{dictumwidth} als
\lstinline;.5\textwidth; definiert und bei \Macro{setchapterpreamble} wird als
optionales Argument für die Breite ebenfalls \lstinline;.5\textwidth;
angegeben, so erfolgt die Ausgabe in einer Box, deren Breite ein Viertel der
Breite des Textkörpers ist. Es wird empfohlen, bei Verwendung von
\Macro{dictum} auf die optionale Angabe einer Breite bei
\Macro{setchapterpreamble} oder \Macro{setpartpreamble} zu verzichten.

Sollen mehrere schlaue Sprüche untereinander gesetzt werden, so sollten diese
durch einen zusätzlichen Abstand vertikal voneinander abgesetzt werden. Ein
solcher kann leicht mit der Anweisung \Macro{bigskip}\IndexCmd{bigskip}
gesetzt werden.

\begin{Example}
  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}
  \setchapterpreamble[u]{%
    \dictum[Schiller]{Drum prüfe, 
      wer sich ewig bindet \dots}}
  \chapter{Die moderne Ehe}
  \end{lstcode}
  Die Ausgabe erfolgt dann in der Form:
  \begin{ShowOutput}
    {\usekomafont{disposition}\usekomafont{chapter}%
      17\enskip Die moderne Ehe\par}
    \vspace{\baselineskip}
    \dictum[Schiller]{Drum prüfe, wer sich ewig bindet \dots}
  \end{ShowOutput}

  Wenn Sie wollen, dass nicht ein Drittel, sondern nur ein Viertel der
  verfügbaren Textbreite für den Spruch verwendet wird, so definieren Sie
  \Macro{dictumwidth} wie folgt um:
  \begin{lstcode}
  \renewcommand*{\dictumwidth}{.25\textwidth}
  \end{lstcode}
\end{Example}

An dieser Stelle sei noch auf das Paket~\cite{package:ragged2e} hingewiesen,
mit dem man Flattersatz mit Trennung erreichen kann.%
\fi
%
\EndIndex{Cmd}{dictum}%
\EndIndex{Cmd}{dictumwidth}%
\EndIndex{Cmd}{dictumauthorformat}%
\EndIndex{Cmd}{raggeddictum}%
\EndIndex{Cmd}{raggeddictumtext}%
\EndIndex{Cmd}{raggeddictumauthor}%
%
\EndIndex{}{Redewendung}%
\EndIndex{}{Zitat}%
\EndIndex{}{Spruch}%
\fi % IgnoreThis

\else %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% <<Error>>

\ClassError{scrguide}{No commen part \the\value{commonpar}\space known}{}

\fi

%%% Local Variables:
%%% mode: latex
%%% coding: iso-latin-1
%%% TeX-master: "../guide"
%%% End:
