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 | 296 |
1 files changed, 172 insertions, 124 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 index 28169a0c58d..36f9fb4ae4d 100644 --- 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 @@ -46,11 +46,12 @@ % ====================================================================== \KOMAProvidesFile{common-interleafpage.tex}% - [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $ + [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $ KOMA-Script guide (common paragraphs: Interleaf Pages)] -\translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi} +\translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi\and + Karl Hagen} -% Date of the translated German file: 2017-01-02 +% Date of the translated German file: 2017-12-07 \section{Interleaf Pages} \seclabel{emptypage}% @@ -59,98 +60,117 @@ \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 + The information in \autoref{sec:\ThisCommonFirstLabelBase.emptypage} applies + equally to this chapter. So if you have already read and understood + \autoref{sec:\ThisCommonFirstLabelBase.emptypage}, you can skip ahead 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 are pages that are inserted between parts of a document. +Traditionally, these pages are completely blank. \LaTeX{}, however, +sets them by default with the current page style. \KOMAScript{} provides +several extensions to this functionality. -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. +Interleaf pages are mostly found in books. Because book chapters commonly +start on the right (recto) page of a two-page spread, an empty left (verso) +page must be inserted if the previous chapter ends on a recto page. For this +reason, interleaf pages really only exist for two-sided printing. +% +\iffalse % Umbruchkorrektur + The blank versos in one-sided printing are not true interleaf pages, + although they may appear as such in counting the printed sheets. +\fi% \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.% + Interleaf pages are unusual in letters. This is not least because two-sided + letters are rare, as letters are usually not bound. Nevertheless, + \KOMAScript{} also supports interleaf pages for two-sided letters. However, + since the commands described here are seldom used in letters, you will not + find any examples here. If necessary, please refer to the examples in + \autoref{sec:maincls.emptypage}, starting on + \autopageref{sec:maincls.emptypage}.% }{}% \begin{Declaration} \OptionVName{cleardoublepage}{page style} \OptionValue{cleardoublepage}{current} \end{Declaration}% -With this option, % -\IfThisCommonLabelBase{maincls}{% +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 +} you can define the page style of the interleaf pages created by the commands \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 +\DescRef{\LabelBase.cmd.cleardoubleevenpage} to advance to the desired page. +You can use any previously 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}{% +\autoref{cha:scrlayer-scrpage} from \autopageref{cha:scrlayer-scrpage}). +In addition, \OptionValue{cleardoublepage}{current} is also possible. +This case corresponds to the default prior to \KOMAScript~2.98c and creates an +interleaf page without changing the page style. Starting with +\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}, +}, the default\textnote{default} follows the recommendation of most +typographers and creates interleaf pages with the +\IfThisCommonLabelBase{scrextend}{% + \DescRef{maincls.pagestyle.empty}}{% + \DescRef{\ThisCommonLabelBase.pagestyle.empty}}\IndexPagestyle{empty} +page style unless you switch compatibility to earlier \KOMAScript{} versions +(see option \DescRef{\ThisCommonLabelBase.option.version}% +\important{\OptionValueRef{\LabelBase}{version}{2.98c}}, \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: + Suppose you want interleaf pages that are empty except for the pagination% + \iffree{, so they are created with \IfThisCommonLabelBase{scrextend}{% + \DescRef{maincls.pagestyle.plain}}{% + \DescRef{\LabelBase.pagestyle.plain}}}{}. You can achieve this, + for example, with: \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}. + You can find more information about the + \IfThisCommonLabelBase{scrextend}{% + \DescRef{maincls.pagestyle.plain}}{\DescRef{\LabelBase.pagestyle.plain}} + page style in \IfThisCommonLabelBase{scrextend}{% + \autoref{sec:maincls.pagestyle}}{% + \autoref{sec:\LabelBase.pagestyle}}, + \IfThisCommonLabelBase{scrextend}{% + \DescPageRef{maincls.pagestyle.plain}}{% + \DescPageRef{\LabelBase.pagestyle.plain}}. \end{Example} \else - \IfThisCommonLabelBase{scrextend}{\iftrue}{\csname iffalse\endcsname} + \IfThisCommonLabelBase{scrextend}{% + You can find an example for setting the page style of interleaf pages in + \autoref{sec:\ThisCommonFirstLabelBase.emptypage}, + \PageRefxmpl{\ThisCommonFirstLabelBase.option.cleardoublepage}.% + \iffalse% Umbruchvariante ohne Beispiel + }{\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: + Suppose you want interleaf pages that are empty except for the pagination, + so they are created with the \IfThisCommonLabelBase{scrextend}{% + \DescRef{maincls.pagestyle.plain}}{\DescRef{\LabelBase.pagestyle.plain}} + page style. You can achieve this with \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}. + You can find more information about the + \DescRef{maincls.pagestyle.plain} page style in + \autoref{sec:maincls.pagestyle}, \DescPageRef{maincls.pagestyle.plain}. \end{Example}% \fi% \fi% @@ -175,81 +195,103 @@ switch compatibility to an earlier version (see option \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. +The\textnote{standard classes} {\LaTeX} kernel provides the \Macro{clearpage} +command, which ensures that all pending floats are output and then starts a +new page. There is also the \Macro{cleardoublepage} command, which works like +\Macro{clearpage} but which starts a new right-hand page in two-sided printing +(see the \Option{twoside} layout option in \autoref{sec:typearea.options}, +\DescPageRef{typearea.option.twoside}). An empty left-hand page in the current +page style is output if necessary. -With% -\IfThisCommonLabelBase{maincls}{% +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. +} \Macro{cleardoubleoddstandardpage}, {\KOMAScript}\textnote{\KOMAScript} +works as exactly in the way just described for the standard classess. The +\Macro{cleardoubleoddplainpage}% +\important{\IfThisCommonLabelBase{scrextend}{% + \DescRef{maincls.pagestyle.plain}}{\DescRef{\LabelBase.pagestyle.plain}}} +command, on the other hand, additionally changes the page style of the empty +left page to \IfThisCommonLabelBase{scrextend}{% + \DescRef{maincls.pagestyle.plain}}{\DescRef{\LabelBase.pagestyle.plain}}% +\IndexPagestyle{plain} in order to suppress the +\IfThisCommonLabelBase{scrlttr2}{page header}{running title}. Likewise, the +\Macro{cleardoubleoddemptypage}\important{% + \IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{% + \DescRef{\LabelBase.pagestyle.empty}}} command uses the +\IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{% + \DescRef{\LabelBase.pagestyle.empty}}\IndexPagestyle{empty} page style to +suppress both \IfThisCommonLabelBase{scrlttr2}{page header and page footer}% +{running title and page number} on the empty left-hand side. The page is thus +completely empty. If you want to specify your own \PName{page style} for the +interleaf page, this should be given as an argument of +\Macro{cleardoubleoddusingpagestyle}. You can use any previously defined +\PName{page style} (see \autoref{cha:scrlayer-scrpage}). \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.% + Sometimes\textnote{odd-side interleaf pages} you want chapters to start not + on the right-hand but on the left-hand page. Although this layout contradicts + classic typography, it can be appropriate if the double-page spread at the + beginning of the chapter very specific contents. For this reason, + \KOMAScript{} provides the \Macro{cleardoubleevenstandardpage} command, + which is equivalent to the \Macro{cleardoubleoddstandardpage} command + except that the next page is a left page. The same applies to the + \Macro{cleardoubleevenplainpage}, \Macro{cleardoubleevenemptypage}, and + \Macro{cleardoubleevenpageusingstyle} commands% + \IfThisCommonLabelBase{maincls}{% Umbruchoptimierungsalternative + , the last of which expects an argument}{}.% } -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} +The \Macro{cleardoublestandardpage}, \Macro{cleardoubleemptypage}, and +\Macro{cleardoubleplainpage} commands, and the single-argument +\Macro{cleardoublepageusingstyle} command, as well as the standard +\Macro{cleardoublepage} command, % +\IfThisCommonLabelBase{maincls}{% + depend on the \DescRef{maincls.option.open}\IndexOption{open}% + \important{\DescRef{maincls.option.open}} option explained in + \autoref{sec:maincls.structure}, \DescPageRef{maincls.option.open} and, + depending on that setting, correspond to one of the commands explained in + the preceding paragraphs. }{% + correspond to the commands previously explained for the + \IfThisCommonLabelBase{scrlttr2}{\Class{scrlttr2} class}{% + \IfThisCommonLabelBase{scrextend}{\Package{scrextend} package}{% + \InternalCommonFileUsageError}% + }% + \IfThisCommonLabelBase{scrlttr2}{. % + The remaining commands are defined in \Class{scrlttr2} for completeness + only. You can find more information on them in + \autoref{sec:maincls.emptypage}, \DescPageRef{maincls.cmd.cleardoublepage} + if necessary% + }{% + \ to transition to the next odd page% + }.% +}% +\IfThisCommonLabelBaseOneOf{scrlttr2,scrextend}{\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 + Suppose you want to insert a double-page spread into your document with a + picture on the left-hand page and a new chapter starting on the right-hand + page. If the previous chapter ends with a left-hand page, an interleaf + page has to be added, which should be completely empty. The picture should + be the same size as the text area without any header or footer. +\iffalse% Umbruchkorrekturtext + First of all, \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}. + ensures that interleaf pages use the + \IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{% + \DescRef{\LabelBase.pagestyle.empty}} page style. You can put this + setting in the document preamble, or you can set it as an optional + argument of \DescRef{\ThisCommonLabelBase.cmd.documentclass}. +\fi - At the relevant place in your document, you'll write: + At the relevant place in your document, write: \begin{lstcode} \cleardoubleevenemptypage \thispagestyle{empty} @@ -257,24 +299,30 @@ the standard command \Macro{cleardoublepage}, that may be either height=\textheight,% keepaspectratio]% {picture} - \chapter{Chapter Headline} + \chapter{Chapter Heading} \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. + The first of these lines switches to the next left-hand page. If needed it + also adds a completely blank right-hand page. The second line makes sure + that the following left-hand page will also be set using the + \IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{% + \DescRef{\LabelBase.pagestyle.empty}} page style. The third through + sixth lines load an image file named \File{picture} and scale it to the + desired size without distorting it. This command requires the + \Package{graphicx}\IndexPackage{graphicx} package (see + \cite{package:graphics}). 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}.% -% +In two-sided printing, \Macro{cleardoubleoddpage} always moves to the next +left-hand page and \Macro{cleardoubleevenpage} to the next right-hand +page. The style of the interleaf page to be inserted if necessary is defined +with the \DescRef{\LabelBase.option.cleardoublepage} option.% +\IfThisCommonLabelBase{scrextend}{\par% + For an example that uses \Macro{cleardoubleevenemptypage}, see + \autoref{sec:maincls.emptypage}, + \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.cleardoublepage}.% +}{}% \EndIndexGroup % \EndIndexGroup |