% ======================================================================
% common-interleafpage.tex
% Copyright (c) Markus Kohm, 2001-2017
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
% This work may be distributed and/or modified under the conditions of
% the LaTeX Project Public License, version 1.3c of the license.
% The latest version of this license is in
%   http://www.latex-project.org/lppl.txt
% and version 1.3c or later is part of all distributions of LaTeX 
% version 2005/12/01 or later and of this work.
%
% This work has the LPPL maintenance status "author-maintained".
%
% The Current Maintainer and author of this work is Markus Kohm.
%
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-interleafpage.tex
% Copyright (c) Markus Kohm, 2001-2017
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
% 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 oder spaeter 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.
% ======================================================================
%
% Paragraphs that are common for several chapters of the KOMA-Script guide
% Maintained by Markus Kohm
%
% ----------------------------------------------------------------------
%
% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind
% Verwaltet von Markus Kohm
%
% ======================================================================

\KOMAProvidesFile{common-interleafpage.tex}
                 [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
                  KOMA-Script guide (common paragraphs)]

\section{Vakatseiten}
\seclabel{emptypage}%
\BeginIndexGroup
\BeginIndex{}{Vakatseite}%
\BeginIndex{}{Seiten>Stil}%

\IfThisCommonFirstRun{}{%
  Es gilt sinngemäß, was in
  \autoref{sec:\ThisCommonFirstLabelBase.emptypage} geschrieben
  wurde. Falls Sie also \autoref{sec:\ThisCommonFirstLabelBase.emptypage}
  bereits gelesen und verstanden haben, können Sie auf
  \autopageref{sec:\ThisCommonLabelBase.emptypage.next} mit
  \autoref{sec:\ThisCommonLabelBase.emptypage.next} fortfahren.%
}

Vakatseiten sind Seiten, die beim Satz eines Dokuments absichtlich leer
bleiben. Bei \LaTeX{} werden sie jedoch in der Voreinstellung mit dem aktuell
gültigen Seitenstil gesetzt. \KOMAScript{} bietet hier diverse Erweiterungen.

Vakatseiten findet man hauptsächlich in Büchern. Da es bei Büchern üblich ist,
dass Kapitel auf einer rechten Seite beginnen, muss in dem Fall, dass das
vorherige Kapitel ebenfalls auf einer rechten Seite endet, eine leere linke
Seite eingefügt werden. Aus dieser Erklärung ergibt sich auch, dass
Vakatseiten normalerweise nur im doppelseitigen Satz existieren.
%
\iffalse % Umbruchkorrektur
  Die leeren Rückseiten im einseitigen Druck werden eher nicht als Vakatseiten
  bezeichnet, obwohl sie auf Druckbögen im Ergebnis als solche erscheinen.%
\fi%

\IfThisCommonLabelBase{scrlttr2}{%
  Vakatseiten sind bei Briefen eher unüblich. Das liegt nicht zuletzt daran,
  dass wahrhaft doppelseitige Briefe recht selten sind, da Briefe
  normalerweise nicht gebunden werden. Trotzdem unterstützt auch
  \Class{scrlttr2} für den Fall von doppelseitigen Briefen Einstellungen für
  Vakatseiten. Da die hier vorgestellten Anweisungen aber in Briefen kaum
  Verwendung finden, finden Sie hier keine Beispiele. Bei Bedarf orientieren
  Sie sich bitte an den Beispielen in \autoref{sec:maincls.emptypage} ab
  \autopageref{sec:maincls.emptypage}.%
}{}%

\begin{Declaration}
  \OptionVName{cleardoublepage}{Seitenstil}%
  \OptionValue{cleardoublepage}{current}
\end{Declaration}%
Mit Hilfe dieser Option%
\IfThisCommonLabelBase{maincls}{%
  \ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
    \Class{scrartcl}}%
}{%
  \IfThisCommonLabelBase{scrlttr2}{%
    \ChangedAt{v3.00}{\Class{scrlttr2}}%
  }{}%
} %
kann man den \PName{Seitenstil} der Vakatseite bestimmen, die bei Bedarf von
den Anweisungen \DescRef{\LabelBase.cmd.cleardoublepage},
\DescRef{\LabelBase.cmd.cleardoubleoddpage} oder
\DescRef{\LabelBase.cmd.cleardoubleevenpage} eingefügt wird, um bis zur
gewünschten Seite zu umbrechen. Als \PName{Seitenstil} sind dabei alle bereits
definierten Seitenstile (siehe \autoref{sec:\ThisCommonLabelBase.pagestyle} ab
\autopageref{sec:\ThisCommonLabelBase.pagestyle} und
\autoref{cha:scrlayer-scrpage} ab \autopageref{cha:scrlayer-scrpage})
verwendbar. Daneben ist auch \OptionValue{cleardoublepage}{current}
möglich. Dieser Fall entspricht der Voreinstellung von \KOMAScript{} bis
Version~2.98c und führt dazu, dass die Vakatseite mit dem Seitenstil erzeugt
wird, der beim Einfügen gerade aktuell ist. Ab Version~3.00%
\IfThisCommonLabelBase{maincls}{%
  \ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
    \Class{scrartcl}}%
}{%
  \IfThisCommonLabelBase{scrlttr2}{%
    \ChangedAt{v3.00}{\Class{scrlttr2}}%
  }{}%
} %
werden in der Voreinstellung entsprechend der typografischen Gepflogenheiten
Vakatseiten mit dem Seitenstil \PageStyle{empty} erzeugt, wenn man nicht
Kompatibilität zu früheren \KOMAScript-Versionen eingestellt hat (siehe Option
\DescRef{\ThisCommonLabelBase.option.version},
\autoref{sec:\ThisCommonLabelBase.compatibilityOptions},
\DescPageRef{\ThisCommonLabelBase.option.version}).
\IfThisCommonLabelBase{maincls}{\iftrue}{\csname iffalse\endcsname}
  \begin{Example}
    \phantomsection\xmpllabel{option.cleardoublepage}%
    Angenommen, Sie wollen, dass die Vakatseiten bis auf die Paginierung leer
    sind\iffree{, also mit Seitenstil \PageStyle{plain} erzeugt
      werden}{}. Dies erreichen Sie \iffree{beispielsweise }{}mit:
\begin{lstcode}
  \KOMAoptions{cleardoublepage=plain}
\end{lstcode}
    Näheres zum Seitenstil \PageStyle{plain} ist in
    \autoref{sec:maincls.pagestyle},
    \DescPageRef{maincls.pagestyle.plain} zu finden.
  \end{Example}
\else
  \IfThisCommonLabelBase{scrextend}{\iftrue}{\csname iffalse\endcsname}
    \begin{Example}
      \phantomsection\xmpllabel{option.cleardoublepage}%
      Angenommen, Sie wollen, dass die Vakatseiten bis auf die Paginierung
      leer sind, also mit Seitenstil \PageStyle{plain} erzeugt werden. Dies
      erreichen Sie beispielsweise mit
\begin{lstcode}
  \KOMAoptions{cleardoublepage=plain}
\end{lstcode}
      Näheres zum Seitenstil \PageStyle{plain} ist in
      \autoref{sec:maincls.pagestyle}, 
      \DescPageRef{maincls.pagestyle.plain}
      zu finden.
    \end{Example}%
  \fi%
\fi%
\EndIndexGroup


\begin{Declaration}
  \Macro{clearpage}%
  \Macro{cleardoublepage}%
  \Macro{cleardoublepageusingstyle}\Parameter{Seitenstil}%
  \Macro{cleardoubleemptypage}%
  \Macro{cleardoubleplainpage}%
  \Macro{cleardoublestandardpage}%
  \Macro{cleardoubleoddpage}%
  \Macro{cleardoubleoddpageusingstyle}\Parameter{Seitenstil}%
  \Macro{cleardoubleoddemptypage}%
  \Macro{cleardoubleoddplainpage}%
  \Macro{cleardoubleoddstandardpage}%
  \Macro{cleardoubleevenpage}%
  \Macro{cleardoubleevenpageusingstyle}\Parameter{Seitenstil}%
  \Macro{cleardoubleevenemptypage}%
  \Macro{cleardoubleevenplainpage}%
  \Macro{cleardoubleevenstandardpage}
\end{Declaration}%
Im \LaTeX-Kern existiert die Anweisung
\Macro{clearpage}, die dafür sorgt, dass alle noch nicht ausgegebenen
Gleitumgebungen ausgegeben werden und anschließend eine neue Seite begonnen
wird.  Außerdem existiert die Anweisung \Macro{cleardoublepage}, die wie
\Macro{clearpage} arbeitet, durch die aber im doppelseitigen Layout (siehe
Option \DescRef{typearea.option.twoside} in \autoref{sec:typearea.typearea},
\DescPageRef{typearea.option.twoside}) eine neue rechte Seite begonnen
wird. Dazu wird gegebenenfalls eine linke Vakatseite im aktuellen Seitenstil
ausgegeben.

Bei {\KOMAScript} arbeitet \Macro{cleardoubleoddstandardpage}%
\IfThisCommonLabelBase{maincls}{%
  \ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
    \Class{scrartcl}}%
}{%
  \IfThisCommonLabelBase{scrlttr2}{%
    \ChangedAt{v3.00}{\Class{scrlttr2}}%
  }{}%
} %
genau in der soeben für die Standardklassen beschriebenen Art und Weise. Die
Anweisung \Macro{cleardoubleoddplainpage} ändert demgegenüber den Seitenstil
der leeren linken Seite zusätzlich auf
\PageStyle{plain}\IndexPagestyle{plain}, um den
\IfThisCommonLabelBase{scrlttr2}{Seitenkopf}{Kolumnentitel} zu
unterdrücken. Analog dazu wird bei der Anweisung
\Macro{cleardoubleoddemptypage} der Seitenstil
\PageStyle{empty}\IndexPagestyle{empty} verwendet, um sowohl
\IfThisCommonLabelBase{scrlttr2}{Seitenkopf als auch Seitenfuß}{Kolumnentitel
  als auch Seitenzahl} auf der leeren linken Seite zu unterdrücken. Die Seite
ist damit vollständig leer. Will man für die Vakatseite einen eigenen
\PName{Seitenstil} vorgeben, so ist dieser als Argument von
\Macro{cleardoubleoddpageusingstyle} anzugeben. Dabei kann jeder bereits
definierte Seitenstil (siehe auch \autoref{cha:scrlayer-scrpage}) verwendet
werden.

\IfThisCommonLabelBase{scrlttr2}{}{%
  Manchmal möchte man nicht, dass Kapitel mit neuen rechten Seiten, sondern
  links auf einer Doppelseite beginnen. Dies widerspricht zwar dem klassischen
  Buchdruck, kann jedoch seine Berechtigung haben, wenn die Doppelseite am
  Kapitelanfang einen ganz speziellen Inhalt hat. Bei \KOMAScript{} ist
  deshalb die Anweisung \Macro{cleardoubleevenstandardpage} als Äquivalent zur
  Anweisung \Macro{cleardoubleoddstandardpage} definiert, jedoch mit dem
  Unterschied, dass die nächste Seite eine linke Seite ist. Entsprechendes
  gilt für die Anweisungen \Macro{cleardoubleevenplainpage},
  \Macro{cleardoubleevenemptypage} und %
  \IfThisCommonLabelBase{maincls}{% Umbruchoptimierungsalternative
    für die ein Argument erwartende Anweisung }{}%
  \Macro{cleardoubleevenpageusingstyle}.%
}

Die Arbeitsweise der Anweisungen \Macro{cleardoublestandardpage},
\Macro{cleardoubleemptypage}, \Macro{cleardoubleplainpage} und der ein
Argument erwartenden Anweisung \Macro{cleardoublepageusingstyle} %
\IfThisCommonLabelBase{maincls}{%
  ist ebenso wie die Standard-Anweisung \Macro{cleardoublepage} von der in
  \autoref{sec:maincls.structure}, \DescPageRef{maincls.option.open} erklärten
  Option \DescRef{maincls.option.open}%
  \IndexOption{open}\important{\DescRef{maincls.option.open}} abhängig und
  entspricht je nach Einstellung einer der in den vorherigen Absätzen
  erläuterten Anweisungen.

}{%
  entspricht \IfThisCommonLabelBase{scrlttr2}{bei der Klasse
    \Class{scrlttr2}}{%
    \IfThisCommonLabelBase{scrextend}{beim Paket \Package{scrextend}}{%
      \InternalCommonFileUsageError}%
  } ebenso wie die Standard-Anweisung \Macro{cleardoublepage} den
  entsprechenden, zuvor erklärten Anweisungen%
  \IfThisCommonLabelBase{scrlttr2}{. %
    Die übrigen Anweisungen sind bei \Class{scrlttr2} nur aus Gründen der
    Vollständigkeit definiert. Näheres zu diesen ist bei Bedarf
    \autoref{sec:maincls.emptypage},
    \DescPageRef{maincls.cmd.cleardoublepage} zu entnehmen%
  }{%
    für den Umbruch zur nächsten ungeraden Seite%
  }.%
}
\IfThisCommonLabelBase{scrlttr2}{\iffalse}{\csname iftrue\endcsname}
  \begin{Example}
    \phantomsection\xmpllabel{cmd.cleardoublepage}%
    Angenommen, Sie wollen innerhalb eines Dokuments als nächstes eine
    Doppelseite setzen, bei der auf der linken Seite eine Abbildung in Größe
    des Satzspiegels platziert wird und rechts ein neues Kapitel
    beginnt. Falls das vorherige Kapitel mit einer linken Seite endet, muss
    also eine Vakatseite eingefügt werden. Diese soll komplett leer
    sein. Ebenso soll die linke Bildseite weder Kopf noch Fußzeile
    besitzen. Zunächst wird mit
\begin{lstcode}
  \KOMAoptions{cleardoublepage=empty}
\end{lstcode}
    dafür gesorgt, dass Vakatseiten mit dem Seitenstil \PageStyle{empty}, also
    ohne Kopf- und Fußzeile gesetzt werden. Diese Einstellung können Sie
    bereits in der Dokumentpräambel vornehmen. Die Optionen können alternativ
    auch als optionale Argumente von
    \DescRef{\ThisCommonLabelBase.cmd.documentclass} angegeben werden.

    An der gewünschten Stelle 
    \IfThisCommonLabelBase{scrextend}{}{im Dokument }% Umbruchoptimierung!!!
    schreiben Sie nun:
\begin{lstcode}
  \cleardoubleevenemptypage
  \thispagestyle{empty}
  \includegraphics[width=\textwidth,%
                   height=\textheight,%
                   keepaspectratio]%
                  {bild}
  \chapter{Kapitelüberschrift}
\end{lstcode}
    Die erste Zeile wechselt auf die nächste linke Seite und fügt zu diesem
    Zweck bei Bedarf eine komplett leere rechte Seite ein. Die zweite Zeile
    sorgt dafür, dass diese linke Seite ebenfalls mit dem Seitenstil
    \PageStyle{empty} gesetzt wird. Die dritte bis sechste Zeile lädt die
    Bilddatei mit dem Namen \File{bild} und bringt sie auf die gewünschte
    Größe, ohne sie dabei zu verzerren. Hierfür wird das Paket
    \Package{graphicx}\IndexPackage{graphicx} benötigt (siehe
    \cite{package:graphics}). Die letzte Zeile beginnt auf der nächsten --
    dann rechten -- Seite ein neues Kapitel.
  \end{Example}%
\fi

Die Anweisungen \Macro{cleardoubleoddpage} und \Macro{cleardoubleevenpage}
führen immer zur nächsten linken beziehungsweise rechten Seite. Dabei wird für
eine gegebenenfalls einzufügende Vakatseite der Seitenstil entsprechend Option
\DescRef{\LabelBase.option.cleardoublepage} gewählt.%
%
\EndIndexGroup
%
\EndIndexGroup


%%% Local Variables:
%%% mode: latex
%%% mode: flyspell
%%% coding: iso-latin-1
%%% ispell-local-dictionary: "de_DE"
%%% TeX-master: "../guide"
%%% End:

%  LocalWords:  Gleitumgebungen Seitenkopf Kolumnentitel Seitenfuß Bilddatei
%  LocalWords:  Satzspiegels Bildseite
