diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/english/common-interleafpage.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/koma-script/doc/english/common-interleafpage.tex | 290 |
1 files changed, 290 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-interleafpage.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-interleafpage.tex new file mode 100644 index 00000000000..28169a0c58d --- /dev/null +++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-interleafpage.tex @@ -0,0 +1,290 @@ +% ====================================================================== +% 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 +% +% ---------------------------------------------------------------------- +% +% Absaetze, 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: Interleaf Pages)] +\translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi} + +% Date of the translated German file: 2017-01-02 + +\section{Interleaf Pages} +\seclabel{emptypage}% +\BeginIndexGroup +\BeginIndex{}{interleaf page}%% +\BeginIndex{}{page>style}% + +\IfThisCommonFirstRun{}{% + What is described in \autoref{sec:\ThisCommonFirstLabelBase.emptypage} + applies, mutatis mutandis. So if you have alread read and understood + \autoref{sec:\ThisCommonFirstLabelBase.emptypage} you can switch to + \autoref{sec:\ThisCommonLabelBase.emptypage.next}, + \autopageref{sec:\ThisCommonLabelBase.emptypage.next}.% +} + +Interleaf pages are pages that are intended to stay blank. Originally these +pages were really completely white. \LaTeX{}, on the other hand, by default +sets those pages with the current valid page style. So those pages may have a +head and a pagination. \KOMAScript{} provides several extensions to this. + +Interleaf pages may be found in books mostly. Because chapters in books +commonly start on odd pages, sometimes a left page without contents has to be +added before. This is also the reason that interleaf pages only exist in +double-sided printing. The unused back sides of the one-sided printings are +not interleaf pages, really, although they may seem to be such pages. + +\IfThisCommonLabelBase{scrlttr2}{% + At letters interleaf pages are unusual. This may be benefited by the case, + that real two-sided letters are seldom, because binding of letters is not + done often. Nevertheless \Class{scrlttr2} supports interleaf pages in the + case of two-sided letters. Because the following described commands are + seldom used in letters no examples are shown. If you need examples, please + note them at \autoref{sec:maincls.emptypage} from + \autopageref{sec:maincls.emptypage} upward.% +}{}% + +\begin{Declaration} + \OptionVName{cleardoublepage}{page style} + \OptionValue{cleardoublepage}{current} +\end{Declaration}% +With this option, % +\IfThisCommonLabelBase{maincls}{% + \ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}}% +}{% + \IfThisCommonLabelBase{scrlttr2}{% + \ChangedAt{v3.00}{\Class{scrlttr2}}% + }{}% +} % +you may define the page style of the interleaf pages created by the +\DescRef{\LabelBase.cmd.cleardoublepage}, +\DescRef{\LabelBase.cmd.cleardoubleoddpage}, or +\DescRef{\LabelBase.cmd.cleardoubleevenpage} to break until the wanted +page. Every already defined \PName{page style} (see +\autoref{sec:\ThisCommonLabelBase.pagestyle} from +\autopageref{sec:\ThisCommonLabelBase.pagestyle} and +\autoref{cha:scrlayer-scrpage} from \autopageref{cha:scrlayer-scrpage}) may be +used. Besides this, \OptionValue{cleardoublepage}{current} is valid. This case +is the default until \KOMAScript~2.98c and results in interleaf page without +changing the page style. Since \KOMAScript~3.00% +\IfThisCommonLabelBase{maincls}{% + \ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}}% +}{% + \IfThisCommonLabelBase{scrlttr2}{% + \ChangedAt{v3.00}{\Class{scrlttr2}}% + }{}% +} % +the default follows the recommendation of most typographers and has been +changed to blank interleaf pages with page style \PageStyle{empty} unless you +switch compatibility to an earlier version (see 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}% + Assume you want interleaf pages almost empty but with pagination. This + means you want to use page style \PageStyle{plain}. You may use following + to achieve this: +\begin{lstcode} + \KOMAoptions{cleardoublepage=plain} +\end{lstcode} + More information about page style \PageStyle{plain} may be found at + \autoref{sec:maincls.pagestyle}, + \DescPageRef{maincls.pagestyle.plain}. + \end{Example} +\else + \IfThisCommonLabelBase{scrextend}{\iftrue}{\csname iffalse\endcsname} + \begin{Example} + \phantomsection\xmpllabel{option.cleardoublepage}% + Assume you want interleaf pages almost empty but with pagination. This + means you want to use page style \PageStyle{plain}. You may use + following to achieve this: +\begin{lstcode} + \KOMAoptions{cleardoublepage=plain} +\end{lstcode} + More information about page style \PageStyle{plain} may be found at + \autoref{sec:maincls.pagestyle}, + \DescPageRef{maincls.pagestyle.plain}. + \end{Example}% + \fi% +\fi% +\EndIndexGroup + + +\begin{Declaration} + \Macro{clearpage}% + \Macro{cleardoublepage}% + \Macro{cleardoublepageusingstyle}\Parameter{page style}% + \Macro{cleardoubleemptypage}% + \Macro{cleardoubleplainpage}% + \Macro{cleardoublestandardpage}% + \Macro{cleardoubleoddpage}% + \Macro{cleardoubleoddpageusingstyle}\Parameter{page style}% + \Macro{cleardoubleoddemptypage}% + \Macro{cleardoubleoddplainpage}% + \Macro{cleardoubleoddstandardpage}% + \Macro{cleardoubleevenpage}% + \Macro{cleardoubleevenpageusingstyle}\Parameter{page style}% + \Macro{cleardoubleevenemptypage}% + \Macro{cleardoubleevenplainpage}% + \Macro{cleardoubleevenstandardpage} +\end{Declaration}% +The {\LaTeX} kernel contains the \Macro{clearpage} command, which takes +care that all not yet output floats are output, and then starts a new +page. There exists the instruction \Macro{cleardoublepage} which +works like \Macro{clearpage} but which, in the double-sided layouts +(see layout option \Option{twoside} in +\autoref{sec:typearea.options}, +\DescPageRef{typearea.option.twoside}) starts a new right-hand +page. An empty left page in the current page style is output if +necessary. + +With% +\IfThisCommonLabelBase{maincls}{% + \ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}}% +}{% + \IfThisCommonLabelBase{scrlttr2}{% + \ChangedAt{v3.00}{\Class{scrlttr2}}% + }{}% +} % +\Macro{cleardoubleoddstandardpage}, {\KOMAScript} works as described above. +The \Macro{cleardoubleoddplainpage} command changes the page style of the +empty left page to \PageStyle{plain}\IndexPagestyle{plain} in order to +suppress the \IfThisCommonLabelBase{scrlttr2}{page}{running} head. +Analogously, the page style \PageStyle{empty}\IndexPagestyle{empty} is applied +to the empty page with \Macro{cleardoubleoddemptypage}, suppressing the page +number as well as the \IfThisCommonLabelBase{scrlttr2}{page}{running} +head. The page is thus entirely empty. If another \PName{page style} is wanted +for the interleaf page is may be set with the argument of +\Macro{cleardoubleoddusingpagestyle}. Every already defined \PName{page style} +(see \autoref{cha:scrlayer-scrpage}) may be used. + +\IfThisCommonLabelBase{scrlttr2}{}{% + Sometimes chapters should not start on the right-hand page but the left-hand + page. This is in contradition to the classic typography; nevertheless, it + may be suitable, e.\,g., if the double-page spread of the chapter start is + of special contents. \KOMAScript{} therefor provides the commands + \Macro{cleardoubleevenstandardpage}, \Macro{cleardoubleevenplainpage}, + \Macro{cleardoubleevenemptypage}, and \Macro{cleardoubleevenpageusingstyle}, + which are equivalent to the odd-page commands.% +} + +However, the approach used by the \KOMAScript{} commands +\Macro{cleardoublestandardpage}, \Macro{cleardoubleemptypage}, +\Macro{cleardoubleplainpage}, and \Macro{cleardoublepageusingstyle} is +dependent on the option +\Option{cleardoublepage}\important{\Option{cleardoublepage}} described above +and is similar to one of the corresponding commands above. The same is valid for +the standard command \Macro{cleardoublepage}, that may be either +\Macro{cleardoubleoddpage} or \Macro{cleardoubleevenpage}. + +\IfThisCommonLabelBase{scrlttr2}{% + In \Class{scrlttr2} the other commands are there only for completeness. More + information about them may be found at + \autoref{sec:maincls.emptypage}, + \DescPageRef{maincls.cmd.cleardoublepage} if needed.% +}{}% +\IfThisCommonLabelBase{scrlttr2}{\iffalse}{\csname iftrue\endcsname} +\begin{Example} + \phantomsection\xmpllabel{cmd.cleardoublepage}% + Assume you want to set next in your document a double-page spread + with a picture at the left-hand page and a chapter start at the + right-hand page. The picture should have the same size as the text + area without any head line or pagination. If the last chapter + ends with a left-hand page, an interleaf page has to be added, which + should be completely empty. + + First you will use +\begin{lstcode} + \KOMAoptions{cleardoublepage=empty} +\end{lstcode} + to make interleaf pages empty. You may use this setting at the document + preamble already. As an alternative you may set it as the optional + argument of \DescRef{\ThisCommonLabelBase.cmd.documentclass}. + + At the relevant place in your document, you'll write: +\begin{lstcode} + \cleardoubleevenemptypage + \thispagestyle{empty} + \includegraphics[width=\textwidth,% + height=\textheight,% + keepaspectratio]% + {picture} + \chapter{Chapter Headline} +\end{lstcode} + The first of these lines switches to the next left page. If needed it also + adds a completely blank right-hand page. The second line makes sure that + the following left-hand page will be set using page style + \PageStyle{empty} too. From third down to sixth line, an external picture + of wanted size will be loaded without deformation. Package + \Package{graphicx}\IndexPackage{graphicx} will be needed for this + command. The last line starts a new chapter on the next page which will be + a right-hand one. + \end{Example}% +\fi% + +The commands \Macro{cleardoubleoddpage} respective \Macro{cleardoubleevenpage} +leads to the next odd respectively even page. The page style of an interleaf +page will be set depending on option +\DescRef{\LabelBase.option.cleardoublepage}.% +% +\EndIndexGroup +% +\EndIndexGroup + +%%% Local Variables: +%%% mode: latex +%%% mode: flyspell +%%% coding: us-ascii +%%% ispell-local-dictionary: "en_GB" +%%% TeX-master: "../guide" +%%% End: + +% LocalWords: mutatis mutandis Interleaf interleaf |