summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/koma-script/source-doc/english/common-titles.tex
blob: 3baf017cb6f663232bc408567b411769f6f953f9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
% ======================================================================
% common-titles.tex
% Copyright (c) Markus Kohm, 2001-2019
%
% 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-titles.tex
% Copyright (c) Markus Kohm, 2001-2019
%
% 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-titles.tex}
                 [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
                  KOMA-Script guide (common paragraphs)]

\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and
	Karl Hagen}

% Date of the translated German file: 2019-10-10

\section{Document Titles}
\seclabel{titlepage}%
\BeginIndexGroup
\BeginIndex{}{title}%

\IfThisCommonFirstRun{}{%
  This information in \autoref{sec:\ThisCommonFirstLabelBase.titlepage}
  largely applies to this chapter. So if you have already read and understood
  \autoref{sec:\ThisCommonFirstLabelBase.titlepage}, you  can skip to 
  \autoref{sec:\ThisCommonLabelBase.titlepage.next},
  \autopageref{sec:\ThisCommonLabelBase.titlepage.next}.%
}%
\IfThisCommonLabelBase{scrextend}{\iftrue}{\csname iffalse\endcsname}%
  \ However,\textnote{Attention!} the capabilities of \Package{scrextend}
  for handling the document title are part of the optional, advanced
  features. Therfore they are only available, if
  \OptionValueRef{\ThisCommonLabelBase}{extendedfeature}{title} is
  selected while loading the package (see
  \autoref{sec:\ThisCommonLabelBase.optionalFeatures},
  \DescRef{\ThisCommonLabelBase.option.extendedfeature}).

  Furthermore, \Package{scrextend} cannot be used with a \KOMAScript{}
  class. Because of this, you should replace
\begin{lstcode}
  \documentclass{scrbook}
\end{lstcode}
  with
\begin{lstcode}
  \documentclass{book}
  \usepackage[extendedfeature=title]{scrextend}
\end{lstcode}
  for all examples from \autoref{sec:maincls.titlepage}, if you want to
  try them with \Package{scrextend}.
\fi

In general, we distinguish two kinds of document titles. First, there are
title pages. These include title of the document, together with additional
information such as the author, on a separate page. In addition to the main
title page, there may be several other title pages, such as the half-title or
bastard title, publisher data, dedication, and so on. Second, there is the
in-page title. This kind of title appears at the top of a new page, usually
the first, and is specially emphasized. It too may be accompanied by
additional information, but it will be followed by more material on the same
page, for example by an abstract, the table of contents, or even a section.


\begin{Declaration}
  \OptionVName{titlepage}{simple switch}%
  \OptionValue{titlepage}{firstiscover}
  \Macro{coverpagetopmargin}
  \Macro{coverpageleftmargin}
  \Macro{coverpagerightmargin}
  \Macro{coverpagebottommargin}
\end{Declaration}%
This option\IfThisCommonLabelBase{maincls}{%
	\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
		\Class{scrartcl}}%
}{} determines whether to use document title pages\Index{title>pages} or
in-page titles\Index{title>in-page} when using
\DescRef{\ThisCommonLabelBase.cmd.maketitle} (see
\DescPageRef{\ThisCommonLabelBase.cmd.maketitle}). Any value from
\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} can be used
for \PName{simple switch}.

With the \OptionValue{titlepage}{true}%
\important{\OptionValue{titlepage}{true}}
\IfThisCommonLabelBase{scrextend}{}{or \Option{titlepage}} option,
invoking \DescRef{\ThisCommonLabelBase.cmd.maketitle} creates titles on
separate pages. These pages are set inside a
\DescRef{\ThisCommonLabelBase.env.titlepage} environment, and they
normally have neither header nor footer. Compared to standard {\LaTeX},
{\KOMAScript} significantly expands the handling of the titles. These
additional elements can be found on the following pages.

