summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/koma-script/doc/common-lists-de.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/koma-script/doc/common-lists-de.tex')
-rw-r--r--macros/latex/contrib/koma-script/doc/common-lists-de.tex893
1 files changed, 893 insertions, 0 deletions
diff --git a/macros/latex/contrib/koma-script/doc/common-lists-de.tex b/macros/latex/contrib/koma-script/doc/common-lists-de.tex
new file mode 100644
index 0000000000..0fbb070153
--- /dev/null
+++ b/macros/latex/contrib/koma-script/doc/common-lists-de.tex
@@ -0,0 +1,893 @@
+% ======================================================================
+% common-lists-de.tex
+% Copyright (c) Markus Kohm, 2001-2022
+%
+% 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.3c of the license.
+% The latest version of this license is in
+% http://www.latex-project.org/lppl.txt
+% and version 1.3c 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.md.
+% ======================================================================
+%
+% Paragraphs that are common for several chapters of the KOMA-Script guide
+% Maintained by Markus Kohm
+%
+% ======================================================================
+
+\KOMAProvidesFile{common-lists-de.tex}%
+ [$Date: 2022-06-05 12:40:11 +0200 (So, 05. Jun 2022) $
+ KOMA-Script guide (common paragraphs)]
+
+\section{Listen}
+\seclabel{lists}%
+\BeginIndexGroup
+\BeginIndex{}{Listen}%
+
+\IfThisCommonFirstRun{}{%
+ Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.lists}
+ geschrieben wurde. Falls Sie also
+ \autoref{sec:\ThisCommonFirstLabelBase.lists} bereits gelesen und verstanden
+ haben, können Sie auf \autopageref{sec:\ThisCommonLabelBase.lists.next} mit
+ \autoref{sec:\ThisCommonLabelBase.lists.next} fortfahren.%
+ \IfThisCommonLabelBaseOneOf{scrextend,scrlttr2}{ %
+ \IfThisCommonLabelBase{scrlttr2}{%
+ Das Paket \Package{scrletter}\OnlyAt{\Package{scrletter}} definiert
+ selbst keine Listenumgebungen, sondern überlässt diese der verwendeten
+ Klasse. Ist dies keine \KOMAScript-Klasse, so lädt es
+ \hyperref[cha:scrextend]{\Package{scrextend}}\IndexPackage{scrextend}%
+ \important{\hyperref[cha:scrextend]{\Package{scrextend}}}. %
+ }{}%
+ Allerdings werden vom Paket \Package{scrextend} nur die Umgebungen
+ \DescRef{\ThisCommonLabelBase.env.labeling},
+ \DescRef{\ThisCommonLabelBase.env.addmargin} und
+ \DescRef{\ThisCommonLabelBase.env.addmargin*} definiert. Alle anderen
+ Listenumgebungen bleiben der Verantwortung % und Kontrolle
+ der verwendeten Klasse überlassen.%
+ }{}%
+}
+
+\IfThisCommonLabelBase{scrextend}{}{%
+ {\LaTeX} und die Standardklassen\textnote{\KOMAScript{} vs. Standardklassen}
+ bieten verschiedene Umgebungen für Listen. All diese Umgebungen bietet
+ {\KOMAScript} selbstverständlich auch, teilweise jedoch mit leichten
+ Abwandlungen oder Erweiterungen. Grundsätzlich gilt, dass Listen -- auch
+ unterschiedlicher Art -- bis zu einer Tiefe von vier Listen geschachtelt
+ werden können. Eine tiefere Schachtelung wäre auch aus typografischen
+ Gründen kaum sinnvoll, da genau genommen schon mehr als drei Ebenen nicht
+ mehr überblickt werden können. Ich empfehle\textnote{Tipp!} in solchen
+ Fällen, die eine große Liste in mehrere kleinere Listen aufzuteilen.%
+}
+
+\IfThisCommonFirstRun{}{%
+ \IfThisCommonLabelBase{scrextend}{}{% Umbruchkorrektur
+ \iffalse % Umbruchkorrektur
+ Da Listen zu den Standardelementen von \LaTeX{} gehören, wurde in diesem
+ Abschnitt auf Beispiele verzichtet. %
+ \else%
+ Auf Beispiele wurde in diesem Abschnitt verzichtet. %
+ \fi%
+ Sie finden solche in \autoref{sec:\ThisCommonFirstLabelBase.lists} ab
+ \autopageref{sec:\ThisCommonFirstLabelBase.lists} oder in jeder
+ \LaTeX-Einführung.%
+ }%
+}
+
+
+\IfThisCommonLabelBase{scrextend}{\iffalse}{\csname iftrue\endcsname}
+ \begin{Declaration}
+ \begin{Environment}{itemize}
+ \begin{Body}
+ \Macro{item} \dots
+ \BodyDots
+ \end{Body}
+ \end{Environment}
+ \Macro{labelitemi}
+ \Macro{labelitemii}
+ \Macro{labelitemiii}
+ \Macro{labelitemiv}
+ \end{Declaration}%
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Die einfachste
+ Form einer Liste ist die Stichpunkt-\textnote{Stichpunktliste} oder
+ \Environment{itemize}-Liste. %
+ \iffalse % Umbruchoptimierungstext
+ Die Benutzer einer unbeliebten Textverarbeitung nennen diese Form der Liste
+ auch gerne \emph{Bulletpoints}. Vermutlich können sie sich nicht vorstellen,
+ dass je nach Ebene auch ein anderes Zeichen als ein fetter Punkt zur
+ Einleitung eines Stichpunkts verwendet werden kann. %
+ \fi%
+ Bei den \KOMAScript-Klassen werden je nach Ebene folgende Aufzählungszeichen
+ zur Einleitung eines Listenelements 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 diese leicht mit \Macro{renewcommand} umdefinieren.
+ \BeginIndex{FontElement}{itemizelabel}\LabelFontElement{itemizelabel}%
+ \BeginIndex{FontElement}{labelitemi}\LabelFontElement{labelitemi}%
+ \BeginIndex{FontElement}{labelitemii}\LabelFontElement{labelitemii}%
+ \BeginIndex{FontElement}{labelitemiii}\LabelFontElement{labelitemiii}%
+ \BeginIndex{FontElement}{labelitemiv}\LabelFontElement{labelitemiv}%
+ Die Schriftart\Index{Schrift>Art}\ChangedAt{v3.33}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}} der Zeichen für die einzelnen
+ Ebenen kann außerdem bei den \KOMAScript-Klassen mit Hilfe der Anweisungen
+ \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und
+ \DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (siehe
+ \autoref{sec:\ThisCommonLabelBase.textmarkup},
+ \DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) für die Elemente
+ \FontElement{labelitemi}\important{\FontElement{labelitemi}},
+ \FontElement{labelitemii}\important{\FontElement{labelitemii}},
+ \FontElement{labelitemiii}\important{\FontElement{labelitemiii}} und
+ \FontElement{labelitemiv}\important{\FontElement{labelitemiv}} geändert
+ werden. In der Voreinstellung verwenden diese alle die Schrifteinstellung
+ für Element
+ \FontElement{itemizelabel}\important{\FontElement{itemizelabel}}. Lediglich
+ Element \FontElement{labelitemii} verwendet zusätzlich
+ \Macro{bfseries}. Die Voreinstellung von \FontElement{itemizelabel} selbst
+ ist \Macro{normalfont}. Die einzelnen Stichpunkte der Umgebung werden mit
+ \Macro{item} eingeleitet.%
+ \IfThisCommonFirstRun{\iftrue}{%
+ \ In \autoref{sec:maincls.lists} auf \PageRefxmpl{maincls.env.itemize}
+ finden Sie ein Beispiel für die Anwendung.%
+ \csname iffalse\endcsname}
+ \begin{Example}
+ \phantomsection\xmpllabel{env.itemize}%
+ 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 zweimotorig
+ \begin{itemize}
+ \item{düsengetrieben}
+ \item{propellergetrieben}
+ \end{itemize}
+ \end{itemize}
+ \item Drehflügler
+ \end{itemize}
+ \item Motorräder
+ \item Automobile
+ \begin{itemize}
+ \item Rennwagen
+ \item Personenwagen
+ \item Lastwagen
+ \end{itemize}
+ \item Fahrräder
+ \end{itemize}
+ \end{lstcode}
+ Anschließend erhalten Sie:%
+ \iffree{}{\vskip 0pt plus \baselineskip}% Umbruchkorrektur
+ \begin{ShowOutput}[.5\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 zweimotorig
+ \begin{itemize}
+ \item{düsengetrieben}
+ \item{propellergetrieben}
+ \end{itemize}
+ \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
+ %
+ \EndIndexGroup
+
+
+ \begin{Declaration}
+ \begin{Environment}{enumerate}\labelsuffix[enumerate]
+ \begin{Body}
+ \Macro{item} \dots
+ \BodyDots
+ \end{Body}
+ \end{Environment}
+ \Macro{theenumi}
+ \Macro{theenumii}
+ \Macro{theenumiii}
+ \Macro{theenumiv}
+ \Macro{labelenumi}
+ \Macro{labelenumii}
+ \Macro{labelenumiii}
+ \Macro{labelenumiv}
+ \end{Declaration}%
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Die nummerierte
+ Liste\textnote{nummerierte Liste} ist ebenfalls sehr häufig zu finden und
+ bereits vom {\LaTeX}-Kern vorgesehen. Die Nummerierung\Index{Nummerierung}
+ erfolgt je nach Ebene in unterschiedlicher Art: mit arabischen Zahlen, mit
+ Kleinbuchstaben, mit kleinen römischen Zahlen und mit Großbuchstaben. Die
+ Art der Nummerierung wird dabei über die Makros \Macro{theenumi} bis
+ \Macro{theenumiv} festgelegt. Das Format der Ausgabe wird von den Makros
+ \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.%
+ \IfThisCommonFirstRun{\iftrue}{%
+ \ In \autoref{sec:maincls.lists} auf \PageRefxmpl{maincls.env.enumerate}
+ finden Sie ein Beispiel für die Anwendung.%
+ \csname iffalse\endcsname}
+ \begin{Example}
+ \phantomsection\xmpllabel{env.enumerate}%
+ Verkürzen wir das vorherige Beispiel und verwenden statt der
+ \DescRef{\ThisCommonLabelBase.env.itemize}- eine
+ \Environment{enumerate}-Umgebung:
+ % Übernehmen wir das Beispiel der
+ % \DescRef{\LabelBase.env.itemize}-Umgebung,
+ % wobei wir jede \DescRef{\LabelBase.env.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}%
+ \ExampleEndFix
+ \fi
+ %
+ \EndIndexGroup
+
+
+ \begin{Declaration}
+ \begin{Environment}{description}\labelsuffix[description]
+ \begin{Body}
+ \Macro{item}\OParameter{Stichwort} \dots
+ \BodyDots
+ \end{Body}
+ \end{Environment}
+ \end{Declaration}%
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Eine weitere
+ Listenform ist die Stichwortliste\textnote{Stichwortliste}. Sie dient in
+ erster Linie der Beschreibung einzelner Begriffe. Diese werden als optionale
+ Parameter bei \Macro{item} angegeben. %
+ \BeginIndex{FontElement}{descriptionlabel}%
+ \LabelFontElement{descriptionlabel}%
+ Die Schriftart\Index{Schrift>Art}\ChangedAt{v2.8p}{\Class{scrbook}\and
+ \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 \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und
+ \DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (siehe
+ \autoref{sec:\ThisCommonLabelBase.textmarkup},
+ \DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) für das Element
+ \FontElement{descriptionlabel}\important{\FontElement{descriptionlabel}}
+ (siehe \autoref{tab:\ThisCommonLabelBase.fontelements},
+ \autopageref{tab:\ThisCommonLabelBase.fontelements}) geändert werden. In der
+ Voreinstellung wird \Macro{sffamily}""\Macro{bfseries} verwendet.%
+ \IfThisCommonFirstRun{\iftrue}{%
+ \ In \autoref{sec:maincls.lists} auf \PageRefxmpl{maincls.env.description}
+ finden Sie ein Beispiel für die Anwendung.%
+ \csname iffalse\endcsname}
+ \begin{Example}
+ \phantomsection\xmpllabel{env.description}%
+ 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
+ %
+ \EndIndexGroup%
+\fi
+
+\begin{Declaration}
+ \begin{Environment}{labeling}\OParameter{Trennzeichen}
+ \Parameter{längstes Schlüsselwort}
+ \labelsuffix[labeling]
+ \begin{Body}
+ \Macro{item}\OParameter{Stichwort} \dots
+ \BodyDots
+ \end{Body}
+ \end{Environment}
+\end{Declaration}%
+Eine andere Form der %
+\IfThisCommonLabelBase{scrextend}{%
+ in vielen Klassen als
+ \DescRef{\ThisCommonFirstLabelBase.env.description}-Umgebung vorhandenen %
+}{}%
+Stichwortliste\textnote{alternative Stichwortliste} ist nur
+bei\IfThisCommonLabelBase{scrextend}{}{ den} {\KOMAScript}-Klassen%
+\IfThisCommonLabelBase{scrextend}{ und \Package{scrextend} }{%
+ \IfThisCommonLabelBase{scrlttr2}{ und
+ \hyperref[cha:scrextend]{\Package{scrextend}} }{}%
+}%
+vorhanden: die \Environment{labeling}-Umgebung. Im Unterschied
+\IfThisCommonLabelBaseOneOf{maincls,scrextend}{zu}{zur zuvor vorgestellten
+ Umgebung} %
+\IfThisCommonLabelBase{scrextend}{%
+ \DescRef{\ThisCommonFirstLabelBase.env.description}%
+}{%
+ \DescRef{\ThisCommonLabelBase.env.description}%
+} kann bei \Environment{labeling} ein Muster angegeben werden, dessen Länge
+die Einrücktiefe aller Stichpunkte ergibt. Zwischen Stichpunkt und
+Beschreibungstext kann ein optionales \PName{Trennzeichen} festgelegt
+werden. %
+\BeginIndexGroup
+\BeginIndex{FontElement}{labelinglabel}\LabelFontElement{labelinglabel}%
+\BeginIndex{FontElement}{labelingseparator}%
+\LabelFontElement{labelingseparator}%
+Die Schriftart\Index{Schrift>Art}%
+\IfThisCommonLabelBase{maincls}{%
+ \ChangedAt{v3.02}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+}{%
+ \IfThisCommonLabelBase{scrlttr2}{%
+ \ChangedAt{v3.02}{\Class{scrlttr2}}%
+ }{%
+ \IfThisCommonLabelBase{scrextend}{%
+ \ChangedAt{v3.02}{\Package{scrextend}}%
+ }{\InternalCommonFileUsageError}%
+ }%
+}%
+, die für die Hervorhebung des Schlüsselworts verwendet wird, kann mit Hilfe
+\IfThisCommonLabelBase{scrextend}{von}{der Anweisungen}
+\DescRef{\ThisCommonLabelBase.cmd.setkomafont} und
+\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (siehe
+\autoref{sec:\ThisCommonLabelBase.textmarkup},
+\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) für das Element
+\FontElement{labelinglabel}\IndexFontElement{labelinglabel} (siehe
+\autoref{tab:\ThisCommonLabelBase.fontelements},
+\autopageref{tab:\ThisCommonLabelBase.fontelements}) geändert werden. Für die
+davon abweichende Schriftart der Trennzeichen ist das Element
+\FontElement{labelingseparator}\IndexFontElement{labelingseparator} (siehe
+ebenfalls \autoref{tab:\ThisCommonLabelBase.fontelements},
+\autopageref{tab:\ThisCommonLabelBase.fontelements}) zuständig. Beide sind in
+der Voreinstellung\textnote{Voreinstellung} leer, es findet also keine
+Schriftumschaltung statt.%
+\IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}
+ \begin{Example}
+ \phantomsection\xmpllabel{env.labeling}%
+ \IfThisCommonLabelBase{scrextend}{%
+ Eine einfache Liste könnte beispielsweise wie folgt definiert werden:%
+ }{%
+ Wir schreiben das Beispiel der
+ \DescRef{\ThisCommonLabelBase.env.description}-Umgebung etwas um:%
+ }%
+\begin{lstcode}
+ \setkomafont{labelinglabel}{\ttfamily}
+ \setkomafont{labelingseparator}{\normalfont}
+ \begin{labeling}[~--]{myheadings}
+ \item[empty]
+ Seitenstil für leere Seiten ohne Kopf und Fuß
+ \item[plain]
+ Seitenstil für Kapitelanfänge ganz ohne
+ Kolumnentitel
+ \item[headings]
+ Seitenstil für automatische Kolumnentitel
+ \item[myheadings]
+ Seitenstil für manuelle Kolumnentitel
+ \end{labeling}
+\end{lstcode}
+ Als Ergebnis erhalten wir dann:
+ \begin{ShowOutput}
+ \setkomafont{labelinglabel}{\ttfamily}
+ \setkomafont{labelingseparator}{\normalfont}
+ \begin{labeling}[~--]{myheadings}
+ \item[empty]
+ Seitenstil für leere Seiten ohne Kopf und Fuß
+ \item[plain]
+ Seitenstil für Kapitelanfänge ganz ohne
+ Kolumnentitel
+ \item[headings]
+ Seitenstil für automatische Kolumnentitel
+ \item[myheadings]
+ Seitenstil für manuelle Kolumnentitel
+ \end{labeling}
+ \end{ShowOutput}
+ Wie in diesem Beispiel zu sehen ist, kann eine eventuell geforderte
+ Schriftumschaltung in bei \KOMAScript{} gewohnter Weise erreicht
+ werden. Da sich die Schriftumschaltung für das Schlüsselwort aber auch auf
+ die Trennzeichen auswirkt, kann es eventuell erforderlich sein, die
+ Schriftumschaltung dafür explizit aufzuheben.
+ \end{Example}
+\fi%
+\EndIndexGroup%
+\IfThisCommonFirstRun{%
+ 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.%
+}{%
+ \ In \autoref{sec:maincls.lists} auf \PageRefxmpl{maincls.env.labeling}
+ finden Sie ein Beispiel für die Anwendung der Umgebung.%
+}%
+\EndIndexGroup
+
+
+\IfThisCommonLabelBase{scrextend}{\iffalse}{\csname iftrue\endcsname}
+ \begin{Declaration}
+ \begin{Environment}{verse}\end{Environment}
+ \end{Declaration}%
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Die
+ \Environment{verse}-Umgebung\textnote{Versform} wird normalerweise nicht als
+ Listenumgebung wahrgenommen, da hier nicht mit \Macro{item} gearbeitet
+ wird. Stattdessen wird wie innerhalb der \Environment{flushleft}-Umgebung
+ mit festen Zeilenumbrüchen gearbeitet. Intern handelt es sich jedoch sowohl
+ bei den Standardklassen als auch bei {\KOMAScript} durchaus um eine
+ Listenumgebung.
+
+ Die \Environment{verse}-Umgebung findet hauptsächlich für
+ Gedichte\Index{Gedichte} Anwendung. Dabei werden die Zeilen links und rechts
+ eingezogen. Einzelne Verse werden mit einem festen Zeilenumbruch, also mit
+ \verb|\\|\IndexCmd{\textbackslash} 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\textnote{Seitenumbruch} erfolgt, so
+ verwendet man ganz normal \verb|\\*|\IndexCmd{\textbackslash*} anstelle von
+ \verb|\\|.%
+ \IfThisCommonFirstRun{\iftrue}{%
+ \par In \autoref{sec:maincls.lists} auf \PageRefxmpl{maincls.env.verse}
+ finden Sie ein Beispiel für die Anwendung.%
+ \csname iffalse\endcsname}
+ \begin{Example}
+ \phantomsection\xmpllabel{env.verse}%
+ 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}
+ \iffree{}{\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}
+ \iffree{}{\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, kann
+ man zusätzlich \Macro{interlinepenalty}\IndexCmd{interlinepenalty} auf
+ 10000 setzen:
+\begin{lstcode}
+ \begin{verse}\interlinepenalty 10000
+ 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}
+ \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{lstcode}
+ \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{lstcode}
+ \begin{ShowOutput}
+ \iffree{}{\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 %
+ \iffalse %
+ In diesen Beispielen wurde übrigens jeweils \Macro{bigskip} verwendet,
+ um zwei Sprüche voneinander zu trennen.%
+ \fi %
+ \end{Example}%
+ \vskip -1\ht\strutbox plus .75\strutbox% Ende Beispiel + Beschreibung
+ \fi
+ %
+ \EndIndexGroup
+
+
+ \iffalse% Umbruchkorrekturvarianten
+ \begin{Declaration}
+ \begin{Environment}{quote}\end{Environment}
+ \end{Declaration}%
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Dies ist
+ intern ebenfalls eine Listenumgebung\textnote{Blockzitat mit
+ Absatzabstand} und sowohl bei den Standardklassen als auch bei
+ {\KOMAScript} zu finden. Der Inhalt der Umgebung wird im Blocksatz mit
+ beidseitigem Einzug gesetzt. Die Umgebung wird häufig verwendet, um
+ längere Zitate\Index{Zitat} abzusetzen. Dabei werden Absätze innerhalb der
+ Umgebung durch einen vertikalen Abstand gekennzeichnet.%
+ \EndIndexGroup
+
+ \begin{Declaration}
+ \begin{Environment}{quotation}\end{Environment}
+ \end{Declaration}%
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Diese
+ Umgebung\textnote{Blockzitat mit Absatzeinzug} ist mit
+ \DescRef{\ThisCommonLabelBase.env.quote} vergleichbar. Während bei
+ \DescRef{\ThisCommonLabelBase.env.quote} Absätze durch vertikalen Abstand
+ gekennzeichnet werden, wird bei \Environment{quotation} mit horizontalem
+ Einzug der ersten Zeile eines Absatzes gearbeitet. Dies gilt auch für den
+ ersten Absatz einer \Environment{quotation}-Umgebung. Wollen Sie dort den
+ Einzug verhindern, müssen Sie die
+ \Macro{noindent}-Anweisung\IndexCmd{noindent} voranstellen.%
+ \else %
+ \begin{Declaration}
+ \begin{Environment}{quote}\end{Environment}
+ \begin{Environment}{quotation}\end{Environment}
+ \end{Declaration}%
+ \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Diese beiden
+ Umgebungen\textnote{Blockzitate} sind intern ebenfalls Listenumgebungen
+ und sowohl bei den Standardklassen als auch bei {\KOMAScript} zu finden.
+ Beide Umgebungen setzen Blocksatz, der rechts und links eingezogen
+ ist. Verwendet werden die Umgebungen häufig, um längere
+ Zitate\Index{Zitat} abzusetzen. Der Unterschied zwischen beiden liegt in
+ der Art und Weise, wie Absätze abgesetzt werden. Während bei
+ \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
+ \IfThisCommonLabelBase{maincls}{%
+ , außer es wird \Macro{noindent}\IndexCmd{noindent} vorangestellt.%
+ }{%
+ \IfThisCommonLabelBase{scrlttr2}{%
+ . Wollen Sie dort den Einzug verhindern, müssen Sie die
+ \Macro{noindent}-Anweisung\IndexCmd{noindent} voranstellen.%
+ }{\InternalCommonFileUsageError}%
+ }%
+ \fi % Umbruchkorrekturvarianten
+ \IfThisCommonFirstRun{\iftrue}{%
+ \ In \autoref{sec:maincls.lists} auf \PageRefxmpl{maincls.env.quote}
+ finden Sie ein Beispiel für die Anwendung.%
+ \csname iffalse\endcsname}
+ \begin{Example}
+ \phantomsection\xmpllabel{env.quote}%
+ Sie wollen eine kleine Anekdote hervorheben. Also schreiben Sie
+ unter Verwendung der Umgebung \Environment{quotation}:%
+\begin{lstcode}
+ \documentclass[paper=a5,pagesize]{scrartcl}
+ \usepackage[ngerman]{babel}
+ \begin{document}
+ Ein kleines Beispiel für eine Anekdote, die sich
+ einst in Schwaben zugetragen haben soll:
+ \begin{quotation}
+ Es klingelt an der Tür eines Pfarrhauses in
+ Stuttgart. Als die Haushälterin öffnet, steht
+ ein unrasierter Mann in reichlich schäbigem
+ 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,
+ "`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{document}
+\end{lstcode}
+ Das Ergebnis könnte dann so aussehen:
+ \begin{ShowOutput}
+ \iftrue% 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 reichlich schäbigem
+ 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,
+ \iffalse% 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}%
+ \iffree{}{\IfThisCommonLabelBase{maincls}{\clearpage}{}}% Umbruchkorrektur!!!!
+ Zum Vergleich sei das Ganze anstelle von \Environment{quotation} auch
+ noch mit einer \DescRef{\LabelBase.env.quote}-Umgebung gezeigt:%
+ \begin{ShowOutput}
+ \iftrue% Umbruchkorrekturtext
+ Ein kleines Beispiel für eine Anekdote, die sich einst
+ 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 reichlich
+ schäbigem 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,
+ \iffalse% 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
+ %
+ \EndIndexGroup
+\fi
+
+\begin{Declaration}
+ \begin{Environment}{addmargin}\OParameter{linker Einzug}\Parameter{Einzug}
+ \end{Environment}
+ \begin{Environment}{addmargin*}\OParameter{innerer Einzug}\Parameter{Einzug}
+ \end{Environment}
+\end{Declaration}
+Wie bei %
+\IfThisCommonLabelBase{scrextend}{%
+ den in den Standardklassen und den \KOMAScript-Klassen vorhandenen
+ Umgebungen \DescRef{\ThisCommonFirstLabelBase.env.quote} und
+ \DescRef{\ThisCommonFirstLabelBase.env.quotation}%
+}{%
+ \DescRef{\ThisCommonLabelBase.env.quote} und
+ \DescRef{\ThisCommonLabelBase.env.quotation}%
+} %
+handelt\textnote{allgemeine Einzugsumgebung} es sich bei
+\Environment{addmargin} um eine Umgebung, die den Rand\Index{Rand}
+verändert. Im Unterschied zu den beiden erstgenannten Umgebungen kann der
+Anwender jedoch bei \Environment{addmargin} wählen, um welchen Wert der Rand
+verändert werden soll. Des Weiteren verändert die Umgebung den Absatzeinzug
+und den Absatzabstand nicht. Es wird auch kein zusätzlicher vertikaler Abstand
+vor und nach der Umgebung eingefügt.
+
+Ist nur das obligatorische Argument \PName{Einzug} angegeben, so wird der
+Inhalt der Umgebung rechts und links um diesen Wert eingezogen. Ist das
+optionale Argument \PName{linker Einzug} hingegen angegeben, so wird links
+abweichend von \PName{Einzug} der Wert \PName{linker Einzug} zum Rand addiert.
+
+Die Sternvariante \Environment{addmargin*}\important{\Environment{addmargin*}}
+unterscheidet sich nur im doppelseitigen Satz von der Variante ohne Stern,
+wobei der Unterschied auch nur dann auf"|tritt, wenn das optionale Argument
+\PName{innerer Einzug} verwendet wird. Dabei wird dann der Wert von
+\PName{innerer Einzug} zum inneren Randanteil der Seite addiert. Dies ist bei
+rechten Seiten der linke Rand der Seite, bei linken Seiten jedoch der rechte
+Rand der Seite. \PName{Einzug} gilt dann für den jeweils anderen Rand.
+
+Bei beiden Varianten der Umgebung sind für alle Parameter auch negative Werte
+erlaubt. % Umbruchkorrektur
+\IfThisCommonLabelBase{scrextend}{%
+ Die Umgebung ragt dann entsprechend in den Rand hinein.%
+}{%
+ Damit kann man erreichen, dass die Umgebung in den Rand hineinragt.%
+}%
+\IfThisCommonFirstRun{\iftrue}{%
+ \ Im Beispiel in \autoref{sec:maincls.lists} auf
+ \PageRefxmpl{maincls.env.addmargin} wird dies gezeigt.%
+ \csname iffalse\endcsname}%
+ \begin{Example}
+ \phantomsection\xmpllabel{env.addmargin}%
+ 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*}%
+ }
+ Zur Demonstration sei die Definition der Umgebung in der Umgebung selbst
+ gesetzt:
+ \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}
+ Nicht zwingend schön, aber es zeigt den Nutzen.
+ \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}
+\fi%
+
+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
+\DescRef{\ThisCommonLabelBase.cmd.Ifthispageodd}
+(\autoref{sec:\ThisCommonLabelBase.oddOrEven},
+\DescPageRef{\ThisCommonLabelBase.cmd.Ifthispageodd}) und
+\iffree{\Macro{ifthispagewasodd}}{%
+ \DescRef{maincls-experts.cmd.ifthispagewasodd}}
+(\autoref{sec:maincls-experts.addInfos},
+\DescPageRef{maincls-experts.cmd.Ifthispageodd}).%
+\IfThisCommonLabelBase{scrlttr2}{}{%
+\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 \DescRef{maincls-experts.option.parskip} in
+ \autoref{sec:maincls-experts.addInfos},
+ \DescPageRef{maincls-experts.option.parskip} auch diesem
+ Thema. Ebenfalls im Expertenteil in \autoref{sec:maincls-experts.addInfos},
+ \DescPageRef{maincls-experts.env.addmargin*} wird die Problematik von
+ mehrseitigen \Environment{addmargin*}-Umgebungen behandelt.
+\end{Explain}}%
+%
+\EndIndexGroup
+%
+\EndIndexGroup
+
+%%% Local Variables:
+%%% mode: latex
+%%% TeX-master: "scrguide-de.tex"
+%%% coding: utf-8
+%%% ispell-local-dictionary: "de_DE"
+%%% eval: (flyspell-mode 1)
+%%% End: