partpagestyle}{empty}
As mentioned previously on
page 77
, the page style empty is exactly what is re-
quired in this example. Naturally you can also use a user-defined page style.
Assume you have defined your own page style for initial chapter pages with the
package scrlayer-scrpage (see
chapter 5
). You have given to this page style the
fitting name chapter. To actually use this style, you must redefine the macro
\chapterpagestyle
accordingly:
\renewcommand*{\chapterpagestyle}{chapter}
Assume that you want the table of contents of a book to have no page numbers.
However, everything after the table of contents should work again with the page
style headings, as well as with plain on every first page of a chapter. You can
use the following commands:
\clearpage
\pagestyle{empty}
\renewcommand*{\chapterpagestyle}{empty}
\tableofcontents
\clearpage
\pagestyle{headings}
\renewcommand*{\chapterpagestyle}{plain}
Instead of the above you may do a local redefinition using a group. The advantage
will be that you do not need to know the current page style before the change to
switch back at the end.
\clearpage
\begingroup
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
81
numbering style example description
arabic
8
Arabic numbers
roman
viii
lower-case Roman numbers
Roman
VIII
upper-case Roman numbers
alph
h
letters
Alph
H
capital letters
Table 3.10.: Available numbering
styles of page numbers
\pagestyle{empty}
\renewcommand*{\chapterpagestyle}{empty}
\tableofcontents
\clearpage
\endgroup
But notice that you never should put a numbered head into a group. Otherwise
you may get funny results with commands like \label.
Whoever thinks that it is possible to put running headings on the first page of a chapter by
using the command
\renewcommand*{\chapterpagestyle}{headings}
should read more about the background of \rightmark at
section 21.1
,
page 441
.
\pagenumbering{numbering style }
This command works the same way in KOMA-Script as in the standard classes. More precisely
it is a feature neither of the standard classes nor of the KOMA-Script classes but of the L
A
TEX
kernel. You can specify with this command the numbering style of page numbers.
The changes take effect immediately, hence starting with the page that contains the com-
mand. It is recommended to use
\cleardoubleoddpage
to close the last page and start a new
odd page before. The possible settings can be found in
table 3.10
.
Using the command \pagenumbering also resets the page counter. Thus the page number
of the next page which TEX outputs will have the number 1 in the style numbering style .
3.13. Interleaf Pages
Interleaf pages are pages that are intended to stay blank. Originally these pages were really
completely white. L
A
TEX, 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. KOMA-Script 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
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
82
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.
cleardoublepage=page style
cleardoublepage=current
With this option,
v3.00
you may define the page style of the interleaf pages created by the
\cleardoublepage
,
\cleardoubleoddpage
, or
\cleardoubleevenpage
to break until the
wanted page. Every already defined page style (see
section 3.12
from
page 76
and
chapter 5
from
page 225
) may be used. Besides this, cleardoublepage=current is valid. This case
is the default until KOMA-Script 2.98c and results in interleaf page without changing the
page style. Since KOMA-Script 3.00
v3.00
the default follows the recommendation of most typogra-
phers and has been changed to blank interleaf pages with page style empty unless you switch
compatibility to an earlier version (see option
version
,
section 3.2
,
page 53
).
Example: Assume you want interleaf pages almost empty but with pagination. This means
you want to use page style plain. You may use following to achieve this:
\KOMAoptions{cleardoublepage=plain}
More information about page style plain may be found at
section 3.12
,
page 78
.
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
83
\clearpage
\cleardoublepage
\cleardoublepageusingstyle{page style }
\cleardoubleemptypage
\cleardoubleplainpage
\cleardoublestandardpage
\cleardoubleoddpage
\cleardoubleoddpageusingstyle{page style }
\cleardoubleoddemptypage
\cleardoubleoddplainpage
\cleardoubleoddstandardpage
\cleardoubleevenpage
\cleardoubleevenpageusingstyle{page style }
\cleardoubleevenemptypage
\cleardoubleevenplainpage
\cleardoubleevenstandardpage
The L
A
TEX kernel contains the \clearpage command, which takes care that all not yet output
floats are output, and then starts a new page. There exists the instruction \cleardoublepage
which works like \clearpage but which, in the double-sided layouts (see layout option twoside
in
section 2.4
,
page 38
) starts a new right-hand page. An empty left page in the current page
style is output if necessary.
With
v3.00
\cleardoubleoddstandardpage
, KOMA-Script works as described above. The
\cleardoubleoddplainpage
command changes the page style of the empty left page to plain
in order to suppress the running head. Analogously, the page style empty is applied to the
empty page with \cleardoubleoddemptypage, suppressing the page number as well as the
running head. The page is thus entirely empty. If another page style is wanted for the
interleaf page is may be set with the argument of \cleardoubleoddusingpagestyle. Every
already defined page style (see
chapter 5
) may be used.
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. KOMA-Script there-
for provides the commands \cleardoubleevenstandardpage, \cleardoubleevenplainpage,
\cleardoubleevenemptypage
, and \cleardoubleevenpageusingstyle, which are equivalent
to the odd-page commands.
However, the approach used by the KOMA-Script commands \cleardoublestandardpage,
\cleardoubleemptypage
, \cleardoubleplainpage, and \cleardoublepageusingstyle is
dependent on the option cleardoublepage described above and is similar to one of the corre-
sponding commands above. The same is valid for the standard command \cleardoublepage,
that may be either \cleardoubleoddpage or \cleardoubleevenpage.
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
84
Example: 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
\KOMAoptions{cleardoublepage=empty}
to make interleaf pages empty. You may use this setting at the document pream-
ble already. As an alternative you may set it as the optional argument of
\documentclass
.
At the relevant place in your document, you’ll write:
\ cleardoubleevenemptypage
\thispagestyle{empty}
\includegraphics[width=\textwidth,%
height=\textheight,%
keepaspectratio]%
{picture}
\chapter{Chapter Headline}
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 empty too. From third down to sixth line,
an external picture of wanted size will be loaded without deformation. Package
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 commands \cleardoubleoddpage respective \cleardoubleevenpage leads to the next
odd respectively even page. The page style of an interleaf page will be set depending on option
cleardoublepage
.
3.14. Footnotes
KOMA-Script, unlike the standard classes, provides features for configuration of the footnote
block format.
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
85
Table 3.11.: Available values for option footnotes setting up footnotes
multiple
At sequences of immediately following footnote marks, consecutive marks will be
separated by
\multfootsep
.
nomultiple
Immediately following footnotes will be handled like single footnotes and not sepa-
rated from each other.
footnotes=setting
Footnotes
v3.00
will be marked with a tiny superscript number in text by default. If more than one
footnote falls at the same place, one may think that it is only one footnote with a very large
number instead of multiple footnotes (i. e., footnote 12 instead of footnotes 1 and 2). Using
footnotes=multiple
will separate multiple footnotes immediately next to each other by a
separator string. The predefined separator at
\multfootsep
is a single comma without space.
The whole mechanism is compatible with package footmisc, Version 5.3d (see [
Fai11
]). It is
related not only to footnotes placed using
\footnote
, but
\footnotemark
too.
Command
\KOMAoptions
or
\KOMAoption
may be used to switch back to the default
footnotes=nomultiple
at any time. If any problems using another package that influences
footnotes occur, it is recommended not to use the option anywhere and not to change the
setting
anywhere inside the document.
A summary of the available setting values of footnotes may be found at
table 3.11
.
\footnote[number ]{text }
\footnotemark[ number ]
\footnotetext[number ]{text }
\multiplefootnoteseparator
\multfootsep
Similar to the standard classes, footnotes in KOMA-Script are produced with the
\footnote
command, or alternatively the paired usage of the commands \footnotemark
and \footnotetext. As in the standard classes, it is possible that a page break occurs within
a footnote. Normally this happens if the footnote mark is placed so near the bottom of a page
as to leave L
A
TEX no choice but to break the footnote onto the next page. KOMA-Script
v3.00
,
unlike the standard classes, can recognize and separate consecutive footnotes automatically.
See the previously documented option
footnotes
for this.
If you want to set the separator manually, you may use \multiplefootnoteseparator.
Note that this command should not be redefined, because it has been defined not only to be
the separator string but also the type style, i. e., font size and superscript. The separator
string without type style may be found at \multfootsep. The predefined default is
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
86
\newcommand*{\multfootsep}{,}
and may be changed by redefining the command.
Example: Assume you want to place two footnotes following a single word. First you may
try
Word\ footnote{1st footnote}\ footnote{2nd footnote}
for this. Assume that the footnotes will be numbered with 1 and 2. Now the reader
may think it’s a single footnote 12, because the 2 immediately follows the 1. You
may change this using
\KOMAoptions{footnotes=multiple}
which would switch on the automatic recognition of footnote sequences. As an
alternative you may use
Word\footnote{1st footnote}%
\multiplefootnoteseparator
\footnote{2nd footnote}
This should give you the wanted result even if the automatic solution would fail
or could not be used.
Further, assume you want the footnotes separated not only by a single comma,
but by a comma and a white space. In this case you may redefine
\renewcommand*{\multfootsep}{,\nobreakspace}
at the document preamble. \nobreakspace instead of a usual space character has
been used in this case to avoid paragraph or at least page breaks within footnote
sequences.
\footref{reference }
Sometimes
v3.00
there are single footnotes to multiple text passages. The least sensible way to
typeset this would be to repeatedly use
\footnotemark
with the same manually set number.
The disadvantages of this method would be that you have to know the number and manually fix
all the
\footnotemark
commands, and if the number changes because of adding or removing
a footnote before, each
\footnotemark
would have to be changed. Because of this, KOMA-
Script provides the use of the \label mechanism in such cases. After simply setting a \label
inside the footnote, \footref may be used to mark all the other text passages with the same
footnote mark.
Example: Maybe you have to mark each trade name with a footnote which states that it is
a registered trade name. You may write, e. g.,
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
87
Figure 3.1.: Parameters that con-
trol the footnote layout
first paragraph of a footnote
next paragraph of a footnote
-
parindent
-
indent
-
mark width
Company SplishSplash\footnote{This is a registered trade name.
All rights are reserved.\label{refnote}}
produces not only SplishPlump\footref{refnote}
but also SplishPlash\footref{refnote}.
This will produce the same footnote mark three times, but only one footnote
text. The first footnote mark is produced by
\footnote
itself, and the following
two footnote marks are produced by the additional \footref commands. The
footnote text will be produced by
\footnote
.
Because of setting the additional footnote marks using the \label mechanism, changes of the
footnote numbers will need at least two L
A
TEX runs to ensure correct numbers for all \footref
marks.
\deffootnote[mark width ]{indent }{parindent }{definition }
\deffootnotemark{definition }
\thefootnotemark
Footnotes are formatted slightly differently in KOMA-Script to in the standard classes. As
in the standard classes the footnote mark in the text is depicted using a small superscripted
number. The same formatting is used in the footnote itself. The mark in the footnote is
type-set right-aligned in a box with width mark width . The first line of the footnote follows
directly.
All following lines will be indented by the length of indent . If the optional parameter
mark width
is not specified, it defaults to indent . If the footnote consists of more than one
paragraph, then the first line of a paragraph is indented, in addition to indent , by the value
of parindent .
Figure 3.1
at
page 87
llustrates the layout parameters. The default configuration of the
KOMA-Script classes is:
\deffootnote[1em]{1.5em}{1em}
{\textsuperscript{\thefootnotemark}}
\textsuperscript
controls both the superscript and the smaller font size. Command
\thefootnotemark
is the current footnote mark without any formatting.
The
v2.8q
ont element footnote determines the font of the footnote including the footnote mark.
Using the element footnotelabel the font of the footnote mark can be changed separately
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
88
with the commands
\setkomafont
and
\addtokomafont
(see
section 3.6
,
page 57
). Please
refer also to
table 3.2
,
page 58
. Default setting is no change in the font.
The footnote mark in the text is defined separately from the mark in front of the actual
footnote. This is done with \deffootnotemark. Default setting is:
\deffootnotemark{%
\textsuperscript{\thefootnotemark}}
In the above
v2.8q
the font for the element footnotereference is applied (see
table 3.2
,
page 58
).
Thus the footnote marks in the text and in the footnote itself are identical. The font can be
changed with the commands
\setkomafont
and
\addtokomafont
(see
section 3.6
,
page 57
).
Example: A feature often asked for is footnote marks which are neither in superscript nor in
a smaller font size. They should not touch the footnote text but be separated by
a small space. This can be accomplished as follows:
\deffootnote{1em}{1em}{\thefootnotemark\ }
The footnote mark and the following space are therefore set right-aligned into a
box of width 1 em. The following lines of the footnote text are also indented by
1 em from the left margin.
Another often requested footnote layout is left-aligned footnote marks. These can
be obtained with:
\deffootnote{1.5em}{1em}{%
\makebox[1.5em][l]{\thefootnotemark}}
If you want however only to change the font for all footnotes, for example to sans
serif, you can solve this problem simply by using the commands
\setkomafont
and
\addtokomafont
(see
section 3.6
,
page 57
):
\setkomafont{footnote}{\sffamily}
As demonstrated with the examples above, the simple user interface of KOMA-Script provides
a great variety of different footnote formattings.
\setfootnoterule[thickness ]{length }
Generally
v3.06
a horizontal rule will be placed between the text area and the footnote area.
But normally this rule is not as long as the width of the typing area. With Command
\setfootnoterule
you may change the thickness and the width of that rule. Thereby the
parameters thickness and length will be evaluated not at definition time but when setting
the rule itself. If optional argument thickness ha been omitted the thickness of the rule will
not be changed. Empty arguments thickness or length are also allowed and do not change
the corresponding parameter. Using implausible values may result in warning messages not
only setting the arguments but also when KOMA-Script uses the parameters.
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
89
With element footnoterule the color
v3.07
of the rule may be changed using the commands
\setkomafont
and
\addtokomafont
for element footnoterule (see
section 3.6
,
page 57
).
Default is no change of font or color. For color changes a color package like xcolor would be
needed.
3.15. Demarcation
scrbook
Sometimes books are roughly separated into front matter, main matter, and back matter.
KOMA-Script provides this for scrbook also.
\frontmatter
\mainmatter
\backmatter
The macro \frontmatter introduces the front matter in which roman numerals are used for
the page numbers. Chapter headings in a front matter are not numbered. The section titles
which would be numbered start at chapter 0, and would be consecutively numbered across
chapter boundaries. However, this is of no import, as the front matter is used only for the
title pages, table of contents, lists of figures and tables, and a foreword. The foreword can
thus be set as a normal chapter. A foreword should never be divided into sections but kept
as short as possible. Therefore, in the foreword there is no need for a deeper structuring than
the chapter level.
In case the user sees things differently and wishes to use numbered sections in the chapters
of the front matter, as of version 2.97e
v2.97e
the section numbering no longer contains the chapter
number. This change only takes effect when the compatibility option is set to at least ver-
sion 2.97e (see option
version
,
section 3.2
,
page 53
). It is explicity noted that this creates a
confusion with chapter numbers! The use of
\addsec
and
\section*
(see
section 3.16
,
page 99
and
page 100
) are thus, in the author’s opinion, far more preferable.
As of version 2.97e
v2.97e
the numbering of float environments, such as tables and figures, and
equation numbers in the front matter also contain no chapter number part. To take effect this
too requires the corresponding compatibility setting (see option
version
,
section 3.2
,
page 53
).
\mainmatter
introduces the main matter with the main text. If there is no front matter,
then this command can be omitted. The default page numbering in the main matter uses
Arabic numerals (re)starting in the main matter at 1.
The back matter is introduced with \backmatter. Opinions differ in what should be part
of the back matter. So in some cases you will find only the bibliography, in some cases only
the index, and in other cases both of these as well as the appendices. The chapters in the
back matter are similar to the chapters in the front matter, but page numbering is not reset.
If you do require separate page numbering you may use the command
\pagenumbering
from
section 3.12
,
page 81
.
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
90
Table 3.12.: Available values for option open to select page breaks with interleaf pages using scrbook
or scrreprt
any
Parts, chapter, index, and back matter use
\clearpage
instead of
\cleardoublepage
;
\cleardoublepageusingstyle
,
\cleardoublestandardpage
,
\cleardoubleplainpage
,
\cleardoubleemptypage
,
and
\cleardoublepage
behaves same like using open=right.
left
Part, chapter, index and back matter use
\cleardoublepage
;
\cleardoublepageusingstyle
,
\cleardoublestandardpage
,
\cleardoubleplainpage
,
\cleardoubleemptypage
,
and
\cleardoublepage
result in a page break and add an interleaf page if needed
to reach the next left-hand page.
right
Part, chapter, index and back matter use
\cleardoublepage
;
\cleardoublepageusingstyle
,
\cleardoublestandardpage
,
\cleardoubleplainpage
,
\cleardoubleemptypage
,
and
\cleardoublepage
result in a page break and add an interleaf page if needed
to reach the next right-hand page.
3.16. Structuring of Documents
Structuring of documents means to divide them into parts, chapters, sections, and several
other structural elements.
open=method
scrbook
,
scrreprt
KOMA-Script classes scrbook and scrreprt give you the choice of where to start a new chapter
with double-sided printing. By default scrreprt starts a new chapter at the next page. This is
like method any. However, scrbook starts new chapters at the next right-hand page. This is
like method right and is usually used in books. But sometimes chapters should start at the
left-hand page of a double-page spread. This would be accomplished with method left
v3.00
. An
overview of the supported methods may be found at
table 3.12
. The table also describes the
effect on
\cleardoublepage
,
\cleardoublepageusingstyle
,
\cleardoublestandardpage
,
\cleardoubleplainpage
, and
\cleardoubleemptypage
(see
section 3.13
,
page 83
).
Since L
A
TEX does not differentiate between left-hand and right-hand pages in single-sided
printing, the option does not have any influence in that case.
In class scrartcl the section is the first structural element below the part. Because of this,
scrartcl does not support this option.
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
91
chapterprefix=simple switch
appendixprefix=simple switch
\IfChapterUsesPrefixLine{then code }{else code }
With the standard classes book and report, a chapter title consists of a line with the word
scrbook
,
scrreprt
“Chapter”
1
followed by the chapter number. The title itself is set left-justified on the following
lines. The same effect is obtained in KOMA-Script with the option chapterprefix. Any
value from table
table 2.5
,
page 39
may be used as simple switch . The default, however,
is chapterprefix=false, which is opposite of the behaviour of the standard classes, which
would correspond to chapterprefix=true. These options also affect the automatic running
titles in the headers (see
section 3.12
,
page 77
).
Sometimes one wishes to have the chapter titles in simplified form according to
chapterprefix=false
. But at the same time, one wishes a title of an appendix to be pre-
ceded by a line with “Appendix” followed by the appendix letter. This is achieved by using
the appendixprefix option (see
table 2.5
,
page 39
). Since this results in an inconsistent
document layout, I advise against using this option. Final consequence of using the option is,
that
\appendix
changes setting of option chapterprefix.
You
v3.18
can execute code depending on the current setting for the chapter preceding line using
\IfChapterUsesPrefixLine
. If chapterprefix is currently active, the then code will be
executed, otherwise the else code .
The font style of the chapter number line using chapterprefix=true or appendixprefix=
true
may be changed with element chapterprefix
v2.96a
using commands
\setkomafont
and
\addtokomafont
(see
section 3.6
,
page 57
). Default is the usage of element
chapter
(see
page 95
, as well as
table 3.15
,
page 98
).
headings=selection
The font size used for the titles is relatively big, both with the standard classes and with
KOMA-Script. Not everyone likes this choice; moreover it is especially problematic for small
paper sizes. Consequently, KOMA-Script provides, besides the large title font size defined
by the headings=big
v3.00
option, the two options headings=normal and headings=small, that
allow for smaller title font sizes. The font sizes for headings resulting from these options for
scrbook and scrreprt are shown in
table 3.15
,
page 98
. Respectively, the fonts of the elements
chapter
,
section
,
subsection
,
subsubsection
,
paragraph
, and
subparagraph
will be reset
to these default.
For scrartcl, smaller font sizes are generally used. The spacing before and after chapter titles
scrbook
,
scrreprt
is also influenced by these options.
Chapter titles are also influenced by the options headings=twolinechapter and
headings=onelinechapter
, that are same as
chapterprefix=true
and
chapterprefix=
false
(see above). The appendix titles are influenced by headings=twolineappendix and
1
When using another language the word “Chapter” is naturally translated to the appropriate language.
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
92
headings=onelineappendix
, that are the same as the options
appendixprefix=true
and
appendixprefix=false
(see also above).
The method of beginning new chapters may be switched by headings=openany, headings=
scrbook
,
scrreprt
openright
, and headings=openleft alternatively to option
open
with the values any, right,
and left (see above).
Another
v3.10
special feature of KOMA-Script is the handling of the optional argument of the
structural commands
\part
,
\chapter
, etc., down to
\subparagraph
. Function and mean-
ing may be influenced by the options headings=optiontohead, headings=optiontotoc, and
headings=optiontoheadandtoc
.
A summary of all the available selections of option headings may be found in
table 3.13
.
Examples are at the following description of the structural commands.
Table 3.13.: Available values for option headings to select different kinds of structural headings
big
Use very large headings with large distances above and below.
normal
Use mid-size headings with medium distances above and below.
onelineappendix
, noappendixprefix, appendixwithoutprefix,
appendixwithoutprefixline
Chapter headings at the appendix will be set like other headings too.
onelinechapter
, nochapterprefix, chapterwithoutprefix,
chapterwithoutprefixline
Chapter headings will be set like other headings too.
openany
The commands
\cleardoublepageusingstyle
,
\cleardoublestandardpage
,
\cleardoubleplainpage
,
\cleardoubleemptypage
, and
\cleardoublepage
be-
have same like using headings=openright.Parts, chapter, index, and back matter
use
\clearpage
instead of
\cleardoublepage
.
openleft
The commands
\cleardoublepageusingstyle
,
\cleardoublestandardpage
,
\cleardoubleplainpage
,
\cleardoubleemptypage
,
and
\cleardoublepage
generate a page break and if needed insert an interleaf page to reach the next
left-hand page at double-page printing.Part, chapter, index and back matter use
\cleardoublepage
.
. . .
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
93
Table 3.13.: Available values for option headings (continuation)
openright
The commands
\cleardoublepageusingstyle
,
\cleardoublestandardpage
,
\cleardoubleplainpage
,
\cleardoubleemptypage
,
and
\cleardoublepage
generate a page break and if needed insert an interleaf page to reach the next
right-hand page at double-page printing.Part, chapter, index and back matter use
\cleardoublepage
.
optiontohead
The
v3.10
advanced functionality of the optional argument of the structural commands
\part
down to
\subparagraph
will be activated. By default the optional argument
will be used for the running head only.
optiontoheadandtoc
, optiontotocandhead
The
v3.10
advanced functionality of the optional argument of the structural commands
\part
down to
\subparagraph
will be activated. By default the optional argument
will be used for the running head and the table of contents.
optiontotoc
The
v3.10
advanced functionality of the optional argument of the structural commands
\part
down to
\subparagraph
will be activated. By default the optional argument
will be used for the table of contents only.
small
Use small headings with small distances above and below.
twolineappendix
, appendixprefix, appendixwithprefix, appendixwithprefixline
Chapters at the appendix will be set with a number line with the contents of
\chapterformat
.
twolinechapter
, chapterprefix, chapterwithprefix, chapterwithprefixline
Chapters will be set with a number line with the contents of
\chapterformat
.
numbers=selection
In German, according to
DUDEN
, the numbering of sectional units should have no period at the
end if only arabic numbers are used (see [
DUD96
, R 3]). On the other hand, if roman numerals or
letters are appear in the numbering, then a period should appear at the end of the numbering (see
[
DUD96
, R 4]). KOMA-Script has an internal mechanism that tries to implement this somewhat
complex rule. The resulting effect is that, normally, after the sectional commands
\part
and
\appendix
a switch is made to numbering with an ending period. The information is saved in the
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
94
Table 3.14.: Available values of option numbers for selection of the period at the end of numbers of
structural headings
autoendperiod
, autoenddot, auto
KOMA-Script decides, whether or not to set the period at the end of the numbers.
The numbers consists in Arabic digits only, the period will be omitted. If there are
alphabetic characters or roman numbers the period will always be set. References
to numbers will be set without ending period always.
endperiod
, withendperiod, periodatend, enddot, withenddot, dotatend
All numbers of structural commands and all dependent numbers will be set with
ending period. Only references will be set without the ending period.
noendperiod
, noperiodatend, noenddot, nodotatend
All the numbers are without ending period.
aux
file and takes effect on the next L
A
TEX run.
In some cases the mechanism for placing or leaving off the ending period may fail, or
other languagues may have different rules. Therefore it is possible to activate the use of
the ending period manually with the option numbers=endperiod or to deactivate it with
numbers=noendperiod
. Default is numbers=autoendperiod with auto detection whether to
set the period or not.
Please note that the mechanism only takes effect on the next L
A
TEX run. Therefore, before
trying to use these options to forcibly control the numbering format, a further run without
changing any options should be made.
The available values are summarized in
table 3.14
. Unlike most other selections, this option
may be changed at the document preamble, before \begin{document}, only.
chapteratlists
chapteratlists=value
As mentioned in
section 3.20
,
page 133
, normally, every chapter entry generated with
\chapter
scrbook
,
scrreprt
introduces vertical spacing into the lists of floats. Since version 2.96a
v2.96a
this applies also for the
command
\addchap
, if no compatibility option to an earlier version was chosen (see option
version
in
section 3.2
,
page 53
).
Furthermore, now the option chapteratlists can be used to change the spacing, by passing
the desired distance as value . The default setting with
listof=chaptergapsmall
is 10 pt.
If chapteratlists=entry or chapteratlists without value is specified, then instead of a
vertical distance, the chapter entry itself will be entered into the lists. This will be done even
if there’s no floating environment inside of the chapter.
Please note that changes to the option will only become effective in the lists following two
more L
A
TEX runs.
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
95
\part[short version ]{heading }
\chapter[short version ]{heading }
\section[short version ]{heading }
\subsection[short version ]{heading }
\subsubsection[short version ]{heading }
\paragraph[short version ]{heading }
\subparagraph[short version ]{heading }
The standard sectioning commands in KOMA-Script work in a similar fashion to those of the
standard classes. Thus, an alternative entry for the table of contents and running headings
can be specified as an optional argument to the sectioning commands.
In addition to this, with
v3.10
option
headings=optiontohead
, KOMA-Script does not use the
optional argument short version at the table of contents, but for the running head only.
Nevertheless, such a running head needs an appropriate page style. See
section 3.12
and
chapter 5
about this. With option
headings=optiontotoc
, KOMA-Script does not use the
optional argument short version for the running head, but at the table of contents. Nev-
ertheless, the entry will be shown only if counter
tocdepth
(see
section 3.9
,
page 72
) is great
enough. With option
headings=optiontoheadandtoc
, KOMA-Script uses the optional argu-
ment short version in both the table of contents and running head. All these three selections
will also activate the extended interpretation of the optional argument short version , which
is not active by default.
The
v3.10
extended interpretation of the optional argument determines whether there’s an equal-
ity sign in short version . If so, the optional argument will be interpreted as option
list
instead of simple short version . Thereby the two options head=running head and
tocentry=table of contents entry
are supported. Commas or equality signs inside of the
values of those options will be accepted only if they are enclosed by braces.
Please note that this mechanism is only functional as long as KOMA-Script controls the
described commands. From using a package that controls the sectioning commands or the
internal L
A
TEX kernel commands for sectioning commands, KOMA-Script can no longer provide
this extended mechanism. This is also valid for the always active extension of KOMA-Script
to not create entries to the table of contents if the text of the entry is empty. If you really
want an entry with empty heading text, you may use an invisible entry like \mbox{} instead.
Example: Assume you’re writing a document with some very extensive chapter headings.
These headings should be shown in the table of contents too. But for the running
head you want only single-line short headings. You will do this using the optional
argument of \chapter.
\chapter[short version of chapter heading]
{The Structural Sectioning Command
for Chapters Supports not only the
Heading Text itself but also a
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
96
Short Version with Selectable
Usage}
Sometimes later you become aware that the automatic line breaking of this heading
is somehow inappropriate. Therefore you want to make the breaking yourself. Nev-
ertheless, the automatic line breaking should be still used at the table of contents.
With
\chapter[head={short version of chapter heading},
tocentry={The Structural Sectioning
Command for Chapters Supports not
only the Heading Text itself but
also a Short Version with
Selectable Usage}]
{The Structural\\
Sectioning Command for Chapters\\
Supports not only\\
the Heading Text itself\\
but also\\
a Short Version\\
with Selectable Usage}
you use independent entries for table of contents, running head, and the chapter
heading itself. The arguments of the options head and tocentry have been en-
closed into braces, so the contents of the options cannot influence the interpretation
of the optional argument.
The recommendation of the braces in the example above will make more sense
with one more example. Assume you’re using option
headings=optiontotoc
and
now have a heading:
\section[head=\emph{value}]
{Option head=\emph{value}}
This would result in the entry “Option head=value” at the table of contents but
“value” at the running head. But surely you wanted the entry “head=value” at
the table of contents and the complete heading text at the running head. You may
do this using braces:
\section[head{=}\emph{value}]
{Option head=\emph{value}}
A similar case would be a comma. With the same
headings
option like before:
\section[head=0, 1, 2, 3, \dots]
{Natural Numbers Including the Zero}
would result in an error, because the comma would be interpreted as the separator
between the single options of the option list “0, 1, 2, 3, \dots”. But writing
Chapter 3: The Main Classes: scrbook, scrreprt, and scrartcl
97
\section[head={0, 1, 2, 3, \dots}]
{Natural Numbers Including the Zero}
will change “0, 1, 2, 3, \dots” into the argument of option head.
The title of the level part (\part) is distinguished from other sectioning levels by being
numbered independently from the other parts. This means that the chapter level (in scrbook or
scrreprt), or the section level (in scrartcl) is numbered consecutively over all parts. Furthermore,
for classes scrbook and scrreprt, the title of the part level together with the corresponding
scrbook
,
scrreprt
preamble (see \setpartpreamble,
page 107
) is set on a separate page.
\chapter
only exists in book or report classes, that is, in classes book, scrbook, report and
scrbook
,
scrreprt
scrreport, but not in the article classes article and scrartcl. In addition to this, the command
\chapter
in KOMA-Script differs substantially from the version in the standard class. In the
standard classes the chapter number is used together with the prefix “Chapter”, or the corre-
sponding word in the appropriate language, on a separate line above the actual chapter title
text. This overpowering style is replaced in KOMA-Script by a simple chapter number before
the chapter heading text, but can be reverted by the option
chapterprefix
(see
page 91
).
Please note that \part and \chapter in classes scrbook and scrreprt change the page style for
scrbook
,
scrreprt
one page. The applied page style in KOMA-Script is defined in the macros
\partpagestyle
and
\chapterpagestyle
(see
section 3.12
,
page 79
).
The font of all headings
v2.8p
can be changed with the commands
\setkomafont
and
\addtokomafont
(see
section 3.6
,
page 57
). In doing this, generally the element disposition
is used, followed by a specific element for every section level (see
table 3.2
,
page 58
). There
is a separate element partnumber for the number part of parts. The font for the element
disposition
is predefined as \normalcolor\sffamily\bfseries. The default font size for
the specific elements depends on the options
headings=big
,
headings=normal
and
headings=
small
(see
page 91
). The defaults are listed in
table 3.15
.
Example: Suppose you are using the class option
headings=big
and notice that the very big
headings of document parts are too bold. You could change this as follows:
\setkomafont{disposition}{\normalcolor\sffamily}
\ Dostları ilə paylaş: |