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.tex662
1 files changed, 362 insertions, 300 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 b37b80c26fa..9d5b7e6ab8e 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlayer.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer.tex
-% Copyright (c) Markus Kohm, 2013-2017
+% Copyright (c) Markus Kohm, 2013-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ============================================================================
\KOMAProvidesFile{scrlayer.tex}%
- [$Date: 2017-08-08 11:47:52 +0200 (Tue, 08 Aug 2017) $
+ [$Date: 2018-02-01 12:55:46 +0100 (Thu, 01 Feb 2018) $
KOMA-Script guide (chapter:scrlayer)]
\chapter[{Definition von Ebenen und Seitenstilen mit \Package{scrlayer}}]
@@ -86,22 +86,9 @@ Anwender werden als zusätzliche Pakete angeboten, die dann ihrerseits
\autoref{part:forAuthors} diese\iffree{r Anleitung}{s Buches}.
-\section{Hinweis zum Entwicklungsstand}
-\seclabel{draft}
-
-Die Entwicklung dieses Pakets ist noch nicht abgeschlossen. Teile des Pakets
-sind auch noch als experimentell einzustufen. Daher können sich in Zukunft
-insbesondere die internen Funktionalitäten und Funktionsweisen noch ändern. Es
-ist auch noch mit Erweiterungen zu rechnen. Wegen dieses noch nicht
-abgeschlossenen Entwicklungsstandes sollte der Leser auch keine abgeschlossene
-Anleitung erwarten. Dennoch gibt diese Anleitung, die sich vor allem an
-erfahrene Anwender und Entwickler richtet, den aktuellen Entwicklungsstand der
-Teile von \Package{scrlayer} wieder, die als zur Verwendung freigegeben
-eingestuft sind. Dinge, die hier nicht dokumentiert sind, sollten allenfalls
-zu Testzwecken Verwendung finden.
-
\LoadCommonFile{options} % \section{Frühe oder späte Optionenwahl}
+
\section{Einige grundlegende Informationen}
\seclabel{generic.information}
@@ -181,13 +168,13 @@ Klassenautors angewiesen.%
\begin{Declaration}
- \Macro{DeclareSectionNumberDepth}\Parameter{Name der Gliederungsebene}
- \Parameter{Tiefe der Gliederungsebene}
+ \Macro{DeclareSectionNumberDepth}\Parameter{Name~der~Gliederungsebene}
+ \Parameter{Tiefe~der~Gliederungsebene}
\end{Declaration}
Jeder Gliederungsebene ist normalerweise eine nummerische Tiefe
zugeordnet. Das ist notwendig, damit \LaTeX{} die Hierarchie der
-Gliederungsebenen verwalten kann. Allerdings sind die Werte normalerweise nur
-der jeweiligen Klasse bekannt, in der die Gliederungsbefehle definiert
+Gliederungsebenen verwalten kann. Allerdings sind die Werte
+nur der jeweiligen Klasse bekannt, in der die Gliederungsbefehle definiert
sind. Diese setzt dann in den entsprechenden \LaTeX-Befehlen selbst die
zugehörigen Nummern ein.
@@ -201,7 +188,7 @@ Tiefe bekannt gemacht werden. Für die Standardklassen wäre \PName{Name der
\PValue{paragraph} oder \PValue{subparagraph} und die jeweils zugehörige
\PName{Tiefe der Gliederungsebene} wäre -1, 0, 1, 2, 3, 4 oder 5.\par}
-Das Paket \Package{scrlayer} versucht diese nummerischen Werte zunächst beim
+Das Paket \Package{scrlayer} versucht, diese nummerischen Werte zunächst beim
Laden des Pakets und noch einmal während \Macro{begin}\PParameter{document}
selbst zu ermitteln. Aber für den Fall, dass dies einmal nicht zu einem
korrekten Ergebnis führt, beispielsweise falls es vollkommen andere
@@ -228,9 +215,14 @@ zwischen den beiden Ebenenstapeln.
Eine Ebene hat mehrere Eigenschaften, die als Antworten auf grundlegende
Fragen verstanden werden können:
-\begin{description}
-\item[Gehört die Ebene zum Vordergrund oder zum Hintergrund?\textnote{Vorder-
- oder Hintergrund}]%
+\iffree{\begin{description}}{%
+ \begingroup
+ \RedeclareSectionCommand[beforeskip=.5\baselineskip plus .25\baselineskip
+ minus .1\baselineskip]{paragraph}%
+ \renewcommand*\item[4][]{\paragraph*{#3{#4}#1}}%
+}%
+\item[Gehört die Ebene zum Vordergrund oder zum Hintergrund?]%
+ \leavevmode\textnote{Vorder- oder Hintergrund}\hskip 0pt
Hintergrundebenen werden ausgegeben, bevor der normale Inhalt der Seite
gedruckt wird. Optisch erscheinen sie daher \emph{hinter} oder \emph{unter}
dem normalen Inhalt der Seite. Vordergrundebenen werden an den normalen
@@ -240,23 +232,26 @@ Fragen verstanden werden können:
Vordergrundebene und wird daher zweimal ausgegeben. Normalerweise ist es
daher sinnvoll, dies explizit einzuschränken.
\item[An welcher Position soll die Ebene ausgegeben
- werden?\textnote{horizontale und vertikale Position}]%
+ werden?]%
+ \leavevmode\textnote{horizontale und vertikale Position}\hskip 0pt
Zur Beantwortung dieser Frage dienen Eigenschaften zur Festlegung der
horizontalen und der vertikalen Position.
-\item[Wie groß ist die Ebene?\textnote{horizontale und vertikale Größe}]%
+\item[Wie groß ist die Ebene?]%
+ \leavevmode\textnote{horizontale und vertikale Größe}\hskip 0pt
Ebenso wie für die Position gibt es auch für die horizontale und vertikale
Ausdehnung der Ebene Eigenschaften. Damit kann eine Ebene auch kleiner oder
größer als das Papier sein und an unterschiedlichen Positionen auf dem
Papier liegen.
\item[Wie werden die horizontale und die vertikale Position
- gemessen?\textnote{Ausrichtung}]%
+ gemessen?]%
+ \leavevmode\textnote{Ausrichtung}\hskip 0pt
Die Antwort auf diese Frage ist die Eigenschaft der Ausrichtung. Man kann
von der linken Papierkante zur linken Kante der Ebene, zur Mitte der Ebene
oder zur rechten Kante der Ebene messen. Entsprechend kann man von der
oberen Kante des Papiers zur oberen Kante der Ebene, zur Mitte der Ebene
oder zur unteren Kante der Ebene messen.
-\item[Ist die Ebene für Textausgabe oder für Grafik vorgesehen?\textnote{Text
- oder Grafik}]%
+\item[Ist die Ebene für Textausgabe oder für Grafik vorgesehen?]%
+ \leavevmode\textnote{Text oder Grafik}\hskip 0pt
Auch diese Frage ist eng mit der Position verknüpft. Während der Anwender
bei der Grafikausgabe beispielsweise davon ausgeht, dass der Ursprung in der
linken unteren Ecke der Ebene liegt, wäre dies bei der Textausgabe eher
@@ -266,23 +261,26 @@ Fragen verstanden werden können:
\Environment{picture}-Umgebung\IndexEnv{picture} auf, in der zusätzliche
Befehle zur Positionierung zur Verfügung stehen.
\item[Soll die Ebene auf linken oder rechten Seiten eines Dokuments gedruckt
- werden?\textnote{linke oder rechte Seite}]%
+ werden?]%
+ \leavevmode\textnote{linke oder rechte Seite}\hskip 0pt
In der Voreinstellung wird eine Ebene auf allen Seiten gedruckt. Es ist zu
beachten, dass \LaTeX{} Seiten mit geraden Seitenzahlen als linke Seiten und
Seiten mit ungeraden Seitenzahlen als rechte Seiten behandelt, dass es
jedoch im einseitigen Modus unabhängig von der Nummer nur rechte Seiten
- gibt. \LaTeX{} bezeichnet den Gepflogenheiten in der englischen Sprache
- entsprechend linke Seiten auch als gerade Seiten und rechte Seiten als
+ gibt. \LaTeX{} bezeichnet, den Gepflogenheiten in der englischen Sprache
+ entsprechend, linke Seiten auch als gerade Seiten und rechte Seiten als
ungerade Seiten.
\item[Soll die Ebene in einseitigen oder in doppelseitigen Dokumenten
- verwendet werden?\textnote{einseitig oder doppelseitig}]%
+ verwendet werden?]%
+ \leavevmode\textnote{einseitig oder doppelseitig}\hskip 0pt
In der Voreinstellung ist die Ebene diesbezüglich unbeschränkt, wird also
sowohl im einseitigen als auch im doppelseitigen Modus
ausgegeben. Nichtsdestotrotz wird eine Ebene, die auf gerade Seiten
beschränkt ist, im einseitigen Modus niemals ausgegeben werden und ist daher
auch keine einseitige Ebene.
\item[Soll die Ebene auf Gleitseiten oder auf Normalseiten ausgegeben
- werden?\textnote{Gleitseiten oder Normalseiten}]%
+ werden?]%
+ \leavevmode\textnote{Gleitseiten oder Normalseiten}\hskip 0pt
\LaTeX{} erzeugt Gleitseiten für Objekte aus Umgebungen wie
\Environment{table} oder \Environment{figure}, wenn diesen erlaubt wurde,
auf eigenen Seiten ohne Teile des normalen Dokumentinhalts ausgegeben zu
@@ -294,13 +292,17 @@ Fragen verstanden werden können:
Gleitumgebungen können auch den Eindruck einer Gleitseite erzeugen, obwohl
es sich bei ihnen in Wirklichkeit um oben auf einer Normalseite platzierte
Gleitumgebungen handelt.
-\item[Welchen Inhalt hat die Ebene?\textnote{Inhalt}]%
+\item[Welchen Inhalt hat die Ebene?]
+ \leavevmode\textnote{Inhalt}\hskip 0pt
Die zugehörige Eigenschaft gibt schlicht an, was gedruckt werden soll, wann
immer die Ebene ausgegeben wird.
-\end{description}
+\iffree{\end{description}}{%
+ \endgroup\par\bigskip\noindent\ignorespaces
+}%
Damit haben wir derzeit acht Fragen an die Ebenen, aus denen sich unmittelbar
-eine Reihe von Eigenschaften ergeben. Später in dieser Anleitung werden wir
-weitere Eigenschaften kennen lernen, die jedoch auf diese primären
+eine Reihe von Eigenschaften ergeben. Später
+\iffree{in dieser Anleitung }{}% Umbruchkorrektur
+werden wir weitere Eigenschaften kennenlernen, die jedoch auf diese primären
Eigenschaften abgebildet werden können.
\begin{Declaration}
@@ -313,19 +315,18 @@ Eigenschaften abgebildet werden können.
Diese Anweisungen können verwendet werden, um Ebenen zu definieren. Der
\PName{Name der Ebene} muss voll expandierbar sein. Die Expansion sollte in
ASCII-Buchstaben resultieren. Einige zusätzliche Zeichen werden ebenfalls
-akzeptiert, ihre Verwendung wird jedoch nicht empfohlen.
-
-Dabei spielt es bei Verwendung von
-\Macro{DeclareLayer}\important{\Macro{DeclareLayer}} keine Rolle, ob eine
-Ebene \PName{Name der Ebene} bereits existiert oder nicht. Sie wird in jedem
-Fall mit den über die \PName{Optionenliste} angegebenen Eigenschaften
-definiert. Einzelne Optionen bestehen entweder nur aus einem Schlüssel oder
-aus einem Schlüssel, gefolgt von einem Gleichheitszeichen und einem Wert. Die
-Optionen sind durch Komma voneinander getrennt. Um innerhalb der Werte einer
-Option ein Komma oder ein Leerzeichen verwenden zu können, muss der
-entsprechende Wert in geschweifte Klammern gesetzt werden. Eine Übersicht
-über die Optionen und die Eigenschaften, die sie repräsentieren, findet sich
-in \autoref{tab:scrlayer.layerkeys}.
+akzeptiert, ihre Verwendung wird jedoch nur erfahrenden Anwendern empfohlen.
+
+Bei Verwendung von \Macro{DeclareLayer}\important{\Macro{DeclareLayer}} spielt
+es keine Rolle, ob eine Ebene \PName{Name der Ebene} bereits existiert oder
+nicht. Sie wird in jedem Fall mit den über die \PName{Optionenliste}
+angegebenen Eigenschaften definiert. Einzelne Optionen bestehen entweder nur
+aus einem Schlüssel oder aus einem Schlüssel, gefolgt von einem
+Gleichheitszeichen und einem Wert. Die Optionen sind durch Komma voneinander
+getrennt. Um innerhalb der Werte einer Option ein Komma oder ein Leerzeichen
+verwenden zu können, muss der entsprechende Wert in geschweifte Klammern
+gesetzt werden. Eine Übersicht über die Optionen und die Eigenschaften, die
+sie repräsentieren, findet sich in \autoref{tab:scrlayer.layerkeys}.
Im Unterschied zu \Macro{DeclareLayer} meldet
\Macro{DeclareNewLayer}\important{\Macro{DeclareNewLayer}} einen Fehler, falls
@@ -400,7 +401,7 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar.
\Option{hoffset} oder \Option{voffset}. Mehrere
\PName{Ausrichtungszeichen} können ohne Leerzeichen oder Komma direkt
hintereinander geschrieben werden und werden in der Reihenfolge ihres
- Auftretens ausgewertet. Makros sind im Wert der Option jedoch
+ Auf"|tretens ausgewertet. Makros sind im Wert der Option jedoch
nicht zulässig. Zulässige \PName{Ausrichtungszeichen} sind:
\begin{description}
\item[\PValue{b} --] der Wert der Option \Option{voffset} ist der Abstand
@@ -421,7 +422,7 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar.
Die zusammengesetzte Eigenschaft resultiert in den primären Eigenschaften
\OptionVName{hoffset}{horizontaler Abstand},
\OptionVName{voffset}{vertikaler Abstand},
- \OptionVName{width}\PName{Breite}, \KOption{height}{Höhe}.%
+ \OptionVName{width}{Breite}, \KOption{height}{Höhe}.%
}%
\entry{\ChangedAt{v3.18}{\Package{scrlayer}}%
\Option{backandforeground}}{%
@@ -448,11 +449,10 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar.
\entry{\OptionVName{clone}{Name einer Ebene}}{%
Die zusammengesetzte Eigenschaft setzt alle primären Eigenschaften
entsprechend der aktuellen, primären Eigenschaften der Ebene mit dem
- angegebenen \PName{Name einer Ebene}. Es ist zu beachten, dass \PName{Name
- einer Ebene} voll expandierbar sein muss und zu Buchstaben expandieren
- sollte. Einige weitere Zeichen werden toleriert, ihre Verwendung wird
- jedoch nicht empfohlen! Die Ebene mit dem angegebenen \PName{Name einer
- Ebene} muss außerdem bereits existieren.%
+ angegebenen \PName{Name einer Ebene}. Bezüglich \PName{Name
+ einer Ebene} siehe die Hinweise zu \PName{Name der Ebene} am Anfang der
+ Erklärung zu \Macro{DeclareLayer}. Darüber hinaus muss die zu klonende
+ Ebene bereits definiert sein.%
}%
\entry{\OptionVName{contents}{Code}}{%
Der angegebene \PName{Code} wird immer dann expandiert und ausgeführt,
@@ -566,7 +566,7 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar.
}%
\entry{\ChangedAt{v3.19}{\Package{scrlayer}}%
\OptionVName{mode}{Modus}}{%
- Diese primäre Eigenschaft bestimmt in welchem \PName{Modus} der Inhalt der
+ Diese primäre Eigenschaft bestimmt, in welchem \PName{Modus} der Inhalt der
Ebene ausgegeben wird. Die Voreinstellung ist \PValue{text}. Dabei wird
die oberste Grundlinie um die Höhe einer Standardtextzeile unterhalb der
Oberkante der Ebene platziert. Damit ist Text normalerweise sauber am
@@ -575,12 +575,13 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar.
linken, unteren Ecke der Ebene aufgespannt. Der ebenfalls vordefinierte
\PName{Modus} \PValue{raw} entspricht in der Voreinstellung \PValue{text}.
- Die\textnote{Achtung!} Änderung des \PName{Modus} einer Ebene führt in der
- Regel zu einer Verschiebung des Inhalts. Außerdem stehen beispielsweise im
- \PName{Modus} \PValue{picture} zusätzliche Platzierungsbefehle zur
- Verfügung, die in einem anderen \PName{Modus} zu Fehlermeldungen führen.
- Daher ist es normalerweise nicht sinnvoll, den \PName{Modus} einer Ebene
- nachträglich zu ändern!%
+ Die %\textnote{Achtung!}
+ Änderung des \PName{Modus} einer Ebene führt in der Regel zu einer
+ Verschiebung des Inhalts. Außerdem stehen beispielsweise im \PName{Modus}
+ \PValue{picture} zusätzliche Platzierungsbefehle zur Verfügung, die in
+ einem anderen \PName{Modus} zu Fehlermeldungen führen. Daher ist es
+ normalerweise nicht sinnvoll, den \PName{Modus} einer Ebene nachträglich
+ zu ändern!%
}%
\entry{\Option{nonfloatpage}}{%
Mit dieser Option wird die Ebene auf Seiten beschränkt, die keine
@@ -695,20 +696,20 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar.
\Macro{layerwidth}
\Macro{layerheight}
\end{Declaration}
-Diese Anweisungen sind nur innerhalb der Ausgabe des mit \Option{contents},
-\Option{addcontents} oder \Option{pretocontents} angegebenen \PName{Code}
-gültig. In diesem Fall enthalten sie die tatsächlich verwendete Ausrichtung,
-Position und Ausdehnung der Ebene, die für die Ausgabe verwendet werden. Dies
-ist jedoch nicht zwangsläufig auch die tatsächliche Ausdehnung des Inhalts,
-falls dieser beispielsweise überbreit oder überhoch ist oder die Ebene nicht
-komplett ausfüllt.
+Diese Anweisungen sind nur im mit \Option{contents}, \Option{addcontents} oder
+\Option{pretocontents} angegebenen \PName{Code} gültig. Sie enthalten die
+tatsächlich verwendete Ausrichtung, Position und Ausdehnung der Ebene während
+deren Ausgabe. Dies ist jedoch nicht zwangsläufig auch die tatsächliche
+Ausdehnung des Inhalts, falls dieser beispielsweise überbreit oder überhoch
+ist oder die Ebene nicht komplett ausfüllt.
Die primäre Ebeneneigenschaft \PValue{align} wird auf
\Macro{layerhalign}\ChangedAt{v3.19}{\Package{scrlayer}} und
\Macro{layervalign} abgebildet. Dabei werden die horizontalen Werte \PValue{l}
und \PValue{r} nur in \Macro{layerhalign} übernommen, während die vertikalen
Werte \PValue{t} und \PValue{b} nur in \Macro{layervalign} übernommen
-werden. Der sowohl horizontale als auch vertikale Wert \PValue{c} wird in
+werden. \iffree{Der sowohl horizontale als auch vertikale }{}% Umbruchkorrektur
+Wert \PValue{c} wird in
beide Anweisungen übernommen. Sind bei \PValue{align} mehrere,
widersprüchliche Angaben zu finden, so gewinnt die jeweils letzte. Damit ist
also \Macro{layerhalign} immer entweder \PValue{l}, \PValue{c} oder \PValue{r}
@@ -724,21 +725,24 @@ Ergebnissen.%
\Macro{LenToUnit}\Parameter{Länge}
\end{Declaration}
Diese\ChangedAt{v3.19}{\Package{scrlayer}} Anweisung stammt ursprünglich von
-\Package{eso-pic}\IndexPackage{eso-pic} ab Version~2.0f. Sie rechnet
-Längen-Werte in Vielfache von \Length{unitlength} um und kann daher an Stelle
-von Koordinaten oder anderen von \Length{unitlength} abhängigen Werten einer
-\Environment{picture}-Umgebung verwendet werden. Siehe dazu auch
+\Package{eso-pic}\IndexPackage{eso-pic}\iffree{ ab
+ Version~2.0f}{}%Umbruchkorrektur
+. Sie rechnet Längen-Werte in Vielfache von \Length{unitlength} um und kann
+daher anstelle von Koordinaten oder anderen von \Length{unitlength} abhängigen
+Werten einer \Environment{picture}-Umgebung verwendet werden. Siehe dazu auch
\cite{package:eso-pic} und die nachfolgende Erklärung zu \Macro{putUR},
-\Macro{putLL} und \Macro{putLR}. Die Anweisung wird nur
-definiert, wenn sie nicht bereits beispielsweise durch das Laden von
-\Package{eso-pic} definiert ist.
-
+\Macro{putLL} und \Macro{putLR}. Die Anweisung wird nur definiert, wenn sie
+nicht bereits beispielsweise durch das Laden von \Package{eso-pic} definiert
+ist.%
+\iffalse% Umbruchkorrekturtext
+\par
Es sei an dieser Stelle darauf hingewiesen, dass man bei Verwendung von Paket
\Package{picture}\IndexPackage{picture}\textnote{\Package{picture}} (siehe
\cite{package:picture}) die Anweisung \Macro{LenToUnit} in der Regel nicht
mehr benötigt. Das Paket erweitert die \Environment{picture}-Umgebung und
deren Anweisung so, dass man für Koordinaten auch direkt \LaTeX-Längen
verwenden kann.%
+\fi
\EndIndexGroup
@@ -757,19 +761,21 @@ entspricht damit
\lstinline[breaklines=false]|\put(0,\LenToUnit{\layerheight})|. \Macro{putUR}
platziert \PName{Inhalt} relativ zur oberen, rechten Ecke der Ebene und
entspricht damit
-\lstinline[breaklines=false]|\put(\LenToUnit{\layerwidth},\LenToUnit{\layerheight})|.
+\lstinline[breaklines=false]
+|\put(\LenToUnit{\layerwidth},\LenToUnit{\layerheight})|.
+\iffree{}{\unskip\linebreak}% Umbruchkorrektur
\Macro{putLL} platziert \PName{Inhalt} relativ zur unteren, linken Ecke der
Ebene und entspricht damit
\lstinline[breaklines=false]|\put(0,0)|. \Macro{putLR} platziert
\PName{Inhalt} relativ zur unteren, rechten Ecke der Ebene und entspricht
damit
\lstinline[breaklines=false]|\put(\LenToUnit{\layerwidth},0)|. \Macro{putC}
-schließlich platziert \PName{Inhalt} relativ zur Mitte der Ebene.%
+schlussendlich platziert \PName{Inhalt} relativ zur Mitte der Ebene.%
%
\begin{Example}
Sie wollen feststellen, wie genau die Höhe des Textbereichs bei
\OptionValueRef{typearea}{DIV}{classic} tatsächlich der Breite der Seite
- entspricht und erstellen dazu eine Ebene, die sowohl den Textbereich
+ entspricht, und erstellen dazu eine Ebene, die sowohl den Textbereich
umrandet als auch einen Kreis mit der Papierbreite als Durchmesser im
Zentrum des Textbereichs platziert:
\begin{lstcode}
@@ -799,17 +805,17 @@ Näheres zu dem im Beispiel skizzierten spätmittelalterlichen Buchseitenkanon
finden Sie übrigens in \autoref{sec:typearea.circleConstruction},
\autopageref{sec:typearea.circleConstruction}.
-Die im Beispiel bereits verwendete Anweisung
-\Macro{DeclareNewPageStyleByLayers}\IndexCmd{DeclareNewPageStyleByLayers} wird
-leider erst in \autoref{sec:scrlayer.pagestyles},
-\DescPageRef{scrlayer.cmd.DeclareNewPageStyleByLayers} erklärt
-werden. Sie dient hier zur Definition eines Seitenstils, der die neu
-definierte Ebene auch tatsächlich verwendet.%
+Die Anweisung
+\Macro{DeclareNewPageStyleByLayers}\IndexCmd{DeclareNewPageStyleByLayers}, die
+im Beispiel bereits verwendet wurde, dient der Definition eines Seitenstils,
+der die neu definiert Ebene ausgibt. Sie wird in
+\autoref{sec:scrlayer.pagestyles},
+\DescPageRef{scrlayer.cmd.DeclareNewPageStyleByLayers} erklärt werden.%
\EndIndexGroup
\begin{Declaration}
- \Macro{GetLayerContents}\Parameter{Name der Ebene}
+ \Macro{GetLayerContents}\Parameter{Name~der~Ebene}
\end{Declaration}
Mit\ChangedAt{v3.16}{\Package{scrlayer}} dieser Anweisung kann der aktuelle
Inhalt einer Ebene ermittelt werden. Es\textnote{Achtung!} ist unbedingt zu
@@ -817,38 +823,44 @@ beachten, dass bei Verwendung dieser Anweisung im \PName{Code} der
Ebenen-Attribute \Option{contents}, \Option{addcontents} oder
\Option{pretocontents} unendliche Rekursionen entstehen können, wenn dabei auf
den Inhalt der aktuellen Ebene zugegriffen wird. Der Anwender ist selbst dafür
-verantwortlich solche Situationen zu vermeiden!%
+verantwortlich, solche Situationen zu vermeiden!%
\EndIndexGroup
\begin{Declaration}
- \Macro{IfLayerExists}\Parameter{Name}
+ \Macro{IfLayerExists}\Parameter{Name~der~Ebene}
\Parameter{Dann-Code}\Parameter{Sonst-Code}
\end{Declaration}
-Diese Anweisung kann dazu verwendet werden, Code in Abhängigkeit davon, ob ein
-eine Ebene existiert oder nicht, auszuführen. Wenn die Ebene mit dem
-angegebenen \PName{Name} existiert, so wird der \PName{Dann-Code}
-ausgeführt, anderenfalls der \PName{Sonst-Code}. Bitte beachten Sie, dass die
-Anweisung nicht wirklich testen kann, ob eine Ebene existiert. Sie verwendet
-stattdessen Heuristiken, die niemals falsch-negativ sein können, jedoch im
-Extremfall falsch-positiv sein könnten. Nichtsdestotrotz: Falls der Test
-falsch-positiv ist, läuft etwas schief. Beispielsweise könnte dies ein
-Indikator für die Verwendung eines inkompatiblen Pakets oder dafür sein, dass
-der Anwender etwas tut, was er besser nicht tun sollte.%
+Diese Anweisung kann dazu verwendet werden, Code in Abhängigkeit davon, ob
+eine Ebene existiert oder nicht, auszuführen. Wenn die Ebene \PName{Name der
+ Ebene} existiert, so wird der \PName{Dann-Code} ausgeführt, anderenfalls der
+\PName{Sonst-Code}. Bitte beachten Sie, dass die Anweisung nicht wirklich
+testen kann, ob eine Ebene existiert. Sie verwendet stattdessen Heuristiken,
+die niemals falsch-negativ sein können, jedoch im Extremfall falsch-positiv
+sein könnten. %
+\iffalse% Umbruchvarianten
+Nichtsdestotrotz: Falls der Test falsch-positiv ist, läuft etwas
+schief. Beispielsweise könnte dies ein Indikator für die Verwendung eines
+inkompatiblen Pakets oder dafür sein, dass der Anwender etwas tut, was er
+besser nicht tun sollte.%
+\else
+Falsch-positive Entscheidungen weisen auf ein Problem, beispielsweise die
+Verwendung eines inkompatiblen Pakets oder ungünstige Wahl von internen
+Makronamen durch den Anwender.%
+\fi
\EndIndexGroup
\begin{Declaration}
- \Macro{DestroyLayer}\Parameter{Name der Ebene}
+ \Macro{DestroyLayer}\Parameter{Name~der~Ebene}
\end{Declaration}
-Existiert eine Ebene mit dem angegebenen \PName{Name der Ebene}, so werden
-alle zu dieser Ebene gehörenden Makros zu \Macro{relax}. Anschließend kann die
-Ebene nicht länger verwendet werden. Allerdings ist es kein Problem, falls die
-Ebene Bestandteil eines mit \Package{scrlayer} definierten Seitenstils ist, da
-derart zerstörte Ebenen schlicht ignoriert werden. Nichtsdestotrotz können
-zerstörte Ebenen anschließend mit \DescRef{\LabelBase.cmd.DeclareNewLayer}
-oder \DescRef{\LabelBase.cmd.ProvideLayer} neu definiert werden. Sie können
-jedoch vor einer neuerlichen Definition nicht länger mit
+Existiert eine Ebene \PName{Name der Ebene}, so werden alle zu dieser Ebene
+gehörenden Makros zu \Macro{relax}. Die Ebene kann nicht länger verwendet
+werden. In bereits mit \Package{scrlayer} definierten Seitenstils werden
+derart zerstörte Ebenen ignoriert. Zerstörte Ebenen können mit
+\DescRef{\LabelBase.cmd.DeclareNewLayer} oder
+\DescRef{\LabelBase.cmd.ProvideLayer} neu definiert werden. Sie können jedoch
+vor einer neuerlichen Definition nicht länger mit
\DescRef{\LabelBase.cmd.RedeclareLayer} oder
\DescRef{\LabelBase.cmd.ModifyLayer} verändert werden.
@@ -890,15 +902,18 @@ möglicherweise überraschende Antwort lautet: mit Hilfe von
Seitenstilen. Üblicherweise werden Seitenstile in \LaTeX{} zur Definition von
Kopf und Fuß der Seite verwendet.
-Kopf und Fuß für ungerade oder rechte Seiten werden im doppelseitigen Modus
-auf Seiten mit ungerader Seitenzahl ausgegeben. Im einseitigen Modus werden
-sie auf allen Seiten verwendet. Das ist unmittelbar mit den Optionen
-\Option{oddpage} und \Option{evenpage} für Ebenen vergleichbar.
+Kopf und Fuß für ungerade oder rechte Seiten\textnote{gerade oder ungerade
+ Seite} werden im doppelseitigen Modus auf Seiten mit ungerader Seitenzahl
+ausgegeben. Im einseitigen Modus werden sie auf allen Seiten verwendet. Das
+ist unmittelbar mit den
+Optionen\important[i]{\Option{evenpage}\\\Option{oddpage}} \Option{oddpage}
+und \Option{evenpage} für Ebenen vergleichbar.
-Der Seitenkopf wird vor dem normalen Seiteninhalt ausgegeben. Der Seitenfuß
-wird entsprechend nach dem normalen Seiteninhalt ausgegeben. Dies
-korrespondiert also unmittelbar mit den Optionen \Option{background} und
-\Option{foreground} für Ebenen.
+Der Seitenkopf\textnote{Kopf oder Fuß} wird vor dem normalen Seiteninhalt
+ausgegeben. Der Seitenfuß wird entsprechend nach dem normalen Seiteninhalt
+ausgegeben. Dies korrespondiert also unmittelbar mit den
+Optionen\important[i]{\Option{background}\\\Option{foreground}}
+\Option{background} und \Option{foreground} für Ebenen.
Daher liegt es nahe, Seitenstile als Listen von Ebenen zu definieren. Aber
statt nur die genannten vier Optionen können dabei alle Eigenschaften
@@ -907,16 +922,16 @@ verwendet werden, die in \autoref{sec:scrlayer.layers},
erklärt wurden.
Als Ergebnis dieser Überlegungen ist eine Form von Seitenstilen, die
-\Package{scrlayer} bietet, der
-Ebenen-Seitenstil\textnote{Ebenen-Seitenstil}%
+\Package{scrlayer} bietet, der Ebenen-Seitenstil\textnote{Ebenen-Seitenstil}%
\Index{Seitenstil>Ebenen-}\Index{Ebenen>Seitenstil}\Index{Seiten>Stil}. Ein
solcher Ebenen-Seitenstil besteht aus Ebenen und zusätzlich aus mehreren Haken
(engl. \emph{hooks}). Die Ebenen wurden bereits in
-\autoref{sec:scrlayer.layers} beschrieben. Die Haken sind Punkte in der
-Expansion oder Anwendung von Seitenstilen, zu denen zusätzlicher Code
-hinzugefügt werden kann. Erfahrene Anwender kennen dieses Konzept bereits von
-beispielsweise \Macro{AtBeginDocument} (siehe \cite{latex:usrguide}) oder
-\Macro{BeforeClosingMainAux} (siehe
+\autoref{sec:scrlayer.layers} beschrieben. Die
+Haken\Index[indexmain]{Haken}\textnote{Haken} sind Punkte in der Expansion
+oder Anwendung von Seitenstilen, zu denen zusätzlicher Code hinzugefügt werden
+kann. Erfahrene Anwender kennen dieses Konzept bereits von beispielsweise
+\Macro{AtBeginDocument} (siehe \cite{latex:usrguide}) oder
+\DescRef{scrlfile.cmd.BeforeClosingMainAux} (siehe
\DescPageRef{scrlfile.cmd.BeforeClosingMainAux}).
Eine zweite Form von Seitenstilen, die \Package{scrlayer} bietet, ist der
@@ -930,11 +945,11 @@ Manipulation am originären Seitenstil. Ist der originäre Seitenstil selbst
ebenfalls ein Seitenstil-Alias, so führt dessen Manipulation wiederum zu einer
Manipulation dessen originären Seitenstils und immer so weiter, bis
schließlich ein realer Seitenstil verändert wird. Der Ausdruck \emph{realer
- Seitenstil} wird zur Unterscheidung von einem Seitenstil-Alias
-verwendet. Alle Seitenstile, die kein Seitenstil-Alias sind, sind reale
-Seitenstile. Seitenstil-Aliase können nicht nur für Seitenstile definiert
-werden, die mit \Package{scrlayer} definiert wurden, sondern für alle
-Seitenstile.
+ Seitenstil}\textnote{realer Seitenstil} wird zur Unterscheidung von einem
+Seitenstil-Alias verwendet. Alle Seitenstile, die kein Seitenstil-Alias sind,
+sind reale Seitenstile. Seitenstil-Aliase können nicht nur für Seitenstile
+definiert werden, die mit \Package{scrlayer} definiert wurden, sondern für
+alle Seitenstile.
\begin{Declaration}
@@ -970,7 +985,7 @@ den aktuellen Seitenstil auf eine Voreinstellung zu setzen.%
\Macro{BeforeSelectAnyPageStyle}\Parameter{Code}
\Macro{AfterSelectAnyPageStyle}\Parameter{Code}
\end{Declaration}
-Die Anweisung \Macro{BeforeSelectAnyPageStyle} fügt einem Haken
+Die Anweisung \Macro{BeforeSelectAnyPageStyle} fügt einem Haken\Index{Haken}
(engl. \emph{hook}) \PName{Code} hinzu, der innerhalb der Ausführung von
Anweisung \DescRef{maincls.cmd.pagestyle}%
\important{\DescRef{maincls.cmd.pagestyle}}\IndexCmd{pagestyle}, unmittelbar
@@ -996,13 +1011,13 @@ einer Gruppe beschränkt werden.%
\begin{Declaration}
\Macro{DeclarePageStyleAlias}\Parameter{Seitenstil-Alias-Name}
- \Parameter{originärer Seitenstil-Name}
+ \Parameter{originärer~Seitenstil-Name}
\Macro{DeclareNewPageStyleAlias}\Parameter{Seitenstil-Alias-Name}
- \Parameter{originärer Seitenstil-Name}
+ \Parameter{originärer~Seitenstil-Name}
\Macro{ProvidePageStyleAlias}\Parameter{Seitenstil-Alias-Name}
- \Parameter{originärer Seitenstil-Name}
+ \Parameter{originärer~Seitenstil-Name}
\Macro{RedeclarePageStyleAlias}\Parameter{Seitenstil-Alias-Name}
- \Parameter{originärer Seitenstil-Name}
+ \Parameter{originärer~Seitenstil-Name}
\end{Declaration}
\BeginIndex{}{Seitenstil>Alias-}%
\BeginIndex{}{Alias>Seitenstil}%
@@ -1046,8 +1061,8 @@ eine Fehlermeldung.
er dies mit:
\begin{lstcode}
\RedeclarePageStyleAlias{chapter}{empty}
-\end{lstcode}
-\end{Example}
+\end{lstcode}%
+\end{Example}%
\fi
\EndIndexGroup
@@ -1060,8 +1075,8 @@ eine Fehlermeldung.
Mit dieser Anweisung wird der Seitenstil-Alias mit dem angegebenen Namen
\PName{Seitenstil-Alias-Name} für \LaTeX{} wieder undefiniert, wenn es
tatsächlich einen Alias-Seitenstil dieses Namens gibt. Anschließend kann der
-Seitenstil auch mit \Macro{DeclareNewAliasPageStyle} oder
-\Macro{ProvideAliasPageStyle} wieder neu definiert werden.
+Seitenstil auch mit \DescRef{\LabelBase.cmd.DeclareNewPageStyleAlias} oder
+\DescRef{\LabelBase.cmd.ProvidePageStyleAlias} neu definiert werden.
Die Anweisung ist dazu bestimmt, innerhalb des Arguments \PName{Code} von
\DescRef{\LabelBase.cmd.scrlayerOnAutoRemoveInterface} (siehe
@@ -1083,8 +1098,7 @@ Alias-Seitenstil gehört. Ist \PName{Seitenstil-Name} nicht der Name eines
Alias-Seitenstils, so ist das Ergebnis \PName{Seitenstil-Name} selbst. Das
gilt auch, falls ein Seitenstil namens \PName{Seitenstil-Name} gar nicht
existiert. Die Anweisung ist voll expandierbar und kann damit beispielsweise
-auch im zweiten Argument einer \Macro{edef}-Anweisung verwendet werden.
-%
+auch im zweiten Argument einer \Macro{edef}-Anweisung verwendet werden.%
\EndIndexGroup
@@ -1104,23 +1118,23 @@ auch im zweiten Argument einer \Macro{edef}-Anweisung verwendet werden.
\end{Declaration}
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
-Diese Anweisungen deklarieren einen Seitenstil mit dem
-Namen \Parameter{Seitenstil-Name}. Der Seitenstil besteht aus einer Anzahl von
-Ebenen, die in der mit Komma separierten \PName{Ebenenliste} angegeben
-sind. Es ist zu beachten\textnote{Achtung!}, dass sowohl
-\PName{Seitenstil-Name} als auch \PName{Ebenenliste} voll expandierbar sein
-müssen und die Expansion zu einer Reihe von Buchstaben führen sollte. Einige
-andere Zeichen werden zwar toleriert, ihre Verwendung wird jedoch nicht
+Diese Anweisungen deklarieren einen Seitenstil mit dem Namen
+\PName{Seitenstil-Name}. Der Seitenstil besteht aus einer Anzahl von Ebenen,
+die in der mit Komma separierten \PName{Ebenenliste} angegeben sind. Es ist zu
+beachten\textnote{Achtung!}, dass sowohl \PName{Seitenstil-Name} als auch
+\PName{Ebenenliste} voll expandierbar sein müssen und die Expansion zu einer
+Reihe von Buchstaben führen sollte. Einige zusätzliche Zeichen werden
+ebenfalls akzeptiert, ihre Verwendung wird jedoch nur erfahrenden Anwendern
empfohlen.
Die \PName{Optionenliste} ist eine mit Komma separierte Liste von Optionen der
Form \texttt{\PName{Schlüssel}=\PName{Code}}. Diese Optionen können verwendet
werden, um zusätzliche Eigenschaften zu setzen und zusätzliche Möglichkeiten
-zu nutzen. Derzeit werden sie verwendet, um Code an bestimmten Stellen der
-Aktivierung oder Verwendung eines Seitenstils über Haken (engl. \emph{hooks})
-auszuführen. Für allgemeine Informationen zu Haken sei auf die Einleitung zu
-diesem Abschnitt verwiesen. Details zu den Haken und ihrer Bedeutung sind
-\autoref{tab:scrlayer.pagestyle.hooks} zu entnehmen.
+zu nutzen. Derzeit werden sie verwendet, um \mbox{Code} an bestimmten Stellen
+der Aktivierung oder Verwendung eines Seitenstils über Haken\Index{Haken}
+(engl. \emph{hooks}) auszuführen. Für allgemeine Informationen zu Haken sei
+auf die Einleitung zu diesem Abschnitt verwiesen. Details zu den Haken und
+ihrer Bedeutung sind \autoref{tab:scrlayer.pagestyle.hooks} zu entnehmen.
\begin{desclist}
\desccaption{%
@@ -1130,80 +1144,81 @@ diesem Abschnitt verwiesen. Details zu den Haken und ihrer Bedeutung sind
Optionen für die Haken von Ebenen-Seitenstilen (\emph{Fortsetzung})%
}%
\entry{\OptionVName{onselect}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn der
- Seitenstil beispielsweise mit \DescRef{maincls.cmd.pagestyle} ausgewählt wird. Es ist zu
- beachten, dass \DescRef{maincls.cmd.thispagestyle} selbst keinen Seitenstil unmittelbar
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn der Seitenstil beispielsweise mit \DescRef{maincls.cmd.pagestyle}
+ ausgewählt wird. Es ist zu beachten, dass
+ \DescRef{maincls.cmd.thispagestyle} selbst keinen Seitenstil unmittelbar
auswählt, sondern der Seitenstil in diesem Fall erst innerhalb der
Ausgaberoutine von \LaTeX{} aktiviert wird.%
}%
\entry{\OptionVName{oninit}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
- Ausgabe der Ebenen für den Seitenstil initialisiert wird. Beachten Sie,
- dass dies für jede Seite zweimal geschieht: einmal für Hintergrund-Ebenen
- und einmal für Vordergrund-Ebenen.%
- }%
- \entry{\OptionVName{ononeside}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn im
- einseitigen Modus die Ausgabe der Ebenen für den Seitenstil initialisiert
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn die Ausgabe der Ebenen für den Seitenstil initialisiert
wird. Beachten Sie, dass dies für jede Seite zweimal geschieht: einmal für
Hintergrund-Ebenen und einmal für Vordergrund-Ebenen.%
}%
+ \entry{\OptionVName{ononeside}{Code}}{%
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn im einseitigen Modus die Ausgabe der Ebenen für den Seitenstil
+ initialisiert wird. Beachten Sie, dass dies für jede Seite zweimal
+ geschieht: einmal für Hintergrund-Ebenen und einmal für
+ Vordergrund-Ebenen.%
+ }%
\entry{\OptionVName{ontwoside}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn im
- doppelseitigen Modus die Ausgabe der Ebenen für den Seitenstil
- initialisiert wird. Beachten Sie, dass dies für jede
- Seite zweimal geschieht: einmal für Hintergrund-Ebenen und einmal für
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn im doppelseitigen Modus die Ausgabe der Ebenen für den Seitenstil
+ initialisiert wird. Beachten Sie, dass dies für jede Seite zweimal
+ geschieht: einmal für Hintergrund-Ebenen und einmal für
Vordergrund-Ebenen.%
}%
\entry{\OptionVName{onoddpage}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
- Ausgabe der Ebenen für den Seitenstil auf einer rechten Seite
- initialisiert wird. Beachten Sie, dass dies für jede
- Seite zweimal geschieht: einmal für Hintergrund-Ebenen und einmal für
- Vordergrund-Ebenen. Beachten Sie außerdem, dass im
- einseitigen Modus alle Seiten rechte Seiten sind.%
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn die Ausgabe der Ebenen für den Seitenstil auf einer rechten Seite
+ initialisiert wird. Beachten Sie, dass dies für jede Seite zweimal
+ geschieht: einmal für Hintergrund-Ebenen und einmal für
+ Vordergrund-Ebenen. Beachten Sie außerdem, dass im einseitigen Modus alle
+ Seiten rechte Seiten sind.%
}%
\entry{\OptionVName{onevenpage}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
- Ausgabe der Ebenen für den Seitenstil auf einer linken Seite initialisiert
- wird. Beachten Sie, dass dies für jede Seite zweimal
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn die Ausgabe der Ebenen für den Seitenstil auf einer linken Seite
+ initialisiert wird. Beachten Sie, dass dies für jede Seite zweimal
geschieht: einmal für Hintergrund-Ebenen und einmal für
- Vordergrund-Ebenen. Beachten Sie außerdem, dass im
- einseitigen Modus keine linken Seiten existieren.%
+ Vordergrund-Ebenen. Beachten Sie außerdem, dass im einseitigen Modus keine
+ linken Seiten existieren.%
}%
\entry{\OptionVName{onfloatpage}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
- Ausgabe der Ebenen für den Seitenstil auf einer Gleitumgebungsseite
- initialisiert wird. Beachten Sie, dass dies für jede
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn die Ausgabe der Ebenen für den Seitenstil auf einer
+ Gleitumgebungsseite initialisiert wird. Beachten Sie, dass dies für jede
Seite zweimal geschieht: einmal für Hintergrund-Ebenen und einmal für
- Vordergrund-Ebenen. Beachten Sie außerdem, dass
- Gleitumgebungsseiten nur diejenigen Seiten sind, auf denen eine oder
- mehrere p-platzierte Gleitumgebungen ausgegeben werden.%
+ Vordergrund-Ebenen. Beachten Sie außerdem, dass Gleitumgebungsseiten nur
+ diejenigen Seiten sind, auf denen eine oder mehrere p-platzierte
+ Gleitumgebungen ausgegeben werden.%
}%
\entry{\OptionVName{onnonfloatpage}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
- Ausgabe der Ebenen für den Seitenstil auf einer Seite initialisiert wird,
- die keine Gleitumgebungsseite ist. Beachten Sie, dass
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn die Ausgabe der Ebenen für den Seitenstil auf einer Seite
+ initialisiert wird, die keine Gleitumgebungsseite ist. Beachten Sie, dass
dies für jede Seite zweimal geschieht: einmal für Hintergrund-Ebenen und
- einmal für Vordergrund-Ebenen. Beachten Sie außerdem,
- dass Gleitumgebungsseiten nur diejenigen Seiten sind, auf denen eine oder
+ einmal für Vordergrund-Ebenen. Beachten Sie außerdem, dass
+ Gleitumgebungsseiten nur diejenigen Seiten sind, auf denen eine oder
mehrere p-platzierte Gleitumgebungen ausgegeben werden, und auf anderen
Seiten sehr wohl t-, b- oder h-platzierte Gleitumgebungen stehen können.%
}%
\entry{\OptionVName{onbackground}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
- Ausgabe der Ebenen für den Hintergrund einer Seite initialisiert
- wird. Beachten Sie, dass dies auf jeder Seite genau
- einmal der Fall ist.%
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn die Ausgabe der Ebenen für den Hintergrund einer Seite initialisiert
+ wird. Beachten Sie, dass dies auf jeder Seite genau einmal der Fall ist.%
}%
\entry{\OptionVName{onforeground}{Code}}{%
- Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
- Ausgabe der Ebenen für den Vordergrund einer Seite initialisiert
- wird. Beachten Sie, dass dies auf jeder Seite genau
- einmal der Fall ist.%
+ Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
+ wenn die Ausgabe der Ebenen für den Vordergrund einer Seite initialisiert
+ wird. Beachten Sie, dass dies auf jeder Seite genau einmal der Fall ist.%
}%
\end{desclist}
+\iffalse% Umbruchvarianten
Während die Anweisung
\Macro{DeclarePageStyleByLayers} %\important{\Macro{DeclarePageStyleByLayers}}%
% Leider zu lang. Deshalb auch auf alle
@@ -1215,7 +1230,21 @@ Seitenstils, der bereits ein Alias für einen anderen Seitenstil ist (siehe
beispielsweise \Macro{DeclareAliasPageStyle} zuvor in diesem Abschnitt) nicht
zu der Umdefinierung des angegebenen Alias-Seitenstils, sondern des realen
Seitenstils (siehe \DescRef{\LabelBase.cmd.GetRealPageStyle} zuvor in diesem
-Abschnitt) führt.
+Abschnitt) führt.%
+\else%
+Die Anweisung \Macro{DeclarePageStyleByLayers} definiert den Seitenstil
+unabhängig davon, ob bereits ein Seitenstil des Namens \PName{Seitenstil-Name}
+existiert. Gegebenenfalls wird der existierende Seitenstil komplett neu
+definiert. Falls bereits ein Alias-Seitenstil \PName{Seitenstil-Name}
+existiert wird jedoch nicht der Alias-Seitenstil selbst neu definiert, sondern
+der zugehörige reale Seitenstil (siehe
+\DescRef{\LabelBase.cmd.GetRealPageStyle} zuvor in diesem Abschnitt).
+
+Die Anweisung \Macro{DeclareNewPageStyleByLayers} unterscheidet sich in dem
+Fall, dass bereits ein gleichnamiger Seitenstil existiert. Unabhängig davon,
+ob es sich um einen realen Seitenstil oder einen Alias-Seitenstil handelt,
+wird in diesem Fall ein Fehler gemeldet.%
+\fi
Im Unterschied dazu wird bei \Macro{ProvidePageStyleByLayers} der Seitenstil
unverändert erhalten, wenn bereits ein Seitenstil des Namens
@@ -1227,7 +1256,7 @@ bereits ein Seitenstil des Namens \PName{Seitenstil-Name} existiert und
definiert dessen realen Seitenstil dann um. Existiert jedoch noch kein
Seitenstil des angegebenen Namens, so resultiert daraus eine Fehlermeldung.
-Beachten Sie auch die nachfolgenden Anmerkungen zum Pseudo-Seitenstil
+Beachten Sie des Weiteren die nachfolgenden Anmerkungen zum Pseudo-Seitenstil
\PageStyle{@everystyle@}.%
\EndIndexGroup
@@ -1241,13 +1270,13 @@ Beachten Sie auch die nachfolgenden Anmerkungen zum Pseudo-Seitenstil
Das Paket \Package{scrlayer} definiert von sich aus bereits zwei in gewisser
Weise spezielle Seitenstile. Der erste davon ist
\PageStyle{@everystyle@}\important{\PageStyle{@everystyle@}}. Dieser
-Seitenstil sollte niemals als normaler Seitenstil beispielsweise mit
-\DescRef{maincls.cmd.pagestyle} oder \DescRef{maincls.cmd.thispagestyle} oder
+Seitenstil sollte niemals als normaler Seitenstil, beispielsweise mit
+\DescRef{maincls.cmd.pagestyle} oder \DescRef{maincls.cmd.thispagestyle}, oder
als Ziel eines Alias-Seitenstils verwendet werden. Stattdessen werden die
-Ebenen und Haken dieses Seitenstils von allen anderen Ebenen-Seitenstilen mit
-verwendet. Dabei werden die Haken von \PageStyle{@everystyle@} jeweils vor den
-entsprechenden Haken und die Ebenen jeweils vor den entsprechenden Ebenen des
-aktiven Seitenstils ausgeführt.
+Ebenen und Haken\Index{Haken} dieses Seitenstils von allen anderen
+Ebenen-Seitenstilen mit verwendet. Dabei werden die Haken von
+\PageStyle{@everystyle@} jeweils vor den entsprechenden Haken und die Ebenen
+jeweils vor den entsprechenden Ebenen des aktiven Seitenstils ausgeführt.
Damit ist das Hinzufügen einer Ebene zum Pseudo-Seitenstil
\PageStyle{@everystyle@} oder von Code zu einem Haken dieses Seitenstils
@@ -1266,8 +1295,9 @@ ein Seitenstil dieses Namens definiert, der einen leeren Kopf und Fuß hat. Das
Paket \Package{scrlayer} definiert diesen Seitenstil als Ebenen-Seitenstil
ohne Ebenen um. Nichtsdestotrotz kann er wie jeder andere Ebenen-Seitenstil
verwendet werden. Der Hauptvorteil dieses Ebenen-Seitenstils gegenüber dem
-ursprünglichen Seitenstil aus dem \LaTeX-Kern ist, dass er ebenfalls die Haken
-und Ebenen des Pseudo-Seitenstils \PageStyle{@everystyle@} ausführt.%
+ursprünglichen Seitenstil aus dem \LaTeX-Kern ist, dass er ebenfalls die
+Haken\Index{Haken} und Ebenen des Pseudo-Seitenstils \PageStyle{@everystyle@}
+ausführt.%
\EndIndexGroup
@@ -1285,17 +1315,21 @@ und Ebenen des Pseudo-Seitenstils \PageStyle{@everystyle@} ausführt.%
\end{Declaration}
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
-Für jeden der Haken aus \autoref{tab:scrlayer.pagestyle.hooks} existiert
-außerdem eine \KOMAScript-Option. Die Namen der \KOMAScript-Optionen ähneln
-den Namen der Optionen für die Befehle zur Deklaration von
-Ebenen-Seitenstilen. Es wird lediglich ein »\texttt{ps}« nach dem
-»\texttt{on}« am Anfang des Namens eingefügt. Die Werte dieser
-\KOMAScript-Optionen werden als Anfangswerte für die entsprechenden Haken
-verwendet. Dieser Anfangswert wird dann um alle Werte, die dem entsprechenden
-Haken in der \PName{Optionenliste} der Deklarationsbefehle zugewiesen werden,
-erweitert. Der Anfangswert kann mit Hilfe der Anweisung
-\DescRef{\LabelBase.cmd.ModifyLayerPageStyleOptions}, die später in diesem
-Abschnitt erklärt wird, entfernt werden.%
+Für jeden der Haken\Index{Haken} aus \autoref{tab:scrlayer.pagestyle.hooks}
+existiert außerdem eine \KOMAScript-Option%
+\iftrue%
+. Die Namen der \KOMAScript-Optionen ähneln den Namen der Optionen für die
+Befehle zur Deklaration von Ebenen-Seitenstilen. Es wird lediglich ein
+»\texttt{ps}« nach dem »\texttt{on}« am Anfang des Namens eingefügt%
+\else%
+, in deren Namen lediglich ein \texttt{ps} eingefügt wurde%
+\fi%
+. Die Werte dieser \KOMAScript-Optionen werden als Anfangswerte für die
+entsprechenden Haken verwendet. Dieser Anfangswert wird dann um alle Werte,
+die dem entsprechenden Haken in der \PName{Optionenliste} der
+Deklarationsbefehle zugewiesen werden, erweitert. Der Anfangswert kann mit
+Hilfe der Anweisung \DescRef{\LabelBase.cmd.ModifyLayerPageStyleOptions}, die
+später in diesem Abschnitt erklärt wird, entfernt werden.%
\EndIndexGroup
@@ -1304,14 +1338,15 @@ Abschnitt erklärt wird, entfernt werden.%
\end{Declaration}
Wird\ChangedAt{v3.24}{\Package{scrlayer}\and \Package{scrlayer-scrpage}} ein
Dokument beispielsweise mit Hilfe von Paket
-\Package{setspace}\IndexPackage{setspace} mit erhöhtem Zeilenabstand gesetzt,
-ist es oft dennoch nicht erwünscht, dass Kopf und Fuß der Seite ebenfalls mit
-diesem erhöhten Zeilenabstand gesetzt werden. Das gilt umso mehr, wenn Kopf
-und Fuß nur aus jeweils einer Zeile bestehen. In diesem Fall kann man
-\KOMAScript-Option \Option{singlespacing} setzen. In der Voreinstellung ist
-die Option jedoch nicht gesetzt! Die Option wirkt generell für alle
-Ebenen-Seitenstile. Will man hingegen nur einige Ebenen-Seitenstil einzeilig
-gesetzt haben, so sollte man stattdessen für diese Seitenstile
+\Package{setspace}\IndexPackage{setspace}\important{\Package{setspace}} mit
+erhöhtem Zeilenabstand gesetzt, ist es oft dennoch nicht erwünscht, dass Kopf
+und Fuß der Seite ebenfalls mit diesem erhöhten Zeilenabstand gesetzt
+werden. Das gilt umso mehr, wenn Kopf und Fuß nur aus jeweils einer Zeile
+bestehen. In diesem Fall kann man \KOMAScript-Option \Option{singlespacing}
+setzen. In der Voreinstellung\textnote{Voreinstellung} ist die Option jedoch
+nicht gesetzt! Die Option wirkt generell für alle Ebenen-Seitenstile. Will man
+hingegen nur einige Ebenen-Seitenstil einzeilig gesetzt haben, so sollte man
+stattdessen für diese Seitenstile
\OptionValue{oninit}{\Macro{linespread}\PParameter{1}\Macro{selectfont}}
verwenden.%
\EndIndexGroup
@@ -1342,16 +1377,16 @@ Platzhalter für den Namen der gerade abgearbeiteten Ebene.
\end{lstcode}
erreichen.
\end{Example}
-Die Verwendung von \Macro{gdef} an Stelle von \Macro{def} ist im Beispiel
-notwendig, weil \PName{Code} innerhalb einer Gruppe ausgeführt wird, um
-unerwünschte Seiteneffekte zu minimieren. Die Anweisung \Macro{gdef} definiert
-\Macro{commaatlist} jedoch global um, so dass beim Aufruf des Codes für die
-nächste Ebene die Änderung Bestand hat.
+Die Verwendung von \Macro{gdef} anstelle von \Macro{def} ist im Beispiel
+notwendig\textnote{Achtung!}, weil \PName{Code} innerhalb einer Gruppe
+ausgeführt wird, um unerwünschte Seiteneffekte zu minimieren. Die Anweisung
+\Macro{gdef} definiert \Macro{commaatlist} jedoch global um, so dass beim
+Aufruf des Codes für die nächste Ebene die Änderung Bestand hat.
Alternativ\ChangedAt{v3.18}{\Package{scrlayer}} hätte man auch zwar mit
\Macro{def}, dafür aber mit der Sternvariante \Macro{ForEachLayerOfPageStyle*}
arbeiten können. Diese Form verzichtet bei der Ausführung von \PName{Code} auf
-eine zusätzliche Gruppe. Allerdings muss der Anwender dann selbst
+eine Gruppe. Allerdings muss der Anwender dann selbst
sicherstellen, dass \PName{Code} keine unerwünschten Seiteneffekte
hat. Insbesondere würde die Deaktivierung der Ebenen mit
\OptionValue{deactivatepagestylelayers}{true} innerhalb von \PName{Code} dann
@@ -1361,8 +1396,7 @@ Diverse Anweisungen von \Package{scrlayer} setzen intern selbst ebenfalls
\Macro{ForEachLayerOfPageStyle} ein. Auch deren Funktion kann daher über die
\KOMAScript-Option \Option{deactivatepagestylelayers} verändert werden. Diese
Option kann also verwendet werden, um alle Ebenen aller Seitenstile temporär
-zu deaktivieren oder zu verstecken.
-%
+zu deaktivieren und damit zu verstecken.%
\EndIndexGroup
@@ -1379,7 +1413,7 @@ zu deaktivieren oder zu verstecken.
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
Diese Anweisungen können verwendet werden, um Ebenen zu einem Seitenstil
-hinzuzufügen oder davon zu entfernen. Der Seitenstil wird dabei über seinen
+hinzuzufügen oder davon zu entfernen. Der Seitenstil wird dabei über
\PName{Seitenstil-Name} referenziert. Die Ebenen werden in einer durch Komma
separierten \PName{Ebenenliste} angegeben.
@@ -1398,13 +1432,20 @@ Ende von \PName{Ebenenliste} steht, nach dem Einfügen die erste und damit die
unterste oder hinterste Ebene (jeweils entweder der Vordergrund- oder der
Hintergrundebenen) sein.
+\iffalse% Umbruchkorrekturtext (beim Aktiveren muss unten \textnot{entfernen}
+ % entfernt werden!)
+Die Anweisung \Macro{RemoveLayersFromPageStyle} dient dem genauen
+Gegenteil. Sie entfernt\textnote{entfernen} die angegebenen Ebenen von
+Seitenstil.%
+\fi
+
Der Versuch, mit Hilfe von
\Macro{RemoveLayersFromPageStyle}\textnote{entfernen} Ebenen von einem
Seitenstil zu entfernen, die gar nicht Teil des Seitenstils sind, wird
ignoriert, führt also nicht zu einer Fehlermeldung. Dagegen ist der Versuch,
Ebenen zu einem Seitenstil, der kein Ebenen-Seitenstil ist und auch kein
Alias-Seitenstil, der zu einem Ebenen-Seitenstil führt, hinzuzufügen oder von
-einem solchen zu entfernen ein Fehler und wird als solcher gemeldet.%
+einem solchen zu entfernen, ein Fehler und wird als solcher gemeldet.%
\EndIndexGroup
@@ -1418,14 +1459,23 @@ einem solchen zu entfernen ein Fehler und wird als solcher gemeldet.%
\end{Declaration}
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
+\iffalse% Umbruchvarianten
Diese beiden Befehle ähneln den vorangegangenen. Allerdings wird hier
zusätzlich ein \PName{Referenzebenen-Name} angegeben. Die Ebenen des über den
\PName{Seitenstil-Name} angegebenen Seitenstils werden nach dieser
-Referenzebene durchsucht. Die Ebenen der \PName{Ebenenliste} werden dann
+Referenzebene durchsucht. %
+\else%
+Die Befehle ähneln den vorherigen. Die existierenden Ebenen des Seitenstils
+werden jedoch nach \PName{Referenzebenen-Name} durchsucht. %
+\fi%
+Die Ebenen der \PName{Ebenenliste} werden dann
vor\textnote{hinzufügen vor/nach Ebene}
-respektive nach jedem Auf"|treten der Referenzebene in die Ebenen des
-Seitenstils eingefügt. Dabei bleibt die Reihenfolge der Ebenen der
-\PName{Ebenenliste} erhalten.%|
+respektive nach jedem Auf"|treten der Referenzebene %
+\iffalse% Umbruchkorrekturtext
+in die Ebenen des Seitenstils %
+\fi%
+eingefügt. Dabei bleibt die Reihenfolge der Ebenen der
+\PName{Ebenenliste} erhalten.
Ist die Referenzebene nicht Bestandteil des Seitenstils, so wird auch nichts
eingefügt. Ist der Seitenstil hingegen kein Ebenen-Seitenstil und auch kein
@@ -1464,18 +1514,19 @@ Reihenfolge neu hinzugefügt werden. In einem solchen Fall ist
\end{Declaration}
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
-Mit diesen beiden Anweisungen können die Optionen und damit die Haken eines
-Ebenen-Seitenstils nachträglich verändert werden. Bei
+Mit diesen beiden Anweisungen können die Optionen und damit die
+Haken\Index{Haken} eines Ebenen-Seitenstils nachträglich verändert werden. Bei
\Macro{ModifyLayerPageStyleOptions}\textnote{Seitenstil-Optionen ändern}
werden dabei genau die Optionen, die in der durch Komma separierten
-\PName{Optionenliste} angegeben sind, auf die dortigen neuen Werte gesetzt. Die
-bisherigen Werte gehen dabei verloren. Es sind alle Optionen aus
+\PName{Optionenliste} angegeben sind, auf die dortigen neuen Werte
+gesetzt. Die bisherigen Werte gehen dabei verloren. Es sind alle Optionen aus
\autoref{tab:scrlayer.pagestyle.hooks},
-\autopageref{tab:scrlayer.pagestyle.hooks} erlaubt. Optionen beziehungsweise
-Haken, die nicht in der \PName{Optionenliste} angegeben sind, bleiben hingegen
-unverändert. Diese Anweisung ist damit auch die einzige Möglichkeit, die
-globalen Voreinstellungen der \KOMAScript-Optionen von einem Seitenstil zu
-entfernen.
+\autopageref{tab:scrlayer.pagestyle.hooks} erlaubt. Optionen
+\iffree{beziehungsweise}{oder} Haken, die nicht in der \PName{Optionenliste}
+angegeben sind, bleiben hingegen unverändert. Diese Anweisung ist
+\iffree{damit auch }{}% Umbruchkorrektur
+die einzige Möglichkeit, die globalen Voreinstellungen der
+\KOMAScript-Optionen von einem Seitenstil zu entfernen.
Die Anweisung \Macro{AddToLayerPageStyleOptions}\textnote{Seitenstil-Optionen
erweitern} dagegen überschreibt die bisher vorhandenen Werte nicht, sondern
@@ -1494,19 +1545,20 @@ neuen Werte an die alten an.%
\end{Declaration}
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
-Mit diesen Anweisungen kann Code in Abhängigkeit davon ausgeführt werden, ob
+Mit den Anweisungen kann Code in Abhängigkeit davon ausgeführt werden, ob
ein Seitenstil ein Ebenen-Seitenstil ist oder nicht. Dabei führt
\Macro{IfLayerPageStyleExists} den \PName{Dann-Code} nur dann aus, wenn
\PName{Seitenstil-Name} der Name eines Ebenen-Seitenstils oder der Name eines
Alias-Seitenstils ist, der zu einem Ebenen-Seitenstil führt. Anderenfalls
führt die Anweisung den \PName{Sonst-Code} aus.
-Die Anweisung \Macro{IfRealLayerPageStyleExists} geht einen Schritt weiter und
-führt den \PName{Dann-Code} nur dann aus, wenn der über
-\PName{Seitenstil-Name} angegebene Seitenstil selbst ein Ebenen-Seitenstil
-ist. Im Falle eines Alias-Seitenstils führt diese Anweisung also selbst dann
-\PName{Sonst-Code} aus, wenn dieser Alias-Seitenstil zu einem
-Ebenen-Seitenstil führt.%
+\iffree{Die Anweisung }{}%Umbruchvarianten
+\Macro{IfRealLayerPageStyleExists} geht einen Schritt weiter und führt
+\iffree{den }{}% Umbruchvarianten
+\PName{Dann-Code} nur dann aus, wenn der über \PName{Seitenstil-Name}
+angegebene Seitenstil selbst ein Ebenen-Seitenstil ist. Im Falle eines
+Alias-Seitenstils führt diese Anweisung also selbst dann \PName{Sonst-Code}
+aus, wenn dieser Alias-Seitenstil zu einem Ebenen-Seitenstil führt.%
\EndIndexGroup
@@ -1527,22 +1579,21 @@ Ebenen-Seitenstil führt.%
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
Mit diesen Anweisungen kann überprüft werden, ob ein oder mehrere Ebenen
-Bestandteil eines Seitenstils sind. \Macro{IfLayerAtPageStyle}\textnote{genau
- eine Ebene}
-erwartet dabei nach dem \PName{Seitenstil-Name} im ersten Argument im zweiten
-Argument genau einen \PName{Ebenen-Name}. Ist die entsprechende Ebene
-Bestandteil des Seitenstils, so wird der \PName{Dann-Code} ausgeführt,
-anderenfalls der \PName{Sonst-Code}.
-
-Im Unterschied dazu erlauben \Macro{IfSomeLayersAtPageStyle}
-und \Macro{IfLayersAtPageStyle} im zweiten Argument eine durch Komma
-separierte \PName{Ebenenliste}. Dabei führt
-\Macro{IfSomeLayersAtPageStyle}\textnote{mindestens eine Ebene}
-den \PName{Dann-Code} bereits aus, wenn \emph{mindestens eine} der Ebenen
+Bestandteil eines Seitenstils sind. \Macro{IfLayerAtPageStyle} erwartet dabei
+nach dem \PName{Seitenstil-Name} im ersten Argument im zweiten Argument
+genau\textnote{genau eine Ebene} einen \PName{Ebenen-Name}. Ist die
+entsprechende Ebene Bestandteil des Seitenstils, so wird der \PName{Dann-Code}
+ausgeführt, anderenfalls der \PName{Sonst-Code}.
+
+Im Unterschied dazu erlauben \Macro{IfSomeLayersAtPageStyle} und
+\Macro{IfLayersAtPageStyle} im zweiten Argument eine durch Komma separierte
+\PName{Ebenenliste}. Dabei führt
+\Macro{IfSomeLayersAtPageStyle}\textnote{mindestens eine Ebene} den
+\PName{Dann-Code} bereits aus, wenn \emph{mindestens eine} der Ebenen
Bestandteil des Seitenstils ist. Dagegen führt
-\Macro{IfLayersAtPageStyle}\textnote{alle Ebenen} den
-\PName{Dann-Code} nur aus, wenn \emph{alle} Ebenen Bestandteil des Seitenstils
-sind. Ist die Bedingung nicht erfüllt, so wird jeweils \PName{Sonst-Code}
+\Macro{IfLayersAtPageStyle}\textnote{alle Ebenen} den \PName{Dann-Code} nur
+aus, wenn \emph{alle} Ebenen Bestandteil des Seitenstils sind. \iffree{Ist die
+ Bedingung nicht erfüllt, so}{Anderenfalls} wird jeweils \PName{Sonst-Code}
ausgeführt.
Durch geeignete Schachtelung sind auch komplexe Bedingungen abbildbar. Gibt
@@ -1556,24 +1607,31 @@ so sind alle drei Anweisungen gleichbedeutend.%
\end{Declaration}
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
+\iftrue%
+Mit der Anweisung wird ein Ebenen-Seitenstil aus \LaTeX-Sicht undefiniert.
+Wurde statt eines Ebenen-Seitenstils ein Alias-Seitenstil, ein anderer
+Seitenstil oder ein unbekannter Seitenstil angegeben, so wird die Anweisung
+ignoriert.%
+\else%
Mit dieser Anweisung kann ein Ebenen-Seitenstil aus \LaTeX-Sicht wieder
undefiniert werden. Dies gilt jedoch nur, wenn es einen Ebenen-Seitenstil mit
dem Namen \PName{Ebenen-Seitenstil-Name} auch tatsächlich gibt. Handelt es sich
stattdessen um einen Alias-Seitenstil -- auch wenn dieser zu einem
Ebenen-Seitenstil führt -- oder um einen anderen Seitenstil oder ist gar kein
Seitenstil mit dem Namen \PName{Ebenen-Seitenstil-Name} bekannt, so geschieht
-nichts, die Anweisung wird ignoriert.
+nichts, die Anweisung wird ignoriert.%
+\fi
Falls \PName{Ebenen-Seitenstil-Name} der Name des aktuellen Seitenstils ist,
-so wird der aktuelle Seitenstil auf eine Art leerer Seitenstil gesetzt. Falls
-der Spezial-Seitenstil, der durch \DescRef{maincls.cmd.thispagestyle} gesetzt
-wurde, auf \PName{Ebenen-Seitenstil-Name} lautet, so wird dieser einfach nur
+so wird dieser auf eine Art leeren Seitenstil gesetzt. Falls der mit
+\DescRef{maincls.cmd.thispagestyle} gesetzte Seitenstil
+\PName{Ebenen-Seitenstil-Name} lautet, so wird dieser einfach nur
zurückgesetzt. Die vorherige Anweisung \DescRef{maincls.cmd.thispagestyle}
verliert damit ihre aktuelle Auswirkung.
Es ist zu beachten\textnote{Achtung!}, dass die Ebenen des Seitenstils nicht
automatisch mit vernichtet werden. Falls Sie die Ebenen ebenfalls vernichten
-möchten, so können Sie dies beispielsweise mit:
+möchten, so können Sie dies beispielsweise mit
\begin{lstcode}
\ForEachLayerOfPageStyle{...}{\DestroyLayer{#1}}
\end{lstcode}
@@ -1597,18 +1655,21 @@ wurden, beim automatischen Entfernen dieses Interfaces mit zu entfernen.%
Das Paket \Package{scrlayer} stellt eine experimentelle Benutzerschnittstelle
zur Verfügung um (konkurrierende) Schnittstellen für Endanwender definieren
-und verwalten zu können. Möglicherweise wird diese Schnittstelle langfristig
-wieder aus \Package{scrlayer} verschwinden und dann stattdessen von
-\Package{scrbase} übernommen werden. Derzeit ist die Schnittstelle aber noch
-hoch experimentell und wird daher von eigenen Befehlen innerhalb von
-\Package{scrlayer} nur für Unterpakete von \Package{scrlayer} bereit
-gestellt. Es empfiehlt sich beim aktuellen Entwicklungsstand nicht, sich
-darauf zu verlassen, dass die automatische Entfernung einer konkurrierenden
+und verwalten zu können. \iffree{% Umbruchvarianten
+ Möglicherweise wird diese Schnittstelle langfristig wieder aus
+ \Package{scrlayer} verschwinden und dann stattdessen von \Package{scrbase}
+ übernommen werden. }{}%
+Derzeit ist die Schnittstelle aber noch hoch
+experimentell\iffree{% Umbruchvariante
+ und wird daher von eigenen Befehlen innerhalb von \Package{scrlayer} nur für
+ Unterpakete von \Package{scrlayer} bereit gestellt}{}%
+. Es empfiehlt sich beim aktuellen Entwicklungsstand nicht, sich darauf zu
+verlassen, dass die automatische Entfernung einer konkurrierenden
Schnittstelle funktioniert. Stattdessen sollte die Verwendung konkurrierender
Schnittstellen vermieden werden.
Dieser Abschnitt beschreibt lediglich die Schnittstellen"=Anweisungen für die
-Definition einer Endanwender-Schnittstelle. Für Endanwender selbst ist es
+Definition einer Endanwender-Schnittstelle. Für Endanwender selbst ist er
damit von geringem Interesse. Vielmehr richtet sich dieser Teil der Anleitung
an Autoren von Paketen und Klassen, die auf \Package{scrlayer}
aufbauen. Endanwender finden Informationen zu konkreten
@@ -1657,17 +1718,17 @@ optionale Argument auch dann zu verwenden, wenn es dem Dateinamen der Klasse
beziehungsweise des Pakets entspricht, da die Werte von \Macro{@currname} und
\Macro{@currext} nur während des Ladens Gültigkeit besitzen.
-Das erste obligatorische Argument ist der \PName{Befehl}\footnote{\PName{Befehl}
- besteht aus einem umgekehrten Schrägstrich (engl. \emph{backslash}) gefolgt
- von einer \PName{Befehlssequenz}, die entweder aus Zeichen der
- Kategorie \emph{letter} oder aus genau einem Zeichen der Kategorie
- \emph{other} besteht, oder aus einem Zeichen der Kategorie \texttt{active}
- (ohne umgekehrten Schrägstrich davor).}, der zu der
-Endanwender-Schnittstelle hinzugefügt werden soll. Falls der Befehl
-definiert werden kann, erfolgt dies. Außerdem wird dann der Befehl auf
-\Macro{relax} gesetzt und \PName{Code} wird ausgeführt. Innerhalb von
-\PName{Code} kann der \PName{Befehl} dann beispielsweise mit Hilfe von
-\Macro{newcommand} definiert werden.
+Das erste obligatorische Argument ist der
+\PName{Befehl}\footnote{\PName{Befehl} besteht aus einem umgekehrten
+ Schrägstrich (engl. \emph{backslash}), gefolgt von einer
+ \PName{Befehlssequenz}, die entweder aus Zeichen der Kategorie \emph{letter}
+ oder aus genau einem Zeichen der Kategorie \emph{other} besteht, oder aus
+ einem Zeichen der Kategorie \emph{active} (ohne umgekehrten Schrägstrich
+ davor).}, der zu der Endanwender-Schnittstelle hinzugefügt werden
+soll. Falls der Befehl definiert werden kann, erfolgt dies. Außerdem wird dann
+der Befehl auf \Macro{relax} gesetzt und \PName{Code} wird
+ausgeführt. Innerhalb von \PName{Code} kann der \PName{Befehl} dann
+beispielsweise mit Hilfe von \Macro{newcommand} definiert werden.
Wann aber kann ein \PName{Befehl}\textnote{definierbare Befehle} definiert
werden? Ist ein \PName{Befehl} undefiniert oder \Macro{relax}, so kann er
@@ -1728,6 +1789,7 @@ optionale Argument sei auf die Erklärung zu
% LocalWords: Vordergrundebene Sternvariante Gleitseiten Hintergrundebenen
% LocalWords: Ausgabebeschränkungen Grafikausgabe Textausgabe Textebenen
-% LocalWords: Standardgrundlinie Grafikebenen Standardtextzeile
+% LocalWords: Standardgrundlinie Grafikebenen Standardtextzeile überhoch
% LocalWords: Platzierungsbefehle Ebeneneigenschaft Satzspiegelkonstruktion
% LocalWords: Kreisschlagen Buchseitenkanon spätmittelalterlichen
+% LocalWords: Makronamen