summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/english/common-interleafpage.tex
diff options
context:
space:
mode:
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.tex296
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