In contrast, with the
\OptionValue{titlepage}{false}\important{\OptionValue{titlepage}{false}}
option, invoking \DescRef{\ThisCommonLabelBase.cmd.maketitle} creates an
\emph{in-page} title. This means that the title is specially emphasized, but
it may be followed by more material on the same page, for instance an abstract
or a section.%

The third choice,%
\IfThisCommonLabelBase{maincls}{%
  \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
    \Class{scrartcl}}%
}{%
  \IfThisCommonLabelBase{scrextend}{%
    \ChangedAt{v3.12}{\Package{scrextend}}%
  }{\InternalCommonFileUseError}%
} \OptionValue{titlepage}{firstiscover}%
\important{\OptionValue{titlepage}{firstiscover}} not only activates title
pages but also prints the first title page of
\DescRef{\ThisCommonLabelBase.cmd.maketitle}\IndexCmd{maketitle}, i.\,e.
either the half-title or the main title, as a cover\Index{cover} page. Any
other setting of the \Option{titlepage} option will cancel this setting. The
margins\important{\Macro{coverpage\dots margin}} of the cover page are given
by \Macro{coverpagetopmargin}, \Macro{coverpageleftmargin},
\Macro{coverpagerightmargin}, and \Macro{coverpagebottommargin}. The defaults
of these depend on the lengths of \Length{topmargin}\IndexLength{topmargin}
and \Length{evensidemargin}\IndexLength{evensidemargin} and can be changed
with \Macro{renewcommand}.

\IfThisCommonLabelBase{maincls}{%
  The default of the \Class{scrbook} and \Class{scrreprt} classes is to use
  title pages. The \Class{scrartcl} class, on the other hand, uses in-page
  titles by default.%
}{%
  \IfThisCommonLabelBase{scrextend}{%
    The default depends on the class used and \Package{scrextend} recognizes
    it in a way that compatible with the standard class. If a class does not
    set up a comparable default, it will be an in-page title.%
  }{\InternalCommonFileUsageError}%
}%
%
\EndIndexGroup


\begin{Declaration}
  \begin{Environment}{titlepage}\end{Environment}%
\end{Declaration}%
The standard classes and {\KOMAScript} set all title pages in a special
environment: the \Environment{titlepage} environment.  This environment always
starts a new page\,---\,in two-sided printing a new right-hand page\,---\,and
in single-column mode. For this page, the style is changed to
\DescRef{maincls.cmd.thispagestyle}%
\PParameter{\DescRef{maincls.pagestyle.empty}}, so that neither page number
nor running head is output. At the end of the environment, the page is
automatically shipped out. Should you not be able to use the automatic layout
of the title pages provided by \DescRef{\ThisCommonLabelBase.cmd.maketitle},
described next, you should design a new one with the help of this environment.

\IfThisCommonFirstRun{\iftrue}{%
  A simple example for a title page with \Environment{titlepage} is shown in
  \autoref{sec:\ThisCommonFirstLabelBase.titlepage} on
  \PageRefxmpl{\ThisCommonFirstLabelBase.env.titlepage}%
  \csname iffalse\endcsname%
}%
  \begin{Example}
    \phantomsection\xmpllabel{env.titlepage}
    Suppose you want a title page on which only the word ``Me'' stands at
    the top on the left, as large as possible and in bold\,---\,no
    author, no date, nothing else. The following document creates just
    that:
\begin{lstcode}
  \documentclass{scrbook}
  \begin{document}
  \begin{titlepage}
    \textbf{\Huge Me}
  \end{titlepage}
  \end{document}
\end{lstcode}
    It's simple, isn't it?
  \end{Example}
\fi%
\EndIndexGroup


\begin{Declaration}
  \Macro{maketitle}\OParameter{page number}
\end{Declaration}%
While\textnote{\KOMAScript{} vs. standard classes} the standard classes
produce at most one title page that can have three items (title, author, and
date), with \KOMAScript{} \Macro{maketitle} can produce up to six pages. In
contrast to the standard classes, \Macro{maketitle} in {\KOMAScript} accepts
an optional numeric argument. If it is used, this number is the page number of
the first title page. This page number is not output, but it affects the
subsequent numbering. You should definitely choose an odd number, because
otherwise the whole count gets mixed up. In my opinion, there are only two
useful applications for the optional argument. On the one hand, you could give
the the logical page number -1 to the half-title\Index[indexmain]{half-title}
in order to give the full title page the number 1. On the other hand, you
could use it to start at a higher page number, for example, 3, 5, or 7, to
accommodate other title pages added by the publishing house.  The optional
argument is ignored for \emph{in-page} titles. You can change the page style
of such a title page by redefining the
\DescRef{\ThisCommonLabelBase.cmd.titlepagestyle} macro (see
\autoref{sec:maincls.pagestyle}, \DescPageRef{maincls.cmd.titlepagestyle}).

The following commands do not lead immediately to the ship-out of the titles.
The typesetting and ship-out of the title pages are always done by
\Macro{maketitle}. Note also that \Macro{maketitle} should not be used inside
a \DescRef{\ThisCommonLabelBase.env.titlepage} environment.
As\textnote{Attention!} shown in the examples, you should use either
\Macro{maketitle} or \DescRef{\ThisCommonLabelBase.env.titlepage}, but not
both.

The following commands only define the contents of the title. Therefore they
must be used before \Macro{maketitle}. It is, however, not necessary and, when
using the \Package{babel} package\IndexPackage{babel} not recommended, to
include these in the preamble before \Macro{begin}\PParameter{document} (see
\cite{package:babel}). You can find examples
\IfThisCommonFirstRun{in the descriptions of the other commands in this
  section}{in \autoref{sec:\ThisCommonFirstLabelBase.titlepage}, starting on
  \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.extratitle}}.


\begin{Declaration}
  \Macro{extratitle}\Parameter{half-title}
  \Macro{frontispiece}\Parameter{frontispiece}
\end{Declaration}%
\begin{Explain}%
  In earlier times the inner book was often not protected from dirt by a
  cover. This function was then assumed by the first page of the book, which
  usually had just a short title, known as the \emph{half-title}. Nowadays the
  extra page often appears before the real main title and contains information
  about the publisher, series number, and similar information.
\end{Explain}
With {\KOMAScript}, it is possible to include a page before the real title
page. The \PName{half-title} can be arbitrary text\,---\,even several
paragraphs. The contents of the \PName{half-title} are output by {\KOMAScript}
without additional formatting. Their organisation is completely left to the
user. The verso of the half-title\IfThisCommonLabelBase{maincls}{%
  \ChangedAt{v3.25}{\Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}}%
}{%
  \IfThisCommonLabelBase{scrextend}{%
    \ChangedAt{v3.25}{\Package{scrextend}}%
  }{\ThisCommonLabelBaseFailure}%
} is the frontispiece. The half-title is set on its own page even when in-page
titles are used. The output of the half-title defined with \Macro{extratitle}
takes place as part of the title produced by
\DescRef{\ThisCommonLabelBase.cmd.maketitle}.

\IfThisCommonFirstRun{\iftrue}{%
  An example of a simple title page with half-title and main title is shown
  in \autoref{sec:\ThisCommonFirstLabelBase.titlepage} on
  \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.extratitle}%
  \csname iffalse\endcsname%
}%
  \begin{Example}
    \phantomsection\xmpllabel{cmd.extratitle}
    Let's return to the previous example and suppose
    that the Spartan ``Me'' is the half-title. The full title should
    still follow the half-title. You can proceed as follows:
\begin{lstcode}
  \documentclass{scrbook}
  \begin{document}
    \extratitle{\textbf{\Huge Me}}
    \title{It's me}
    \maketitle
  \end{document}
\end{lstcode}
    You can centre the half-title horizontally and put it a little lower down
    the page:
\begin{lstcode}
  \documentclass{scrbook}
  \begin{document}
    \extratitle{\vspace*{4\baselineskip}
      \begin{center}\textbf{\Huge Me}\end{center}}
    \title{It's me}
    \maketitle
  \end{document}
\end{lstcode}
    The command\textnote{Attention!} \DescRef{\ThisCommonLabelBase.cmd.title}
    is necessary in order to make the examples above work correctly. It is
    explained next.
  \end{Example}
\fi%
\EndIndexGroup


\begin{Declaration}
  \Macro{titlehead}\Parameter{title head}%
  \Macro{subject}\Parameter{subject}%
  \Macro{title}\Parameter{title}%
  \Macro{subtitle}\Parameter{subtitle}%
  \Macro{author}\Parameter{author}%
  \Macro{date}\Parameter{date}%
  \Macro{publishers}\Parameter{publisher}%
  \Macro{and}%
  \Macro{thanks}\Parameter{footnote}
\end{Declaration}%
There are seven elements available for the content of the main title page. The
main title page is output as part of the title pages created by
\DescRef{\ThisCommonLabelBase.cmd.maketitle}, while the definitions given here
only apply to the respective elements.

\BeginIndexGroup\BeginIndex{FontElement}{titlehead}%
\LabelFontElement{titlehead}%
The\important{\Macro{titlehead}} \PName{title head}%
\Index[indexmain]{title>head} is defined with the command
\Macro{titlehead}. It occupies the entire text width, at the top of the page,
in normal justification, and it can be freely designed by the user. It uses
the font element\important{\FontElement{titlehead}} with same name (see
\autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup

\BeginIndexGroup\BeginIndex{FontElement}{subject}\LabelFontElement{subject}%
The\important{\Macro{subject}} \PName{subject}\Index[indexmain]{subject} is
output with the font element\important{\FontElement{subject}} of the same name
immediately above the \PName{title}.%
\EndIndexGroup

\BeginIndexGroup\BeginIndex{FontElement}{title}\LabelFontElement{title}%
The\important{\Macro{title}} \PName{title} is set in a very large font size.
Along\IfThisCommonLabelBase{maincls}{%
  \ChangedAt{v2.8p}{\Class{scrbook}\and \Class{scrreprt}\and
    \Class{scrartcl}}}{} with the font size, the font element
\FontElement{title}\IndexFontElement[indexmain]{title}%
\important{\FontElement{title}} is applied (see
\autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup

\BeginIndexGroup\BeginIndex{FontElement}{subtitle}\LabelFontElement{subtitle}%
The\important{\Macro{subtitle}}
\PName{subtitle}\IfThisCommonLabelBase{maincls}{%
  \ChangedAt{v2.97c}{\Class{scrbook}\and \Class{scrreprt}\and
    \Class{scrartcl}}}{} is set just below the title using the font
element\important{\FontElement{subtitle}} of the same name (see
\autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup

\BeginIndexGroup\BeginIndex{FontElement}{author}\LabelFontElement{author}%
Below\important{\Macro{author}} the \PName{subtitle} appears the
\PName{author}\Index[indexmain]{author}. Several authors can be specified in
the argument of \Macro{author}. They should be separated by
\Macro{and}\important{\Macro{and}}. The output uses the font 
element\important{\FontElement{author}} of the same name. (see
\autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup

\BeginIndexGroup\BeginIndex{FontElement}{date}\LabelFontElement{date}%
Below\important{\Macro{date}} the author or authors appears the
date\Index{date} in the font of the element of the same name. The default
value is the current date, as produced by \Macro{today}\IndexCmd{today}. The
\Macro{date} command accepts arbitrary information\,---\,even an empty
argument. The output uses the font element\important{\FontElement{date}} of
the same name (see \autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup

\BeginIndexGroup\BeginIndex{FontElement}{publishers}%
\LabelFontElement{publishers}%
Finally\important{\Macro{publishers}} comes the
\PName{publisher}\Index[indexmain]{publisher}. Of course this command can also
be used for any other information of minor importance. If necessary, the
\Macro{parbox} command can be used to typeset this information over the full
page width like a regular paragraph instead of centring it. It should then be
considered equivalent to the title head. Note, however, that this field is
placed above any existing footnotes. The output uses the font 
element\important{\FontElement{publishers}} of the same name (see
\autoref{tab:\ThisCommonFirstLabelBase.mainTitle},
\autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).%
\EndIndexGroup

Footnotes\important{\Macro{thanks}}\Index{footnotes} on the title page are
produced not with \Macro{footnote}, but with \Macro{thanks}. They serve
typically for notes associated with the authors. Symbols are used as footnote
markers instead of numbers. Note\textnote{Attention!} that \Macro{thanks} has
to be used inside the argument of another command, such as in the 
\PName{author} argument of the command \Macro{author}.
\IfThisCommonLabelBase{scrextend}{%
  However, in order for the \DescRef{\ThisCommonLabelBase.fontelement.footnote}
  element to be aware of the \Package{scrextend} package, not only does the
  title extension need to be enabled, it must also be set to use footnotes
  with this package (see the introduction to
  \autoref{sec:\ThisCommonLabelBase.footnotes},
  \autopageref{sec:\ThisCommonLabelBase.footnotes}). Otherwise, the font
  specified by the class or other packages used for the footnotes will be
  used.%
}{}%

For%
\IfThisCommonLabelBase{maincls}{%
  \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
    \Class{scrartcl}}%
}{%
  \IfThisCommonLabelBase{scrextend}{%
    \ChangedAt{v3.12}{\Package{scrextend}}%
  }{\InternalCommonFileUsageError}%
} the output of the title elements, the font\textnote{font} can be set using
the \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} command (see
\autoref{sec:\ThisCommonLabelBase.textmarkup},
\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}). The defaults are listed
in \autoref{tab:\ThisCommonFirstLabelBase.titlefonts}%
\IfThisCommonFirstRun{}{%
  , \autopageref{tab:\ThisCommonFirstLabelBase.titlefonts}%
}.%
\IfThisCommonFirstRun{%
  \begin{table}
%  \centering
%  \caption
    \KOMAoptions{captions=topbeside}%
    \setcapindent{0pt}%
%  \addtokomafont{caption}{\raggedright}%
    \begin{captionbeside}
      [{Font defaults for the elements of the title}]
      {\label{tab:\ThisCommonLabelBase.titlefonts}%
        \hspace{0pt plus 1ex}Font defaults for the elements of the title}
      [l]
      \begin{tabular}[t]{ll}
        \toprule
        Element name & Default \\
        \midrule
        \FontElement{author} & \Macro{Large} \\
        \FontElement{date} & \Macro{Large} \\
        \FontElement{dedication} & \Macro{Large} \\
        \FontElement{publishers} & \Macro{Large} \\
        \FontElement{subject} &
                                \Macro{normalfont}\Macro{normalcolor}%
                                \Macro{bfseries}\Macro{Large} \\
        \FontElement{subtitle} &
                                 \DescRef{\ThisCommonLabelBase.cmd.usekomafont}%
                                 \PParameter{title}\Macro{large} \\
        \FontElement{title} & 
                              \DescRef{\ThisCommonLabelBase.cmd.usekomafont}%
                              \PParameter{disposition} \\
        \FontElement{titlehead} & \\
        \bottomrule
      \end{tabular}
    \end{captionbeside}
  \end{table}%
}{}%

With the exception of \PName{title head} and any footnotes, all output is
centred horizontally. %
\iffree{%
  \IfThisCommonLabelBase{scrextend}{The formatting of each element is}{These
    details are} briefly summarized in
  \autoref{tab:\ThisCommonFirstLabelBase.mainTitle}\IfThisCommonFirstRun{}{%
    , \autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}}.%
}{%
  \IfThisCommonLabelBase{scrextend}{%
    The alignment of individual elements can also be found in
    \autoref{tab:\ThisCommonFirstLabelBase.mainTitle}\IfThisCommonFirstRun{}{%
      , \autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}}.%
  }{%
    For a summary, see \autoref{tab:\ThisCommonFirstLabelBase.mainTitle}.%
  }%
}%
\IfThisCommonFirstRun{%
  \begin{table}
    % \centering
    \KOMAoptions{captions=topbeside}%
    \setcapindent{0pt}%
    % \caption
    \begin{captionbeside}[Main title]{%
        \hspace{0pt plus 1ex}%
        Font and horizontal positioning of the elements in the main title page
        in the order of their vertical position from top to bottom when 
        typeset with \DescRef{\ThisCommonLabelBase.cmd.maketitle}}
      [l]
      \setlength{\tabcolsep}{.85\tabcolsep}% Umbruchoptimierung
      \begin{tabular}[t]{llll}
        \toprule
        Element    & Command            & Font               & Alignment     \\
        \midrule
        Title head & \Macro{titlehead}  & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{titlehead} & justified \\
        Subject    & \Macro{subject}    & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{subject} & centred \\
        Title      & \Macro{title}      & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{title}\Macro{huge}  & centred  \\
        Subtitle   & \Macro{subtitle}   & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{subtitle}  & centred \\
        Authors    & \Macro{author}     & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{author}  & centred \\
        Date       & \Macro{date}       & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{date}  & centred  \\
        Publishers & \Macro{publishers} & \DescRef{\ThisCommonLabelBase.cmd.usekomafont}\PParameter{publishers} & centred \\
        \bottomrule
      \end{tabular}
    \end{captionbeside}
    \label{tab:maincls.mainTitle}
  \end{table}
}{}

Note\textnote{Attention!} that for the main title, \Macro{huge} will be used
after the font switching element
\DescRef{\ThisCommonLabelBase.fontelement.title}\IndexFontElement{title}. So
you cannot change the size of the main title using
\DescRef{\ThisCommonLabelBase.cmd.setkomafont} or
\DescRef{\ThisCommonLabelBase.cmd.addtokomafont}.%

\IfThisCommonFirstRun{\iftrue}{%
  An example for a title page using all the elements offered by \KOMAScript{}
  is shown in \autoref{sec:\ThisCommonFirstLabelBase.titlepage} on
  \PageRefxmpl{\ThisCommonFirstLabelBase.maintitle}.%
  \csname iffalse\endcsname%
}%
  \begin{Example}
    \phantomsection\xmpllabel{maintitle}%
    Suppose you are writing a dissertation. The title page should have the
    university's name and address at the top, flush left, and the semester,
    flush right. As usual, a title including author and submission date
    should be given. The adviser must also be indicated, together with the
    fact that the document is a dissertation. You can do this as follows:
\begin{lstcode}
  \documentclass{scrbook}
  \usepackage[english]{babel}
  \begin{document}
  \titlehead{{\Large Unseen University
      \hfill SS~2002\\}
    Higher Analytical Institute\\
    Mythological Rd\\
    34567 Etherworld}
  \subject{Dissertation}
  \title{Digital space simulation with the DSP\,56004}
  \subtitle{Short but sweet?}
  \author{Fuzzy George}
  \date{30. February 2002}
  \publishers{Adviser Prof. John Eccentric Doe}
  \maketitle
  \end{document}
\end{lstcode}
  \end{Example}%
\fi

\begin{Explain}
  A common misconception concerns the function of the full title page. It is
  often erroneously assumed to be the cover\Index{cover} or dust jacket.
  Therefore, it is frequently expected that the title page will not follow the
  normal layout for two-sided typesetting but will have equally large left and
  right margins.

  But if you pick up a book and open it, you will quickly find at least one
  title page inside the cover, within the so-called book block. Precisely
  these title pages are produced by
  \DescRef{\ThisCommonLabelBase.cmd.maketitle}.

  As is the case with the half-title, the full title page belongs to the book
  block, and therefore should have the same page layout as the rest of the
  document. A cover is actually something that you should create in a
  separate document. After all, it often has a very distinct format. It can
  also be designed with the help of a graphics or DTP program. A separate
  document should also be used because the cover will be printed on a
  different medium, such as cardboard, and possibly with another printer.

  Nevertheless, since \KOMAScript~3.12 the first title page issued by
  \DescRef{\ThisCommonLabelBase.cmd.maketitle} can be formatted as a cover
  page with different margins. Changes to the margins on this page do not
  affect the other margins. For more information about this option, see
  \OptionValueRef{\ThisCommonLabelBase}{titlepage}{firstiscover}%
  \IndexOption{titlepage~=\textKValue{firstiscover}} on
  \DescPageRef{\ThisCommonLabelBase.option.titlepage}.
\end{Explain}
%
\EndIndexGroup


\begin{Declaration}
  \Macro{uppertitleback}\Parameter{titlebackhead}%
  \Macro{lowertitleback}\Parameter{titlebackfoot}
\end{Declaration}%
In\textnote{\KOMAScript{} vs. standard classes} two-sided printing, the
standard classes leave the back (verso) of the title page empty. However, with
{\KOMAScript} the back of the full title page can be used for other
information. There are exactly two elements which the user can freely format:
\PName{titlebackhead}\Index{title>back}\Index{title>verso} and
\PName{titlebackfoot}. The header can extend to the footer and vice versa.
\iffree{Using this guide as an example, the legal disclaimer was set with the
  help of the \Macro{uppertitleback} command.}{The publishers information of
  this book, for example, could have been set either with
  \Macro{uppertitleback} or \Macro{lowertitleback}.}%
%
\EndIndexGroup


\begin{Declaration}
  \Macro{dedication}\Parameter{dedication}
\end{Declaration}%
{\KOMAScript} offers its own dedication page. This
dedication\Index{dedication} is centred and set by default with a slightly
larger font\textnote{font}.
\BeginIndexGroup\BeginIndex{FontElement}{dedication}%
\LabelFontElement{dedication}
The%
\IfThisCommonLabelBase{maincls}{%
  \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
    \Class{scrartcl}}%
}{%
  \IfThisCommonLabelBase{scrextend}{%
    \ChangedAt{v3.12}{\Package{scrextend}}%
  }{\InternalCommonFileUseError}%
}\important{\FontElement{dedication}} exact font setting for the
\FontElement{dedication} element, which is taken from
\autoref{tab:\ThisCommonFirstLabelBase.titlefonts},
\autopageref{tab:\ThisCommonFirstLabelBase.titlefonts}, can be changed with
the \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} commands (see
\autoref{sec:\ThisCommonLabelBase.textmarkup},
\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}).%
\EndIndexGroup

\IfThisCommonFirstRun{\iftrue}{%
  An example with all title pages provided by \KOMAScript{} is shown in
  \autoref{sec:\ThisCommonFirstLabelBase.titlepage} on
  \PageRefxmpl{\ThisCommonFirstLabelBase.fulltitle}.%
  \csname iffalse\endcsname%
}%
  \begin{Example}
    \phantomsection\xmpllabel{fulltitle}%
    Suppose you have written a book of poetry and want to
    dedicate it to your spouse. A solution would look like this:
\begin{lstcode}
  \documentclass{scrbook}
  \usepackage[english]{babel}
  \begin{document}
  \extratitle{\textbf{\Huge In Love}}
  \title{In Love}
  \author{Prince Ironheart}
  \date{1412}
  \lowertitleback{This poem book was set with%
       the help of {\KOMAScript} and {\LaTeX}}
  \uppertitleback{Self-mockery Publishers}
  \dedication{To my treasured hazel-hen\\
    in eternal love\\
    from your dormouse.}
  \maketitle
  \end{document}
\end{lstcode}
    Please use your own favourite pet names to personalize it.
  \end{Example}%
\fi%
\EndIndexGroup
%
\EndIndexGroup
%
\EndIndexGroup

%%% Local Variables:
%%% mode: latex
%%% coding: us-ascii
%%% TeX-master: "../guide"
%%% End: