% ======================================================================
% common-8.tex
% Copyright (c) Markus Kohm, 2001-2009
%
% 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-8.tex
% Copyright (c) Markus Kohm, 2001-2009
%
% 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
%
% ======================================================================

\ProvidesFile{common-8.tex}[2009/02/27 KOMA-Script guide (common paragraphs)]

\makeatletter
\@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}%
\@ifundefined{ifCommonscrextend}{\newif\ifCommonscrextend}{}%
\@ifundefined{ifCommonscrlttr}{\newif\ifCommonscrlttr}{}%
\@ifundefined{ifIgnoreThis}{\newif\ifIgnoreThis}{}%
\makeatother


\section{Vakatseiten}
\label{sec:\csname label@base\endcsname.emptypage}%
\ifshortversion\IgnoreThisfalse\IfNotCommon{maincls}{\IgnoreThistrue}\fi%
\ifIgnoreThis %+++++++++++++++++++++++++++++++++++++++++++++ nicht maincls +
Es gilt sinngemäß, was in \autoref{sec:maincls.emptypage} geschrieben
wurde.
\else %------------------------------------------------------- nur maincls -
\BeginIndex{}{Vakatseite}%%
\BeginIndex{}{Seitenstil}%

\IfNotCommon{scrlttr2}{Vakatseiten sind Seiten, die beim Satz eines Dokuments
  absichtlich leer bleiben. Ursprünglich sind diese Seiten wirklich komplett
  leer. 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 vorherigen 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. Die leeren
  Rückseiten im einseitigen Druck werden eher nicht als Vakatseiten
  bezeichnet, obwohl sie auf Druckbögen im Ergebnis als solche erscheinen.}%
\fi %**************************************************** Ende nur maincls *
\ifIgnoreThis %+++++++++++++++++++++++++++++++++++++++++++++ nicht maincls +
\IfCommon{scrlttr2}{Aber}
\fi %**************************************************** Ende nur maincls *

\IfCommon{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}.}%
\ifIgnoreThis %+++++++++++++++++++++++++++++++++++++++++++++ nicht maincls +
\else %------------------------------------------------------- nur maincls -

\begin{Declaration}
  \KOption{cleardoublepage}\PName{Seitenstil}\\
  \OptionValue{cleardoublepage}{current}
\end{Declaration}%
\BeginIndex{Option}{cleardoublepage~=\PName{Seitenstil}}%
\BeginIndex{Option}{cleardoublepage~=current}%
Mit Hilfe dieser Option\ChangedAt{v3.00}{\Class{scrbook}\and
  \Class{scrreprt}\and \Class{scrartcl}\and \Class{scrlttr2}} kann man den
\PName{Seitenstil} der Vakatseite bestimmen, die gegebenenfalls von der
Anweisung \Macro{cleardoublepage} eingefügt wird, um bis zur gewünschten Seite
zu umbrechen. Als \PName{Seitenstil} sind alle bereits definierten Seitenstile
(siehe \autoref{sec:\csname label@base\endcsname.pagestyle} ab
\autopageref{sec:\csname label@base\endcsname.pagestyle} und
\autoref{cha:scrpage} ab \autopageref{cha: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\ChangedAt{v3.00}{\Class{scrbook}\and
  \Class{scrreprt}\and \Class{scrartcl}\and \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 \Option{version},
\autoref{sec:\csname label@base\endcsname.compatibilityOptions},
\autopageref{desc:\csname label@base\endcsname.option.version}).
\ifCommonmaincls
\begin{Example}
  \phantomsection\label{desc:maincls.option.cleardoublepage.example}
  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}
  \KOMAoption{cleardoublepage=plain}
  \end{lstcode}
  Näheres zum Seitenstil \Pagestyle{plain} ist in
  \autoref{sec:maincls.pagestyle}, \autopageref{desc:maincls.pagestyle.plain}
  zu finden.
\end{Example}
\fi
\ifCommonscrextend
\begin{Example}
  \phantomsection\label{desc:scrextend.option.cleardoublepage.example}
  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}
  \KOMAoption{cleardoublepage=plain}
  \end{lstcode}
  Näheres zum Seitenstil \Pagestyle{plain} ist in
  \autoref{sec:maincls.pagestyle}, \autopageref{desc:maincls.pagestyle.plain}
  zu finden.
\end{Example}
\fi
\EndIndex{Option}{cleardoublepage~=current}%
\EndIndex{Option}{cleardoublepage~=\PName{Seitenstil}}


\begin{Declaration}
  \Macro{clearpage}\\
  \Macro{cleardoublepage}\\
  \Macro{cleardoublepageusingstyle}\Parameter{Seitenstil}\\
  \Macro{cleardoubleemptypage}\\
  \Macro{cleardoubleplainpage}\\
  \Macro{cleardoublestandardpage}\\
  \Macro{cleardoubleoddusingstyle}\Parameter{Seitenstil}\\
  \Macro{cleardoubleoddemptypage}\\
  \Macro{cleardoubleoddplainpage}\\
  \Macro{cleardoubleoddstandardpage}\\
  \Macro{cleardoubleevenusingstyle}\Parameter{Seitenstil}\\
  \Macro{cleardoubleevenemptypage}\\
  \Macro{cleardoubleevenplainpage}\\
  \Macro{cleardoubleevenstandardpage}
