% \CheckSum{3307}
% \iffalse^^A meta-comment
% ======================================================================
% scrlayer.dtx
% Copyright (c) Markus Kohm, 2012-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
% This work may be distributed and/or modified under the conditions of
% the LaTeX Project Public License, version 1.3c of the license.
% The latest version of this license is in
% http://www.latex-project.org/lppl.txt
% and version 1.3c or later is part of all distributions of LaTeX
% version 2005/12/01 and of this work.
%
% This work has the LPPL maintenance status "author-maintained".
%
% The Current Maintainer and author of this work is Markus Kohm.
%
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer.dtx
% Copyright (c) Markus Kohm, 2012-2013
%
% Diese Datei ist Teil der LaTeX2e KOMA-Script-Sammlung.
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c.
% Die neuste Version dieser Lizenz ist
% http://www.latex-project.org/lppl.txt
% und Version 1.3c ist Teil aller Verteilungen von LaTeX
% Version 2005/12/01 und dieses Werks.
%
% Dieses Werk hat den LPPL-Verwaltungs-Status "author-maintained"
% (allein durch den Autor verwaltet).
%
% Der Aktuelle Verwalter und Autor dieses Werkes ist Markus Kohm.
%
% Dieses Werk besteht aus den in manifest.txt aufgefuehrten Dateien.
% ======================================================================
% \fi^^A meta-comment
%
% \CharacterTable
% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
% Digits \0\1\2\3\4\5\6\7\8\9
% Exclamation \! Double quote \" Hash (number) \#
% Dollar \$ Percent \% Ampersand \&
% Acute accent \' Left paren \( Right paren \)
% Asterisk \* Plus \+ Comma \,
% Minus \- Point \. Solidus \/
% Colon \: Semicolon \; Less than \<
% Equals \= Greater than \> Question mark \?
% Commercial at \@ Left bracket \[ Backslash \\
% Right bracket \] Circumflex \^ Underscore \_
% Grave accent \` Left brace \{ Vertical bar \|
% Right brace \} Tilde \~}
%
% \iffalse^^A meta-comment
%%%% From File: $Id: scrlayer.dtx 1480 2013-10-31 10:00:02Z mjk $ (identify)
%%%% From File: $Id: scrlayer.dtx 1480 2013-10-31 10:00:02Z mjk $ (init)
%%%% From File: $Id: scrlayer.dtx 1480 2013-10-31 10:00:02Z mjk $ (options)
%%%% From File: $Id: scrlayer.dtx 1480 2013-10-31 10:00:02Z mjk $ (body)
%%%% From File: $Id: scrlayer.dtx 1480 2013-10-31 10:00:02Z mjk $ (final)
%<*dtx>
\ifx\ProvidesFile\undefined\def\ProvidesFile#1[#2]{}\fi
\begingroup
\def\filedate$#1: #2-#3-#4 #5${\gdef\filedate{#4/#3/#2}}
\filedate$Date: 2013-10-31 11:00:02 +0100 (Do, 31. Okt 2013) $
\def\filerevision$#1: #2 ${\gdef\filerevision{v0.9.#2}}
\filerevision$Revision: 1480 $
\endgroup
\ProvidesFile{scrlayer.dtx}[\filedate\space\filerevision\space
%
%<*identify|doc>
%\NeedsTeXFormat{LaTeX2e}[1995/12/01]
%\ProvidesPackage{scrlayer}[%
%\ProvidesFile{scrlayer.tex}[%
% Sometimes following will be replaced by !KOMASCRIPTVERSION:
%!SCRLAYERVERSION
% package
%
%<*dtx|identify|doc>
(defining layers and page styles)]
%
%<*dtx>
\ifx\documentclass\undefined
\input scrdocstrip.tex
\@@input scrkernel-version.dtx
\@@input scrstrip.inc
\KOMAdefVariable{COPYRIGHTFROM}{2012}
\KOMAdefVariable{SCRLAYERVERSION}{\space\space\filedate\space\filerevision}%
\generate{\usepreamble\defaultpreamble
\file{scrlayer.sty}{%
\from{scrlayer.dtx}{package,trace,scrlayer,identify}%
\from{scrlayer.dtx}{package,trace,scrlayer,init}%
\from{scrlayer.dtx}{package,trace,scrlayer,options}%
\from{scrlayer.dtx}{package,trace,scrlayer,body}%
\from{scrlayer.dtx}{package,trace,scrlayer,final}%
\from{scrlogo.dtx}{logo}%
}%
}
\batchinput{scrlayer-scrpage.dtx}
\batchinput{scrlayer-notecolumn.dtx}
\@@input scrstrop.inc
\else
\let\endbatchfile\relax
\fi
\endbatchfile
%
%<*driver>
\documentclass{scrdoc}
\addtolength{\textwidth}{-1em}
\addtolength{\marginparwidth}{2em}
\addtolength{\oddsidemargin}{2em}
\usepackage[ngerman,english]{babel}
\usepackage{url,babelbib}\bibliographystyle{babalpha-fl}
\usepackage{listings}
\usepackage{scrhack}
\usepackage{etoolbox}
\pretocmd\DescribeMacro{\ifhmode\else\bigskip\noindent\fi}{}{}
\pretocmd\DescribeEnv{\ifhmode\else\bigskip\noindent\fi}{}{}
\pretocmd\DescribeOption{\ifhmode\else\bigskip\noindent\fi}{}{}
\CodelineIndex
\RecordChanges
\GetFileInfo{scrlayer.dtx}
\title{The \KOMAScript{} package \texttt{scrlayer}%
\footnote{This is version \fileversion\ of file \texttt{\filename}.}}
\date{\filedate}
\author{Markus Kohm}
\newenvironment{Explain}{\par}{\par}
\newcommand*{\length}{}
\let\length\Length
\let\endlength\endLength
\let\Macro\cs
\let\Length\Macro
\let\Package\textsf
\let\Class\Package
\let\File\texttt
\let\Option\texttt
\newcommand*{\KOption}[1]{\Option{#1}\texttt{=}}
\newcommand*{\OptionValue}[2]{\Option{#1}\texttt{=}\PValue{#2}}
\let\Counter\texttt
\let\Environment\texttt
\let\ShowOutput\quote
\let\endShowOutput\endquote
\let\Pagestyle\texttt
\newcommand*{\Parameter}[1]{\texttt{\marg{#1}}\linebreak[1]}
\newcommand*{\OParameter}[1]{\texttt{\oarg{#1}}\linebreak[1]}
\newcommand*{\MParameter}[2]{\texttt{(\meta{#1},\meta{#2})}\linebreak[1]}
\providecommand\PParameter[1]{\mbox{\texttt{\{#1\}}}\linebreak[1]}
\let\PName\meta
\let\PValue\texttt
\providecommand*{\autoref}[1]{\expandafter\AUTOREF#1:}
\providecommand*{\AUTOREF}{}
\makeatletter
\def\AUTOREF#1:#2:{%
\edef\@tempa{#1}%
\edef\@tempb{tab}\ifx\@tempa\@tempb table~\fi
\edef\@tempb{sec}\ifx\@tempa\@tempb section~\fi
\ref{#1:#2}%
}
\providecommand*{\IndexCmd}[2][]{}
\providecommand*{\textnote}[2][]{}
\providecommand*\eTeX{\leavevmode\hbox{$\varepsilon$}-\TeX}
\providecommand*\NTS{%
\leavevmode\hbox{$\cal N\kern-0.35em\lower0.5ex\hbox{$\cal T$}%
\kern-0.2emS$}}
\lstnewenvironment{lstcode}{\lstset{language=[LaTeX]TeX}}{}
\makeatother
\sloppy% YOU SHOULD NOT DO THIS!!!
\begin{document}
\maketitle
\DocInput{\filename}
\DocInput{scrlayer-scrpage.dtx}
\DocInput{scrlayer-notecolumn.dtx}
\bibliography{guide}
\PrintChanges
\PrintIndex
\end{document}
%
% \fi^^A meta-comment
%
% \selectlanguage{english}
%
% \changes{v0.0}{2012/01/01}{Start of new package}
%
%\iffalse^^A meta comment
%<*dtx|doc>
\chapter[{Defining Layers and Page Styles Using \Package{scrlayer}}]%
{Defining Layers and Page Styles Using \Package{scrlayer}%
%\footnote{This chapter has been generated from \File{scrlayer.dtx}.}%
}
\labelbase{scrlayer}
\BeginIndex{Package}{scrlayer}
%\fi^^A meta comment
% \begin{abstract}
\LaTeX{} itself doesn't know layers, but there are already packages
like \Package{eso-pic} or \Package{textpos}, that provide a kind of
background or foreground layer. \Package{scrlayer} is another package,
that provides such background and foreground layers, but in difference
to the other packages mentioned above these layers are part of the
page style definition. With this you may simply switch between usage
of layers by switching the page style.
To do so, the package also supports a low level interface to define page
styles using a layer stack, to put layers onto a page style's layer stack, to
put layers at the lowest position of a page style's layer stack, to put layers
before or after a layer of a page style's layer stack, to remove a layer from
a page style's layer stack and to remove doublets of layers of a page style's
layer stack. In short words: The page style interface of \Package{scrlayer}
provides commands to define layer-stack-based page styles and to manage those
layer stacks.
Nevertheless using the layers directly is recommended for advanced users only.
End user interfaces for beginners or average users are provided by additional
packages, that load \Package{scrlayer} on their own.
% \end{abstract}
%
% \tableofcontents
%
\section{State of Development Note}
\label{sec:scrlayer.draft}
Development of this package hasn't been finished yet. Because of this,
especially internal functionality may be changed in future. Most likely the
package will be extended. And because of the early state of development, you
should not expect any user documentation. In fact there's at least only some
developers documentation needed by the main developer himself.
%\iffalse^^A meta-comment
\EndIndex{Package}{scrlayer}
%\fi^^A meta-comment
\section{Early or Late Selection of Options}
\label{sec:scrlayer.options}
Package \Package{scrlayer} uses the option interface of \KOMAScript. Therefore
you may set options either within the optional argument of
\Macro{documentclass} as global options, or within the optional argument of
\Macro{usepackage} as local options, or with \Macro{KOMAoptions} or
\Macro{KOMAoption} as \KOMAScript{} option. Several of these options expect a
value. See the \KOMAScript{} manual, \File{scrguide.pdf}, for more information
about this.
\section{Some Generic Information}
\label{sec:scrlayer.generic}
The package needs some generic information about the class. Class authors may
help \Package{scrlayer} setting this information. Otherwise the package tries
to detect the information itself. This works, e.g., for the standard classes
and the \KOMAScript{} classes. But it may or may not fail with other classes.
This section describes some of the information, that class authors may
provide. Generally users need not to care about this.
%\iffalse^^A meta-comment
\begin{Declaration}
\Macro{if@chapter}\ \PName{then code} \Macro{else}\ \PName{else code} \Macro{fi}%
\end{Declaration}
\BeginIndex{Cmd}{if@chapter}%
%\fi^^A meta-comment
% \DescribeMacro{\if@chapter}
If \Macro{if@chapter} is defined and \Macro{iftrue}, \Package{scrlayer} will
work including the chapter level, e.g., at option \Option{automark}. If it is
defined, but not \Macro{iftrue}, it only handles part, section, subsection,
sub\dots subsection, paragraph, subparagraph, sub\dots subparagraph. If the
macro isn't defined, \Package{scrlayer} searches for \Macro{chapter}. If
\Macro{chapter} is defined and not \Macro{relax}, \Package{scrlayer} will
define \Macro{if@chapter} to \Macro{iftrue}, otherwise \Macro{if@chapter} will
become \Macro{iffalse}.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{if@chapter}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
\Macro{if@mainmatter}\ \PName{then code} \Macro{else}\ \PName{else code} \Macro{fi}%
\end{Declaration}
\BeginIndex{Cmd}{if@mainmatter}%
%\fi^^A meta-comment
% \DescribeMacro{\if@mainmatter}
Classes like \Class{book} define \Macro{frontmatter}, \Macro{mainmatter}, and
\Macro{backmatter}. They also use \Macro{if@mainmatter} to distinguish whether
or the current matter is the main matter. Classes like \Class{report} and
\Class{article} don't have \Macro{frontmatter}, \Macro{mainmatter}, or
\Macro{backmatter} and therefore also don't have \Macro{if@mainmatter}.
For \Package{scrlayer} it's easier not to test always for the existence of the
matter commands, but to have \Macro{if@mainmatter} even with classes like
\Class{report} and \Class{article}, simply set to \Macro{iftrue}. So if
\Macro{if@mainmatter} is not defined, it will be defined to \Macro{iftrue}.
Some classes have \Macro{frontmatter}, \Macro{mainmatter}, or
\Macro{backmatter} but not \Macro{if@mainmatter}. In this case
\Package{scrlayer} will also define \Macro{if@mainmatter} to be \Macro{iftrue}
and it'll extend definition of \Macro{frontmatter}, \Macro{mainmatter}, and
\Macro{backmatter} to set \Macro{if@mainmatter} properly. Other matter
commands are not known, not tested, and not extended. So if there other matter
commands \Package{scrlayer} needs help of the class author to get
\Macro{if@mainmatter} set correctly.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{if@mainmatter}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\DeclareSectionNumberDepth}
% The command
\Macro{DeclareSectionNumberDepth}%^^A
\Parameter{level name}\Parameter{level depth}
% maps
%\iffalse^^A meta-comment
\end{Declaration}
\BeginIndex{Cmd}{DeclareSectionNumberDepth}%
With this command you may map
%\fi^^A meta-comment
the name of a heading level to a section numbering depth. With standard class
book, e.g., the \PName{level name} could be \PValue{part}, \PValue{chapter},
\PValue{section}, \PValue{subsection}, \PValue{subsubsection},
\PValue{paragraph}, or \PValue{subparagraph} and the corresponding
\PName{level depth}s would be -1, 0, 1, 2, 3, 4, and 5. Package
\Package{scrlayer} tries to determine the levels on it's own while loading
and while \Macro{begin}\PParameter{document}. But, if it fails, you may set it
on yourself using this command.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{DeclareSectionNumberDepth}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\footheight}
%\iffalse^^A meta-comment
\Length{footheight}%
\end{Declaration}
\BeginIndex{Length}{footheight}%
%\fi^^A meta-comment
While \LaTeX{} already provides \Length{headheight} to set up the height of
the page head, it doesn't provide a corresponding length for the page
footer. Nevertheless \Package{scrlayer} needs this in several cases. So if
\Length{footheight} doesn't already exist, \Package{scrlayer} will define
it and initialise it to -12345\,sp. If it's value is still this magic value
while \Macro{begin}\PParameter{document}, it will be set to
\Length{baselineskip} then.
%\iffalse^^A meta-comment
\EndIndex{Length}{footheight}
%\fi^^A meta-comment
\section{Declaration of Layers}
\label{sec:scrlayer.layers}
A layer is a kind of logical sheet of transparent paper (in opposite to a
physical sheet of paper). One layer is stacked onto another layer and opaque
material on one layer may hide material on the layers below. The stack of all
layers together makes the physical page. Package \Package{scrlayer}
provides two such layer stacks for each page: a background layer stack and a
foreground layer stack. The background layer stack is behind the normal page
contents, the foreground layer stack is above the normal page contents. So the
normal contents is a kind of a separating layer.
A layer has several attributes. The first attribute is, whether or not
the layer is part of the foreground or the background. Background
layers will be printed before the main contents of the page. Optically
they will be behind the main contents. Foreground layers will be
printed after the main contents of the page. Optically they will be in
front of the main contents. By default, a layer is both, a background
layer \emph{and} a foreground layer and therefore will be printed
twice.
The second and third attributes are the horizontal and vertical position of
the layer. The forth and fifth attributes are the horizontal and vertical size
of the layer. As you can see, a layer may be smaller or larger than the
paper.
But how are the horizontal an vertical positions measured? The answer
is the sixth attribute, the alignment. We can measure from the left edge of
the paper to the left edge of the layer, or from the left edge of the paper to
the middle of the layer, or from the left edge of the paper to the right edge
of the layer. We can measure from the top edge of the paper to the top edge of
the layer, or to the middle of the layer, or to the bottom edge of the layer.
The seventh and eights attributes are, whether or not a layer should be
printed onto left or right pages. By default a layer will be printed at both,
left and right pages. Note, that \LaTeX{} names left pages as even pages and
right pages as odd pages and that there are no left or even pages in
single-sided mode.
The ninth and tenth attributes are, whether or not a layer should be printed in
single-side mode or in two-side mode. By default a layer will be printed in
both, single-side mode and two-side mode. Nevertheless an even page layer will
never be printed in single-side mode and therefore isn't really a two-side
mode layer.
The eleventh and twelveth attributes are, whether or not a layer should be
printed onto float pages or non-float pages. \LaTeX{} produces float pages for
float environment like tables or figures, if they are allowed to be printed on
a page without normal page contents (see option \PValue{p} for
\Environment{figure} or \Environment{table}). Non-float pages aren't pages
without floats, but pages, that aren't float pages. They may contain floats
inside the text, on the top of the page, or on the bottom of the page. Very
large floats may seem to be page floats, while in reality they are top floats.
The thirteenth and last attribute is the contents of the layer. This is simply,
what should be printed, whenever the layer will be printed.
So we have thirteen attributes yet. Below in this manual we will see additional
attributes, that may be build by these twelve attribute. Because of this, we
call these twelve attributes the primary attributes.
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\DeclareLayer}
% \DescribeMacro{\DeclareNewLayer}
% \DescribeMacro{\ProvideLayer}
% \DescribeMacro{\RedeclareLayer}
% \DescribeMacro{\ModifyLayer}
% The command:
\Macro{DeclareLayer}\OParameter{option list}\Parameter{layer name}
%\iffalse^^A meta-comment
\\\Macro{DeclareNewLayer}\OParameter{option list}\Parameter{layer name}
\\\Macro{ProvideLayer}\OParameter{option list}\Parameter{layer name}
\\\Macro{RedeclareLayer}\OParameter{option list}\Parameter{layer name}
\\\Macro{ModifyLayer}\OParameter{option list}\Parameter{layer name}
\end{Declaration}
\BeginIndex{Cmd}{DeclareLayer}%
\BeginIndex{Cmd}{DeclareNewLayer}%
\BeginIndex{Cmd}{ProvideLayer}%
\BeginIndex{Cmd}{RedeclareLayer}%
\BeginIndex{Cmd}{ModifyLayer}%
Command \Macro{DeclareLayer}
%\fi^^A meta-comment
declares or defines a layer with the name \PName{layer name}. It doesn't care
whether or not a layer with this name already exists. Argument \PName{layer
name} must be fully expandable and the expansion has to result in
letters. Some other characters will be tolerated, but only letters are
recommended.
The \PName{option list} is a comma separated list of \PName{option}s. An
\PName{option} may be either a \PName{key} or a \PName{key} followed be an
equal sign followed by a \PName{value}. We call this a
\OptionValue{\PName{key}}{\PName{value}} option. Each \PName{key} is the
representation of a layer attribute. See \autoref{tab:scrlayer.layerkeys} for
more information about the names of the \PName{key}s and the corresponding
attributes.
\begin{center}
\captionaboveof{table}{The \PName{key}s representing a layer attribute}%
\label{tab:scrlayer.layerkeys}%
\begin{description}
\item[\OptionValue{align}{\PName{alignment character}s} --] a description
of the wanted alignment. Each \PName{alignment character} influences
either, how the \PName{length} of \Option{hoffset} or \Option{voffset}
will be used. Several \PName{alignment character}s may be used together
(without comma or space). No macros should be used here! Valid
\PName{alignment character}s are:
\begin{description}
\item[\PValue{b} --] align the layer with its bottom edge to the given
\Option{length} of \Option{voffset} from the top edge of the paper.
\item[\PValue{c} --] align the layer with its centre to the given
\PValue{length} of \Option{hoffset} from the left edge and of
\Option{voffset} from the top edge of the paper.
\item[\PValue{l} --] align the layer with its left edge to the given
\PValue{length} of \Option{hoffset} from the left edge of the paper.
\item[\PValue{r} --] align the layer with its right edge to the given
\PValue{length} of \Option{hoffset} from the left edge of the paper.
\item[\PValue{t} --] align the layer with its top edge to the given
\Option{length} of \Option{voffset} from the top edge of the paper.
\end{description}
\item[\OptionValue{area}{%^^A
\Parameter{hoffset}\Parameter{voffset}%^^A
\Parameter{width}\Parameter{height}} --] composing option, that results
in \OptionValue{hoffset}{\PName{hoffset}},
\OptionValue{voffset}{\PName{voffset}},
\OptionValue{width}{\PName{width}}, \OptionValue{height}{\PName{height}}.
\item[\Option{background} --] print the layer only in the background, but not
in the foreground. This makes a background-only layer in opposite to the
default of layers which are both, background and foreground layers. The
option doesn't expect any value. By the default the attribute is not set.
\item[\Option{bottommargin} --] composing option, that sets
\Option{hoffset}, \Option{voffset}, \Option{width}, \Option{height}, and
\Option{align} to horizontally span the paper from the left edge to the
right and vertically span the area below the footer down to the bottom
edge of the paper.
\item[\OptionValue{clone}{\PName{layer name}} --] composing option, that
sets all primary attributes of the layer to the same values as the primary
attributes of the layer with the given \PName{layer name}. Note, that
\PName{layer name} has to be fully expandable and should expand to letters
only. Some additional characters will be tolerated, but they are not
recommended!
\item[\OptionValue{contents}{\PName{code}} --] the \PName{code} will be
expanded whenever the layer is printed. So the \PName{code} is what you
will see. No checks for valid code will be done. So errors in \PName{code}
may result in several failures on each page, that prints the layer.
\item[\Option{evenpage} --] print the layer on even pages only, but not on
odd pages. The option doesn't expect any value. By the default the
attribute is not set. Note, that this attribute includes \Option{twoside}.
\item[\Option{floatpage} --] print the layer on float pages only, but not on
other pages. The option doesn't expect any value. By the default the
attribute is not set.
\item[\Option{foot} --] composing option, that sets \Option{hoffset},
\Option{voffset}, \Option{width}, \Option{height}, and \Option{align} to
horizontally span the text area and vertically span the page footer
defined by the new \LaTeX{} length \Length{footheight}.
\item[\Option{footskip} --] composing option, that sets \Option{hoffset},
\Option{voffset}, \Option{width}, \Option{height}, and \Option{align} to
horizontally span the text area and vertically span the distance between
the text area and the page footer (note, that this is not the same like
\Length{footskip}).
\item[\Option{foreground} --] print the layer only in the foreground, but not
in the background. This makes a foreground-only layer in opposite to the
default of layers which are both, background and foreground layers. The
option doesn't expect any value. By the default the attribute is not set.
\item[\Option{head} --] composing option, that sets \Option{hoffset},
\Option{voffset}, \Option{width}, \Option{height}, and \Option{align} to
horizontally span the text area and vertically span the page head defined
by usual\LaTeX{} length \Length{headheight}.
\item[\Option{headsep} --] composing option, that sets \Option{hoffset},
\Option{voffset}, \Option{width}, \Option{height}, and \Option{align} to
horizontally span the text area and vertically span the distance between
the page head and the text area.
\item[\OptionValue{height}{\PName{length}} --] the height of the
layer. Note, that \PName{length} may either a \LaTeX{} length, declared
using \Macro{newlength}, or a \TeX{} length, declared using
\Macro{newdimen} or \Macro{newskip}, a length value like 10\,pt, or a
dimensional expression using +, -, /, *, (, and ). For more information
about valid dimensional expression see \cite[section~3.5]{manual:eTeX}.
\item[\OptionValue{hoffset}{\PName{length}} --] the offset of the layer
(depending on \Option{align} either left edge of the layer, middle of the
layer or right edge of the layer) from the left edge of the paper. See
\Option{height} for more information about valid content of
\PName{length}.
\item[\Option{innermargin} --] composing option, that sets \Option{hoffset},
\Option{voffset}, \Option{width}, \Option{height}, and \Option{align} to
horizontally span the distance between the right edge of text area and the
right edge of the paper on even pages or the distance between the left
edge of the paper and the left edge of the text area on odd pages and
vertically span the whole paper from the top edge to the bottom edge.
\item[\Option{leftmargin} --] composing option, that sets \Option{hoffset},
\Option{voffset}, \Option{width}, \Option{height}, and \Option{align} to
horizontally span the distance between the left edge of the paper and the
left edge of the text area and vertically span the whole paper from the
top edge to the bottom edge.
\item[\Option{nonfloatpage} --] don't print the layer on float pages, but on
other pages only. The option doesn't expect any value. By the default the
attribute is not set.
\item[\Option{oddpage} --] print the layer on odd pages only, but not on even
pages. The option doesn't expect any value. By the default the attribute
is not set.
\item[\Option{oneside} --] print the layer in single-side mode only, but not
in two-side mode. The option doesn't expect any value. By the default the
attribute is not set.
\item[\Option{outermargin} --] composing option, that sets \Option{hoffset},
\Option{voffset}, \Option{width}, \Option{height}, and \Option{align} to
horizontally span the distance between the left edge of the paper and the
left edge of the text area on even pages or the distance between the right
edge of the text area and the right edge of the paper on odd pages and
vertically span the whole paper from the top edge to the bottom edge.
\item[\Option{page} --] composing option, that sets \Option{hoffset},
\Option{voffset}, \Option{width}, \Option{height}, and \Option{align} to
horizontally and vertically span the whole paper from the left edge to the
right edge and the top edge to the bottom edge.
\item[\Option{rightmargin} --] composing option, that sets \Option{hoffset},
\Option{voffset}, \Option{width}, \Option{height}, and \Option{align} to
horizontally span the distance between the right edge of text area and the
right edge of the paper and vertically span the whole paper from the top
edge to the bottom edge.
\item[\Option{textarea} --] composing option, that sets \Option{hoffset},
\Option{voffset}, \Option{width}, \Option{height}, and \Option{align} to
horizontally and vertically span the whole text area from the left edge to
the right edge and the top edge to the bottom edge.
\item[\Option{topmargin} --] composing option, that sets \Option{hoffset},
\Option{voffset}, \Option{width}, \Option{height}, and \Option{align} to
horizontally span the whole page from the left edge to the right edge and
vertically span the distance between the top edge of the paper and the
page head.
\item[\Option{twoside} --] print the layer in two-side mode only, but not in
single-side mode. The option doesn't expect any value. By the default the
attribute is not set.
\item[\OptionValue{voffset}{\PName{length}} --] the offset of the layer
(depending on \Option{align} either top edge of the layer, middle of the
layer or bottom edge of the layer) from the top edge of the paper. See
\Option{height} for more information about valid content of
\PName{length}.
\item[\OptionValue{width}{\PName{length}} --] the width of the layer. See
\Option{height} for more information about valid content of
\PName{length}.
\end{description}
\end{center}
The difference between \Macro{DeclareLayer} and \Macro{DeclareNewLayer} is,
that using \Macro{DeclareNewLayer} would result in an error, if a layer with
the same \PName{layer name} already exists. So you may prevent yourself using
the same \PName{layer name} twice by mistake.
The difference between \Macro{DeclareLayer} and \Macro{ProvideLayer} is, that
using \Macro{ProvideLayer} would be simply ignored, if a layer with the same
\PName{layer name} already exists. So it is something like: \emph{declare the
layer only, if is hasn't been declared already.}
The difference between \Macro{DeclareLayer} and \Macro{RedeclareLayer} is,
that using \Macro{RedeclareLayer} would result in an error, if a layer with
the same \PName{layer name} doesn't exist already. So it may not be used to
define a new layer.
The difference between \Macro{RedeclareLayer} and \Macro{ModifyLayer} is, that
\Macro{RedeclareLayer} resets the layer to the default, before declaring it
new. \Macro{ModifyLayer} doesn't reset it, so only the attributes, set by the
\PName{option list} will be changed.
%
%\iffalse^^A meta-comment
\EndIndex{Cmd}{ModifyLayer}%
\EndIndex{Cmd}{RedeclareLayer}%
\EndIndex{Cmd}{ProvideLayer}%
\EndIndex{Cmd}{DeclareNewLayer}%
\EndIndex{Cmd}{DeclareLayer}%
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\IfLayerExists}
% The command
\Macro{IfLayerExists}%^^A
\Parameter{string}\Parameter{then-code}\Parameter{else-code}
%\iffalse^^A meta-comment
\end{Declaration}
\BeginIndex{Cmd}{IfLayerExists}%
This command
%\fi^^A meta-comment
may be used to execute code depending on whether or not a layer has been
defined already. If the layer exists \PName{then-code} will be executed,
otherwise \PName{else-code}. Note, that the command cannot really test whether
a layer exists. It uses a heuristic, that will never be false negative, but
may be false positive. Nevertheless, if it is false positive something went
wrong, either an incompatible package has been used or the user made something
he shouldn't do.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{IfLayerExists}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\DestroyLayer}
% The command
\Macro{DestroyLayer}%^^A
\Parameter{layer name}
%\iffalse^^A meta-comment
\end{Declaration}
\BeginIndex{Cmd}{DestroyLayer}%
This command
%\fi^^A meta-comment
sets all macros corresponding with the layer with given \PName{layer name} to
\Macro{relax}, if a layer with that name exists. After this the layer may not
be used any longer. But it doesn't matter, if the layer is still part of the
layer list of a page style, because such destroyed layers will be
ignored. Nevertheless destroyed layers may be defined new using
\Macro{DeclareNewLayer} or \Macro{ProvideLayer}, but couldn't be changed using
\Macro{RedeclareLayer} or \Macro{ModifyLayer} any longer. The command is
intended to be used inside \Macro{scrlayerOnAutoRemoveInterface} to remove
layers, that have been defined by an interface using removable macros of that
interface.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{DestroyLayer}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% The command
% \DescribeMacro{\layercontentsmeasure}
% \DescribeOption{draft}
\Macro{layercontentsmeasure}%
%\iffalse^^A meta-comment
\\\KOption{draft}{\PName{simple switch}}%
\end{Declaration}
\BeginIndex{Option}{draft~=\PName{simple switch}}
\BeginIndex{Cmd}{layercontentsmeasure}%
The command \Macro{layercontentsmeasure}
%\fi^^A meta-comment
is internally used, if option \Option{draft} has been set, so visualise
the layers. The visualisation will be done with a centimetre ruler at the top
and left edge of the layer and an inch ruler at the bottom and right edge of
the layer. The rulers will be drawn behind the content of the layer. If you
would you, could also use it as content of a layer.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{layercontentsmeasure}
\EndIndex{Option}{draft~=\PName{simple switch}}
%\fi^^A meta-comment
\section{Declaration and Management of Page Styles}
\label{sec:scrlayer.pagestyles}
Until now we know layers, but we don't know how to use them. The
perhaps astonishing answer is: with page styles. In \LaTeX{}, page
styles usually define heads and foots of odd and even pages.
The head and foot of odd pages will be printed on pages with odd
page number in two-side mode or on all pages in single-side mode. This is
something like the layer attributes \Option{oddpage} and \Option{evenpage}.
The page head will be printed before the main contents of a page. The page
footer will be printed after the main contents of a page. So this is something
like the layer attributes \Option{background} and \Option{foreground}.
So it's obvious to declare page styles to be a list of layers. But instead of
having only four attributes \Option{oddpage}, \Option{evenpage},
\Option{background}, and \Option{foreground} all the attributes of layers
shown in \autoref{sec:scrlayer.layers} may be used.
The outcome of this is, that one kind of page styles \Package{scrlayer}
provides are layer page styles. A layer page style consists of layers and
several \emph{hooks}. For description of layers see
\autoref{sec:scrlayer.layers}. The \emph{hooks} are points in the expansion
or execution of page styles and you may add additional code, that will be
expanded there.
Another kind of page styles \Package{scrlayer} provides are alias page
style. An alias page style simply consists of one other page style. In
other words, the name of an alias page style is only an alias name of
another page style, the aliased or original page style. Because of
this, the manipulation of an alias page style results in the
manipulation of the original page style. If the original page style is
an alias page style too, the manipulation will result in the
manipulation of the aliased page style of that original page style and
so on until a real page style will be manipulated. You may not only
alias layer page styles made with \Package{scrlayer}, but all kind of
page styles.
% \DescribeMacro{\currentpagestyle}
%\iffalse^^A meta-comment
\begin{Declaration}
\Macro{currentpagestyle}
\end{Declaration}
\BeginIndex{Cmd}{currentpagestyle}%
%\fi^^A meta-comment
Package scrlayer patches \Macro{pagestyle} to set \Macro{currentpagestyle} to
the currently active page style. Note, that \Macro{thispagestyle} does not
change \Macro{currentpagestyle}. But if you use \Macro{thispagestyle} the
result of \Macro{currentpagestyle} may be changed while execution of the
\LaTeX{} output routine. This may be relevant only, if
\Macro{currentpagestyle} has been used protected until execution of the output
routine.
Note, that the layer page styles described later in this section, won't need
the patch of \Macro{pagestyle} to set \Macro{currentpagestyle}. The patch has
been made for usage with other page styles. Note also, that
\Macro{currentpagestyle} is empty before the first \Macro{pagestyle} after
loading \Package{scrlayer}. So if you define an end user page style interface,
it may be useful to use an implicit \Macro{pagestyle} to set the current page
style to a default page style.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{currentpagestyle}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\BeforeSelectAnyPageStyle}
% \DescribeMacro{\AfterSelectAnyPageStyle}
% The command
\Macro{BeforeSelectAnyPageStyle}\Parameter{code}%
%\iffalse^^A meta-comment
\\\Macro{AfterSelectAnyPageStyle}\Parameter{code}%^^A
\end{Declaration}
\BeginIndex{Cmd}{BeforeSelectAnyPageStyle}%
\BeginIndex{Cmd}{AfterSelectAnyPageStyle}%
The command \Macro{BeforeSelectAnyPageStyle}
%\fi^^A meta-comment
adds \PName{code} to hook, that will be executed inside of \Macro{pagestyle}
just before the page style will be selected. You may use \texttt{\#1} as a
placeholder for the argument of \Macro{pagestyle}.
The command \Macro{AfterSelectAnyPageStyle}%^^A
% \iffalse^^A meta-comment
\Parameter{code}%^^A
% \fi^^A meta-comment
\ is similar, but the \PName{code} will be executed just after the page style
has been selected and after \Macro{currentpagestyle} has been set to the name
of real page style.
Note, that \PName{code} of both commands will be executed only, if a page
style will be selected using \Macro{pagestyle}, but not, e.\,g., if a page
style will be selected using \Macro{thispagestyle}. Note also, that you cannot
remove \PName{code} from the hook after adding it. But the \PName{code} will
be added locally, so you may use a group to limit the scope of
\PName{code}.%^^A
%\iffalse^^A meta-comment
\EndIndex{Cmd}{AfterSelectAnyPageStyle}
\EndIndex{Cmd}{BeforeSelectAnyPageStyle}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\DeclarePageStyleAlias}
% \DescribeMacro{\DeclareNewPageStyleAlias}
% \DescribeMacro{\ProvidePageStyleAlias}
% \DescribeMacro{\RedeclarePageStyleAlias}
% The command
\Macro{DeclarePageStyleAlias}%^^A
\Parameter{alias page style name}\Parameter{original page style name}
%\iffalse^^A meta-comment
\\\Macro{DeclareNewPageStyleAlias}%
\Parameter{alias page style name}\Parameter{original page style name}
\\\Macro{ProvidePageStyleAlias}%
\Parameter{alias page style name}\Parameter{original page style name}
\\\Macro{RedeclarePageStyleAlias}%
\Parameter{alias page style name}\Parameter{original page style name}
\end{Declaration}
\BeginIndex{Cmd}{DeclarePageStyleAlias}%
\BeginIndex{Cmd}{DeclareNewPageStyleAlias}%
\BeginIndex{Cmd}{ProvidePageStyleAlias}%
\BeginIndex{Cmd}{RedeclarePageStyleAlias}%
These Commands
%\fi^^A meta-comment
may be used to define a page style with name \PName{alias page style name},
that is simply an alias for already existing page style with name
\PName{original page style name}. If there's already a page style \PName{alias
page style name} it will be destroyed before creating the alias using
\Macro{DeclarePageStyleAlias} or \Macro{RedeclarePageStyleAlias}.
\Macro{DeclareNewPageStyleAlias} will throw an error message, if a page style
\PName{alias page style name} has already been defined before. It doesn't
matter if the already defined page style is a layer page style, an alias page
style or another page style.
\Macro{ProvidePageStyleAlias} will define the alias only, if a page style
\PName{alias page style name} hasn't been defined before. If a page style
\PName{alias page style name} already exists nothing will be done.
\Macro{RedeclarePageStyleAlias} expects, that a page style \PName{alias page
style name} already exists. In this case it will destroy it and define the
alias newly. In the other case you'll get an error.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{RedeclarePageStyleAlias}%
\EndIndex{Cmd}{ProvidePageStyleAlias}%
\EndIndex{Cmd}{DeclareNewPageStyleAlias}%
\EndIndex{Cmd}{DeclarePageStyleAlias}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\DestroyPageStyleAlias}
% The command
\Macro{DestroyPageStyleAlias}\Parameter{page style name}%
%\iffalse^^A meta-comment
\end{Declaration}
\BeginIndex{Cmd}{DestroyPageStyleAlias}%
This command
%\fi^^A meta-comment
makes the page style with given \PName{page style name} \LaTeX-undefined, if
it is an alias for another page style. After this, the page style may be
defined newly with, e.g., \Macro{DeclareNewAliasPageStyle} or
\Macro{ProvideAliasPageStyle}. The command is intended to be used inside of
\Macro{scrlayerOnAutoRemoveInterface} to remove page styles, that have been
declared by an interface and uses removable macros of that interface.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{DestroyPageStyleAlias}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\GetRealPageStyle}
% The command
\Macro{GetRealPageStyle}\Parameter{page style name}%
%\iffalse^^A meta-comment
\end{Declaration}
\BeginIndex{Cmd}{GetRealPageStyle}%
The command
%\fi^^A meta-comment
will result in the (recursive) real page name of the page style, if
the page style with given name \PName{page style name} is an alias of
another page style. In all other cases, even if there's no alias and no page
style named \PName{page style name}, the result would be simply \PName{page
style name}. The command is fully expandable and may be used, e.g., in the
second argument of \Macro{edef}.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{GetRealPageStyle}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\DeclarePageStyleByLayers}
% \DescribeMacro{\DeclareNewPageStyleByLayers}
% \DescribeMacro{\ProvidePageStyleByLayers}
% \DescribeMacro{\RedeclarePageStyleByLayers}
% The command
\Macro{DeclarePageStyleByLayers}%^^A
\OParameter{option list}\Parameter{page style name}\Parameter{layer list}%
%\iffalse^^A meta-comment
\\\Macro{DeclareNewPageStyleByLayers}%^^A
\OParameter{option list}\Parameter{page style name}\Parameter{layer list}%
\\\Macro{ProvidePageStyleByLayers}%^^A
\OParameter{option list}\Parameter{page style name}\Parameter{layer list}%
\\\Macro{RedeclarePageStyleByLayers}%^^A
\OParameter{option list}\Parameter{page style name}\Parameter{layer list}%
\end{Declaration}
\BeginIndex{Cmd}{DeclarePageStyleByLayers}%
\BeginIndex{Cmd}{DeclareNewPageStyleByLayers}%
\BeginIndex{Cmd}{ProvidePageStyleByLayers}%
\BeginIndex{Cmd}{RedeclarePageStyleByLayers}%
These commands
%\fi^^A meta-comment
declares a page style with \PName{page style name}. The page style will
consist of the layers given in \PName{layer list}, a comma separated list of
layer names. Note, that the \PName{page style name} and the layer names at the
\PName{layer list} must be fully expandable and should expand to
letters. Several other characters will be tolerated, but nevertheless, they
aren't recommended.
The \PName{option list} is a comma separated list of
\OptionValue{\PName{key}}{\PName{value}} options. These options may be used to
set additional features. Currently they are used to set the code, that should
be expanded or executed at several \emph{hooks}. See the introduction to this
section for more general information about \emph{hooks}. See
\autoref{tab:scrlayer.pagestyle.hooks} for more information about the hooks
and their purpose.
\begin{center}
\parbox{\textwidth}{%
\captionaboveof{table}{The \emph{hook} options for page styles (in order of
execution)}\nobreak\vskip4\baselineskip}\vskip-5\baselineskip
\label{tab:scrlayer.pagestyle.hooks}
\begin{description}
\item[\texttt{\KOption{onselect}\PName{code}}:] Execute \PName{code}
whenever the page style will be selected using, e.g.,
\Macro{pagestyle}. Note, that \Macro{thispagestyle} doesn't select the
page style immediately, but asynchronously inside \LaTeX's output routine.
\item[\texttt{\KOption{oninit}\PName{code}}:] Execute \PName{code} whenever
the output of the layers of a page style will be initialised. Note, that
this will be done twice for every page: once for background layers and
once for foreground layers.
\item[\texttt{\KOption{ononeside}\PName{code}}:] Execute \PName{code}
whenever the output of the layers of a page style in single-side mode will
initialised. Note, that this will be done twice for every page: once for
background layers and once for foreground layers.
\item[\texttt{\KOption{ontwoside}\PName{code}}:] Execute \PName{code}
whenever the output of the layers of a page style in two-side mode will
initialised. Note, that this will be done twice for every page: once for
background layers and once for foreground layers.
\item[\texttt{\KOption{onoddpage}\PName{code}}:] Execute \PName{code}
whenever the output of the layers of a page style on an odd page will
initialised. Note, that this will be done twice for every page: once for
background layers and once for foreground layers. Note also, that in
single-side mode all pages are odd pages, not only pages with odd page
numbers.
\item[\texttt{\KOption{onevenpage}\PName{code}}:] Execute \PName{code}
whenever the output of the layers of a page style on an even page will
initialised. Note, that this will be done twice for every page: once for
background layers and once for foreground layers. Note also, that there
aren't even pages in single-side mode, but all pages are odd pages, not
only pages with odd page numbers.
\item[\texttt{\KOption{onfloatpage}\PName{code}}:] Execute \PName{code}
whenever the output of the layers of a page style on a float page will
initialised. Note, that this will be done twice for every page: once for
background layers and once for foreground layers. Note also, that float
pages are only those pages with p-placed floating objects.
\item[\texttt{\KOption{onnonfloatpage}\PName{code}}:] Execute \PName{code}
whenever the output of the layers of a page style on a non-float page will
initialised. Note, that this will be done twice for every page: once for
background layers and once for foreground layers. Note also, that
non-float pages are all pages, that aren't float-pages. Those pages may
have t-placed, h-placed, b-placed, or no floating objects.
\item[\texttt{\KOption{onbackground}\PName{code}}:] Execute \PName{code}
whenever the output of the layers of a page style in the background of a
page will initialised. Note, that this will be done once for every page.
\item[\texttt{\KOption{onforeground}\PName{code}}:] Execute \PName{code}
whenever the output of the layers of a page style in the foreground of a
page will initialised. Note, that this will be done once for every page.
\end{description}
\end{center}
The difference of \Macro{DeclarePageStyleByLayers} and
\Macro{DeclareNewPageStyleByLayers} is, that \Macro{DeclareNewPageStyleByLayers}
will result in an error, if a page style with name \PName{page style name}
already exists. Note, that declaring a page style, that is an alias of another
page style (see \Macro{DeclareAliasPageStyle} prior in this section), will not
re-declare the page style itself, but it's real page style (see
\Macro{GetRealPageStyle} prior in this section).
The difference of \Macro{DeclarePageStyleByLayers} and
\Macro{ProvidePageStyleByLayers} is, that \Macro{ProvidePageStyleByLayers}
will simply do nothing, if there's already a page style with name \PName{page
style name}. In difference to \Macro{DeclareNewPageStyleByLayers} it won't
raise an error in this case.
The difference of \Macro{DeclarePageStyleByLayers} and
\Macro{RedeclarePageStyleByLayers} is, that \Macro{RedeclarePageStyleByLayers}
may be used only, if the real page style of \PName{page style name} already
exists. Otherwise an error would occur.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{RedeclarePageStyleByLayers}%
\EndIndex{Cmd}{ProvidePageStyleByLayers}%
\EndIndex{Cmd}{DeclareNewPageStyleByLayers}%
\EndIndex{Cmd}{DeclarePageStyleByLayers}%
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
\Pagestyle{@everystyle@}\\
\Pagestyle{empty}
\end{Declaration}
\BeginIndex{Pagestyle}{@everysel@}%
\BeginIndex{Pagestyle}{empty}%
%\fi^^A meta-comment
There are two somehow special, default layer page styles. The first one is
\Pagestyle{@everystyle@}. This page style shouldn't be used normally, but the
layers of this page style will be used by all the other layer page styles. So
adding a layer to this page style would be similar to adding this layer to all
other layer page styles even the empty one. There's one difference: Layer
referencing commands of the page style interface like
\Macro{ForEachLayerOfPageStyle}, \Macro{AddLayerToPageStyleBeforeLayer}, or
\Macro{AddLayerToPageStyleAfterLayer} ignore the layers of
\Pagestyle{@everystyle@} if they are used for another layer page style.
The other somehow special page style is \Pagestyle{empty}. Normally page style
\Pagestyle{empty} is defined by the \LaTeX{} kernel, to be a page style
without page head or page foot. Package{scrlayer} re-defines it to be a layer
page style without any layer. Nevertheless you may use it like every other
layer page style too. The main advantage above the \LaTeX{} kernel's empty
page style is, that it also executes the layers of special layer page style
\Pagestyle{@everysel@}.
%\iffalse^^A meta-comment
\EndIndex{Pagestyle}{empty}%
\EndIndex{Pagestyle}{@everysel@}%
%\fi^^A meta-comment
% \iffalse^^A meta-comment
\begin{Declaration}
% \fi^^A meta-comment
% \DescribeOption{onpsselect}%
% \DescribeOption{onpsinit}%
% \DeleteShortVerb{\|}%
% \DescribeOption{onps(one|two)side}%
% \DescribeOption{onps(odd|even)page}%
% \DescribeOption{onps(float|nonfloat)page}%
% \DescribeOption{onps(back|fore)ground}%
% \MakeShortVerb{\|}%
% \iffalse^^A meta-comment
\KOption{onpsselect}\PValue{code}\\
\KOption{onpsinit}\PValue{code}\\
\KOption{onpsoneside}\PValue{code}\\
\KOption{onpstwoside}\PValue{code}\\
\KOption{onpsoddpage}\PValue{code}\\
\KOption{onpsevenpage}\PValue{code}\\
\KOption{onpsfloatpage}\PValue{code}\\
\KOption{onpsnonfloatpage}\PValue{code}\\
\KOption{onpsbackground}\PValue{code}\\
\KOption{onpsforeground}\PValue{code}
\end{Declaration}
\BeginIndex{Option}{onpsselect}%
\BeginIndex{Option}{onpsinit}%
\BeginIndex{Option}{onpsoneside}%
\BeginIndex{Option}{onpstwoside}%
\BeginIndex{Option}{onpsoddpage}%
\BeginIndex{Option}{onpsevenpage}%
\BeginIndex{Option}{onpsfloatpage}%
\BeginIndex{Option}{onpsnonfloatpage}%
\BeginIndex{Option}{onpsbackground}%
\BeginIndex{Option}{onpsforeground}%
% \fi^^A meta-comment
There's also a \KOMAScript{} option for each of those \texttt{hooks}. The
names of the \KOMAScript{} options are similar to the names of the page style
options, but with ``\texttt{ps}'' inserted behind ``\texttt{on}''. The value of
the \KOMAScript{} options are the initial defaults of the corresponding
\texttt{hooks}. This default will be extended by every usage of the page style
options at the \PName{option list}. You may remove the default, using
\Macro{ModifyLayerPageStyleOptions} described later in this section.
% \iffalse^^A meta-comment
\EndIndex{Option}{onpsforeground}%
\EndIndex{Option}{onpsbackground}%
\EndIndex{Option}{onpsnonfloatpage}%
\EndIndex{Option}{onpsfloatpage}%
\EndIndex{Option}{onpsevenpage}%
\EndIndex{Option}{onpsoddpage}%
\EndIndex{Option}{onpstwoside}%
\EndIndex{Option}{onpsoneside}%
\EndIndex{Option}{onpsinit}%
\EndIndex{Option}{onpsselect}%
% \fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
\KOption{deactivatepagestylelayers}\PName{simple switch}\\
%\fi^^A meta-comment
% \DescribeMacro{\ForEachLayerOfPageStyle}
% The command
\Macro{ForEachLayerOfPageStyle}%^^A
\Parameter{page style name}\Parameter{code}
%\iffalse^^A meta-comment
\end{Declaration}
\BeginIndex{Cmd}{ForEachLayerOfPageStyle}%
This command
%\fi^^A meta-comment
may be used to process \PName{code} for every layer, that is a member of the
layers list of a page style with given \PName{page style name}. Inside of
\PName{code} the place holder \PValue{\#1} may be used for the name of the
current layer.
%\iffalse^^A meta-comment
\begin{Example}
%\fi^^A meta-comment
% \par
If you want to output the names of all layers of page style
\PValue{scrheadings}, you may us:
\begin{lstcode}
\let\commaatlist\empty
\ForEachLayerOfPageStyle{scrheadings}{%
\commaatlist#1\gdef\commaatlist{, }}
\end{lstcode}
%\iffalse^^A meta-comment
\end{Example}
%\fi^^A meta-comment
\KOMAScript{} option \Option{deactivatepagestylelayers} may be used to
deactivate all layers within \Macro{ForEachLayerOfPageStyle}. If the options
has been switched on, \Macro{ForEachLayerOfPageStyle} will not longer process
\PName{code} for any layer. Several other commands of \Package{scrlayer} also
uses \Macro{ForEachLayerOfPageStyle} internally. So these also won't process
any layer. You may use this options, e.g., to hide all layers.
Please note, that \PName{code} will be executed inside a group!
% \iffalse^^A meta-comment
\EndIndex{Cmd}{ForEachLayerOfPageStyle}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\AddLayersToPageStyle}
% \DescribeMacro{\AddLayersAtBeginOfPageStyle}
% \DescribeMacro{\AddLayersAtEndOfageStyle}
% \DescribeMacro{\RemoveLayersFromPageStyle}
% The command
\Macro{AddLayersToPageStyle}%^^A
\Parameter{page style name}\Parameter{layer list}%
%\iffalse^^A meta-comment
\\\Macro{AddLayersAtBeginOfPageStyle}%^^A
\Parameter{page style name}\Parameter{layer list}%
\\\Macro{AddLayersAtEndOfPageStyle}%^^A
\Parameter{page style name}\Parameter{layer list}%
\\\Macro{RemoveLayersFromPageStyle}%^^A
\Parameter{page style name}\Parameter{layer list}%
\end{Declaration}
\BeginIndex{Cmd}{AddLayersToPageStyle}%
\BeginIndex{Cmd}{AddLayersAtBeginOfPageStyle}%
\BeginIndex{Cmd}{AddLayersAtEndOfPageStyle}%
\BeginIndex{Cmd}{RemoveLayersFromPageStyle}%
The first command
%\fi^^A meta-comment
adds all layers of the comma separated list of layers \PName{layer list} at
the end of the layer list of layer page style \PName{page style
name}. \Macro{AddLayersAtEndOfPageStyle} is an alias for the same. If you
want to add the new layers at the begin of the layer list of a layer page
style you may use \Macro{AddLayersAtBeginOfPageStyle}. Note, that the layers
will be added in the order of the \PName{layer list}. The first layer at
\PName{layer list} will be added first, the second layer will be added second
and so on. So with \Macro{AddLayersAtBeginOfPageStyle} the last layer at
\PName{layer list} will become the new first layer of the layer list of layer
page style \PName{page style name}.
Command \Macro{RemoveLayersFromPageStyle} may be used to remove layers from
the layer list of layer page style \PName{page style name} instead of adding
them. Note, that layers, that are part of \PName{layer list} but not part of
the page style's layer list, will be ignored.
Adding or removing layers from a page style, that is not a layer page style or
an alias of a layer page style would be an error and result in an error
message.%
%\iffalse^^A meta-comment
\EndIndex{Cmd}{RemoveLayersFromPageStyle}%
\EndIndex{Cmd}{AddLayersAtEndOfPageStyle}%
\EndIndex{Cmd}{AddLayersAtBeginOfPageStyle}%
\EndIndex{Cmd}{AddLayersToPageStyle}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\AddLayersToPageStyleBeforeLayer}
% The commands
\Macro{AddLayersToPageStyleBeforeLayer}%^^A
\Parameter{page style name}\Parameter{layer list}%^^A
\Parameter{reference layer name}
% and
\\\Macro{AddLayersToPageStyleAfterLayer}%^^A
\Parameter{page style name}\Parameter{layer list}%^^A
\Parameter{reference layer name}
%\iffalse^^A meta-comment
\end{Declaration}
\BeginIndex{Cmd}{AddLayersToPageStyleBeforeLayer}%
\BeginIndex{Cmd}{AddLayersToPageStyleAfterLayer}%
These commands
%\fi^^A meta-comment
are similar to the commands described before, but they do not add the layers
at the begin or end of the layer list of a layer page style, but just before
or after a reference layer at the layer list of a layer page style. Note, that
in this case the order of the \PName{layer list} will be same in the layer
list of \PName{page style name} after adding. If the reference layer named
\PName{reference layer name} is not part of the layer list of the layer page
style, nothing happens.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{AddLayersToPageStyleAfterLayer}
\EndIndex{Cmd}{AddLayersToPageStyleBeforeLayer}
%\fi^^A meta-comment
% \DescribeMacro{\UnifyLayersAtPageStyle}
%\iffalse^^A meta-comment
\begin{Declaration}
\Macro{UnifyLayersAtPageStyle}\Parameter{page style name}
\end{Declaration}
\BeginIndex{Cmd}{UnifyLayersAtPageStyle}%
%\fi^^A meta-comment
With the commands described before in this section you may not only add
different layers to a page style, but even add the same layer several times to
a page style. In most cases it doesn't make sense to have one layer several
times at the layer list of a layer page style. So you may use
\Macro{UnifyLayersAtPageStyle}%^^A
%\Parameter{page style name}^^A
\ to remove all dupes of layers from the layer list of a layer page
style. Note that the order of layers may change! So if you want a special
order, you should remove all layers and add the layers in the order you want
instead of using \Macro{UnifyLayersAtPageStyle}.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{UnifyLayersAtPageStyle}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\ModifyLayerPageStyleOptions}
% \DescribeMacro{\AddToLayerPageStyleOptions}
% The command
\Macro{ModifyLayerPageStyleOptions}%^^A
\Parameter{page style name}\Parameter{option list}
%\iffalse^^A meta-comment
\\\Macro{AddToLayerPageStyleOptions}%^^A
\Parameter{page style name}\Parameter{option list}
\end{Declaration}
\BeginIndex{Cmd}{ModifyLayerPageStyleOptions}%
\BeginIndex{Cmd}{AddToLayerPageStyleOptions}%
Command \Macro{ModifyLayerPageStyleOptions}
%\fi^^A meta-comment
may be used to modify the page style options of a layer page style. Only
options at the comma separated \PName{option list} will be set to the new
values given in \PName{option list} if the new value is not empty. Options,
that are not at \PName{option list}, will stay unchanged. If you want to set
an option to \emph{do nothing} you may use value \Macro{relax}. Note, that
setting an option to a new value using \Macro{ModifyLayerPageStyleOptions}
will remove the previous value including the global default value.
\Macro{AddToLayerPageStyleOptions} differs from
\Macro{ModifyLayerPageStyleOptions} in that point. It will not overwrite the
previous values, but adds\,---\,or more precisely: concatenates\,---\, the new
values to the previous values of the options at \PName{option list}.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{AddToLayerPageStyleOptions}
\EndIndex{Cmd}{ModifyLayerPageStyleOptions}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\IfLayerPageStyleExists}
% \DescribeMacro{\IfRealLayerPageStyleExists}
% The command
\Macro{IfLayerPageStyleExists}%^^A
\Parameter{page style name}\Parameter{then code}\Parameter{else code}%
%\iffalse^^A meta-comment
\\\Macro{IfRealLayerPageStyleExists}%^^A
\Parameter{page style name}\Parameter{then code}\Parameter{else code}%
\end{Declaration}
\BeginIndex{Cmd}{IfLayerPageStyleExists}%
\BeginIndex{Cmd}{IfRealLayerPageStyleExists}%
Command \Macro{IfLayerPageStyleExists}
%\fi^^A meta-comment
tests, whether or not the real page style of \PName{page style name} is a
layer page style. If the test is true, \PName{then code} will be executed. If
\PName{page style name} is neither a layer page style, nor an alias of a layer
page style, nor an alias of an alias of \dots\ a layer page style, \PName{else
code} will be executed. Internally this command is often used to throw an
error message if you use one of the layer page style commands with an
\PName{page style name} that doesn't correspond with a layer page style.
Command \Macro{IfRealLayerPageStyleExists} is similar, but \PName{then code}
will only be executed, if \PName{page style name} itself is the name of a
layer page style. So \PName{else code} will even be executed, if \PName{page
style name} is an alias name of a layer page style or the alias name of an
alias name of \dots\ a layer page style.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{IfRealLayerPageStyleExists}
\EndIndex{Cmd}{IfLayerPageStyleExists}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\IfLayerAtPageStyle}
% \DescribeMacro{\IfSomeLayersAtPageStyle}
% \DescribeMacro{\IfLayersAtPageStyle}
% The command
\Macro{IfLayerAtPageStyle}%
\Parameter{page style name}\Parameter{layer name}%^^A
\Parameter{then code}\Parameter{else code}%
%\iffalse^^A meta-comment
\\\Macro{IfSomeLayerAtPageStyle}%
\Parameter{page style name}\Parameter{layer list}%^^A
\Parameter{then code}\Parameter{else code}%
\\\Macro{IfLayerAtPageStyle}%
\Parameter{page style name}\Parameter{layer list}%^^A
\Parameter{then code}\Parameter{else code}%
\end{Declaration}
\BeginIndex{Cmd}{IfLayerAtPageStyle}%
\BeginIndex{Cmd}{IfSomeLayersAtPageStyle}%
\BeginIndex{Cmd}{IfLayersAtPageStyle}%
Command \PName{IfLayerAtPageStyle}
%\fi^^A meta-comment
may be used to test, whether or not a layer named \PName{layer name} is a
member of the layer list of a given page style. If the test is true, the
\PName{then code} will be executed. If the layer is not a member of the layer
list of \PName{page style name}, the \PName{else code} will be executed.
Commands \Macro{IfSomeLayerAtPageStyle} and \Macro{IfLayersAtPageStyle} do not
only test one layer but several layers at a given, comma separated
\PName{layer list}. \Macro{IfSomeLayerAtPageStyle} will execute the
\PName{then code} if \emph{at least one} of the layers at \PName{layer list}
is a member of the layer list of \PName{page style name}. In difference
\Macro{IfLayersAtPageStyle} executes the \PName{then code} only, if \emph{all}
of the layers at \PName{layer list} are members of the layer list of
\PName{page style name}.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{IfLayersAtPageStyle}
\EndIndex{Cmd}{IfSomeLayersAtPageStyle}
\EndIndex{Cmd}{IfLayerAtPageStyle}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\DestroyRealLayerPageStyle}
% The command
\Macro{DestroyRealLayerPageStyle}\Parameter{page style name}
%\iffalse^^A meta-comment
\end{Declaration}
\BeginIndex{Cmd}{DestroyRealLayerPageStyle}%
Command \Macro{DestroyRealLayerPageStyle}
%\fi^^A meta-comment
makes the page style named \PName{page style name} undefined, if and only if
it is a layer page style. Nothing will be happen if it is an alias name of a
layer page style, if it is another page style, or if it isn't a page style. If
\PName{page style name} is the name of the current page style the current page
style will become a kind of empty page style. If the special page
style\,---\,this may be set using \Macro{thispagestyle}\,---\,is \PName{page
style name}, this will be simply reset.
Note, that the layers of the page style won't be destroyed automatically. If
you want to destroy the layers too, you may use
\begin{lstcode}
\ForEachLayerOfPageStyle{...}{\DestroyLayer{#1}}
\end{lstcode}
\emph{before} destroying the layer page style.
The command is intended to be used inside the auto-remove code of an interface
See following \ref{sec:scrlayer.enduserinterfaces} for more information about
auto-remove code.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{DestroyRealLayerPageStyle}
%\fi^^A meta-comment
\section{End User Interfaces}
\label{sec:scrlayer.enduserinterfaces}
Package \Package{scrlayer} provides an interface to define and manage
(concurrent) end user interfaces. Maybe future releases of \KOMAScript{} will
provide parts of this by package \Package{scrbase}, but currently package
\Package{scrlayer} provides its own interface definition commands.
This section only describes the interface commands for defining end user
interfaces. This is not of interest for end users, but only for authors of end
user interfaces. End users will find information about the end user interfaces
in the sections about the particular end user interface, e.g.,
\autoref{sec:scrlayer.scrpage}.
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\scrlayerInitInterface}
% The command
\Macro{scrlayerInitInterface}\OParameter{interface name}
%\iffalse^^A meta-comment
\end{Declaration}
\BeginIndex{Cmd}{scrlayerInitInterface}%
Command \Macro{scrlayerInitInterface}
%\fi^^A meta-comment
registers a new interface. The \PName{interface name} must be unique. If you
try to initialise an already initialised interface an error will occur. This
command is obligatory and mandatory for interfaces. It should be the first
interface command and therefore has been described first. If the optional
argument is omitted, \PValue{\Macro{@currname}.\Macro{@currext}} will be
used instead. For classes and packages this will be the file name of the class
or package while loading the class or package. But you may use any sequence of
characters with category letter or other.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{scrlayerInitInterface}
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
\KOption{forceoverwrite}\PName{simple switch}\\
\KOption{autoremoveinterfaces}\PName{simple switch}\\
%\fi^^A meta-comment
% \DescribeMacro{\scrlayerAddToInterface}
% \DescribeMacro{\scrlayerAddCsToInterface}
%\iffalse^^A meta-comment
\Macro{scrlayerAddToInterface}%
\OParameter{interface name}\Parameter{command}\Parameter{code}\\
\Macro{scrlayerAddCsToInterface}%
\OParameter{interface name}\Parameter{command sequence}\Parameter{code}
\end{Declaration}
\BeginIndex{Option}{forceoverwrite}%
\BeginIndex{Option}{autoremoveinterfaces}%
\BeginIndex{Cmd}{scrlayerAddToInterface}%
\BeginIndex{Cmd}{scrlayerAddCsToInterface}%
%\fi^^A meta-comment
One of the special features of end user interfaces is, that they should
register all interface dependent commands (also known as \emph{macros}). You
may do this using \Macro{scrlayerAddToInterface}%^^A
%\OParameter{interface name}\Parameter{command}\Parameter{code}%^^A
. If your interface generates macros not only at load time but also at run
time or if the interface name shouldn't be the class's or package's name, you
have to use the optional argument to add the command to a dedicated
interface. An error will occur, if the interface hasn't been initialised
before.
The first mandatory argument is the \PName{command}\footnote{The
\PName{command} consists in the backslash followed by a \PName{command
sequence} consisting in characters with category code letter or one other
character, or \PName{command} consists in one active character (without
backslash).}, that should be added to the interface. If the command can be
added to the interface, it will be added to the interface, will be set to
\Macro{relax} and \PName{code} will be executed. You can use, e.g.,
\Macro{newcommand}\PName{command} inside of \PName{code} to define
\PName{command}.
But when can a command be defined? If a command is undefined or \Macro{relax}
it can be defined. If a command has already been defined and registered for
another interface \emph{and} if \KOMAScript{} option
\Option{autoremoveinterface} has been switched on, the other interface will be
removed automatically and the new command will be set to \Macro{relax} and
will be registered for the given interface. If a command
has already been defined but isn't part of another interface \emph{and} if
\KOMAScript{} option \Option{forceoverwrite} has been switched on, the command
will be set to \Macro{relax} and will be registered for the given interface.
Command \Macro{scrlayerAddCsToInterface} is similar to
\Macro{scrlayerAddToInterface} but doesn't expect a command as first,
mandatory argument, but a command sequence\footnote{A command sequence may
consist of any characters with category code letter or other.}.
%\iffalse^^A meta-comment
\EndIndex{Cmd}{scrlayerAddCsToInterface}%
\EndIndex{Cmd}{scrlayerAddToInterface}
\EndIndex{Option}{autoremoveinterfaces}%
\EndIndex{Option}{forceoverwrite}%
%\fi^^A meta-comment
%\iffalse^^A meta-comment
\begin{Declaration}
%\fi^^A meta-comment
% \DescribeMacro{\scrlayerOnAutoRemoveInterface}
% The command
\Macro{scrlayerOnAutoRemoveInterface}%^^A
\OParameter{interface name}\Parameter{code}
%\iffalse^^A meta-comment
\end{Declaration}
\BeginIndex{Cmd}{scrlayerOnAutoRemoveInterface}%
Command \Macro{scrlayerOnAutoRemoveInterface}
%\fi^^A meta-comment
registers \PName{code} to be executed, if the interface will be automatically
removed (see \Option{autoremoveinterfaces} prior in this section). This may be
used, e.g., to automatically destroy layers or page styles (see
\Macro{DestroyLayer}, \Macro{DestroyAliasPageStyle}, and
\Macro{DestroyRealLayerPageStyle}).
%\iffalse^^A meta-comment
\EndIndex{Cmd}{scrlayerOnAutoRemoveInterface}
%\fi^^A meta-comment
%\iffalse
%
%\fi
%
% \StopEventually{}
%
%
% \section{Implementation of \Package{scrlayer}}
%
% This section if for developers only.
% Users may continue at \autoref{sec:scrlayer.scrpage} at
% page~\pageref{sec:scrlayer.scrpage}.
%
% \iffalse
%<*package>
%<*identify>
% \fi
%
%\iffalse^^A meta-comment
%
%
%<*package|interface>
%\fi^^A meta-comment
%
% \subsection{Initialising some Values before the Options}
%
% \iffalse^^A meta-comment
%<*init>
% \fi^^A meta-comment
%
% Initialisation before all options.
%
% While there are \KOMAScript{} options, we need \Package{scrkbase} to declare
% them, but the interfaces also needs \Package{scrlayer} which already
% includes \Package{scrkbase}.
% \begin{macrocode}
%\RequirePackage{scrkbase}[2013/03/05]
%\RequirePackage{scrlayer}
% \end{macrocode}
%
%
% \begin{macro}{\scrlayer@AtEndOfPackage}
% Initial \Macro{AtEndOfPackage}, but after end of package
% \Macro{@firstofone}.
% \begin{macrocode}
\scr@ifundefinedorrelax{scrlayer@AtEndOfPackage}{%
\AtEndOfPackage{\let\scrlayer@AtEndOfPackage\@firstofone}%
}{%
\ifx\scrlayer@AtEndOfPackage\@firstofone
\AtEndOfPackage{\let\scrlayer@AtEndOfPackage\@firstofone}%
\fi
}
\let\scrlayer@AtEndOfPackage\AtEndOfPackage
% \end{macrocode}
% \end{macro}^^A \sls@AtEndOfPackage
%
% \begin{macro}{\scrlayer@testunexpectedarg}
% We'll have several \KOMAScript{} options, that didn't expect an
% value. So we use this general helper to test the value and report an error
% if it is not empty (or \Macro{relax}).
% \begin{macrocode}
%<*package>
\newcommand*{\scrlayer@testunexpectedarg}[2]{%
\ifx\relax#2\relax\else
\PackageError{scrlayer}{unexpected value to `#1'}{%
Option `#1' doesn't expect any value.\MessageBreak
If you'll continue, the value `#2' will be ignored.%
}%
\fi
}
%
% \end{macrocode}
% \end{macro}^^A \scrlayer@testunexpectedarg
%
% \begin{macro}{\if@chapter}
% We need this later. But it is something general. So we initialise it as
% early as possible.
% \begin{macrocode}
%<*package>
\scr@ifundefinedorrelax{if@chapter}{%
\newif\if@chapter
\scr@ifundefinedorrelax{chapter}{\@chapterfalse}{\@chaptertrue}%
}{}
% \end{macrocode}
% \end{macro}^^A \if@chapter
%
% \begin{macro}{\if@mainmatter}
% Some classes define \Macro{frontmatter} or \Macro{mainmatter}, but do not
% define \Macro{if@mainmatter}. But we nee some information about the matter,
% so in that case, we add it.
% \begin{macrocode}
\scr@ifundefinedorrelax{if@mainmatter}{%
\scr@ifundefinedorrelax{mainmatter}{%
\newif\if@mainmatter\@mainmattertrue
}{%
\PackageWarningNoLine{scrlayer}{%
\string\mainmatter\space defined without
\string\if@mainmatter!\MessageBreak
Note, that several packages need
\string\if@mainmatter\space\MessageBreak
to detect whether or no the main matter has been\MessageBreak
entered. So does scrlayer. Because of this\MessageBreak
it will extend \string\mainmatter, now%
}%
\newif\if@mainmatter\@mainmattertrue
\expandafter\def\expandafter\mainmatter\expandafter{%
\expandafter\@mainmattertrue\mainmatter}%
\scr@ifundefinedorrelax{frontmatter}{}{%
\expandafter\def\expandafter\frontmatter\expandafter{%
\expandafter\@mainmatterfalse\frontmatter}
}%
\scr@ifundefinedorrelax{backmatter}{}{%
\expandafter\def\expandafter\backmatter{%
\expandafter\@mainmatterfalse\backmattter}%
}%
}%
}{}
%
% \end{macrocode}
% \end{macro}^^A \if@mainmatter
%
% \iffalse^^A meta-comment
%
% \fi^^A meta-comment
%
%
% \subsection{Process Options}
%
% \iffalse^^A meta-comment
%<*body>
% \fi^^A meta-comment
%
% The very first thing at the body is processing the options:
% \begin{macrocode}
\KOMAProcessOptions\relax
% \end{macrocode}
%
% \subsection{Body Initialisation}
%
% Currently not needed.
%
% \iffalse
%
% \fi
%
%
% \subsection{Extended Running Heads}
%
% Package \Package{scrpage2} changes and extends the running head mechanisms
% of \LaTeX{} and the classes. Most of this are basic features an therefore
% done already by \Package{scrlayer}. But not the deprecated options.
%
% \begin{option}{markcase}
% \begin{description}
% \item[\texttt{=\meta{setting}}] one of: \texttt{upper}, \texttt{lower},
% \texttt{used}, or \texttt{ignoreuppercase}.
% \end{description}\noindent
% The two options \Option{markuppercase} and \Option{markusedcase} become
% deprecated and are replace be the single option \Option{markcase}. Note,
% that interface \Package{scrlayer-scrpage} has to delay this option to
% overload case setting of option \Option{pagestyleset}.
% \begin{macrocode}
%<*options>
\KOMA@key{markcase}{%
%\scrlayer@AtEndOfPackage{%
\begingroup
\KOMA@set@ncmdkey{markcase}{reserved@a}{%
{upper}{0},{lower}{1},{used}{2},%
{ignoreuppercase}{3},{nouppercase}{3},%
{ignoreupper}{3},{noupper}{3}%
}{#1}%
\ifx\FamilyKeyState\FamilyKeyStateProcessed
\aftergroup\FamilyKeyStateProcessed
\ifnum \reserved@a>\m@ne
\aftergroup\let\aftergroup\MakeMarkcase
\ifcase \reserved@a
\aftergroup\MakeUppercase
\aftergroup\scrlayer@forceignoreuppercasefalse
\or
\aftergroup\MakeLowercase
\aftergroup\scrlayer@forceignoreuppercasefalse
\or
\aftergroup\@firstofone
\aftergroup\scrlayer@forceignoreuppercasefalse
\else
\aftergroup\scrlayer@ignoreuppercase
\aftergroup\scrlayer@forceignoreuppercasetrue
\fi
\fi
\else
\aftergroup\FamilyKeyStateUnknownValue
\fi
\endgroup
%}%
}
%\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @markcase}
% \end{macrocode}
% \begin{macro}{\MakeMarkcase}
% We use this instead of, e.g., \Macro{MakeUppercase} for every layer! So the
% name seams to be wrong, but it is common, so we use it here.
% \begin{macrocode}
%<*package>
\providecommand*{\MakeMarkcase}[1]{#1}
% \end{macrocode}
% \begin{macro}{\scrlayer@ignoreuppercase}
% We span a group and set \Macro{uppercase} and \Macro{MakeUppercase} to
% \Macro{@firstofone}.
% \begin{macrocode}
\DeclareRobustCommand*{\scrlayer@ignoreuppercase}[1]{%
\begingroup
\let\uppercase\@firstofone
\let\MakeUppercase\@firstofone
\expandafter\let\csname MakeUppercase \endcsname\@firstofone
#1%
\endgroup
}
% \end{macrocode}
% This is almost enough, but standard classes still would show upper-case
% letters at table of contents, list of figures, list of tables, index and
% bibliography. So we need an additional workaround.
% \begin{macro}{\ifscrlayer@forceignoreuppercase}
% \begin{macrocode}
\newif\ifscrlayer@forceignoreuppercase
%
%
% \end{macrocode}
% \end{macro}^^A \ifscrlayer@forceignoreuppercase
% \end{macro}^^A \scrlayer@ignoreuppercase
% \end{macro}^^A \MakeMarkcase
% \end{option}^^A markcase
%
%
% \begin{macro}{\headmark}
% Inside a page style, this macro is either \Macro{rightmark} or
% \Macro{leftmark}. Outside its \LaTeX-undefined and therefore it's not an
% interface command, but has to be undefined:
% \begin{macrocode}
%<*package&body>
\@ifundefined{headmark}{}{%
\PackageWarningNoLine{scrlayer}{%
\string\headmark\space detected!\MessageBreak
\string\headmark\space will either be set to
\string\rightmark\MessageBreak
or \string\leftmark inside of page styles.\MessageBreak
This means, that \string\headmark\space will be overwritten\MessageBreak
at every page layer usage!\MessageBreak
Nevertheless it will stay unchanged outside\MessageBreak
of page layers.\MessageBreak
I hope, this won't break your document%
}%
}
%
% \end{macrocode}
% \end{macro}^^A \headmark
%
% \begin{macro}{\pagemark}
% The page number together with its font setting. It's robust and will never
% be part of the interface.
% \begin{macrocode}
%<*package&body>
\@ifundefined{pagemark}{%
\DeclareRobustCommand\pagemark{{\pnumfont{\thepage}}}%
}{}%
% \end{macrocode}
% \begin{macro}{\pnumfont}
% \begin{macro}{\scr@fnt@pagenumber}
% The low-level page number font command. It is deprecated to redefine or use
% this and it may already be defined. These commands will not become part of
% the interface!
% \begin{macrocode}
\@ifundefined{pnumfont}{%
\newcommand{\pnumfont}{\normalfont}%
}{}
\@ifundefined{scr@fnt@pagenumber}{%
\newcommand{\scr@fnt@pagenumber}{\pnumfont}%
}{}
%
% \end{macrocode}
% \end{macro}^^A \scr@fnt@pagenumber
% \end{macro}^^A \pnumfont
% \end{macro}^^A \pagemark
%
% \begin{macro}{\partmarkformat}
% \begin{macro}{\chaptermarkformat}
% \begin{macro}{\sectionmarkformat}
% \begin{macro}{\GenericMarkFormat}
% All the \Macro{\dots markformat} macros of \KOMAScript{} are also
% supported by \Package{scrlayer} and it uses them actively. The generic
% definition has been moved from \Macro{@seccntmarkformat} to
% \Macro{GenericMarkFormat}. This is one more difference to
% \Package{scrpage2}. The defaults are compatible to the standard
% classes. These commands will not become part of the interface and other
% interfaces should redefine them only, if they are not already defined.
% \begin{macrocode}
%<*package&body>
\providecommand*{\partmarkformat}{\partname\ \thepart. \ }%
\if@chapter
\providecommand*{\@chapapp}{\chaptername}%
\providecommand*{\chaptermarkformat}{\@chapapp\ \thechapter. \ }%
\providecommand*{\sectionmarkformat}{\thesection. \ }%
\else
\providecommand*{\sectionmarkformat}{\GenericMarkFormat{section}}%
\fi
\scr@ifundefinedorrelax{@seccntmarkformat}{%
\providecommand*{\GenericMarkFormat}{\@seccntformat}%
}{%
\providecommand*{\GenericMarkFormat}[1]{\@seccntmarkformat{#1}}%
}
%
% \end{macrocode}
% Note, that the other \Macro{\dots markformat} will be defined by
% \Macro{scrlayer@level@init}.
% \end{macro}^^A \GenericMarkFormat
% \end{macro}^^A \sectionmarkformat
% \end{macro}^^A \chaptermarkformat
% \end{macro}^^A \partmarkformat
%
% \begin{macro}{\@mkleft}
% \begin{macro}{\@mkright}
% \begin{macro}{\@mkdouble}
% These are new in \Package{scrlayer}. They may be updated, whenever
% \Macro{@mkboth} will be updated. Otherwise they get a working default
% definition. These commands will not become part of the interface and other
% interfaces should redefine them only, if they are not already defined.
% \begin{macrocode}
%<*package&body>
\providecommand*{\@mkleft}{%
\begingroup
\ifx\@mkboth\markboth \aftergroup\markleft
\else
\ifx\@mkboth\@gobbletwo \aftergroup\@gobble
\else \def\@gobbletwo##1##2{}%
\ifx \@mkboth\@gobbletwo \aftergroup\@gobble
\else
\PackageWarning{scrlayer}{%
package incompatibility detected!\MessageBreak
\string\@mkboth it neither \string\markboth nor any\MessageBreak
kind of two arguments gobbling,\MessageBreak
e.g., \string\@gobbletwo.\MessageBreak
So I don't known, what to do\MessageBreak
with \string\@mkleft.\MessageBreak
Nevertheless, \string\markleft\space will be\MessageBreak
used%
}%
\aftergroup\markleft
\fi
\fi
\fi
\endgroup
}%
\providecommand*{\@mkright}{%
\begingroup
\ifx\@mkboth\markboth \aftergroup\markright
\else
\ifx\@mkboth\@gobbletwo \aftergroup\@gobble
\else \def\@gobbletwo##1##2{}%
\ifx \@mkboth\@gobbletwo \aftergroup\@gobble
\else
\PackageWarning{scrlayer}{%
package incompatibility detected!\MessageBreak
\string\@mkboth it neither \string\markboth nor any\MessageBreak
kind of two arguments gobbling,\MessageBreak
e.g., \string\@gobbletwo.\MessageBreak
So I don't known, what to do\MessageBreak
with \string\@mkright.\MessageBreak
Nevertheless, \string\markright\space will be\MessageBreak
used%
}%
\aftergroup\markright
\fi
\fi
\fi
\endgroup
}%
\providecommand*{\@mkdouble}[1]{%
\@mkboth{#1}{#1}%
}
%
% \end{macrocode}
% \end{macro}^^A \@mkdouble
% \end{macro}^^A \@mkright
% \end{macro}^^A \@mkleft
%
% \begin{macro}{\markleft}
% \begin{macro}{\@markleft}
% \LaTeX{} itself provides \Macro{markboth} and \Macro{markright} but not
% \Macro{markleft}. So we add it.
% \begin{macrocode}
%<*package&body>
\providecommand*{\markleft}[1]{%
\begingroup
\let\label\relax \let\index\relax \let\glossary\relax
\expandafter\@markleft\@themark {#1}%
\@temptokena \expandafter{\@themark}%
\mark{\the\@temptokena}%
\endgroup
\if@nobreak\ifvmode\nobreak\fi\fi
}
\providecommand{\@markleft}[3]{%
\@temptokena {#2}%
\unrestored@protected@xdef\@themark{{#3}{\the\@temptokena}}%
}
%
% \end{macrocode}
% \end{macro}^^A \@markleft
% \end{macro}^^A \markleft
%
%
% \begin{option}{autooneside}
% \begin{macro}{\ifscrlayer@autooneside}
% Decide whether or not use the optional argument of \Macro{automark} in
% single-side layout.
% \begin{macrocode}
%<*options>
\KOMA@ifkey{autooneside}{scrlayer@autooneside}\scrlayer@autoonesidetrue
%\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @autooneside}
%
% \end{macrocode}
% \end{macro}^^A \ifscrlayer@autooneside
% \end{option}^^A autooneside
%
%
% \begin{option}{automark}
% \begin{option}{manualmark}
% Maybe we will extend these options later. Currently they do almost the
% same they do at \Package{scrpage2}. The difference is, that single-side or
% two-side doesn't matter here (but it does inside of the definitions of the
% marks itself).
% ToDo: Maybe \Option{manualmark} should become deprecated and
% \Option{automark} should have simple values or a new option, that also
% handles \Option{autooneside}?
% \begin{macrocode}
%<*options>
\KOMA@key{automark}[]{%
\scrlayer@testunexpectedarg{automark}{#1}%
\scrlayer@AtEndOfPackage{%
\if@chapter
\automark[section]{chapter}%
\else
\automark[subsection]{section}%
\fi
}%
\FamilyKeyStateProcessed
}
%<*interface>
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @automark}
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @automark@default}
%
\KOMA@key{manualmark}[]{%
\scrlayer@testunexpectedarg{manualmark}{#1}%
\scrlayer@AtEndOfPackage{\manualmark}%
\FamilyKeyStateProcessed
}
%<*interface>
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @manualmark}
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @manualmark@default}
%
%
% \end{macrocode}
% \end{option}^^A manualmark
% \end{option}^^A automark
%
% \begin{macro}{\manualmark}
% Switch to manual marks. This resets \Macro{@mkleft}, \Macro{@mkright},
% \Macro{@mkdouble}, \Macro{@mkboth} and the \Macro{\dots mark} of all known
% levels.
% \begin{macrocode}
%<*package&body>
\newcommand*{\manualmark}{%
\begingroup
\def\@elt##1{%
\aftergroup\let\expandafter\aftergroup\csname ##1mark\endcsname
\aftergroup\@gobble
}%
\scrlayer@level@list
\endgroup
\let\@mkleft\@gobble
\let\@mkright\@gobble
\let\@mkdouble\@gobble
\let\@mkboth\@gobbletwo
}
%
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\automark}
% \begin{macro}{\@automark}
% This is the brain knot of the game! I'll try to explain, what I'm doing:
% First of all the new starred version of \Macro{automark} doesn't reset the
% mark commands. So it works cumulatively. This may be useful e.g. to have
% chapter marks as long as no section marks have been made etc.
% \begin{macrocode}
%<*package&body>
\newcommand*{\automark}{%
\@ifstar{\@automark}{\manualmark\@automark}%
}
\newcommand*{\@automark}[2][]{%
\ifstr{#2}{}{%
\ifstr{#1}{}{%
% \end{macrocode}
% \Macro{automark[]{}} or \Macro{automark{}} has been used. This will activate
% the low level mark commands, but doesn't change the high level commands. It
% may be useful or may not, the user should know what he does:
% \begin{macrocode}
\automark@basics
}{%
% \end{macrocode}
% \Macro{automark[\dots]{}} has been used. This will activate the higher level
% mark commands and also set up the right mark
% \begin{macrocode}
\automark@basics
\automark@righthigh{#1}%
}%
}{%
\ifstr{#1}{}{%
% \end{macrocode}
% \Macro{automark[]{\dots}} or \Macro{automark{\dots}} has been used. This
% will activate the low level mark commands and also set up either the left or
% both marks.
% \begin{macrocode}
\automark@basics
\automark@leftlow{#2}%
}{%
% \end{macrocode}
% \Macro{automark[\dots]{\dots}} has been used. This will activate the low
% level mark commands and also both high level marks.
% \begin{macrocode}
\automark@basics
\automark@both{#1}{#2}%
}%
}%
}
% \end{macrocode}
% \begin{macro}{\automark@basics}
% Activate all low level \Macro{@mk\dots} commands:
% \begin{macrocode}
\newcommand*{\automark@basics}{%
\let\@mkleft\markleft
\let\@mkright\markright
\let\@mkboth\markboth
\def\@mkdouble##1{\@mkboth{##1}{##1}}%
}
% \end{macrocode}
% \end{macro}^^A \automark@basics
% \begin{macro}{\automark@righthigh}
% Set up the right mark of a higher level, but in single-side layout only if
% \Option{autooneside} hasn't been used. Note, that with this definition no
% special handling for \KOMAScript's \Macro{addchap} and \Macro{addsec} is
% needed.
% \begin{macrocode}
\newcommand*{\automark@righthigh}[1]{%
\ifscrlayer@level@prepared{#1}{%
\expandafter\def\csname #1mark\endcsname##1{%
\begingroup
\@tempswafalse
\if@twoside\@tempswatrue
\else\ifscrlayer@autooneside\else\@tempswatrue\fi\fi
\expandafter\endgroup
\if@tempswa
\@mkright{%
\MakeMarkcase{%
\ifnum \c@secnumdepth<\numexpr \csname #1level\endcsname +0\relax
\else\if@mainmatter \csname #1markformat\endcsname\fi\fi
##1%
}%
}%
\fi
}%
}{}%
}
% \end{macrocode}
% \end{macro}^^A \automark@righthigh
% \begin{macro}{\automark@leftlow}
% Set up the left mark of a low level, but in single-side layout the right
% mark has to be used.
% \begin{macrocode}
\newcommand*{\automark@leftlow}[1]{%
\ifscrlayer@level@prepared{#1}{%
\expandafter\def\csname #1mark\endcsname ##1{%
\if@twoside
% \end{macrocode}
% In two-side mode the left high mark has also to clear the right low
% mark. This would be unwanted, if the left mark is a low mark and the right
% mark is a high mark. But we cannot detect this if no right mark level has
% been given. So we simply use:
% \begin{macrocode}
\expandafter\@mkboth
\else
% \end{macrocode}
% In single-side mode there's no left high mark without a right low mark. So
% instead of only a left high mark, we set up both marks.
% \begin{macrocode}
\expandafter\@mkdouble
\fi
{%
\MakeMarkcase{%
\ifnum \c@secnumdepth<\numexpr \csname #1level\endcsname +0\relax
\else\if@mainmatter \csname #1markformat\endcsname\fi\fi
##1%
}%
}\@empty
}%
}{}%
}
% \end{macrocode}
% \end{macro}^^A \automark@leftlow
% \begin{macro}{\automark@both}
% Set up both marks, but in single-side layout depending on
% \Option{autooneside}.
% \begin{macrocode}
\newcommand*{\automark@both}[2]{%
\ifscrlayer@level@prepared{#1}{%
\ifscrlayer@level@prepared{#2}{%
\ifnum \numexpr \csname #1level\endcsname +0\relax
> \numexpr \csname #2level\endcsname +0\relax
% \end{macrocode}
% Level of left mark is greater than level of right mark. e.g., section >
% chapter. This is unusual. Nevertheless we'll handle it.
% \begin{macrocode}
\automark@leftlow{#2}%
\automark@righthigh{#1}%
\else \ifnum \numexpr \csname #1level\endcsname +0\relax
= \numexpr \csname #2level\endcsname +0\relax
% \end{macrocode}
% Level of left mark is equal to level of right mark. This is
% nice and very easy to handle.
% \begin{macrocode}
\expandafter\def\csname #2mark\endcsname##1{%
\@mkdouble{%
\MakeMarkcase{%
\ifnum \c@secnumdepth<\numexpr
\csname #2level\endcsname +0\relax
\else
\if@mainmatter \csname #2markformat\endcsname\fi
\fi
##1%
}%
}%
}%
\else
% \end{macrocode}
% Level of left mark is less than level of right mark. This is
% usual.
% \begin{macrocode}
\expandafter\def\csname #1mark\endcsname##1{%
\begingroup
\@tempswafalse
\if@twoside\@tempswatrue
\else\ifscrlayer@autooneside\else\@tempswatrue\fi\fi
\expandafter\endgroup
\if@tempswa
\@mkleft{%
\MakeMarkcase{%
\ifnum \c@secnumdepth
< \numexpr\csname #1level\endcsname +0\relax
\else
\if@mainmatter \csname #1markformat\endcsname\fi
\fi
##1%
}%
}%
\fi
}%
\expandafter\def\csname #2mark\endcsname##1{%
\@mkboth{}{%
\MakeMarkcase{%
\ifnum \c@secnumdepth
< \numexpr \csname #2level\endcsname +0\relax
\else\if@mainmatter \csname #2markformat\endcsname\fi\fi
##1%
}%
}%
}%
\fi
\fi
}{}%
}{}%
}
% \end{macrocode}
% \begin{macro}{\ifscrlayer@level@prepared}
% Test, whether or not this level has been prepared.
% \begin{macrocode}
\newcommand*{\ifscrlayer@level@prepared}[1]{%
\typeout{1: \detokenize{#1}}%
\scr@ifundefinedorrelax{#1level}{%
\PackageError{scrlayer}{numbering depth of `#1' unknown}{%
Someone told me to use a section mark for level `#1',\MessageBreak
but the numbering depth hasn't been declared before. You may solve this
using\MessageBreak
\string\DeclareSectionNumberDepth{#1}{NUMBER}.%
}%
\@secondoftwo
}{%
\@firstoftwo
}%
}
%
% \end{macrocode}
% \end{macro}^^A \ifscrlayer@level@prepared
% \end{macro}^^A \automark@both
% \end{macro}^^A \@automark
% \end{macro}^^A \automark
%
% \begin{macro}{\DeclareSectionNumberDepth}
% \begin{description}
% \item[\Parameter{string}:] the name of the section level, e.g.,
% part, chapter, section etc. (must be fully
% expandable and expand to a string).
% \item[\Parameter{numeric expression}:] the section number depth of the
% level, e.g., -1 for part, 0 for chapter etc.
% \end{description}
% Note that levels part, chapter, section, subsection, sub\dots subsection,
% paragraph, subparagraph, sub\dots subparagraph, minisec, subminisec,
% sub\dots subminisec will be recognised either at load time or at
% \Macro{begin}\PParameter{document} automatically if they have the usual
% levels.
% \begin{macrocode}
%<*package&body>
\newcommand*{\DeclareSectionNumberDepth}[2]{%
\expandafter\edef\csname #1level\endcsname{\the\numexpr #2\relax}%
\@ifundefined{#1mark}{%
\expandafter\let\csname #1mark\endcsname\@gobble
}{}%
\@ifundefined{#1markformat}{%
\@namedef{#1markformat}{\GenericMarkFormat{#1}}%
}{}%
\begingroup
\@tempswatrue
\def\@elt##1{\ifstr{#1}{##1}{\@tempswafalse}{}}%
\scrlayer@level@list
\if@tempswa
\aftergroup\@firstofone
\else
\aftergroup\@gobble
\fi
\endgroup
{%
\l@addto@macro\scrlayer@level@list{\@elt{#1}}%
}%
}
% \end{macrocode}
% \begin{macro}{\scrlayer@level@list}
% \begin{macro}{\scrlayer@level@init}
% Stores all the existing levels.
% \begin{macrocode}
\newcommand*{\scrlayer@level@list}{}
% \end{macrocode}
% Usually all levels are known on loading this package, but if a package
% defines additional levels later we'll do an additional test at
% \Macro{begin}\PParameter{document}. But we do not redo the part and the
% chapter test.
% \begin{macrocode}
\scr@ifundefinedorrelax{part}{}{%
\DeclareSectionNumberDepth{part}{-1}%
}
\if@chapter
\DeclareSectionNumberDepth{chapter}{0}%
\fi
\newcommand*{\scrlayer@level@init}{%
\@tempcnta=1
\def\reserved@b##1{%
\@tempswatrue
\def\reserved@a{##1}%
\@whilesw \if@tempswa \fi {%
\scr@ifundefinedorrelax{\reserved@a}{%
\@tempswafalse
}{%
\@ifundefined{\reserved@a level}{%
\expandafter\DeclareSectionNumberDepth
\expandafter{\reserved@a}{\@tempcnta}%
}{}%
\advance \@tempcnta by \@ne
\edef\reserved@a{sub\reserved@a}%
}%
}%
}%
\reserved@b{section}%
\reserved@b{paragraph}%
\reserved@b{minisec}%
}
\scrlayer@level@init
\AtBeginDocument{%
\scrlayer@level@init
}
%
% \end{macrocode}
% \end{macro}^^A \scrlayer@level@init
% \end{macro}^^A \scrlayer@level@list
% \end{macro}^^A DeclareSectionNumberDepth
%
%
% \subsection{Providing Layers}
%
% A layer is a virtual sheet of paper stacked behind or above the real sheet
% of paper. All the virtual and real sheets of one page may been seen
% simultanous, but material o one sheet may overlap material on sheets below.
% Layers provided by \Package{scrlayer} will not be stacked below or above
% real sheets unless they are used by a page style.
%
% While we use \meta{key}\texttt{=}\meta{value} arguments for several of the
% layer commands we define a new family with a new member:
% \begin{macrocode}
%<*package&body>
\DefineFamily{KOMAarg}
\DefineFamilyMember[.definelayer]{KOMAarg}
%
% \end{macrocode}
%
% \begin{macro}{\DeclareLayer}
% \begin{description}
% \item[\OParameter{option list}:] a comma separated list of
% \texttt{\meta{key}=\meta{value}} pairs.
% \item[\Parameter{string}:] the name of the layer (must be fully expandable
% and expand to a string only).
% \end{description}
% Layers are the basic elements of page styles. A layer has a name and several
% attributes. The attributes may be set as comma separated list at the first,
% optional argument of \cs{DeclareLayer}. The name must be set by the second,
% mandatory argument.
% \begin{macro}{\def@scr@l@pos}
% And a second helper macro to easily define $x, y, w, h$ of a layer.
% \begin{macrocode}
%<*package&body>
\newcommand*{\def@scr@l@pos}[4]{%
\@namedef{scr@l@\scr@current@layer @x}{#1}%
\@namedef{scr@l@\scr@current@layer @y}{#2}%
\@namedef{scr@l@\scr@current@layer @w}{#3}%
\@namedef{scr@l@\scr@current@layer @h}{#4}%
}
% \end{macrocode}
% \end{macro}^^A \def@scr@l@pos
%
% There are basic attributes and compounding attributes. The basic attributes
% are:
% \begin{description}
% \item[\texttt{hoffset=\meta{dimension expression}}:] offset from the left
% edge of the paper.
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{hoffset}{%
\@namedef{scr@l@\scr@current@layer @x}{\dimexpr #1\relax}%
\FamilyKeyStateProcessed
}
% \end{macrocode}
% \item[\texttt{voffset=\meta{dimension expression}}:] offset from the top
% edge of the paper.
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{voffset}{%
\@namedef{scr@l@\scr@current@layer @y}{\dimexpr #1\relax}%
\FamilyKeyStateProcessed
}
% \end{macrocode}
% \item[\texttt{width=\meta{dimension expression}}:] width of the layer.
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{width}{%
\@namedef{scr@l@\scr@current@layer @w}{\dimexpr #1\relax}%
\FamilyKeyStateProcessed
}
% \end{macrocode}
% \item[\texttt{height=\meta{dimension expression}}:] height of the layer.
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{height}{%
\@namedef{scr@l@\scr@current@layer @h}{\dimexpr #1\relax}%
\FamilyKeyStateProcessed
}
% \end{macrocode}
% \item[\texttt{align=\meta{specification}}:] horizontal and vertical
% alignment of the layer. The \meta{specification} will interpreted
% character by character with the following valid characters:
% \begin{itemize}
% \item[l] -- align the layer with its left edge to the given horizontal
% offset. This means, that the layer's width will span right from the
% given horizontal offset.
% \item[r] -- align the layer with its right edge to the given horizontal
% offset. This means, that the layer's width will span left from the given
% horizontal offset.
% \item[c] -- align the layer centered to the given horizontal and vertical
% offset. This means, that the given offsets are at the middle of the
% layer width and total height.
% \item[t] -- align the layer with its top edge to the given vertical
% offset. This means that the layer's contents will span below the given
% vertical offset.
% \item[b] -- align the layer with its bottom edge to the given vertical
% offset. This means, that the layer's contents will span above the given
% vertical offset.
% \end{itemize}
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{align}{%
\@namedef{scr@l@\scr@current@layer @align}{#1}%
\FamilyKeyStateProcessed
}
% \end{macrocode}
% \item[\texttt{contents=\meta{output}}:] whatever should be printed by the
% layer.
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{contents}{%
\@namedef{scr@l@\scr@current@layer @contents}{#1}%
\FamilyKeyStateProcessed
}
% \end{macrocode}
% \item[\texttt{background}:] restrict the layer to the page
% background. This means, that the main contents of the page may overprint
% the contents of the layer. Note, that this attribute has no value!
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{background}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{background}{#1}%
\csname @scr@l@\scr@current@layer @backgroundtrue\endcsname
\csname @scr@l@\scr@current@layer @foregroundfalse\endcsname
}
% \end{macrocode}
% \item[\texttt{foreground}:] restrict the layer to the page
% foreground. This means, that the layer's contents may overprint the main
% contents of the page. Note, that this attribute has no value!
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{foreground}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{foreground}{#1}%
\csname @scr@l@\scr@current@layer @backgroundfalse\endcsname
\csname @scr@l@\scr@current@layer @foregroundtrue\endcsname
}
% \end{macrocode}
% \item[\texttt{oddpage}:] restrict the layer to odd pages only. At
% two-sided layout only pages with odd page numbers are odd pages. At
% single-sided layout all pages are odd pages. Note, that this attribute has
% no value!
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{oddpage}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{oddpage}{#1}%
\csname @scr@l@\scr@current@layer @oddtrue\endcsname
\csname @scr@l@\scr@current@layer @evenfalse\endcsname
}
% \end{macrocode}
% \item[\texttt{evenpage}:] restrict the layer to even pages only. At
% two-sided layout only pages with even page numbers are even pages. At
% single-sided layout there aren't even pages. Note, that this attribute has
% no value!
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{evenpage}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{evenpage}{#1}%
\csname @scr@l@\scr@current@layer @oddfalse\endcsname
\csname @scr@l@\scr@current@layer @eventrue\endcsname
}
% \end{macrocode}
% \item[\Option{floatpage}:] restrict the layer to float pages.
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{floatpage}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{floatpage}{#1}%
\csname @scr@l@\scr@current@layer @nonfloatpagefalse\endcsname
\csname @scr@l@\scr@current@layer @floatpagetrue\endcsname
}
% \end{macrocode}
% \item[\Option{nonfloatpage}:] restrict the layer to pages, which aren't
% float pages.
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{nonfloatpage}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{twoside}{#1}%
\csname @scr@l@\scr@current@layer @nonfloatpagetrue\endcsname
\csname @scr@l@\scr@current@layer @floatpagefalse\endcsname
}
% \end{macrocode}
% \item[\Option{oneside}:] restrict the layer to pages on single-sided
% layouts.
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{oneside}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{oneside}{#1}%
\csname @scr@l@\scr@current@layer @twosidefalse\endcsname
\csname @scr@l@\scr@current@layer @onesidetrue\endcsname
}
% \end{macrocode}
% \item[\Option{twoside}:] restrict the layer to pages on two-sided
% layouts.
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{twoside}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{twoside}{#1}%
\csname @scr@l@\scr@current@layer @twosidetrue\endcsname
\csname @scr@l@\scr@current@layer @onesidefalse\endcsname
}
% \end{macrocode}
% \end{description}
%
% Compounding attributes are attributes, that set up several basic attributes
% with a single compounding attribute:
% \begin{description}
% \item[\texttt{page}:] set up \texttt{hoffset}, \texttt{voffset},
% \texttt{width}, and \texttt{height} to values spanning the whole
% page aligned by the default alignment \texttt{tl}. Note, that this
% attribute has no value!
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{page}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{page}{#1}%
\def@scr@l@pos{\z@}{\z@}{\paperwidth}{\paperheight}%
\@namedef{scr@l@\scr@current@layer @align}{tl}%
}
% \end{macrocode}
% \item[\texttt{topmargin}:] set up \texttt{hoffset}, \texttt{voffset},
% \texttt{width}, and \texttt{height} to values vertically spanning the top
% margin of the page and horizontally spanning the whole page aligned by the
% default alignment \texttt{tl}. Note, that this attribute has no value!
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{topmargin}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{topmargin}{#1}%
\def@scr@l@pos{\z@}{\z@}{\paperwidth}{\dimexpr \topmargin+1in\relax}%
\@namedef{scr@l@\scr@current@layer @align}{tl}%
}
% \end{macrocode}
% \item[\texttt{head}:] set up \texttt{hoffset}, \texttt{voffset},
% \texttt{width}, and \texttt{height} to values vertically spanning the page
% head and horizontally spanning the text area aligned by usual head
% alignment \texttt{bl}. Note, that this attribute has no value!
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{head}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{head}{#1}%
\def@scr@l@pos{%
\dimexpr
\if@twoside\ifodd\value{page}\oddsidemargin\else\evensidemargin\fi
\else\oddsidemargin\fi
+1in
\relax
}{%
\dimexpr \topmargin+1in+\headheight\relax
}{\textwidth}{\headheight}%
\@namedef{scr@l@\scr@current@layer @align}{bl}%
}
% \end{macrocode}
% \item[\texttt{headsep}:] set up \texttt{hoffset}, \texttt{voffset},
% \texttt{width}, and \texttt{height} to values vertically spanning the area
% between page head and text area and horizontally spanning the text area
% aligned by the default alignment \texttt{t}. Note, that this attribute
% has no value!
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{headsep}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{head}{#1}%
\def@scr@l@pos{%
\dimexpr
\if@twoside\ifodd\value{page}\oddsidemargin\else\evensidemargin\fi
\else\oddsidemargin\fi
+1in
\relax
}{%
\dimexpr \topmargin+1in+\headheight\relax
}{\textwidth}{\headsep}%
\@namedef{scr@l@\scr@current@layer @align}{tl}%
}
% \end{macrocode}
% \item[\texttt{textarea}:] set up \texttt{hoffset}, \texttt{voffset},
% \texttt{width}, and \texttt{height} to values spanning the text area of
% the page aligned by the default alignment \texttt{t}. Note, that this
% attribute has no value!
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{textarea}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{textarea}{#1}%
\def@scr@l@pos{%
\dimexpr
\if@twoside\ifodd\value{page}\oddsidemargin\else\evensidemargin\fi
\else\oddsidemargin\fi
+1in
\relax
}{%
\dimexpr \topmargin+1in+\headheight+\headsep\relax
}{\textwidth}{\textheight}%
\@namedef{scr@l@\scr@current@layer @align}{tl}%
}
% \end{macrocode}
% \item[\texttt{foot}:] set up \texttt{hoffset}, \texttt{voffset},
% \texttt{width}, and \texttt{height} to values vertically spanning the page
% footer and horizontally spanning the text area aligned by the usual footer
% alignment \texttt{t}. Note, that this attribute has no value!
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{foot}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{foot}{#1}%
\def@scr@l@pos{%
\dimexpr
\if@twoside\ifodd\value{page}\oddsidemargin\else\evensidemargin\fi
\else\oddsidemargin\fi
+1in
\relax
}{%
\dimexpr \topmargin+1in+\headheight+\headsep+\textheight
+\footskip+\dp\strutbox-\footheight\relax
}{\textwidth}{\footheight}%
\@namedef{scr@l@\scr@current@layer @align}{tl}%
}
% \end{macrocode}
% \item[\texttt{footskip}:] set up \texttt{hoffset}, \texttt{voffset},
% \texttt{width}, and \texttt{height} to values vertically spanning the
% distance from the text area to the page
% footer and horizontally spanning the text area aligned by the usual footer
% alignment \texttt{t}. Note, that this attribute has no value!
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{footskip}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{foot}{#1}%
\def@scr@l@pos{%
\dimexpr
\if@twoside\ifodd\value{page}\oddsidemargin\else\evensidemargin\fi
\else\oddsidemargin\fi
+1in
\relax
}{%
\dimexpr \topmargin+1in+\headheight+\headsep+\textheight\relax
}{\textwidth}{\dimexpr\footskip+\dp\strutbox-\footheight\relax}%
\@namedef{scr@l@\scr@current@layer @align}{tl}%
}
% \end{macrocode}
% \item[\texttt{bottommargin}:] set up \texttt{hoffset}, \texttt{voffset},
% \texttt{width}, and \texttt{height} to values vertically spanning the
% page's bottom margin below the footer and horizontally spanning the page
% by the default alignment \texttt{t}. Note, that this attribute has no
% value!
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{bottommargin}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{bottommargin}{#1}%
\def@scr@l@pos{\z@}{%
\dimexpr \topmargin+1in+\headheight+\headsep
+\textheight
+\footskip+\dp\strutbox\relax
}{\paperwidth}{\dimexpr\paperheight-\layeryoffset\relax}%
\@namedef{scr@l@\scr@current@layer @align}{tl}%
}
% \end{macrocode}
% \item[\texttt{leftmargin}:] set up \texttt{hoffset}, \texttt{voffset},
% \texttt{width}, and \texttt{height} to values vertically spanning the page
% and horizontally spanning the left margin of the page by the default
% alignment \texttt{t}. Note, that this attribute has no value!
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{leftmargin}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{leftmargin}{#1}%
\def@scr@l@pos{\z@}{\z@}{%
\dimexpr
\if@twoside\ifodd\value{page}\oddsidemargin\else\evensidemargin\fi
\else\oddsidemargin\fi
+1in
\relax
}{\paperheight}%
\@namedef{scr@l@\scr@current@layer @align}{tl}%
}
% \end{macrocode}
% \item[\texttt{rightmargin}:] set up \texttt{hoffset}, \texttt{voffset},
% \texttt{width}, and \texttt{height} to values vertically spanning the page
% and horizontally spanning the right margin of the page by the default
% alignment \texttt{t}. Note, that this attribute has no value!
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{rightmargin}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{rightmargin}{#1}%
\def@scr@l@pos{\paperwidth}{\z@}{%
\dimexpr \paperwidth-1in-\textwidth
-\if@twoside\ifodd\value{page}\oddsidemargin\else\evensidemargin\fi
\else\oddsidemargin\fi\relax
}{\paperheight}%
\@namedef{scr@l@\scr@current@layer @align}{tr}%
}
% \end{macrocode}
% \item[\texttt{innermargin}:] set up \texttt{hoffset}, \texttt{voffset},
% \texttt{width}, and \texttt{height} to values vertically spanning the page
% and horizontally spanning the right margin of even pages and the left
% margin of odd pages by the default alignment \texttt{t}. See attributes
% \texttt{oddpage} and \texttt{evenpage} for more information about odd and
% even pages. Note, that this attribute has no value!
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{innermargin}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{innermargin}{#1}%
\def@scr@l@pos{%
\if@twoside
\ifodd\value{page} \z@
\else \dimexpr \evensidemargin+1in+\textwidth\relax
\fi
\else \z@\fi
}{\z@}{%
\dimexpr
\if@twoside\ifodd\value{page} \oddsidemargin+1in
\else \paperwidth-\layerxoffset\fi
\else \oddsidemargin+1in\fi
\relax
}{\paperheight}%
\@namedef{scr@l@\scr@current@layer @align}{tl}%
}
% \end{macrocode}
% \item[\texttt{outermargin}:] set up \texttt{hoffset}, \texttt{voffset},
% \texttt{width}, and \texttt{height} to values vertically spanning the page
% and horizontally spanning the left margin of even pages and the right
% margin of odd pages by the default alignment \texttt{t}. See attributes
% \texttt{oddpage} and \texttt{evenpage} for more information about odd and
% even pages. Note, that this attribute has no value!
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{outermargin}[\relax]{%
\FamilyKeyStateProcessed
\scrlayer@testunexpectedarg{outermargin}{#1}%
\def@scr@l@pos{%
\dimexpr
\if@twoside\ifodd\value{page} \oddsidemargin+1in+\textwidth
\else \z@\fi
\else \oddsidemargin+1in+\textwidth\fi
\relax
}{\z@}{%
\dimexpr
\if@twoside\ifodd\value{page}\paperwidth-\layerxoffset
\else \evensidemargin+1in\fi
\else \paperwidth-\layerxoffset\fi
\relax
}{\paperheight}%
\@namedef{scr@l@\scr@current@layer @align}{tl}%
}
% \end{macrocode}
% \item[\texttt{area=\{\meta{hoffset}\}\{\meta{voffset}\}^^A
% \{\meta{width}\}\{\meta{height}\}}:] set up
% \texttt{hoffset}, \texttt{voffset}, \texttt{width}, and \texttt{height} to
% the given values.
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{area}{%
\def@scr@l@pos#1
\FamilyKeyStateProcessed
}
% \end{macrocode}
% \item[\texttt{clone=\meta{layer}}:] set up the new layer by the settings
% of the given \meta{layer}.
% \begin{macrocode}
\DefineFamilyKey[.definelayer]{KOMAarg}{clone}{%
\scr@ifundefinedorrelax{scr@l@#1@x}{%
\FamilyKeyStateUnknownValue
\PackageError{scrlayer}{layer `#1' undefined}{%
You can clone only already defined layers.\MessageBreak
If you'll continue, `clone=#1' will be ignored.%
}%
}{%
\FamilyKeyStateProcessed
\scrlayer@clone@attribute{\scr@current@layer}{#1}{x}%
\scrlayer@clone@attribute{\scr@current@layer}{#1}{y}%
\scrlayer@clone@attribute{\scr@current@layer}{#1}{w}%
\scrlayer@clone@attribute{\scr@current@layer}{#1}{h}%
\scrlayer@clone@attribute{\scr@current@layer}{#1}{align}%
\scrlayer@clone@attribute{\scr@current@layer}{#1}{contents}%
\scrlayer@clone@switch{\scr@current@layer}{#1}{background}%
\scrlayer@clone@switch{\scr@current@layer}{#1}{foreground}%
\scrlayer@clone@switch{\scr@current@layer}{#1}{odd}%
\scrlayer@clone@switch{\scr@current@layer}{#1}{even}%
\scrlayer@clone@switch{\scr@current@layer}{#1}{oneside}%
\scrlayer@clone@switch{\scr@current@layer}{#1}{twoside}%
\scrlayer@clone@switch{\scr@current@layer}{#1}{floatpage}%
\scrlayer@clone@switch{\scr@current@layer}{#1}{nonfloatpage}%
}%
}
% \end{macrocode}
% \begin{macro}{\scrlayer@clone@attribute}
% \begin{macro}{\scrlayer@clone@switch}
% Two helpers used to at option \texttt{clone} to clone either a macro-based
% attribute or a if-based attribute.
% \begin{macrocode}
\newcommand*{\scrlayer@clone@attribute}[3]{%
\expandafter\let\csname scr@l@#1@#3\expandafter\endcsname
\csname scr@l@#2@#3\expandafter\endcsname
}
\newcommand*{\scrlayer@clone@switch}[3]{%
\expandafter\let\csname if@scr@l@#1@#3\expandafter\endcsname
\csname if@scr@l@#2@#3\expandafter\endcsname
}
% \end{macrocode}
% \end{macro}^^A \scrlayer@clone@switch
% \end{macro}^^A \scrlayer@clone@attribute
% \end{description}
%
% \begin{macrocode}
\newcommand*{\DeclareLayer}[2][]{%
\def\scr@current@layer{#2}%
\@namedef{scr@l@#2@x}{\z@}%
\@namedef{scr@l@#2@y}{\z@}%
\@namedef{scr@l@#2@w}{\paperwidth}%
\@namedef{scr@l@#2@h}{\paperheight}%
\@namedef{scr@l@#2@align}{tl}%
\@namedef{scr@l@#2@contents}{}%
\expandafter\newif\csname if@scr@l@#2@background\endcsname
\csname @scr@l@#2@backgroundtrue\endcsname
\expandafter\newif\csname if@scr@l@#2@foreground\endcsname
\csname @scr@l@#2@foregroundtrue\endcsname
\expandafter\newif\csname if@scr@l@#2@odd\endcsname
\csname @scr@l@#2@oddtrue\endcsname
\expandafter\newif\csname if@scr@l@#2@even\endcsname
\csname @scr@l@#2@eventrue\endcsname
\expandafter\newif\csname if@scr@l@#2@oneside\endcsname
\csname @scr@l@#2@onesidetrue\endcsname
\expandafter\newif\csname if@scr@l@#2@twoside\endcsname
\csname @scr@l@#2@twosidetrue\endcsname
\expandafter\newif\csname if@scr@l@#2@floatpage\endcsname
\csname @scr@l@#2@floatpagetrue\endcsname
\expandafter\newif\csname if@scr@l@#2@nonfloatpage\endcsname
\csname @scr@l@#2@nonfloatpagetrue\endcsname
\FamilyExecuteOptions[.definelayer]{KOMAarg}{#1}%
}
% \end{macrocode}
% \begin{macro}{\scr@current@layer}
% Helper to hold the current layer and only valid in non recursive calls of
% \Macro{DeclareLayer}.
% \begin{macrocode}
\newcommand*{\scr@current@layer}{}
%
% \end{macrocode}
% \end{macro}^^A \scr@current@layer
% \end{macro}^^A \DeclareLayer
%
% \begin{macro}{\IfLayerExists}
% \begin{description}
% \item[\Parameter{string}:] the name of the layer (must be fully expandable
% and expand to a string only).
% \item[\Parameter{then code}:] will be executed, if the layer exists.
% \item[\Parameter{else code}:] will be executed, if the layer doesn't exist.
% \end{description}
% Note, that we don't known really whether or not a layer exists, but have a
% heuristic.
% \begin{macrocode}
%<*package&body>
\newcommand*{\IfLayerExists}[1]{%
\scr@ifundefinedorrelax{scr@l@#1@x}{%
\expandafter\@secondoftwo
}{%
\expandafter\@firstoftwo
}%
}
%
% \end{macrocode}
% \end{macro}%^^A \IfLayerExists
%
% \begin{macro}{\DeclareNewLayer}
% \begin{macro}{\ProvideLayer}
% \begin{macro}{\RedeclareLayer}
% \begin{macro}{\ModifyLayer}
% There are also two commands for declaration of layers, that haven't been
% declared before, with or without error message for already declared layers,
% and two commands for changing already declared layers, first one beginning
% again from scratch, second one for only setting up attributes, that should
% be changed.
% \begin{macrocode}
%<*package&body>
\newcommand*{\DeclareNewLayer}[2][]{%
\IfLayerExists{#2}{%
\PackageError{scrlayer}{layer `#2' already defined}{%
You may declare only layer, that haven't been declared previously
using\MessageBreak
\string\DeclareNewLayer. See also the alternatives
\string\RedeclareLayer,\MessageBreak
\string\ModifyLayer\space and \string\ProvideLayer.\MessageBreak
If you'll continue, declaration will be ignored.}%
}{\DeclareLayer[{#1}]{#2}}%
}
\newcommand*{\ProvideLayer}[2][]{%
\IfLayerExists{#2}{%
%<*trace>
\PackageInfo{scrlayer}{\string\ProvideLayer{#2} ignored,\MessageBreak
because of already defined layer}%
%
}{\DeclareNewLayer[{#1}]{#2}}%
}
\newcommand*{\RedeclareLayer}[2][]{%
\IfLayerExists{#2}{}{%
\PackageError{scrlayer}{layer `#2' not yet defined}{%
You may declare only already declared layers using
\string\RedeclareLayer.\MessageBreak
See also the alternatives
\string\DeclareLayer and \string\ProvideLayer.\MessageBreak
Nevertheless, if you'll continue, declaration will be done.}%
}%
\DeclareLayer[{#1}]{#2}%
}
\newcommand*{\ModifyLayer}[2][]{%
\IfLayerExists{#2}{%
\FamilyExecuteOptions[.definelayer]{KOMAarg}{#1}%
}{%
\PackageError{scrlayer}{layer `#2' not yet defined}{%
You may modify only already declared layers using
\string\ModifyLayer.\MessageBreak
See also the alternatives
\string\DeclareLayer and \string\ProvideLayer.\MessageBreak
Nevertheless, if you'll continue, declaration will be done.}%
\DeclareLayer[{#1}]{#2}%
}%
}
%
% \end{macrocode}
% \end{macro}^^A \ModifyLayer
% \end{macro}^^A \RedeclareLayer
% \end{macro}^^A \ProvideLayer
% \end{macro}^^A \DeclareNewLayer
%
%
% \begin{macro}{\DestroyLayer}
% \begin{description}
% \item[\Parameter{string}:] the name of the layer, that should be
% destroyed
% \end{description}
% Note: Nothing will be done to remove the layer from a page style, but this
% shouldn't matter, because layers with, e.g.,
% \Macro{if@scr@l@\dots@nonfloatpage}=\Macro{relax} and
% \Macro{if@scr@l@\dots@floatpage}=\Macro{relax} won't be output ever. This
% command may and should be used by interfaces via
% \Macro{scrlayerOnAutoRemoveInterface} to remove the generated
% layers. Therefore it only destroys existing layers and doesn't care for not
% existing.
% \begin{macrocode}
%<*package&body>
\newcommand*{\DestroyLayer}[1]{%
\IfLayerExists{#1}{%
\expandafter\let\csname scr@l@#1@x\endcsname\relax
\expandafter\let\csname scr@l@#1@y\endcsname\relax
\expandafter\let\csname scr@l@#1@w\endcsname\relax
\expandafter\let\csname scr@l@#1@h\endcsname\relax
\expandafter\let\csname scr@l@#1@align\endcsname\relax
\expandafter\let\csname scr@l@#1@contents\endcsname\relax
\expandafter\let\csname if@scr@l@#1@background\endcsname\relax
\expandafter\let\csname @scr@l@#1@backgroundfalse\endcsname\relax
\expandafter\let\csname @scr@l@#1@backgroundtrue\endcsname\relax
\expandafter\let\csname if@scr@l@#1@foreground\endcsname\relax
\expandafter\let\csname @scr@l@#1@foregroundfalse\endcsname\relax
\expandafter\let\csname @scr@l@#1@foregroundtrue\endcsname\relax
\expandafter\let\csname if@scr@l@#1@odd\endcsname\relax
\expandafter\let\csname @scr@l@#1@oddfalse\endcsname\relax
\expandafter\let\csname @scr@l@#1@oddtrue\endcsname\relax
\expandafter\let\csname if@scr@l@#1@even\endcsname\relax
\expandafter\let\csname @scr@l@#1@evenfalse\endcsname\relax
\expandafter\let\csname @scr@l@#1@eventrue\endcsname\relax
\expandafter\let\csname if@scr@l@#1@oneside\endcsname\relax
\expandafter\let\csname @scr@l@#1@onesidefalse\endcsname\relax
\expandafter\let\csname @scr@l@#1@onesidetrue\endcsname\relax
\expandafter\let\csname if@scr@l@#1@twoside\endcsname\relax
\expandafter\let\csname @scr@l@#1@twosidefalse\endcsname\relax
\expandafter\let\csname @scr@l@#1@twosidetrue\endcsname\relax
\expandafter\let\csname if@scr@l@#1@floatpage\endcsname\relax
\expandafter\let\csname @scr@l@#1@floatpagefalse\endcsname\relax
\expandafter\let\csname @scr@l@#1@floatpagetrue\endcsname\relax
\expandafter\let\csname if@scr@l@#1@nonfloatpage\endcsname\relax
\expandafter\let\csname @scr@l@#1@nonfloatpagefalse\endcsname\relax
\expandafter\let\csname @scr@l@#1@nonfloatpagetrue\endcsname\relax
}{%
%<*trace>
\PackageInfo{scrlayer}{\string\DestroyLayer{#1} ignored,\MessageBreak
because that layer doesn't exist\MessageBreak
(any longer)%
}%
%
}%
}
%
% \end{macrocode}
% \end{macro}^^A \DestroyLayer
%
%
% \begin{macro}{\layercontentsmeasure}
% This may used by used as the only value of the layer option
% \texttt{contents} to show measure lines around the layer. The left and the
% top measure line will be in centimeter, the right and the bottom measure
% line in inch. With option \texttt{draft=true} this also be used
% automatically and additionally for every layer of a page style.
% \begin{macrocode}
%<*package&body>
\newcommand*{\layercontentsmeasure}{%
\smash{\begin{picture}(0,0)
(0,\if t\scr@l@valign -\ht\strutbox
\else
\if b\scr@l@valign -\dimexpr\layerheight-\dp\strutbox\relax
\else -.5\dimexpr \layerheight+\ht\strutbox-\dp\strutbox\relax
\fi
\fi\@gobble)
% \end{macrocode}
% 1st horizontal cm
% \begin{macrocode}
\put(0,0){\line(1,0){\layerwidth\@gobble}}%
\@tempcnta=\numexpr \dimexpr\layerwidth + .5mm\relax/\dimexpr 1mm\relax\relax
\multiput(0,0)(1mm\@gobble,0){\@tempcnta}{%
\line(0,-1){1mm\@gobble}%
}%
\@tempcnta=\numexpr \dimexpr\layerwidth + 2.5mm\relax/\dimexpr 5mm\relax\relax
\multiput(0,0)(5mm\@gobble,0){\@tempcnta}{%
\line(0,-1){2mm\@gobble}%
}%
\@tempcnta=\numexpr \dimexpr\layerwidth + .5cm\relax/\dimexpr 1cm\relax\relax
\multiput(0,0)(10mm\@gobble,0){\@tempcnta}{%
\put(0,0){\line(0,-1){3mm\@gobble}}%
\put(0,-3.5mm\@gobble){%
\makebox(0,0)[ct]{\the\numexpr\@tempcnta-\@multicnt\relax}}%
}%
% \end{macrocode}
% 2nd horizontal in:
% \begin{macrocode}
\put(0,-\layerheight\@gobble){\line(1,0){\layerwidth\@gobble}}%
\@tempcnta=\numexpr \dimexpr\layerwidth + .05in\relax/\dimexpr .1in\relax\relax
\multiput(0,-\layerheight\@gobble)(.1in\@gobble,0){\@tempcnta}{%
\line(0,1){1mm\@gobble}%
}%
\@tempcnta=\numexpr \dimexpr\layerwidth + .25in\relax/\dimexpr .5in\relax\relax
\multiput(0,-\layerheight\@gobble)(.5in\@gobble,0){\@tempcnta}{%
\line(0,1){2mm\@gobble}%
}%
\@tempcnta=\numexpr \dimexpr\layerwidth + .5in\relax/\dimexpr 1in\relax\relax
\multiput(0,-\layerheight\@gobble)(1in\@gobble,0){\@tempcnta}{%
\put(0,0){\line(0,1){3mm\@gobble}}%
\put(0,3.5mm\@gobble){%
\makebox(0,0)[cb]{\the\numexpr\@tempcnta-\@multicnt\relax}}%
}%
% \end{macrocode}
% 3rd vertical cm:
% \begin{macrocode}
\put(0,0){\line(0,-1){\layerheight\@gobble}}%
\@tempcnta\numexpr \dimexpr\layerheight + .5mm\relax/\dimexpr 1mm\relax\relax
\multiput(0,0)(0,-1mm\@gobble){\@tempcnta}{%
\line(1,0){1mm\@gobble}%
}%
\@tempcnta\numexpr \dimexpr\layerheight + 2.5mm\relax/\dimexpr 5mm\relax\relax
\multiput(0,0)(0,-5mm\@gobble){\@tempcnta}{%
\line(1,0){2mm\@gobble}%
}%
\@tempcnta\numexpr \dimexpr\layerheight + .5cm\relax/\dimexpr 1cm\relax\relax
\multiput(0,0)(0,-1cm\@gobble){\@tempcnta}{%
\put(0,0){\line(1,0){3mm\@gobble}}%
\put(3.5mm\@gobble,0){%
\makebox(0,0)[cl]{\the\numexpr\@tempcnta-\@multicnt\relax}}%
}%
% \end{macrocode}
% 4th vertical in:
% \begin{macrocode}
\put(\layerwidth\@gobble,0){\line(0,-1){\layerheight\@gobble}}%
\@tempcnta\numexpr \dimexpr\layerheight + .05in\relax/\dimexpr .1in\relax\relax
\multiput(\layerwidth\@gobble,0)(0,-.1in\@gobble){\@tempcnta}{%
\line(-1,0){1mm\@gobble}%
}%
\@tempcnta\numexpr \dimexpr\layerheight + .25in\relax/\dimexpr .5in\relax\relax
\multiput(\layerwidth\@gobble,0)(0,-.5in\@gobble){\@tempcnta}{%
\line(-1,0){2mm\@gobble}%
}%
\@tempcnta\numexpr \dimexpr\layerheight + .5in\relax/\dimexpr 1in\relax\relax
\multiput(\layerwidth\@gobble,0)(0,-1in\@gobble){\@tempcnta}{%
\put(0,0){\line(-1,0){3mm\@gobble}}%
\put(-3.5mm\@gobble,0){%
\makebox(0,0)[cr]{\the\numexpr\@tempcnta-\@multicnt\relax}}%
}%
\end{picture}}%
}
%
% \end{macrocode}
% \end{macro}^^A \layercontentsmeasure
%
%
% \subsection{Providing Page Styles}
%
% Page styles in \LaTeX{} consist of the elements:
% \begin{itemize}
% \item a header for odd pages,
% \item a header for even pages,
% \item a footer for odd pages,
% \item a footer for even pages,
% \end{itemize}
% and some optional additional commands, that will be expanded, whenever the
% page style will be activated. Note, that header and footer for even pages
% will be used only at two-sided mode. At one-sided mode the header and footer
% for odd pages will be used for all pages.
%
% With package \Package{scrlayer} layers will be linked to package styles and
% expanded at the four elements above. Background layers will expand only
% at the headers. Foreground layers will expand only at the
% footers. Layers, that haven't been restricted to background or foreground,
% will expand at both, page headers and page footers.
%
% Similar to the expansion of background and foreground layers, odd page
% layers will only expand in the headers or footers of odd pages and even page
% layers will only expand in the headers or footers of even pages. Layers,
% that haven't been restricted to odd or even pages, will expand in the
% headers or footers of odd pages and also in the headers or footers of even
% pages.
%
% One step more: Single-side layers will only expand in the headers or footers
% of pages in single-side layouts and two-side layers only in the headers or
% footers of pages in two-side layout.
%
% One more step: float page layers will only expand in the headers or footers
% of pages, that consists of page floats only, while non-float page layers
% will only expand in the headers of footers of pages, that doesn't have page
% floats.
%
% \begin{length}{\footheight}
% For the header \LaTeX{} already defines a length \Length{headheight} to be
% the maximum height of the header. But for footer it only defines the
% distance of the baseline of the footer from the last baseline of the text
% area. \Package{scrlayer} changes this and also defines a new length
% \Length{footheight}. This length will be initialised with magic value
% -12345\,sp. But if it is still that magic value at
% \Macro{begin}\PParameter{document} it will be reset to the value of
% \Length{baselineskip}.
% \begin{macrocode}
%<*package&init>
\@ifundefined{footheight}{%
\newlength{\footheight}%
\setlength{\footheight}{-12345sp}%
}{%
%<*trace>
\PackageInfo{scrlayer}{Using already defined \string\footheight\MessageBreak
hoping, that this is a length and\MessageBreak
not only a macro}%
%
}
\AtBeginDocument{%
\ifdim\footheight=-12345sp
%<*trace>
\PackageInfo{scrlayer}{Setting magic \string\footheight\space to
\string\baselineskip\space while\MessageBreak
\string\begin{document}}%
%
\setlength{\footheight}{\baselineskip}
\fi
}
%
% \end{macrocode}
% \end{length}^^A \footheight
%
%
% Several of the following commands use \meta{key}=\meta{value} arguments. So
% we define a family with a new member:
% \begin{macrocode}
%<*package&body>
\DefineFamily{KOMAarg}
\DefineFamilyMember[.definelayerpagestyle]{KOMAarg}
%
% \end{macrocode}
%
% \begin{macro}{\DeclarePageStyleByLayers}
% \begin{description}
% \item[\OParameter{option list}:] comma separated list of named page
% style options (see below).
% \item[\Parameter{string}:] the name of the page style to be declared (must
% be expandable and result in a string).
% \item[\Parameter{string list}:] comma separated list of layer names (must
% be expandable and result in strings); first in the list will be added
% first.
% \end{description}
% Page styles may be declared using this command. It has one optional and
% two mandatory arguments. The first mandatory one is the name of the page
% style and the second one is a list of layers to be used for this page
% style. The page style itself will expand all background layers for odd
% pages in \cs{@oddhead}, all background layers for even pages on
% \cs{@evenhead}, all foreground layers for odd pages in \cs{@oddfoot}, and
% all foreground layers for even pages in \cs{@evenfoot}. This may be
% restricted by additional attributes, e.g., \Option{oneside} and
% \Option{twoside}.
%
% The optional argument may be used to define hooks. There are six named
% optional arguments to set up six hooks. And there are also \KOMAScript{}
% options for these, to define global pre-definitions. Note, that you may
% remove the global pre-definitions by emptying the local hooks. The local
% argument are named similar, but without ``\texttt{ps}'' after
% ``\texttt{on}''.
% \begin{option}{onpsselect}
% \begin{macro}{\@ps@initialhook}
% \begin{description}
% \item[\texttt{=\meta{code}}:] executes \meta{code} whenever the
% page style will be selected, e.g. using \Macro{pagestyle} or
% \Macro{thispagestyle} or the low level command defining the page
% style itself.
% \end{description}
% \begin{macrocode}
%<*options>
\KOMA@key{onpsselect}{%
\l@addto@macro{\@ps@initialhook}{#1}%
\FamilyKeyStateProcessed
}
%<*interface>
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpsselect}
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpsselect@default}
%
%\newcommand*{\@ps@initialhook}{}
%
%<*package&body>
\DefineFamilyKey[.definelayerpagestyle]{KOMAarg}{onselect}{%
\expandafter\l@addto@macro
\csname @ps@\scrlayer@current@pagestyle @initialhook\endcsname
{#1}%
\FamilyKeyStateProcessed
}
%
% \end{macrocode}
% \end{macro}^^A \@ps@initialhook
% \end{option}^^A onpsselect
% \begin{option}{onpsinit}
% \begin{macro}{\@ps@hook}
% \begin{description}
% \item[\texttt{=\meta{code}}:] executes \meta{code} whenever the
% output of a layer stack is initialised. Note, that \meta{code} must not
% result in any page output. Otherwise the output of the layer stack will be
% broken!
% \end{description}
% \begin{macrocode}
%<*options>
\KOMA@key{onpsinit}{%
\l@addto@macro{\@ps@hook}{#1}%
\FamilyKeyStateProcessed
}
%<*interface>
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpsinit}
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpsinit@default}
%
%\newcommand*{\@ps@hook}{}
%
%<*package&body>
\DefineFamilyKey[.definelayerpagestyle]{KOMAarg}{oninit}{%
\expandafter\l@addto@macro
\csname @ps@\scrlayer@current@pagestyle @hook\endcsname
{#1}%
\FamilyKeyStateProcessed
}
%
% \end{macrocode}
% \end{macro}^^A \@ps@hook
% \end{option}^^A onpsinit
% \begin{option}{onpsoneside}
% \begin{macro}{\@ps@onesidehook}
% \begin{description}
% \item[\Option{=\meta{code}}:] executes \meta{code} after
% \Option{oninit}'s \meta{code} whenever the output of a layer stack of a
% page in single-side layout is initialised. Note, that \meta{code} must not
% result in any page output. Otherwise the output of the layer stack will be
% broken!
% \end{description}
% \begin{macrocode}
%<*options>
\KOMA@key{onpsoneside}{%
\l@addto@macro{\@ps@onesidehook}{#1}%
\FamilyKeyStateProcessed
}
%<*interface>
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpsoneside}
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpsoneside@default}
%
%\newcommand*{\@ps@onesidehook}{}
%
%<*package&body>
\DefineFamilyKey[.definelayerpagestyle]{KOMAarg}{ononeside}{%
\expandafter\l@addto@macro
\csname @ps@\scrlayer@current@pagestyle @onesidehook\endcsname
{#1}%
\FamilyKeyStateProcessed
}
%
% \end{macrocode}
% \end{macro}^^A \@ps@onesidehook
% \end{option}^^A onpsoneside
% \begin{option}{onpstwoside}
% \begin{macro}{\@ps@twosidehook}
% \begin{description}
% \item[\Option{=\meta{code}}:] executes \meta{code} after
% \Option{oninit}'s \meta{code} whenever the output of a layer stack of a
% page in two-side layout is initialised. Note, that \meta{code} must not
% result in any page output. Otherwise the output of the layer stack will be
% broken!
% \end{description}
% \begin{macrocode}
%<*options>
\KOMA@key{onpstwoside}{%
\l@addto@macro{\@ps@twosidehook}{#1}%
\FamilyKeyStateProcessed
}
%<*interface>
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpstwoside}
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpstwoside@default}
%
%\newcommand*{\@ps@twosidehook}{}
%
%<*package&body>
\DefineFamilyKey[.definelayerpagestyle]{KOMAarg}{ontwoside}{%
\expandafter\l@addto@macro
\csname @ps@\scrlayer@current@pagestyle @twosidehook\endcsname
{#1}%
\FamilyKeyStateProcessed
}
%
% \end{macrocode}
% \end{macro}^^A \@ps@twosidehook
% \end{option}^^A onpstwoside
% \begin{option}{onpsoddpage}
% \begin{macro}{\@ps@oddpagehook}
% \begin{description}
% \item[\texttt{=\meta{code}}:] executes \meta{code} after
% \Option{ononeside}'s or \Option{ontwoside}'s \meta{code} whenever the
% output of a layer stack of an odd page is initialised. Note, that
% \meta{code} must not result in any page output. Otherwise the output of
% the layer stack will be broken!
% \end{description}
% \begin{macrocode}
%<*options>
\KOMA@key{onpsoddpage}{%
\l@addto@macro{\@ps@oddpagehook}{#1}%
\FamilyKeyStateProcessed
}
%<*interface>
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpsoddpage}
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpsoddpage@default}
%
%\newcommand*{\@ps@oddpagehook}{}
%
%<*package&body>
\DefineFamilyKey[.definelayerpagestyle]{KOMAarg}{onoddpage}{%
\expandafter\l@addto@macro
\csname @ps@\scrlayer@current@pagestyle @oddpagehook\endcsname
{#1}%
\FamilyKeyStateProcessed
}
%
% \end{macrocode}
% \end{macro}^^A \@ps@oddpagehook
% \end{option}^^A onpsoddpage
% \begin{option}{onpsevenpage}
% \begin{macro}{\@ps@evenpagehook}
% \begin{description}
% \item[\texttt{=\meta{code}}:] executes \meta{code} after
% \Option{ononeside}'s or \Option{ontwoside}'s \meta{code} whenever the
% output of a layer stack of an even page is initialised. Note, that
% \meta{code} must not result in any page output. Otherwise the output of
% the layer stack will be broken!
% \end{description}
% \begin{macrocode}
%<*options>
\KOMA@key{onpsevenpage}{%
\l@addto@macro{\@ps@evenpagehook}{#1}%
\FamilyKeyStateProcessed
}
%<*interface>
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpsevenpage}
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpsevenpage@default}
%
%\newcommand*{\@ps@evenpagehook}{}
%
%<*package&body>
\DefineFamilyKey[.definelayerpagestyle]{KOMAarg}{onevenpage}{%
\expandafter\l@addto@macro
\csname @ps@\scrlayer@current@pagestyle @evenpagehook\endcsname
{#1}%
\FamilyKeyStateProcessed
}
%
% \end{macrocode}
% \end{macro}^^A \@ps@evenpagehook
% \end{option}^^A onpsevenpage
% \begin{option}{onpsfloatpage}
% \begin{macro}{\@ps@floatpagehook}
% \begin{description}
% \item[\Option{=\meta{code}}:] executes \meta{code} after
% \Option{onoddpage}'s or \Option{onevenpage}'s \meta{code} whenever a float
% column has been made (usually those pages are float pages).
% \end{description}
% \begin{macrocode}
%<*options>
\KOMA@key{onpsfloatpage}{%
\l@addto@macro{\@ps@floatpagehook}{#1}%
\FamilyKeyStateProcessed
}
%<*interface>
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpsfloatpage}
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpsfloatpage@default}
%
%\newcommand*{\@ps@floatpagehook}{}
%
%<*package&body>
\DefineFamilyKey[.definelayerpagestyle]{KOMAarg}{onfloatpage}{%
\expandafter\l@addto@macro
\csname @ps@\scrlayer@current@pagestyle @floatpagehook\endcsname
{#1}%
\FamilyKeyStateProcessed
}
%
% \end{macrocode}
% \end{macro}^^A \@ps@floatpagehook
% \end{option}^^A onpsfloatpage
% \begin{option}{onpsnonfloatpage}
% \begin{macro}{\@ps@nonfloatpagehook}
% \begin{description}
% \item[\Option{=\meta{code}}:] executes \meta{code} after
% \Option{onoddpage}'s or \Option{onevenpage}'s \meta{code} whenever no
% float column has been made (usually those pages aren't float pages).
% \end{description}
% \begin{macrocode}
%<*options>
\KOMA@key{onpsnonfloatpage}{%
\l@addto@macro{\@ps@nonfloatpagehook}{#1}%
\FamilyKeyStateProcessed
}
%<*interface>
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpsnonfloatpage}
\scrlayer@AddCsToInterface{%
KV@KOMA.\@currname.\@currext @onpsnonfloatpage@default}
%
%\newcommand*{\@ps@nonfloatpagehook}{}
%
%<*package&body>
\DefineFamilyKey[.definelayerpagestyle]{KOMAarg}{onnonfloatpage}{%
\expandafter\l@addto@macro
\csname @ps@\scrlayer@current@pagestyle @nonfloatpagehook\endcsname
{#1}%
\FamilyKeyStateProcessed
}
%
% \end{macrocode}
% \end{macro}^^A \@ps@nonfloatpagehook
% \end{option}^^A onpsnonfloatpage
% \begin{option}{onpsbackground}
% \begin{macro}{\@ps@backgroundhook}
% \begin{description}
% \item[\texttt{=\meta{code}}:] executes \meta{code} after
% \Option{onfloatpage}'s or \Option{onnonfloatpage}'s \meta{code} whenever
% the output of a background layer stack is initialised. Note, that
% \meta{code} must not result in any page output. Otherwise the output of
% the layer stack will be broken!
% \end{description}
% \begin{macrocode}
%<*options>
\KOMA@key{onpsbackground}{%
\l@addto@macro{\@ps@backgroundhook}{#1}%
\FamilyKeyStateProcessed
}
%<*interface>
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpsbackground}
\scrlayer@AddCsToInterface{%
KV@KOMA.\@currname.\@currext @onpsbackground@default}
%
%\newcommand*{\@ps@backgroundhook}{}
%
%<*package&body>
\DefineFamilyKey[.definelayerpagestyle]{KOMAarg}{onbackground}{%
\expandafter\l@addto@macro
\csname @ps@\scrlayer@current@pagestyle @backgroundhook\endcsname
{#1}%
\FamilyKeyStateProcessed
}
%
% \end{macrocode}
% \end{macro}^^A \@ps@backgroundhook
% \end{option}^^A onbackground
% \begin{option}{onpsforeground}
% \begin{macro}{\@ps@foregroundhook}
% \begin{description}
% \item[\texttt{=\meta{code}}:] executes \meta{code} after
% \Option{onfloatpage}'s or \Option{onnonfloatpage}'s \meta{code} whenever
% the output of a foreground layer stack is initialised. Note, that
% \meta{code} must not result in any page output. Otherwise the output of
% the layer stack will be broken!
% \end{description}
% \begin{macrocode}
%<*options>
\KOMA@key{onpsforeground}{%
\l@addto@macro{\@ps@foregroundhook}{#1}%
\FamilyKeyStateProcessed
}
%<*interface>
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @onpsforeground}
\scrlayer@AddCsToInterface{%
KV@KOMA.\@currname.\@currext @onpsforeground@default}
%
%\newcommand*{\@ps@foregroundhook}{}
%
%<*package&body>
\DefineFamilyKey[.definelayerpagestyle]{KOMAarg}{onforeground}{%
\expandafter\l@addto@macro
\csname @ps@\scrlayer@current@pagestyle @foregroundhook\endcsname
{#1}%
\FamilyKeyStateProcessed
}
%
% \end{macrocode}
% \end{macro}^^A \@psforegroundhook
% \end{option}^^A onpsforeground
% \begin{macrocode}
%<*package&body>
\newcommand*{\DeclarePageStyleByLayers}[3][]{%
\edef\scrlayer@current@pagestyle{\GetRealPageStyle{#2}}%
\expandafter\scrlayer@declare@ps@by@layers\expandafter{%
\scrlayer@current@pagestyle
}{#1}{#3}%
}
% \end{macrocode}
% \begin{macro}{\scrlayer@declare@ps@by@layers}
% Needed, because of page style aliases. Same arguments like
% \cs{DeclarePageStyleByLayers} but, \#1 is the name of the page style, \#2 is
% the list of options and \#3 is still the list of layers.
% \begin{macrocode}
\newcommand*{\scrlayer@declare@ps@by@layers}[3]{%
\@namedef{@ps@#1@initialhook}{\@ps@initialhook}%
\@namedef{@ps@#1@hook}{\@ps@hook}%
\@namedef{@ps@#1@backgroundhook}{\@ps@backgroundhook}%
\@namedef{@ps@#1@foregroundhook}{\@ps@foregroundhook}%
\@namedef{@ps@#1@oddpagehook}{\@ps@oddpagehook}%
\@namedef{@ps@#1@evenpagehook}{\@ps@evenpagehook}%
\@namedef{@ps@#1@onesidehook}{\@ps@onesidehook}%
\@namedef{@ps@#1@twosidehook}{\@ps@twosidehook}%
\@namedef{@ps@#1@floatpagehook}{\@ps@floatpagehook}%
\@namedef{@ps@#1@nonfloatpagehook}{\@ps@nonfloatpagehook}%
\FamilyExecuteOptions[.definelayerpagestyle]{KOMAarg}{#2}%
\@namedef{ps@#1}{%
\renewcommand*{\currentpagestyle}{#1}%
\@nameuse{@ps@@everystyle@@initialhook}%
\@nameuse{@ps@#1@initialhook}%
\renewcommand*{\currentpagestyle}{#1}%
\renewcommand*{\@oddhead}{%
\begingroup
\let\headmark\rightmark
\@nameuse{@ps@@everystyle@@hook}%
\@nameuse{@ps@#1@hook}%
\@nameuse{@ps@@everystyle@@\if@twoside two\else one\fi sidehook}%
\@nameuse{@ps@#1@\if@twoside two\else one\fi sidehook}%
\@nameuse{@ps@@everystyle@@oddpagehook}%
\@nameuse{@ps@#1@oddpagehook}%
\@nameuse{@ps@@everystyle@@\if@fcolmade\else non\fi floatpagehook}%
\@nameuse{@ps@#1@\if@fcolmade\else non\fi floatpagehook}%
\@nameuse{@ps@@everystyle@@backgroundhook}%
\@nameuse{@ps@#1@backgroundhook}%
\parbox[t][\headheight][t]{\linewidth}{%
\vskip \dimexpr -\topmargin-1in
-\headheight
-\ht\strutbox\relax
\hskip \dimexpr -\oddsidemargin-1in\relax
\strut\makebox[\z@][l]{%
\ForEachLayerOfPageStyle{@everystyle@}{%
\scrlayer@do@page@style@element@layer{background}{odd}%
{########1}%
}%
\ForEachLayerOfPageStyle{#1}{%
\scrlayer@do@page@style@element@layer{background}{odd}%
{########1}%
}%
}%
}%
\endgroup
}%
\renewcommand*{\@evenhead}{%
\begingroup
\let\headmark\leftmark
\@nameuse{@ps@@everystyle@@hook}%
\@nameuse{@ps@#1@hook}%
\@nameuse{@ps@@everystyle@@twosidehook}%
\@nameuse{@ps@#1@twosidehook}%
\@nameuse{@ps@@everystyle@@evenpagehook}%
\@nameuse{@ps@#1@evenpagehook}%
\@nameuse{@ps@@everystyle@@\if@fcolmade\else non\fi floatpagehook}%
\@nameuse{@ps@#1@\if@fcolmade\else non\fi floatpagehook}%
\@nameuse{@ps@@everystyle@@backgroundhook}%
\@nameuse{@ps@#1@backgroundhook}%
\parbox[t][\headheight][t]{\linewidth}{%
\vskip \dimexpr -\topmargin-1in
-\headheight
-\ht\strutbox\relax
\hskip \dimexpr-\evensidemargin-1in\relax
\strut\makebox[\z@][l]{%
\ForEachLayerOfPageStyle{@everystyle@}{%
\scrlayer@do@page@style@element@layer{background}{even}%
{########1}%
}%
\ForEachLayerOfPageStyle{#1}{%
\scrlayer@do@page@style@element@layer{background}{even}%
{########1}%
}%
}%
}%
\endgroup
}%
\renewcommand*{\@oddfoot}{%
\begingroup
\let\headmark\rightmark
\@nameuse{@ps@@everystyle@@hook}%
\@nameuse{@ps@#1@hook}%
\@nameuse{@ps@@everystyle@@\if@twoside two\else one\fi sidehook}%
\@nameuse{@ps@#1@\if@twoside two\else one\fi sidehook}%
\@nameuse{@ps@@everystyle@@oddpagehook}%
\@nameuse{@ps@#1@oddpagehook}%
\@nameuse{@ps@@everystyle@@\if@fcolmade\else non\fi floatpagehook}%
\@nameuse{@ps@#1@\if@fcolmade\else non\fi floatpagehook}%
\@nameuse{@ps@@everystyle@@foregroundhook}%
\@nameuse{@ps@#1@foregroundhook}%
\parbox[t][\headheight][t]{\linewidth}{%
\vskip \dimexpr -\topmargin-1in
-\headheight
-\headsep
-\textheight
-\footskip
-\ht\strutbox\relax
\hskip \dimexpr -\oddsidemargin-1in\relax
\strut\makebox[\z@][l]{%
\ForEachLayerOfPageStyle{@everystyle@}{%
\scrlayer@do@page@style@element@layer{foreground}{odd}%
{########1}%
}%
\ForEachLayerOfPageStyle{#1}{%
\scrlayer@do@page@style@element@layer{foreground}{odd}%
{########1}%
}%
}%
}%
\endgroup
}%
\renewcommand*{\@evenfoot}{%
\begingroup
\let\headmark\leftmark
\@nameuse{@ps@@everystyle@@hook}%
\@nameuse{@ps@#1@hook}%
\@nameuse{@ps@@everystyle@@twosidehook}%
\@nameuse{@ps@#1@twosidehook}%
\@nameuse{@ps@@everystyle@@evenpagehook}%
\@nameuse{@ps@#1@evenpagehook}%
\@nameuse{@ps@@everystyle@@\if@fcolmade\else non\fi floatpagehook}%
\@nameuse{@ps@#1@\if@fcolmade\else non\fi floatpagehook}%
\@nameuse{@ps@@everystyle@@foregroundhook}%
\@nameuse{@ps@#1@foregroundhook}%
\parbox[t][\headheight][t]{\linewidth}{%
\vskip \dimexpr -\topmargin-1in
-\headheight
-\headsep
-\textheight
-\footskip
-\ht\strutbox\relax
\hskip \dimexpr-\evensidemargin-1in\relax
\strut\makebox[\z@][l]{%
\ForEachLayerOfPageStyle{@everystyle@}{%
\scrlayer@do@page@style@element@layer{foreground}{even}%
{########1}%
}%
\ForEachLayerOfPageStyle{#1}{%
\scrlayer@do@page@style@element@layer{foreground}{even}%
{########1}%
}%
}%
}%
\endgroup
}%
}%
\@namedef{@ps@#1@layers}{}%
\@for \reserved@a:=#3\do {%
\ifstr\reserved@a\@empty{}{%
\expandafter\@cons\csname @ps@#1@layers\endcsname{{\reserved@a}}%
}%
}%
}
%
% \end{macrocode}
% \end{macro}^^A \scrlayer@declare@ps@by@layers
%
% \begin{macro}{\ForEachLayerOfPageStyle}
% \begin{description}
% \item[\Parameter{string}:] a valid page style (must be fully expandable
% and expand to the name of a existing page style); note, that currently
% no exists test will be done.
% \item[\Parameter{code}:] any macro definition body with usage of at most
% one argument (\texttt{\#1}), that will be replaced by the layer's name
% \end{description}
% Do the given \meta{code} for each layer of the page style
% \meta{string}. Note, that the expansion of \meta{code} will be done inside
% a group.
% \begin{macrocode}
%<*package&body>
\newcommand*{\ForEachLayerOfPageStyle}[2]{%
\begingroup
\edef\reserved@a{\GetRealPageStyle{#1}}%
\def\@elt##1{\ifscrlayer@deactivate@layers\else #2\fi}%
\@nameuse{@ps@\reserved@a @layers}%
\endgroup
}
%
% \end{macrocode}
% \begin{option}{deactivatepagestylelayers}
% \begin{macro}{\ifscrlayer@deactivate@layers}
% \begin{description}
% \item[\Parameter{simple switch}:] whether or not
% \Macro{ForEachLayerOfPageStyle} should ignore the layers.
% \end{description}
% This is a global \KOMAScript{} options. Several other definitions and at
% least the usage of the page style will ignore the layers if
% \Macro{ForEachLayerOfPageStyle} ignores them. So this is something like:
% hide the layers. It may also be useful inside the code for the hooks
% described above, because hooks may used to deactivate the layers with this
% option too.
% \begin{macrocode}
%<*options>
\KOMA@ifkey{deactivatepagestylelayers}{scrlayer@deactivate@layers}
%<*interface>
\scrlayer@AddCsToInterface{%
KV@KOMA.\@currname.\@currext @deactivatepagestylelayers}
\scrlayer@AddCsToInterface{%
KV@KOMA.\@currname.\@currext @deactivatepagestylelayers@default}
%
%
% \end{macrocode}
% \end{macro}^^A \ifscrlayer@deactivate@layers
% \end{option}^^A deactivatepagestylelayers
% \end{macro}^^A \ForEachLayerOfPageStyle
%
% \begin{macro}{\scrlayer@do@page@style@element@layer}
% Helper macro to show one layer. First argument is either ``background'' or
% ``foreground'', second argument is either ``odd'' or ``even'', and third
% argument is the name of the layer. Note, that in draft mode for every layer
% will be shown also a \cs{layercontentsmeasure}.
% \begin{macrocode}
%<*package&body>
\newcommand*{\scrlayer@do@page@style@element@layer}[3]{%
\begingroup
\expandafter\ifx\csname if@scr@l@#3@\if@fcolmade\else non\fi floatpage%
\expandafter\endcsname\csname iftrue\endcsname
\expandafter\ifx\csname if@scr@l@#3@\if@twoside two\else one\fi side%
\expandafter\endcsname\csname iftrue\endcsname
\expandafter
\ifx\csname if@scr@l@#3@#1\expandafter\endcsname
\csname iftrue\endcsname
\expandafter
\ifx\csname if@scr@l@#3@#2\expandafter\endcsname
\csname iftrue\endcsname
\ifscrlayer@draft
\scr@layerbox(\csname scr@l@#3@x\endcsname,%
\csname scr@l@#3@y\endcsname)%
(\csname scr@l@#3@w\endcsname,%
\csname scr@l@#3@h\endcsname)%
[\csname scr@l@#3@align\endcsname]%
{\layercontentsmeasure}%
\fi
\scr@layerbox(\csname scr@l@#3@x\endcsname,%
\csname scr@l@#3@y\endcsname)%
(\csname scr@l@#3@w\endcsname,%
\csname scr@l@#3@h\endcsname)%
[\csname scr@l@#3@align\endcsname]%
{\csname scr@l@#3@contents\endcsname}%
\fi
\fi
\fi
\fi
\endgroup
}
% \end{macrocode}
% \begin{macro}{\scr@layerbox}
% \begin{macro}{\scr@@layerbox}
% The layer box is used to output a layer in \cs{@oddhead}, \cs{@evenhead},
% \cs{@oddfoot}, or \cs{@evenfoot}. Is has two pairs of arguments: ($x,y$)
% and ($w,h$), where $x$ is the distance from left paper edge, $y$ is the
% distance from the topmost edge of paper, $w$ is the width of the box and $h$
% is the height of the box. The fifth argument is an optional vertical and
% horizontal alignment of the box. It may be a combination of the alignment
% characters described above. The sixth and last argument is the contents of
% the layer, to be placed into the last argument of the innermost
% \cs{parbox}.
% \begin{macrocode}
\def\scr@layerbox(#1,#2)(#3,#4){%
\@ifnextchar [%]
{\scr@@layerbox(#1,#2)(#3,#4)}{\scr@@layerbox(#1,#2)(#3,#4)[]}%
}
\def\scr@@layerbox(#1,#2)(#3,#4)[#5]#6{%
\begingroup
\edef\layerxoffset{#1}%
\edef\layeryoffset{#2}%
\edef\layerwidth{#3}%
\edef\layerheight{#4}%
\def\scr@l@valign{t}%
\def\scr@l@halign{l}%
\edef\reserved@b{#5}%
\expandafter\@tfor\expandafter\reserved@a\expandafter:\expandafter=%
\reserved@b\do{%
\if t\reserved@a
\def\scr@l@valign{t}%
\else
\if c\reserved@a
\def\scr@l@valign{c}%
\def\scr@l@halign{c}%
\else
\if b\reserved@a
\def\scr@l@valign{b}%
\else
\if l\reserved@a
\def\scr@l@halign{l}%
\else
\if r\reserved@a
\def\scr@l@halign{r}%
\else
\PackageWarning{scrlayer}{%
Unknown alignment `\reserved@a' ignored}%
\fi
\fi
\fi
\fi
\fi
}%
\parbox[t][\z@][t]{\z@}{%
\vskip\layeryoffset
\if b\scr@l@valign\vskip-\layerheight\fi
\if c\scr@l@valign\vskip-.5\dimexpr\layerheight\relax\fi
\makebox[\z@][l]{%
\hskip\layerxoffset
\makebox[\z@][\scr@l@halign]{%
\parbox[\scr@l@valign][\layerheight][\scr@l@valign]{\layerwidth}{%
\vskip\z@\strut{%
\ifscrlayer@forceignoreuppercase
\expandafter\let\csname MakeUppercase \endcsname\@firstofone
\let\MakeUppercase\@firstofone
\let\uppercase\@firstofone
\fi
#6%
}\strut\vskip\z@
}%
}%
}%
}%
\endgroup
}
%
% \end{macrocode}
% \end{macro}^^A \scr@@layerbox
% \end{macro}^^A \scr@layerbox
% \begin{option}{draft}
% \begin{macro}{\ifscrlayer@draft}
% \begin{description}
% \item[\Parameter{simple switch}:] whether or not to use the draft mode,
% that, i.e., activates visualisation of the layers.
% \end{description}
% When option is set, every layer is shown twice: one time with it's own
% contents and one time with contents \Macro{layercontentsmeasure}.
% \begin{macrocode}
%<*options>
\KOMA@ifkey{draft}{scrlayer@draft}
%<*interface>
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @draft}
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @draft@default}
%
%
% \end{macrocode}
% \end{macro}^^A \ifscrlayer@draft
% \end{option}^^A draft
% \end{macro}^^A \scrlayer@do@page@style@element@layer
% \end{macro}^^A \DeclarePageStyleByLayers
%
%
% \begin{macro}{\DeclareNewPageStyleByLayers}
% Arguments like \Macro{DeclarePageStyleByLayers}; results in error if the page
% style has been defined (or declared) already.
% \begin{macro}{\ProvidePageStyleByLayers}
% Arguments like \Macro{DeclarePageStyleByLayers}; doesn't define anything it
% the page style has been defined (or declared) already.
% \begin{macro}{\RedeclarePageStyleByLayers}
% Arguments like \Macro{DeclarePageStyleByLayers}; results in error if the page
% style hasn't been defined (or declared) already.
% \begin{macrocode}
%<*package&body>
\newcommand*{\DeclareNewPageStyleByLayers}[2][]{%
\@ifundefined{ps@#2}{}{%
\PackageError{scrlayer}{%
Page style `#2' already defined%
}{%
You may use \string\DeclareNewPageStyleByLayers\space to declare a new
page style only\MessageBreak
if that page style hasn't been declared or defined before.\MessageBreak
You may use either \string\ProvidePageStyleByLayers\space to declare the
page style only\MessageBreak
if it hasn't been declared or defined before, or
\string\RedeclarePageStyleByLayers\MessageBreak
to overwrite the former
declaration or definition of the page style%
\@ifundefined{@ps@#2@layers}{}{,\MessageBreak
or \string\AddLayersToPageStyle\space to add further layers to the
already declared\MessageBreak
page style, or \string\RemoveLayersFromPageStyle\space to remove
layers from the\MessageBreak
already declared page style}.\MessageBreak
Nevertheless, if you'll continue, the page style will be
overwritten\MessageBreak
by the new declaration.%
}%
}%
\DeclarePageStyleByLayers[{#1}]{#2}%
}
\newcommand*{\ProvidePageStyleByLayers}[3][]{%
\@ifundefined{ps@#2}{%
\DeclarePageStyleByLayers[{#1}]{#2}{#3}%
}{%
%<*trace>
\PackageInfo{scrlayer}{%
\string\ProvidePageStyleByLayers{#2}{#3} ignored,\MessageBreak
because page style `#2'\MessageBreak
already exists%
}%
%
}%
}
\newcommand*{\RedeclarePageStyleByLayers}[2][]{%
\@ifundefined{ps@#2}{%
\PackageError{scrlayer}{%
Page style `#2' not yet defined%
}{%
You may use \string\RedeclarePageStyleByLayers\space to declare a page
style only\MessageBreak
if that page style has already been declared or defined.\MessageBreak
You may use either \string\DeclareNewPageStyleByLayers,
\string\DeclarePageStyleByLayers,\MessageBreak
or \string\ProvidePageStyleByLayers\space to declare that not yet
defined page style.\MessageBreak
Nevertheless, if you'll continue, the page style will be declared.%
}%
}{}%
\DeclarePageStyleByLayers[{#1}]{#2}%
}
%
% \end{macrocode}
% \end{macro}^^A \RedeclarePageStyleByLayers
% \end{macro}^^A \ProvidePageStyleByLayers
% \end{macro}^^A \DeclareNewPageStyleByLayers
%
% We also declare page style \Pagestyle{@everystyle@} by default. You should
% not use this page style as an real page style (even not as the empty
% one). The layers of this page style will be used by every other layer page
% style. An we re-declare \Pagestyle{empty} to be a layer page style.
% \begin{macrocode}
%<*package&final>
\DeclareNewPageStyleByLayers{@everystyle@}{}
\RedeclarePageStyleByLayers{empty}{}
%
% \end{macrocode}
%
% \begin{macro}{\AddLayersToPageStyle}
% \begin{macro}{\AddLayersAtBeginOfPageStyle}
% \begin{macro}{\AddLayersAtEndOfPageStyle}
% \begin{macro}{\RemoveLayersFromPageStyle}
% \begin{description}
% \item[\Parameter{string}:] the name of the page style to be modified (must
% be expandable and result in a string).
% \item[\Parameter{string list}:] comma separated list of layer names (must
% be expandable and result in strings); first in the list will be added
% first.
% \end{description}
% Change the layer list of a given page style. The differences between the
% commands are:
% \begin{description}
% \item[\Macro{AddLayersToPageStyle}:] first in the \meta{string list} will
% be added first at the end.
% \item[\Macro{AddLayersAtBeginOfPageStyle}:] first in the \meta{string list}
% will be added first at the start. Note, that this will result in changing
% the order of the layers in \meta{string list}.
% \item[\Macro{AddLayerAtEndOfPageStyle}:] same like
% \Macro{AddLayerToPageStyle}.
% \item[\Macro{RemoveLayersFromPageStyle}:] remove the layers from the page
% style's layer list.
% \end{description}
% \begin{macrocode}
%<*package&body>
\newcommand*{\AddLayersToPageStyle}[2]{%
\edef\reserved@b{\GetRealPageStyle{#1}}%
\IfLayerPageStyleExists{\reserved@b}{%
\@for \reserved@a:=#2\do {%
\ifstr\reserved@a\@empty{}{%
\expandafter\@cons\csname @ps@\reserved@b @layers\endcsname
{{\reserved@a}}%
}%
}%
}{%
\scrlayer@lpm@error{#1}{adding layers}%
}%
}
\newcommand*{\AddLayersAtEndOfPageStyle}{%
\AddLayersToPageStyle
}
\newcommand*{\AddLayersAtBeginOfPageStyle}[2]{%
\begingroup
\let\@cons\@snoc
\AddLayersToPageStyle{#1}{#2}%
\endgroup
}
% \end{macrocode}
% \begin{macro}{\@snoc}
% \cs{@snoc} is a helper macro similar to \cs{@cons} from \LaTeX{} kernel, but
% it appends at the front instead of the end.
% \begin{macrocode}
\newcommand*{\@snoc}[2]{%
\begingroup\let\@elt\relax\xdef#1{\@elt #2#1}\endgroup
}
% \end{macrocode}
% \end{macro}^^A \@snoc
% \begin{macrocode}
\newcommand*{\RemoveLayersFromPageStyle}[2]{%
\edef\reserved@b{\GetRealPageStyle{#1}}%
\IfLayerPageStyleExists{#1}{%
\@for \reserved@a:=#2\do {%
\ifstr\reserved@a\@empty{}{%
\expandafter\remove@layer@from@page@style\expandafter{\reserved@a}%
{\reserved@b}%
}%
}%
}{%
\scrlayer@lpm@error{#1}{removing layers}%
}%
}
% \end{macrocode}
% \begin{macro}{\remove@layer@from@page@style}
% Helper macro to remove exactly one layer (arg 1) from a page style (arg 2).
% \begin{macrocode}
\newcommand*{\remove@layer@from@page@style}[2]{%
\begingroup
\expandafter\let\expandafter\reserved@a\csname @ps@#2@layers\endcsname
\@namedef{@ps@#2@layers}{}%
\def\@elt##1{%
\ifstr{#1}{##1}{}{%
\expandafter\@cons\csname @ps@#2@layers\endcsname{{##1}}%
}%
}\reserved@a
\endgroup
}
% \end{macrocode}
% \end{macro}^^A \remoce@layer@from@page@style
% \begin{macro}{\scrlayer@lpm@error}
% \begin{description}
% \item[\Parameter{string}:] the name of the page style to be modified (must
% be expandable and result in a string).
% \item[\Parameter{string}:] the kind of modification, that isn't allowed
% (must be expandable and result in a string).
% \end{description}
% Show an error because of page style it either not a defined or not a layer
% page style.
% \begin{macrocode}
\newcommand*{\scrlayer@lpm@error}[2]{%
\PackageError{scrlayer}{`#1' is not a layer page style}{%
\scr@ifundefinedorrelax{ps@#1}{%
Page style `#1' is not defined,
}{%
Page style `#1' is not a layer page style,
}%
but #2\MessageBreak
may be used only for layer page styles declared using\MessageBreak
\string\DeclarePageStyleByLayers,
\string\DeclareNewPageStyleByLayers,\MessageBreak
of \string\ProvidePageStyleByLayers.\MessageBreak
If you'll continue, your operation will be ignored.%
}%
}
%
% \end{macrocode}
% \end{macro}^^A \scrlayer@lpm@error
% \end{macro}^^A \RemoveLayersFromPageStyle
% \end{macro}^^A \AddLayersAtEndOfPageStyle
% \end{macro}^^A \AddLayersAtBeginOfPageStyle
% \end{macro}^^A \AddLayersToPageStyle
%
% \begin{macro}{\AddLayersToPageStyleBeforeLayer}
% \begin{macro}{\AddLayersToPageStyleAfterLayer}
% \begin{description}
% \item[\Parameter{string}:] the name of the page style to be modified (must
% be expandable and result in a string).
% \item[\Parameter{string list}:] comma separated list of layer names (must
% be expandable and result in strings); first in the list will be added
% first.
% \item[\Parameter{string}:] the name of the layer before
% (\Macro{AddLayersToPageStyleBeforeLayer}) or after
% (\Macro{AddLayersToPageStyleAfterLayer}) that the layers of the list
% should be added.
% \end{description}
% Note: If the layer from third argument is not part of the page style's layer
% list, the new layers won't be added anywhere.
% \begin{macrocode}
%<*package&body>
\newcommand*{\AddLayersToPageStyleAfterLayer}[3]{%
\edef\reserved@b{\GetRealPageStyle{#1}}%
\IfLayerPageStyleExists{\reserved@b}{%
\begingroup
\expandafter\let\expandafter\reserved@a
\csname @ps@\reserved@b @layers\endcsname
\@namedef{@ps@\reserved@b @layers}{}%
\def\@elt##1{%
\ifstr{##1}\@empty{}{%
\expandafter\@cons\csname @ps@\reserved@b @layers\endcsname{{##1}}%
\ifstr{##1}{#3}{%
\@for \reserved@a:=#2\do {%
\ifstr\reserved@a\@empty{}{%
\expandafter\@cons\csname @ps@\reserved@b @layers\endcsname
{{\reserved@a}}%
}%
}%
}{}%
}%
}%
\reserved@a
\endgroup
}{%
\scrlayer@lpm@error{#1}{adding layers}%
}%
}
\newcommand*{\AddLayersToPageStyleBeforeLayer}[3]{%
\edef\reserved@b{\GetRealPageStyle{#1}}%
\IfLayerPageStyleExists{\reserved@b}{%
\begingroup
\expandafter\let\expandafter\reserved@a
\csname @ps@\reserved@b @layers\endcsname
\@namedef{@ps@\reserved@b @layers}{}%
\def\@elt##1{%
\ifstr{##1}\@empty{}{%
\ifstr{##1}{#3}{%
\@for \reserved@a:=#2\do {%
\ifstr\reserved@a\@empty{}{%
\expandafter\@cons\csname @ps@\reserved@b @layers\endcsname
{{\reserved@a}}%
}%
}%
}{}%
\expandafter\@cons\csname @ps@#1@layers\endcsname{{##1}}%
}%
}%
\reserved@a
\endgroup
}{%
\scrlayer@lpm@error{#1}{adding layers}%
}%
}
%
% \end{macrocode}
% \end{macro}^^A \AddLayersToPageStyleAfterLayer
% \end{macro}^^A \AddLayersToPageStyleBeforeLayer
%
%
% \begin{macro}{\UnifyLayersAtPageStyle}
% \begin{description}
% \item[\Parameter{string}:] the name of the page style to be unified (must
% be expandable and result in a string).
% \end{description}
% Remove doublets of layers from a page style.
% \begin{macrocode}
%<*package&body>
\newcommand*{\UnifyLayersAtPageStyle}[1]{%
\edef\reserved@b{\GetRealPageStyle{#1}}%
\IfLayerPageStyleExists{\reserved@b}{%
\expandafter\let\expandafter\reserved@a
\csname @ps@\reserved@b @layers\endcsname
\@namedef{@ps@\reserved@b @layers}{}%
\begingroup
\def\@elt##1{%
\ifstr{##1}\@empty{}{%
\remove@layer@from@page@style{##1}{\reserved@b}%
\expandafter\@cons\csname @ps@\reserved@b @layers\endcsname{{##1}}%
}%
}%
\reserved@a
\endgroup
}{%
\scrlayer@lpm@error{#1}{unifying}%
}%
}
%
% \end{macrocode}
% \end{macro}^^A \UnifyLayersAtPageStyle
%
% \begin{macro}{\ModifyLayerPageStyleOptions}
% \begin{macro}{\AddToLayerPageStyleOptions}
% \begin{description}
% \item[\Parameter{string}:] the name of the page style to be modified (must
% be expandable and result in a string).
% \item[\Parameter{option list}:] comma separated list of named page
% style options. You may use any of the options provided for
% \Macro{DeclarePageStyle}.
% \end{description}
% \Macro{ModifyLayerPageStyleOptions} replaces the options and only the
% options from the list by their new
% values. \Macro{AddToLayerPageStyleOptions} adds the new values to the
% already given.
% \begin{macrocode}
%<*package&body>
\newcommand*{\ModifyLayerPageStyleOptions}[2]{%
\edef\reserved@a{\GetRealPageStyle{#1}}%
\IfLayerPageStyleExists{#1}{%
\expandafter\scrlayer@modify@layer@ps@options\expandafter{%
\reserved@a
}{#2}%
}{%
\scrlayer@lpm@error{#1}{modifying}%
}%
}
% \end{macrocode}
% \begin{macro}{\scrlayer@modify@layer@ps@options}
% Helper needed because of alias page styles. Same parameters like
% \cs{ModifyLayerPageStyleOptions}
% \begin{macrocode}
\newcommand*{\scrlayer@modify@layer@ps@options}[2]{%
\begingroup
\def\scrlayer@current@pagestyle{#1}%
\@namedef{@ps@#1@initialhook}{}%
\@namedef{@ps@#1@hook}{}%
\@namedef{@ps@#1@backgroundhook}{}%
\@namedef{@ps@#1@foregroundhook}{}%
\@namedef{@ps@#1@oddpagehook}{}%
\@namedef{@ps@#1@evenpagehook}{}%
\@namedef{@ps@#1@onesidehook}{}%
\@namedef{@ps@#1@twosidehook}{}%
\@namedef{@ps@#1@floatpagehook}{}%
\@namedef{@ps@#1@nonfloatpagehook}{}%
\FamilyExecuteOptions[.definelayerpagestyle]{KOMAarg}{#2}%
\def\reserved@a{\endgroup}%
\def\@sls@##1{%
\expandafter\let\expandafter\reserved@b\csname @ps@#1@##1hook\endcsname
\ifx\reserved@b\@empty\else
\l@addto@macro\reserved@a{\@namedef{@ps@#1@##1hook}}%
\expandafter\l@addto@macro\expandafter\reserved@a\expandafter{%
\expandafter{%
\reserved@b
}%
}%
\fi
}%
\@sls@{initial}%
\@sls@{}%
\@sls@{background}%
\@sls@{foreground}%
\@sls@{oddpage}%
\@sls@{evenpage}%
\@sls@{oneside}%
\@sls@{twoside}%
\@sls@{floatpage}%
\@sls@{nonfloatpage}%
\reserved@a
}
% \end{macrocode}
% \end{macro}^^A \scrlayer@modify@layer@ps@options
% \begin{macrocode}
\newcommand*{\AddToLayerPageStyleOptions}[2]{%
\IfLayerPageStyleExists{#1}{%
\def\scrlayer@current@pagestyle{#1}%
\FamilyExecuteOptions[.definelayerpagestyle]{KOMAarg}{#2}%
}{%
\scrlayer@lpm@error{#1}{modifying}%
}%
}
%
% \end{macrocode}
% \end{macro}^^A \AddToLayerPageStyleOptions
% \end{macro}^^A \ModifyLayerPageStyleOptions
%
% \begin{macro}{\DeclarePageStyleAlias}
% \begin{macro}{\DeclareNewPageStyleAlias}
% \begin{macro}{\ProvidePageStyleAlias}
% \begin{macro}{\RedeclarePageStyleAlias}
% \begin{description}
% \item[\Parameter{string}:] The name of the page style to be declared
% (must be expandable and result in a string).
% \item[\Parameter{string}:] The name of the existing page style
% (must be expandable and result in a string).
% \end{description}
% \begin{macrocode}
%<*package&body>
\newcommand*{\DeclarePageStyleAlias}[2]{%
\edef\reserved@a{\GetRealPageStyle{#2}}%
\scr@ifundefinedorrelax{ps@\reserved@a}{%
\PackageError{scrlayer}{unknown real page style `#2'}{%
You've tried to declare an alias for page style `#2',\MessageBreak
but the real page style of `#2' is undefined.\MessageBreak
You can define aliases, only if the real page style has been
defined.\MessageBreak
If you'll continue, the declaration will be ignored.%
}%
\DestroyRealLayerPageStyle{#1}%
\DestroyLayerAlias{#1}%
}{%
\@namedef{@ps@#1@alias}{#2}%
\@namedef{ps@#1}{\pagestyle{\@nameuse{@ps@#1@alias}}}%
}%
}
\newcommand*{\DeclareNewPageStyleAlias}[1]{%
\@ifundefined{ps@#1}{}{%
\PackageError{scrlayer}{%
Page style `#1' already defined%
}{%
You may use \string\DeclareNewPageStyleAlias\space to declare a new
page style only\MessageBreak
if that page style hasn't been declared or defined before.\MessageBreak
You may use either \string\ProvidePageStyleAlias\space to declare the
page style only\MessageBreak
if it hasn't been declared or defined before, or
\string\RedeclarePageStyleAlias\MessageBreak
to overwrite the former declaration or definition of the page
style\MessageBreak
Nevertheless, if you'll continue, the page style will be
overwritten\MessageBreak
by the new alias.%
}%
}%
\DeclarePageStyleAlias{#1}%
}
\newcommand*{\ProvidePageStyleAlias}[2]{%
\@ifundefined{ps@#1}{%
\DeclarePageStyleAlias{#1}{#2}%
}{%
%<*trace>
\PackageInfo{scrlayer}{%
\string\ProvidePageStyleAlias{#1}{#2} ignored,\MessageBreak
because page style `#1' already\MessageBreak
exists%
}%
%
}%
}
\newcommand*{\RedeclarePageStyleAlias}[1]{%
\@ifundefined{ps@#1}{%
\PackageError{scrlayer}{%
Page style `#1' not yet defined%
}{%
You may use \string\RedeclarePageStyleAlias\space to declare a page
style only\MessageBreak
if that page style has already been declared or defined.\MessageBreak
You may use either \string\DeclareNewPageStyleAlias,
\string\DeclarePageStyleAlias,\MessageBreak
or \string\ProvidePageStyleAlias\space to declare that not yet
defined page style.\MessageBreak
Nevertheless, if you'll continue, the page style will be declared.%
}%
}{}%
\DeclarePageStyleAlias{#1}%
}
% \end{macrocode}
% \end{macro}^^A \RedeclarePageStyleAlias
% \end{macro}^^A \ProvidePageStyleAlias
% \end{macro}^^A \DeclareNewPageStyleAlias
% \end{macro}^^A \DeclarePageStyleAlias
%
% \begin{macro}{\DestroyPageStyleAlias}
% \begin{description}
% \item[\Parameter{string}:] the name of a page style (must be
% expandable and result in a string).
% \end{description}
% \begin{macrocode}
\newcommand*{\DestroyPageStyleAlias}[1]{%
\scr@ifundefinedorrelax{@ps@#1@alias}{}{%
\expandafter\let\csname @ps@#1@alias\endcsname\relax
\expandafter\let\csname ps@#1\endcsname\relax
}%
}
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\GetRealPageStyle}
% \begin{description}
% \item[\Parameter{string}:] the name of a page style (must be
% expandable and result in a string).
% \end{description}
% Get the real name of the page style.
% \begin{macrocode}
\newcommand*{\GetRealPageStyle}[1]{%
\scr@ifundefinedorrelax{@ps@#1@alias}{#1}{%
\expandafter\GetRealPageStyle\expandafter{%
\expandafter\csname @ps@#1@alias\expandafter\endcsname\expandafter}%
}%
}
%
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\IfLayerPageStyleExists}
% \begin{macro}{\IfRealLayerPageStyleExists}
% \begin{description}
% \item[\Parameter{string}:] the name of the page style to be tested (must
% be expandable and result in a string).
% \item[\Parameter{code}:] whatever code should be expanded, if the test
% result is true.
% \item[\Parameter{code}:] whatever code should be expanded, if the test
% result is false.
% \end{description}
% Test, whether or not the page style is a declared layer page style.
% \begin{macrocode}
%<*package&body>
\newcommand*{\IfLayerPageStyleExists}[1]{%
\scr@ifundefinedorrelax{ps@#1}{%
\expandafter\@secondoftwo
}{%
\scr@ifundefinedorrelax{@ps@#1@layers}{%
\scr@ifundefinedorrelax{@ps@#1@alias}{%
\expandafter\@secondoftwo
}{%
\expandafter\IfLayerPageStyleExists\expandafter{%
\expandafter\csname @ps@#1@alias\expandafter\endcsname\expandafter}%
}%
}{%
\expandafter\@firstoftwo
}%
}%
}
\newcommand*{\IfRealLayerPageStyleExists}[1]{%
\scr@ifundefinedorrelax{ps@#1}{%
\expandafter\@secondoftwo
}{%
\scr@ifundefinedorrelax{@ps@#1@layers}{%
\expandafter\@secondoftwo
}{%
\expandafter\@firstoftwo
}%
}%
}
%
% \end{macrocode}
% \end{macro}^^A \IfRealLayerPageStyleExists
% \end{macro}^^A \IfLayerPageStyleExists
%
% \begin{macro}{\IfLayerAtPageStyle}
% \begin{macro}{\IfSomeLayersAtPageStyle}
% \begin{macro}{\IfLayersAtPageStyle}
% \begin{description}
% \item[\Parameter{string}:] the name of the page style to be tested (must
% be expandable and result in a string).
% \item[\Parameter{string}:] the name(s) of the layer(s) to be tested (must be
% expandable and result in a string).
% \item[\Parameter{code}:] whatever code should be expanded, if the test
% result is true.
% \item[\Parameter{code}:] whatever code should be expanded, if the test
% result is false.
% \end{description}
% Tests:
% \begin{description}
% \item[\Macro{IfLayerAtPageStyle}:] Test, whether or not the page style has a
% layer. The second argument is the name of one layer only!
% \item[\Macro{IfSomeLayersAtPageStyle}:] Test, whether or not the page style
% has at least one layer of a list of layers. The second argument is a comma
% separated list of layer names.
% \item[\Macro{IfLayersAtPageStyle}:] Test, whether or not the page style has
% every layer of a list of layers. The second argument is a comma separated
% list of layer names.
% \end{description}
% Note, that testing an page style, that is not a layer page style will result
% in an error and neither the third nor the fourth argument will be expanded.
% Note, that layers with empty name are only part of a layer page style
% without any layers.
%
% Note also, that with active \Option{deactivatepagestylelayers} layers are
% logically not longer part of the page styles.
% \begin{macrocode}
%<*package&body>
\newcommand*{\IfLayerAtPageStyle}[2]{%
\IfLayerPageStyleExists{#1}{%
\begingroup
\edef\reserved@a{\GetRealPageStyle{#1}}%
\@tempswafalse
\ifstr{#2}{}{%
\expandafter\ifx\csname @ps@\reserved@a @layers\endcsname\@empty
\@tempswatrue
\fi
}{%
\expandafter\ForEachLayerOfPageStyle\expandafter{%
\reserved@a}{\ifstr{##1}{#2}{\aftergroup\@tempswatrue}{}}%
}%
\if@tempswa \aftergroup\@firstoftwo \else \aftergroup\@secondoftwo \fi
\expandafter\endgroup
}{%
\scrlayer@lpm@error{#1}{testing for layers}%
\expandafter\@gobbletwo
}%
}
\newcommand*{\IfSomeLayersAtPageStyle}[2]{%
\IfLayerPageStyleExists{#1}{%
\begingroup
\@tempswafalse
\@for \reserved@a:=#2\do {%
\edef\reserved@a{\noexpand\IfLayerAtPageStyle{#1}{\reserved@a}}%
\reserved@a{\@tempswatrue}{}%
}%
\if@tempswa \aftergroup\@firstoftwo \else \aftergroup\@secondoftwo \fi
\expandafter\endgroup
}{%
\scrlayer@lpm@error{#1}{testing for layers}%
\expandafter\@gobbletwo
}%
}
\newcommand*{\IfLayersAtPageStyle}[2]{%
\IfLayerPageStyleExists{#1}{%
\begingroup
\@tempswatrue
\ifstr{#2}{}{%
\edef\reserved@a{\GetRealPageStyle{#1}}%
\expandafter\ifx\csname @scr@\reserved@a @layers\endcsname\@empty \else
\@tempswafalse
\fi
}{%
\@for \reserved@a:=#2\do {%
\edef\reserved@a{\noexpand\IfLayerAtPageStyle{#1}{\reserved@a}}%
\reserved@a{}{\@tempswafalse}%
}%
}%
\if@tempswa \aftergroup\@firstoftwo \else \aftergroup\@secondoftwo \fi
\expandafter\endgroup
}{%
\scrlayer@lpm@error{#1}{testing for layers}%
\expandafter\@gobbletwo
}%
}
%
% \end{macrocode}
% \end{macro}^^A \IfLayersAtPageStyle
% \end{macro}^^A \IfSomeLayersAtPageStyle
% \end{macro}^^A \IfLayerAtPageStyle
%
%
% \begin{macro}{\DestroyRealLayerPageStyle}
% \begin{description}
% \item[\Parameter{string}:] name of the layer page style to be destroyed.
% \end{description}
% Destroys the given layer page style but not the layers! If the page style is
% the current page style, the empty page style an empty page style will be
% activated. If the special page style is valid an the destroyed one, this
% will be removed. This command may be used, e.g., at
% \Macro{scrlayerOnAutoRemoveInterface} after destroying the layers.
% \begin{macrocode}
%<*package&body>
\newcommand*{\DestroyRealLayerPageStyle}[1]{%
\IfRealLayerPageStyleExists{#1}{%
\expandafter\let\csname @ps@#1@initialhook\endcsname\relax
\expandafter\let\csname @ps@#1@hook\endcsname\relax
\expandafter\let\csname @ps@#1@backgroundhook\endcsname\relax
\expandafter\let\csname @ps@#1@foregroundhook\endcsname\relax
\expandafter\let\csname @ps@#1@oddpagehook\endcsname\relax
\expandafter\let\csname @ps@#1@evenpagehook\endcsname\relax
\expandafter\let\csname @ps@#1@onesidehook\endcsname\relax
\expandafter\let\csname @ps@#1@twosidehook\endcsname\relax
\expandafter\let\csname @ps@#1@floatpagehook\endcsname\relax
\expandafter\let\csname @ps@#1@nonfloatpagehook\endcsname\relax
\expandafter\let\csname @ps@#1@layers\endcsname\relax
\expandafter\let\csname ps@#1\endcsname\relax
\ifstr{\currentpagestyle}{#1}{%
\def\currentpagestyle{scrlayer@empty}%
\let\@oddhead\@empty\let\@evenhead\@empty
\let\@oddfoot\@empty\let\@evenfoot\@empty
}{}%
\if@specialpage
\ifstr{\@specialstyle}{#1}{%
\global\let\@specialstyle\relax
\global\@specialpagefalse
}{}%
\fi
}{%
%<*trace>
\PackageInfo{scrlayer}{%
\string\DestroyRealLayerPageStyle{#1} ignored,\MessageBreak
because the layer page style isn't\MessageBreak
defined (any longer)%
}%
%
}%
}
%
% \end{macrocode}
% \end{macro}^^A \DestroyRealLayerPageStyle
%
%
% \subsection{Kernel Patches}
%
% This package as so many others need to patch the \LaTeX{} kernel. This will
% be done, because we need information about the current active package style.
%
% \begin{macro}{\pagestyle}
% \begin{macro}{\currentpagestyle}
% We save the current page style. Note, that this doesn't work for special
% page styles\footnote{Special page styles are set by
% \Macro{thispagestyle}.} that hasn't been defined using
% \Package{scrlayer}. As long as \Macro{currentpagestyle} is empty, the
% current page style is unknown. And we add two hooks into page style
% selection: one before an one after the selection.
% \begin{macrocode}
%<*package&body>
\newcommand*{\currentpagestyle}{}
\PackageInfo{scrlayer}{patching LaTeX kernel macro \string\pagestyle}
\def\reserved@a{\scrlayer@exec@before@pagestyle@hook{##1}}
\expandafter\expandafter\expandafter\renewcommand
\expandafter\expandafter\expandafter*%
\expandafter\expandafter\expandafter\pagestyle
\expandafter\expandafter\expandafter[%
\expandafter\expandafter\expandafter1%
\expandafter\expandafter\expandafter]%
\expandafter\expandafter\expandafter{%
\expandafter\reserved@a
\pagestyle{#1}%
\edef\currentpagestyle{\GetRealPageStyle{#1}}%
\scrlayer@exec@after@pagestyle@hook{#1}%
}
\AtBeginDocument{%
\begingroup
\let\scrlayer@exec@before@pagestyle@hook\@gobble
\let\scrlayer@exec@after@pagestyle@hook\@gobble
\def\ps@test{}%
\pagestyle{test}%
\ifstr{\currentpagestyle}{test}{}{%
\PackageError{scrlayer}{package incompatibility detected}{%
Another package redefines \string\pagestyle\space incompatible with
scrlayer.\MessageBreak
This disables setting of \string\currentpagestyle\space and may
be serious.\MessageBreak
Maybe you could prevent this loading package scrlayer
later.\MessageBreak
If not you should either not use scrlayer or not the other
package,\MessageBreak
that redefines \string\pagestyle.%
}%
}%
\endgroup
}
%
% \end{macrocode}
% \end{macro}^^A \currentpagestyle
%
% \begin{macro}{\BeforeSelectAnyPageStyle}
% \begin{macro}{\scrlayer@exec@before@pagestyle@hook}
% \begin{macro}{\AfterSelectAnyPageStyle}
% \begin{macro}{\scrlayer@exec@after@pagestyle@hook}
% We have two macros to locally add code to be executed whenever a page style
% changes using \Macro{pagestyle}. The first one executes the code before the
% page style will be changed, the second one after the page style has been
% changed. Note, that you may use \#1 as a placeholder of the argument of
% \Macro{pagestyle}.
% \begin{macrocode}
%<*package&body>
\newcommand*{\BeforeSelectAnyPageStyle}[1]{%
\expandafter\renewcommand\expandafter*%
\expandafter\scrlayer@exec@before@pagestyle@hook
\expandafter[\expandafter1\expandafter]\expandafter{%
\scrlayer@exec@before@pagestyle@hook{##1}#1}%
}
\newcommand*{\scrlayer@exec@before@pagestyle@hook}[1]{}
\newcommand*{\AfterSelectAnyPageStyle}[1]{%
\expandafter\renewcommand\expandafter*%
\expandafter\scrlayer@exec@after@pagestyle@hook
\expandafter[\expandafter1\expandafter]\expandafter{%
\scrlayer@exec@after@pagestyle@hook{##1}#1}%
}
\newcommand*{\scrlayer@exec@after@pagestyle@hook}[1]{}
%
% \end{macrocode}
% \end{macro}^^A \scrlayer@exec@after@pagestyle@hook
% \end{macro}^^A \AfterSelectAnyPageStyle
% \end{macro}^^A \scrlayer@exec@before@pagestyle@hook
% \end{macro}^^A \BeforeSelectAnyPageStyle
% \end{macro}^^A \pagestyle
%
%
% \subsection{Declaration of End User Interfaces}
%
% The package also supports an interface for loading end user interfaces.
% Maybe it would be a good idea to move this to \Package{scrbase}, but
% currently it is not needed.
%
% \begin{macro}{\scrlayerAddToInterface}
% \begin{macro}{\scrlayerAddCsToInterface}
% \begin{description}
% \item[\texttt{\{\meta{command}\textbar\meta{command sequence}\}}:] the
% command (with backslash) or the command sequence of the command (without
% backslash) of the command, that should be added to the interface.
% \item[\Parameter{code}:] will be executed, only if the command could be
% added to the interface.
% \end{description}
% Add either a command sequence or a command to the user interface.
% \begin{macrocode}
%<*package&body>
\newcommand*{\scrlayerAddToInterface}[2][\@currname.\@currext]{%
\begingroup
\edef\reserve@a{%
\noexpand\scrlayerAddCsToInterface[#1]{\expandafter\@gobble\string #2}%
}%
\expandafter\endgroup\reserve@a
}
\newcommand{\scrlayerAddCsToInterface}[3][\@currname.\@currext]{%
\@ifundefined{scrlayer@#1@commandlist}{%
\PackageError{scrlayer}{unkown interface `#1'}{%
I've been told to add a command sequence to an interface, that hasn't
been\MessageBreak
defined yet. Please initialise every interface using
\string\InitInterface\space before\MessageBreak
trying to add command sequences to it.\MessageBreak
If you'll continue, the command will be ignored.%
}%
}{%
\@ifundefined{#2}{%
\scrlayer@AddCsToInterface[#1]{#2}#3%
}{%
\@ifundefined{scrlayer@command@#2}{%
\ifscrlayer@forceoverwrite
\PackageWarning{scrlayer}{%
Overloading `\@backslashchar#2'!\MessageBreak
scrlayer detected, that the given command\MessageBreak
has been defined already, when\MessageBreak
`#1' tried to define it again.\MessageBreak
Nevertheless, while scrlayer is in force overwrite\MessageBreak
mode currently, the original definition will be\MessageBreak
removed%
}%
\expandafter\let\csname #2\endcsname\relax
\scrlayer@AddCsToInterface[#1]{#2}#3%
\else
\PackageError{scrlayer}{cannot define `\@backslashchar#2'}{%
scrlayer interface `#1' has tried to
define command\MessageBreak
`\@backslashchar#2', but this has already been defined\MessageBreak
and is not part of another interface. So it cannot be
defined.\MessageBreak
Before continuing you should solve this conflict.\MessageBreak
Nevertheless, you may use option `forceoverwrite' to get only a
warning instead\MessageBreak
of an error. But this wouldn't solve the problem at
all!\MessageBreak
This error is almost fatal, so you should abort the LaTeX
run.%
}%
\fi
}{%
\ifscrlayer@autoremoveinterfaces
\PackageInfo{scrlayer}{%
already define interface command\MessageBreak
`\@backslashchar#2' detected.\MessageBreak
Command has been defined by interface\MessageBreak
`\@nameuse{scrlayer@command@#2}'.\MessageBreak
To continue installation of interface\MessageBreak
`#1', interface\MessageBreak
`\@nameuse{scrlayer@command@#2}' will\MessageBreak
be removed%
}%
\@nameuse{scrlayer@\@nameuse{scrlayer@command@#2}@onremove}%
\begingroup
\def\@elt##1{%
\aftergroup\let\aftergroup##1\aftergroup\relax
}%
\@nameuse{scrlayer@\@nameuse{scrlayer@command@#2}@commandlist}%
\endgroup
\expandafter\let\csname
scrlayer@\@nameuse{scrlayer@command@#2}@commandlist\endcsname\relax
\expandafter\let\csname
scrlayer@\@nameuse{scrlayer@command@#2}@onremove\endcsname\relax
\expandafter\let\csname #2\endcsname\relax
\scrlayer@AddCsToInterface[#1]{#2}#3%
\else
\PackageError{scrlayer}{cannot define `\@backslashchar#2'}{%
Interface command `\@backslashchar#2' has already
been\MessageBreak
defined by interface
`\@nameuse{scrlayer@command@#2}'.\MessageBreak
So it cannot be defined again.\MessageBreak
You may try scrlayer option `autoremoveinterfaces' to
automatically remove\MessageBreak
older interfaces in such conflict situations.\MessageBreak
For now, it's recommended so solve the problem before you'll
continue.%
}%
\fi
}%
}%
}%
}%
% \end{macrocode}
% \begin{macro}{\scrlayer@AddCsToInterface}
% Little helper, to avoid repeating this \Macro{expandafter} orgy.
% \begin{description}
% \item[\OParameter{string}:] the interface name (must be expandable and
% expand to a string)
% \item[\Parameter{command sequence}] the command sequence of the command to
% be added.
% \end{description}
% \begin{macrocode}
\newcommand*\scrlayer@AddCsToInterface[2][\@currname.\@currext]{%
\expandafter\expandafter\expandafter\def\expandafter
\csname scrlayer@#1@commandlist\expandafter\expandafter\expandafter\endcsname
\expandafter\expandafter\expandafter{%
\csname scrlayer@#1@commandlist\expandafter\endcsname
\expandafter\@elt\csname #2\endcsname
}%
\@namedef{scrlayer@command@#2}{#1}%
}
%
% \end{macrocode}
% \begin{option}{forceoverwrite}
% \begin{macro}{\ifscrlayer@forceoverwrite}
% \begin{description}
% \item[\Parameter{simple switch}:] whether or not to overwrite already
% defined command. Note: If true, there will still be a warning.
% \end{description}
% \begin{macrocode}
%<*options>
\KOMA@ifkey{forceoverwrite}{scrlayer@forceoverwrite}
%<*interface>
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @forceoverwrite}
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @forceoverwrite@default}
%
%
% \end{macrocode}
% \end{macro}^^A \ifscrlayer@forceoverwrite
% \end{option}^^A forceoverwrite
%
% \begin{option}{autoremoveinterfaces}
% \begin{macro}{\ifscrlayer@autoremoveinterfaces}
% \begin{description}
% \item[\Parameter{simple switch}:] whether or not older interfaces may be
% automatically removed in conflict cases.
% \end{description}
% \begin{macrocode}
%<*options>
\KOMA@ifkey{autoremoveinterfaces}{scrlayer@autoremoveinterfaces}
%<*interface>
\scrlayer@AddCsToInterface{KV@KOMA.\@currname.\@currext @autoremoveinterfaces}
\scrlayer@AddCsToInterface{%
KV@KOMA.\@currname.\@currext @autoremoveinterfaces@default}
%
%
% \end{macrocode}
% \end{macro}^^A \ifscrlayer@autoremoveinterfaces
% \end{option}^^A autoremoveinterfaces
% \end{macro}^^A \scrlayer@AddCsToInterface
% \end{macro}^^A \scrlayerAddCsToInterface
% \end{macro}^^A \scrlayerAddToInterface
%
% \begin{macro}{\scrlayerInitInterface}
% \begin{description}
% \item[\OParameter{string}:] the name of the interface. Generally this is
% the file name of the package or class, that defines the interface
% (default: \texttt{\Macro{@currname}.\Macro{@currext}}).
% \end{description}
% This registers a new user interface.
% \begin{macrocode}
%<*package&body>
\newcommand*{\scrlayerInitInterface}[1][\@currname.\@currext]{%
\@ifundefined{scrlayer@#1@commandlist}{%
\@namedef{scrlayer@#1@commandlist}{}%
}{%
\begingroup
\def\@elt##1{\space\space\string##1\MessageBreak}%
\PackageError{scrlayer}{interface `#1' already initialised}{%
You've tried to initialise scrlayer interface `#1',\MessageBreak
but an interface of this name has been initialised
already.\MessageBreak
Here's a list of all macros of the already initialised
interface:\MessageBreak
\@nameuse{scrlayer@#1@commandlist}.%
If you'll continue, this re-initialisation will be ignored.%
}%
\endgroup
}%
}
%
% \end{macrocode}
% The initialisation has to be done by each interface package:
% \begin{macrocode}
%\scrlayerInitInterface
% \end{macrocode}
% \end{macro}^^A \scrlayerInitInterface
%
% \begin{macro}{\scrlayerOnAutoRemoveInterface}
% \begin{description}
% \item[\OParameter{string}:] the name of the interface. Generally this is
% the file name of the package or class, that defines the interface
% (default: \texttt{\Macro{@currname}.\Macro{@currext}}).
% \item[\Parameter{code}:] will be executed if the interface will be removed
% automatically (see option \Option{autoremoveinterfaces}).
% \end{description}
% \begin{macrocode}
%<*package&body>
\newcommand*{\scrlayerOnAutoRemoveInterface}[2][\@currname.\@currext]{%
\@ifundefined{scrlayer@#1@onremove}{\@namedef{scrlayer@#1@onremove}{}}{}%
\expandafter\l@addto@macro\csname scrlayer@#1@onremove\endcsname{#2}%
}
%
% \end{macrocode}
% \end{macro}^^A \scrlayerOnAutoRemoveInterface
%
%
% \iffalse^^A meta-comment
%
% \fi^^A meta-comment
%
%
% \Finale
%
\endinput
%
% end of file `scrlayer.dtx'
%%% Local Variables:
%%% mode: doctex
%%% mode: flyspell
%%% ispell-local-dictionary: "en_GB"
%%% TeX-master: t
%%% End: