summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex')
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex603
1 files changed, 348 insertions, 255 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex
index 2bf8540ab0c..8123af22b72 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlayer.tex
-% Copyright (c) Markus Kohm, 2013
+% Copyright (c) Markus Kohm, 2013-2014
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer.tex
-% Copyright (c) Markus Kohm, 2013
+% Copyright (c) Markus Kohm, 2013-2014
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,8 +45,8 @@
%
% ============================================================================
-\KOMAProvidesFile{scrlayer.tex}
- [$Date: 2013-12-10 19:50:34 +0100 (Di, 10. Dez 2013) $
+\KOMAProvidesFile{scrlayer.tex}%
+ [$Date: 2014-03-07 09:39:28 +0100 (Fri, 07 Mar 2014) $
KOMA-Script guide (chapter:scrlayer)]
\chapter[{Definition von Ebenen und Seitenstilen mit \Package{scrlayer}}]
@@ -54,8 +54,8 @@
mit \Package{scrlayer}}
\labelbase{scrlayer}
-\BeginIndex{Package}{scrlayer}
-
+\BeginIndex{Package}{scrlayer}%
+\BeginIndex{}{Ebenen}%
Anwender von Grafikprogrammen sind mit dem Modell der Ebenen für eine Seite
bereits vertraut. \LaTeX{} selbst ist ein solches Modell jedoch eher
fremd. Dennoch gibt es bereits einige Pakete wie \Package{eso-pic} oder
@@ -121,16 +121,16 @@ kümmern brauchen.
\end{Declaration}
\BeginIndex{Cmd}{if@chapter}%
Wenn \Macro{if@chapter} definiert ist und \Macro{iftrue}\IndexCmd{iftrue}
-entspricht, wird \Package{scrlayer} bei seiner Arbeit die Kapitel-Ebene
-beispielsweise bei Option \Option{automark} mit berücksichtigen. Wenn es
-definiert ist, aber nicht \Macro{iftrue} entspricht, behandelt
+entspricht, berücksichtigt \Package{scrlayer} bei seiner Arbeit die
+Kapitel-Ebene beispielsweise bei Verwendung von Option \Option{automark}. Wenn
+es definiert ist, aber nicht \Macro{iftrue} entspricht, behandelt
\Package{scrlayer} nur die Ebenen der Befehle \Macro{part}, \Macro{section},
\Macro{subsection}, \Macro{sub\dots subsection}, \Macro{paragraph},
\Macro{subparagraph}, \Macro{sub\dots subparagraph}. Wenn das Makro nicht
-definiert ist, macht \Package{scrlayer} die Frage, ob auch die
-Kapitel-Ebene zu behandeln ist, an der Anweisung \Macro{chapter} fest. Ist
-diese Anweisung definiert und entspricht sie nicht \Macro{relax}, dann
-definiert \Package{scrlayer} das Makro \Macro{if@chapter} selbst als Synonym für
+definiert ist, macht \Package{scrlayer} die Frage, ob auch die Kapitel-Ebene
+zu behandeln ist, an der Anweisung \Macro{chapter} fest. Ist diese Anweisung
+definiert und entspricht sie nicht \Macro{relax}, dann definiert
+\Package{scrlayer} das Makro \Macro{if@chapter} selbst als Synonym für
\Macro{iftrue}. Anderenfalls definiert es \Macro{if@chapter} als Synonym für
\Macro{iffalse}\IndexCmd{iffalse}.%
%
@@ -141,13 +141,14 @@ definiert \Package{scrlayer} das Makro \Macro{if@chapter} selbst als Synonym für
\Macro{fi}
\end{Declaration}
\BeginIndex{Cmd}{if@mainmatter}%
-Klassen wie \Class{book} definieren \Macro{frontmatter}\IndexCmd{frontmatter},
+Klassen wie \Class{book} oder \Class{scrbook} bieten
+\Macro{frontmatter}\IndexCmd{frontmatter},
\Macro{mainmatter}\IndexCmd{mainmatter} und
\Macro{backmatter}\IndexCmd{backmatter}, um zwischen Vorderteil, Hauptteil und
-Endteil eines Buches umschalten zu können. In der Regel verwenden diese Klassen
-intern \Macro{if@mainmatter}, um entscheiden zu können, ob gerade im Hauptteil
-des Dokuments gearbeitet wird oder nicht. Klassen wie \Class{report} oder
-\Class{article} haben kein \Macro{frontmatter}, \Macro{mainmatter} oder
+Endteil eines Buches umschalten zu können. In der Regel verwenden diese
+Klassen intern \Macro{if@mainmatter}, um entscheiden zu können, ob gerade im
+Hauptteil des Dokuments gearbeitet wird oder nicht. Klassen wie \Class{report}
+oder \Class{article} haben kein \Macro{frontmatter}, \Macro{mainmatter} oder
\Macro{backmatter} und deshalb auch kein \Macro{if@mainmatter}. Stattdessen
gehen sie davon aus, dass es nur einen Hauptteil gibt.
@@ -160,11 +161,11 @@ schlicht \Macro{iftrue}\IndexCmd{iftrue} entsprechen. Wenn also
\Macro{if@mainmatter} nicht definiert ist, dann definiert \Package{scrlayer}
es als Synonym für \Macro{iftrue}.
-Einige Klassen haben jedoch tatsächlich \Macro{frontmatter},
+Einige Klassen definieren jedoch \Macro{frontmatter},
\Macro{mainmatter} oder \Macro{backmatter} und trotzdem kein
-\Macro{if@mainmatter}. In diesem Fall definiert \Package{scrlayer} ebenfalls
-\Macro{if@mainmatter} als Synonym für \Macro{iftrue} und erweitert
-die gefundenen Definitionen von \Macro{frontmatter}, \Macro{mainmatter} und
+\Macro{if@mainmatter}. In diesem Fall definiert \Package{scrlayer}
+\Macro{if@mainmatter} ebenfalls als Synonym für \Macro{iftrue} und erweitert
+darüber hinaus die gefundenen Definitionen von \Macro{frontmatter}, \Macro{mainmatter} und
\Macro{backmatter} so, dass diese \Macro{if@mainmatter} passend
umdefinieren. Falls es jedoch weitere, vergleichbare Befehle zur Umschaltung
zwischen unterschiedlichen Dokumentteilen gibt, so kennt \Package{scrlayer}
@@ -175,7 +176,9 @@ Klassenautors angewiesen.%
\begin{Declaration}
\Macro{DeclareSectionNumberDepth}%
- \Parameter{Name der Gliederungsebene}\Parameter{Tiefe der Gliederungsebene}
+ \Parameter{Name der Gliederungsebene}\\
+ \hphantom{\XMacro{DeclareSectionNumberDepth}}%
+ \Parameter{Tiefe der Gliederungsebene}
\end{Declaration}
\BeginIndex{Cmd}{DeclareSectionNumberDepth}%
Jeder Gliederungsebene ist normalerweise eine nummerische Tiefe
@@ -185,20 +188,21 @@ der jeweiligen Klasse bekannt, in der die Gliederungsbefehle definiert
sind. Diese setzt dann in den entsprechenden \LaTeX-Befehlen selbst die
zugehörigen Nummern ein.
+{\setlength{\emergencystretch}{1em}%
Das Paket \Package{scrlayer} benötigt ebenfalls Informationen über die
-Hierarchie. Mit Hilfe der Anweisung \Macro{DeclareSectionNumberDepth} kann
+Hierarchie. Mit Hilfe von \Macro{DeclareSectionNumberDepth} kann
\Package{scrlayer} zum Namen einer Gliederungsebene die zugehörige nummerische
-Tiefe bekannt gemacht werden. Für die Standardklassen wäre \Parameter{Name der
+Tiefe bekannt gemacht werden. Für die Standardklassen wäre \PName{Name der
Gliederungsebene} beispielsweise \PValue{part}, \PValue{chapter},
\PValue{section}, \PValue{subsection}, \PValue{subsubsection},
\PValue{paragraph} oder \PValue{subparagraph} und die jeweils zugehörige
-\PName{Tiefe der Gliederungsebene} wäre -1, 0, 1, 2, 3, 4 oder 5.
+\PName{Tiefe der Gliederungsebene} wäre -1, 0, 1, 2, 3, 4 oder 5.\par}
Das Paket \Package{scrlayer} versucht diese nummerischen Werte zunächst beim
-Laden des Pakets und dann noch einmal während
-\Macro{begin}\PParameter{document} selbst zu ermitteln. Aber für den Fall,
-dass dies einmal nicht zu einem korrekten Ergebnis führt, beispielsweise falls
-es vollkommen andere Gliederungsbefehle gibt, kann man die Zuordnung eben mit
+Laden des Pakets und noch einmal während \Macro{begin}\PParameter{document}
+selbst zu ermitteln. Aber für den Fall, dass dies einmal nicht zu einem
+korrekten Ergebnis führt, beispielsweise falls es vollkommen andere
+Gliederungsbefehle gibt, kann man die Zuordnung eben mit
\Macro{DeclareSectionNumberDepth} auch explizit vornehmen.%
%
\EndIndex{Cmd}{DeclareSectionNumberDepth}%
@@ -207,7 +211,7 @@ es vollkommen andere Gliederungsbefehle gibt, kann man die Zuordnung eben mit
\label{sec:scrlayer.layers}
Eine Ebene (engl. \emph{layer}) ist ein Denkmodell für eine Seite. Im
-Gegensatz zu echtem, physischem Papier, ist diese Seite vollständig
+Gegensatz zu echtem, physischem Papier ist diese Seite vollständig
transparent. Üblicherweise werden mehrere Ebenen übereinander gestapelt und
undurchsichtiges Material auf einer Ebene überdeckt Material auf den Ebenen
darunter. Ein solcher Stapel von Ebenen wird dann auf eine reale Seite Papier
@@ -218,7 +222,8 @@ während der Vordergrundstapel über oder vor dem normalen Seiteninhalt
ausgegeben wird. Der normale Seiteninhalt ist daher eine Art von Trennebene
zwischen den beiden Ebenenstapeln.
-Eine Ebene hat mehrere Eigenschaften. Die erste Eigenschaft ist Antwort auf
+Eine Ebene hat mehrere Eigenschaften. Die erste Eigenschaft\textnote{Vorder-
+ oder Hintergrund} ist Antwort auf
die Frage, ob die Ebene zum Hintergrund oder zum Vordergrund
gehört. Hintergrundebenen werden ausgegeben, bevor der normale Inhalt der
Seite gedruckt wird. Optisch erscheinen sie daher \emph{hinter} oder
@@ -228,48 +233,52 @@ normalen Inhalt anschließend ausgegeben. Optisch erscheinen sie daher
Voreinstellung ist eine Ebene sowohl eine Hintergrundebene als auch eine
Vordergrundebene und wird daher zweimal ausgegeben.
-Die zweite und dritte Eigenschaft sind die horizontale und vertikale Position
-der Ebene. Die vierte und fünfte Eigenschaft sind die horizontale und
-vertikale Größe der Ebene. Daraus ergibt sich, dass eine Ebene auch kleiner
-oder größer als das Papier sein kann.
-
-Aber wie werden die horizontale und die vertikale Position gemessen? Aus der
-Antwort ergibt sich die sechste Eigenschaft, die Ausrichtung. Man kann von der
-linken Papierkante zur linken Kante der Ebene, zur Mitte der Ebene oder zur
-rechten Kante der Ebene messen. Entsprechend kann man von der oberen Kante des
-Papiers zur oberen Kante der Ebene, zur Mitte der Ebene oder zur unteren Kante
-der Ebene messen.
-
-Die siebte Eigenschaft ist, ob eine Ebene auf linken oder rechten Seiten eines
-Dokuments gedruckt werden soll. In der Voreinstellung wird eine Ebene auf
-allen Seiten gedruckt. Es ist zu beachten, dass \LaTeX{} Seiten mit geraden
-Seitenzahlen als linke Seiten und Seiten mit ungeraden Seitenzahlen als rechte
-Seiten behandelt, dass es jedoch im einseitigen Modus unabhängig von der
-Nummer nur rechte Seiten gibt. \LaTeX{} bezeichnet den Gepflogenheiten in der
-englischen Sprache entsprechend linke Seiten auch als gerade Seiten und rechte
-Seiten als ungerade Seiten.
-
-Die achte Eigenschaft ist, ob eine Ebene auf den einseitigen oder den
-doppelseitigen Modus beschränkt sein soll. In der Voreinstellung ist die Ebene
-diesbezüglich unbeschränkt, wird also sowohl im einseitigen als auch im
-doppelseitigen Modus ausgegeben. Nichtsdestotrotz wird eine Ebene, die auf
-gerade Seiten beschränkt ist, im einseitigen Modus niemals ausgegeben werden
-und ist daher auch keine einseitige Ebene.
-
-Die neunte Eigenschaft ist, ob eine Ebene auf Gleitseiten oder auf
-Normalseiten beschränkt ist. \LaTeX{} erzeugt Gleitseiten für Objekte aus
-Umgebungen wie \Environment{table} oder \Environment{figure}, wenn diesen
-erlaubt wurde, auf eigenen Seiten ohne Teile des normalen Dokumentinhalts
-ausgegeben zu werden (siehe Option \PValue{p} für \Environment{table} oder
-\Environment{figure}). In gewisser Weise ist es so der gesamten Seite erlaubt,
-im Dokument zu gleiten. Normalseiten in diesem Sinne sind alle Seiten, die
-keine Gleitseiten sind. Normalseiten können ebenfalls Gleitumgebungen am
-Anfang, im Inneren oder am Ende enthalten. Sehr große Gleitumgebungen können
-auch den Eindruck einer Gleitseite erzeugen, obwohl es sich bei ihnen in
-Wirklichkeit um oben auf einer Normalseite platzierte Gleitumgebungen handelt.
-
-Die zehnte und letzte Eigenschaft ist der Inhalt der Ebene. Das ist schlicht
-das, was gedruckt werden soll, wann immer die Ebene ausgegeben wird.
+Die zweite und dritte Eigenschaft\textnote{horizontale
+ Position}\textnote{vertikale Position} sind die horizontale und vertikale
+Position der Ebene. Die vierte und fünfte Eigenschaft sind die horizontale und
+vertikale\textnote{horizontale Größe}\textnote{vertikale Größe} Größe der
+Ebene. Daraus ergibt sich, dass eine Ebene auch kleiner oder größer als das
+Papier sein kann.
+
+Aber wie werden die horizontale und die vertikale Position
+gemessen?\textnote{Ausrichtung} Aus der Antwort ergibt sich die sechste
+Eigenschaft, die Ausrichtung. Man kann von der linken Papierkante zur linken
+Kante der Ebene, zur Mitte der Ebene oder zur rechten Kante der Ebene
+messen. Entsprechend kann man von der oberen Kante des Papiers zur oberen
+Kante der Ebene, zur Mitte der Ebene oder zur unteren Kante der Ebene messen.
+
+Die siebte Eigenschaft\textnote{linke oder rechte Seite} ist, ob eine Ebene
+auf linken oder rechten Seiten eines Dokuments gedruckt werden soll. In der
+Voreinstellung wird eine Ebene auf allen Seiten gedruckt. Es ist zu beachten,
+dass \LaTeX{} Seiten mit geraden Seitenzahlen als linke Seiten und Seiten mit
+ungeraden Seitenzahlen als rechte Seiten behandelt, dass es jedoch im
+einseitigen Modus unabhängig von der Nummer nur rechte Seiten gibt. \LaTeX{}
+bezeichnet den Gepflogenheiten in der englischen Sprache entsprechend linke
+Seiten auch als gerade Seiten und rechte Seiten als ungerade Seiten.
+
+Die achte Eigenschaft\textnote{ein- oder doppelseitig} ist, ob eine Ebene auf
+den einseitigen oder den doppelseitigen Modus beschränkt sein soll. In der
+Voreinstellung ist die Ebene diesbezüglich unbeschränkt, wird also sowohl im
+einseitigen als auch im doppelseitigen Modus ausgegeben. Nichtsdestotrotz wird
+eine Ebene, die auf gerade Seiten beschränkt ist, im einseitigen Modus niemals
+ausgegeben werden und ist daher auch keine einseitige Ebene.
+
+Die neunte Eigenschaft ist, ob eine Ebene auf Gleitseiten\textnote{Gleit- oder
+ Normalseiten} oder auf Normalseiten beschränkt ist. \LaTeX{} erzeugt
+Gleitseiten für Objekte aus Umgebungen wie \Environment{table} oder
+\Environment{figure}, wenn diesen erlaubt wurde, auf eigenen Seiten ohne Teile
+des normalen Dokumentinhalts ausgegeben zu werden (siehe Option \PValue{p} für
+\Environment{table} oder \Environment{figure}). In gewisser Weise ist es so
+der gesamten Seite erlaubt, im Dokument zu gleiten. Normalseiten in diesem
+Sinne sind alle Seiten, die keine Gleitseiten sind. Normalseiten können
+ebenfalls Gleitumgebungen am Anfang, im Inneren oder am Ende enthalten. Sehr
+große Gleitumgebungen können auch den Eindruck einer Gleitseite erzeugen,
+obwohl es sich bei ihnen in Wirklichkeit um oben auf einer Normalseite
+platzierte Gleitumgebungen handelt.
+
+Die zehnte und letzte Eigenschaft\textnote{Inhalt} ist der Inhalt der
+Ebene. Das ist schlicht das, was gedruckt werden soll, wann immer die Ebene
+ausgegeben wird.
Damit haben wir also zehn Eigenschaften. Später in dieser Anleitung werden wir
weitere Eigenschaften sehen, die jedoch auf diese zehn Eigenschaften
@@ -293,7 +302,8 @@ Diese Anweisungen können verwendet werden, um Ebenen zu definieren. Der
ASCII-Buchstaben resultieren. Einige zusätzliche Zeichen werden ebenfalls
akzeptiert, ihre Verwendung wird jedoch nicht empfohlen.
-Dabei spielt es bei Verwendung von \Macro{DeclareLayer} keine Rolle, ob eine
+Dabei spielt es bei Verwendung von
+\Macro{DeclareLayer}\important{\Macro{DeclareLayer}} keine Rolle, ob eine
Ebene \PName{Name der Ebene} bereits existiert oder nicht. Sie wird in jedem
Fall mit den über die \PName{Optionenliste} angegebenen Eigenschaften
definiert. Einzelne Optionen bestehen entweder nur aus einem Schlüssel oder
@@ -304,27 +314,28 @@ entsprechende Wert in geschweifte Klammern gesetzt werden. Eine Übersicht
über die Optionen und die Eigenschaften, die sie repräsentieren, findet sich
in \autoref{tab:scrlayer.layerkeys}.
-Im Unterschied zu \Macro{DeclareLayer} meldet \Macro{DeclareNewLayer} einen
-Fehler, falls eine Ebene mit dem angegebenen Namen bereits existiert. Damit
-wird der Anwender davor bewahrt, versehentlich mehrmals denselben Namen zu
+Im Unterschied zu \Macro{DeclareLayer} meldet
+\Macro{DeclareNewLayer}\important{\Macro{DeclareNewLayer}} einen Fehler, falls
+eine Ebene mit dem angegebenen Namen bereits existiert. Damit wird der
+Anwender davor bewahrt, versehentlich mehrmals denselben Namen zu
verwenden. Dies ist insbesondere auch dann nützlich, wenn Klassen oder Pakete
intern ebenfalls Ebenen definieren.
-Dagegen definiert \Macro{ProvideLayer} die Ebene nur, wenn nicht bereits eine
-Ebene mit dem angegebenen Namen existiert. Ist der Name hingegen bereits für
-eine andere Ebene verwendet, so wird die neuerliche Definition ignoriert. Die
-Anweisung hat also die Bedeutung: \emph{Definiere die Ebene, falls sie noch
- nicht existiert.}
+Dagegen definiert \Macro{ProvideLayer}\important{\Macro{ProvideLayer}} die
+Ebene nur, wenn nicht bereits eine Ebene mit dem angegebenen Namen
+existiert. Wird der Name hingegen bereits für eine andere Ebene verwendet, so
+wird die neuerliche Definition ignoriert. Die Anweisung hat also die
+Bedeutung: \emph{Definiere die Ebene, falls sie noch nicht existiert.}
Soll eine bereits existierende Ebene umdefiniert werden, so kann wahlweise
\Macro{RedeclareLayer} oder \Macro{ModifyLayer} verwendet werden. Während mit
-\Macro{RedeclareLayer} die Ebene zunächst auf die Grundeinstellungen
-zurückgesetzt und damit über die angegebene \PName{Optionenliste} komplett neu
-definiert wird, unterbleibt bei \Macro{ModifyLayer} das Zurücksetzen. Es
-werden dann nur die Eigenschaften geändert, für die in der
-\PName{Optionenliste} auch Angaben vorhanden sind. Die Anwendung auf eine
-zuvor noch nicht definierte Ebene stellt bei beiden Anweisungen einen Fehler
-dar.
+\Macro{RedeclareLayer}\important{\Macro{RedeclareLayer}} die Ebene zunächst
+auf die Grundeinstellungen zurückgesetzt und damit über die angegebene
+\PName{Optionenliste} komplett neu definiert wird, unterbleibt bei
+\Macro{ModifyLayer}\important{\Macro{ModifyLayer}} das Zurücksetzen. Es werden
+dann nur die Eigenschaften geändert, für die in der \PName{Optionenliste} auch
+Angaben vorhanden sind. Die Anwendung auf eine zuvor noch nicht definierte
+Ebene stellt bei beiden Anweisungen einen Fehler dar.
\begin{desclist}
\desccaption{%
@@ -358,7 +369,7 @@ dar.
}%
\entry{\KOption{area}\Parameter{horizontaler Abstand}\Parameter{vertikaler
Abstand}\Parameter{Breite}\Parameter{Höhe}}{%
- Die zusammengesetzte Eigenschaft, resultiert in den primären Eigenschaften
+ Die zusammengesetzte Eigenschaft resultiert in den primären Eigenschaften
\KOption{hoffset}\PName{horizontaler Abstand},
\KOption{voffset}\PName{vertikaler Abstand},
\KOption{width}\PName{Breite}, \KOption{height}\PName{Höhe}.%
@@ -424,7 +435,7 @@ dar.
erwartet und erlaubt keinen Wert.%
}%
\entry{\Option{foreground}}{%
- Mit dieser Option wird die Ebene zu einer reinen Vodergrundebene. Sie wird
+ Mit dieser Option wird die Ebene zu einer reinen Vordergrundebene. Sie wird
also im Gegensatz zur Grundeinstellung nicht mehr gleichzeitig im
Hintergrund und im Vordergrund, sondern nur noch im Vordergrund
ausgegeben. Diese Option erwartet und erlaubt keinen Wert.%
@@ -597,7 +608,7 @@ angegebenen \PName{Name} existiert, so wird der \PName{Dann-Code}
ausgeführt, anderenfalls der \PName{Sonst-Code}. Bitte beachten Sie, dass die
Anweisung nicht wirklich testen kann, ob eine Ebene existiert. Sie verwendet
stattdessen Heuristiken, die niemals falsch-negativ sein können, jedoch im
-Extremfall falsch-positiv sein könnten. Nichts desto trotz: Falls der Test
+Extremfall falsch-positiv sein könnten. Nichtsdestotrotz: Falls der Test
falsch-positiv ist, läuft etwas schief. Beispielsweise könnte dies ein
Indikator für die Verwendung eines inkompatiblen Pakets oder dafür sein, dass
der Anwender etwas tut, was er besser nicht tun sollte.%
@@ -617,12 +628,13 @@ zerstörte Ebenen anschließend mit \Macro{DeclareNewLayer} oder
neuerlichen Definition nicht länger mit \Macro{RedeclareLayer} oder
\Macro{ModifyLayer} verändert werden.
-Die Anweisung ist dazu bestimmt, innerhalb von
-\Macro{scrlayerOnAutoRemoveInterface} verwendet zu werden. Damit können Ebenen
-die unter Verwendung von entfernbaren Anweisungen einer entfernbaren
-Benutzerschnittstelle definiert wurden, zusammen mit dieser
+Die Anweisung ist dazu bestimmt, innerhalb des Arguments \PName{Code} von
+\Macro{scrlayerOnAutoRemoveInterface} (siehe
+\autoref{sec:scrlayer.enduserinterfaces},
+\autopageref{desc:scrlayer.cmd.scrlayerOnAutoRemoveInterface}) verwendet zu
+werden. Damit können Ebenen, die unter Verwendung von entfernbaren Anweisungen
+einer entfernbaren Benutzerschnittstelle definiert wurden, zusammen mit dieser
Benutzerschnittstelle entfernt werden.%
-%
\EndIndex{Cmd}{DestroyLayer}%
@@ -664,29 +676,34 @@ korrespondiert also unmittelbar mit den Optionen \Option{background} und
\Option{foreground} für Ebenen.
Daher liegt es nahe, Seitenstile als Listen von Ebenen zu definieren. Aber
-statt nur die genannten vier Optionen, können dabei alle Eigenschaften
-verwendet werden, die in \autoref{sec:scrlayer.layers} erklärt wurden.
+statt nur die genannten vier Optionen können dabei alle Eigenschaften
+verwendet werden, die in \autoref{sec:scrlayer.layers},
+\autoref{tab:scrlayer.layerkeys}, ab \autopageref{tab:scrlayer.layerkeys}
+erklärt wurden.
Als Ergebnis dieser Überlegungen ist eine Form von Seitenstilen, die
-\Package{scrlayer} bietet, der Ebenen-Seitenstil. Ein solcher Ebenen-Seitenstil
-besteht aus Ebenen und zusätzlich aus mehreren Haken (engl. \emph{hooks}). Die
-Ebenen wurden bereits in \autoref{sec:scrlayer.layers} beschrieben. Die Haken
-sind Punkte in der Expansion oder Anwendung von Seitenstilen, zu denen
-zusätzlicher Code hinzugefügt werden kann. Erfahrene Anwender kennen dieses
-Konzept bereits von beispielsweise \Macro{AtBeginDocument} (siehe
-\cite{latex:usrguide}) oder \Macro{BeforeClosingMainAux} (siehe
+\Package{scrlayer} bietet, der
+Ebenen-Seitenstil\textnote{Ebenen-Seitenstil}\Index{Seitenstil>Ebenen-}\Index{Ebenen>Seitenstil}\Index{Seiten>Stil}. Ein
+solcher Ebenen-Seitenstil besteht aus Ebenen und zusätzlich aus mehreren Haken
+(engl. \emph{hooks}). Die Ebenen wurden bereits in
+\autoref{sec:scrlayer.layers} beschrieben. Die Haken sind Punkte in der
+Expansion oder Anwendung von Seitenstilen, zu denen zusätzlicher Code
+hinzugefügt werden kann. Erfahrene Anwender kennen dieses Konzept bereits von
+beispielsweise \Macro{AtBeginDocument} (siehe \cite{latex:usrguide}) oder
+\Macro{BeforeClosingMainAux} (siehe
\autopageref{desc:scrlfile.cmd.BeforeClosingMainAux}).
Eine zweite Form von Seitenstilen, die \Package{scrlayer} bietet, ist der
-Alias-Seitenstil oder Seitenstil-Alias. Ein Seitenstil-Alias besteht in
-Wirklichkeit aus einem anderen Seitenstil. Anders ausgedrückt ist der Name eines
-Seitenstil-Alias ein Alias-Name für einen anderen Seitenstil-Alias oder einen
-primären Seitenstil. Daher führt die Manipulation an einem Seitenstil-Alias
-zu einer Manipulation am originären Seitenstil. Ist der originäre Seitenstil
-selbst ebenfalls ein Seitenstil-Alias, so führt dessen Manipulation wiederum
-zu einer Manipulation dessen originären Seitenstils und immer so weiter, bis
-schließlich ein realer Seitenstil verändert wird. Der Ausdruck
-\emph{realer Seitenstil} wird zur Unterscheidung von einem Seitenstil-Alias
+Alias-Seitenstil\textnote{Alias-Seitenstil}\Index{Seitenstil>Alias-}\Index{Alias>Seitenstil}\Index{Seiten>Stil} oder
+Seitenstil-Alias. Ein Seitenstil-Alias besteht in Wirklichkeit aus einem
+anderen Seitenstil. Anders ausgedrückt ist der Name eines Seitenstil-Alias ein
+Alias-Name für einen anderen Seitenstil-Alias oder einen primären
+Seitenstil. Daher führt die Manipulation an einem Seitenstil-Alias zu einer
+Manipulation am originären Seitenstil. Ist der originäre Seitenstil selbst
+ebenfalls ein Seitenstil-Alias, so führt dessen Manipulation wiederum zu einer
+Manipulation dessen originären Seitenstils und immer so weiter, bis
+schließlich ein realer Seitenstil verändert wird. Der Ausdruck \emph{realer
+ Seitenstil} wird zur Unterscheidung von einem Seitenstil-Alias
verwendet. Alle Seitenstile, die kein Seitenstil-Alias sind, sind reale
Seitenstile. Seitenstil-Aliase können nicht nur für Seitenstile definiert
werden, die mit \Package{scrlayer} definiert wurden, sondern für alle
@@ -709,7 +726,7 @@ verwendet wird.
Es sei darauf hingewiesen, dass die später in diesem Abschnitt dokumentierten
Ebenen-Seitenstile nicht auf diese Erweiterung von \Macro{pagestyle} angewiesen
-sind, da sie selbst ebenfalls \Macro{currentpagestyle} umdefinieren. Die
+sind, da sie selbst auch \Macro{currentpagestyle} umdefinieren. Die
Erweiterung wurde für die Verwendung von anderen Seitenstilen, die nicht auf
\Package{scrlayer} basieren, vorgenommen. Es ist außerdem zu
beachten\textnote{Achtung!}, dass \Macro{currentpagestyle} vor der ersten
@@ -727,9 +744,10 @@ Seitenstil auf eine Voreinstellung zu setzen.%
\BeginIndex{Cmd}{AfterSelectAnyPageStyle}%
Die Anweisung \Macro{BeforeSelectAnyPageStyle} fügt einem Haken
(engl. \emph{hook}) \PName{Code} hinzu, der innerhalb der Ausführung von
-\Macro{pagestyle}, unmittelbar vor der Auswahl des Seitenstils ausgeführt
-wird. Innerhalb von \PName{Code} kann \texttt{\#1} als Platzhalter für das
-Argument von \Macro{pagestyle} verwendet werden.
+Anweisung \Macro{pagestyle}\important{\Macro{pagestyle}}\IndexCmd{pagestyle},
+unmittelbar vor der Auswahl des Seitenstils ausgeführt wird. Innerhalb von
+\PName{Code} kann \texttt{\#1} als Platzhalter für das Argument von
+\Macro{pagestyle} verwendet werden.
Die Anweisung \Macro{AfterSelectAnyPageStyle} arbeitet ähnlich. Allerdings
wird hier \PName{Code} ausgeführt, nachdem der Seitenstil gewählt und
@@ -749,18 +767,29 @@ beschränkt werden.%
\begin{Declaration}
\Macro{DeclarePageStyleAlias}%
- \Parameter{Seitenstil-Alias-Name}\Parameter{originärer Seitenstil-Name}\\
+ \Parameter{Seitenstil-Alias-Name}\\
+ \hphantom{\XMacro{DeclarePageStyleAlias}}%
+ \Parameter{originärer Seitenstil-Name}\\
\Macro{DeclareNewPageStyleAlias}%
- \Parameter{Seitenstil-Alias-Name}\Parameter{originärer Seitenstil-Name}\\
+ \Parameter{Seitenstil-Alias-Name}\\
+ \hphantom{\XMacro{DeclareNewPageStyleAlias}}%
+ \Parameter{originärer Seitenstil-Name}\\
\Macro{ProvidePageStyleAlias}%
- \Parameter{Seitenstil-Alias-Name}\Parameter{originärer Seitenstil-Name}\\
+ \Parameter{Seitenstil-Alias-Name}\\
+ \hphantom{\XMacro{ProvidePageStyleAlias}}%
+ \Parameter{originärer Seitenstil-Name}\\
\Macro{RedeclarePageStyleAlias}%
- \Parameter{Seitenstil-Alias-Name}\Parameter{originärer Seitenstil-Name}%
+ \Parameter{Seitenstil-Alias-Name}\\
+ \hphantom{\XMacro{RedeclarePageStyleAlias}}%
+ \Parameter{originärer Seitenstil-Name}%
\end{Declaration}
\BeginIndex{Cmd}{DeclarePageStyleAlias}%
\BeginIndex{Cmd}{DeclareNewPageStyleAlias}%
\BeginIndex{Cmd}{ProvidePageStyleAlias}%
\BeginIndex{Cmd}{RedeclarePageStyleAlias}%
+\BeginIndex{}{Seitenstil>Alias-}%
+\BeginIndex{}{Alias>Seitenstil}%
+\BeginIndex{}{Seiten>Stil}%
Diese Anweisungen können verwendet werden, um einen Seitenstil mit dem Namen
\PName{Seitenstil-Alias-Name} zu definieren, der einfach nur ein Alias für
einen bereits existierenden Seitenstil mit dem Namen \PName{originärer
@@ -770,20 +799,40 @@ Alias mit \Macro{DeclarePageStyleAlias} oder \Macro{RedeclarePageStyleAlias}
zerstört.
Die Anweisung \Macro{DeclareNewPageStyleAlias} erzeugt eine Fehlermeldung,
-falls zuvor bereits ein Seitenstil mit dem Namen \PName{Seitenstil-Alias-Name}
+falls zuvor bereits ein Seitenstil \PName{Seitenstil-Alias-Name}
definiert wurde. Dabei spielt es keine Rolle, ob der existierende Seitenstil
selbst ein Alias-Seitenstil, ein Ebenen-Seitenstil oder eine andere Art von
Seitenstil ist.
-Die Anweisung \Macro{ProvidePageStyleAlias} definiert den Alias-Seitenstil
-nur, falls nicht bereits ein Seitenstil mit dem Namen
+Die Anweisung \Macro{ProvidePageStyleAlias} definiert den Seitenstil-Alias
+nur, falls nicht bereits ein Seitenstil
\PName{Seitenstil-Alias-Name} existiert. Falls ein solcher Seitenstil
existiert, bleibt dieser erhalten und die Anweisung tut schlicht nichts.
-Im Gegensatz zu den anderen Anweisungen erwartet
+Im Gegensatz zu den drei vorgenannten Anweisungen erwartet
\Macro{RedeclarePageStyleAlias}, dass bereits ein Seitenstil mit dem Namen
\PName{Seitenstil-Alias-Name} existiert. Anderenfalls erzeugt die Anweisung
-eine Fehlermeldung.%
+eine Fehlermeldung.
+\iffree{\csname @tempswafalse\endcsname}{\csname @tempswatrue\endcsname}%
+\csname if@tempswa\endcsname% Umbruchkorrekturtext
+\begin{Example}
+ Angenommen, Sie schreiben eine Klasse und verwenden darin für
+ Kapitelanfangsseiten den Seitenstil \Pagestyle{chapter}. In der
+ Voreinstellung soll dieser Seitenstil dem Seitenstil \Pagestyle{plain}
+ entsprechen. Daher verwenden Sie das Paket \Package{scrlayer} und definieren
+ mit
+\begin{lstcode}
+ \DeclareNewPageStyleAlias{chapter}{plain}
+\end{lstcode}
+ den Seitenstil \Pagestyle{chapter} als Alias für den Seitenstil
+ \Pagestyle{plain}. Will hingegen der Anwender später, dass der Seitenstil
+ \Pagestyle{chapter} dem Seitenstil \Pagestyle{empty} entspricht, so erreicht
+ er dies mit:
+\begin{lstcode}
+ \RedeclarePageStyleAlias{chapter}{empty}
+\end{lstcode}
+\end{Example}
+\fi
\EndIndex{Cmd}{RedeclarePageStyleAlias}%
\EndIndex{Cmd}{ProvidePageStyleAlias}%
\EndIndex{Cmd}{DeclareNewPageStyleAlias}%
@@ -796,13 +845,15 @@ eine Fehlermeldung.%
Mit dieser Anweisung wird der Seitenstil-Alias mit dem angegebenen Namen
\PName{Seitenstil-Alias-Name} für \LaTeX{} wieder undefiniert, wenn es
tatsächlich einen Alias-Seitenstil dieses Namens gibt. Anschließend kann der
-Seitenstil beispielsweise mit \Macro{DeclareNewAliasPageStyle} oder
-\Macro{ProvideAliasPageStyle} neu definiert werden.
-
-Die Anweisung ist dazu bestimmt innerhalb von
-\Macro{scrlayerOnAutoRemoveInterface} verwendet zu werden, um Seitenstile, die
-als Teil eines Endanwender-Interfaces definiert wurden, beim Entfernen dieses
-Interfaces mit zu entfernen.%
+Seitenstil auch mit \Macro{DeclareNewAliasPageStyle} oder
+\Macro{ProvideAliasPageStyle} wieder neu definiert werden.
+
+Die Anweisung ist dazu bestimmt, innerhalb des Arguments \PName{Code} von
+\Macro{scrlayerOnAutoRemoveInterface} (siehe
+\autoref{sec:scrlayer.enduserinterfaces},
+\autopageref{desc:scrlayer.cmd.scrlayerOnAutoRemoveInterface}) verwendet zu
+werden, um Seitenstile, die als Teil eines Endanwender-Interfaces definiert
+wurden, beim automatischen Entfernen dieses Interfaces mit zu entfernen.%
\EndIndex{Cmd}{DestroyPageStyleAlias}%
\begin{Declaration}
@@ -818,43 +869,50 @@ existiert. Die Anweisung ist voll expandierbar und kann damit beispielsweise
auch im zweiten Argument einer \Macro{edef}-Anweisung verwendet werden.
%
\EndIndex{Cmd}{GetRealPageStyle}%
-
+\EndIndex{}{Alias>Seitenstil}%
+\EndIndex{}{Seitenstil>Alias-}%
\begin{Declaration}
\Macro{DeclarePageStyleByLayers}%
- \OParameter{Optionenliste}\Parameter{Seitenstil-Name}%
+ \OParameter{Optionenliste}\\
+ \hphantom{\XMacro{DeclarePageStyleByLayers}}\Parameter{Seitenstil-Name}%
\Parameter{Ebenenliste}\\
\Macro{DeclareNewPageStyleByLayers}%
- \OParameter{Optionenliste}\Parameter{Seitenstil-Name}%
+ \OParameter{Optionenliste}\\
+ \hphantom{\XMacro{DeclareNewPageStyleByLayers}}\Parameter{Seitenstil-Name}%
\Parameter{Ebenenliste}\\
\Macro{ProvidePageStyleByLayers}%
- \OParameter{Optionenliste}\Parameter{Seitenstil-Name}%
+ \OParameter{Optionenliste}\\
+ \hphantom{\XMacro{ProvidePageStyleByLayers}}\Parameter{Seitenstil-Name}%
\Parameter{Ebenenliste}\\
\Macro{RedeclarePageStyleByLayers}%
- \OParameter{Optionenliste}\Parameter{Seitenstil-Name}%
+ \OParameter{Optionenliste}\\
+ \hphantom{\XMacro{RedeclarePageStyleByLayers}}\Parameter{Seitenstil-Name}%
\Parameter{Ebenenliste}%
\end{Declaration}
\BeginIndex{Cmd}{DeclarePageStyleByLayers}%
\BeginIndex{Cmd}{DeclareNewPageStyleByLayers}%
\BeginIndex{Cmd}{ProvidePageStyleByLayers}%
\BeginIndex{Cmd}{RedeclarePageStyleByLayers}%
+\BeginIndex{}{Seitenstil>Ebenen-}%
+\BeginIndex{}{Ebenen>Seitenstil}%
Diese Anweisungen deklarieren einen Seitenstil mit dem
Namen \Parameter{Seitenstil-Name}. Der Seitenstil besteht aus einer Anzahl von
Ebenen, die in der mit Komma separierten \PName{Ebenenliste} angegeben
sind. Es ist zu beachten\textnote{Achtung!}, dass sowohl
\PName{Seitenstil-Name} als auch \PName{Ebenenliste} voll expandierbar sein
-muss und die Expansion zu einer Reihe von Buchstaben führen sollte. Einige
+müssen und die Expansion zu einer Reihe von Buchstaben führen sollte. Einige
andere Zeichen werden zwar toleriert, ihre Verwendung wird jedoch nicht
empfohlen.
-Die \PName{Optionenliste} ist eine mit Komma separierte Liste von
-\texttt{\PName{Schlüssel}=\PName{Wert}}-Optionen. Diese Optionen können
-verwendet werden, um zusätzliche Eigenschaften zu setzen und zusätzliche
-Möglichkeiten zu nutzen. Derzeit werden sie verwendet, um Code an bestimmten
-Stellen der Aktivierung oder Verwendung eines Seitenstils über Haken
-(engl. \emph{hooks}) auszuführen. Für allgemeine Informationen zu Haken sei
-auf die Einleitung zu diesem Abschnitt verwiesen. Details zu den Haken und
-ihrer Bedeutung sind \autoref{tab:scrlayer.pagestyle.hooks} zu entnehmen.
+Die \PName{Optionenliste} ist eine mit Komma separierte Liste von Optionen der
+Form \texttt{\PName{Schlüssel}=\PName{Code}}. Diese Optionen können verwendet
+werden, um zusätzliche Eigenschaften zu setzen und zusätzliche Möglichkeiten
+zu nutzen. Derzeit werden sie verwendet, um Code an bestimmten Stellen der
+Aktivierung oder Verwendung eines Seitenstils über Haken (engl. \emph{hooks})
+auszuführen. Für allgemeine Informationen zu Haken sei auf die Einleitung zu
+diesem Abschnitt verwiesen. Details zu den Haken und ihrer Bedeutung sind
+\autoref{tab:scrlayer.pagestyle.hooks} zu entnehmen.
\begin{desclist}
\desccaption{%
@@ -938,21 +996,22 @@ ihrer Bedeutung sind \autoref{tab:scrlayer.pagestyle.hooks} zu entnehmen.
}%
\end{desclist}
-Der Unterschied zwischen \Macro{DeclarePageStyleByLayers} und
-\Macro{DeclareNewPageStyleByLayers} besteht darin, dass
-\Macro{DeclareNewPageStyleByLayers} eine Fehlermeldung erzeugt, falls bereits
-ein Seitenstil des Namens \PName{Seitenstil-Name}
+Während die Anweisung
+\Macro{DeclarePageStyleByLayers} %\important{\Macro{DeclarePageStyleByLayers}}%
+ % Leider zu lang. Deshalb auch auf alle
+ % weiteren verzichtet.
+den Seitenstil immer definiert, erzeugt \Macro{DeclareNewPageStyleByLayers}
+eine Fehlermeldung, falls bereits ein Seitenstil gleichen Namens
existiert. Beachten\textnote{Achtung!} Sie, dass die Deklaration eines
Seitenstils, der bereits ein Alias für einen anderen Seitenstil ist (siehe
-\Macro{DeclareAliasPageStyle} zuvor in diesem Abschnitt) nicht zu der
-Umdefinierung des angegebenen Alias-Seitenstils, sondern des realen
+beispielsweise \Macro{DeclareAliasPageStyle} zuvor in diesem Abschnitt) nicht
+zu der Umdefinierung des angegebenen Alias-Seitenstils, sondern des realen
Seitenstils (siehe \Macro{GetRealPageStyle} zuvor in diesem Abschnitt) führt.
Im Unterschied dazu wird bei \Macro{ProvidePageStyleByLayers} der Seitenstil
unverändert erhalten, wenn bereits ein Seitenstil des Namens
\PName{Seitenstil-Name} existiert. Existiert kein solcher Seitenstil, so wird
-er wie bei \Macro{DeclarePageStyleByLayers} oder
-\Macro{DeclareNewPageStyleByLayers} neu definiert.
+er wie bei \Macro{DeclarePageStyleByLayers} definiert.
Die Anweisung \Macro{RedeclarePageStyleByLayers} wiederum erwartet, dass
bereits ein Seitenstil des Namens \PName{Seitenstil-Name} existiert und
@@ -971,37 +1030,40 @@ Beachten Sie auch die nachfolgenden Anmerkungen zum Pseudo-Seitenstil
\Pagestyle{@everystyle@}\\
\Pagestyle{empty}
\end{Declaration}
-\BeginIndex{Pagestyle}{@everysel@}%
+\BeginIndex{Pagestyle}{@everystyle@}%
\BeginIndex{Pagestyle}{empty}%
Das Paket \Package{scrlayer} definiert von sich aus bereits zwei in gewisser
Weise spezielle Seitenstile. Der erste davon ist
-\Pagestyle{@everystyle@}. Dieser Seitenstil sollte niemals als normaler
-Seitenstil beispielsweise mit \Macro{pagestyle} oder \Macro{thispagestyle}
-oder als Ziel eines Alias-Seitenstils verwendet werden. Stattdessen werden die
-Ebenen und Haken dieses Seitenstils von allen anderen Ebenen-Seitenstilen mit
-verwendet. Dabei werden die Haken von \Pagestyle{@everystyle@} jeweils vor den
-entsprechenden Haken und die Ebenen jeweils vor den entsprechenden Ebenen des
-aktiven Seitenstils ausgeführt. Damit ist das Hinzufügen einer Ebene zum
-Seitenstil \Pagestyle{@everystyle@} oder von Code zu einem Haken dieses
-Seitenstils vergleichbar mit dem Hinzufügen einer Ebene beziehungsweise von
-Haken-Code zu allen Ebenen-Seitenstile. Der eine entscheidende Unterschied
-ist: Befehle, die sich auf die Ebenen eines Seitenstils beziehen,
-beispielsweise \Macro{ForEachLayerOfPageStyle},
+\Pagestyle{@everystyle@}\important{\Pagestyle{@everystyle@}}. Dieser
+Seitenstil sollte niemals als normaler Seitenstil beispielsweise mit
+\Macro{pagestyle} oder \Macro{thispagestyle} oder als Ziel eines
+Alias-Seitenstils verwendet werden. Stattdessen werden die Ebenen und Haken
+dieses Seitenstils von allen anderen Ebenen-Seitenstilen mit verwendet. Dabei
+werden die Haken von \Pagestyle{@everystyle@} jeweils vor den entsprechenden
+Haken und die Ebenen jeweils vor den entsprechenden Ebenen des aktiven
+Seitenstils ausgeführt.
+
+Damit ist das Hinzufügen einer Ebene zum Pseudo-Seitenstil
+\Pagestyle{@everystyle@} oder von Code zu einem Haken dieses Seitenstils
+vergleichbar mit dem Hinzufügen einer Ebene beziehungsweise von Haken-Code zu
+allen Ebenen-Seitenstile. Der eine entscheidende Unterschied ist: Befehle, die
+sich auf die Ebenen eines Seitenstils beziehen, das sind neben
+\Macro{ForEachLayerOfPageStyle} beispielsweise auch die Anweisungen
\Macro{AddLayersToPageStyleBeforeLayer} oder
-\Macro{AddLayersToPageStyleAfterLayer} lassen die Ebenen des Seitenstils
+\Macro{AddLayersToPageStyleAfterLayer}, lassen die Ebenen des Seitenstils
\Pagestyle{@everystyle@} unberücksichtigt, wenn sie auf einen anderen
Ebenen-Seitenstil angewendet werden.
-Der zweite etwas andere Ebenen-Seitenstil ist \Pagestyle{empty}. Normalerweise
-wird bereits vom \LaTeX-Kern ein Seitenstil dieses Namens definiert. Dieser
-Seitenstil hat einen leeren Kopf und Fuß. Das Paket \Package{scrlayer}
-definiert diesen Seitenstil als Ebenen-Seitenstil ohne Ebenen
-um. Nichtsdestotrotz kann er wie jeder andere Ebenen-Seitenstil verwendet
-werden. Der Hauptvorteil dieses Ebenen-Seitenstils gegenüber dem
+Der zweite etwas andere Ebenen-Seitenstil ist
+\Pagestyle{empty}\important{\Pagestyle{empty}}. Bereits vom \LaTeX-Kern wird
+ein Seitenstil dieses Namens definiert, der einen leeren Kopf und Fuß hat. Das
+Paket \Package{scrlayer} definiert diesen Seitenstil als Ebenen-Seitenstil
+ohne Ebenen um. Nichtsdestotrotz kann er wie jeder andere Ebenen-Seitenstil
+verwendet werden. Der Hauptvorteil dieses Ebenen-Seitenstils gegenüber dem
ursprünglichen Seitenstil aus dem \LaTeX-Kern ist, dass er ebenfalls die Haken
und Ebenen des Pseudo-Seitenstils \Pagestyle{@everystyle@} ausführt.%
\EndIndex{Pagestyle}{empty}%
-\EndIndex{Pagestyle}{@everysel@}%
+\EndIndex{Pagestyle}{@everystyle@}%
\begin{Declaration}
@@ -1055,7 +1117,7 @@ wird, entfernt werden.%
\end{Declaration}
\BeginIndex{Option}{deactivatepagestylelayers~=\PName{Ein-Aus-Wert}}%
\BeginIndex{Cmd}{ForEachLayerOfPageStyle}%
-Solange die \KOMAScript-Option \Option{deactivatepagestylelayers} nicht
+Solange \KOMAScript-Option \Option{deactivatepagestylelayers} nicht
aktiviert ist, kann mit \Macro{ForEachLayerOfPageStyle} für jede Ebene des
Seitenstils mit dem Namen \PName{Seitenstil-Name} beliebiger \PName{Code}
ausgeführt werden. Innerhalb von \PName{Code} dient dabei \PValue{\#1} als
@@ -1077,7 +1139,7 @@ unerwünschte Seiteneffekte zu minimieren. Die Anweisung \Macro{gdef} definiert
\Macro{commaatlist} jedoch global um, so dass beim Aufruf des Codes für die
nächste Ebene die Änderung Bestand hat.
-Diverse Anweisungen von \Package{scrlayer} setzen ebenfalls
+Diverse Anweisungen von \Package{scrlayer} setzen intern selbst ebenfalls
\Macro{ForEachLayerOfPageStyle} ein. Auch deren Funktion kann daher über die
\KOMAScript-Option \Option{deactivatepagestylelayers} verändert werden. Diese
Option kann daher verwendet werden, um alle Ebenen aller Seitenstile temporär
@@ -1105,21 +1167,23 @@ hinzuzufügen oder davon zu entfernen. Der Seitenstil wird dabei über seinen
\PName{Seitenstil-Name} referenziert. Die Ebenen werden in einer durch Komma
separierten \PName{Ebenenliste} angegeben.
-Die Anweisungen \Macro{AddLayersToPageStyle} und
-\Macro{AddLayersAtEndOfPageStyle} fügen die Ebenen am Ende der Ebenenliste des
-Seitenstils ein. Logisch liegen die neu hinzugefügten Ebenen also über oder
-vor den bereits vorhandenen Ebenen, wobei Hintergrund-Ebenen natürlich
-weiterhin logisch hinter der Textebene und damit auch hinter allen
-Vordergrund-Ebenen liegen.
-
-Die Anweisung \Macro{AddLayersAtBeginOfPageStyle} fügt die Ebenen hingegen am
-Anfang der Ebenenliste des Seitenstils ein. Dabei werden die Ebenen in der
-Reihenfolge am Anfang eingefügt, in der sie auch in der \PName{Ebenenliste}
-stehen. Damit wird die Ebene, die ganz am Ende von \PName{Ebenenliste} steht,
-nach dem Einfügen die erste und damit die unterste oder hinterste Ebene
-(jeweils entweder der Vordergrund oder der Hintergrundebenen) sein.
-
-Der Versuch, mit Hilfe von \Macro{RemoveLayersFromPageStyle} Ebenen von einem
+Sowohl die Anweisung \Macro{AddLayersToPageStyle} als auch die Anweisung
+\Macro{AddLayersAtEndOfPageStyle}\textnote{hinzufügen am Ende} fügt die Ebenen
+am Ende der Ebenenliste des Seitenstils ein. Logisch liegen die neu
+hinzugefügten Ebenen also über oder vor den bereits vorhandenen Ebenen, wobei
+Hintergrund-Ebenen natürlich weiterhin logisch hinter der Textebene und damit
+auch hinter allen Vordergrund-Ebenen liegen.
+
+Die Anweisung \Macro{AddLayersAtBeginOfPageStyle}\textnote{hinzufügen am
+ Anfang} fügt die Ebenen hingegen am Anfang der Ebenenliste des Seitenstils
+ein. Dabei werden die Ebenen in der Reihenfolge am Anfang eingefügt, in der
+sie auch in der \PName{Ebenenliste} stehen. Damit wird die Ebene, die ganz am
+Ende von \PName{Ebenenliste} steht, nach dem Einfügen die erste und damit die
+unterste oder hinterste Ebene (jeweils entweder der Vordergrund- oder der
+Hintergrundebenen) sein.
+
+Der Versuch, mit Hilfe von
+\Macro{RemoveLayersFromPageStyle}\textnote{entfernen} Ebenen von einem
Seitenstil zu entfernen, die gar nicht Teil des Seitenstils sind, wird
ignoriert, führt also nicht zu einer Fehlermeldung. Dagegen ist der Versuch,
Ebenen zu einem Seitenstil, der kein Ebenen-Seitenstil ist und auch kein
@@ -1132,10 +1196,12 @@ einem solchen zu entfernen ein Fehler und wird als solcher gemeldet.%
\begin{Declaration}
\Macro{AddLayersToPageStyleBeforeLayer}%
- \Parameter{Seitenstil-Name}\Parameter{Ebenenliste}%
+ \Parameter{Seitenstil-Name}\Parameter{Ebenenliste}\\
+ \hphantom{\XMacro{AddLayersToPageStyleBeforeLayer}}%
\Parameter{Referenzebenen-Name}\\
\Macro{AddLayersToPageStyleAfterLayer}%
- \Parameter{Seitenstil-Name}\Parameter{Ebenenliste}%
+ \Parameter{Seitenstil-Name}\Parameter{Ebenenliste}\\
+ \hphantom{\XMacro{AddLayersToPageStyleAfterLayer}}%
\Parameter{Referenzebenen-Name}%
\end{Declaration}
\BeginIndex{Cmd}{AddLayersToPageStyleBeforeLayer}%
@@ -1143,7 +1209,8 @@ einem solchen zu entfernen ein Fehler und wird als solcher gemeldet.%
Diese beiden Befehle ähneln den vorangegangenen. Allerdings wird hier
zusätzlich ein \PName{Referenzebenen-Name} angegeben. Die Ebenen des über den
\PName{Seitenstil-Name} angegebenen Seitenstils werden nach dieser
-Referenzebene durchsucht. Die Ebenen der \PName{Ebenenliste} werden dann vor
+Referenzebene durchsucht. Die Ebenen der \PName{Ebenenliste} werden dann
+vor\textnote{hinzufügen vor/nach Ebene}
respektive nach jedem Auf"|treten der Referenzebene in die Ebenen des
Seitenstils eingefügt. Dabei bleibt die Reihenfolge der Ebenen der
\PName{Ebenenliste} erhalten.%|
@@ -1171,8 +1238,8 @@ entfernt werden.
Es ist zu beachten\textnote{Achtung!}, dass sich dabei die Reihenfolge der
Ebenen ändern kann. Wird also eine spezielle Reihenfolge gewünscht, sollten
stattdessen alle Ebenen entfernt und die gewünschten Ebenen in der erwarteten
-Reihenfolge neu hinzugefügt werden. \Macro{UnifyLayersAtPageStyle} ist in einem
-solchen Fall also nicht geeignet.%
+Reihenfolge neu hinzugefügt werden. In einem solchen Fall ist
+\Macro{UnifyLayersAtPageStyle} also nicht geeignet.%
\EndIndex{Cmd}{UnifyLayersAtPageStyle}%
\begin{Declaration}
@@ -1185,27 +1252,33 @@ solchen Fall also nicht geeignet.%
\BeginIndex{Cmd}{AddToLayerPageStyleOptions}%
Mit diesen beiden Anweisungen können die Optionen und damit die Haken eines
Ebenen-Seitenstils nachträglich verändert werden. Bei
-\Macro{ModifyLayerPageStyleOptions} werden dabei genau die Optionen, die in
-der durch Komma separierten \PName{Optionenliste} angegeben sind auf die
-dortigen neuen Werte gesetzt. Die bisherigen Werte gehen dabei verloren. Es
-sind alle Optionen aus \autoref{tab:scrlayer.pagestyle.hooks},
+\Macro{ModifyLayerPageStyleOptions}\textnote{Seitenstil-Optionen ändern}
+werden dabei genau die Optionen, die in der durch Komma separierten
+\PName{Optionenliste} angegeben sind, auf die dortigen neuen Werte gesetzt. Die
+bisherigen Werte gehen dabei verloren. Es sind alle Optionen aus
+\autoref{tab:scrlayer.pagestyle.hooks},
\autopageref{tab:scrlayer.pagestyle.hooks} erlaubt. Optionen beziehungsweise
Haken, die nicht in der \PName{Optionenliste} angegeben sind, bleiben hingegen
unverändert. Diese Anweisung ist damit auch die einzige Möglichkeit, die
globalen Voreinstellungen der \KOMAScript-Optionen von einem Seitenstil zu
entfernen.
-Die Anweisung \Macro{AddToLayerPageStyleOptions} unterscheidet sich insofern,
-als die neuen Werte die bisher vorhandenen Werte nicht überschreiben, sondern
-diesen hinzugefügt oder -- genauer gesagt -- an diese angehängt werden.%
+Die Anweisung \Macro{AddToLayerPageStyleOptions}\textnote{Seitenstil-Optionen
+ erweitern} dagegen überschreibt die bisher vorhandenen Werte nicht, sondern
+fügt die neuen zu den bisherigen hinzu oder -- genauer gesagt -- hängt die
+neuen Werte an die alten an.%
\EndIndex{Cmd}{AddToLayerPageStyleOptions}%
\EndIndex{Cmd}{ModifyLayerPageStyleOptions}%
\begin{Declaration}
\Macro{IfLayerPageStyleExists}%
- \Parameter{Seitenstil-Name}\Parameter{Dann-Code}\Parameter{Sonst-Code}\\
- \Macro{IfRealLayerPageStyleExists}%^
- \Parameter{Seitenstil-Name}\Parameter{Dann-Code}\Parameter{Sonst-Code}%
+ \Parameter{Seitenstil-Name}\\
+ \hphantom{\XMacro{IfLayerPageStyleExists}}%
+ \Parameter{Dann-Code}\Parameter{Sonst-Code}\\
+ \Macro{IfRealLayerPageStyleExists}%
+ \Parameter{Seitenstil-Name}\\
+ \hphantom{\XMacro{IfRealLayerPageStyleExists}}%
+ \Parameter{Dann-Code}\Parameter{Sonst-Code}%
\end{Declaration}
\BeginIndex{Cmd}{IfLayerPageStyleExists}%
\BeginIndex{Cmd}{IfRealLayerPageStyleExists}%
@@ -1227,33 +1300,39 @@ Ebenen-Seitenstil führt.%
\begin{Declaration}
\Macro{IfLayerAtPageStyle}%
- \Parameter{Seitenstil-Name}\Parameter{Ebenen-Name}%
+ \Parameter{Seitenstil-Name}\Parameter{Ebenen-Name}\\
+ \hphantom{\XMacro{IfLayerAtPageStyle}}%
\Parameter{Dann-Code}\Parameter{Sonst-Code}\\
\Macro{IfSomeLayersAtPageStyle}%
- \Parameter{Seitenstil-Name}\Parameter{Ebenenliste}%
+ \Parameter{Seitenstil-Name}\Parameter{Ebenenliste}\\
+ \hphantom{\XMacro{IfSomeLayersAtPageStyle}}%
\Parameter{Dann-Code}\Parameter{Sonst-Code}\\
\Macro{IfLayersAtPageStyle}%
- \Parameter{Seitenstil-Name}\Parameter{Ebenenliste}%
+ \Parameter{Seitenstil-Name}\Parameter{Ebenenliste}\\
+ \hphantom{\XMacro{IfLayersAtPageStyle}}%
\Parameter{Dann-Code}\Parameter{Sonst-Code}%
\end{Declaration}
\BeginIndex{Cmd}{IfLayerAtPageStyle}%
\BeginIndex{Cmd}{IfSomeLayersAtPageStyle}%
\BeginIndex{Cmd}{IfLayersAtPageStyle}%
-Mit diesen Anweisungen kann überprüft werden ob ein oder mehrere Ebenen
-Bestandteil eines Seitenstils sind. Anweisung \Macro{IfLayerAtPageStyle}
+Mit diesen Anweisungen kann überprüft werden, ob ein oder mehrere Ebenen
+Bestandteil eines Seitenstils sind. \Macro{IfLayerAtPageStyle}\textnote{genau
+ eine Ebene}
erwartet dabei nach dem \PName{Seitenstil-Name} im ersten Argument im zweiten
Argument genau einen \PName{Ebenen-Name}. Ist die entsprechende Ebene
Bestandteil des Seitenstils, so wird der \PName{Dann-Code} ausgeführt,
anderenfalls der \PName{Sonst-Code}.
-Die Anweisungen \Macro{IfSomeLayersAtPageStyle} und
-\Macro{IfLayersAtPageStyle} erlauben hingegen im zweiten Argument eine durch
-Komma separierte \PName{Ebenenliste}. Dabei führt
-\Macro{IfSomeLayersAtPageStyle} den \PName{Dann-Code} bereits aus, wenn
-\emph{mindestens eine} der Ebenen Bestandteil des Seitenstils ist. Dagegen
-führt \Macro{IfLayersAtPageStyle} den \PName{Dann-Code} nur aus, wenn
-\emph{alle} Ebenen Bestandteil des Seitenstils sind. Ist die Bedingung nicht
-erfüllt, so wird jeweils \PName{Sonst-Code} ausgeführt.
+Im Unterschied dazu erlauben \Macro{IfSomeLayersAtPageStyle}
+und \Macro{IfLayersAtPageStyle} im zweiten Argument eine durch Komma
+separierte \PName{Ebenenliste}. Dabei führt
+\Macro{IfSomeLayersAtPageStyle}\textnote{mindestens eine Ebene}
+den \PName{Dann-Code} bereits aus, wenn \emph{mindestens eine} der Ebenen
+Bestandteil des Seitenstils ist. Dagegen führt
+\Macro{IfLayersAtPageStyle}\textnote{alle Ebenen} den
+\PName{Dann-Code} nur aus, wenn \emph{alle} Ebenen Bestandteil des Seitenstils
+sind. Ist die Bedingung nicht erfüllt, so wird jeweils \PName{Sonst-Code}
+ausgeführt.
Durch geeignete Schachtelung sind auch komplexe Bedingungen abbildbar. Gibt
man statt einer \PName{Ebenenliste} jeweils nur einen \PName{Ebenen-Name} an,
@@ -1269,7 +1348,7 @@ so sind alle drei Anweisungen gleichbedeutend.%
Mit dieser Anweisung kann ein Ebenen-Seitenstil aus \LaTeX-Sicht wieder
undefiniert werden. Dies gilt jedoch nur, wenn es einen Ebenen-Seitenstil mit
dem Namen \PName{Ebenen-Seitenstil-Name} auch tatsächlich gibt. Handelt es sich
-stattdessen um einen Alias-Seitentstil -- auch wenn dieser zu einem
+stattdessen um einen Alias-Seitenstil -- auch wenn dieser zu einem
Ebenen-Seitenstil führt -- oder um einen anderen Seitenstil oder ist gar kein
Seitenstil mit dem Namen \PName{Ebenen-Seitenstil-Name} bekannt, so geschieht
nichts, die Anweisung wird ignoriert.
@@ -1289,11 +1368,16 @@ möchten, so können Sie dies beispielsweise mit:
\end{lstcode}
vor der Vernichtung des Seitenstils selbst erreichen.
-Die Anweisung ist dazu gedacht innerhalb der automatischen Entfernung einer
-Endanwender-Schnittstelle verwendet zu werden. Siehe
-\autoref{sec:scrlayer.enduserinterfaces} für weitere Informationen zu diesem
-Thema.%
+Die Anweisung ist dazu bestimmt, innerhalb des Arguments \PName{Code} von
+\Macro{scrlayerOnAutoRemoveInterface} (siehe
+\autoref{sec:scrlayer.enduserinterfaces},
+\autopageref{desc:scrlayer.cmd.scrlayerOnAutoRemoveInterface}) verwendet zu
+werden, um Seitenstile, die als Teil eines Endanwender-Interfaces definiert
+wurden, beim automatischen Entfernen dieses Interfaces mit zu entfernen.%
\EndIndex{Cmd}{DestroyRealLayerPageStyle}%
+\EndIndex{}{Ebenen>Seitenstil}%
+\EndIndex{}{Seitenstil>Ebenen-}%
+\EndIndex{}{Seiten>Stil}%
\LoadCommon{20} % \section{Höhe von Kopf und Fuß}
@@ -1302,19 +1386,19 @@ Thema.%
\section{Definition und Verwaltung von Schnittstellen für Endanwender}
\label{sec:scrlayer.enduserinterfaces}
-Das Paket \Package{scrlayer} stellt eine Benutzerschnittstelle zur Verfügung
-um (konkurrierende) Schnittstellen für Endanwender definieren und verwalten zu
-können. Möglicherweise wird diese Schnittstelle langfristig wieder aus
-\Package{scrlayer} verschwinden und dann stattdessen von \Package{scrbase}
-übernommen werden. Derzeit ist diese Schnittstelle aber noch hoch
-experimentell und wird daher von eigenen Befehlen innerhalb von
+Das Paket \Package{scrlayer} stellt eine experimentelle Benutzerschnittstelle
+zur Verfügung um (konkurrierende) Schnittstellen für Endanwender definieren
+und verwalten zu können. Möglicherweise wird diese Schnittstelle langfristig
+wieder aus \Package{scrlayer} verschwinden und dann stattdessen von
+\Package{scrbase} übernommen werden. Derzeit ist die Schnittstelle aber noch
+hoch experimentell und wird daher von eigenen Befehlen innerhalb von
\Package{scrlayer} nur für Unterpakete von \Package{scrlayer} bereit
-gestellt. Es empfiehlt sich derzeit nicht, sich darauf zu verlassen, dass die
-automatische Entfernung einer konkurrierenden Schnittstelle
-funktioniert. Stattdessen sollte die Verwendung konkurrierender Schnittstellen
-vermieden werden.
+gestellt. Es empfiehlt sich beim aktuellen Entwicklungsstand nicht, sich
+darauf zu verlassen, dass die automatische Entfernung einer konkurrierenden
+Schnittstelle funktioniert. Stattdessen sollte die Verwendung konkurrierender
+Schnittstellen vermieden werden.
-Dieser Abschnitt beschreibt lediglich die Schnittstellen-Anweisungen für die
+Dieser Abschnitt beschreibt lediglich die Schnittstellen"=Anweisungen für die
Definition einer Endanwender-Schnittstelle. Für Endanwender selbst ist es
damit von geringem Interesse. Vielmehr richtet sich dieser Teil der Anleitung
an Autoren von Paketen und Klassen, die auf \Package{scrlayer}
@@ -1327,14 +1411,14 @@ Endanwender-Schnittstellen in \autoref{cha:scrlayer-scrpage},
\end{Declaration}
\BeginIndex{Cmd}{scrlayerInitInterface}%
Mit dieser Anweisung wird eine neue Schnittstelle mit dem Namen
-\PName{Schnittstellen-Name} registriert. Das Argument
+\PName{Schnittstellen-Name} registriert. Der
\PName{Schnittstellen-Name} muss einzigartig sein. Das bedeutet, dass eine
Schnittstelle gleichen Namens noch nicht registriert sein darf. Sollte dies
doch der Fall sein, so wird ein Fehler ausgegeben.
Diese Anweisung sollte immer ganz am Anfang einer Endanwender-Schnittstelle
stehen. Daher wird sie hier auch zuerst erklärt. Wird das optionale Argument
--- einschließlich der eckigen Klammern -- weg gelassen, so wird dafür
+-- einschließlich der eckigen Klammern -- weggelassen, so wird dafür
\PValue{\Macro{@currname}.\Macro{@currext}} verwendet. Für Klassen und
Pakete ist dies der Dateiname der Klasse respektive des Pakets. Aber
selbstverständlich kann jede andere Zeichenfolge der Kategorie \emph{letter}
@@ -1346,9 +1430,13 @@ eine Klasse oder ein Paket mehrere Endanwender-Schnittstellen definiert.%
\KOption{forceoverwrite}\PName{Ein-Aus-Wert}\\
\KOption{autoremoveinterfaces}\PName{Ein-Aus-Wert}\\
\Macro{scrlayerAddToInterface}%
- \OParameter{Schnittstellen-Name}\Parameter{Befehl}\Parameter{Code}\\
+ \OParameter{Schnittstellen-Name}\\
+ \hphantom{\XMacro{scrlayerAddToInterface}}%
+ \Parameter{Befehl}\Parameter{Code}\\
\Macro{scrlayerAddCsToInterface}%
- \OParameter{Schnittstellen-Name}\Parameter{Befehlssequenz}\Parameter{Code}
+ \OParameter{Schnittstellen-Name}\\
+ \hphantom{\XMacro{scrlayerAddCsToInterface}}%
+ \Parameter{Befehlssequenz}\Parameter{Code}
\end{Declaration}
\BeginIndex{Option}{forceoverwrite}%
\BeginIndex{Option}{autoremoveinterfaces}%
@@ -1377,14 +1465,14 @@ Endanwender-Schnittstelle hinzugefügt werden soll. Falls der Befehl
definiert werden kann, erfolgt dies. Außerdem wird dann der Befehl auf
\Macro{relax} gesetzt und \PName{Code} wird ausgeführt. Innerhalb von
\PName{Code} kann der \PName{Befehl} dann beispielsweise mit Hilfe von
-\Macro{newcommand}\PName{Befehl} definiert werden.
-
-Wann aber kann ein \PName{Befehl} definiert werden? Ist ein \PName{Befehl}
-undefiniert oder \Macro{relax}, so kann er immer definiert werden. Wurde ein
-\PName{Befehl} bereits definiert \emph{und} für eine andere
-Endanwender-Schnittstelle registriert \emph{und} wurde die \KOMAScript-Option
-\Option{autoremoveinterface} aktiviert, so wird diese andere
-Endanwender-Schnittstelle automatisch entfernt, der \PName{Befehl} auf
+\Macro{newcommand} definiert werden.
+
+Wann aber kann ein \PName{Befehl}\textnote{definierbare Befehle} definiert
+werden? Ist ein \PName{Befehl} undefiniert oder \Macro{relax}, so kann er
+immer definiert werden. Wurde ein \PName{Befehl} bereits definiert \emph{und}
+für eine andere Endanwender-Schnittstelle registriert \emph{und} wurde auch die
+\KOMAScript-Option \Option{autoremoveinterface} aktiviert, so wird diese
+andere Endanwender-Schnittstelle automatisch entfernt, der \PName{Befehl} auf
\Macro{relax} gesetzt und für die angegebene neue Endanwender-Schnittstelle
registriert. Damit ist \PName{Befehl} auch dann definierbar. Falls ein
\PName{Befehl} bereits definiert ist, \emph{aber nicht} Teil einer anderen
@@ -1413,19 +1501,20 @@ als erstes Argument keinen \PName{Befehl}, sondern eine
\OParameter{Schnittstellen-Name}\Parameter{Code}
\end{Declaration}
\BeginIndex{Cmd}{scrlayerOnAutoRemoveInterface}%
-Für den Fall, dass die Endanwender-Schnittstelle namens
+Für den Fall, dass die Endanwender-Schnittstelle mit dem angegebenen
\PName{Schnittstellen-Name} automatisch entfernt wird (siehe
\KOMAScript-Option \Option{autoremoveinterface} zuvor in diesem Abschnitt)
kann zusätzlich \PName{Code} ausgeführt werden. Dies kann beispielsweise
verwendet werden, um Ebenen oder Seitenstile automatisch mit zu vernichten
(siehe \Macro{DestroyLayer}, \Macro{DestroyAliasPageStyle}, and
\Macro{DestroyRealLayerPageStyle}), die auf Befehlen der
-Endanwender-Schnittstelle beruhen. Bezüglich des optionalen Arguments
-\PName{Schnittstellen-Name} sei auf die Erklärung zu
+Endanwender-Schnittstelle beruhen. Bezüglich der Voreinstellung für das
+optionale Argument sei auf die Erklärung zu
\Macro{scrlayerInitInterface} verwiesen.%
\EndIndex{Cmd}{scrlayerOnAutoRemoveInterface}%
%
\EndIndex{Package}{scrlayer}%
+\EndIndex{}{Ebenen}%
%%% Local Variables:
%%% mode: latex
@@ -1434,3 +1523,7 @@ Endanwender-Schnittstelle beruhen. Bezüglich des optionalen Arguments
%%% ispell-local-dictionary: "de_DE"
%%% TeX-master: "../guide"
%%% End:
+
+
+
+% LocalWords: Vordergrundebene