summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer.tex')
-rw-r--r--macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer.tex296
1 files changed, 171 insertions, 125 deletions
diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer.tex
index 18a1c91b59..f887b84b5d 100644
--- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer.tex
+++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer.tex
@@ -46,7 +46,7 @@
% ============================================================================
\KOMAProvidesFile{scrlayer.tex}%
- [$Date: 2019-10-09 15:19:04 +0200 (Wed, 09 Oct 2019) $
+ [$Date: 2019-12-03 09:41:21 +0100 (Tue, 03 Dec 2019) $
KOMA-Script guide (chapter:scrlayer)]
\chapter[{Definition von Ebenen und Seitenstilen mit \Package{scrlayer}}]
@@ -60,29 +60,29 @@
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
-\Package{textpos}, mit denen bereits eine Art Hintergrund- oder
+\Package{textpos}, mit denen eine Art Hintergrund- oder
Vor\-der\-grund\-ebe\-ne in \LaTeX{} verfügbar gemacht wurden. Das Paket
\Package{scrlayer} ist ein weiteres Paket, das solche Hintergrund- und
Vordergrundebenen zur Verfügung stellt. Im Unterschied zu den anderen
genannten Paketen sind die Ebenen bei \Package{scrlayer} jedoch Teil des
-Seitenstils. Dadurch ist eine einfache Umschaltung zwischen der Verwendung
-unterschiedlicher Ebenen durch die Umschaltung des Seitenstils möglich.
-
-Um dies zu erreichen, stellt das Paket auf unterer Stufe zusätzlich eine
-Schnittstelle zur Definition von Seitenstilen, die auf einem Stapel oder einer
-Liste von Ebenen beruhen, zum Hinzufügen von Ebenen wahlweise am Anfang oder
-Ende einer solchen Liste von Ebenen oder unmittelbar vor oder hinter einer
-anderen Ebene in einer solchen Liste, zum Löschen einer Ebene aus einer
-solchen Liste und zum Löschen aller Dubletten einer Ebene aus einer solchen
-Liste bereit. Oder kurz und verständlich gesagt: Die Seitenstil-Schnittstelle
-von \Package{scrlayer} stellt Befehle bereit, um einen Seitenstil, der auf
-einer Liste von Ebenen basiert, zu definieren und diese Ebenenliste zu
-verwalten.
+Seitenstils. Dadurch ist eine Umschaltung zwischen der Verwendung
+unterschiedlicher Ebenen einfach durch die Umschaltung des Seitenstils möglich.
+
+Um dies zu erreichen, stellt das Paket eine Schnittstelle für die Verwaltung
+Seitenstilen bereit, die auf Ebenen basieren. Über diese können neue
+Seitenstil als Stapel oder Listen von Ebenen definiert werden. Ebenen können
+wahlweise am Anfang oder Ende dieser Listen eingefügt werden. Das Einfügen ist
+ebenfalls vor oder nach einer anderen Ebene in einer solchen Liste
+möglich. Ebenen können auch wieder aus den Listen entfernt oder Listen von
+Dupletten bereinigt werden. Natürlich gibt es außerdem Schnittstellen zur
+Definition und Manipulation der Ebenen selbst.
Nichtsdestoweniger wird die direkte Verwendung der Ebenen nur erfahrenen
Anwendern empfohlen. Schnittstellen für Anfänger und durchschnittliche
-Anwender werden als zusätzliche Pakete angeboten, die dann ihrerseits
-\Package{scrlayer} laden. Siehe hierzu \autoref{cha:scrlayer-scrpage} in
+Anwender werden als zusätzliche Pakete wie
+\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} angeboten, die
+dann ihrerseits \Package{scrlayer} laden. Siehe hierzu
+\autoref{cha:scrlayer-scrpage} ab \autopageref{cha:scrlayer-scrpage} in
\autoref{part:forAuthors} diese\iffree{r Anleitung}{s Buches}.
@@ -98,10 +98,10 @@ sie entsprechende Angaben machen. Anderenfalls versucht das Paket diese
Informationen selbst zu ermitteln. Das funktioniert beispielsweise für die
Standardklassen oder für die \KOMAScript-Klassen. Mit anderen Klassen kann es
funktionieren oder auch ganz oder teilweise fehlschlagen.
-
+\iffalse \par\fi% Umbruchkorrektur
Dieser Abschnitt beschreibt einige der Informationen, die Autoren von Klassen
-bereitstellen können. Anwender sollten sich im Normalfall nicht darum zu
-kümmern brauchen.
+bereitstellen können.\iffalse Anwender sollten sich im Normalfall nicht darum zu
+kümmern brauchen.\fi
\begin{Declaration}
\Macro{if@chapter}\ \PName{Dann-Code}\ %
@@ -171,24 +171,24 @@ Klassenautors angewiesen.%
\Macro{DeclareSectionNumberDepth}\Parameter{Name~der~Gliederungsebene}
\Parameter{Tiefe~der~Gliederungsebene}
\end{Declaration}
-Jeder Gliederungsebene ist normalerweise eine nummerische Tiefe
+Jeder Gliederungsebene ist normalerweise eine numerische Tiefe
zugeordnet. Das ist notwendig, damit \LaTeX{} die Hierarchie der
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.
-{\setlength{\emergencystretch}{1em}%
+{\setlength{\emergencystretch}{1em}% Umbruchkorrektur
Das Paket \Package{scrlayer} benötigt ebenfalls Informationen über die
Hierarchie. Mit Hilfe von \Macro{DeclareSectionNumberDepth} kann
-\Package{scrlayer} zum Namen einer Gliederungsebene die zugehörige nummerische
+\Package{scrlayer} zum Namen einer Gliederungsebene die zugehörige numerische
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.\par}
+\PValue{paragraph}, \PValue{subparagraph} und die jeweilige
+\PName{Tiefe der Gliederungsebene} -1, 0, 1, 2, 3, 4, 5.\par}
-Das Paket \Package{scrlayer} versucht, diese nummerischen Werte zunächst beim
+Das Paket \Package{scrlayer} versucht, diese numerischen 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
@@ -229,31 +229,37 @@ Fragen verstanden werden können:
Inhalt anschließend ausgegeben. Optisch erscheinen sie daher \emph{vor},
\emph{auf} oder \emph{über} dem normalen Inhalt der Seite. In der
Voreinstellung ist eine Ebene sowohl eine Hintergrundebene als auch eine
- Vordergrundebene und wird daher zweimal ausgegeben. Normalerweise ist es
- daher sinnvoll, dies explizit einzuschränken.
-\item[An welcher Position soll die Ebene ausgegeben
- werden?]%
- \leavevmode\textnote{horizontale und vertikale Position}\hskip 0pt
- Zur Beantwortung dieser Frage dienen Eigenschaften zur Festlegung der
- horizontalen und der vertikalen Position.
+ Vordergrundebene und wird daher zweimal ausgegeben. In der Regel ist es
+ deshalb sinnvoll, dies explizit einzuschränken.
\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.
+ Eine Ebene kann auch kleiner oder größer als das Papier sein. Damit werden
+ Eigenschaften für die horizontale und vertikale Ausdehnung der Ebene
+ benötigt.
+\item[An welcher Position soll die Ebene ausgegeben werden?]%
+ \leavevmode\textnote{horizontale und vertikale Position}\hskip 0pt
+ Diese Frage stellt sich nicht nur aufgrund der von der Papiergröße
+ möglichweise abweichenden Ausdehnung der Ebene. Auch gleich große Ebenen
+ können gegeneinander verschoben sein. Ihre Beantwortung führt zu
+ Eigenschaften für die Festlegung der horizontalen und vertikalen Position
+ der Ebene.
\item[Wie werden die horizontale und die vertikale Position
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.
+ \iftrue% Umbruchkorrektur
+ Diese Frage ergibt sich unmittelbar aus der vorherigen. Die Antwort darauf
+ \else%
+ Die Antwort auf diese Frage %
+ \fi%
+ 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?]%
\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
+ bei der Grafikausgabe davon ausgeht, dass der Ursprung in der
linken unteren Ecke der Ebene liegt, wäre dies bei der Textausgabe eher
ungünstig. Daher liegt der Ursprung für Textebenen um die Höhe einer
Standardtextzeile unterhalb der oberen, linken Ecke der Ebene. Grafikebenen
@@ -264,12 +270,14 @@ Fragen verstanden werden können:
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
- ungerade Seiten.
+ beachten, dass \LaTeX{} im doppelseitigen Satz 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
+ der englischen Sprache entsprechend, linke Seiten auch als gerade Seiten
+ und rechte Seiten als ungerade Seiten. Dies erfolgt ungeachtet der Tatsache,
+ dass im einseitigen Satz ungerade Seiten dann auch gerade Nummern tragen
+ können.
\item[Soll die Ebene in einseitigen oder in doppelseitigen Dokumenten
verwendet werden?]%
\leavevmode\textnote{einseitig oder doppelseitig}\hskip 0pt
@@ -312,10 +320,11 @@ Eigenschaften abgebildet werden können.
\Macro{RedeclareLayer}\OParameter{Optionenliste}\Parameter{Name der Ebene}
\Macro{ModifyLayer}\OParameter{Optionenliste}\Parameter{Name der Ebene}
\end{Declaration}
-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 nur erfahrenden Anwendern empfohlen.
+Diese Anweisungen können verwendet werden, um Ebenen zu definieren oder zu
+verändern. 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 nur erfahrenen
+Anwendern empfohlen.
Bei Verwendung von \Macro{DeclareLayer}\important{\Macro{DeclareLayer}} spielt
es keine Rolle, ob eine Ebene \PName{Name der Ebene} bereits existiert oder
@@ -327,36 +336,14 @@ 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
-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}\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}\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.
-
+%
+% Umbruchkorrektur: Tabelle verschoben
\begin{desclist}
\desccaption{%
- Optionen für die Definition von Seiten-Ebenen mit ihrer jeweiligen
+ Optionen für die Beschreibung von Seiten-Ebenen mit ihrer jeweiligen
Bedeutung als Ebenen-Eigenschaft\label{tab:scrlayer.layerkeys}%
}{%
- Optionen für die Definition von Ebenen (\emph{Fortsetzung})%
+ Optionen für die Beschreibung von Ebenen (\emph{Fortsetzung})%
}%
\entry{%
\ChangedAt{v3.16}{\Package{scrlayer}}%
@@ -428,7 +415,7 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar.
\Option{backandforeground}}{%
Mit dieser Option wird die Einschränkung der Ebene auf den Vorder- oder
Hintergrund wieder aufgehoben und diesbezüglich die Grundeinstellung
- wieder hergestellt. In der Regel ist dies wenig sinnvoll, daher existiert
+ wiederhergestellt. In der Regel ist dies wenig sinnvoll, daher existiert
die Option nur aus Gründen der Vollständigkeit. Diese Option erwartet und
erlaubt keinen Wert.%
}%
@@ -486,7 +473,7 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar.
\Option{floatornonfloatpage}}{%
Mit dieser Option wird die Einschränkung der Ebene auf Gleitseiten oder
Seiten, die keine Gleitseiten sind, aufgehoben und diesbezüglich die
- Voreinstellung wieder hergestellt. Diese Option erwartet und erlaubt
+ Voreinstellung wiederhergestellt. Diese Option erwartet und erlaubt
keinen Wert.%
}%
\entry{\Option{floatpage}}{%
@@ -684,17 +671,40 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar.
Längenausdrucks ist \cite[Abschnitt~3.5]{manual:eTeX} zu entnehmen.%
}%
\end{desclist}
-%
+
+\iffree{}{\clearpage}% Umbruchkorrektur
+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}\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}\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.%
\EndIndexGroup
\begin{Declaration}
\Macro{ModifyLayers}\OParameter{Optionenliste}\Parameter{Ebenenliste}
\end{Declaration}
Diese\ChangedAt{v3.26}{\Package{scrlayer}} Anweisung führt
-\DescRef{\LabelBase.cmd.ModifyLayer} mit der angebenen \PName{Optionenliste}
-für alle Ebenen aus, die in der durch Komma separierten \PName{Ebenenliste}
-angegeben sind. Sie dient also dazu, die Eigenschaften einer ganzen Reihe von
-Ebenen gleichzeitig zu ändern.%
+\DescRef{\LabelBase.cmd.ModifyLayer}\Parameter{Optionenliste}\Parameter{Ebene}
+für jede \PName{Ebene} aus, die in der durch Komma separierten
+\PName{Ebenenliste} angegeben ist. Sie dient also dazu, die Eigenschaften
+einer ganzen Reihe von Ebenen gleichzeitig auf gleiche Weise zu ändern.%
\EndIndexGroup
\begin{Declaration}
@@ -739,10 +749,10 @@ Diese\ChangedAt{v3.19}{\Package{scrlayer}} Anweisung stammt ursprünglich von
. 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.%
+\cite{package:eso-pic} und die nachfolgende Erklärung zu
+\DescRef{\LabelBase.cmd.putUL} bis \DescRef{\LabelBase.cmd.putC}. 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
@@ -871,8 +881,9 @@ derart zerstörte Ebenen ignoriert. Zerstörte Ebenen können mit
\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.
-
+\DescRef{\LabelBase.cmd.ModifyLayer} verändert werden.%
+\iffalse % Siehe Hinweis zur Interface-Schnittstelle
+\par
Die Anweisung ist dazu bestimmt, innerhalb des Arguments \PName{Code} von
\DescRef{\LabelBase.cmd.scrlayerOnAutoRemoveInterface} (siehe
\autoref{sec:scrlayer.enduserinterfaces},
@@ -880,19 +891,20 @@ Die Anweisung ist dazu bestimmt, innerhalb des Arguments \PName{Code} von
werden. Damit können Ebenen, die unter Verwendung von entfernbaren Anweisungen
einer entfernbaren Benutzerschnittstelle definiert wurden, zusammen mit dieser
Benutzerschnittstelle entfernt werden.%
+\fi%
\EndIndexGroup
\begin{Declaration}
+ \OptionVName{draft}{Ein-Aus-Wert}
\Macro{layercontentsmeasure}
\end{Declaration}
-Mit Hilfe der \KOMAScript-Option
-\DescRef{\LabelBase.option.draft}\IndexOption{draft~=\PName{Ein-Aus-Wert}}
-kann für das Paket \Package{scrlayer} ein Entwurfsmodus aktiviert werden. In
-diesem Entwurfsmodus wird hinter jeder Ebene zunächst eine Bemaßung der Ebene
-ausgegeben. Diese Bemaßung erfolgt mit \Macro{layercontentsmeasure}. Diese
-Anweisung zeigt am oberen und linken Rand der Ebene ein Maßband in Zentimeter
-und am rechten und unteren Rand der Ebene ein Maßband in Zoll. Die Anweisung
+Mit Hilfe der \KOMAScript-Option \Option{draft} kann für das Paket
+\Package{scrlayer} ein Entwurfsmodus aktiviert werden. In diesem Entwurfsmodus
+wird hinter jeder Ebene zunächst eine Bemaßung der Ebene ausgegeben. Diese
+Bemaßung erfolgt mit \Macro{layercontentsmeasure}. Diese Anweisung zeigt am
+oberen und linken Rand der Ebene ein Maßband in Zentimeter und am rechten und
+unteren Rand der Ebene ein Maßband in Zoll. Die Anweisung
\Macro{layercontentsmeasure} kann statt über die Option auch schlicht als
alleiniger \PName{Code} für die Eigenschaft \Option{contents} einer Ebene
verwendet werden.%
@@ -903,10 +915,10 @@ verwendet werden.%
\section{Deklaration und Verwaltung von Seitenstilen}
\seclabel{pagestyles}
-\BeginIndexGroup
+\BeginIndexGroup%
\BeginIndex{}{Seiten>Stil}%
Wir kennen nun Ebenen und wissen, wie diese definiert und verwaltet
-werden. Aber bisher wissen wir noch nicht, wie sie verwendet werden. Die
+werden. Aber bisher wissen wir kaum, wie sie verwendet werden. Die
möglicherweise überraschende Antwort lautet: mit Hilfe von
Seitenstilen. Üblicherweise werden Seitenstile in \LaTeX{} zur Definition von
Kopf und Fuß der Seite verwendet.
@@ -925,7 +937,7 @@ 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
+statt nur den 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.
@@ -994,7 +1006,7 @@ liefert \Macro{currentpagestyle} nicht den Alias-Namen, sondern den des
originären Seitenstils. Den\ChangedAt{v3.16}{\Package{scrlayer}} Alias-Namen
kann man in diesem Fall mit \Macro{toplevelpagestyle} erhalten. Es wird davon
abgeraten, Seitenstile zu definieren, die beispielsweise per
-\DescRef{scrbase.cmd.ifstr} abhängig von \Macro{toplevelpagestyle}
+\DescRef{scrbase.cmd.Ifstr} abhängig von \Macro{toplevelpagestyle}
unterschiedliche Ergebnisse liefern, da dies bei Aktivierung per
\DescRef{maincls.cmd.thispagestyle} zu falschen Resultaten führen kann.%
\EndIndexGroup
@@ -1082,6 +1094,7 @@ eine Fehlermeldung.
\RedeclarePageStyleAlias{chapter}{empty}
\end{lstcode}%
\end{Example}%
+\ExampleEndFix%
\fi
\EndIndexGroup
@@ -1095,14 +1108,16 @@ 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 \DescRef{\LabelBase.cmd.DeclareNewPageStyleAlias} oder
-\DescRef{\LabelBase.cmd.ProvidePageStyleAlias} neu definiert werden.
-
+\DescRef{\LabelBase.cmd.ProvidePageStyleAlias} neu definiert werden.%
+\iffalse % Siehe Hinweis zur Interface-Schnittstelle
+\par
Die Anweisung ist dazu bestimmt, innerhalb des Arguments \PName{Code} von
\DescRef{\LabelBase.cmd.scrlayerOnAutoRemoveInterface} (siehe
\autoref{sec:scrlayer.enduserinterfaces},
\DescPageRef{scrlayer.cmd.scrlayerOnAutoRemoveInterface}) verwendet zu
werden, um Seitenstile, die als Teil eines Endanwender-Interfaces definiert
wurden, beim automatischen Entfernen dieses Interfaces mit zu entfernen.%
+\fi%
\EndIndexGroup
@@ -1143,7 +1158,7 @@ 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
+ebenfalls akzeptiert, ihre Verwendung wird jedoch nur erfahrenen Anwendern
empfohlen.
Die \PName{Optionenliste} ist eine mit Komma separierte Liste von Optionen der
@@ -1153,7 +1168,11 @@ 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.
+ihrer Bedeutung sind \autoref{tab:scrlayer.pagestyle.hooks} zu entnehmen. Es
+ist zu beachten, dass die Haken auch für den nachfolgend erklärten
+Pseudo-Seitenstil
+\DescRef{\LabelBase.pagestyle.@everystyle@}\IndexPagestyle{@everystyle@}%
+\important{\DescRef{\LabelBase.pagestyle.@everystyle@}} ausgeführt werden.
\begin{desclist}
\desccaption{%
@@ -1164,7 +1183,7 @@ ihrer Bedeutung sind \autoref{tab:scrlayer.pagestyle.hooks} zu entnehmen.
}%
\entry{\OptionVName{onselect}{Code}}{%
Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt,
- wenn der Seitenstil beispielsweise mit \DescRef{maincls.cmd.pagestyle}
+ 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
@@ -1273,10 +1292,12 @@ er wie bei \Macro{DeclarePageStyleByLayers} definiert.
Die Anweisung \Macro{RedeclarePageStyleByLayers} wiederum erwartet, dass
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.
-
+Seitenstil des angegebenen Namens, so resultiert daraus eine Fehlermeldung.%
+\iffalse % Umbruchkorrektur
+\par
Beachten Sie des Weiteren die nachfolgenden Anmerkungen zum Pseudo-Seitenstil
\PageStyle{@everystyle@}.%
+\fi%
\EndIndexGroup
@@ -1312,11 +1333,13 @@ 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\Index{Haken} und Ebenen des Pseudo-Seitenstils \PageStyle{@everystyle@}
-ausführt.%
+ohne Ebenen um. \iffalse % Umbruchkorrektur
+Nichtsdestotrotz kann er wie jeder andere Ebenen-Seitenstil verwendet
+werden. %
+\fi%
+Der Hauptvorteil dieses Ebenen-Seitenstils gegenüber dem 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
@@ -1336,7 +1359,7 @@ ausführt.%
\BeginIndex{}{Ebenen>Seitenstil}%
Für jeden der Haken\Index{Haken} aus \autoref{tab:scrlayer.pagestyle.hooks}
existiert außerdem eine \KOMAScript-Option%
-\iftrue%
+\iffalse%
. 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%
@@ -1356,8 +1379,8 @@ später in diesem Abschnitt erklärt wird, entfernt werden.%
\OptionVName{singlespacing}{Ein-Aus-Wert}
\end{Declaration}
Wird\ChangedAt{v3.24}{\Package{scrlayer}\and \Package{scrlayer-scrpage}} ein
-Dokument beispielsweise mit Hilfe von Paket
-\Package{setspace}\IndexPackage{setspace}\important{\Package{setspace}} mit
+Dokument, beispielsweise mit Hilfe von Paket
+\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
@@ -1451,7 +1474,10 @@ 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}
+Werden\textnote{unbekannte Ebenen} nicht existente Ebenen zu einem Seitenstil
+hinzugefügt, werden diese bei der Anwendung des Stils ignoriert.
+
+\iffalse% Umbruchkorrekturtext (beim Aktiveren muss unten \textnote{entfernen}
% entfernt werden!)
Die Anweisung \Macro{RemoveLayersFromPageStyle} dient dem genauen
Gegenteil. Sie entfernt\textnote{entfernen} die angegebenen Ebenen von
@@ -1548,7 +1574,7 @@ 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
+ erweitern} überschreibt dagegen 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.%
\EndIndexGroup
@@ -1599,7 +1625,7 @@ aus, wenn dieser Alias-Seitenstil zu einem Ebenen-Seitenstil führt.%
\BeginIndex{}{Ebenen>Seitenstil}%
Mit diesen Anweisungen kann überprüft werden, ob ein oder mehrere Ebenen
Bestandteil eines Seitenstils sind. \Macro{IfLayerAtPageStyle} erwartet dabei
-nach dem \PName{Seitenstil-Name} im ersten Argument im zweiten Argument
+den \PName{Seitenstil-Name} im ersten Argument und 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}.
@@ -1626,7 +1652,7 @@ so sind alle drei Anweisungen gleichbedeutend.%
\end{Declaration}
\BeginIndex{}{Seitenstil>Ebenen-}%
\BeginIndex{}{Ebenen>Seitenstil}%
-\iftrue%
+\iffalse% Umbruchkorrektur
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
@@ -1654,14 +1680,16 @@ möchten, so können Sie dies beispielsweise mit
\begin{lstcode}
\ForEachLayerOfPageStyle{...}{\DestroyLayer{#1}}
\end{lstcode}
-vor der Vernichtung des Seitenstils selbst erreichen.
-
+vor der Vernichtung des Seitenstils selbst erreichen.%
+\iffalse % Siehe Hinweis zur Interface-Schnittstelle
+\par
Die Anweisung ist dazu bestimmt, innerhalb des Arguments \PName{Code} von
\DescRef{\LabelBase.cmd.scrlayerOnAutoRemoveInterface} (siehe
\autoref{sec:scrlayer.enduserinterfaces},
\DescPageRef{scrlayer.cmd.scrlayerOnAutoRemoveInterface}) verwendet zu
werden, um Seitenstile, die als Teil eines Endanwender-Interfaces definiert
wurden, beim automatischen Entfernen dieses Interfaces mit zu entfernen.%
+\fi %
\EndIndexGroup
\EndIndexGroup
@@ -1672,6 +1700,23 @@ wurden, beim automatischen Entfernen dieses Interfaces mit zu entfernen.%
\section{Definition und Verwaltung von Schnittstellen für Endanwender}
\seclabel{enduserinterfaces}
+\iftrue% Der komplette Mechanismus ist überholt und sollte nicht mehr
+ % verwendet werden. Daher wird die Doku dazu deaktiviert.
+%\begin{sloppypar}
+Bis Version 3.27\ChangedAt{v3.28}{\Package{scrlayer}} stellte das Paket
+\Package{scrlayer} noch einen als experimentell dokumentierten Mechanismus zur
+Verwaltung konkurrierender Benutzerschnittstellen zur Verfügung. Da der Nutzen
+dieses lediglich von \KOMAScript{} selbst eingesetzten Mechanismus sehr
+begrenzt war, ist er inzwischen als überholt gekennzeichnet. Die Befehle
+\Macro{scrlayerInitInterface}\IndexCmd{scrlayerInitInterface},
+\Macro{scrlayerOnAutoRemoveInterface}\IndexCmd{scrlayerOnAutoRemoveInterface},
+\Macro{scrlayerAddToInterface}\IndexCmd{scrlayerAddToInterface} und
+\Macro{scrlayerAddCsToInterface}\IndexCmd{scrlayerAddCsToInterface} und die
+Optionen \Option{forceoverwrite}\IndexOption{forceoverwrite} und
+\Option{autoremoveinterfaces}\IndexOption{autoremoveinterfaces} sollten daher
+nicht mehr verwendet werden.%
+%\end{sloppypar}%
+\else%
Das Paket \Package{scrlayer} stellt eine experimentelle Benutzerschnittstelle
zur Verfügung um (konkurrierende) Schnittstellen für Endanwender definieren
und verwalten zu können. \iffree{% Umbruchvarianten
@@ -1791,7 +1836,8 @@ vernichten (siehe \DescRef{\LabelBase.cmd.DestroyLayer},
Endanwender-Schnittstelle beruhen. Bezüglich der Voreinstellung für das
optionale Argument sei auf die Erklärung zu
\DescRef{\LabelBase.cmd.scrlayerInitInterface} verwiesen.%
-\EndIndexGroup
+\EndIndexGroup%
+\fi%
%
\EndIndexGroup