\end{Declaration}%
\BeginIndex{Cmd}{clearpage}%
\BeginIndex{Cmd}{cleardoublepage}%
\BeginIndex{Cmd}{cleardoublepageusingstyle}%
\BeginIndex{Cmd}{cleardoublestandardpage}%
\BeginIndex{Cmd}{cleardoubleplainpage}%
\BeginIndex{Cmd}{cleardoubleemptypage}%
\BeginIndex{Cmd}{cleardoubleoddusingstyle}%
\BeginIndex{Cmd}{cleardoubleoddstandardpage}%
\BeginIndex{Cmd}{cleardoubleoddplainpage}%
\BeginIndex{Cmd}{cleardoubleoddemptypage}%
\BeginIndex{Cmd}{cleardoubleevenusingstyle}%
\BeginIndex{Cmd}{cleardoubleevenstandardpage}%
\BeginIndex{Cmd}{cleardoubleevenplainpage}%
\BeginIndex{Cmd}{cleardoubleevenemptypage}%
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 \Option{twoside} in
\autoref{sec:typearea.options}, \autopageref{desc:typearea.option.twoside})
eine neue rechte Seite begonnen wird. Dazu wird gegebenenfalls eine linke
Vakatseite im aktuellen Seitenstil ausgegeben.

Bei {\KOMAScript} arbeitet
\Macro{cleardoubleoddstandardpage}\ChangedAt{v3.00}{\Class{scrbook}\and
  \Class{scrreprt}\and \Class{scrartcl}\and \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 %
\IfCommon{maincls}{Kolumnentitel}%
\IfCommon{scrlttr2}{Seitenkopf}%
\ zu unterdrücken. Analog dazu wird bei der Anweisung
\Macro{cleardoubleoddemptypage} der Seitenstil
\Pagestyle{empty}\IndexPagestyle{empty} verwendet, um sowohl %
\IfCommon{maincls}{Kolumnentitel als auch Seitenzahl}%
\IfCommon{scrlttr2}{Seitenkopf als auch Seitenfuß}%
\ 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{cleardoubleoddusingstyle}
anzugeben. Dabei kann jeder bereits definierte Seitenstil (siehe auch
\autoref{cha:scrpage}) verwendet werden.

\IfNotCommon{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 zu
  \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 \Macro{cleardoubleevenusingstyle}.}

Die Arbeitsweise der neuen Anweisungen \Macro{cleardoublestandardpage},
\Macro{cleardoubleemptypage}, \Macro{cleardoubleplainpage} und der ein
Argument erwartenden Anweisung \Macro{cleardoublepageusingstyle} ist %
\IfCommon{scrlttr2}{bei \Class{scrlttr2} }%
\IfCommon{scrextend}{bei \Package{scrextend} }%
ebenso wie die Standard-Anweisung \Macro{cleardoublepage} von der zuvor
erklärten Option \Option{cleardoublepage} abhängig und entspricht je nach
Einstellung einer der in den vorherigen Absätzen erläuterten Anweisungen.

\IfCommon{scrlttr2}{%
  Die übrigen Anweisungen sind bei \Class{scrlttr2} nur aus Gründen der
  Vollständigkeit definiert. Näheres zu diesen Anweisungen ist bei Bedarf
  \autoref{sec:maincls.emptypage},
  \autopageref{desc:maincls.cmd.cleardoublepage} zu entnehmen.}%
\ifCommonscrlttr2\else
\begin{Example}
  \label{desc:maincls.cmd.cleardoublepage.example}%
  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 \Macro{documentclass} angegeben werden.

  An der gewünschten Stelle im Dokument 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
%
\EndIndex{Cmd}{clearpage}%
\EndIndex{Cmd}{cleardoublepage}%
\EndIndex{Cmd}{cleardoublepageusingstyle}%
\EndIndex{Cmd}{cleardoublestandardpage}%
\EndIndex{Cmd}{cleardoubleplainpage}%
\EndIndex{Cmd}{cleardoubleemptypage}%
\EndIndex{Cmd}{cleardoubleoddusingstyle}%
\EndIndex{Cmd}{cleardoubleoddstandardpage}%
\EndIndex{Cmd}{cleardoubleoddplainpage}%
\EndIndex{Cmd}{cleardoubleoddemptypage}%
\EndIndex{Cmd}{cleardoubleevenusingstyle}%
\EndIndex{Cmd}{cleardoubleevenstandardpage}%
\EndIndex{Cmd}{cleardoubleevenplainpage}%
\EndIndex{Cmd}{cleardoubleevenemptypage}%
%
\EndIndex{}{Seitenstil}%
\EndIndex{}{Vakatseite}%
\fi %**************************************************** Ende nur maincls *


%%% Local Variables:
%%% mode: latex
%%% coding: iso-latin-1
%%% TeX-master: "../guide"
%%% End:
