summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/english/common-8.tex
blob: 38d9dccf77e467747bd79b324bc6c17ebc3f0107 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
% ======================================================================
% 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/01/04 KOMA-Script guide (common paragraphs)]
\translator{Gernot Hassenpflug}

\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
Es gilt sinngemäß, was in \autoref{sec:maincls.emptypage} geschrieben
wurde.
\else
\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
\ifIgnoreThis
\IfCommon{scrlttr2}{Aber}
\fi
\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\else

\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% IgnoreThis


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