summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-12-26 23:18:36 +0000
committerKarl Berry <karl@freefriends.org>2013-12-26 23:18:36 +0000
commit9b219d1b664067729034647a4b37626cf2bf5e26 (patch)
tree00708467b44f90736dc32ed1bebb95e9c4710139 /Master/texmf-dist/source/latex/koma-script/doc
parentc00c8298eb6913b74270a36c1f1018f1e9946f7b (diff)
koma-script (26dec13)
git-svn-id: svn://tug.org/texlive/trunk@32489 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc')
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/Makefile10
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/Makefile.guide32
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/bin/genhtmlidx.pl9
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/Makefile14
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-0.tex24
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex16
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-10.tex8
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-11.tex8
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-12.tex10
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-13.tex8
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-14.tex163
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-15.tex8
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-2.tex10
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-20.tex127
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-21.tex765
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-3.tex8
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-4.tex8
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-5.tex379
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-6.tex23
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-7.tex9
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-8.tex20
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-9.tex14
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/expertpart.tex8
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/guide-english.tex12
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/guide.tex6
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/htmlsetup5
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/introduction.tex8
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/japanlco.tex8
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/preface.tex31
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scraddr.tex8
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrbase.tex928
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex26
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex263
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex15
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrextend.tex41
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrhack.tex18
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-notecolumn.tex317
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage-experts.tex660
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage.tex1128
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer.tex1242
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlfile.tex110
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2-experts.tex97
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex277
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrpage2.tex18
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrwfile.tex68
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex229
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/typearea-experts.tex61
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/typearea.tex221
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/guide.bib33
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/guide.tex6
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-0.tex124
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-1.tex29
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-11.tex14
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-12.tex29
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-14.tex210
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-20.tex136
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-21.tex873
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-5.tex547
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-8.tex57
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide-ngerman.tex90
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide.tex6
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/htmlsetup5
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/introduction.tex263
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbase.tex482
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex731
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrextend.tex35
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-notecolumn-example.tex131
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-notecolumn.tex679
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage-experts.tex672
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage.tex1205
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex1436
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex102
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex24
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex582
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrpage2.tex40
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/tocbasic.tex211
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex19
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea.tex318
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/scrguide.cls162
79 files changed, 14206 insertions, 2523 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/Makefile b/Master/texmf-dist/source/latex/koma-script/doc/Makefile
index 9092d885d86..05097a7c297 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/Makefile
+++ b/Master/texmf-dist/source/latex/koma-script/doc/Makefile
@@ -1,6 +1,6 @@
# ======================================================================
# Makefile
-# Copyright (c) Markus Kohm, 2002-2012
+# Copyright (c) Markus Kohm, 2002-2013
#
# This file is part of the LaTeX2e KOMA-Script bundle.
#
@@ -18,7 +18,7 @@
# This work consists of all files listed in manifest.txt.
# ----------------------------------------------------------------------
# Makefile
-# Copyright (c) Markus Kohm, 2002-2012
+# Copyright (c) Markus Kohm, 2002-2013
#
# Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
# Version 1.3c, verteilt und/oder veraendert werden.
@@ -97,9 +97,13 @@ STATIC_DOC_SRC = koma-script.html
STATIC_DOC_LINKS= komascript.html komascr.html \
scrbook.html scrreprt.html scrartcl.html scrlttr2.html \
+ scrextend.html \
typearea.html scrpage2.html scraddr.html scrlfile.html \
scrwfile.html \
- scrtime.html scrdate.html tocbasic.html scrbase.html
+ scrtime.html scrdate.html tocbasic.html \
+ scrlayer.html scrlayer-scrpage.html \
+ scrlayer-notecolumn.html \
+ scrbase.html scrhack.html
DOC_SRC = scrguide.cls scrguide.ist scrguide.gst \
guide.tex guide.bib plength.dtx \
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/Makefile.guide b/Master/texmf-dist/source/latex/koma-script/doc/Makefile.guide
index 8f76ea692dd..432d427419d 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/Makefile.guide
+++ b/Master/texmf-dist/source/latex/koma-script/doc/Makefile.guide
@@ -1,6 +1,6 @@
# ======================================================================
# Makefile.guide
-# Copyright (c) Markus Kohm, 2002-2012
+# Copyright (c) Markus Kohm, 2002-2013
#
# This file is part of the LaTeX2e KOMA-Script bundle.
#
@@ -18,7 +18,7 @@
# This work consists of all files listed in manifest.txt.
# ----------------------------------------------------------------------
# Makefile.guide
-# Copyright (c) Markus Kohm, 2002-2012
+# Copyright (c) Markus Kohm, 2002-2013
#
# Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
# Version 1.3c, verteilt und/oder veraendert werden.
@@ -70,19 +70,23 @@ endif
TEX_CHAPTERS = preface.tex introduction.tex \
authorpart.tex typearea.tex scrbookreportarticle.tex \
- scrlttr2.tex scrpage2.tex scrdatetime.tex scraddr.tex \
+ scrlttr2.tex scrlayer-scrpage.tex scrpage2.tex \
+ scrdatetime.tex scraddr.tex \
adrconvnote.tex scrextend.tex \
expertpart.tex scrbase.tex scrlfile.tex scrwfile.tex \
tocbasic.tex scrhack.tex \
+ scrlayer.tex \
+ scrlayer-scrpage-experts.tex scrlayer-notecolumn.tex \
typearea-experts.tex scrbookreportarticle-experts.tex \
scrlttr2-experts.tex \
$(TEX_APPENDICES)
-TEX_MISC = $(DOCDIR)guide.tex $(DOCDIR)linkalias.tex \
+TEX_MISC = ../guide.tex ../linkalias.tex \
common-0.tex common-1.tex common-2.tex common-3.tex \
common-4.tex common-5.tex common-6.tex common-7.tex \
common-8.tex common-9.tex common-10.tex common-11.tex \
- common-12.tex common-13.tex common-14.tex common-15.tex
+ common-12.tex common-13.tex common-14.tex common-15.tex \
+ common-20.tex common-21.tex
EXAMPLE_LETTER_DTX = scrlttr2examples.dtx
@@ -93,6 +97,11 @@ EXAMPLE_LETTER_LETTERS = $(foreach num,\
EXAMPLE_LETTER_DTX_RESULT = $(EXAMPLE_LETTER_LETTERS) musterlogo.eps ich.lco
+ifeq ($(LANGUAGE),ngerman)
+EXAMPLE_NOTECOLUMN_SRC = scrlayer-notecolumn-example.tex
+EXAMPLE_NOTECOLUMN_PDF = $(addsuffix .pdf,$(basename $(EXAMPLE_NOTECOLUMN_SRC)))
+endif
+
PLENGTH_DTX = $(DOCDIR)plength.dtx
PLENGTH_DTX_RESULT = plength.drv plenDIN.mp varDIN.mp plinc.mp \
@@ -108,18 +117,20 @@ EXAMPLE_LETTER_SRC = $(EXAMPLE_LETTER_LETTERS) $(PDF_EPS) ich.lco
EXAMPLE_LETTER_PDF = $(addsuffix .pdf,$(basename $(EXAMPLE_LETTER_LETTERS)))
-GENERATED_SRC = $(EXAMPLE_LETTER_PDF) $(PLENGTH_PDF)
+GENERATED_SRC = $(EXAMPLE_LETTER_PDF) $(PLENGTH_PDF) \
+ $(EXAMPLE_NOTECOLUMN_PDF)
GENERATED_CLEAN = $(GENERATED_SRC) \
$(EXAMPLE_LETTER_DTX_RESULT) letter-label.tex \
- $(PDF_EPS) \
+ $(EXAMPLE_NOTECOLUMN_PDF) $(PDF_EPS) \
$(PLENGTH_DTX_RESULT)
TEX_SRC = guide-$(LANGUAGELONG).tex $(TEX_CHAPTERS) $(TEX_MISC)
MISC_SRC = $(MAKE_FILES) htmlsetup
-DIST_SRC = $(MISC_SRC) $(TEX_SRC) $(EXAMPLE_LETTER_DTX)
+DIST_SRC = $(MISC_SRC) $(TEX_SRC) $(EXAMPLE_LETTER_DTX) \
+ $(EXAMPLE_NOTECOLUMN_SRC)
GUIDE_FILES = $(GUIDENAME).pdf $(GUIDENAME).html
@@ -277,6 +288,11 @@ $(EXAMPLE_LETTER_PDF): $(EXAMPLE_LETTER_SRC)
$(EXAMPLE_LETTER_DTX_RESULT): $(EXAMPLE_LETTER_DTX)
$(PDFLATEX) $<
+ifdef EXAMPLE_NOTECOLUMN_SRC
+$(EXAMPLE_NOTECOLUMN_PDF): $(EXAMPLE_NOTECOLUMN_SRC)
+ $(PDFLATEX) $<
+endif
+
guide.ind: guide.idx
$(MAKEINDEX) $@ $<
$(INDEXPOSTOP) guide
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/bin/genhtmlidx.pl b/Master/texmf-dist/source/latex/koma-script/doc/bin/genhtmlidx.pl
index 65ec7e5b444..a49935fd8df 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/bin/genhtmlidx.pl
+++ b/Master/texmf-dist/source/latex/koma-script/doc/bin/genhtmlidx.pl
@@ -4,7 +4,7 @@ eval 'exec perl -S $0 ${1+"$@"}'
# ======================================================================
# genhtmlidx.pl
-# Copyright (c) Markus Kohm, 2002-2006
+# Copyright (c) Markus Kohm, 2002-2013
#
# This file is part of the LaTeX2e KOMA-Script bundle.
#
@@ -22,7 +22,7 @@ eval 'exec perl -S $0 ${1+"$@"}'
# This work consists of all files listed in manifest.txt.
# ----------------------------------------------------------------------
# genhtmlidx.pl
-# Copyright (c) Markus Kohm, 2002-2006
+# Copyright (c) Markus Kohm, 2002-2013
#
# Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
# Version 1.3c, verteilt und/oder veraendert werden.
@@ -62,6 +62,7 @@ my @counter;
my @floatstyle;
my @fontelement;
my @file;
+my @length;
my $baselink;
my $htmlhead;
@@ -106,6 +107,8 @@ while ( $auxfile=shift ) {
push @fontelement,$entry;
} elsif ( "$2" eq "package" ) {
push @file,$entry;
+ } elsif ( "$2" eq "length" ) {
+ push @length,$entry;
} else {
print STDERR "Unknown type $2!\n";
}
@@ -146,6 +149,7 @@ print "<ul>\n";
print "<li><a href=\"#option\">$titles{option}</a></li>" if ( @option );
print "<li><a href=\"#macro\">$titles{macro}</a></li>" if ( @macro );
print "<li><a href=\"#environment\">$titles{environment}</a></li>" if ( @environment );
+print "<li><a href=\"#length\">$titles{length}</a></li>" if ( @length );
print "<li><a href=\"#plength\">$titles{plength}</a></li>" if ( @plength );
print "<li><a href=\"#variable\">$titles{variable}</a></li>" if ( @variable );
print "<li><a href=\"#pagestyle\">$titles{pagestyle}</a></li>" if ( @pagestyle );
@@ -158,6 +162,7 @@ print "</ul>\n";
process "option","",\@option;
process "macro","\\",\@macro;
process "environment","",\@environment;
+process "length","",\@length;
process "plength","",\@plength;
process "variable","",\@variable;
process "pagestyle","",\@pagestyle;
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/Makefile b/Master/texmf-dist/source/latex/koma-script/doc/english/Makefile
index e9c2b0cd026..9ac3413dfaf 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/Makefile
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/Makefile
@@ -53,7 +53,7 @@ tocbasic.tex: ../../tocbasic.tex
if [ -L $@ ] || ! [ -f $@ ]; then $(SYMLINK) $< .; else touch $@; fi
../../tocbasic.tex: ../../tocbasic.dtx
- cd ../.. && tex \\nonstopmode\\input tocbasic.dtx
+ cd ../.. && tex \\nonstopmode\\input $(basename $<)
# ----------------------------------------------------------------------
# ----------------------------------------------------------------------
@@ -63,7 +63,17 @@ scrwfile.tex: ../../scrwfile.tex
if [ -L $@ ] || ! [ -f $@ ]; then $(SYMLINK) $< .; else touch $@; fi
../../scrwfile.tex: ../../scrwfile.dtx
- cd ../.. && tex \\nonstopmode\\input scrwfile.dtx
+ cd ../.. && tex \\nonstopmode\\input $(basename $<)
+# ----------------------------------------------------------------------
+
+# ----------------------------------------------------------------------
+# NOTE: Remove these rules after real translation of scrlayer-notecolumn.tex
+# is available.
+scrlayer-notecolumn.tex: ../../scrlayer-notecolumn.tex
+ if [ -L $@ ] || ! [ -f $@ ]; then $(SYMLINK) $< .; else touch $@; fi
+
+../../scrlayer-notecolumn.tex: ../../scrlayer-notecolumn.dtx
+ cd ../.. && tex \\nonstopmode\\input $(basename $<)
# ----------------------------------------------------------------------
#
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-0.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-0.tex
index f950ed11530..deced1e00ca 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-0.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-0.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-0.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-0.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,10 +45,12 @@
%
% ======================================================================
-\ProvidesFile{common-0.tex}[2012/04/02 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-0.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\translator{Gernot Hassenpflug\and Krickette Murabayashi}
-% Date of the translated German file: 2011/08/26
+% Date of the translated German file: 2013/08/08
\makeatletter
\@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}%
@@ -109,7 +111,7 @@ may also have the form \PName{option}\texttt{=}\PName{value}. Apart
from this difference \Macro{documentclass} and \Macro{usepackage}
function the same in {\KOMAScript} as described in
\cite{latex:usrguide} or any introduction to \LaTeX, for example
-\cite{l2short}.%
+\cite{lshort}.%
%
\IfNotCommon{scrextend}{\par%
When using a {\KOMAScript} class, no options should be passed on
@@ -124,7 +126,17 @@ function the same in {\KOMAScript} as described in
packages.}%
\IfCommon{scrlttr2}{\ Actually, it is no longer necessary when using
any {\KOMAScript} class to explicity load either one of these
- packages.}}%
+ packages.}}
+
+You should note\textnote{Attention!}, that in opposite to the interface
+described below the options interface of \Macro{documentclass} and
+\Macro{usepackage} is not robust. So commands, lengths, counters and such
+constructs may break inside the optional argument of these commands. Because
+of this, the usage of a \LaTeX{} length inside the value of an option would
+cause an error before \KOMAScript{} can get the control over the option
+execution. So, if you want to use a \LaTeX{} length, counter or command a part
+of the value of an option, you have to use \Macro{KOMAoptions} or
+\Macro{KOMAoption}. These commands will be described next.%
%
\EndIndex{Cmd}{usepackage}%
\EndIndex{Cmd}{documentclass}%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex
index 3dbcdad259b..69e02610745 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-1.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-1.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-1.tex}[2012/04/08 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-1.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\translator{Markus Kohm\and Krickette Murabayashi}
% Date of the translated German file: 2011/09/20
@@ -127,7 +129,7 @@ poses possibilities of compatibility issues for future \LaTeX{} runs. Option
\Option{version} without any \PName{value} means the
same. \ChangedAt{v3.01a}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}\and \Class{scrlttr2}\and \Package{scrextend}}This is the
-default behaviour as long as you don't use any deprecated options.
+default behaviour as long as you do not use any deprecated options.
If\textnote{Attention!} you use a deprecated option of \KOMAScript~2,
\KOMAScript~3 will switch to \OptionValue{version}{first} automatically. This
@@ -137,7 +139,7 @@ switching. Alternatively you may select another adjustment using option
Compatibility is primarily make-up compatibility. New features not related to
the mark-up will be available even if you switch compatibility to a version
-before first implementation of the feature. Option \Option{version} doesn't
+before first implementation of the feature. Option \Option{version} does not
influence make-up changes that are motivated by bug fixes. If you need bug
compatibility you should physically save the used \KOMAScript{} version
together with your document.
@@ -151,8 +153,8 @@ together with your document.
latest version.%
\end{Example}}
-Please note\textnote{Attention!} that you can't change option \Option{version}
-anymore after loading the %
+Please note\textnote{Attention!} that you cannot change option
+\Option{version} anymore after loading the %
\IfCommon{maincls}{class}%
\IfCommon{scrlttr2}{class}%
\IfCommon{typearea}{package \Package{typearea}}%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-10.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-10.tex
index 2b10f4ae9c9..a3c209f6806 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-10.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-10.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-10.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-10.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-10.tex}[2012/05/15 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-10.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\translator{Markus Kohm\and Krickette Murabayashi}
% Date of the translated German file: 2012/01/01
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-11.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-11.tex
index 55f9aeb02a8..e4f3ebb325b 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-11.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-11.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-11.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-11.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-11.tex}[2012/02/07 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-11.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\translator{Gernot Hassenpflug\and Markus Kohm}
% Date of the translated German file: 2012/01/01
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-12.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-12.tex
index a57b75f9624..a567512ef83 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-12.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-12.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-12.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-12.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-12.tex}[2012/05/15 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-12.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi}
% Date of the translated German file: 2011/09/21
@@ -415,7 +417,7 @@ with the commands \Macro{setkomafont} and \Macro{addtokomafont} (see \autoref{se
\end{labeling}
\end{ShowOutput}
As can be seen in this example, a font changing command may be set
- in the usual way. But if you don't want the font of the separator to
+ in the usual way. But if you do not want the font of the separator to
be changed in the same way as the font of the label, you have to set
the font of the separator as well.
\end{Example}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-13.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-13.tex
index 62a79e01ef9..e4f69fb2f48 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-13.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-13.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-13.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-13.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-13.tex}[2012/02/14 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-13.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\translator{Gernot Hassenpflug\and Markus Kohm}
% Date of the translated German file: 2011/09/03
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-14.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-14.tex
index afbd0583800..15f222f283b 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-14.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-14.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-14.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-14.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,10 +45,12 @@
%
% ======================================================================
-\ProvidesFile{common-14.tex}[2012/05/15 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-14.tex}
+ [$Date: 2013-11-21 16:13:48 +0100 (Do, 21. Nov 2013) $
+ KOMA-Script guide (common paragraphs)]
\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi}
-% Date of the translated German file: 2012/01/01
+% Date of the translated German file: 2013/11/21
\makeatletter
\@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}%
@@ -103,9 +105,11 @@ should be used.
\else %------------------------------------------------------- nur maincls -
\begin{Declaration}
- \KOption{titlepage}\PName{simple switch}
+ \KOption{titlepage}\PName{simple switch}\\
+ \OptionValue{titlepage}{firstiscover}
\end{Declaration}%
\BeginIndex{Option}{titlepage~=\PName{simple switch}}%
+\BeginIndex{Option}{titlepage~=\PValue{firstiscover}}%
Using \Macro{maketitle} (see \autopageref{desc:\csname
label@base\endcsname.cmd.maketitle}), this option\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} switches between document title pages\Index{title>pages}
@@ -127,6 +131,27 @@ specially emphasized, but it may be followed by more material on the same
page, for instance by an abstract or a section.%
\EndIndex{Option}{titlepage~=\PName{simple switch}}%
+The third choice,\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}}
+\OptionValue{titlepage}{firstiscover}%
+\important{\OptionValue{titlepage}{firstiscover}} does not only select title
+pages. It additionally prints the first title page of
+\Macro{maketitle}\IndexCmd{maketitle}, this is either the extra title or the
+main title, as a cover\Index{cover} page. Every other setting of option
+\Option{titlepage} would cancel this setting. The margins\important{%
+ \Macro{coverpagetopmargin}\\
+ \Macro{coverpagebottommargin}\\
+ \Macro{coverpageleftmargin}\\
+ \Macro{coverpagerightmargin}} of the cover page are given by
+\Macro{coverpagetopmargin}\IndexCmd[indexmain]{coverpagetopmargin},
+\Macro{coverpagebottommargin}\IndexCmd[indexmain]{coverpagebottommargin},
+\Macro{coverpageleftmargin}\IndexCmd[indexmain]{coverpageleftmargin} und
+\Macro{coverpagerightmargin}\IndexCmd[indexmain]{coverpagerightmargin}. The
+defaults of these depend on the lengths
+\Length{topmargin}\IndexLength{topmargin} and
+\Length{evensidemargin}\IndexLength{evensidemargin} and can be changed using
+\Macro{renewcommand}.
+
\IfCommon{maincls}{The default of classes \Class{scrbook} and \Class{scrreprt}
is usage of title pages. Class \Class{scrartcl}, on the other hand, uses
in-page titles as default.}%
@@ -335,69 +360,16 @@ the top of the page. It can be freely designed by the user.
The\important{\Macro{subject}} \PName{subject}\Index[indexmain]{subject} is
output immediately above the \PName{title}.
-Thereby\ChangedAt{v2.95}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} the font switching of element
-\FontElement{subject}\IndexFontElement{subject}\important{\FontElement{subject}}
-will be used. The default, that may be found in
-\autoref{tab:maincls.titlefonts}, %
-\IfNotCommon{maincls}{\autopageref{tab:maincls.titlefonts}, }%
-may be changed using the commands \Macro{setkomafont} and
-\Macro{addtokomafont} (see \autoref{sec:\csname
- label@base\endcsname.textmarkup}, \autopageref{desc:\csname
- label@base\endcsname.cmd.setkomafont}).
The\important{\Macro{title}} \PName{title} is output with a very large font
-size. Besides\ChangedAt{v2.8p}{%
- \Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}} the change of size,
-the settings for the element
-\FontElement{title}\IndexFontElement{title}\important{\FontElement{title}}
-also take effect. By default these settings are identical to the settings for
-the element \FontElement{disposition}\IndexFontElement{disposition} (see
-\autoref{tab:maincls.elementsWithoutText},
-\autopageref{tab:maincls.elementsWithoutText}). The default settings may be
-changed using the commands \Macro{setkomafont} and \Macro{addtokomafont} (see
-\autoref{sec:\csname label@base\endcsname.textmarkup},
-\autopageref{desc:\csname label@base\endcsname.cmd.setkomafont}). The font
-size\textnote{Attention!} is, however, not affected (see
+size. Beside all other element the font size\textnote{Attention!} is,
+however, not affected by the font switching element \FontElement{title} (see
\autoref{tab:maincls.elementsWithoutText},
\autopageref{tab:maincls.mainTitle}).
The\important{\Macro{subtitle}}
\PName{subtitle}\ChangedAt{v2.97c}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} is set just below the title, in a font determined by the
-element \FontElement{subtitle}\IndexFontElement{subtitle}%
-\important{\FontElement{subtitle}}. The default, seen in
-\autoref{tab:maincls.titlefonts}%
-\IfNotCommon{maincls}{, \autopageref{tab:maincls.titlefonts}}, %
-can be changed with the help of the commands \Macro{setkomafont} and
-\Macro{addtokomafont} (see \autoref{sec:\csname
- label@base\endcsname.textmarkup}, \autopageref{desc:\csname
- label@base\endcsname.cmd.setkomafont}).
-
-\IfCommon{maincls}{%
-\begin{table}
-% \centering
- \KOMAoptions{captions=topbeside}%
- \setcapindent{0pt}%
-% \caption
- \begin{captionbeside}
- [{Font defaults for the elements of the title}]
- {\label{tab:maincls.titlefonts}%
- Font defaults for the elements of the title}
- [l]
- \begin{tabular}[t]{ll}
- \toprule
- Element name & Default \\
- \midrule
- \FontElement{subject} &
- \Macro{normalfont}\Macro{normalcolor}\Macro{bfseries}\Macro{Large} \\
- \FontElement{title} & \Macro{usekomafont}\PParameter{disposition} \\
- \FontElement{subtitle} &
- \Macro{usekomafont}\PParameter{title}\Macro{large} \\
- \bottomrule
- \end{tabular}
- \end{captionbeside}
-\end{table}}
+ \Class{scrartcl}} is set just below the title.
Below\important{\Macro{author}} the \PName{subtitle} appears the
\PName{author}\Index[indexmain]{author}. Several authors can be
@@ -424,6 +396,44 @@ markers instead of numbers. Note\textnote{Attention!}, that \Macro{thanks} has
to be used inside the argument of another command, e.\,g., at the argument
\PName{author} of the command \Macro{author}.
+While\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}} printing the title elements the
+equal named font switching elements will be used for all them. The defaults,
+that may be found in \autoref{tab:maincls.titlefonts}, %
+\IfNotCommon{maincls}{\autopageref{tab:maincls.titlefonts}, }%
+may be changed using the commands \Macro{setkomafont} and
+\Macro{addtokomafont} (see \autoref{sec:\csname
+ label@base\endcsname.textmarkup}, \autopageref{desc:\csname
+ label@base\endcsname.cmd.setkomafont}). \IfCommon{maincls}{%
+\begin{table}
+% \centering
+ \KOMAoptions{captions=topbeside}%
+ \setcapindent{0pt}%
+% \caption
+ \begin{captionbeside}
+ [{Font defaults for the elements of the title}]
+ {\label{tab:maincls.titlefonts}%
+ 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} &
+ \Macro{usekomafont}\PParameter{title}\Macro{large} \\
+ \FontElement{title} & \Macro{usekomafont}\PParameter{disposition} \\
+ \FontElement{titlehead} & \\
+ \bottomrule
+ \end{tabular}
+ \end{captionbeside}
+\end{table}}
+
With the exception of \PName{titlehead} and possible footnotes, all
the items are centered horizontally. The information is summarised in
\autoref{tab:maincls.mainTitle}%
@@ -436,7 +446,7 @@ the items are centered horizontally. The information is summarised in
\setcapindent{0pt}%
% \caption
\begin{captionbeside}[Main title]{%
- Font size and horizontal positioning of the
+ 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 \Macro{maketitle}}
[l]
@@ -445,19 +455,21 @@ the items are centered horizontally. The information is summarised in
\toprule
Element & Command & Font & Orientation \\
\midrule
- Title head & \Macro{titlehead} & \Macro{normalsize} & justified \\
+ Title head & \Macro{titlehead} & \Macro{usekomafont}\PParameter{titlehead} & justified \\
Subject & \Macro{subject} & \Macro{usekomafont}\PParameter{subject} & centered \\
- Title & \Macro{title} & \Macro{huge}\Macro{usekomafont}\PParameter{title} & centered \\
+ Title & \Macro{title} & \Macro{usekomafont}\PParameter{title}\Macro{huge} & centered \\
Subtitle & \Macro{subtitle} & \Macro{usekomafont}\PParameter{subtitle} & centered \\
- Authors & \Macro{author} & \Macro{Large} & centered \\
- Date & \Macro{date} & \Macro{Large} & centered \\
- Publishers & \Macro{publishers} & \Macro{Large} & centered \\
+ Authors & \Macro{author} & \Macro{usekomafont}\PParameter{author} & centered \\
+ Date & \Macro{date} & \Macro{usekomafont}\PParameter{date} & centered \\
+ Publishers & \Macro{publishers} & \Macro{usekomafont}\PParameter{publishers} & centered \\
\bottomrule
\end{tabular}
\end{captionbeside}
\label{tab:maincls.mainTitle}
-\end{table}}
-
+ \end{table}}
+Please note\textnote{Attention!}, that for the main title \Macro{huge} will be
+used after the font switching element \Macro{title}. So you cannot change the
+size of the main title using \Macro{setkomafont} or \Macro{addtokomafont}.
\begin{Example}
Assume you are writing a dissertation. The title page should have
@@ -510,9 +522,9 @@ the items are centered horizontally. The information is summarised in
\begin{Explain}
A frequent misunderstanding concerns the role of the full title page. It is
- often erroneously assumed that the cover or dust cover is meant. Therefore,
- it is frequently expected that the title page does not follow the normal
- page layout, but has equally large left and right margins.
+ often erroneously assumed that the cover\Index{cover} or dust cover is
+ meant. Therefore, it is frequently expected that the title page does not
+ follow the normal page layout, but has equally large left and right margins.
However, if one takes a book and opens it, one notices very quickly at least
one title page under the cover within the so-called inner book. Precisely
@@ -525,6 +537,13 @@ the items are centered horizontally. The information is summarised in
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,
possibly cardboard, and possibly with another printer.
+
+ Nevertheless, since \KOMAScript~3.12 the first title page of
+ \Macro{maketitle} can be printed as a cover page with different margins. For
+ more information about this see the description of option
+ \OptionValue{titlepage}{firstiscover}%
+ \IndexOption{titlepage~=\PValue{firstiscover}} on \autopageref{desc:\csname
+ label@base\endcsname.option.titlepage}.
\end{Explain}
%
\EndIndex{Cmd}{titlehead}%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-15.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-15.tex
index 2f8f870f71d..ff61582d756 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-15.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-15.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-15.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-15.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-15.tex}[2012/05/15 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-15.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi}
% Date of the translated German file: 2011/09/21
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-2.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-2.tex
index 81a5e22d550..8ac590a8100 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-2.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-2.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-2.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-2.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-2.tex}[2012/05/15 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-2.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi}
% Date of the translated German file: 2011/09/20
@@ -71,7 +73,7 @@ Many classes and packages provide a draft mode aside from the final
typesetting mode. The difference of draft and final mode may be as manifold as
the classes and package that support these modes. For instance, the
\Package{graphics}\IndexPackage{graphics} and the
-\Package{graphicx}\IndexPackage{graphicx} packages don't actually output the
+\Package{graphicx}\IndexPackage{graphicx} packages do not actually output the
graphics in their own draft mode. Instead they output a framed box of the
appropriate size containing only the graphic's file name (see
\cite{package:graphics}).%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-20.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-20.tex
new file mode 100644
index 00000000000..85fdea3b1a8
--- /dev/null
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-20.tex
@@ -0,0 +1,127 @@
+% ======================================================================
+% common-20.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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-20.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ======================================================================
+%
+% Text that is common for several chapters of the KOMA-Script guide
+% Maintained by Markus Kohm
+%
+% ----------------------------------------------------------------------
+%
+% Absaetze, die mehreren Kapitels in der KOMA-Script-Anleitung gemeinsam sind
+% Verwaltet von Markus Kohm
+%
+% ============================================================================
+
+\KOMAProvidesFile{common-20.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (common paragraph: Head and Foot Height)]
+\translator{Markus Kohm\and Jana Schubert\and Jens H\"uhne}
+
+% Date of the translated German file: 2013-10-18
+
+\makeatletter
+\@ifundefined{ifCommonscrlayer}{\newif\ifCommonscrlayer}{}%
+\@ifundefined{ifCommoonscrlayer-scrpage}{\expandafter\newif\csname ifCommonscrlayer-scrpage\endcsname}{}%
+\@ifundefined{ifIgnoreThis}{\newif\ifIgnoreThis}{}%
+\makeatother
+
+\section{Head and Foot Height}
+\label{sec:\csname label@base\endcsname.height}
+
+\IfCommon{scrlayer-scrpage}{%
+ The \LaTeX{} standard classes do not use the page footer a lot and if they do
+ use it, they put the contents into a \Macro{mbox} which results in the
+ footer being a single text line. This is probably the reason that \LaTeX{} itself
+ does not have a well-defined foot height. Actually there is
+ \Length{footskip}\IndexLength{footskip} giving the distance between the last base
+ line of the text area and the base line of the footer. However, if the footer
+ consists of more than one text line, there is no definite statement whether this
+ length should be the distance to the first or the last base line of the footer.
+
+ Despite the fact that the page header of the standard classes will also be
+ put into a horizontal box and therefore is a single text line too, \LaTeX{}
+ indeed has a length to setup the height of the page header. The reason for
+ this may be that the height will be needed to determine the start of the
+ text area. }
+
+\ifshortversion\IgnoreThisfalse\IfNotCommon{scrlayer-scrpage}{\IgnoreThistrue}\fi
+\ifIgnoreThis %++++++++++++++++++++++++++++++++++++++++ not scrlayer-scrpage +
+You may find basic information about the height of the page header and footer
+in \autoref{sec:scrlayer-scrpage.height},
+\autopageref{sec:scrlayer-scrpage.height}.
+\else % ---------------------------------------------- only scrlayer-scrpage -
+
+\begin{Declaration}
+ \Length{footheight}\\
+ \Length{headheight}
+\end{Declaration}
+\BeginIndex{Length}{footheight}%
+\BeginIndex{Length}{headheight}%
+The package \Package{scrlayer} introduces \Length{footheight} as a new length
+similar to \Length{headheight} of the \LaTeX{} kernel. Additionally
+\Package{scrlayer-scrpage} interprets \Length{footskip} to be the distance
+from the last possible base line of the text area to the first normal base
+line of the footer. Package \Package{typearea}\IndexPackage{typearea}
+interprets \Package{footheight} in the same way. So \Package{typearea}'s foot
+height options may also be used to setup the values for packages
+\Package{scrlayer} and \Package{scrlayer-scrpage}. See option
+\Option{footheight} and \Option{footlines} in \autoref{sec:typearea.typearea},
+\autopageref{desc:typearea.option.footheight}) and option \Option{footinclude}
+at \autopageref{desc:typearea.option.footinclude} of the same section.
+
+If you do not use package \Package{typearea}, you should setup the head and
+foot height using the lengths directly where necessary. At least for the head
+package \Package{geometry} provides similar settings. If you setup a head or
+foot height that is too small for the effective content,
+\Package{scrlayer-scrpage} will try to adjust the corresponding lengths
+properly. Furthermore, it will warn you and give you additional information
+about the changes and proper settings you may use yourself. The automatic
+changes will become valid immediately after the need for them has been
+detected. They will never be removed automatically, however, even if content
+with a lower height requirement should be detected at a later point in time.%
+\EndIndex{Length}{headheight}%
+\EndIndex{Length}{footheight}%
+
+\fi % ********************************************* Ende nur scrlayer-scrpage *
+
+%%% Local Variables:
+%%% mode: latex
+%%% mode: flyspell
+%%% coding: us-ascii
+%%% ispell-local-dictionary: "en_GB"
+%%% TeX-master: "../guide.tex"
+%%% TeX-PDF-mode: t
+%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-21.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-21.tex
new file mode 100644
index 00000000000..92397fe2f17
--- /dev/null
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-21.tex
@@ -0,0 +1,765 @@
+% ======================================================================
+% common-21.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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-21.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ======================================================================
+%
+% Text that is common for several chapters of the KOMA-Script guide
+% Maintained by Markus Kohm
+%
+% ----------------------------------------------------------------------
+%
+% Absaetze, die mehreren Kapitels in der KOMA-Script-Anleitung gemeinsam sind
+% Verwaltet von Markus Kohm
+%
+% ============================================================================
+
+\KOMAProvidesFile{common-21.tex}
+ [$Date: 2013-10-22 11:17:09 +0200 (Di, 22 Okt 2013) $
+ KOMA-Script guide (common paragraph:
+ Manipulation of defined page styles)]
+\translator{Markus Kohm\and Jana Schubert}
+
+% Date version of the translated file: 2013-10-23
+
+\makeatletter
+\@ifundefined{ifCommonscrlayer}{\newif\ifCommonscrlayer}{}%
+\@ifundefined{ifCommoonscrlayer-scrpage}{\expandafter\newif\csname ifCommonscrlayer-scrpage\endcsname}{}%
+\@ifundefined{ifIgnoreThis}{\newif\ifIgnoreThis}{}%
+\makeatother
+
+\section{Manipulation of Defined Page Styles}
+\label{sec:\csname label@base\endcsname.pagestyle.content}
+
+\IfCommon{scrlayer}{%
+ Even though \Package{scrlayer} itself does not define a concrete page style
+ with content\,---\,the already mentioned page styles \Pagestyle{@everystyle@}
+ and \Pagestyle{empty} are initially defined without any level and so empty
+ and without content\,---\,, it provides some options and commands for the
+ manipulation of the contents.%
+}
+
+\IfCommon{scrlayer-scrpage}{%
+ \hyperref[sec:scrlayer-scrpage.predefined.pagestyles]%
+ {Section~\ref*{sec:scrlayer-scrpage.predefined.pagestyles}}
+ states the predefined defaults for the page style \Pagestyle{scrheadings}
+ and \Pagestyle{plain.scrheadings} and how they can be adapted. But
+ information about the generation of, i.\,e., the running heads, the
+ manipulation of the widths of page head and footer, and how you can get
+ horizontal lines printed above or below the page head or footer are still
+ missing. Even though all these are features of package \Package{scrlayer},
+ they will be described consecutively, because these basic features of
+ \Package{scrlayer} are also a fundamental part of the features of
+ \Package{scrlayer-scrpage}.%
+}
+
+\ifshortversion\IgnoreThistrue\IfCommon{scrlayer-scrpage}{\IgnoreThisfalse}\fi
+\ifIgnoreThis %++++++++++++++++++++++++++++++++++++++++ not scrlayer-scrpage +
+\else %----------------------------------------------- only scrlayer-scrpage -
+
+\begin{Declaration}
+ \Macro{automark}\OParameter{section level of the right mark}%
+ \Parameter{section level of the left mark}\\
+ \Macro{automark*}\OParameter{section level of the right mark}%
+ \Parameter{section level of the left mark}\\
+ \Macro{manualmark}\\
+ \Option{automark}\\
+ \KOption{autooneside}\PName{simple switch}\\
+ \Option{manualmark}
+\end{Declaration}
+\BeginIndex{Cmd}{automark}%
+\BeginIndex{Cmd}{manualmark}%
+\BeginIndex{Option}{automark}%
+\BeginIndex{Option}{manualmark}%
+\BeginIndex{Option}{autooneside~=\PName{simple switch}}%
+With the \LaTeX{} standard classes or the \KOMAScript{} classes the decision
+whether using automatic running heads\Index{running heads>automatic}, or
+static or manual running heads\Index{running heads>static}\Index{running
+ heads>manual} would be done using either page style \Pagestyle{headings} or
+\Pagestyle{myheadings}. Automatic running heads are replications of a
+significant, characterizing text snippet of the page mostly inside the page
+head, sometimes in the page footer.
+
+The article classes\OnlyAt{\Class{article}\and \Class{scrartcl}}
+\Class{article} or \Class{scrartcl} with page style
+\Pagestyle{headings}\IndexPagestyle{headings} use the section heading, which
+is either the mandatory or the optional argument of \Macro{section}, for the
+automatic running head of single side documents. Double side documents use
+this section heading as the \emph{left mark} and at once use the subsection
+heading as the \emph{right mark}. The left mark will be printed on left pages,
+which founds the name \emph{left mark}. The right mark will be printed on
+right\,---\,in single side mode this means every\,---\,page. The classes by
+default also remove the right mark whenever they put the section heading into
+the left mark.
+
+The report and book classes \OnlyAt{\Class{report}\and
+ \Class{scrreprt}\and \Class{book}\and \Class{scrbook}} start one level
+higher. So they use the chapter heading to be the right mark in single side
+layout. In double side layout they use the chapter heading to be the left mark
+and the section heading to be the right mark.
+
+If you are using \Pagestyle{myheadings} instead of
+\Pagestyle{headings}\IndexPagestyle{myheadings}, the marks in the page header
+still exists and would be printed same like using \Pagestyle{headings}. But
+section commands will not automatically set the marks any longer. So you can
+fill them only using the commands \Macro{markright}, \Macro{markleft}, and
+\Macro{markboth}, which will be described later in this section.
+
+This difference between two page styles has been abolished by
+\Package{scrpage2} and also by \Package{scrlayer}. Instead of distinguishing
+between automatic and manual running head by the selection of a page style,
+two new commands, \Macro{automark} and \Macro{manualmark}, are provided. The
+command \Macro{manualmark} switches to manual marks and deactivates the
+automatic filling of the marks. In contrast to this \Macro{automark} and
+\Macro{automark*} can be used to define, which section levels should be used
+for the automatic mark filling. The optional argument is the \PName{section
+ level of the right mark}, the mandatory argument the \PName{section level of
+ the left mark}. The arguments always should be the name of a section level
+like \PValue{part}, \PValue{chapter}, \PValue{section}, \PValue{subsection},
+\PValue{subsubsection}, \PValue{paragraph}, or \PValue{subparagraph}.
+
+Generally the higher level should be used for the left mark and the lower
+level for the right mark. This is only a convention and not a need, but it
+makes sense.
+
+The difference in \Macro{automark} and \Macro{automark*} is, that
+\Macro{automark} deletes all prior usages of \Macro{automark} or
+\Macro{automark*}, while \Macro{automark*} changes only the behaviour of the
+section levels of its arguments. So you can even build more complex cases.
+
+\begin{Example}
+ Assume you want the chapter heading to be the running head of even pages
+ and the section heading to be the running head of odd pages like this is
+ usual for books. But on odd pages you also want the chapter headings as a
+ running head as long as the first section appears. To do so, you first have
+ to load \Package{scrlayer-scrpage} and select page style
+ \Pagestyle{scrheadings}. So you're document starts with:
+\begin{lstcode}
+ \documentclass{scrbook}
+ \usepackage{scrlayer-scrpage}
+ \pagestyle{scrheadings}
+\end{lstcode}
+ Next you will setup the chapter heading to be not only the left but also the
+ right mark:
+\begin{lstcode}
+ \automark[chapter]{chapter}
+\end{lstcode}
+ Then the section heading should also become a right mark:
+\begin{lstcode}
+ \automark*[section]{}
+\end{lstcode}
+ Here the star version is used, because the prior \Macro{automark} command
+ should be still valid. Additionally the mandatory argument for the
+ \PName{section level of the left mark} is empty, because this mark should be
+ unchanged.
+
+ Now you just need some document contents to see a result:
+\begin{lstcode}
+ \usepackage{lipsum}
+ \begin{document}
+ \chapter{Chapter Heading}
+ \lipsum[1-20]
+ \section{Section Heading}
+ \lipsum[21-40]
+ \end{document}
+\end{lstcode}
+ We once again use package \Package{lipsum}\IndexPackage{lipsum} to generate
+ some dummy text with command \Macro{lipsum}\IndexCmd{lipsum}. The package is
+ really useful.
+
+ If you'd test the example, you'd see, that the chapter start page does not
+ have a running head as usual. This is, because it automatically uses the
+ \Pagestyle{plain} page style \Pagestyle{plain.scrheadings}. Pages~2--4 have
+ the chapter headings in the running head. After the section heading on
+ page~4 the running head of page~5 changes into this section heading. From
+ this page to the end the running head alternates between chapter and section
+ heading from page to page.
+\end{Example}
+
+Instead of the commands you may also use the options \Option{manualmark} and
+\Option{automark} to switch between manual and automatic running
+heads. Thereby \Option{automark} always uses the default
+\begin{lstcode}[belowskip=\dp\strutbox]
+ \automark[section]{chapter}
+\end{lstcode}
+for classes with \Macro{chapter} and
+\begin{lstcode}[belowskip=\dp\strutbox]
+ \automark[subsection]{section}
+\end{lstcode}
+for classes without \Macro{chapter}.
+
+But normally in single side mode you do not want that the lower level
+influences the right mark, you want the higher level, that
+will fill only the left mark in double side layout, to be the running head of
+all pages. The default option \Option{autooneside} corresponds to this
+behaviour. The option understands the values for simple switches, that can be
+found in \autoref{tab:truefalseswitch} on
+\autopageref{tab:truefalseswitch}. If you'd deactivate the option, in single
+side layout the optional and the obligatory arguments of \Macro{automark} and
+\Macro{automark*} will influence the running head again.%
+%
+\begin{Example}
+ Assume you have a single sided report but want similar running heads as in
+ the book example before. The chapter headings should be used as a running
+ head as long as the first section appears. From the first section on, the
+ section heading should be used. So we modify the previous example a little
+ bit:
+\begin{lstcode}
+ \documentclass{scrreprt}
+ \usepackage[autooneside=false]{scrlayer-scrpage}
+ \pagestyle{scrheadings}
+ \automark[section]{chapter}
+ \usepackage{lipsum}
+ \begin{document}
+ \chapter{Chapter Heading}
+ \lipsum[1-20]
+ \section{Section Heading}
+ \lipsum[21-40]
+ \end{document}
+\end{lstcode}
+ You can see, that we do not need a \Macro{automark*} command in this
+ case. Please try the example also with \Option{autooneside} set to
+ \PValue{true} or remove the option and its value. You should find a
+ difference at the running head in the pages' head from page~4 on.
+\end{Example}
+
+Please note\textnote{Attention!}, only loading the package does not have
+any effect on the fact whether automatic or manual running heads are used or
+what kind of section headings do fill up the marks. Only using an explicit
+option \Option{automark} or \Option{manualmark} or one of the commands
+\Macro{automark} or \Macro{manualmark} can reach a well defined state.%
+\EndIndex{Option}{autooneside~=\PName{simple switch}}%
+\EndIndex{Option}{manualmark}%
+\EndIndex{Option}{automark}%
+\EndIndex{Cmd}{manualmark}%
+\EndIndex{Cmd}{automark}%
+\fi % ******************************************** End only scrlayer-scrpage *
+
+\ifshortversion\IgnoreThistrue\IfCommon{scrlayer}{\IgnoreThisfalse}\fi
+\ifIgnoreThis %++++++++++++++++++++++++++++++++++++++++++++++++ not scrlayer +
+\else %------------------------------------------------------- only scrlayer -
+
+\begin{Declaration}
+ \KOption{draft}\PName{simple switch}
+\end{Declaration}
+\BeginIndex{Option}{draft~=\PName{simple switch}}%
+This \KOMAScript{} option understands the values for simple switches, that are
+shown in \autoref{tab:truefalseswitch} on \autopageref{tab:truefalseswitch}. If
+the option is active, all elements of the page styles will also show dimension
+lines. This might be useful while draft editing. If the option has been set as
+a global option (see the optional argument of \Macro{documentclass}), but you
+do not want the dimension lines, you can deactivate them for the package only
+using \OptionValue{draft}{false} as an optional argument of \Macro{usepackage}
+while loading the package.%
+\EndIndex{Option}{draft~=\PName{Ein-Aus-Wert}}%
+
+\begin{Declaration}
+ \Macro{MakeMarkcase}\Parameter{string}
+\end{Declaration}
+\BeginIndex{Cmd}{MakeMarkcase}%
+The automatic running head and only this uses \Macro{MakeMarkcase} for its
+output. If the command has not been defined, e.\,g., by the class, while
+loading \Package{scrlayer}, it would be defined with the default of outputting
+the argument \PName{string} without changes. But the default can be change
+either redefining \Macro{MakeMarkcase} or using option \Option{markcase}, that
+\ifshortversion has been described in
+\autoref{sec:scrlayer-scrpage.pagestyle.content}%
+\else will be described next%
+\fi%
+. Depending on the setting the argument could, e.\,g., be converted into upper
+or lower cases.
+%
+\EndIndex{Cmd}{MakeMarkcase}%
+\fi %***************************************************** End only scrlayer *
+
+\ifshortversion\IgnoreThistrue\IfCommon{scrlayer-scrpage}{\IgnoreThisfalse}\fi
+\ifIgnoreThis %++++++++++++++++++++++++++++++++++++++++ not scrlayer-scrpage +
+\else %----------------------------------------------- only scrlayer-scrpage -
+\begin{Declaration}
+ \KOption{markcase}\PName{Wert}
+\end{Declaration}
+\BeginIndex{Option}{markcase~=\PName{Wert}}%
+As already mentioned with \Package{scrlayer} you may switch between manual and
+automatic running heads. Using automatic running heads the corresponding marks
+will be filled by the section heading commands. Some culture areas do convert
+the running heads into upper case letters in opposite to the German
+typographic habit. The \LaTeX{} standard classes do so by default. Package
+\Package{scrlayer} optionally provides this too. Therefor you'd use option
+\OptionValue{markcase}{upper} which results in a redefinition of
+\Macro{MakeMarkcase}\IndexCmd[indexmain]{MakeMarkcase}, a command, that is
+used by \Package{scrlayer} for automatic running heads.
+
+Unfortunately \LaTeX's command for upper case letter typesetting,
+\Macro{MakeUppercase}\IndexCmd{MakeUppercase} results in an very inadequate
+typesetting, because it neither uses letter spacing nor does it space
+balancing. One reason for this behaviour might be, that a glyph analyzing
+would be needed, to incorporate the letter shapes and their combination while
+space balancing. Because of this \KOMAScript{} author suggests to abstain from
+upper case letter typesetting for running heads. This could be achieved using
+\OptionValue{markcase}{used}. Nevertheless, some classes would add
+\Macro{MarkUppercase} or even \TeX{} command \Macro{uppercase} into the
+running heads. For such cases option \OptionValue{markcase}{noupper} can be
+used. This will also deactivate \Macro{MakeUppercase} and \Macro{uppercase}
+inside the running heads.
+
+You can find all valid values for \Option{markcase} in
+\autoref{tab:scrlayer-scrpage.markcase}.%
+%
+\begin{table}
+ \centering
+ \caption[Possible values for option \Option{markcase}]{Possible values for
+ option \Option{markcase} to select upper/lower case letter typesetting in
+ automatic running heads}%
+ \label{tab:scrlayer-scrpage.markcase}%
+ \begin{desctabular}
+ \pventry{lower}{\IndexOption{markcase~=\PValue{lower}}%
+ redefines \Macro{MakeMarkcase} to convert the automatic running heads
+ into lower case letters using \Macro{MakeLowercase}
+ (lower case typesetting).%
+ }%
+ \pventry{upper}{\IndexOption{markcase~=\PValue{upper}}%
+ redefines \Macro{MakeMarkcase} to convert the automatic running heads
+ into upper case letters using \Macro{MakeUppercase}
+ (upper case typesetting).%
+ }%
+ \pventry{used}{\IndexOption{markcase~=\PValue{used}}%
+ redefines \Macro{MakeMarkcase} to use automatic running heads without
+ any case changes.%
+ }%
+ \entry{\PValue{ignoreuppercase}, \PValue{nouppercase},
+ \PValue{ignoreupper},
+ \PValue{noupper}}{\IndexOption{markcase~=\PValue{noupper}}%
+ redefines not only \Macro{MakeMarkcase} but also locally to the running
+ heads \Macro{MakeUppercase} and \Macro{uppercase} to leave the automatic
+ running heads unchanged.%
+ }%
+ \end{desctabular}
+\end{table}
+%
+\EndIndex{Option}{markcase~=\PName{Wert}}%
+
+\begin{Declaration}
+ \Macro{leftmark}\\
+ \Macro{rightmark}\\
+ \Macro{headmark}\\
+ \Macro{pagemark}
+\end{Declaration}
+\BeginIndex{Cmd}{leftmark}%
+\BeginIndex{Cmd}{rightmark}%
+\BeginIndex{Cmd}{headmark}%
+\BeginIndex{Cmd}{pagemark}%
+If you want to differ from the predefined page styles, usually you need to
+decide, where to place the marks' contents. With \Macro{leftmark} you can state
+the contents of the left mark.
+
+Similar you can use \Macro{rightmark} to state the contents of the right
+mark. For more information about some intricacies of this see the further
+description of \Macro{rightmark} in \autoref{sec:maincls-experts.addInfos},
+\autopageref{desc:maincls-experts.cmd.rightmark}.
+
+Somehow easier would be usage of \Macro{headmark}. This extension of
+\Package{scrlayer} aliases either \Macro{leftmark} or \Macro{rightmark}
+depending on whether the current page is even or odd.
+
+Strictly thought command \Macro{pagemark} is not involved by \TeX's mark
+mechanism. It is only used to output a formatted page number.
+\BeginIndex{FontElement}{pagenumber}%
+The font of element
+\FontElement{pagenumber}\important{\FontElement{pagenumber}} will be used for
+the output. This can be changed using command \Macro{setkomafont} or
+\Macro{addtokomafont} (see also \autoref{sec:maincls.textmarkup},
+\autopageref{desc:maincls.cmd.setkomafont}).%
+\EndIndex{FontElement}{pagenumber}%
+%
+\begin{Example}
+ Assume you want to use a left aligned running head and right aligned page
+ number in the head of the pages of a document in single side layout. The
+ following minimal but working examples would do so:
+\begin{lstcode}
+ \documentclass{scrreprt}
+ \usepackage{blindtext}
+ \usepackage[automark]{scrlayer-scrpage}
+ \pagestyle{scrheadings}
+ \ihead{\headmark}
+ \ohead[\pagemark]{\pagemark}
+ \chead{}
+ \cfoot[]{}
+ \begin{document}
+ \blinddocument
+ \end{document}
+\end{lstcode}
+ Here package \Package{blindtext}\IndexPackage{blindtext} with its command
+ \Macro{blinddocument}\IndexCmd{blinddocument} has been used to easily
+ generate content for an example document.
+
+ Commands \Macro{ihead} and \Macro{ohead} have been used to place the wanted
+ marks. Although the page mark will be place not only to pages in page style
+ \Pagestyle{scrheadings} but using the optional argument also to pages in
+ page style \Pagestyle{plain.scrheadings}.
+
+ Because of both page styles already have marks in the middle of the page
+ head and page foot, those elements will be cleared using \Macro{chead} and
+ \Macro{cfoot} with empty arguments. Alternatively you'd use
+ \Macro{clearpairofpagestyles} \emph{before} \Macro{ihead}. You will find a
+ description of this command in
+ \autoref{sec:scrlayer-scrpage.pagestyle.pairs}.
+\end{Example}
+
+Please note\textnote{Attention!}, that the empty optional argument of
+\Macro{cfoot} in the example above is not the same like omitting the optional
+argument. Please try it out and have a look at the difference in the footer of
+the first page.%
+%
+\EndIndex{Cmd}{pagemark}%
+\EndIndex{Cmd}{headmark}%
+\EndIndex{Cmd}{rightmark}%
+\EndIndex{Cmd}{leftmark}%
+
+\begin{Declaration}
+ \Macro{partmarkformat}\\
+ \Macro{chaptermarkformat}\\
+ \Macro{sectionmarkformat}\\
+ \Macro{subsectionmarkformat}\\
+ \Macro{subsubsectionmarkformat}\\
+ \Macro{paragraphmarkformat}\\
+ \Macro{subparagraphmarkformat}
+\end{Declaration}
+\BeginIndex{Cmd}{partmarkformat}%
+\BeginIndex{Cmd}{chaptermarkformat}%
+\BeginIndex{Cmd}{sectionmarkformat}%
+\BeginIndex{Cmd}{subsectionmarkformat}%
+\BeginIndex{Cmd}{subsubsectionmarkformat}%
+\BeginIndex{Cmd}{paragraphmarkformat}%
+\BeginIndex{Cmd}{subparagraphmarkformat}%
+Usually the \KOMAScript{} classes and package \Package{scrlayer} use these
+commands internally to bring the section numbers into wanted form and
+additionally they support the \Macro{autodot} mechanism of the \KOMAScript{}
+classes. If wanted these commands may be redefined to get another form of
+section numbers.%
+%
+\begin{Example}
+ Assume you do not want section numbers but section heading text only in the
+ running head. So:
+\begin{lstcode}
+ \renewcommand*{\sectionmarkformat}{}
+\end{lstcode}
+ would be a simple solution for this.
+\end{Example}
+%
+\EndIndex{Cmd}{subparagraphmarkformat}%
+\EndIndex{Cmd}{paragraphmarkformat}%
+\EndIndex{Cmd}{subsubsectionmarkformat}%
+\EndIndex{Cmd}{subsectionmarkformat}%
+\EndIndex{Cmd}{sectionmarkformat}%
+\EndIndex{Cmd}{chaptermarkformat}%
+\EndIndex{Cmd}{partmarkformat}%
+
+\begin{Declaration}
+ \Macro{partmark}\Parameter{Text}\\
+ \Macro{chaptermark}\Parameter{Text}\\
+ \Macro{sectionmark}\Parameter{Text}\\
+ \Macro{subsectionmark}\Parameter{Text}\\
+ \Macro{subsubsectionmark}\Parameter{Text}\\
+ \Macro{paragraphmark}\Parameter{Text}\\
+ \Macro{subparagraphmark}\Parameter{Text}
+\end{Declaration}
+\BeginIndex{Cmd}{partmark}%
+\BeginIndex{Cmd}{chaptermark}%
+\BeginIndex{Cmd}{sectionmark}%
+\BeginIndex{Cmd}{subsectionmark}%
+\BeginIndex{Cmd}{subsubsectionmark}%
+\BeginIndex{Cmd}{paragraphmark}%
+\BeginIndex{Cmd}{subparagraphmark}%
+Most classes use these commands to setup marks corresponding to the
+section commands. Thereby the only argument is the text without the number of
+the section heading, that should be used for the running head. For the number
+simply the number of the current section level will be used, if the current
+level uses numbers.
+
+If users redefine these commands, they should\textnote{Attention!} take care
+to also use the counter \Counter{secnumdepth} for the test whether or not the
+section level should output a number, even in the case the user
+does not change counter \Counter{secnumdepth} himself, because packages and
+classes may do so locally and rely on correct handling of
+\Counter{secnumdepth}.
+
+However, package \Package{scrlayer} redefines these commands whenever you use
+\Macro{automark} or \Macro{manualmark} or the corresponding options, to
+activate or deactivate the wanted running heads.%
+%
+\EndIndex{Cmd}{subparagraphmark}%
+\EndIndex{Cmd}{paragraphmark}%
+\EndIndex{Cmd}{subsubsectionmark}%
+\EndIndex{Cmd}{subsectionmark}%
+\EndIndex{Cmd}{sectionmark}%
+\EndIndex{Cmd}{chaptermark}%
+\EndIndex{Cmd}{partmark}%
+
+\begin{Declaration}
+ \Macro{markleft}\Parameter{left mark}\\
+ \Macro{markright}\Parameter{right mark}\\
+ \Macro{markboth}\Parameter{left mark}\Parameter{right mark}
+\end{Declaration}
+\BeginIndex{Cmd}{markleft}%
+\BeginIndex{Cmd}{markright}%
+\BeginIndex{Cmd}{markboth}%
+Independent of whether currently manual or automatic running heads are active,
+you may change the contents of the \PName{left mark} or the \PName{right mark}
+at any time using these commands. You should note, that the resulting contents
+of \Macro{leftmark}\IndexCmd{leftmark} is the \PName{left
+ mark} of the last \Macro{markleft} or \Macro{markboth} command of the
+current page. In opposite to this the resulting contents of
+\Macro{rightmark}\IndexCmd{rightmark} is the \PName{right mark} of the first
+\Macro{rightmark} or \Macro{markboth} command of the current page.
+
+If you are using manual running heads, the marks will stay valid until one of
+the corresponding commands will be used again. If you are using automatic
+running heads the marks can loose their validity with the next section heading
+depending on the configuration of the automatism.
+
+You may also use these commands together with the star versions of the section
+commands.%
+%
+\begin{Example}
+ Assume you are using a preface with several pages just before the table of
+ contents, that should not have an entry at the table of contents
+ itself. Because of using a separation line at the page head, you want also a
+ running head for this preface:
+\begin{lstcode}
+ \documentclass[headsepline]{book}
+ \usepackage{scrlayer-scrpage}
+ \pagestyle{scrheadings}
+ \usepackage{blindtext}
+ \begin{document}
+ \chapter*{Preface}
+ \markboth{Preface}{Preface}
+ \blindtext[20]
+ \tableofcontents
+ \blinddocument
+ \end{document}
+\end{lstcode}
+ First of all this seems to produce the wanted result. But have a closer
+ look: In difference to the other running heads ``\texttt{Preface}'' is not in
+ upper case letters. But you can fix this easily:
+\begin{lstcode}
+ \documentclass[headsepline]{book}
+ \usepackage{scrlayer-scrpage}
+ \pagestyle{scrheadings}
+ \usepackage{blindtext}
+ \begin{document}
+ \chapter*{Preface}
+ \markboth{\MakeMarkcase{Preface}}{\MakeMarkcase{Preface}}
+ \blindtext[20]
+ \tableofcontents
+ \blinddocument
+ \end{document}
+\end{lstcode}
+ Using command \Macro{MakeMarkcase} results in getting the same letter case
+ as for automatic running heads.
+
+ Now, let's move command \Macro{tableofcontents} in front of the
+ preface. Let's remove the \Macro{markboth} command too. You'll realise, that
+ the preface now has the running head ``\texttt{CONTENTS}''. This is because
+ of a quirk of \Macro{chapter*} (see also \autoref{sec:maincls.structure} on
+ \autopageref{desc:maincls.cmd.chapter*}). If in such cases the running head
+ should be removed, \Macro{markboth} with two empty arguments would be
+ useful:
+\begin{lstcode}
+ \documentclass[headsepline]{book}
+ \usepackage{scrlayer-scrpage}
+ \pagestyle{scrheadings}
+ \usepackage{blindtext}
+ \begin{document}
+ \tableofcontents
+ \chapter*{Preface}
+ \markboth{}{}
+ \blindtext[20]
+ \blinddocument
+ \end{document}
+\end{lstcode}
+\end{Example}
+%
+\EndIndex{Cmd}{markboth}%
+\EndIndex{Cmd}{markright}%
+\EndIndex{Cmd}{markleft}%
+
+\fi %********************************************* End only scrlayer-scrpage *
+
+
+\ifshortversion\IgnoreThistrue\IfCommon{scrlayer}{\IgnoreThisfalse}\fi
+\ifIgnoreThis %++++++++++++++++++++++++++++++++++++++++++++++++ not scrlayer +
+\else %------------------------------------------------------- only scrlayer -
+
+\begin{Declaration}
+ \Macro{GenericMarkFormat}\Parameter{name of the section level}
+\end{Declaration}
+\BeginIndex{Cmd}{GenericMarkFormat}%
+At the running head this command will be used by default for the formatting of
+all section numbers below the subsection and with classes without
+\Macro{chapter} also for the section level and the subsection level, if the
+mark commands for those numbers have not been defined before loading
+\Package{scrlayer}. Thereby the package uses \Macro{@seccntmarkformat} if such
+a command has been defined, like the \KOMAScript{} classes do. Otherwise
+\Macro{@seccntformat} will be used, which is provided by the \LaTeX{}
+kernel. The expected, mandatory argument of the command is the \PName{name of
+ a section level}, i.\,e., \PValue{chapter} or \PValue{section}
+\emph{without} the backslash prefix.
+
+You can change the default formatting of the numbers, that use this command,
+by redefining only this single command. Classes can change the default
+formatting also by defining this command.%
+%
+\begin{Example}
+ Assume you want the section numbers of all levels at the running head of
+ an article to be printed in white colour inside a black coloured box. Using
+ standard \LaTeX{} \Class{article} class, package \Package{scrlayer} defines
+ the number mark commands \Macro{sectionmarkformat} and
+ \Macro{subsectionmarkformat} using \Macro{GenericMarkFormat}. So you need to
+ redefine only this single command:
+\begin{lstcode}
+ \documentclass{article}
+ \usepackage{blindtext}
+ \usepackage[automark]{scrlayer-scrpage}
+ \pagestyle{scrheadings}
+ \usepackage{xcolor}
+ \newcommand*{\numberbox}[1]{%
+ \colorbox{black}{\strut~\textcolor{white}{#1}~}}
+ \renewcommand*{\GenericMarkFormat}[1]{%
+ \protect\numberbox{\csname the#1\endcsname}\enskip}
+ \begin{document}
+ \blinddocument
+ \end{document}
+\end{lstcode}
+ The colour has been done using package
+ \Package{xcolor}\IndexPackage{xcolor}. See the package manual for more
+ information about this. Additionally a not visible strut has been
+ used. Every complete \LaTeX{} introduction should explain the related
+ command \Macro{strut}. A helper macro \Macro{numberbox} has been defined for
+ the formatting of the number within a box. In the redefinition of
+ \Macro{GenericMarkFormat} this has been prefixed by
+ \Macro{protect} to protect it from expansion. This is necessary because
+ otherwise the upper case letter conversion of \Macro{MakeUppercase} that
+ will be used for the running head, would result in an ask for colours
+ ``\texttt{BLACK}'' and ``\texttt{WHITE}'' instead of ``\texttt{black}'' and
+ ``\texttt{white}'' and those colours are undefined. Alternatively you may
+ define \Macro{numberbox} using \Macro{DeclareRobustCommand*} instead of
+ \Macro{newcommand*} and then omit \Macro{protect} (see
+ \cite{latex:clsguide}).
+
+ If you'd do the same with a \KOMAScript{} class or with one of the \LaTeX{}
+ standard classes \Class{book} or \Class{report}, you'd additionally have to
+ redefine \Macro{sectionmarkformat} and \Macro{subsectionmarkformat}
+ respectively \Macro{chaptermarkformat} and \Macro{sectionmarkformat} too,
+ because then these would not have been defined using
+ \Macro{GenericMarkFormat}:
+\begin{lstcode}
+ \documentclass{scrbook}
+ \usepackage{blindtext}
+ \usepackage[automark]{scrlayer-scrpage}
+ \pagestyle{scrheadings}
+ \usepackage{xcolor}
+ \newcommand*{\numberbox}[1]{%
+ \colorbox{black}{\strut~\textcolor{white}{#1}~}}
+ \renewcommand*{\GenericMarkFormat}[1]{%
+ \protect\numberbox{\csname the#1\endcsname}\enskip}
+ \renewcommand*{\chaptermarkformat}{\GenericMarkFormat{chapter}}
+ \renewcommand*{\sectionmarkformat}{\GenericMarkFormat{section}}
+ \begin{document}
+ \blinddocument
+ \end{document}
+\end{lstcode}
+\end{Example}
+%
+\EndIndex{Cmd}{GenericMarkFormat}%
+
+\begin{Declaration}
+ \Macro{@mkleft}\Parameter{left mark}\\
+ \Macro{@mkright}\Parameter{right mark}\\
+ \Macro{@mkdouble}\Parameter{mark}\\
+ \Macro{@mkboth}\Parameter{left mark}\Parameter{right mark}
+\end{Declaration}
+\BeginIndex{Cmd}{@mkleft}%
+\BeginIndex{Cmd}{@mkright}%
+\BeginIndex{Cmd}{@mkdouble}%
+\BeginIndex{Cmd}{@mkboth}%
+Sometimes inside classes and packages the marks for running heads should be
+filled up only if automatic running heads are active (see option
+\Option{automark} and command \Macro{automark} on
+\autopageref{desc:scrlayer-scrpage.cmd.automark}). In the \LaTeX{} standard
+classes only \Macro{@mkboth} has been used for this. This command is either
+\Macro{@gobbletwo}, that simply destroys both mandatory arguments, or
+\Macro{markboth}, a command that fills up the left and \PValue{left mark} and
+the \PValue{right mark}. Packages like \Package{babel} also change
+\Macro{\@mkboth}, i.\,e., to add language switching to the running head.
+
+But if a class or package author only wants to change either the \PName{left
+ mark} or the \PName{right mark} without the other one, a proper command is
+missing. Package \Package{scrlayer} itself needs such commands for the
+implementation of all cases of automatic running heads. So if command
+\Macro{@mkleft} to fill up only the left mark or \Macro{@mkright} to fill up
+only the right mark or \Macro{@mkdouble} to fill up both marks with the same
+content is undefined while loading \Package{scrlayer}, the package will define
+them. Thereby the actual definition of \Macro{@mkboth} will be used as an
+indicator whether or not automatic running heads should be used. The new
+commands will full up the marks only in the case of automatic running heads.
+
+Class and package authors can use these commands too, if they want to fill up
+only one of the marks or both marks with the same content but only if
+automatic running heads are activated. This condition is also the difference
+to the commands \Macro{markleft}, \Macro{markright}, and \Macro{markboth}.%
+\EndIndex{Cmd}{@mkboth}%
+\EndIndex{Cmd}{@mkdouble}%
+\EndIndex{Cmd}{@mkright}%
+\EndIndex{Cmd}{@mkleft}%
+
+
+\fi %***************************************************** End only scrlayer *
+
+
+\ifshortversion%
+\IfCommon{scrlayer}{%
+ For more information about manipulation of the contents of page styles see
+ also \autoref{sec:scrlayer-scrpage.pagestyle.content} from
+ \autopageref{sec:scrlayer-scrpage.pagestyle.content}.%
+}%
+\fi
+
+%%% Local Variables:
+%%% mode: latex
+%%% mode: flyspell
+%%% coding: iso-latin-1
+%%% ispell-local-dictionary: "en_GB"
+%%% TeX-master: "scrlayer-de.tex"
+%%% TeX-PDF-mode: t
+%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-3.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-3.tex
index 4ab9ce77ef9..a747b1f68e2 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-3.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-3.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-3.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-3.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-3.tex}[2012/05/15 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-3.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\translator{Markus Kohm\and Krickette Murabayashi}
% Date of the translated german file: 2009/11/28
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-4.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-4.tex
index 38c0e9e2730..8388bc8a938 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-4.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-4.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-4.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-4.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-4.tex}[2012/05/15 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-4.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\translator{Markus Kohm\and Krickette Murabayashi}
% Date of the translated German file: 2011/09/05
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-5.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-5.tex
index dfbf6fd9aff..fea58a3a5ee 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-5.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-5.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-5.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-5.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,10 +45,12 @@
%
% ======================================================================
-\ProvidesFile{common-5.tex}[2012/05/15 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-5.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi}
-% Date of the translated German file: 2012/01/01
+% Date of the translated German file: 2013/07/31
\makeatletter
\@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}%
@@ -60,11 +62,12 @@
\section{Text Markup}
\label{sec:\csname label@base\endcsname.textmarkup}%
-\ifshortversion\IgnoreThisfalse\IfCommon{scrlttr2}{\IgnoreThistrue}\fi%
-\ifIgnoreThis %++++++++++++++++++++++++++++++++++++++++++++++ nur scrlttr2 +
+\IgnoreThisfalse
+\ifshortversion\IgnoreThistrue\ifCommonmaincls\IgnoreThisfalse\fi\fi%
+\ifIgnoreThis %++++++++++++++++++++++++++++++++++++ short version (maincls) +
What is described in
\autoref{sec:maincls.textmarkup} applies, mutatis mutandis.
-\else %---------------------------------------------------- nicht scrlttr2 -
+\else %----------------------------------------- long version (not maincls) -
\BeginIndex{}{text>markup}%
\BeginIndex{}{font}%
@@ -177,8 +180,8 @@ You should\textnote{Attention!}, however, absolutely limit yourself to those
statements that really switch only one font attribute. This will usually be
the commands \Macro{normalfont}, \Macro{rmfamily}, \Macro{sffamily},
\Macro{ttfamily}, \Macro{mdseries}, \Macro{bfseries}, \Macro{upshape},
-\Macro{itshape}, \Macro{slshape}, and \Macro{scshape}, as well as the font size
-commands \Macro{Huge}, \Macro{huge}, \Macro{LARGE}, \Macro{Large},
+\Macro{itshape}, \Macro{slshape}, and \Macro{scshape}, as well as the font
+size commands \Macro{Huge}, \Macro{huge}, \Macro{LARGE}, \Macro{Large},
\Macro{large}, \Macro{normalsize}, \Macro{small}, \Macro{footnotesize},
\Macro{scriptsize}, and \Macro{tiny}. The description of these commands can be
found in \cite{lshort}, \cite{latex:usrguide}, or \cite{latex:fntguide}. Color
@@ -192,7 +195,7 @@ completely new definition. In contrast to this, the \Macro{addtokomafont}
command merely extends an existing definition. It is recommended to not use
both commands inside the document body, but only in the document preamble.
Usage examples can be found in the paragraphs on the corresponding element.
-\fi %************************************************* Ende nicht scrlttr2 *
+\fi %**************************************** End long version (not maincls) *
Names and meanings of the individual items are listed in %
\IfNotCommon{scrextend}{\autoref{tab:\csname
label@base\endcsname.elementsWithoutText}}%
@@ -206,6 +209,362 @@ Names and meanings of the individual items are listed in %
the \KOMAScript{} classes. }%
The default values are shown in the corresponding paragraphs.
+\ifIgnoreThis %++++++++++++++++++++++++++++++++++++ short version (maincls) +
+\else %----------------------------------------- long version (not maincls) -
+With command \Macro{usekomafont} the current font style may be changed into
+the font style of the selected \PName{element}.
+%
+\ifCommonmaincls %++++++++++++++++++++++++++++++++++++++++++++ maincls only +
+%
+\begin{Example}
+ \phantomsection\label{desc:maincls.setkomafont.example}%
+ Assume that you want to use for the element \FontElement{captionlabel} the
+ same font specification that is used with
+ \FontElement{descriptionlabel}. This can be easily done with:
+\begin{lstcode}
+ \setkomafont{captionlabel}{%
+ \usekomafont{descriptionlabel}%
+ }
+\end{lstcode}
+ You can find other examples in the paragraphs on each element.
+\end{Example}
+
+\begin{desclist}
+ \desccaption{%
+ Elements whose type style can be changed with the {\KOMAScript} command
+ \Macro{setkomafont} or
+ \Macro{addtokomafont}\label{tab:maincls.elementsWithoutText}%
+ }{%
+ Elements whose type style can be changed (\emph{continuation})%
+ }%
+ \feentry{author}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}}%
+ author of the document on the main title, i.\,e., the argument of
+ \Macro{author} when \Macro{maketitle} will be used (see
+ \autoref{sec:maincls.titlepage}, \autopageref{desc:maincls.cmd.author})}%
+ \feentry{caption}{text of a table or figure caption (see
+ \autoref{sec:maincls.floats}, \autopageref{desc:maincls.cmd.caption})}%
+ \feentry{captionlabel}{label of a table or figure caption; used according to
+ the element \FontElement{caption} (see \autoref{sec:maincls.floats},
+ \autopageref{desc:maincls.cmd.caption})}%
+ \feentry{chapter}{title of the sectional unit \Macro{chapter} (see
+ \autoref{sec:maincls.structure}, \autopageref{desc:maincls.cmd.chapter})}%
+ \feentry{chapterentry}{%
+ table of contents entry of the sectional unit \Macro{chapter} (see
+ \autoref{sec:maincls.toc},
+ \autopageref{desc:maincls.cmd.tableofcontents})}%
+ \feentry{chapterentrypagenumber}{%
+ page number of the table of contents entry of the sectional unit
+ \Macro{chapter}, variation on the element \FontElement{chapterentry} (see
+ \autoref{sec:maincls.toc},
+ \autopageref{desc:maincls.cmd.tableofcontents})}%
+ \feentry{chapterprefix}{%
+ chapter number line at setting \OptionValue{chapterprefix}{true} or
+ \OptionValue{appendixprefix}{true} (see \autoref{sec:maincls.structure},
+ \autopageref{desc:maincls.option.chapterprefix})}%
+ \feentry{date}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}}%
+ date of the document on the main title, i.\,e., the argument of
+ \Macro{date} when \Macro{maketitle} will be used (see
+ \autoref{sec:maincls.titlepage}, \autopageref{desc:maincls.cmd.date})}%
+ \feentry{dedication}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}}%
+ dedication page after the main title, i.\,e., the argument of
+ \Macro{dedication} when \Macro{maketitle} will be used (see
+ \autoref{sec:maincls.titlepage},
+ \autopageref{desc:maincls.cmd.dedication})}%
+ \feentry{descriptionlabel}{labels, i.\,e., the optional argument of
+ \Macro{item} in the \Environment{description} environment (see
+ \autoref{sec:maincls.lists}, \autopageref{desc:maincls.env.description})}%
+ \feentry{dictum}{dictum, wise saying, or smart slogan (see
+ \autoref{sec:maincls.dictum}, \autopageref{desc:maincls.cmd.dictum})}%
+ \feentry{dictumauthor}{author of a dictum, wise saying, or smart slogan;
+ used according to the element \FontElement{dictumtext} (see
+ \autoref{sec:maincls.dictum}, \autopageref{desc:maincls.cmd.dictum})}%
+ \feentry{dictumtext}{another name for \FontElement{dictum}}%
+ \feentry{disposition}{all sectional unit titles, i.\,e., the arguments of
+ \Macro{part} down to \Macro{subparagraph} and \Macro{minisec}, including
+ the title of the abstract; used before the element of the corresponding
+ unit (see \autoref{sec:maincls.structure} ab
+ \autopageref{sec:maincls.structure})}%
+ \feentry{footnote}{footnote text and marker (see
+ \autoref{sec:maincls.footnotes},
+ \autopageref{desc:maincls.cmd.footnote})}%
+ \feentry{footnotelabel}{mark of a footnote; used according to the element
+ \FontElement{footnote} (see \autoref{sec:maincls.footnotes},
+ \autopageref{desc:maincls.cmd.footnote})}%
+ \feentry{footnotereference}{footnote reference in the text (see
+ \autoref{sec:maincls.footnotes},
+ \autopageref{desc:maincls.cmd.footnote})}%
+ \feentry{footnoterule}{%
+ horizontal rule\ChangedAt{v3.07}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} above the footnotes at the end of the text area (see
+ \autoref{sec:maincls.footnotes},
+ \autopageref{desc:maincls.cmd.setfootnoterule})}%
+ \feentry{labelinglabel}{labels, i.\,e., the optional argument of
+ \Macro{item} in the \Environment{labeling} environment (see
+ \autoref{sec:maincls.lists}, \autopageref{desc:maincls.env.labeling})}%
+ \feentry{labelingseparator}{separator, i.\,e., the optional argument of the
+ \Environment{labeling} environment; used according to the element
+ \FontElement{labelinglabel} (see \autoref{sec:maincls.lists},
+ \autopageref{desc:maincls.env.labeling})}%
+ \feentry{minisec}{title of \Macro{minisec} (see
+ \autoref{sec:maincls.structure} ab
+ \autopageref{desc:maincls.cmd.minisec})}%
+ \feentry{pagefoot}{only used if package \Package{scrpage2} has been loaded
+ (see \autoref{cha:scrpage},
+ \autopageref{desc:scrpage.fontelement.pagefoot})}%
+ \feentry{pagehead}{another name for \FontElement{pageheadfoot}}%
+ \feentry{pageheadfoot}{the head of a page, but also the foot of a page (see
+ \autoref{sec:maincls.pagestyle} ab \autopageref{sec:maincls.pagestyle})}%
+ \feentry{pagenumber}{page number in the header or footer (see
+ \autoref{sec:maincls.pagestyle})}%
+ \feentry{pagination}{another name for \FontElement{pagenumber}}%
+ \feentry{paragraph}{title of the sectional unit \Macro{paragraph} (see
+ \autoref{sec:maincls.structure},
+ \autopageref{desc:maincls.cmd.paragraph})}%
+ \feentry{part}{title of the \Macro{part} sectional unit, without the line
+ containing the part number (see \autoref{sec:maincls.structure},
+ \autopageref{desc:maincls.cmd.part})}%
+ \feentry{partentry}{%
+ table of contents entry of the sectional unit \Macro{part} (see
+ \autoref{sec:maincls.toc},
+ \autopageref{desc:maincls.cmd.tableofcontents})}%
+ \feentry{partentrypagenumber}{%
+ Page number of the table of contents entry of the sectional unit
+ \Macro{part} variation on the element \FontElement{partentry} (see
+ \autoref{sec:maincls.toc},
+ \autopageref{desc:maincls.cmd.tableofcontents})}%
+ \feentry{partnumber}{line containing the part number in a title of the
+ sectional unit \Macro{part} (see \autoref{sec:maincls.structure},
+ \autopageref{desc:maincls.cmd.part})}%
+ \feentry{publishers}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}}%
+ publishers of the document on the main title, i.\,e., the argument of
+ \Macro{publishers} when \Macro{maketitle} will be used (see
+ \autoref{sec:maincls.titlepage},
+ \autopageref{desc:maincls.cmd.publishers})}%
+ \feentry{section}{title of the sectional unit \Macro{section} (see
+ \autoref{sec:maincls.structure}, \autopageref{desc:maincls.cmd.section})}%
+ \feentry{sectionentry}{%
+ table of contents entry of sectional unit \Macro{section} (only available
+ in \Class{scrartcl}, see \autoref{sec:maincls.toc},
+ \autopageref{desc:maincls.cmd.tableofcontents})}%
+ \feentry{sectionentrypagenumber}{%
+ page number of the table of contents entry of the sectional unit
+ \Macro{section}, variation on element \FontElement{sectionentry} (only
+ available in \Class{scrartcl, see \autoref{sec:maincls.toc},
+ \autopageref{desc:maincls.cmd.tableofcontents}})}%
+ \feentry{sectioning}{another name for \FontElement{disposition}}%
+ \feentry{subject}{%
+ categorization of the document, i.\,e., the argument of \Macro{subject} on
+ the main title page (see \autoref{sec:maincls.titlepage},
+ \autopageref{desc:maincls.cmd.subject})}%
+ \feentry{subparagraph}{title of the sectional unit \Macro{subparagraph} (see
+ \autoref{sec:maincls.structure},
+ \autopageref{desc:maincls.cmd.subparagraph})}%
+ \feentry{subsection}{title of the sectional unit \Macro{subsection} (see
+ \autoref{sec:maincls.structure},
+ \autopageref{desc:maincls.cmd.subsection})}%
+ \feentry{subsubsection}{title of the sectional unit \Macro{subsubsection}
+ (see \autoref{sec:maincls.structure},
+ \autopageref{desc:maincls.cmd.subsubsection})}%
+ \feentry{subtitle}{%
+ subtitle of the document, i.\,e., the argument of \Macro{subtitle} on the
+ main title page (see \autoref{sec:maincls.titlepage},
+ \autopageref{desc:maincls.cmd.title})}%
+ \feentry{title}{main title of the document, i.\,e., the argument of
+ \Macro{title} (for details about the title size see the additional note in
+ the text of \autoref{sec:maincls.titlepage} from
+ \autopageref{desc:maincls.cmd.title})}%
+ \feentry{titlehead}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}}%
+ head above the main title of the document, i.\,e., the argument of
+ \Macro{titlehead} when \Macro{maketitle} will be used (see
+ \autoref{sec:maincls.titlepage},
+ \autopageref{desc:maincls.cmd.titlehead})}%
+\end{desclist}
+\fi %************************************************** end of maincls only *
+\ifCommonscrextend %++++++++++++++++++++++++++++++++++++++++ scrextend only +
+\begin{Example}
+ Assumed, you want to print the document title in a serif font and with red
+ color. You may do this using:
+\begin{lstcode}
+ \setkomafont{title}{\color{red}}
+\end{lstcode}
+ Package \Package{color} or \Package{xcolor} will be needed for command
+ \lstinline|\color{red}|. The additional usage of \Macro{normalfont} is not
+ needed in this case, because it is already part of the definition of the
+ title itself. This\textnote{Attention!} example also needs option
+ \OptionValue{extendedfeature}{title} (see
+ \autoref{sec:scrextend.optionalFeatures},
+ \autopageref{desc:scrextend.option.extendedfeature}).
+\end{Example}
+\fi %************************************************ end of scrextend only *
+\ifCommonscrlttr %+++++++++++++++++++++++++++++++++++++++++++ scrlttr2 only +
+A general example for the usage of \Macro{setkomafont} and \Macro{usekomafont}
+may be found in \autoref{sec:maincls.textmarkup} at
+\autopageref{desc:maincls.setkomafont.example}.
+%
+\fi %************************************************* End of scrlttr2 only *
+\fi %*************************************** End long version (not maincls) *
+\ifCommonscrlttr % ++++++++++++++++++++++++++++++++++++++++++ scrlttr2 only +
+\begin{desclist}
+ \desccaption{%
+ Alphabetical list of elements whose font can be changed in
+ \Class{scrlttr2} using the commands \Macro{setkomafont} and
+ \Macro{addtokomafont}\label{tab:scrlttr2.elementsWithoutText}%
+ }{%
+ Elements whose font can be changed (\emph{continuation})%
+ }%
+ \feentry{addressee}{name und address in address field %
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.option.addrfield})}%
+ \feentry{backaddress}{%
+ return address for a window envelope %
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.option.backaddress})}%
+ \feentry{descriptionlabel}{%
+ label, i.\,e., the optional argument of \Macro{item}, in a
+ \Environment{description} environment %
+ (\autoref{sec:scrlttr2.lists},
+ \autopageref{desc:scrlttr2.env.description})}%
+ \feentry{foldmark}{%
+ foldmark on the letter page; intended for color settings %
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.option.foldmarks})}%
+ \feentry{footnote}{%
+ footnote text and marker %
+ (see \autoref{sec:scrlttr2.footnotes},
+ \autopageref{desc:scrlttr2.cmd.footnote})}%
+ \feentry{footnotelabel}{%
+ mark of a footnote; used according to the element \FontElement{footnote} %
+ (see \autoref{sec:scrlttr2.footnotes},
+ \autopageref{desc:scrlttr2.cmd.footnote})}%
+ \feentry{footnotereference}{%
+ footnote reference in the text %
+ (see \autoref{sec:scrlttr2.footnotes},
+ \autopageref{desc:scrlttr2.cmd.footnote})}%
+ \feentry{footnoterule}{%
+ horizontal rule\ChangedAt{v3.07}{\Class{scrlttr2}} above the footnotes at
+ the end of the text area %
+ (see \autoref{sec:maincls.footnotes},
+ \autopageref{desc:maincls.cmd.setfootnoterule})}%
+ \feentry{labelinglabel}{%
+ labels, i.\,e., the optional argument of \Macro{item} in the
+ \Environment{labeling} environment %
+ (see \autoref{sec:scrlttr2.lists},
+ \autopageref{desc:scrlttr2.env.labeling})}%
+ \feentry{labelingseparator}{%
+ separator, i.\,e., the optional argument of the \Environment{labeling}
+ environment; used according to the element \FontElement{labelinglabel} %
+ (see \autoref{sec:scrlttr2.lists},
+ \autopageref{desc:scrlttr2.env.labeling})}%
+ \feentry{pagefoot}{%
+ used after element \FontElement{pageheadfoot} for the page foot, that has
+ been defined with variable \Variable{nextfoot}\IndexVariable{nextfoot}, or
+ for the page foot of package \Package{scrpage2} %
+ (\autoref{cha:scrpage}, \autopageref{desc:scrpage.fontelement.pagefoot})}%
+ \feentry{pagehead}{%
+ another name for \FontElement{pageheadfoot}}%
+ \feentry{pageheadfoot}{%
+ the head of a page, but also the foot of a page at all page style, that
+ has been defined using \KOMAScript{} %
+ (see \autoref{sec:scrlttr2.pagestyle},
+ \autopageref{desc:scrlttr2.fontelement.pageheadfoot})}%
+ \feentry{pagenumber}{%
+ page number in the header or footer %
+ (see \autoref{sec:scrlttr2.pagestyle},
+ \autopageref{desc:scrlttr2.fontelement.pagenumber})}%
+ \feentry{pagination}{%
+ another name for \FontElement{pagenumber}}%
+ \feentry{placeanddate}{%
+ \ChangedAt{v3.12}{\Class{scrlttr2}}%
+ place and date, if a date line will be used instead of a normal reference
+ line (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.placeseparator})}%
+ \feentry{refname}{%
+ description or title of the fields in the reference line %
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.yourref})}%
+ \feentry{refvalue}{%
+ content of the fields in the reference line %
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.yourref})}%
+ \feentry{specialmail}{%
+ mode of dispatch in the address field %
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.specialmail})}%
+ \feentry{subject}{%
+ subject in the opening of the letter %
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.subject})}%
+ \feentry{title}{%
+ title in the opening of the letter %
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.title})}%
+ \feentry{toaddress}{%
+ variation of the element \FontElement{addressee} for setting the addressee
+ address (less the name) in the address field %
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.toaddress})}%
+ \feentry{toname}{%
+ variation of the element \FontElement{addressee} for the name (only) of
+ the addressee in the address field %
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.toname})}%
+\end{desclist}
+\fi %************************************************* End of scrlttr2 only *
+\ifIgnoreThis %++++++++++++++++++++++++++++++++++++ short version (maincls) +
+\else %----------------------------------------- long version (not maincls) -
+%
+\EndIndex{Cmd}{setkomafont}%
+\EndIndex{Cmd}{addtokomafont}%
+\EndIndex{Cmd}{usekomafont}%
+
+\begin{Declaration}
+ \Macro{usefontofkomafont}\Parameter{element}\\
+ \Macro{useencodingofkomafont}\Parameter{element}\\
+ \Macro{usesizeofkomafont}\Parameter{element}\\
+ \Macro{usefamilyofkomafont}\Parameter{element}\\
+ \Macro{useseriesofkomafont}\Parameter{element}\\
+ \Macro{useshapeofkomafont}\Parameter{element}
+\end{Declaration}
+\BeginIndex{Cmd}{usefontofkomafont}%
+\BeginIndex{Cmd}{useencodingofkomafont}%
+\BeginIndex{Cmd}{usesizeofkomafont}%
+\BeginIndex{Cmd}{usefamilyofkomafont}%
+\BeginIndex{Cmd}{useseriesofkomafont}%
+\BeginIndex{Cmd}{useshapeofkomafont}%
+Sometimes\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}} and despite the recommendation
+users use the font setting feature of elements not only for font settings but
+for other settings too. In this case it may be useful to switch only to the
+font setting of an element but not to those other settings. You may use
+\Macro{usefontofkomafont} in such cases. This will activate the font size and
+baseline skip, the font encoding, the font family, the font series, and the
+font shape of an element, but no further settings as long as those further
+settings are local.
+
+You may also switch to one of those attributes only using one of the other
+commands. Note, that \Macro{usesizeofkomafont} will activate both, the font
+size and the baseline skip.%
+\EndIndex{Cmd}{useshapeofkomafont}%
+\EndIndex{Cmd}{useseriesofkomafont}%
+\EndIndex{Cmd}{usefamilyofkomafont}%
+\EndIndex{Cmd}{usesizeofkomafont}%
+\EndIndex{Cmd}{useencodingofkomafont}%
+\EndIndex{Cmd}{usefontofkomafont}%
+%
+\EndIndex{}{font}%
+\EndIndex{}{text>markup}
+\fi %*************************************** End long version (not maincls) *
+
%%% Local Variables:
%%% mode: latex
%%% coding: us-ascii
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-6.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-6.tex
index 06051e8a95a..9636b3eb4c1 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-6.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-6.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-6.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-6.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-6.tex}[2012/05/15 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-6.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (common paragraph: Paragraph Markup)]
\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi}
% Date of the translated German file: 2012/01/01
@@ -91,8 +93,8 @@
\IfCommon{scrlttr2}{%
In the preliminaries of \autoref{sec:maincls.parmarkup},
\autopageref{sec:maincls.parmarkup} it was argued why paragraph indent is
- preferred over paragraph spacing. But the elements the argumentation depends on,
- i.\,e., figures, tables, lists, equations, and even new pages,
+ preferred over paragraph spacing. But the elements the argumentation depends
+ on, i.\,e., figures, tables, lists, equations, and even new pages,
are rare. Often letters are not so long that an oversighted paragraph will
have serious consequences to the readability of the document. Because of
this, the arguments are less serious for standard letters. This may be one
@@ -100,7 +102,7 @@
indentation of the first line, but with a vertical skip between
them. But there may be still some advantages of the paragraph indent. One
may be that such a letter is highlighted in the mass of letters. Another may
- be that the \emph{corporate identity} needn't be broken for letters only.}%
+ be that the \emph{corporate identity} need not be broken for letters only.}%
\ifIgnoreThis %+++++++++++++++++++++++++++++++++++++++++++++ nicht maincls +
\IfCommon{scrlttr2}{Apart from these suggestions, everything that has been
written at \autoref{sec:maincls.parmarkup} for the other \KOMAScript{}
@@ -126,11 +128,12 @@
The \PName{manner} consists of two elements. The first element is either
\PValue{full} or \PValue{half}, meaning the space amount of one line or only
half of a line. The second element is ``\PValue{*}'', ``\PValue{+}'', or
-``\PValue{-}'', and may be omitted. Without the second element the last line of
-a paragraph will end with white space of at least 1\Unit{em}. With the plus
+``\PValue{-}'', and may be omitted. Without the second element the last line
+of a paragraph will end with white space of at least 1\Unit{em}. With the plus
character as second element the white space amount will be a third, and with
-the asterisk a fourth, of the width of a normal line. The minus variant doesn't
-take care about the white space at the end of the last line of a paragraph.
+the asterisk a fourth, of the width of a normal line. The minus variant does
+not take care about the white space at the end of the last line of a
+paragraph.
The setting may be changed at any place inside the document. In this case the
command \Macro{selectfont}\IndexCmd{selectfont}%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-7.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-7.tex
index aeef2455ac2..3648bf1abb6 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-7.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-7.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-7.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-7.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,10 @@
%
% ======================================================================
-\ProvidesFile{common-7.tex}[2012/05/15 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-7.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (common paragraph: Detection of Odd and
+ Even Pages)]
\translator{Markus Kohm\and Krickette Murabayashi}
% Date of translated German file: 2011/08/26
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-8.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-8.tex
index 784129a0fa8..29eb6a19a78 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-8.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-8.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-8.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-8.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,10 +45,12 @@
%
% ======================================================================
-\ProvidesFile{common-8.tex}[2012/05/15 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-8.tex}%
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (common paragraphs: Interleaf Pages)]
\translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi}
-% Date of the translated German file: 2011/09/21
+% Date of the translated German file: 2013/11/07
\makeatletter
\@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}%
@@ -78,7 +80,7 @@
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 aren't interleaf pages, really,
+ sides of the one-sided printings are not interleaf pages, really,
although % . Nevertheless at the printing paper
they may seem to be such pages.}
\fi %**************************************************** Ende nur maincls *
@@ -88,7 +90,7 @@
\IfCommon{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 won't be done often. Nevertheless \Class{scrlttr2} supports
+ 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
@@ -126,7 +128,7 @@ compatibility to an earlier version (see option \Option{version},
means you want to use page style \Pagestyle{plain}. You may use following to
achieve this:
\begin{lstcode}
- \KOMAoption{cleardoublepage=plain}
+ \KOMAoptions{cleardoublepage=plain}
\end{lstcode}
More information about page style \Pagestyle{plain} may be found at
\autoref{sec:maincls.pagestyle}, \autopageref{desc:maincls.pagestyle.plain}.
@@ -139,7 +141,7 @@ compatibility to an earlier version (see option \Option{version},
means you want to use page style \Pagestyle{plain}. You may use following to
achieve this:
\begin{lstcode}
- \KOMAoption{cleardoublepage=plain}
+ \KOMAoptions{cleardoublepage=plain}
\end{lstcode}
More information about page style \Pagestyle{plain} may be found at
\autoref{sec:maincls.pagestyle}, \autopageref{desc:maincls.pagestyle.plain}.
@@ -288,6 +290,8 @@ the standard command \Macro{cleardoublepage}, that may be either
%%% Local Variables:
%%% mode: latex
+%%% mode: flyspell
%%% coding: us-ascii
+%%% ispell-local-dictionary: "en_GB"
%%% TeX-master: "../guide"
%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-9.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-9.tex
index 150e563f87d..408de83c117 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-9.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-9.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-9.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-9.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-9.tex}[2012/05/15 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-9.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (common paragraphs: Footnotes)]
\translator{Markus Kohm\and Krickette Murabayashi}
% Date of the translated German file: 2012/01/01
@@ -83,7 +85,7 @@
Package \Package{scrextend} supports all the footnote features of
\KOMAScript
\ifIgnoreThis %+++++++++++++++++++++++++++++++++++++++++++++ nicht maincls +
- , that are described at \autoref{sec:maincls.footnotes}%
+ \ that are described in \autoref{sec:maincls.footnotes}%
\fi %**************************************************** Ende nur maincls *
. Nevertheless, by default the footnotes are under full control of the used
class. This changes as soon as command \Macro{deffootnote} (see
@@ -168,7 +170,7 @@ automatically. See\important{\Option{footnote}} the previously documented
option \Option{footnotes} for this.
If you want to set the separator manually, you may use
-\Macro{multiplefootnoteseparator}. Note that this command shouldn't be
+\Macro{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 \Macro{multfootsep}. The
@@ -200,7 +202,7 @@ and may be changed by redefining the command.
\footnote{2nd footnote}
\end{lstcode}
This should give you the wanted result even if the automatic solution would
- fail or couldn't be used.
+ 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
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/expertpart.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/expertpart.tex
index 4556bf6a940..b8ba50618ee 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/expertpart.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/expertpart.tex
@@ -1,6 +1,6 @@
% ======================================================================
% expertpart.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% expertpart.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{expertpart.tex}[2012/01/13 Part KOMA-Script for Experts]
+\KOMAProvidesFile{expertpart.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ Part KOMA-Script for Experts]
\translator{Markus Kohm}
\setpartpreamble{%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/guide-english.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/guide-english.tex
index 9137bd523ab..947254a3ce5 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/guide-english.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/guide-english.tex
@@ -1,6 +1,6 @@
% ======================================================================
% guide-english.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% guide-english.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,7 @@
%
% ======================================================================
%
-\ProvidesFile{guide-english.tex}[{2012/03/14
+\ProvidesFile{guide-english.tex}[{2013/08/05
KOMA-Script guide language dependencies}]
%
% \section{Extra Packages}
@@ -71,9 +71,9 @@
% Ugly note
\vfill
\noindent Note: This document is a translation of the German \KOMAScript{}
- manual. Several authors has been involved to this translation. Some of them
- are native English speakers, others like me are not. Improvement of the
- translation by native speakers or experts would be welcome always!%
+ manual. Several authors have been involved to this translation. Some of them
+ are native English speakers, others like me are not. Improvements of the
+ translation by native speakers or experts are welcome at all times!%
}%
\newcommand*{\GuideAuthorHeadline}{Authors of the {\KOMAScript} Bundle}%
\newcommand*{\GuideTranslatorHeadline}{English translation of this manual by:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/guide.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/guide.tex
index 6fc6a8c55dd..41ba9402133 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/guide.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/guide.tex
@@ -45,7 +45,7 @@
%
% ======================================================================
-\ProvidesFile{guide.tex}[2012/02/22 KOMA-Script guide main file]
+\ProvidesFile{guide.tex}[2013/10/14 KOMA-Script guide main file]
\documentclass[\languagename]{scrguide}
@@ -95,6 +95,7 @@
\include{scrbookreportarticle}
\include{scrlttr2}
\include{scrpage2}
+\include{scrlayer-scrpage}
\include{scrdatetime}
\include{scraddr}
\include{adrconvnote}
@@ -106,6 +107,9 @@
\include{scrwfile}
\include{tocbasic}
\include{scrhack}
+\include{scrlayer}
+\include{scrlayer-scrpage-experts}
+\include{scrlayer-notecolumn}
\include{typearea-experts}
\include{scrbookreportarticle-experts}
\include{scrlttr2-experts}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/htmlsetup b/Master/texmf-dist/source/latex/koma-script/doc/english/htmlsetup
index fd90a64e075..8c30c6ed561 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/htmlsetup
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/htmlsetup
@@ -1,6 +1,6 @@
# ======================================================================
# htmlsetup
-# Copyright (c) Markus Kohm, 2002-2009
+# Copyright (c) Markus Kohm, 2002-2013
#
# This file is part of the LaTeX2e KOMA-Script bundle.
#
@@ -18,7 +18,7 @@
# This work consists of all files listed in manifest.txt.
# ----------------------------------------------------------------------
# htmlsetup
-# Copyright (c) Markus Kohm, 2002-2009
+# Copyright (c) Markus Kohm, 2002-2013
#
# Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
# Version 1.3c, verteilt und/oder veraendert werden.
@@ -54,6 +54,7 @@ alt=\"Valid HTML 4.0 Strict\" height=\"31\" width=\"88\"></a>
%titles=( "option" => "Options",
"macro" => "Commands",
"environment" => "Environments",
+ "length" => "Lengths",
"plength" => "Pseudolengths",
"variable" => "Variables",
"pagestyle" => "Page Styles",
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/introduction.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/introduction.tex
index fe43c56e545..28569628ad8 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/introduction.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/introduction.tex
@@ -1,6 +1,6 @@
% ======================================================================
% introduction.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% introduction.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{introduction.tex}[2012/03/14 KOMA-Script guide introduction]
+\KOMAProvidesFile{introduction.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide introduction]
\translator{Kevin Pfeiffer\and Gernot Hassenpflug\and
Krickette Murabayashi\and Markus Kohm}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/japanlco.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/japanlco.tex
index 1ceb9bbe6cc..54a6d3f0782 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/japanlco.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/japanlco.tex
@@ -1,6 +1,6 @@
% ======================================================================
% japanlco.tex
-% Copyright (c) Gernot Hassenpflug and Markus Kohm, 2001-2012
+% Copyright (c) Gernot Hassenpflug and Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% japanlco.tex
-% Copyright (c) Gernot Hassenpflug und Markus Kohm, 2001-2012
+% Copyright (c) Gernot Hassenpflug und Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -49,7 +49,9 @@
% KOMA-Script bundle.
%
-\ProvidesFile{japanlco.tex}[2007/12/17 KOMA-Script guide (appendix: japanlco)]
+\KOMAProvidesFile{japanlco.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (appendix: japanlco)]
\appendix
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/preface.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/preface.tex
index 17ed62fca68..f98815f546b 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/preface.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/preface.tex
@@ -1,6 +1,6 @@
% ======================================================================
% preface.tex
-% Copyright (c) Markus Kohm, 2008-2012
+% Copyright (c) Markus Kohm, 2008-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% preface.tex
-% Copyright (c) Markus Kohm, 2008-2012
+% Copyright (c) Markus Kohm, 2008-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -35,7 +35,9 @@
% Dieses Werk besteht aus den in manifest.txt aufgefuehrten Dateien.
% ======================================================================
-\ProvidesFile{preface.tex}[2012/05/15 Preface to the KOMA-Script book]
+\KOMAProvidesFile{preface.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ Preface to the KOMA-Script book]
%\translator{Markus Kohm}
% Date of the translated German file: 0000/00/00
@@ -46,15 +48,24 @@ This is not a translation of the preface of the German \KOMAScript{} guide,
because this translation of the German \KOMAScript{} guide is still a work in
progress. Currently the chapters of \autoref{part:forAuthors} and
\autoref{cha:scrbase}, \autoref{cha:scrlfile}, \autoref{cha:scrhack},
+\autoref{cha:scrlayer}, \autoref{cha:scrlayer-scrpage-experts},
\autoref{cha:typearea-experts}, \autoref{cha:maincls-experts},
-\autoref{cha:scrlttr2-experts} are up-to-date. There may still be dead-links
-and broken references at these chapters, because the referenced information in
-chapters of other parts could be missing.
+\autoref{cha:scrlttr2-experts} are up-to-date.
-The descriptions in \autoref{cha:scrwfile}, \autoref{cha:tocbasic} aren't
-translations from the German manual but are primary descriptions from the
-implementation of these packages. They should be up-to-date\,---\,sometimes
-even more than the chapters from the German manual.
+Nevertheless, for \autoref{cha:scrlayer}, \autoref{cha:scrlayer-scrpage},
+\autoref{cha:scrlayer-scrpage-experts} a native speaker or someone with
+advanced knowledge of the English language would be needed to improve it.
+% AFAIK currently there are not any dead links or broken references, otherwise
+% I would use the following:
+% There may still be dead links and broken references in these chapters,
+% because the referenced information in chapters of other parts could be
+% missing.
+
+The descriptions in \autoref{cha:scrwfile}, \autoref{cha:tocbasic},
+\autoref{cha:scrlayer-notecolumn} are not translations from the German manual
+but are primary descriptions from the implementation of these packages. They
+should be up-to-date\,---\,sometimes even more than the chapters from the
+German manual.
So this English guide is complete but nevertheless not as good as the German
one, because my English is not as good as my German. Currently there's only
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scraddr.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scraddr.tex
index beec72d274b..3c383597324 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scraddr.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scraddr.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scraddr.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scraddr.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{scraddr.tex}[2012/02/23 KOMA-Script guide (chapter: scraddr)]
+\KOMAProvidesFile{scraddr.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (chapter: scraddr)]
\translator{Jens-Uwe Morawski\and Gernot Hassenpflug\and Markus Kohm}
% Date of translated german file: 2011/09/30
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbase.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbase.tex
index ce472d81292..376319b4d06 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbase.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbase.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrbase.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrbase.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,21 +45,23 @@
%
% ======================================================================
-\ProvidesFile{scrbase.tex}[2012/03/04 KOMA-Script package scrbase]
-\translator{Markus Kohm}
+\KOMAProvidesFile{scrbase.tex}
+ [$Date: 2013-12-13 16:32:18 +0100 (Fr, 13 Dez 2013) $
+ KOMA-Script package scrbase]
+\translator{Markus Kohm\and Melvin Hendrix}
-% Date of the translated German file: 2012/03/04
+% Date of the translated German file: 2013/11/06
-\chapter{Basic Functions at Package \Package{scrbase}}
+\chapter{Basic Functions of Package \Package{scrbase}}
\labelbase{scrbase}
\BeginIndex{Package}{scrbase}%
-The package \Package{scrbase} provides basic features, that are designed and
-implemented to be used by authors of packages and classes. Thereby it may not
-only used for wrapper classes, that use a \KOMAScript{} class. Authors of
-classes, that aren't related to anything else from \KOMAScript{}, may also
-benefit from the functionality of \Package{scrbase}.
+The package \Package{scrbase} provides basic features designed and implemented
+for use by authors of packages and classes. However, \Package{scrbase} cannot
+only by used for wrapper classes related to \KOMAScript{} class. Authors of
+classes that have nothing to do with \KOMAScript{} can benefit from
+\Package{scrbase} functionality.
\section{Loading the Package}
\label{sec:scrbase.loadit}
@@ -68,10 +70,10 @@ Whereas users load packages using \Macro{usepackage}, authors of packages or
classes should use \Macro{RequirePackage}\IndexCmd{RequirePackage}. Authors of
wrapper packages may also use \Macro{RequirePackageWithOptions}. Command
\Macro{RequirePackage} has the same optional argument for package options like
-\Macro{usepackage}. In opposite to this \Macro{RequirePackageWithOptions}
-doesn't have an optional argument but passes all options given while loading
-the wrapper package to the required package. See \cite{latex:clsguide} for
-more information about these commands.
+\Macro{usepackage}. In contrast, \Macro{RequirePackageWithOptions} does not
+have an optional argument but passes all options given when loading the
+wrapper package to the required package. See \cite{latex:clsguide} for more
+information about these commands.
The package \Package{scrbase} needs the functionality of package
\Package{keyval}\IndexPackage{keyval} internally. This may be provided by
@@ -79,7 +81,7 @@ package \Package{xkeyval} alternatively. Package \Package{scrbase} loads
\Package{keyval} as needed.
The package \Package{keyval} provides definition of keys and assignment of
-values to this keys. The options provided by \Package{scrbase} also use
+values to these keys. The options provided by \Package{scrbase} also use
\Package{keyval} syntax: \PName{key}\texttt{=}\PName{value}.
\begin{Declaration}
@@ -87,35 +89,37 @@ values to this keys. The options provided by \Package{scrbase} also use
\end{Declaration}
\BeginIndex{Option}{internalonly~=\PName{value}}%
Package \Package{scrbase} provides some commands for conditional
-execution. The primary names of those are build like
-\Macro{scr@\PName{name}}. With this those are internal commands. \KOMAScript{}
-really uses this internal commands internally. Authors of packages and classes
-may use those internal commands too, but should not redefine them. Because
-some of those commands may be useful for users too, they are also provided as
-\Macro{\PName{name}} normally. But eventually other packages provide commands
-with the same name but different syntax or different functionality. This would
-result in an conflict. So \Package{scrbase} provides to suppress the
-definition of the user commands, \Macro{\PName{name}}, only. Using option
-\Option{internalonly} without \PName{value} will define only the internal
-commands and suppress definition of all the user commands for conditional
-execution. Alternatively, the user may give all the commands, that shouldn't
-be defined as \PName{value}, but replaces ``\Macro{}'' by ``\texttt{/}''.
+execution. The primary names for these are builds like
+\Macro{scr@\PName{name}}, which are internal commands. \KOMAScript{} only uses
+these internal commands internally. Authors of packages and classes may use
+these internal commands, too, but should not redefine them. Because some of
+these commands are useful for users, too, they are provided as
+\Macro{\PName{name}} normally. But eventually, other packages may provide
+commands with the same name but different syntax or different
+functionality. As this would result in an conflict, \Package{scrbase} can
+suppress the definition of the user commands \Macro{\PName{name}}. Using
+option \Option{internalonly} without \PName{value} will define only the
+internal commands and suppress definition of all the user commands for
+conditional execution. Alternatively, the user may give all the commands that
+should not be defined as \PName{value}, but replaces ``\Macro{}'' by
+``\texttt{/}''.
Authors of packages and classes normally should not use this option. Users may
use it with or without \PName{value} either as a global option with
\Macro{documentclass} or using \Macro{PassOptionsToPackage}.
\begin{Example}
- The user doesn't want \Package{scrbase} to define commands \Macro{ifVTeX}
- and \Macro{ifundefinedorrelax}. Because of this, user uses:
+ The user does not want \Package{scrbase} to define commands \Macro{ifVTeX}
+ and \Macro{ifundefinedorrelax}. Because of this, to load the class, the user
+ writes:
\begin{lstcode}
\documentclass%
[internalonly=/ifVTeX/ifundefinedorrelax]%
{foo}
\end{lstcode}
- to load the class. Class name \Class{foo} has been used as an placeholder
+ Class name \Class{foo} is, therefore, an placeholder
for any class in this example. The meanings of commands \Macro{ifVTeX} and
\Macro{ifundefinedorrelax} and many more commands for conditional execution
- may be found in \autoref{sec:scrbase.if}.
+ is located in \autoref{sec:scrbase.if}.
\end{Example}
%
\EndIndex{Option}{internalonly~=\PName{value}}%
@@ -127,54 +131,55 @@ use it with or without \PName{value} either as a global option with
As already mentioned in \autoref{sec:scrbase.loadit}, \Package{scrbase} uses
package \Package{keyval} for keys and values of keys. Nevertheless
\Package{scrbase} extends the functionality of \Package{keyval}. Whereas only
-one family owns all keys of \Package{keyval}, \Package{scrbase} knows also
-family members. Now, a key may be owned by a family or by one or more family
-members. Additionally a value may be assigned to the key of a family member,
-of a family or of all family members.
+one family owns all keys of \Package{keyval}, \Package{scrbase} recognises
+also family members. Therefore, a key may be owned by a family or by one or
+more family members. Additionally, a value may be assigned to the key of a
+family member, to the key of a family, or to the keys of all family members.
\begin{Declaration}
\Macro{DefineFamily}\Parameter{family}\\
- \Macro{DefineFamilyMember}\OParameter{family member}\Parameter{family}
+ \Macro{DefineFamilyMember}\OParameter{family member}\Parameter{family}%
\end{Declaration}
\BeginIndex{Cmd}{DefineFamily}%
\BeginIndex{Cmd}{DefineFamilyMember}%
\Package{scrbase} needs to know the members of a family for different
-reasons. So it's necessary first to define a new family using
-\Macro{DefineFamily}, that produces also an empty member list. If the family
-has already been defined nothing would happen. Nothing means also, that an
+reasons. First, you have to define a new family using
+\Macro{DefineFamily}, which produces an empty member list. If the family
+has already been defined nothing would happen. Nothing also means that an
already existing member list would not be overwritten.
-A new member may be added to the family using \Macro{DefineFamilyMember}. If
-the family doesn't exist, this would result in an error message. If the member
-already exists, nothing happens. If the member is omitted, the member won't
-stay empty, but ``\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}'' will
-be assumed. While loading a class or package \Macro{@currname} and
-\Macro{@currext} together represent the file name of the class or package.
-
-Theoretically is would be possible, to define a member without a name using an
-empty optional argument \PName{family member}. But this would be same like the
-family itself. It is recommended to use only letters and digits at the
-\PName{family} an start the \PName{family member} with another char like a
-period. Otherwise it could happen, that members of one family are same like
-members of another family.
-
-\Package{scrbase} itself defines family ``\PValue{KOMA}'' and adds member
-``\PValue{.scrbase.sty}'' to is. Generally family ``\PValue{KOMA}'' is
-reserved to \KOMAScript{}. For your own packages it is recommended to use the
-name of the bundle as \PName{family} and the name of the package as
-\PName{family member} of that \PName{family}.
+Next, a new member can be added to the family using
+\Macro{DefineFamilyMember}. If the family does not exist, this would result in
+an error message. If the member already exists, nothing happens. If the
+optional \PName{family member} is omitted, the default value
+``\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}'' is used. During
+class or package loading \Macro{@currname} and \Macro{@currext} together
+represent the file name of the class or package.
+
+Theoretically, it is possible, to define a member without a name using an
+empty optional \PName{family member} argument. But this is the same as the
+family itself. It is recommended that only letters and digits be used for
+\PName{family} and the first character of \PName{family member} should not be
+a letter or digit. Otherwise, it could happen that members of one family are
+the same as members of another family.
+
+\Package{scrbase} assigns family ``\PValue{KOMA}'' to itself and adds member
+``\PValue{.scrbase.sty}'' to it. Family ``\PValue{KOMA}'' is reserved to
+\KOMAScript{}. For your own packages, use the name of the bundle as
+\PName{family} and the name of the package as \PName{family member} of that
+\PName{family}.
%
\begin{Example}
- Assumed you're writing a bundle ``master butcher''. Within that bundle you
- have packages \File{salami.sty}, \File{liversausage.sty}, and
- \File{kielbasa.sty}. Therefor you decide to use family name
- ``\PValue{butcher}'' and add the lines
+ Assume you are writing a bundle called ``master butcher''. Within that
+ bundle you have packages \File{salami.sty}, \File{liversausage.sty}, and
+ \File{kielbasa.sty}. Therefore, you decide to use family name
+ ``\PValue{butcher}'' and,to each of the package file, you add the lines
\begin{lstcode}
\DefineFamily{butcher}
\DefineFamilyMember{butcher}
\end{lstcode}
- to each of the package files. While loading the three packages this will
- all the members ``\PValue{.salami.sty}'', ``\PValue{.liversausage.sty}'',
+ When loading the three packages, this will
+ add the members ``\PValue{.salami.sty}'', ``\PValue{.liversausage.sty}'',
and ``\PValue{.kielbasa.sty}'' to the family ``\PValue{butcher}''. After
loading all three packages, all three member will be defined.
\end{Example}
@@ -186,18 +191,29 @@ name of the bundle as \PName{family} and the name of the package as
\begin{Declaration}
\Macro{DefineFamilyKey}\OParameter{family member}\Parameter{family}%
\Parameter{key}\OParameter{default}\\
- \hphantom{\Macro{DefineFamilyKey}}\Parameter{action}
+ \hphantom{\Macro{DefineFamilyKey}}\Parameter{action}\\
+ \Macro{FamilyKeyState}\\
+ \Macro{FamilyKeyStateUnknown}\\
+ \Macro{FamilyKeyStateProcessed}\\
+ \Macro{FamilyKeyStateUnknownValue}\\
+ \Macro{FamilyKeyStateNeedValue}
\end{Declaration}
\BeginIndex{Cmd}{DefineFamilyKey}%
-This command defines a \PName{key}. If a \PName{family member} is given, the
-\PName{key} will become an attribute of that member of the also given
-\PName{family}. If no \PName{family member} is given, the member
-``\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}'' will be assumed. If
-later a value will be assigned to the \PName{key}, the \PName{action} will be
-executed and the value will be an argument of this. So inside of
-\PName{action} ``\lstinline{#1}'' would be that value. If the value will be
-omitted, the \PName{default} will be used instead. If there's no
-\PName{default}, the \PName{key} can be used only with value.
+\BeginIndex{Cmd}{FamilyKeyState}%
+\BeginIndex{Cmd}{FamilyKeyStateUnknown}%
+\BeginIndex{Cmd}{FamilyKeyStateProcessed}%
+\BeginIndex{Cmd}{FamilyKeyStateUnknownValue}%
+\BeginIndex{Cmd}{FamilyKeyStateNeedValue}%
+The command \Macro{DefineFamilyKey} defines a \PName{key}. If a \PName{family
+ member} is given, the \PName{key} becomes an attribute of that member in the
+given \PName{family}. If a \PName{family member} is not given, the member
+``\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}'' is assumed. If,
+later, a value is assigned to the \PName{key}, the \PName{action} will be
+executed and the value made an argument of \PName{action}. So inside
+\PName{action} ``\lstinline{#1}'' would be that value. If the value is
+omitted, the \PName{default} is used instead. If there is no \PName{default},
+the \PName{key} can be used only with a value being defined.
+
\begin{Explain}
\phantomsection\label{explain:scrbase.macro.DefineFamilyKey}%
At least
@@ -208,33 +224,73 @@ omitted, the \PName{default} will be used instead. If there's no
will result in a call of
\begin{lstcode}[moretexcs={define@key},escapeinside=`']
\define@key{`\PName{family\,member}'}{`\PName{key}'}
- [`\PName{default}']{`\PName{action}'}
+ [`\PName{default}']{`\PName{extended action}'}
\end{lstcode}
- with \Macro{define@key} is provided by package
- \Package{keyval}\IndexPackage{keyval} (see \cite{package:keyval}).
+ with \Macro{define@key} provided by package
+ \Package{keyval}\IndexPackage{keyval} (see \cite{package:keyval}). However,
+ the call of \Macro{define@key} and the \PName{action} is, in fact,
+ extended by additional arrangements.
\end{Explain}
+
+Success\ChangedAt{v3.12}{\Package{scrbase}} or failure of the execution of the
+\PName{action} should be reported back to \Package{scrbase} by
+\Macro{FamilyKeyState}. The package itself will take care of additional
+procedures if needed. You should not report errors by yourself! The default
+state before execution of \PName{action} is
+\Macro{FamilyKeyStateUnknown}. This signals that it is not known whether or
+not the execution is successful. If this state does not change until end of
+execution of the \PName{action}, \Package{scrbase} will write a message into
+the \File{log} file and assumes state \Macro{FamilyKeyStateProcessed} during
+the further procedure.
+
+State \Macro{FamilyKeyStateProcessed} signals that the option and the value
+assignment to the option are completely and successfully finished. You may
+switch to this state by using \Macro{FamilyKeyStateProcessed} itself.
+
+State \Macro{FamilyKeyStateUnknownValue} indicates that the option was
+handled, but the value, that should be assigned to the key, was unknown or not
+allowed. You should use \Macro{FamilyKeyStateUnknownValue} to switch to
+this state.
+
+State \Macro{FamilyKeyStateNeedValue} signals that the option could not be
+set because it needs a value, but no value was assigned to the
+key. This state is used automatically, whenever an option has been
+defined without \PName{default} value and is used without value
+assignment. You should not set the state using \Macro{FamilyKeyStateNeedValue}
+yourself.
+
+Last but not least you may switch to additional failure states, simply
+re-defining \Macro{FamilyKeyState} with a very short text message.
+Generally, the four predefined states should be sufficient.
+
\begin{Example}
- Assumed, each of the three packages from the previous example should get a
- key \PValue{coldcuts}. If this is used, a switch should be set at each of
- the packages. For package \Package{salami} this may be, e.\,g.,
+ Assume each of the three packages from the previous example should get a
+ key named \PValue{coldcuts}. When used, a switch is set at each of
+ the packages. For package \Package{salami} this may be:
\begin{lstcode}
\newif\if@Salami@Aufschnitt
\DefineFamilyKey{butcher}%
{coldcut}[true]{%
\expandafter\let\expandafter\if@salami@coldcut
\csname if#1\endcsname
+ \FamilyKeyStateProcessed
}
\end{lstcode}
Available values for the key are \PValue{true} or \PValue{false} in this
- case. There's no test on inappropriate values in this example. If the key
- will be used later, this has to be done with one of the allowed values or
- without assignment. In the second case the default \PName{true} will be
- used.
+ case. Instead of testing on inappropriate values, success will be signalled
+ for any case in this example. If the key is used later, it is executed with
+ one of the allowed values or without assignment. In the second case, the
+ default \PName{true} will be used.
The definitions in the other packages are similar. Only ``\texttt{salami}''
has to be replaced by the corresponding names.
\end{Example}
%
+\EndIndex{Cmd}{FamilyKeyStateNeedValue}%
+\EndIndex{Cmd}{FamilyKeyStateUnknownValue}%
+\EndIndex{Cmd}{FamilyKeyStateProcessed}%
+\EndIndex{Cmd}{FamilyKeyStateUnknown}%
+\EndIndex{Cmd}{FamilyKeyState}%
\EndIndex{Cmd}{DefineFamilyKey}%
@@ -243,38 +299,37 @@ omitted, the \PName{default} will be used instead. If there's no
\end{Declaration}
\BeginIndex{Cmd}{FamilyProcessOptions}%
Generally the extension of keys of families to keys of families and family
-members was mentioned to use keys or key-value settings as class or package
-options. This command therefor is an extension of \Macro{ProcessOption*} from
-\LaTeX{} kernel (see \cite{latex:clsguide}. Thereby the command processes not
-only options that has been declared using \Macro{DeclareOption}. It processes
-even all keys of the given family member. If the optional argument
+members, as mentioned earlier, uses keys or key-value settings as class or
+package options. The command \Macro{FamilyProcessOptions} is an extension of
+\Macro{ProcessOption*} from \LaTeX{} kernel (see \cite{latex:clsguide}, which
+processes not only options that has been declared using \Macro{DeclareOption},
+it processes all keys of the given family member. If the optional argument
\PName{family member} is omitted, family member
-``\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}'' will be used.
+``\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}'' is used.
-Somehow special are keys, that are not attached to a family member, but to a
-family. These are keys with an empty family member. Such keys will be set also
-and before the keys of the family members.
+Somehow special are keys that are not attached to a family member, but to a
+family. These are keys with an empty family member. Such keys are set before
+the keys of the family members.
\begin{Example}
If a package in the previous example would be extended by the line
\begin{lstcode}
\FamilyProcessOptions{butcher}
\end{lstcode}
- then the user may select the option \Option{coldcut} while loading the
- package. If the option will be used globally, this means at the optional
+ then the user may select the option \Option{coldcut} when loading the
+ package. If the option is used globally, this means at the optional
argument of \Macro{documentclass}, then the option would be passed
- automatically to all three packages, if all three packages will be loaded
+ automatically to all three packages, if all three packages are loaded
later.
\end{Example}
-Please note\textnote{Attention!} that packages process global options always
-before local options, that has been assigned locally to the package. In
-opposite to unknown options while processing of global options, that will only
-result in an information in the \File{log}-file, unknown options assigned to
-the package result in error messages.
+Please note\textnote{Attention!} that packages always process global options
+before local options. When processing unknown options initiate an entry in the
+\File{log}-file and the option is otherwise ignored. By contrast, unknown
+options assigned to the package locally leads to an error message.
\Macro{FamilyProcessOptions} may be interpreted either as an extension of
\Macro{ProcessOption*} or as an extension of the \PName{key=value} mechanism
-of \Package{keyval}. Finally \PName{key=value} pairs become options with help
-of \Macro{FamilyProcessOptions}.%
+of \Package{keyval}. Ultimately, with the help of
+\Macro{FamilyProcessOptions}, \PName{key=value} pairs become options.%
%
\EndIndex{Cmd}{FamilyProcessOptions}%
@@ -285,17 +340,17 @@ of \Macro{FamilyProcessOptions}.%
\end{Declaration}
\BeginIndex{Cmd}{FamilyExecuteOptions}%
This command is an extension of \Macro{ExecuteOptions} from the \LaTeX{}
-kernel (see \cite{latex:clsguide}). Thereby the command processes not only
-options, that has been defined using \Macro{DeclareOption}. Also all keys of
-the given family member will be processed. If the optional argument
-\Macro{family member} is omitted, then
+kernel (see \cite{latex:clsguide}). The command processes not only options
+that are defined using \Macro{DeclareOption}, but also processes all keys of
+the given \PName{family member}. If the optional argument \Macro{family
+ member} is omitted, then
``\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}'' is used.
-Somehow special are keys, that are not attached to a family member, but to a
-family. These are keys with an empty family member. Such keys will be set also
-and before the keys of the family members.
+Somehow special are keys of empty family members, which are not attached to a
+family member, but to a family. Such keys are set before the keys of family
+members.
\begin{Example}
- Assumed, option \Option{coldcut} should be set by default already in the
+ Assume option \Option{coldcut} should be set by default in the
previous example. In this case only line
\begin{lstcode}
\FamilyExecuteOptions{butcher}{coldcut}
@@ -307,31 +362,27 @@ and before the keys of the family members.
\begin{Declaration}
- \Macro{FamilyOptions}\Parameter{family}\Parameter{options list}\\
- \Macro{Family@Options}\Parameter{family}\Parameter{options list}%
- \Parameter{error action}
+ \Macro{FamilyOptions}\Parameter{family}\Parameter{options list}%
\end{Declaration}
\BeginIndex{Cmd}{FamilyOptions}%
-\BeginIndex{Cmd}{Family@Options}%
-Thereby \PName{options list} is like:
+Hence \PName{options list} is like:
\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
\PName{key}\texttt{=}\PName{value}\texttt{,}%
\PName{key}\texttt{=}\PName{value}\dots
\end{tabular}\vskip\dp\strutbox\end{flushleft}
-whereby the value assignment may be omitted for \PName{key}s, that have a
+after which the value assignment may be omitted for \PName{key}s that have a
defined default.
-In opposite to average options, that has been defined using
-\Macro{DeclareOption}, the \PName{key}s may also be set after loading a class
-or package. For this the user uses \Macro{FamilyOptions}. Thereby the
-\PName{key}s of all members of the given family will be set. If a \PName{key}
-also exists as an family attribute, then the family key will be set
-first. After this the member keys will follow in the order, the members has
-been defined. If a given \PName{key} does exist neither in the family nor in
-any member of the family, then \Macro{FamilyOptions} will result in an
-error. In opposite to this with \Macro{Family@Options} the user may declare
-his own \PName{error action}. But this internal command is reserved for
-authors of classes and packages.
+In contrast to average options that are defined using \Macro{DeclareOption},
+the \PName{key}s also may be set after loading a class or package. For this,
+the user calls \Macro{FamilyOptions}. Thereafter, the \PName{key}s of all
+members of the specified family are set. If a \PName{key} also exists as a
+family attribute, then the family key is set first. After this, the member
+keys follow in the order in which the members have been defined. If a given
+\PName{key} does not exist, either for the family or for any member of the
+family, then \Macro{FamilyOptions} will result in an error. Package
+\Package{scrbase} reports an error also if there are members with key
+\PName{key}, but all those members signal failure via \Macro{FamilyKeyState}.
\begin{Example}
You extend your butcher project by a package \Package{sausagesalad}. If this
package has been loaded, all sausage package should generate cold cut:
@@ -343,15 +394,15 @@ authors of classes and packages.
\FamilyProcessOptions{butcher}\relax
\FamilyOptions{butcher}{coldcut}
\end{lstcode}
- If currently non of the sausage packages has been loaded, then an error
- message would result because of undefined option ``\Option{coldcut}''. Dies
- may be avoided changing the last line of the previous code into:
+ If currently none of the sausage packages are loaded, then an error
+ message results because of undefined option ``\Option{coldcut}''. This is
+ avoided by changing the last line of the code to:
\begin{lstcode}[moretexcs={Family@Options}]
\Family@Options{butcher}{coldcut}{}
\end{lstcode}
- Nevertheless, sausage packages, that will be loaded after
- \Package{sausagesalad}, won't produce cold cut. This may be changed
- additionally, by changing the last line again:
+ Despite this, sausage packages loaded after
+ \Package{sausagesalad} still do not produce cold cut. This may be corrected
+ by editing the last line of the code again to:
\begin{lstcode}[moretexcs={Family@Options}]
\AtBeginDocument{%
\Family@Options{butcher}{coldcut}{%
@@ -361,40 +412,34 @@ authors of classes and packages.
}%
}%
\end{lstcode}
- This will also throw a warning message, if non of the sausage packages will
- be loaded.
+ This may throw a warning message if none of the sausage packages are loaded.
\end{Example}
%
-\EndIndex{Cmd}{Family@Options}%
\EndIndex{Cmd}{FamilyOptions}%
\begin{Declaration}
\Macro{FamilyOption}\Parameter{family}%
- \Parameter{option}\Parameter{values list}\\
- \Macro{Family@Option}\Parameter{family}%
- \Parameter{option}\Parameter{values list}%
- \Parameter{error action}
+ \Parameter{option}\Parameter{values list}%
\end{Declaration}
\BeginIndex{Cmd}{FamilyOption}%
-\BeginIndex{Cmd}{Family@Option}%
-Beside options that have concurrently excluding values, there may be options,
-that have several values at the same time. Using \Macro{FamilyOptions} for
-that kind of options would result in using the same option several times with
+Besides options that have concurrently excluding values, there may be options
+that produce several values at the same time. Using \Macro{FamilyOptions} for
+that type of option would result in using the same option several times with
different value assignments. Instead of this, \Macro{FamilyOption} may be used
to assign a whole \PName{values list} to the same \PName{option}. The
-\PName{values list} is a comma separated list of values:
+\PName{values list} is a comma separated list of values, also known as
+\emph{csv}:
\begin{flushleft}\begin{tabular}{l}
\PName{value}\texttt{,}\PName{value}\dots
\end{tabular}\end{flushleft}
-By the way please note, that usage of a comma inside a value may be done only,
-if the value is put into braces. The general functionality of these commands
-is the same like that of the previous commands \Macro{FamilyOptions} and
-\Macro{Family@Options}.
+By the way, please note that usage of a comma inside a value may be done only
+if the value is put inside braces. The general functionality of this command
+is the same as that of the previous command \Macro{FamilyOptions}.
\begin{Example}
Package \Package{sausagesalad} should have one mire option, to add
- additional ingredients. Each of the ingredients will set a switch like done
- before for the cold cut.
+ additional ingredients. Each of the ingredients sets a switch as was done
+ previously for the cold cut.
\begin{lstcode}
\newif\if@saladwith@onions
\newif\if@saladwith@gherkins
@@ -403,8 +448,9 @@ is the same like that of the previous commands \Macro{FamilyOptions} and
\csname @saladwith@#1true\endcsname
}
\end{lstcode}
- Here the three ingredients ``onions'', ``gherkins'', and ``chillies'' has
- been defined. An error message for not defined ingredients doesn't exist.
+ Here the three ingredients ``onions'', ``gherkins'', and ``chillies'' have
+ been defined. An error message for ``not defined'' ingredients does not
+ exist.
For a salad with onions and gherkins the user may use
\begin{lstcode}
@@ -418,11 +464,26 @@ is the same like that of the previous commands \Macro{FamilyOptions} and
\end{lstcode}
\end{Example}
%
-\EndIndex{Cmd}{Family@Option}%
\EndIndex{Cmd}{FamilyOption}%
\begin{Declaration}
+ \Macro{AtEndOfFamilyOptions}\Parameter{action}%
+\end{Declaration}
+\BeginIndex{Cmd}{AtEndOfFamilyOptions}%
+Sometimes\ChangedAt{v3.12}{\Package{scrbase}} it is useful to delay the
+execution of an \PName{action} that is part of a value assignment to a key
+until all assignments inside one \Macro{FamilyProcessOptions},
+\Macro{FamilyExecuteOptions}, \Macro{FamilyOptions}, or \Macro{FamilyOption}
+is finished. This may be done using \Macro{AtEndOfFamilyOptions} inside
+an option definition. Reporting failure states of \PName{action} is not
+possible in this case. Furthermore, the command should not be used outside an
+option definition.
+%
+\EndIndex{Cmd}{AtEndOfFamilyOptions}%
+
+
+\begin{Declaration}
\Macro{FamilyBoolKey}\OParameter{family member}\Parameter{family}%
\Parameter{key}\Parameter{switch name}\\
\Macro{FamilySetBool}\Parameter{family}%
@@ -430,31 +491,33 @@ is the same like that of the previous commands \Macro{FamilyOptions} and
\end{Declaration}
\BeginIndex{Cmd}{FamilyBoolKey}%
\BeginIndex{Cmd}{FamilySetBool}%
-In the previous examples boolean switches often have been used. In the example
-with option \Option{coldcut} is was necessary, that the user assigns either
-value \PValue{true} or value \PValue{false}. No error message existed on wrong
-value assignment. Because of such boolean switches are an often needed
-feature, \Package{scrbase} provides \Macro{FamilyBoolKey} for definition of
-such options. Thereby the arguments \PName{family member}, \PName{family},
-and \PName{key} are same like used by \Macro{DefineFamilyKey} (see
+In the previous examples, boolean switches often have been used. In the example
+with option \Option{coldcut}, it is necessary that the user assigns either
+value \PValue{true} or value \PValue{false}. There is no error message for
+wrong value assignment. Because of this, boolean switches are a necessary
+feature. Package \Package{scrbase} provides \Macro{FamilyBoolKey} for definition of
+such options. Therefore, the arguments \PName{family member}, \PName{family}, and
+\PName{key} are the same as that used by \Macro{DefineFamilyKey} (see
\autopageref{desc:scrbase.cmd.DefineFamilyKey}). Argument \PName{switch name}
is the name of the switch without the prefix \Macro{if}. If a switch with this
-name doesn't exist already, \Macro{FamilyBoolKey} will define it and
+name does not exist already, \Macro{FamilyBoolKey} will define it and
initialize it to \PName{false}. Internally \Macro{FamilyBooKey} uses
\Macro{FamilySetBool} as \PName{action} of \Macro{DefineFamilyKey}. The
\PName{default} for those options is always \PValue{true}.
-\Macro{FamilySetBool} on the other side understands \PName{value} \PValue{on}
+On the other hand, \Macro{FamilySetBool} understands \PName{value} \PValue{on}
and \PValue{yes} beside \PName{true} for switching on and \PName{off} and
\PName{no} beside \PName{false} for switching off. Unknown values will result
in a call of \Macro{FamilyUnknownKeyValue} with the arguments \PName{family},
-\PName{key}, and \PName{value}. This will normally result in an error message
-about unknown value assignment (see also
-\autopageref{desc:scrbase.cmd.FamilyUnkownKeyValue}).
+\PName{key}, and \PName{value}, which results in setting of
+\Macro{FamilyKeyState}. Depending on the command used and other family
+members, this may result in an error message about unknown value assignment
+(see also \autopageref{desc:scrbase.cmd.FamilyUnkownKeyValue} and
+\autopageref{desc:scrbase.cmd.FamilyKeyState}).
\begin{Example}
- The key \Option{coldcut} should be declared somehow more robust. Additionally
- all sausage packages should use the same key. So either all or none of them
- will produce cold cut.
+ The key \Option{coldcut} should be declared somehow more
+ robust. Additionally, all sausage packages should use the same key. So
+ either all or none of them will produce cold cut.
\begin{lstcode}
\FamilyBoolKey{butcher}{coldcut}%
{@coldcut}
@@ -467,13 +530,13 @@ about unknown value assignment (see also
...
\fi
\end{lstcode}
- This would be the same in each of the three sausage packages. With this the
- attribute ``coldcut'' may be defined as a family option:
+ This would be the same in each of the three sausage packages, thereby
+ defining the attribute ``coldcut'' as a family option:
\begin{lstcode}[moretexcs={define@key}]
\@ifundefined{if@coldcut}{%
\expandafter\newif\csname if@coldcut\endcsname
}{}%
- \define@key{butcher}{coldcut}[true]{%
+ \DefineFamilyKey[]{butcher}{coldcut}[true]{%
\FamilySetBool{butcher}{coldcut}%
{@coldcut}%
{#1}%
@@ -485,7 +548,7 @@ about unknown value assignment (see also
{@coldcut}
\end{lstcode}
using the additional information at
- \autopageref{explain:scrbase.macro.DefineFamilyKey}, that's not only valid
+ \autopageref{explain:scrbase.macro.DefineFamilyKey}, this is not only valid
for \Macro{DefineFamilyKey} but for \Macro{FamilyBoolKey} too.
\end{Example}
%
@@ -506,10 +569,10 @@ about unknown value assignment (see also
\end{Declaration}
\BeginIndex{Cmd}{FamilyNumericalKey}%
\BeginIndex{Cmd}{FamilySetNumerical}%
-In opposite to switches that may be either true or false, also key exists,
+In contrast to switches that may be either true or false, a key exists
that accept several values. For example an alignment may not only be left or
-not left, but, e.\,g., left, centered, or right. Internally such
-differentiations are often made using \Macro{ifcase}. This \TeX{} command
+not left, but left, centered, or right. Internally such
+differentiation often is made using \Macro{ifcase}. This \TeX{} command
expects a numerical value. Because of this the command to define a macro by
a \PName{key} has been named \Macro{FamilyNumericalKey} in
\Package{scrbase}. The \PName{values list} thereby has the form:
@@ -518,16 +581,16 @@ a \PName{key} has been named \Macro{FamilyNumericalKey} in
\Parameter{value}\Parameter{definition}\texttt{,}%
\dots
\end{tabular}\vskip\dp\strutbox\end{flushleft}
-So the \PName{values list} does not only define the supported values to the
-\PName{key}. For each of the \PName{value}s it also gives the
-\PName{definition} of macro \Macro{\PName{command}}. Usually
-\PName{definition} is just a numerical value. Nevertheless other content is
-possible and allowed. Currently the only limitation is, that
-\PName{definition} has to be fully expandable and will be expanded while the
+Therefore, the \PName{values list} does not solely define the supported values to the
+\PName{key}. For each of the \PName{value}s, the
+\PName{definition} of macro \Macro{\PName{command}} also is given. Usually,
+\PName{definition} is just a numerical value. Nevertheless, other content is
+possible and allowed. Currently, the only limitation is that
+\PName{definition} has to be fully expandable and will be expanded during the
assignment.
\begin{Example}
The sausage may be cut different. For example the cold cut may stay uncut or
- will by cut roughly or may be cut thinly. This information should be stored
+ will be cut roughly or may be cut thinly. This information should be stored
in command \Macro{cuthow}.
\begin{lstcode}
\FamilyNumericalKey{butcher}%
@@ -551,10 +614,10 @@ assignment.
\end{lstcode}
In all three cases \Macro{cuthow} would be defined with content
\PValue{none}. It may be very useful to provide several values for the same
- result like shown in this example.
+ result as shown in this example.
Now, it's most likely, that the kind of cutting will not be printed, but
- should be evaluated later. In this case a textual definition wouldn't be
+ should be evaluated later. In this case a textual definition would not be
useful. If the key is defined like this:
\begin{lstcode}
\FamilyNumericalKey{butcher}%
@@ -564,7 +627,7 @@ assignment.
{thin}{2}%
}
\end{lstcode}
- then a condition like this:
+ then a condition like the following may be used:
\begin{lstcode}
\ifcase\cuthow
% no cut
@@ -574,9 +637,8 @@ assignment.
% thin cut
\fi
\end{lstcode}
- may be used.
\end{Example}
-Internally \Macro{FamilyNumericalKey} uses \Macro{FamilySetNumerical} as
+Internally, \Macro{FamilyNumericalKey} uses \Macro{FamilySetNumerical} as
\PName{action} of \Macro{DefineFamilyKey}. If a unknown value is assigned to
such a key, \Macro{FamilySetNumerical} will call \Macro{FamilyUnkownKeyValue}
with the arguments \PName{family}, \PName{key} and \PName{value}. This will
@@ -593,18 +655,19 @@ normally result in an error message about assigning an unknown value.
\OParameter{default}\Parameter{command}
\end{Declaration}
\BeginIndex{Cmd}{FamilyStringKey}%
-This defines\ChangedAt{v3.08}{\Package{scrbase}} a \PName{key}, that accepts
-every value. The value will be stored into the given \Macro{command}. If their
+This defines\ChangedAt{v3.08}{\Package{scrbase}} a \PName{key} that accepts
+every value. The value will be stored into the given \Macro{command}. If there
is no optional argument for the \PName{default}, \Macro{FamilyStringKey} is
-the same like
+the same as:
\begin{quote}
\Macro{DefineFamilyKey}\OParameter{family member}\Parameter{family}%
\Parameter{key}\\
\hphantom{\Macro{DefineFamilyKey}}%
-\PParameter{\Macro{def}\PName{command}\string{\#1\string}}.
+\PParameter{\Macro{def}\PName{command}\string{\#1\string}%
+\Macro{FamilyKeyStateProcessed}}.
\end{quote}
-If an optional argument \PName{default} has been used, \Macro{FamilyStringKey}
-is the same like
+If an optional argument \PName{default} is used, \Macro{FamilyStringKey}
+is the same as:
\begin{quote}
\Macro{DefineFamilyKey}\OParameter{family member}\Parameter{family}%
\Parameter{key}\\
@@ -612,13 +675,12 @@ is the same like
\OParameter{default}%
\PParameter{\Macro{def}\PName{command}\string{\#1\string}}.
\end{quote}
-If \PName{command} hasn't been defined already, an empty macro will be
-defined.
+If \PName{command} is not been defined, an empty macro will be defined.
\begin{Example}
By default an amount of 250\Unit{g} sausage salad should be produced. The
amount should be configurable by an option. The wanted amount will be stored
in the macro \Macro{saladweight}. The option should be named
- \PValue{saladweight} too:
+ \PValue{saladweight}, too:
\begin{lstcode}
\newcommand*{\saladweight}{250g}
\FamilyStringKey{butcher}%
@@ -629,11 +691,11 @@ defined.
\begin{lstcode}
\FamilyOptions{butcher}{saladweight}
\end{lstcode}
- That may be done, because the default weight has been set as default at the
+ This may be done, because the default weight has been set as default at the
definition of the option above.
\end{Example}
-In this case there are no unknown values, because all values are simply used
-for a macro definition. Nevertheless, you should note, that paragraph breaks
+In this case there are not unknown values because all values are simply used
+for a macro definition. Nevertheless, you should note that paragraph breaks
at the value assignment to the key are not allowed.
%
\EndIndex{Cmd}{FamilyStringKey}%
@@ -641,8 +703,7 @@ at the value assignment to the key are not allowed.
\begin{Declaration}
\Macro{FamilyUnkownKeyValue}\Parameter{family}\Parameter{key}%
- \Parameter{value}\Parameter{values list}\\
- \Macro{FamilyElseValues}
+ \Parameter{value}\Parameter{values list}%
\end{Declaration}
\BeginIndex{Cmd}{FamilyUnkownKeyValue}%
\BeginIndex{Cmd}{FamilyElseValues}%
@@ -652,17 +713,10 @@ separated list of allowed values in the form:
\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
`\PName{value}'\texttt{,} `\PName{value}' \dots
\end{tabular}\vskip\dp\strutbox\end{flushleft}
-Additional allowed values may be set by \Macro{FamilyElseValues} in
-the form:
-\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
- \texttt{,} `\PName{value}'\texttt{,} `\PName{value}' \dots
-\end{tabular}\vskip\dp\strutbox\end{flushleft}
-These will also be shown in the error message. \Macro{FamilySetBool} as well
-as \Macro{FamilySetNumerical} will reset \Macro{FamilyElseValue} to an empty
-definition automatically\,---\,independent of whether or not a error has been
-thrown.
+Currently\ChangedAt{v3.12}{\Package{scrbase}}, \PName{values list} is
+not used by \Package{scrbase}.
\begin{Example}
- Now, for the cold cut the choices should be cut or no cut and in case of cut
+ Now, for the cold cut, the choices should be cut or no-cut and in case of cut
rough or thin. Rough should be the default for cutting.
\begin{lstcode}
\@ifundefined{if@thincut}{%
@@ -673,31 +727,62 @@ thrown.
\newif\csname if@coldcut\endcsname}{}
\DefineFamilyKey{butcher}%
{coldcut}[true]{%
- \ifstr{#1}{thin}{%
- \@coldcuttrue
- \@thincuttrue
- }{%
+ \FamilySetBool{butcher}{coldcut}%
+ {@coldcut}%
+ {#1}%
+ \ifx\FamilyKeyState\FamilyKeyStateProcessed
\@thincutfalse
- \def\FamilyElseValue{, `thin'}%
- \FamilySetBool{butcher}{coldcut}%
- {@coldcut}%
- {#1}%
- }%
+ \else
+ \ifstr{#1}{thin}{%
+ \@coldcuttrue
+ \@thincuttrue
+ \FamilyKeyStateProcessed
+ }{}%
+ \fi
}%
\end{lstcode}
- Command \Macro{ifstr} used at the example code above will be described at
- \autopageref{desc:scrbase.cmd.ifstr} in \autoref{sec:scrbase.if}.
+ Let's have a look at the definition of \Option{butcher}:
+ First of all, we try to set the boolean switch of cold cut using
+ \Macro{FamilySetBool}. After this command, we test whether or not
+ \Macro{FamilyKeyState} signals the success of the command with state
+ \Macro{FamilyKeyStateProcessed}. If so, only the thin cut has to be
+ deactivated.
+
+ In the other case, the value will be tested to be equal to \PValue{thin}. In
+ that case, cold cut and thin cut are activated and the state will be
+ switched to \Macro{FamilyKeyStateProcessed}. If the last test failed also,
+ the failure state of \Macro{FamilySetBool} is still valid at the end of the
+ execution.
+
+ Command \Macro{ifstr} is used for the thin test. It is
+ described on \autopageref{desc:scrbase.cmd.ifstr} in
+ \autoref{sec:scrbase.if}.
\end{Example}
%
-\EndIndex{Cmd}{FamilyElseValues}%
\EndIndex{Cmd}{FamilyUnkownKeyValue}%
+\begin{Declaration}
+ \Macro{FamilyElseValues}
+\end{Declaration}
+\BeginIndex{Cmd}{FamilyElseValues}%
+With former releases\ChangedAt{v3.12}{\Package{scrbase}} of \Package{scrbase},
+additional allowed values reported by \Macro{FamilyUnknownKeyValue} can be
+set re-defining \Macro{FamilyElseValues} in the form:
+\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
+ \texttt{,} `\PName{value}'\texttt{,} `\PName{value}' \dots
+\end{tabular}\vskip\dp\strutbox\end{flushleft}
+Since release~3.12 \Macro{FamilyUnknownValue} does not report errors itself,
+but signals them using \Macro{FamilyKeyState}. Therefore,
+\Macro{FamilyElseValues} became deprecated. Nevertheless, its former usage is
+recognised by \Package{scrbase} and results in a code change demand message.%
+\EndIndex{Cmd}{FamilyElseValues}%
+
\section{Conditional Execution}
\label{sec:scrbase.if}
The package \Package{scrbase} provides several commands for conditional
-execution. Thereby not the \TeX{} syntax of conditionals, e.\,g.,
+execution. other than the \TeX{} syntax of conditionals, e.\,g.,
% Umbruchkorrektur
\begin{lstcode}[belowskip=\dp\strutbox]
\iftrue
@@ -706,21 +791,21 @@ execution. Thereby not the \TeX{} syntax of conditionals, e.\,g.,
...
\fi
\end{lstcode}
-but the \LaTeX{} syntax also known from \LaTeX{} commands like
+yet the \LaTeX{} syntax also known from \LaTeX{} commands like
\Macro{IfFileExists}, \Macro{@ifundefined}, \Macro{@ifpackageloaded}, and many
-others will be used. Nevertheless, some package authors prefer to use the
-\TeX{} syntax even for users at the \LaTeX{} interface level. In fact the
-conditionals of \Package{scrbase} are very basic conditionals, this could
-result in conditionals with the same name but different syntax and though in
-naming conflicts. Because of this \Package{scrbase} firstly defines these
-conditionals as internal commands with prefix \Macro{scr@}. Additional user
-commands without this prefix are additionally defined. But the definition of
-the user commands may be suppressed with option \Option{internalonly} (see
+others, is used. Nevertheless, some package authors prefer to use the \TeX{}
+syntax even for users at the \LaTeX{} interface level that could inevitably
+lead to naming conflicts with the \Package{scrbase} conditionals. In fact, the
+conditionals of \Package{scrbase} are very basic. Because of this
+\Package{scrbase} firstly defines these conditionals as internal commands with
+prefix \Macro{scr@}. Additional user commands without this prefix are
+subsequently defined. But the definition of the user commands may be
+suppressed with option \Option{internalonly} (see
\autoref{sec:scrbase.loadit}, \autopageref{desc:scrbase.option.internalonly}).
-Authors of packages and classes should use the internal commands like
+Authors of packages and classes should use the internal commands as
\KOMAScript{} itself does. Nevertheless, for completeness the user commands
-are described additionally.
+are described separately.
\begin{Declaration}
@@ -733,12 +818,12 @@ are described additionally.
\BeginIndex{Cmd}{ifundefinedorrelax}%
This command has almost the same functionality as \Macro{@ifundefined} from
the \LaTeX{} kernel (see \cite{latex:source2e}). So the \PName{then
- instructions} will be executed, if \PName{name} is the name of a command,
-that is currently either not defined or \Macro{relax}. Otherwise the
-\PName{else instructions} will be executed. In opposite to
-\Macro{@ifundefined} \Macro{\PName{name}} won't be defined to be \Macro{relax}
-in the case it wasn't defined before. Using \eTeX{} this case won't at least
-consume any hash memory.%
+ instructions} will be executed if \PName{name} is the name of a command
+that is currently either not defined or \Macro{relax}. Otherwise, the
+\PName{else instructions} will be executed. In contrast to
+\Macro{@ifundefined}, \Macro{\PName{name}} is not defined to be \Macro{relax}
+in the event it was not defined before. Moreover, using \eTeX{} this case will
+not consume any hash memory.%
%
\EndIndex{Cmd}{ifundefinedorrelax}%
\EndIndex{Cmd}{scr@ifundefinedorrelax}%
@@ -753,11 +838,10 @@ consume any hash memory.%
\BeginIndex{Cmd}{scr@ifpdftex}%
\BeginIndex{Cmd}{ifpdftex}%
If pdf\TeX{} has been used, the \PName{then instructions} will be executed,
-otherwise the \PName{else instructions}. Whether or not a PDF-file will be
-out, doesn't matter. Nevertheless, this pdf\TeX{} test seems so make sense
-seldom only. Generally it's recommended to test for the wanted commands
-instead (see previous \Macro{scr@ifundefinedorrelax} and
-\Macro{ifundefinedorrelax}).
+otherwise the \PName{else instructions}. Whether or not a PDF-file is
+generated does not matter, and the pdf\TeX{} test is rarely useful. In
+general, test for the desired command instead (see previous
+\Macro{scr@ifundefinedorrelax} and \Macro{ifundefinedorrelax}).
%
\EndIndex{Cmd}{ifpdftex}%
\EndIndex{Cmd}{scr@ifpdftex}%
@@ -772,9 +856,9 @@ instead (see previous \Macro{scr@ifundefinedorrelax} and
\BeginIndex{Cmd}{scr@ifVTeX}%
\BeginIndex{Cmd}{ifVTeX}%
If V\TeX{} has been used, the \PName{then instructions} will be executed,
-otherwise the \PName{else instructions}. This test seems so make sense
-seldom only. Generally it's recommended to test for the wanted commands instead
-(see previous \Macro{scr@ifundefinedorrelax} and \Macro{ifundefinedorrelax}).
+otherwise the \PName{else instructions}. This test is seldom useful. Test for
+the desired command instead (see previous \Macro{scr@ifundefinedorrelax} and
+\Macro{ifundefinedorrelax}).
%
\EndIndex{Cmd}{ifVTeX}%
\EndIndex{Cmd}{scr@ifVTeX}%
@@ -788,9 +872,9 @@ seldom only. Generally it's recommended to test for the wanted commands instead
\end{Declaration}
\BeginIndex{Cmd}{scr@ifpdfoutput}%
\BeginIndex{Cmd}{ifpdfoutput}%
-While PDF-file generation the \PName{then instructions} will be executed,
-otherwise the \PName{else instructions}. Whether, e.\,g., pdf\TeX{} or V\TeX{}
-is used to generate the PDF-file doesn't matter.
+When generating a PDF-file the \PName{then instructions} will be executed,
+otherwise the \PName{else instructions}. Whether pdf\TeX{} or V\TeX{} or
+another \TeX{} engine is used to generate the PDF-file does not matter.
%
\EndIndex{Cmd}{ifpdfoutput}%
\EndIndex{Cmd}{scr@ifpdfoutput}%
@@ -804,12 +888,11 @@ is used to generate the PDF-file doesn't matter.
\end{Declaration}
\BeginIndex{Cmd}{scr@ifpsoutput}%
\BeginIndex{Cmd}{ifpsoutput}%
-While PostScript-file generation the \PName{then instructions} will be executed,
-otherwise the \PName{else instructions}. V\TeX{} provides direct PostScript
-generation, that will be recognized here. If V\TeX{} is not used but a switch
-\Macro{if@dvips} has been defined, the decision depends on that
-switch. \KOMAScript{}, e.\,g., provides \Macro{if@dvips} in
-\Package{typearea}.
+When generating a PostScript-file the \PName{then instructions} will be
+executed, otherwise the \PName{else instructions}. V\TeX{} provides direct
+PostScript generation that will be recognised here. If V\TeX{} is not used,
+but a switch \Macro{if@dvips} has been defined, the decision depends on that
+switch. \KOMAScript{} provides \Macro{if@dvips} in \Package{typearea}.
%
\EndIndex{Cmd}{ifpsoutput}%
\EndIndex{Cmd}{scr@ifpsoutput}%
@@ -823,7 +906,7 @@ switch. \KOMAScript{}, e.\,g., provides \Macro{if@dvips} in
\end{Declaration}
\BeginIndex{Cmd}{scr@ifdvioutput}%
\BeginIndex{Cmd}{ifdvioutput}%
-While DVI-file generation the \PName{then instructions} will be executed,
+When generating a DVI-file the \PName{then instructions} will be executed,
otherwise the \PName{else instructions}. If neither a direct PDF-file
generation nor a direct PostScript-file generation has been detected, DVI-file
generation is assumed.
@@ -839,8 +922,8 @@ generation is assumed.
\BeginIndex{Cmd}{ifnotundefined}%
\eTeX{} will be used to test, whether or not a command with the given
\PName{name} has already been defined. The \PName{then instructions} will be
-executed, if the command is defined, the \PName{else instructions}
-otherwise. There's no corresponding internal command for this.
+executed if the command is defined, otherwise the \PName{else
+ instructions}. There is no corresponding internal command.
%
\EndIndex{Cmd}{ifnotundefined}%
@@ -850,23 +933,159 @@ otherwise. There's no corresponding internal command for this.
\Parameter{then instructions}\Parameter{else instructions}
\end{Declaration}
\BeginIndex{Cmd}{ifstr}%
-Both \PName{string} arguments will be expanded and afterward compared. If the
-expansions are same, the \PName{then instructions} will be
-executed, otherwise the \PName{else instructions}. There's no corresponding
-internal command for this.
+Both \PName{string} arguments are expanded and afterwards compared. If the
+expansions are the same, the \PName{then instructions} will be executed,
+otherwise the \PName{else instructions}. There is no corresponding internal
+command.
%
\EndIndex{Cmd}{ifstr}%
+\begin{Declaration}
+ \Macro{ifstrstart}\Parameter{string}\Parameter{string}%
+ \Parameter{then instructions}\Parameter{else instructions}
+\end{Declaration}
+\BeginIndex{Cmd}{ifstrstart}%
+Both\ChangedAt{v3.12}{\Package{scrbase}} \PName{string} arguments are
+expanded and afterwards compared. If aside from white spaces the first string
+starts with the second one, the \PName{then instructions} will be executed,
+otherwise the \PName{else instructions}. The command is not completely
+expandable and there is no corresponding internal command.%
+\EndIndex{Cmd}{ifstrstart}%
+
+\begin{Declaration}
+ \Macro{ifisdimen}\Parameter{code}%
+ \Parameter{then instructions}\Parameter{else instructions}
+\end{Declaration}
+\BeginIndex{Cmd}{ifisdimen}%
+If\ChangedAt{v3.12}{\Package{scrbase}} the expansion of\PName{code} results in
+a \Macro{dimen}, which is also known as \TeX{} length register, the
+\PName{then instructions} will be executed, otherwise the \PName{else
+ instructions}. The command is not completely expandable and there is no
+corresponding internal command.%
+\EndIndex{Cmd}{ifisdimen}%
+
+\begin{Declaration}
+ \Macro{ifisdimension}\Parameter{code}%
+ \Parameter{then instructions}\Parameter{else instructions}
+\end{Declaration}
+\BeginIndex{Cmd}{ifisdimension}%
+If\ChangedAt{v3.12}{\Package{scrbase}} \PName{code} expands to something with
+the syntax of the value of a length, the \PName{then instructions} will be
+executed, otherwise the \PName{else instructions}. Please
+note\textnote{Attention!} that currently an invalid unit will result in an
+error message. The command is not completely expandable and there is no
+corresponding internal command.%
+\EndIndex{Cmd}{ifisdimension}%
+
+\begin{Declaration}
+ \Macro{ifisdimexpr}\Parameter{code}%
+ \Parameter{then instructions}\Parameter{else instructions}
+\end{Declaration}
+\BeginIndex{Cmd}{ifisdimexpr}%
+If\ChangedAt{v3.12}{\Package{scrbase}} the expansion of\PName{code} results in
+a \Macro{dimexpr}, which is also known as \TeX{} length expression, the
+\PName{then instructions} will be executed, otherwise the \PName{else
+ instructions}. Note\textnote{Attention!} that illegal expressions will
+result in error messages. The command is not completely expandable and there
+is no corresponding internal command.%
+\EndIndex{Cmd}{ifisdimexpr}%
+
+\begin{Declaration}
+ \Macro{ifisskip}\Parameter{code}%
+ \Parameter{then instructions}\Parameter{else instructions}
+\end{Declaration}
+\BeginIndex{Cmd}{ifisskip}%
+If\ChangedAt{v3.12}{\Package{scrbase}} the expansion of\PName{code} results in
+a \Macro{skip}, which is also known as \TeX{} distance register, the
+\PName{then instructions} will be executed, otherwise the \PName{else
+ instructions}. The command is not completely expandable and there is no
+corresponding internal command.%
+\EndIndex{Cmd}{ifisskip}%
+
+\begin{Declaration}
+ \Macro{ifisglue}\Parameter{code}%
+ \Parameter{then instructions}\Parameter{else instructions}
+\end{Declaration}
+\BeginIndex{Cmd}{ifisglue}%
+If\ChangedAt{v3.12}{\Package{scrbase}} \PName{code} expands to something with
+the syntax of the value of a skip, the \PName{then instructions} will be
+executed, otherwise the \PName{else instructions}. Please
+note\textnote{Attention!} that currently an invalid unit will result in an
+error message. The command is not completely expandable and there is no
+corresponding internal command.%
+\EndIndex{Cmd}{ifisglue}%
+
+\begin{Declaration}
+ \Macro{ifisglueexpr}\Parameter{code}%
+ \Parameter{then instructions}\Parameter{else instructions}
+\end{Declaration}
+\BeginIndex{Cmd}{ifisglueexpr}%
+If\ChangedAt{v3.12}{\Package{scrbase}} the expansion of\PName{code} results in
+a \Macro{glueexpr}, which is also known as \TeX{} distance expression, the
+\PName{then instructions} will be executed, otherwise the \PName{else
+ instructions}. Note,\textnote{Attention!} that illegal expressions will
+result in error messages. The command is not completely expandable and there
+is no corresponding internal command.%
+\EndIndex{Cmd}{ifisglueexpr}%
+
+\begin{Declaration}
+ \Macro{ifiscount}\Parameter{code}%
+ \Parameter{then instructions}\Parameter{else instructions}
+\end{Declaration}
+\BeginIndex{Cmd}{ifiscount}%
+If\ChangedAt{v3.12}{\Package{scrbase}} the expansion of\PName{code} results in
+a \Macro{count}, which is also known as \TeX{} counter register, the
+\PName{then instructions} will be executed, otherwise the \PName{else
+ instructions}. The command is not completely expandable and there is no
+corresponding internal command. For test with \LaTeX{} counters, see
+\Macro{ifiscounter}.%
+\EndIndex{Cmd}{ifiscount}%
+
+\begin{Declaration}
+ \Macro{ifisnumber}\Parameter{code}%
+ \Parameter{then instructions}\Parameter{else instructions}
+\end{Declaration}
+\BeginIndex{Cmd}{ifisnumber}%
+If\ChangedAt{v3.12}{\Package{scrbase}} \PName{code} expands to something with
+the syntax of the value of a counter, which would be a negative or positive
+integer, the \PName{then instructions} will be executed, otherwise the
+\PName{else instructions}. The command is not completely expandable and there
+is no corresponding internal command.%
+\EndIndex{Cmd}{ifisnumber}%
+
+\begin{Declaration}
+ \Macro{ifisnumexpr}\Parameter{code}%
+ \Parameter{then instructions}\Parameter{else instructions}
+\end{Declaration}
+\BeginIndex{Cmd}{ifisnumexpr}%
+If\ChangedAt{v3.12}{\Package{scrbase}} the expansion of\PName{code} results in
+a \Macro{numexpr}, which is also known as \TeX{} number expression, the
+\PName{then instructions} will be executed, otherwise the \PName{else
+ instructions}. Note\textnote{Attention!} that illegal expressions will
+result in error messages. The command is not completely expandable and there
+is no corresponding internal command.%
+\EndIndex{Cmd}{ifisnumexpr}%
+
+\begin{Declaration}
+ \Macro{ifiscounter}\Parameter{counter}%
+ \Parameter{then instructions}\Parameter{else instructions}
+\end{Declaration}
+\BeginIndex{Cmd}{ifiscounter}%
+If\ChangedAt{v3.12}{\Package{scrbase}} \PName{counter} is an already defined
+\LaTeX{} counter, the \PName{then instructions} will be executed, otherwise
+the \PName{else instructions}. The command is not completely expandable and
+there is no corresponding internal command.%
+\EndIndex{Cmd}{ifiscounter}%
\begin{Declaration}
\Macro{ifnumber}\Parameter{string}%
\Parameter{then instructions}\Parameter{else instructions}
\end{Declaration}
\BeginIndex{Cmd}{ifnumber}%
-Note, that this does not compare numbers. The \PName{then instructions} will
-be executed, if the expansion of \PName{string} consists of digits
-only. Otherwise the \PName{else instructions} will be used. There's no
-corresponding internal command for this.
+Note that this does not compare numbers. The \PName{then instructions} will
+be executed if the expansion of \PName{string} consists of digits
+only. Otherwise the \PName{else instructions} will be used. There is no
+corresponding internal command.
%
\EndIndex{Cmd}{ifnumber}%
@@ -876,10 +1095,10 @@ corresponding internal command for this.
\Parameter{then instructions}\Parameter{else instructions}
\end{Declaration}
\BeginIndex{Cmd}{ifdimen}%
-Note, that this does not compare dimensions. The \PName{then instructions} will
+Note that this does not compare dimensions. The \PName{then instructions} will
be executed, if the expansion of \PName{string} consists of digits and a valid
-unit of length. Otherwise the \PName{else instructions} will be used. There's no
-corresponding internal command for this.
+unit of length. Otherwise, the \PName{else instructions} will be used. There
+is no corresponding internal command.
%
\EndIndex{Cmd}{ifdimen}%
@@ -890,11 +1109,11 @@ corresponding internal command for this.
\end{Declaration}
\BeginIndex{Cmd}{if@atdocument}%
This command exists intentionally as internal command only. In the document
-preamble \Macro{if@atdocument} is same like \Macro{iffalse}. After
-\Macro{begin}\PParameter{document} it's same like \Macro{iftrue}. Authors of
-classes and packages may use this, if a command should work somehow different
-depending in whether it has been used in the preamble or inside the documents
-body. Please note\textnote{Attention!}, that this is a condition in \TeX{}
+preamble \Macro{if@atdocument} is same as \Macro{iffalse}. After
+\Macro{begin}\PParameter{document} it's the same as \Macro{iftrue}. Authors of
+classes and packages may use this if a command should work somehow different
+depending on whether it has been used in the preamble or inside the documents
+body. Please note\textnote{Attention!} that this is a condition in \TeX{}
syntax not in \LaTeX{} syntax!
%
\EndIndex{Cmd}{if@atdocument}%
@@ -906,77 +1125,106 @@ syntax not in \LaTeX{} syntax!
\index{language>dependent terms|see{language definition}}
\index{terms>language-dependent|see{language definition}}
-Normally one has to change or define language-dependent terms like
-\Macro{captionsenglish} in such a way that in addition to the available terms
+Normally, one has to change or define language-dependent terms like
+\Macro{captionsenglish} in such a way that, in addition to the available terms,
the new or redefined terms are defined. This is made more difficult by the
fact that some packages like \Package{german}\IndexPackage{german} or
\Package{ngerman}\IndexPackage{ngerman} redefine those settings when the
-packages are loaded. This definitions unfortunately occurs in such a manner as
+packages are loaded. These definitions unfortunately occur in such a manner as
to destroy all previous private settings. That is also the reason why it makes
-sense to delay own changes with \Macro{AtBeginDocument} until
-\Macro{begin}\PParameter{document}, that is, after package loading is
-completed. The user can also use \Macro{AtBeginDocument}, or redefine the
-language-dependent terms after \Macro{begin}\PParameter{document}, that is,
+sense to delay changes with \Macro{AtBeginDocument} until
+\Macro{begin}\PParameter{document}; that is, after package loading is
+completed. The user can also use \Macro{AtBeginDocument} or redefine the
+language-dependent terms after \Macro{begin}\PParameter{document}; that is,
not put them in the preamble at all. The package \Package{scrbase}
provides some additional commands for defining language-dependent terms.
\begin{Declaration}
+ \Macro{defcaptionname}%
+ \Parameter{language list}\Parameter{term}\Parameter{definition}\\
\Macro{providecaptionname}%
- \Parameter{language}\Parameter{term}\Parameter{definition}\\
+ \Parameter{language list}\Parameter{term}\Parameter{definition}\\
\Macro{newcaptionname}%
- \Parameter{language}\Parameter{term}\Parameter{definition}\\
+ \Parameter{language list}\Parameter{term}\Parameter{definition}\\
\Macro{renewcaptionname}%
- \Parameter{language}\Parameter{term}\Parameter{definition}
+ \Parameter{language list}\Parameter{term}\Parameter{definition}\\
+ \Macro{defcaptionname*}%
+ \Parameter{language list}\Parameter{term}\Parameter{definition}\\
+ \Macro{providecaptionname*}%
+ \Parameter{language list}\Parameter{term}\Parameter{definition}\\
+ \Macro{newcaptionname*}%
+ \Parameter{language list}\Parameter{term}\Parameter{definition}\\
+ \Macro{renewcaptionname*}%
+ \Parameter{language list}\Parameter{term}\Parameter{definition}
\end{Declaration}
+\BeginIndex{Cmd}{defcaptionname}%
\BeginIndex{Cmd}{providecaptionname}%
\BeginIndex{Cmd}{newcaptionname}%
\BeginIndex{Cmd}{renewcaptionname}%
Using one of these commands, the user can assign a \PName{definition} for a
-particular \PName{language} to a \PName{term}. The \PName{term} is always a
-macro. The commands differ dependent on whether a given \PName{language} or a
-\PName{term} within a given \PName{language} are already defined or not at the
+particular language to a \PName{term}. Several languages can be concatenated
+with comma to a \PName{language list}. The \PName{term} is always a
+macro. The commands differ depending on whether a given language or a
+\PName{term} within a given language are already defined or not at the
time the command is called.
-If \PName{language} is not defined, then \Macro{providecaptionname} does
-nothing other than writes a message in the log file. This happens only once
-for each language. If \PName{language} is defined but \PName{term} is not yet
+If a language is not defined, then \Macro{providecaptionname} does
+nothing other than write a message in the log file. This happens only once
+for each language. If a language is defined, but \PName{term} is not yet
defined for it, then it will be defined using \PName{definition}. The
-\PName{term} will not be redefined if the \PName{language} already has such a
+\PName{term} will not be redefined if the language already has such a
definition; instead, an appropriate message is written to the log file.
-The command \Macro{newcaptionname} has a slightly different behaviour. If the
-\PName{language} is not yet defined, then a new language command will be
-created and a message written to the log file. For \PName{language}
-\PValue{USenglish}, e.\,g.\, this would be the language command
-\Macro{captionsUSenglish}. If \PName{term} is not yet defined in
-\PName{language}, then it will be defined using \PName{definition}. If
-\PName{term} already exists in \PName{language}, then this results in an error
+The command \Macro{newcaptionname} has a slightly different behaviour. If a
+language is not yet defined, then a new language command will be
+created and a message written to the log file. For language
+\PValue{USenglish}, for example, this would be the language command
+\Macro{captionsUSenglish}. If \PName{term} is not yet defined in a
+language, then it will be defined using \PName{definition}. If
+\PName{term} already exists in a language, then this results in an error
message.
The command \Macro{renewcaptionname} again behaves differently. It requires an
-existing definition of \PName{term} in \PName{language}. If neither
-\PName{language} nor \PName{term} exist or \PName{term} is unknown in a
-defined language then a error message will be given. Otherwise, the
-\PName{term} for \PName{language} will be redefined according to
+existing definition of \PName{term} in the languages. If neither
+a language nor \PName{term} exist or \PName{term} is unknown in a
+defined language, then an error message is given. Otherwise, the
+\PName{term} for the language will be redefined according to
\PName{definition}.
-\KOMAScript{} itself employs \Macro{providecaptionname} in order to define the
+\KOMAScript{} employs \Macro{providecaptionname} in order to define the
commands in \autoref{sec:scrlttr2-experts.languages}.
\begin{Example}
- If you prefer ``fig.'' instead of ``figure'', you may achieve this using:
+ If you prefer ``fig.'' instead of ``figure'' in \PValue{USenglish}, you may
+ achieve this using:
\begin{lstcode}
\renewcaptionname{USenglish}{\figurename}{fig.}
\end{lstcode}
+ If you want the same change not only in \PValue{USenglish} but also in
+ \PValue{UKenglish}, you do not need an additional:
+\begin{lstcode}
+ \renewcaptionname{UKenglish}{\figurename}{fig.}
+\end{lstcode}
+ but can simply extend the \PName{language list}:
+\begin{lstcode}
+ \renewcaptionname{USenglish,UKenglish}{\figurename}{fig.}
+\end{lstcode}
+ You can extend the \PName{language list} in the same manner by
+ \PValue{american}, \PValue{australian}, \PValue{british}, \PValue{canadian},
+ and \PValue{newzealand}.
\end{Example}
-Since\textnote{Attention!} only existing terms in available languages can be
-redefined using \Macro{renewcaptionname}, you have to put the command after
-\Macro{begin}\PParameter{document} or delay the command by using
-\Macro{AtBeginDocument}. Furthermore, you will get an error message if there
-is no package used that switches language selection to, e.\,g.,
-\PName{USenglish} in the example above.
+Since \KOMAScript~3.12\ChangedAt{v3.12}{\Package{scrbase}} you do not need to
+delay the definition or redefinition until \Macro{begin}\PParameter{document}
+using \Macro{AtBeginDocument} any longer because \Package{scrbase} does the
+delay automatically for (re)definitions in the document's
+preamble. Additionally, \Package{scrbase} tests if a redefinition should be
+made in \Macro{extras\PName{language}} instead of
+\Macro{captions\PName{language}} and does so automatically. The new star
+variants of the commands always use \Macro{extras\PName{language}}. So
+redefinition of language dependent terms for packages like \Package{hyperref}
+that use \Macro{extras\PName{language}} should work as expected by the user.
Language dependent terms usually defined by classes and language
packages are listed and described in \autoref{tab:scrbase.commonNames}.
@@ -1081,6 +1329,7 @@ packages are listed and described in \autoref{tab:scrbase.commonNames}.
\EndIndex{Cmd}{providecaptionname}%
\EndIndex{Cmd}{newcaptionname}%
\EndIndex{Cmd}{renewcaptionname}%
+\EndIndex{Cmd}{defcaptionname}%
%
\EndIndex{}{language>definition}
@@ -1088,18 +1337,18 @@ packages are listed and described in \autoref{tab:scrbase.commonNames}.
\section{Identification of \KOMAScript}
\label{sec:scrbase.identify}
-\Package{scrbase} may be used independent of \KOMAScript{} with
-other packages and classes, nevertheless it's a \KOMAScript{} package. For
-this is also provides commands to identify \KOMAScript{} and itself as a
-\KOMAScript{} package.
+Package \Package{scrbase} may be used independent of \KOMAScript{} with
+other packages and classes. Nevertheless, it is a \KOMAScript{} package. For
+this, \Package{scrbase} also provides commands to identify \KOMAScript{} and
+to identify itself as a \KOMAScript{} package.
\begin{Declaration}
\Macro{KOMAScript}
\end{Declaration}
\BeginIndex{Cmd}{KOMAScript}%
This command only sets the word ``\KOMAScript'' with sans-serif font and
-a little bit tracking of the capitals. Bay the way: All \KOMAScript{} classes
-and packages define this command, if it hasn't been defined already. The
+a little bit tracking for the capitals. By the way: All \KOMAScript{} classes
+and packages define this command, if it has not been defined already. The
definition is robust using \Macro{DeclareRobustCommand}.
%
\EndIndex{Cmd}{KOMAScript}
@@ -1111,9 +1360,9 @@ definition is robust using \Macro{DeclareRobustCommand}.
\BeginIndex{Cmd}{KOMAScriptVersion}%
\KOMAScript{} defines the main version of \KOMAScript{} in this command. It
has the form ``\PName{date} \PName{version} \texttt{KOMA-Script}''. This main
-version is same for all \KOMAScript{} classes and the \KOMAScript{} packages,
+version is same for all \KOMAScript{} classes and the \KOMAScript{} packages
that are essential for the classes. Because of this, it may be inquired after
-loading \Package{scrbase} too. This document has been made, e.\,g., using
+loading \Package{scrbase}, too. For example, this document has been made using
\KOMAScript{} version ``\KOMAScriptVersion''.
%
\EndIndex{Cmd}{KOMAScriptVersion}%
@@ -1122,8 +1371,8 @@ loading \Package{scrbase} too. This document has been made, e.\,g., using
\section{Extension of the \LaTeX{} Kernel}
\label{sec:scrbase:latexkernel}
-Sometimes the \LaTeX{} kernel itself provides commands, but lacks of other,
-similar commands, that would often be useful too. Some of those commands for
+Sometimes the \LaTeX{} kernel itself provides commands, but lacks other,
+similar commands that would often be useful, too. Some of those commands for
authors of packages and classes are provided by \Package{scrbase}.
\begin{Declaration}
@@ -1133,14 +1382,14 @@ authors of packages and classes are provided by \Package{scrbase}.
\BeginIndex{Cmd}{PackageInfoNoLine}%
\BeginIndex{Cmd}{ClassInfoNoLine}%
For authors of classes and package the \LaTeX{} kernel already provides
-commands like \Macro{ClassInfo} and \Macro{PackageInfo} to write information
-together with the current line number into the log-file. Beside
+commands like \Macro{ClassInfo} and \Macro{PackageInfo} to write information.
+together with the current line number, into the log-file. Besides
\Macro{PackageWarning} and \Macro{ClassWarning} to throw warning messages with
line numbers, it also provides \Macro{PackageWarningNoLine} and
\Macro{ClassWarningNoLine} for warning messages without line
numbers. Nevertheless, the commands \Macro{ClassInfoNoLine} and
-\Macro{PackageInfoNoLine}, to write information without line numbers into the
-log-file, are missing. Package \Package{scrbase} provides them.
+\Macro{PackageInfoNoLine} for writing information without line numbers into the
+log-file are missing. Package \Package{scrbase} provides them.
%
\EndIndex{Cmd}{ClassInfoNoLine}%
\EndIndex{Cmd}{PackageInfoNoLine}
@@ -1156,8 +1405,8 @@ globally. This may be used only for macros that have no
arguments. Nevertheless, sometimes a command like this, that works locally to
a group instead of globally, could be useful. Package \Package{scrbase}
provides such a command with \Macro{l@addto@macro}. An alternative may be
-usage of package \Package{etoolbox}\IndexPackage{etoolbox}, that provides
-several of such commands for different purpose (see \cite{package:etoolbox}).
+usage of package \Package{etoolbox}\IndexPackage{etoolbox}, which provides
+several of such commands for different purposes (see \cite{package:etoolbox}).
%
\EndIndex{Cmd}{l@addto@macro}
@@ -1166,7 +1415,7 @@ several of such commands for different purpose (see \cite{package:etoolbox}).
\label{sec:scrbase:etex}
\eTeX{}, that is meanwhile used by \LaTeX{} and needed by \KOMAScript{},
-provides with \Macro{numexpr}\IndexCmd{numexpr} an extended feature for
+provided with \Macro{numexpr}\IndexCmd{numexpr}, an extended feature for
calculation of simple arithmetic with \TeX{} counters and
integers. The four basic arithmetic operations and brackets are
supported. Correct rounding is done while division. Sometimes additional
@@ -1178,9 +1427,10 @@ operators would be useful.
\end{Declaration}%
\BeginIndex{Cmd}{XdivY}%
\BeginIndex{Cmd}{XmodY}%
-Having a division with remainder, command\ChangedAt{v3.05a}{\Package{scrbase}}
-\Macro{XdivY} gives the value of the integer quotient, command \Macro{XmodY}
-the value of the remainder. This kind of division is defined:
+Having a division with remainder command\ChangedAt{v3.05a}{\Package{scrbase}}
+\Macro{XdivY} gives the value of the integer quotient, with command
+\Macro{XmodY} giving the value of the remainder. This kind of division is
+defined:
\[
\textit{dividend} = \textit{divisor} \cdot
\textit{integer quotient} + \textit{remainder}
@@ -1190,7 +1440,7 @@ is greater or equal to \textit{divisor}, and \textit{divisor} is a natural
number greater than 0.
The value may be used for assignment to a counter or directly in the
-expression of \Macro{numexpr}. For output the value as an Arabic number is has
+expression of \Macro{numexpr}. For output the value as an Arabic number has
to be prefixed by \Macro{the}.%
%
\EndIndex{Cmd}{XmodY}%
@@ -1203,7 +1453,7 @@ to be prefixed by \Macro{the}.%
%%% Local Variables:
%%% mode: latex
%%% mode: flyspell
-%%% ispell-local-dictionary: "english"
+%%% ispell-local-dictionary: "en_GB"
%%% coding: us-ascii
%%% TeX-master: "../guide.tex"
%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex
index b718bccf6f8..9fc393d423e 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrbookreportarticle-experts.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrbookreportarticle-experts.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -47,8 +47,10 @@
%
% ============================================================================
-\ProvidesFile{scrbookreportarticle-experts.tex}[2012/02/28 KOMA-Script guide
-(chapter: scrbook, scrreprt, scrartcl for experts)]
+\KOMAProvidesFile{scrbookreportarticle-experts.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl for
+ experts)]
\translator{Gernot Hassenpflug\and Markus Kohm}
@@ -64,14 +66,14 @@ This chapter gives additional information about the \KOMAScript{} classes
\Class{scrbook}, \Class{scrreprt}, and \Class{scrartcl}. Some of the features
are also available for package \Package{scrextend}. \iffree{Some parts of the
chapter are subject to the \KOMAScript{} book \cite{book:komascript}
- only. This shouldn't be a problem, because the}{The} average user, who only
-want to use the package, won't need the information, that is addressed to
+ only. This should not be a problem, because the}{The} average user, who only
+want to use the package, will not need the information, that is addressed to
users with non-standard requirements or who want to write their own classes
using a \KOMAScript{} class. Another part of the information describes features
of the classes that exist only because of compatibility to former
releases of \KOMAScript{} or the standard classes. The features, that exist
only because of compatibility to former \KOMAScript{} releases, are printed
-with a sans serif font. You shouldn't use them any longer.
+with a sans serif font. You should not use them any longer.
\LoadNonFree{scrbookreportarticle-experts}{0}
@@ -108,7 +110,7 @@ difference to this, \Macro{ClassName} tells which would be the standard class,
that has been replaced by a \KOMAScript{} class.
Please note\textnote{Attention!}, that the existence of
-\Macro{KOMAScript}\IndexCmd{KOMAScript} isn't a indication for the usage of a
+\Macro{KOMAScript}\IndexCmd{KOMAScript} is not a indication for the usage of a
\KOMAScript{} class. First of all: Every \KOMAScript{} package and not only
\KOMAScript{} classes define \Macro{KOMAScript}. Furthermore other packages
may also define the \KOMAScript{} word mark with this name.%
@@ -122,7 +124,7 @@ may also define the \KOMAScript{} word mark with this name.%
\end{Declaration}
\BeginIndex{Cmd}{addtocentrydefault}%
The\ChangedAt{v3.08}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} \KOMAScript{} classes don't use
+ \Class{scrartcl}} \KOMAScript{} classes do not use
\Macro{addcontentsline}\IndexCmd{addcontentsline}%
\important{\Macro{addcontentsline}} directly. Instead they
call \Macro{addtocentrydefault} with similar arguments. The command may be used
@@ -168,7 +170,7 @@ manipulate the entries. For example\textnote{Example} one could suggest
}%
}%
\end{lstcode}
-to omit entries with empty \PName{heading}. In real live this wouldn't be
+to omit entries with empty \PName{heading}. In real live this would not be
needed, because the \KOMAScript{} classes already use another method to
suppress empty entries. See the description of the structuring commands in
\autoref{sec:maincls.structure} from \autopageref{desc:maincls.cmd.part}
@@ -218,7 +220,7 @@ The prefix \File{scrsize} for file names of font size files, that has been
mentioned\iffree{ in \autoref{sec:maincls-experts.addInfos}}{} at
\autopageref{desc:maincls-experts.option.fontsize} is only the default of the
internal macro \Macro{@fontsizefilebase}\IndexCmd{@fontsizefilebase}. This
-default is used only, if the macro hasn't already be defined when loading a
+default is used only, if the macro has not already be defined when loading a
\KOMAScript{} class or package \Package{scrextend}. Authors of wrapper classes
may define this macro with another file name prefix to use completely
different font size files. Also\textnote{Hint!} authors of wrapper classes
@@ -569,7 +571,7 @@ the\,---\,list environment, that will be used for the bibliography. It should
be assumed, that many packages will execute this command in the same kind, if
they redefine the bibliography.
-The \KOMAScript{} classes do something similar. Nevertheless, they don't
+The \KOMAScript{} classes do something similar. Nevertheless, they do not
redefine \Macro{@openbib@code} at the end of the class. Instead of, the
bibliography style \PValue{openstyle} is defined using
\Macro{newbibstyle}. The \PName{instructions}, that has been defined as part
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex
index 08633a351a6..2d9a75f5718 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrbookreportarticle.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrbookreportarticle.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,11 +45,13 @@
%
% ============================================================================
-\ProvidesFile{scrbookreportarticle.tex}[2012/05/15 KOMA-Script guide (chapter:
-scrbook, scrreprt, scrartcl)]
+\KOMAProvidesFile{scrbookreportarticle.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl)]
+
\translator{Jens-Uwe Morawski\and Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi}
-% Date of translated german file: 2012-02-15
+% Date of translated german file: 2013-05-31
\chapter{The Main Classes: \Class{scrbook}, \Class{scrreprt}, and
\Class{scrartcl}}
@@ -188,160 +190,8 @@ class.%
\LoadCommon{5}% \section{Text Markup}
-The command \Macro{usekomafont} can change the current font specification to
-the one currently used with the specified \PName{element}.
-
-\begin{Example}
- \phantomsection\label{desc:maincls.setkomafont.example}%
- Assume that you want to use for the element \FontElement{captionlabel} the
- same font specification that is used with
- \FontElement{descriptionlabel}. This can be easily done with:
-\begin{lstcode}
- \setkomafont{captionlabel}{%
- \usekomafont{descriptionlabel}%
- }
-\end{lstcode}
- You can find other examples in the paragraphs on each element.
-\end{Example}
-
-\begin{desclist}
- \desccaption{%
- Elements whose type style can be changed with the {\KOMAScript} command
- \Macro{setkomafont} or
- \Macro{addtokomafont}\label{tab:maincls.elementsWithoutText}%
- }{%
- Elements whose type style can be changed (\emph{continuation})%
- }%
- \feentry{caption}{text of a table or figure caption (see
- \autoref{sec:maincls.floats}, \autopageref{desc:maincls.cmd.caption})}%
- \feentry{captionlabel}{label of a table or figure caption; used according to
- the element \FontElement{caption} (see \autoref{sec:maincls.floats},
- \autopageref{desc:maincls.cmd.caption})}%
- \feentry{chapter}{title of the sectional unit \Macro{chapter} (see
- \autoref{sec:maincls.structure}, \autopageref{desc:maincls.cmd.chapter})}%
- \feentry{chapterentry}{%
- table of contents entry of the sectional unit \Macro{chapter} (see
- \autoref{sec:maincls.toc},
- \autopageref{desc:maincls.cmd.tableofcontents})}%
- \feentry{chapterentrypagenumber}{%
- page number of the table of contents entry of the sectional unit
- \Macro{chapter}, variation on the element \FontElement{chapterentry} (see
- \autoref{sec:maincls.toc},
- \autopageref{desc:maincls.cmd.tableofcontents})}%
- \feentry{chapterprefix}{%
- chapter number line at setting \OptionValue{chapterprefix}{true} or
- \OptionValue{appendixprefix}{true} (see \autoref{sec:maincls.structure},
- \autopageref{desc:maincls.option.chapterprefix})}%
- \feentry{descriptionlabel}{labels, i.\,e., the optional argument of
- \Macro{item} in the \Environment{description} environment (see
- \autoref{sec:maincls.lists}, \autopageref{desc:maincls.env.description})}%
- \feentry{dictum}{dictum, wise saying, or smart slogan (see
- \autoref{sec:maincls.dictum}, \autopageref{desc:maincls.cmd.dictum})}%
- \feentry{dictumauthor}{author of a dictum, wise saying, or smart slogan;
- used according to the element \FontElement{dictumtext} (see
- \autoref{sec:maincls.dictum}, \autopageref{desc:maincls.cmd.dictum})}%
- \feentry{dictumtext}{another name for \FontElement{dictum}}%
- \feentry{disposition}{all sectional unit titles, i.\,e., the arguments of
- \Macro{part} down to \Macro{subparagraph} and \Macro{minisec}, including
- the title of the abstract; used before the element of the corresponding
- unit (see \autoref{sec:maincls.structure} ab
- \autopageref{sec:maincls.structure})}%
- \feentry{footnote}{footnote text and marker (see
- \autoref{sec:maincls.footnotes},
- \autopageref{desc:maincls.cmd.footnote})}%
- \feentry{footnotelabel}{mark of a footnote; used according to the element
- \FontElement{footnote} (see \autoref{sec:maincls.footnotes},
- \autopageref{desc:maincls.cmd.footnote})}%
- \feentry{footnotereference}{footnote reference in the text (see
- \autoref{sec:maincls.footnotes},
- \autopageref{desc:maincls.cmd.footnote})}%
- \feentry{footnoterule}{%
- horizontal rule\ChangedAt{v3.07}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} above the footnotes at the end of the text area (see
- \autoref{sec:maincls.footnotes},
- \autopageref{desc:maincls.cmd.setfootnoterule})}%
- \feentry{labelinglabel}{labels, i.\,e., the optional argument of
- \Macro{item} in the \Environment{labeling} environment (see
- \autoref{sec:maincls.lists}, \autopageref{desc:maincls.env.labeling})}%
- \feentry{labelingseparator}{separator, i.\,e., the optional argument of the
- \Environment{labeling} environment; used according to the element
- \FontElement{labelinglabel} (see \autoref{sec:maincls.lists},
- \autopageref{desc:maincls.env.labeling})}%
- \feentry{minisec}{title of \Macro{minisec} (see
- \autoref{sec:maincls.structure} ab
- \autopageref{desc:maincls.cmd.minisec})}%
- \feentry{pagefoot}{only used if package \Package{scrpage2} has been loaded
- (see \autoref{cha:scrpage},
- \autopageref{desc:scrpage.fontelement.pagefoot})}%
- \feentry{pagehead}{another name for \FontElement{pageheadfoot}}%
- \feentry{pageheadfoot}{the head of a page, but also the foot of a page (see
- \autoref{sec:maincls.pagestyle} ab \autopageref{sec:maincls.pagestyle})}%
- \feentry{pagenumber}{page number in the header or footer (see
- \autoref{sec:maincls.pagestyle})}%
- \feentry{pagination}{another name for \FontElement{pagenumber}}%
- \feentry{paragraph}{title of the sectional unit \Macro{paragraph} (see
- \autoref{sec:maincls.structure},
- \autopageref{desc:maincls.cmd.paragraph})}%
- \feentry{part}{title of the \Macro{part} sectional unit, without the line
- containing the part number (see \autoref{sec:maincls.structure},
- \autopageref{desc:maincls.cmd.part})}%
- \feentry{partentry}{%
- table of contents entry of the sectional unit \Macro{part} (see
- \autoref{sec:maincls.toc},
- \autopageref{desc:maincls.cmd.tableofcontents})}%
- \feentry{partentrypagenumber}{%
- Page number of the table of contents entry of the sectional unit
- \Macro{part} variation on the element \FontElement{partentry} (see
- \autoref{sec:maincls.toc},
- \autopageref{desc:maincls.cmd.tableofcontents})}%
- \feentry{partnumber}{line containing the part number in a title of the
- sectional unit \Macro{part} (see \autoref{sec:maincls.structure},
- \autopageref{desc:maincls.cmd.part})}%
- \feentry{section}{title of the sectional unit \Macro{section} (see
- \autoref{sec:maincls.structure}, \autopageref{desc:maincls.cmd.section})}%
- \feentry{sectionentry}{%
- table of contents entry of sectional unit \Macro{section} (only available
- in \Class{scrartcl}, see \autoref{sec:maincls.toc},
- \autopageref{desc:maincls.cmd.tableofcontents})}%
- \feentry{sectionentrypagenumber}{%
- page number of the table of contents entry of the sectional unit
- \Macro{section}, variation on element \FontElement{sectionentry} (only
- available in \Class{scrartcl, see \autoref{sec:maincls.toc},
- \autopageref{desc:maincls.cmd.tableofcontents}})}%
- \feentry{sectioning}{another name for \FontElement{disposition}}%
- \feentry{subject}{%
- categorization of the document, i.\,e., the argument of \Macro{subject} on
- the main title page (see \autoref{sec:maincls.titlepage},
- \autopageref{desc:maincls.cmd.subject})}%
- \feentry{subparagraph}{title of the sectional unit \Macro{subparagraph} (see
- \autoref{sec:maincls.structure},
- \autopageref{desc:maincls.cmd.subparagraph})}%
- \feentry{subsection}{title of the sectional unit \Macro{subsection} (see
- \autoref{sec:maincls.structure},
- \autopageref{desc:maincls.cmd.subsection})}%
- \feentry{subsubsection}{title of the sectional unit \Macro{subsubsection}
- (see \autoref{sec:maincls.structure},
- \autopageref{desc:maincls.cmd.subsubsection})}%
- \feentry{subtitle}{%
- subtitle of the document, i.\,e., the argument of \Macro{subtitle} on the
- main title page (see \autoref{sec:maincls.titlepage},
- \autopageref{desc:maincls.cmd.title})}%
- \feentry{title}{main title of the document, i.\,e., the argument of
- \Macro{title} (for details about the title size see the additional note in
- the text of \autoref{sec:maincls.titlepage} from
- \autopageref{desc:maincls.cmd.title})}%
-\end{desclist}
-%
-\EndIndex{Cmd}{setkomafont}%
-\EndIndex{Cmd}{addtokomafont}%
-\EndIndex{Cmd}{usekomafont}%
-%
-\EndIndex{}{font}%
-\EndIndex{}{text>markup}%
-
\LoadCommon{14} %\section{Document Titles}
-
\section{Abstract}
\label{sec:maincls.abstract}
\BeginIndex{}{summary}%
@@ -408,8 +258,8 @@ When using an in-page title\Index{title>in-page} (see option \Option{titlepage},
the abstract is set using the environment
\Environment{quotation}\IndexEnv{quotation} (see \autoref{sec:maincls.lists},
\autopageref{desc:maincls.env.quotation}) internally. Thereby paragraphs will
-be set with intention of the first line. If that first paragraph of the
-abstract should not be intended, this indent may be disabled using
+be set with indentation of the first line. If that first paragraph of the
+abstract should not be indented, this indent may be disabled using
\Macro{noindent}\IndexCmd{noindent}\important{\Macro{noindent}} \iffree{just
after \Macro{begin}\PParameter{abstract}}{at the begin of the environment}.%
%
@@ -662,7 +512,7 @@ macros \Macro{chapterlevel}, \Macro{sectionlevel}, and so on, down to
\Macro{subparagraphlevel}.
\begin{Example}
Assume that you are preparing an article that uses the sectional
- unit \Macro{subsubsection}. However, you don't want this sectional
+ unit \Macro{subsubsection}. However, you do not want this sectional
unit to appear in the table of contents. The preamble of your
document might contain the following:
\begin{lstcode}
@@ -723,7 +573,7 @@ rule.
These options have no effect with the page styles \PValue{empty} and
\PValue{plain}, because there is no header in this case. Such a line always
has the effect of visually bringing header and text body closer together. That
-doesn't mean that the header must now be moved farther from the text
+does not mean that the header must now be moved farther from the text
body. Instead, the header should be considered as belonging to the text body
for the purpose of page layout calculations. {\KOMAScript} takes this into
account by automatically passing the option \Option{headinclude} to the
@@ -1002,7 +852,7 @@ The page styles can be redefined with the \Macro{renewcommand} macro.
\renewcommand*{\chapterpagestyle}{plain}
\end{lstcode}
Instead of the above you may do a local redefinition using a group. The
- advantage will be that you don't need to know the current page style before
+ advantage will be that you do not need to know the current page style before
the change to switch back at the end.
\begin{lstcode}
\clearpage
@@ -1238,12 +1088,12 @@ starts, the option influences also the explicit usage of the commands
\Macro{cleardoublestandardpage}, \Macro{cleardoubleplainpage}, and
\Macro{cleardoubleemptypage}. See \autoref{sec:maincls.pagestyle},
\autopageref{desc:maincls.cmd.cleardoublepage} for more information
-about these. Since \LaTeX{} doesn't differentiate between left-hand
-and right-hand pages in single-sided printing, the option doesn't have
+about these. Since \LaTeX{} 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 \Class{scrartcl} the section is the first structural element below
-the part. Because of this, \Class{scrartcl} doesn't support this option.
+the part. Because of this, \Class{scrartcl} does not support this option.
%
\EndIndex{Option}{open~=\PName{method}}%
@@ -1414,7 +1264,7 @@ description of the structural commands.
structural commands \Macro{part} down to \Macro{subparagraph} will be
activated. By default the optional argument will be used for the running
head only.%
- \IndexOption{headings=~optiontohead}%
+ \IndexOption{headings~=\PValue{optiontohead}}%
}%
\entry{\PValue{optiontoheadandtoc}, \PValue{optiontotocandhead}%
\IndexOption{headings~=\PValue{optiontoheadandtoc}}}{%
@@ -1430,7 +1280,7 @@ description of the structural commands.
structural commands \Macro{part} down to \Macro{subparagraph} will be
activated. By default the optional argument will be used for the table of
contents only.%
- \IndexOption{headings=~optiontohead}%
+ \IndexOption{headings~=\PValue{optiontohead}}%
}%
\pventry{small}{%
Use small headings with small distances above and below.%
@@ -1578,13 +1428,13 @@ In addition to this, with\ChangedAt{v3.10}{\Class{scrbook}\and
classes} option \important{\Option{headings}}
\OptionValue{headings}{optiontohead}%
\IndexOption[indexmain]{headings~=\PValue{optiontohead}}, \KOMAScript{}
-doesn't use
+does not use
the optional argument \PName{short version} at the table of
contents, but for the running head only. Nevertheless, such a running head
needs an appropriate page style. See \autoref{sec:maincls.pagestyle} and
\autoref{cha:scrpage} about this. With option
\OptionValue{headings}{optiontotoc}%
-\IndexOption[indexmain]{headings~=\PValue{optiontotoc}}, \KOMAScript{} doesn't
+\IndexOption[indexmain]{headings~=\PValue{optiontotoc}}, \KOMAScript{} does not
use the
optional argument \PName{short version} for the running head, but
at the table of contents. Nevertheless, the entry will be shown only if
@@ -1594,7 +1444,7 @@ counter \Counter{tocdepth} (see \autoref{sec:maincls.toc},
\IndexOption[indexmain]{headings~=\PValue{optiontoheadandtoc}}, \KOMAScript{}
uses the optional argument \PName{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 \PName{short version}, which isn't
+interpretation of the optional argument \PName{short version}, which is not
active by default.
The \ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
@@ -2121,7 +1971,7 @@ horizontally centered instead of set ragged right. This is because command
\end{lstcode}
You may also redefine this using \Macro{renewcommand} too.
\begin{Example}
- You don't want different alignment at headings of \Macro{part}. So you
+ You do not want different alignment at headings of \Macro{part}. So you
put
\begin{lstcode}
\renewcommand*{\raggedpart}{\raggedsection}
@@ -2270,12 +2120,16 @@ Since chapters only exist in the classes \Class{scrbook} and
\begin{Declaration}
\Macro{chaptermark}\Parameter{running head}\\
+ \Macro{addchapmark}\Parameter{running head}\\
\Macro{sectionmark}\Parameter{running head}\\
+ \Macro{addsecmark}\Parameter{running head}\\
\Macro{subsectionmark}\Parameter{running head}\\
\Macro{chaptermarkformat}\\
\Macro{sectionmarkformat}\\
\Macro{subsectionmarkformat}
\end{Declaration}%
+\BeginIndex{Cmd}{addchapmark}%
+\BeginIndex{Cmd}{addsecmark}%
\BeginIndex{Cmd}{chaptermark}%
\BeginIndex{Cmd}{sectionmark}%
\BeginIndex{Cmd}{subsectionmark}%
@@ -2297,6 +2151,18 @@ Since chapters only exist in the classes \Class{scrbook} and
\Macro{chaptermarkformat}, \Macro{sectionmarkformat}, or
\Macro{subsectionmarkformat}.
+ Because\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} \KOMAScript{} provides additional commands
+ \Macro{addchap} and \Macro{addsec} to make headings without numbers, there
+ also exist corresponding commands for making the running heads of those.
+ Please note\textnote{Attention!}, that the predefined \Macro{addchapmark}
+ and \Macro{addsecmark} use \Macro{chaptermark} and
+ \Macro{sectionmark} while they set counter
+ \Counter{secnumdepth} to -1 locally. You should pay attention for this
+ exspecially if you redefine \Macro{chaptermark} or
+ \Macro{sectionmark}, e.\,g., you should also redefine \Macro{addchapmark}
+ and \Macro{addsecmark} suitable.
+
\OnlyAt{\Class{scrbook}\and\Class{scrreprt}}Of course there is no
command \Macro{chaptermark} or \Macro{chaptermarkformat} in
\Class{scrartcl}. \OnlyAt{\Class{scrartcl}}Accordingly,
@@ -2336,6 +2202,8 @@ As you can see, both the commands \Macro{chapappifchapterprefix} and
\EndIndex{Cmd}{chaptermarkformat}%
\EndIndex{Cmd}{sectionmarkformat}%
\EndIndex{Cmd}{subsectionmarkformat}%
+\EndIndex{Cmd}{addsecmark}%
+\EndIndex{Cmd}{addchapmark}%
\begin{Declaration}
@@ -2476,7 +2344,7 @@ classes. Instead of this, the math features of the \LaTeX{} kernel have been
supported. With this also, the options \Option{leqno} and \Option{fleqn} are
available.
-You won't find a description of the math environments of the \LaTeX{} kernel
+You will not find a description of the math environments of the \LaTeX{} kernel
here. If you want to use \Environment{displaymath}\IndexEnv{displaymath},
\Environment{equation}\IndexEnv{equation}, and
\Environment{eqnarray}\IndexEnv{eqnarray} you should read a short introduction
@@ -2493,7 +2361,7 @@ standard option \Option{leqno} causes the standard option file
\File{leqno.clo} to be loaded. The equations are then numbered on the
left. This\textnote{Attention!} option has to be used as an optional argument
of \Macro{documentclass}. Usage as an argument of \Macro{KOMAoptions} or
-\Macro{KOMAoption} is not supported. This wouldn't make sense, because the
+\Macro{KOMAoption} is not supported. This would not make sense, because the
recommended math package \Package{amsmath} supports the option at loading
time only too and would not react on run-time changes of the option.
%
@@ -2508,7 +2376,7 @@ standard option \Option{fleqn} causes the standard option file
\File{fleqn.clo} to be loaded. Displayed equations are then
left-justified. This option may be used as an optional argument of
\Macro{documentclass} but not as an argument of \Macro{KOMAoptions} or
-\Macro{KOMAoption}. The latter wouldn't make sense, because the recommended
+\Macro{KOMAoption}. The latter would not make sense, because the recommended
math package \Package{amsmath} supports the option at loading time only too
and would not react on run-time changes of the option.
%
@@ -2600,7 +2468,7 @@ Of course similar features exist\ChangedAt{v3.09}{\Class{scrbook}\and
\IndexOption{captions~=\PValue{figuresignature}}. Nevertheless,
figures like photos will be viewed as a whole, and a diagram or graph
will mostly be examined from left bottom to the right. Therefore, in
-general, signatures should be used and it wouldn't be useful to change
+general, signatures should be used and it would not be useful to change
the caption format from signatures to headings.
Nevertheless sometimes all floating environments shall use headings. For this
@@ -2630,7 +2498,7 @@ Furthermore, \KOMAScript{} supports to switch off the distinguish of captions
with only one line or more than one line using option
\OptionValue{captions}{nooneline}\IndexOption{captions~=\PValue{nooneline}}%
\important{\OptionValue{captions}{nooneline}}. This may be useful, if one-line
-captions shouldn't be centered. The default of centering one-line captions
+captions should not be centered. The default of centering one-line captions
corresponds to \OptionValue{captions}{oneline}.
Another special feature of \KOMAScript{} is to alternatively put the caption
@@ -3156,7 +3024,7 @@ e.\,g., using \Macro{raisebox}\IndexCmd{raisebox}.
placed on the inner side beside the figure. The figure itself is
shifted 2\Unit{em} into the outer margin.
- With \Macro{dimexp} a \eTeX{} command has been used. This shouldn't be a
+ With \Macro{dimexp} a \eTeX{} command has been used. This should not be a
problem at all, because \KOMAScript{} itself needs \eTeX{} and every almost
up-to-date \LaTeX{} distribution uses \eTeX already.
@@ -3606,13 +3474,13 @@ will become their final result.
Setting \OptionValue{listof}{entryprefix}\ChangedAt{v3.06}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}} will automatically activate
\OptionValue{listof}{flat}
-too. Normally\important{\OptionValue{listof}{entryprefix}} it wouldn't make
+too. Normally\important{\OptionValue{listof}{entryprefix}} it would not make
sense to add the prefix ``figure'' to each entry of the list of figures and
the prefix ``table'' to each entry of the list of tables, because nothing else
than figures would be and should be expected at the list of figures and
nothing else than tables would be and should be expected at the list of
-tables. So this prefixes wouldn't give any additional information and for this
-wouldn't be useful. Nevertheless, such prefixes may be added using option
+tables. So this prefixes would not give any additional information and for this
+would not be useful. Nevertheless, such prefixes may be added using option
\OptionValue{listof}{entryprefix}. With this all entries of the same list will
get the same prefix. The prefix will depend on the file extension of the
helper file, that will be used for the corresponding list. For the list of
@@ -3640,7 +3508,7 @@ with \OptionValue{listof}{nochaptergap}%
\IndexOption{listof~=\PValue{chapterentry}} is somehow special. Instead of a
gap it adds the table of contents entry for the chapter additionally to the
lists of floating environments. Please\textnote{Attention!} note, that this
-would also happen, if the chapter doesn't have any floating
+would also happen, if the chapter does not have any floating
environment. Additional influence of chapters to the lists of floating
environments is available with option \Option{chapteratlists}. See
\autoref{sec:maincls.structure},
@@ -3693,11 +3561,11 @@ An overview about all settings to option \Option{listof} may be found at
sectioning level than default.%
\IndexOption{listof~=\PValue{leveldown}}}%
\entry{\PValue{nochaptergap}, \PValue{ignorechapter}}{%
- Chapter starts won't be marked at the lists of floating environments.%
+ Chapter starts are not marked at the lists of floating environments.%
\IndexOption{listof~=\PValue{nochaptergap}}}%
\entry{\PValue{notoc}, \PValue{plainheading}}{%
The lists of floating environments, e.\,g., list of figures and list of
- tables, won't generate an entry at the table of contents.%
+ tables do not generate an entry at the table of contents.%
\IndexOption{listof~=\PValue{notoc}}}%
\entry{\PValue{numbered}, \PValue{totocnumbered}, \PValue{tocnumbered},
\PValue{numberedtotoc}}{%
@@ -3708,7 +3576,7 @@ An overview about all settings to option \Option{listof} may be found at
\entry{\PValue{totoc}, \PValue{toc}, \PValue{notnumbered}}{%
The lists of floating environments, e.\,g., list of figures and list of
tables, would generate an entry at the table of contents, but their
- headings won't be numbered.%
+ headings are not numbered.%
\IndexOption{listof~=\PValue{totoc}}}%
\end{desclist}
%
@@ -3863,6 +3731,17 @@ neither a number nor an entry to the table of contents and corresponds to
\PValue{nobibliography} to this option at
\autopageref{desc:maincls.option.toc.bibliography}.
+Sometimes\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} it is not usefull to have one bibliography for the whole
+document but a bibliography at every chapter of a document made using
+\Class{scrbook} or \Class{scrreprt}. In that case
+you'd\important{\OptionValue{bibliography=leveldown}} need the bibliography
+itself not to be a chapter but one level below, a section. You may achieve
+this using Option \OptionValue{bibliography}{leveldown}%
+\IndexOption{bibliography~=\PValue{leveldown}}. You may use this also if you'd
+combine several lists and the bibliography together below one heading. So this
+option is also available with \Class{scrartcl}.
+
A summary of all available values for option \Option{bibliography} may be
found in \autoref{tab:maincls.bibliography}. Nevertheless you should note,
that additional values may be generated using
@@ -3874,6 +3753,12 @@ that additional values may be generated using
of the bibliography}
\label{tab:maincls.bibliography}
\begin{desctabular}
+ \pventry{leveldown}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ The bibliography will use a heading of one step lower section level than
+ default.%
+ \IndexOption{bibliography~=\PValue{leveldown}}}%
\pventry{nottotoc}{%
The bibliography will neither have an entry at the table of contents nor
a number,%
@@ -3907,7 +3792,7 @@ that additional values may be generated using
\BeginIndex{Cmd}{setbibpreamble}%
The command \Macro{setbibpreamble} can be used to set a preamble for the
bibliography\Index{bibliography}. This can be achieved by placing the preamble
-before the command for issuing the bibliography. However, it needn't be
+before the command for issuing the bibliography. However, it need not be
directly in front of it. For example, it could be placed at the beginning of
the document. Similar\textnote{Attention!} to the options
\OptionValue{bibliography}{totoc} and
@@ -4001,10 +3886,10 @@ index hardly. This would be valid, e.\,g., for usage of package
The index is chapter (\Class{scrbook} or \Class{scrreprt}) or section
(\Class{scrartcl}) without heading number or entry at the table of contents by
default or option
-\OptionValue{index}{default}\IndexOption{index~=\PValue{default}}. The\important{\OptionValue{index}{totoc}} index
-doesn't need an entry at the table of contents, because it should always be
-the last element of a document. Nevertheless, such an entry may be achieved
-using option
+\OptionValue{index}{default}\IndexOption{index~=\PValue{default}}.
+The\important{\OptionValue{index}{totoc}} index does not need an entry at the
+table of contents, because it should always be the last element of a
+document. Nevertheless, such an entry may be achieved using option
\OptionValue{index}{totoc}\IndexOption{index~=\PValue{totoc}}. See also option
\Option{toc} with value \PValue{index} in \autoref{sec:maincls.toc} from
\autopageref{desc:maincls.option.toc.index} onward.
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex
index 39be1185e0f..82ec269a6aa 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrdatetime.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrdatetime.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,8 +45,9 @@
%
% ============================================================================
-\ProvidesFile{scrdatetime.tex}[{2012/02/23 KOMA-Script guide (chapter:
- scrdate, scrtime)}]
+\KOMAProvidesFile{scrdatetime.tex}
+ [$Date: 2013-12-13 12:13:03 +0100 (Fr, 13 Dez 2013) $
+ KOMA-Script guide (chapter: scrdate, scrtime)]
\translator{Markus Kohm\and Gernot Hassenpflug}
% Date of translated German file: 2012/02/23
@@ -88,7 +89,7 @@ The\ChangedAt{v3.05a}{\Package{scrdate}} command \Macro{CenturyPart} offers
the value of the century digits\,---\,hundreds and thousands\,---\,of a
\PName{year}. The command \Macro{DecadePart} in difference offers the other
digits which are the units and tens. The number of digits of \PName{year}
-doesn't care. The value may be assigned to a counter or may be used for
+does not care. The value may be assigned to a counter or may be used for
calculations, i.\,e., using \Macro{numexpr}\IndexCmd{numexpr}. For output of
an Arabic number of the value prefix it with \Macro{the}\IndexCmd{the}.
@@ -125,7 +126,7 @@ differ only in the kind of date declaration. Command \Macro{DayNumber} needs
\PName{year}, \PName{month}, and \PName{day} as separate parameters. Command
\Macro{ISODayNumber} expects an \PName{ISO-date} as a single argument. The
expected format of the \PName{ISO-date} is:
-\PName{year}\texttt{-}\PName{month}\texttt{-}\PName{day}. It doesn't matter
+\PName{year}\texttt{-}\PName{month}\texttt{-}\PName{day}. It does not matter
whether \PName{month} or \PName{day} have one or two digits. The result of
both commands may be assigned to a counter or used for calculations, i.\,e.,
using \Macro{numexpr}\IndexCmd{numexpr}. For output of
@@ -179,7 +180,7 @@ Wednesday\,=\,3, Thursday\,=\,4, Friday\,=\,5, and Saturday\,=\,6.%
\BeginIndex{Cmd}{DayNameByNumber}%
\BeginIndex{Cmd}{DayName}%
\BeginIndex{Cmd}{ISODayName}%
-Usually\ChangedAt{v3.05a}{\Package{scrdate}} you don't want to know the number
+Usually\ChangedAt{v3.05a}{\Package{scrdate}} you do not want to know the number
of the day of the week, but the name of the day of the week. Because of this,
the command \Macro{DayNameByNumber} offers the name of the day of the week
corresponding with a number. The number may be the result of \Macro{DayNumber}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrextend.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrextend.tex
index 05e7dea5eb5..5baf6701c96 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrextend.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrextend.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrextend.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrextend.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,10 +45,12 @@
%
% ======================================================================
-\ProvidesFile{scrextend.tex}[2012/02/16 KOMA-Script package scrextend]
+\KOMAProvidesFile{scrextend.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script package scrextend]
\translator{Markus Kohm}
-% Date of the translated German file: 2008/09/12
+% Date of the translated German file: 2013/05/31
\chapter{Making Basic Feature of the \KOMAScript{} Classes Available with
Package \Package{scrextend} while Using Other Classes}
@@ -62,7 +64,7 @@ classes \Class{book}, \Class{report}, and \Class{article}, but also for
several features of the \KOMAScript{} class \Class{scrlttr2}, the successor of
\Class{scrlettr}, that may be used for letters. These basic features, that may
be found in the above-named classes, are also provided by package
-\Package{scrextend} since \KOMAScript{} release~3.00. This package shouldn't
+\Package{scrextend} since \KOMAScript{} release~3.00. This package should not
be used together with a \KOMAScript{} class, but may be used together with
many other classes. Package \Package{scrextend} would recognize, if it would
be used with a \KOMAScript{} class, and would terminate with a warning message
@@ -86,7 +88,7 @@ In difference to the above, only the \KOMAScript{} classes \Class{scrbook},
\Class{scrreprt}, and \Class{scrartcl} load package \Package{tocbasic} (see
\autoref{cha:tocbasic} from \autopageref{cha:tocbasic}), that has been
designed to be used by authors of classes and packages too. Because of this
-\Package{scrextend} doesn't provide the features of this package. Nevertheless
+\Package{scrextend} does not provide the features of this package. Nevertheless
you may use \Package{tocbasic} together with \Package{scrextend}.%
\fi
@@ -157,31 +159,6 @@ argument of \Macro{usepackage}\OParameter{optional
\LoadCommon{5}% \section{Text Markup}
-With command \Macro{usekomafont} the current font style may be changed into
-the font style, that has been defined for the given \PName{element}.
-
-\begin{Example}
- Assumed, you want to print the document title in a serif font and with red
- color. You may do this using:
-\begin{lstcode}
- \setkomafont{title}{\color{red}}
-\end{lstcode}
- Package \Package{color} or \Package{xcolor} will be needed for command
- \lstinline|\color{red}|. The additional usage of \Macro{normalfont} is not
- needed in this case, because it is already part of the definition of the
- title itself. This\textnote{Attention!} example also needs option
- \OptionValue{extendedfeature}{title} (see
- \autoref{sec:scrextend.optionalFeatures},
- \autopageref{desc:scrextend.option.extendedfeature}).
-\end{Example}
-%
-\EndIndex{Cmd}{setkomafont}%
-\EndIndex{Cmd}{addtokomafont}%
-\EndIndex{Cmd}{usekomafont}%
-%
-\EndIndex{}{font>style}%
-\EndIndex{}{text>markup}
-
\LoadCommon{14} %\section{Document Title Pages}
\LoadCommon{7}% \section{Detection of Odd and Even Pages}
@@ -191,7 +168,7 @@ the font style, that has been defined for the given \PName{element}.
One of the basic features of a document is the page
style\Index[indexmain]{page>style}. Page style in \LaTeX{} means mainly header
-and footer of the page. Package \Package{scrextend} doesn't define any page
+and footer of the page. Package \Package{scrextend} does not define any page
style, but it uses and expects the definition some page styles.
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrhack.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrhack.tex
index fce50ee9fda..901ae104649 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrhack.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrhack.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrhack.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrhack.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ============================================================================
-\ProvidesFile{scrhack.tex}[2012/03/06 KOMA-Script guide (chapter: scrhack)]
+\KOMAProvidesFile{scrhack.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (chapter: scrhack)]
\translator{Markus Kohm}
% Date of the translated German file: 2011/10/07
@@ -71,13 +73,13 @@ been used by lot of users, there's one problem with it. While redefinition of
macros of foreign packages, it depend on the exact definition an usage of
those macros. This means additionally, that it depends on dedicated releases
of those packages. If a unknown release of such a package will be used,
-\Package{scrhack} eventually couldn't do the needed patch. Contrary, in
+\Package{scrhack} eventually could not do the needed patch. Contrary, in
extreme cases the patch may cause errors and fault.
So \Package{scrhack} has to be continuously modified to fit new releases of
foreign packages and will never be finished. Because of this \Package{scrhack}
will stay in beta state forever. Though the usage will generally be a
-benefit, the correct function couldn't be guaranteed forever.
+benefit, the correct function could not be guaranteed forever.
\LoadCommon{0}
@@ -105,7 +107,7 @@ will need a certain package loading order, though all these packages are not
related to each other. Wrong loading order may result in an error or break the
functionality of the commands.
-To clear all this disadvantages and problems, \KOMAScript{} officially doesn't
+To clear all this disadvantages and problems, \KOMAScript{} officially does not
support this old interface any more. Instead \KOMAScript{} warns, if the old
interface is used. At the same time package
\Package{tocbasic}\IndexPackage{tocbasic}\important{\Package{tocbasic}} (see
@@ -115,7 +117,7 @@ lists. Usage of this package provides much more advantages and features than
the two old commands, that has been alluded above.
Though the effort using that package is very small, the authors of most of the
-packages, that are using the old interface, haven't done so currently. Because
+packages, that are using the old interface, have not done so currently. Because
of this \Package{scrhack} contains appropriate modifications of packages
\Package{float}\IndexPackage{float}\important{\Package{float},
\Package{floatrow}, \Package{listings}},
@@ -144,7 +146,7 @@ Before version~6.79h package \Package{hyperref} set the link anchors after
instead of before the heading of star version commands like \Macro{part*},
\Macro{chapter*}, and so on. In the meantime this problem have been solved at
the \KOMAScript{} author's suggestion. But because the \KOMAScript{} author
-wasn't patient enough to wait more than a year for the change of
+was not patient enough to wait more than a year for the change of
\Package{hyperref}, a corresponding patch has been added to
\Package{scrhack}. This may be deactivated by
\OptionValue{hyperref}{false}. Nevertheless, it is recommended to use the
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-notecolumn.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-notecolumn.tex
new file mode 100644
index 00000000000..63606d0b3a6
--- /dev/null
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-notecolumn.tex
@@ -0,0 +1,317 @@
+\immediate\write17{^^J%
++----------------------------------------------------------------------^^J%
+| WARNING (`scrlayer-notecolumn.tex'):^^J%
++----------------------------------------------------------------------^^J%
+| YOU SHOULD NOTE, THAT THIS IS NOT AN OFFICIAL RELEASE!^^J%
+| THIS VERSION IS INTENDED TO BE USED FOR TESTING ONLY!^^J%
+| USAGE FOR PURPOSES OTHER THAN INTENDED IS DANGEROUS!^^J%
+| DON'T EXPECT ANY SUPPORT FOR THIS VERSION!^^J%
++----------------------------------------------------------------------^^J%
+}
+%%
+%% This is file `scrlayer-notecolumn.tex',
+%% generated with the docstrip utility, extended by scrdocstrip.
+%%
+%% The original source files were:
+%%
+%% scrlayer-notecolumn.dtx (with options: `doc')
+%%
+%% Copyright (c) 1994-2013 Markus Kohm [komascript at gmx info]
+%%
+%% This file was generated from file(s) of the KOMA-Script bundle.
+%% ---------------------------------------------------------------
+%%
+%% It may be distributed under the conditions of the
+%% LaTeX Project Public License in the version distributed together
+%% with KOMA-Script, see file `lppl.txt' or `lppl-de.txt'.
+%%
+%% This file may only be distributed together with a copy of the
+%% KOMA-Script bundle. You may however distribute the
+%% KOMA-Script bundle without all such generated files. See also
+%% `lppl.txt' or `lppl-de.txt' for additional information.
+%%
+%% The list of files belonging to KOMA-Script distribution is given in
+%% the file `manifest.txt'. See also `lppl.txt' or `lppl-de.txt' for
+%% additional information.
+%%
+%% If this file is a beta version, you may not be allowed to distribute
+%% it. Look at the comments below to see if this is the case.
+%%
+%% English and German manuals are part of KOMA-Script bundle.
+%% ----------------------------------------------------------
+%%
+%% See `README'.
+%%
+%% The KOMA-Script bundle (but maybe not this file) was based upon the
+%% LaTeX 2.09 Script family created by Frank Neukam 1993 and the LaTeX2e
+%% standard classes created by The LaTeX3 Project 1994-1996. You may
+%% find a complete unmodified copy of LaTeX2e at
+%% <http://www.ctan.org/pub/tex-archive/macros/latex/base/>.
+%%
+\ProvidesFile{scrlayer-notecolumn.tex}[%
+ 15/11/2013 v0.1.1514
+ (end user interface for scrlayer)]
+
+\chapter[{End User Interface \Package{scrlayer-notecolumn}}]{End User
+ Interface \Package{scrlayer-notecolumn}\footnote{This is not a translation
+ of the corresponding chapter of the German \KOMAScript{} manual but the
+ tentative and primary implementation manual of package
+ \Package{scrlayer-notecolumn}. As long as \Package{scrlayer-notecolumn} is
+ primary a proof of concept this doesn't matter. But nevertheless, a
+ German to English translator would still be welcome.}}
+\label{sec:scrlayer.notecolumn}
+\labelbase{scrlayer-notecolumn}
+
+Sometimes documents need an additional notes column beside the main text
+column and maybe beside the marginal note column. Problematicly may be
+having page breaks inside the notes column. This package provides a
+solution based on the layer interface of \Package{scrlayer}. You may
+define several notes columns, each of them with page breaks
+inside. It supports automatic page break inside of notes and recognises
+note collisions and solve them by moving notes.
+
+The idea of this package raised while an e-mail contact with Heiner
+Richter from FH~Stralsund, who told me of a book project, and asked
+whether or not such a functionality may be added to another package of
+mine easily. It couldn't, but design and implementation of a first test
+alpha of \Package{scrlayer-notecolumn} has been done in about three
+hours. So maybe it was a really good idea to ask me the question.
+
+\begin{Declaration}
+ \Macro{DeclareNoteColumn}%
+ \OParameter{option list}\Parameter{note column name}%
+ \\
+ \Macro{DeclareNewNoteColumn}%
+ \OParameter{option list}\Parameter{note column name}\\%^^A
+ \Macro{ProvideNoteColumn}%
+ \OParameter{option list}\Parameter{note column name}\\%^^A
+ \Macro{RedeclareNoteColumn}%
+ \OParameter{option list}\Parameter{note column name}%
+\end{Declaration}
+\BeginIndex{Cmd}{DeclareNoteColumn}%
+\BeginIndex{Cmd}{DeclareNewNoteColumn}%
+\BeginIndex{Cmd}{ProvideNoteColumn}%
+\BeginIndex{Cmd}{RedeclareNoteColumn}%
+Command \Macro{DeclareNoteColumn}
+may be used to declare a note column. Each note column is referenced by its
+name, defined by the obligatory argument \PName{note column name}. A note
+column vertically span the text area.
+
+By default its horizontal position is the current position of the marginal
+note column. It also regards \Macro{reversemarginpar} and
+\Macro{normalmarginpar}, while output of a note. Note that this is not the
+same like making a margin note. The default width is
+\Length{marginparwidth}. But you may use the optional argument \PName{option
+ list} to change this behaviour.
+
+The \PName{option list} is a comma-separated list of
+\texttt{\PName{key}=\PName{value}} options. Currently the following
+\PName{key}s are supported:
+\begin{labeling}[\ --]{\KOption{position}\PName{horizontal offset}}
+\item [\KOption{font}\PName{font declaration}] set the initial font attributes
+ to be used for the note column. Everything, that is allowed to be set by
+ \Macro{setkomafont} or \Macro{addtokomafont} can be used as
+ \PName{font declaration}. Note, that
+ \Macro{normalfont}\Macro{normalsize} will be used
+ before. So you don't need one of them at your own initialisation.
+\item [\Option{marginpar}] set up \Option{position} and \Option{width} to use
+ the marginal note column of \Macro{marginpar}.
+\item [\Option{normalmarginpar}] set up \Option{position} and \Option{width}
+ to use the normal marginal note column and ignore \Macro{reversemarginpar}
+ and \Macro{normalmarginpar}.
+\item [\KOption{position}\PName{horizontal offset}] set up the horizontal
+ offset of the note column from the left edge of the paper. The
+ \PName{horizontal offset} can be either a \LaTeX{} length, a \TeX{}
+ dimension, a \TeX{} skip, a length value, or a dimensional expression using
+ \texttt{+}, \texttt{-}, \texttt{*}, \texttt{/} and parenthesis (see
+ \cite[section~3.5]{manual:eTeX} for more information about dimensional
+ expressions). The value will be calculated at usage time not at definition
+ time. So you may even use more complex constructs like:
+\begin{lstcode}
+ \ifodd\value{page}
+ \oddsidemargin+1in
+ +\textwidth+\marginparsep
+ \else
+ \evensidemargin+1in
+ -\marginparsep
+ -\marginparwidth
+ \fi
+\end{lstcode}
+\item [\Option{reversemarginpar}] set up \Option{position} and \Option{width}
+ to use the reverse marginal note column and ignore \Macro{reversemarginpar}
+ and \Macro{normalmarginpar}.
+\item [\KOption{width}\PName{size}] set up the horizontal size of the note
+ column. You can use the same values for \PName{size} like for
+ \PName{horizontal offset} of option \Option{position}.
+\end{labeling}
+
+You may use as much note columns as \LaTeX{} provides free box registers,
+because every note column needs one box register. You may use package
+\Package{etex} to increase the normal amount of box registers from 256 to
+32768. This should be enough to avoid the ``\texttt{no room for
+ \Macro{newbox}}'' error.
+
+The implementation of note columns uses foreground layers from package
+\Package{scrlayer}. Every \Macro{DeclareNoteColumn} generates a layer and adds
+this layer to the pseudo page style \Pagestyle{@everystyle@}. Theoretically
+you may modify the generated layer, but it is recommended not to modify them.
+
+Overlapping of different note columns is allowed. There's one predefined note
+column named ``\texttt{marginpar}''.
+
+\BeginIndex{FontElement}{notecolumn.\PName{note column name}}%
+Note, that if you change the initial font using
+\begin{quote}
+ \Macro{setkomafont}\linebreak[1]\PParameter{marginnote.\PName{note column
+ name}}\Parameter{font declaration}
+\end{quote}
+or
+\begin{quote}
+ \Macro{addtokomafont}\linebreak[1]\PParameter{marginnote.\PName{note column
+ name}}\Parameter{font declaration}
+\end{quote}
+the font of all succeeding note column outputs would change. This could make it
+hard to find out, which notes will be affected by the change.
+See \autoref{sec:maincls.textmarkup},
+\autopageref{desc:maincls.cmd.setkomafont} for more information about
+\Macro{setkomafont} and \Macro{addtokomafont}.%
+\EndIndex{FontElement}{notecolumn.\PName{note column name}}%
+
+The difference between \Macro{DeclareNoteColumn} and the other commands is,
+that \Macro{DeclareNoteColumn} defines the note column independent whether a
+note column with the same name has already been defined or
+not. \Macro{DeclareNewNoteColumn} defined only note columns which names are
+not yet used for another note column. It's an error to use it with an already
+used \PName{note column name}. \Macro{ProvideNoteColumn} is like
+\Macro{DeclareNewNoteColumn}, but if the \PName{note column name} is already
+used for a note column nothing happens. \Macro{RedeclareNoteColumn} may be
+used to declare a note column with a name, that is already used. Using it with
+a new name is an error.
+\EndIndex{Cmd}{RedeclareNoteColumn}%^^A
+\EndIndex{Cmd}{ProvideNoteColumn}%^^A
+\EndIndex{Cmd}{DeclareNewNoteColumn}%^^A
+\EndIndex{Cmd}{DeclareNoteColumn}%^^A
+
+\begin{Declaration}
+ \Macro{makenote}%
+ \OParameter{note column name}\Parameter{note text}
+\end{Declaration}
+\BeginIndex{Cmd}{makenote}%
+This command
+may be used to make a new note. The note will be written to a helper file with
+extension \File{.slnc} in this run. In the next run, it will be
+typeset. Normally it will be typeset with the same vertical position, that
+would be used for a \Macro{parbox[t]}, but horizontally moved to the note
+column. Collisions at this position of this note column (but not of other note
+columns) will be recognised. In such a case the note may be moved down and
+even to another page. Automatic page breaks at the note columns are
+supported. This is something different to \Macro{marginpar},
+\Macro{marginline} (\KOMAScript{} classes), or \Macro{marginnote} (package
+\Package{marginnote}).
+
+Note, that after changing the document, at least two \LaTeX{} runs are needed
+to move the note to its final position.
+
+Note, that fragile commands should be protected to avoid error messages while
+writing or reading the helper file.
+
+Note, that \Package{scrlayer-notecolumn} needs only one helper file for all
+note columns together. You should not edit or change that helper file, because
+the syntax is fragile. It won't be read using \Macro{input} but
+\Macro{read}. Because of this, line breaks, empty lines and \Macro{par} should
+be avoided.
+
+Currently it is unknown where you may use \Macro{makenote} and where not. But
+you must not use \Macro{makenote} inside of \Macro{makenote}!
+
+The default for the optional argument \PName{makenote} is \PValue{marginpar},
+that is the \PName{note column name} of the pre-defined note column.
+\EndIndex{Cmd}{makenote}
+
+\begin{Declaration}
+ \KOption{autoclearnotecolumns}\PName{simple switch}\\
+ \Macro{clearnotecolumn}\OParameter{name of a note column}%
+ \\
+ \Macro{clearnotecolumns}\OParameter{list of note column names}
+\end{Declaration}
+\BeginIndex{Cmd}{clearnotcolumn}%
+\BeginIndex{Cmd}{clearnotcolumns}%
+The commands
+may be used to output all hanging notes for either one or several note
+columns. With \Macro{clearnotecolumn} only the notes of the note column with
+the given \PName{name of a note column} will be output. If you omit the
+optional argument (this is not the same like using an empty value!) note
+column \PValue{marginnote} will be used.
+
+With \Macro{clearnotecolumns} the notes of all note columns of the comma
+separated \PName{list of note column names} will be output. If you omit the
+optional Argument or if the optional Argument is empty (or start with
+\Macro{relax}) the notes of all note columns will be output.
+
+Macro \Macro{clearpage} will be used to output hanging notes and several
+\LaTeX{} runs may be needed to terminate with the correct number of
+\Macro{clearpage} for the whole document. You will get the message ``\LaTeX{}
+Warning: Label(s) may have changed. Rerun to get cross-references right.'' as
+long as the process hasn't been terminated.
+
+But normally you don't need to us \Macro{clearnotecolum} or
+\Macro{clearnotecolumns} yourself. Because by default option
+\Option{autoclearnotecolumns} is switched on, which means, that
+\Macro{clearnotecolumns} will be done at every \Macro{clearpage}. You may
+change this, switching off \Macro{autoclearnotecolumns} using one of the
+values for simple switches.
+
+Note, that it is not allowed to use \Macro{clearnotecolumn} or
+\Macro{clearnotecolumns} inside a note. You can use these commands only inside
+the main text of the document.%
+\EndIndex{Cmd}{clearnotcolumns}%
+\EndIndex{Cmd}{clearnotcolumn}%
+
+\begin{Declaration}
+ \Macro{syncwithnotecolumn}\OParameter{name of a note column}%
+ \\
+ \Macro{syncwithnotecolumns}\OParameter{list of note column names}%
+\end{Declaration}
+\BeginIndex{Cmd}{syncwithnotecolumn}%
+\BeginIndex{Cmd}{syncwithnotecolumns}%
+These commands
+may be used to synchronise the vertical position of the main text with one or
+several note columns. If you use the optional argument of
+\Macro{syncwithnotecolumn} it should be one \PName{name of a note column}. If
+you omit it, \PValue{marginpar} will be used as the \PName{name of a note
+ column}. Usage of \Macro{syncwithnotecolumn} is exactly the same like usage
+of \Macro{syncwithnotecolumns} with exactly one \PName{name of a note column}.
+
+The optional argument of \Macro{syncwithnotecolumns} is a comma-separated list
+of names of note columns. If you omit this optional argument or if you use an
+empty argument or if the argument starts with \Macro{relax} synchronisation
+will be done with all declared note columns.
+
+Synchronisation with a note column means, that the current position of the
+main text will be changed to be the current vertical position of the note
+column after cleaning the note column. This differs in several point from
+cleaning a note column:
+\begin{itemize}
+\item After cleaning a note column the text position would change to be at a
+ new page, even if the note column doesn't fill the whole page
+ before. Synchronisation will change the vertical position just after the
+ last vertical position of the note column.
+\item Cleaning a note column needs less \LaTeX{} runs than synchronising a
+ note column.
+\end{itemize}
+Both, cleaning an synchronising a note column, uses the label mechanism of
+\LaTeX{} without using \Macro{label}, \Macro{ref}, or \Macro{pageref} itself
+(but \Macro{newlabel}). So you should have a look at \LaTeX{} rerun messages,
+because of undefined or changed labels.
+
+Note, that it is not allowed to use \Macro{syncwithnotecolumn} or
+\Macro{syncwithnotecolumns} inside a note. If you do so, you need endless
+\LaTeX{} runs without reaching a final state. But synchronisation of several
+note columns in the main text of a document will also synchronise the notes
+columns with each others.%
+\EndIndex{Cmd}{syncwithnotecolumns}
+\EndIndex{Cmd}{syncwithnotecolumn}
+
+\endinput
+%%
+%% End of file `scrlayer-notecolumn.tex'.
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage-experts.tex
new file mode 100644
index 00000000000..ba5a99e60b3
--- /dev/null
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage-experts.tex
@@ -0,0 +1,660 @@
+% ======================================================================
+% scrlayer-scrpage-experts.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ----------------------------------------------------------------------
+% scrlayer-scrpage-experts.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ======================================================================
+%
+% Expert chapter about scrlayer-scrpage of the KOMA-Script guide
+%
+% ----------------------------------------------------------------------
+%
+% Expertenkapitel ueber scrlayer-scrpage in der KOMA-Script-Anleitung
+%
+% ============================================================================
+
+\KOMAProvidesFile{scrlayer-scrpage-experts.tex}%
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (chapter: scrlayer-scrpage-experts)]
+\translator{Markus Kohm}
+
+% Date version of the translated file: 2013-10-28
+
+\chapter[{Additional Features of \Package{scrlayer-scrpage}}]
+ {Additional Features\ChangedAt{v3.12}{\Package{scrlayer-scrpage}} with
+ package \Package{scrlayer-scrpage}}
+\labelbase{scrlayer-scrpage-experts}
+%
+\BeginIndex{Package}{scrlayer-scrpage}%
+Package \Package{scrlayer-scrpage} provides features that have not been
+described in \autoref{cha:scrlayer-scrpage} of \autoref{part:forAuthors} of this
+\iffree{user guide}{book}. But the most average user will not need those
+extensions and some of them are only implemented for compatibility with
+\Package{scrpage2}. So most users do not need to know them. Therefore all those
+things are described here in \autoref{part:forExperts} only.
+
+\section{Definition of new Pairs of Page Styles}
+\label{sec:scrlayer-scrpage.pagestyle.pairs}
+
+In \autoref{sec:scrlayer-scrpage.predefined.pagestyles} the page styles
+\Pagestyle{scrheadings} and \Pagestyle{plain.scrheadings} have been
+described. Those build quasi a pair of page styles, with
+\Pagestyle{scrheadings} as the main page style with running head and
+\Pagestyle{plain.scrheadings} as the corresponding \Pagestyle{plain} page
+style without running head but generally with pagination. Beside the
+configuration of these page styles, \Package{scrlayer-scrpage} provides also
+the feature of defining new such pairs of page styles. Thereby the name of the
+main page style, e.\,g., \Pagestyle{scrheadings}, is quasi the name of the
+pair of page styles.
+
+Most users will not need more than the predefined pair
+\Pagestyle{scrheadings}. So the commands of this section may be understood as
+an addition for special cases. And because each such case is very special,
+this section also lacks of handsome examples. Nevertheless, if the support
+will show me a real nice example in future, I perhaps could use it in
+future. Nevertheless, I'm almost sure that all such cases could also be
+solved using the predefined pair only.
+
+\begin{Declaration}
+ \Macro{defpairofpagestyles}%
+ \OParameter{parent pair}\Parameter{name}\Parameter{definition}\\
+ \Macro{newpairofpagestyles}%
+ \OParameter{parent pair}\Parameter{name}\Parameter{definition}\\
+ \Macro{renewpairofpagestyles}%
+ \OParameter{parent pair}\Parameter{name}\Parameter{definition}\\
+ \Macro{providepairofpagestyles}%
+ \OParameter{parent pair}\Parameter{name}\Parameter{definition}
+\end{Declaration}
+\BeginIndex{Cmd}{defpairofpagestyles}%
+\BeginIndex{Cmd}{newpairofpagestyles}%
+\BeginIndex{Cmd}{renewpairofpagestyle}%
+\BeginIndex{Cmd}{providepairofpagestyles}%
+With these commands you may define pairs of page styles similar to
+\Pagestyle{scrheadings} and \Pagestyle{plain.scrheadings}. Thereby
+\PName{name} is the name of the main page style that is similar to
+\Pagestyle{scrheadings}. The name of the corresponding \Pagestyle{plain} page
+style will be prefixed by \PValue{plain.} automatically. So \PName{name} is
+not only the name of the pair of page styles, but also the name of the main
+page style of that pair, while \PValue{plain.}\PName{name} is the name of the
+\Pagestyle{plain} page style of this pair.
+
+If the optional argument \PName{parent pair} is given, the settings of the
+pair of page styles with that name are the initial settings of the new pair of
+page styles. So the new pair inherits the configuration of the \PName{parent
+ pair}.
+
+While reading \autoref{sec:scrlayer-scrpage.predefined.pagestyles} you might
+have the impression that the commands of this section were related to
+\Pagestyle{scrheadings} and \Pagestyle{plain.scrheadings} only. Nevertheless,
+this is only as long true, as this is the only existing pair of page
+styles. As soon as there exist more pairs of page styles, they are related to
+the pair that has been activated last. In fact, this is the case for \Macro{lehead}, \Macro{cehead}, \Macro{rehead}, \Macro{lohead},
+\Macro{cohead}, \Macro{rohead}, \Macro{lefoot}, \Macro{cefoot},
+\Macro{refoot}, \Macro{lofoot}, \Macro{cofoot}, \Macro{rofoot}, \Macro{ihead},
+\Macro{chead}, \Macro{ohead}, \Macro{ifoot}, \Macro{cfoot}, and \Macro{ofoot}
+from \autoref{sec:scrlayer-scrpage.predefined.pagestyles}.
+
+All those commands and the below described commands \Macro{clearmainofpairofpagestyles}, \Macro{clearplainofpairofpagestyles}, and
+\Macro{clearpairofpagestyles} are also mentioned to be used inside the
+argument \PName{definition}. In that case, they are a kind of default
+configuration of the pair of page styles that will be executed each time the
+pair will be activated. A pair of page styles will be activated, if one of the
+page styles of the pair will be activated. This will be done mostly using
+\Macro{pagestyle}\IndexCmd{pagestyle}.
+
+Please note that the commands of
+\autoref{sec:scrlayer-scrpage.pagestyle.content} are for general purpose,
+anyway. So they are related to every page style that has been defined using
+\Package{scrlayer-scrpage}.
+
+Whereas \Macro{defpairofpagestyles} will define a pair independent whether or
+not the corresponding page styles are already defined, will
+\Macro{newpairofpagestyles} and \Macro{providepairofpagestyles} define the pair
+only, if the page styles are currently undefined. If at least one of the page
+styles is already defined, the new definition of
+\Macro{providepairofpagestyles} will be ignored, but usage of
+\Macro{newpairofpagestyles} would result in an error message. To redefine
+already existing pairs of page styles you may use
+\Macro{renewpairofpagestyles}. With this an error would be thrown, if at least
+one of the page styles of the pair does not already exist.%
+\EndIndex{Cmd}{providepairofpagestyles}%
+\EndIndex{Cmd}{renewpairofpagestyles}%
+\EndIndex{Cmd}{newpairofpagestyles}%
+\EndIndex{Cmd}{defpairofpagestyles}%
+
+\begin{Declaration}
+ \Macro{clearmainofpairofpagestyles}\\
+ \Macro{clearplainofpairofpagestyles}\\
+ \Macro{clearpairofpagestyles}
+\end{Declaration}
+\BeginIndex{Cmd}{clearmainofpairofpagestyles}%
+\BeginIndex{Cmd}{clearplainofpairofpagestyles}%
+\BeginIndex{Cmd}{clearpairofpagestyles}%
+Command \Macro{clearmainofpairofpagestyles} will configure the main page style
+of the lastly activated pair of page styles to be empty. In contrast to this
+\Macro{clearplainofpairofpagestyles} will configure the \Pagestyle{plain} page
+style of the lastly activated pair of page styles to be empty. Last but not
+least \Macro{clearpairofpagestyle} will configure both page styles of the
+lastly activated pair of page styles to be empty.
+
+But please note\textnote{Attention!} that none of these commands will remove
+the definitions of argument \PName{definition} that has been used when
+defining the pair of page styles (see above). So if you activate the pair of
+page styles again, those definitions will be used again!
+
+These commands may be used inside of \PName{definition} themselves. But you
+may use them outside the definition of a pair of page styles too. In this case
+they are related to the lastly activated pair of page styles.
+
+\BeginIndex{Cmd}{clearscrheadings}%
+\BeginIndex{Cmd}{clearscrplain}%
+\BeginIndex{Cmd}{clearscrheadfoot}%
+The commands \Macro{clearscrheadings}, \Macro{clearscrplain}, and
+\Macro{clearscrheadfoot} are aliases for these commands that have been
+implemented for compatibility with \Package{scrpage2} only. Nevertheless, they
+are deprecated and should not be used any longer.%
+\EndIndex{Cmd}{clearscrheadfoot}%
+\EndIndex{Cmd}{clearscrplain}%
+\EndIndex{Cmd}{clearscrheadings}%
+%
+\EndIndex{Cmd}{clearpairofpagestyles}%
+\EndIndex{Cmd}{clearplainofpairofpagestyles}%
+\EndIndex{Cmd}{clearmainofpairofpagestyles}%
+
+
+\section{Definition of Simple Page Styles with Three Parts in Head and Foot }
+\label{sec:scrlayer-scrpage.pagestyle.triple}
+
+Beside predefined page styles and beside the definition of new pairs of page
+styles, package \Package{scrlayer-scrpage} also provides the Definition of
+page styles with three parts in head and foot. But this user interface exists
+for compatibility with \Package{scrpage2} only. Nevertheless, it has been
+extended to have a more consistent set of commands in difference to
+\Package{scrpage2}. However, for new documents it is recommended to use the
+advanced features that have been described in the previous section, instead
+of the commands of this section.
+
+\begin{Declaration}
+ \Macro{deftriplepagestyle}%
+ \Parameter{name of the page style}\\
+ \hphantom{\XMacro{deftriplepagestyle}}%
+ \OParameter{thickness of the outer line}%
+ \OParameter{thickness of the inner line}\\
+ \hphantom{\XMacro{deftriplepagestyle}}%
+ \Parameter{inner head element}%
+ \Parameter{centre head element}%
+ \Parameter{outer head element}\\
+ \hphantom{\XMacro{deftriplepagestyle}}%
+ \Parameter{inner foot element}%
+ \Parameter{centre foot element}%
+ \Parameter{outer foot element}\\
+ \Macro{newtriplepagestyle}%
+ \Parameter{name of the page style}\\
+ \hphantom{\XMacro{newtriplepagestyle}}%
+ \OParameter{thickness of the outer linen}%
+ \OParameter{thickness of the inner linen}\\
+ \hphantom{\XMacro{newtriplepagestyle}}%
+ \Parameter{inner head element}%
+ \Parameter{centre head element}%
+ \Parameter{outer head element}\\
+ \hphantom{\XMacro{newtriplepagestyle}}%
+ \Parameter{inner foot element}%
+ \Parameter{centre foot element}%
+ \Parameter{outer foot element}\\
+ \Macro{renewtriplepagestyle}%
+ \Parameter{name of the page style}\\
+ \hphantom{\XMacro{renewtriplepagestyle}}%
+ \OParameter{thickness of the outer line}%
+ \OParameter{thickness of the inner line}\\
+ \hphantom{\XMacro{renewtriplepagestyle}}%
+ \Parameter{inner head element}%
+ \Parameter{centre head element}%
+ \Parameter{outer head element}\\
+ \hphantom{\XMacro{renewtriplepagestyle}}%
+ \Parameter{inner foot element}%
+ \Parameter{centre foot element}%
+ \Parameter{outer foot element}\\
+ \Macro{providetriplepagestyle}%
+ \Parameter{name of the page style}\\
+ \hphantom{\XMacro{providetriplepagestyle}}%
+ \OParameter{thickness of the outer line}%
+ \OParameter{thickness of the inner line}\\
+ \hphantom{\XMacro{providetriplepagestyle}}%
+ \Parameter{inner head element}%
+ \Parameter{centre head element}%
+ \Parameter{outer head element}\\
+ \hphantom{\XMacro{providetriplepagestyle}}%
+ \Parameter{inner foot element}%
+ \Parameter{centre foot element}%
+ \Parameter{outer foot element}
+\end{Declaration}
+\BeginIndex{Cmd}{deftriplepagestyle}%
+\BeginIndex{Cmd}{newtriplepagestyle}%
+\BeginIndex{Cmd}{renewtriplepagestyle}%
+\BeginIndex{Cmd}{providetriplepagestyle}%
+With these commands you can define a single page style, whose head and foot are
+parted into three elements: an inner element, a centre element, and an outer
+element. The contents of the elements are given three mandatory arguments for
+the head and three mandatory arguments for the foot.
+
+Each of the two inner elements will be printed right aligned on left pages and
+left aligned on right pages. The centre elements will be printed centred in
+the head respectively foot of left and right pages. Each of the two outer
+elements will be printed left aligned on left pages and right aligned on right
+pages.
+
+Please remember once again:\textnote{Attention!} There are only right pages in
+single side layout!
+
+The two optional arguments can be used to activate horizontal lines in the
+head and foot of the page style. To do so, you put the wanted thickness of the
+line as an optional argument. The first optional argument is the
+\PName{thickness of the outer line} in both, the page head and footer. In the
+page head it will be printed above the head contents. In the page footer it
+will be printed below the foot contents. The second optional argument is the
+\PName{thickness of the inner line}. This will be printed below the page head
+and additionally above the page footer. If you have only one optional
+argument, this is the \PName{thickness of the inner line}. In this case no
+outer line will be printed. And if you omit both optional arguments, both
+lines will be omitted.
+
+Please note\textnote{Attention!} that an empty optional argument is not the
+same like omitting the optional argument! Empty optional arguments are not
+allowed in this case. But you may use simple dimension expressions for the
+optional arguments, like they have been explained for \KOMAScript{} option
+\Option{headwidth} (see \autoref{sec:scrlayer-scrpage.pagestyle.content},
+\autopageref{desc:scrlayer-scrpage.option.headwidth}).
+
+The meaning of the arguments is also shown in
+\autoref{fig:scrlayer-scrpage.triplepagestyle} for an schematic double
+page. Thereby ``\texttt{outer}'', ``\texttt{inner}'', and ``\texttt{centre}''
+are example contents. The corresponding arrows illustrate the expansion of
+those contents. The \iffree{coloured }{}texts inside the pages are only the
+names of the arguments of these commands. The related arrows \iffree{in
+ the same colour }{} point to the corresponding elements of the page.
+
+\begin{figure}
+ \centering
+ \begin{picture}(\textwidth,80mm)
+ \put(0,50mm){%
+ %\
+ \begin{picture}(\textwidth,30mm)(0,-10mm)
+ \thinlines
+ \small
+ % linke Seite
+ \put(0,20mm){\line(1,0){.49\textwidth}}%
+ \put(0,0){\line(0,1){20mm}}%
+ \multiput(0,0)(0,-1mm){10}{\line(0,-1){.5mm}}%
+ \put(.49\textwidth,5mm){\line(0,1){15mm}}%
+ \put(.05\textwidth,15mm){\thicklines\line(1,0){.415\textwidth}}%
+ \put(.05\textwidth,10mm){\makebox(0em,5mm)[l]{\slshape outer\strut$\longrightarrow$}}%
+ \put(.465\textwidth,10mm){\makebox(0em,5mm)[r]{\slshape $\longleftarrow$inner\strut}}%
+ \put(.2575\textwidth,10mm){\makebox(0em,5mm)[c]{\slshape $\longleftarrow$centre\strut$\longrightarrow$}}%
+ \put(.05\textwidth,10mm){\thicklines\line(1,0){.415\textwidth}}%
+ % rechte Seite
+ \put(0.51\textwidth,20mm){\line(1,0){.49\textwidth}}%
+ \put(0.51\textwidth,5mm){\line(0,1){15mm}}%
+ \multiput(\textwidth,0)(0,-1mm){10}{\line(0,-1){.5mm}}%
+ \put(\textwidth,0mm){\line(0,1){20mm}}%
+ \put(.535\textwidth,15mm){\thicklines\line(1,0){.415\textwidth}}%
+ \put(.535\textwidth,10mm){\makebox(0em,5mm)[l]{\slshape inner\strut$\longrightarrow$}}%
+ \put(.95\textwidth,10mm){\makebox(0em,5mm)[r]{\slshape $\longleftarrow$outer\strut}}%
+ \put(.7425\textwidth,10mm){\makebox(0em,5mm)[c]{\slshape $\longleftarrow$centre\strut$\longrightarrow$}}%
+ \put(.535\textwidth,10mm){\thicklines\line(1,0){.415\textwidth}}%
+ % commands for both pages
+ \iffree{\color{red}}{}%
+ \put(.5\textwidth,0){\makebox(0,\baselineskip)[c]{\PName{inner head element}}}%
+ \put(.5\textwidth,-5mm){\makebox(0,\baselineskip)[c]{\PName{centre
+ head element}}}%
+ \put(.5\textwidth,-10mm){\makebox(0,\baselineskip)[c]{\PName{outer
+ head element}}}%
+ \put(\dimexpr.5\textwidth-2em,.5\baselineskip){%
+ \put(-1.5em,.5\baselineskip){\vector(0,1){7mm}}%
+ \put(-3.5em,-1\baselineskip){\line(-1,0){\dimexpr .25\textwidth-6.5em\relax}}%
+ \put(-\dimexpr
+ .25\textwidth-3em\relax,-1\baselineskip){\vector(0,1){\dimexpr
+ 7mm+1.5\baselineskip\relax}}
+ \put(-3.25em,-2.25\baselineskip){\line(-1,0){\dimexpr .45\textwidth-8em\relax}}%
+ \put(-\dimexpr
+ .45\textwidth-4.75em\relax,-2.25\baselineskip){\vector(0,1){\dimexpr
+ 7mm+2.75\baselineskip\relax}}
+ }%
+ \put(\dimexpr.5\textwidth+2em,.5\baselineskip){%
+ \put(1.5em,.5\baselineskip){\vector(0,1){7mm}}%
+ \put(3.5em,-1\baselineskip){\line(1,0){\dimexpr .25\textwidth-6.5em\relax}}
+ \put(\dimexpr
+ .25\textwidth-3em\relax,-1\baselineskip){\vector(0,1){\dimexpr
+ 7mm+1.5\baselineskip\relax}}
+ \put(3.25em,-2.25\baselineskip){\line(1,0){\dimexpr .45\textwidth-8em\relax}}
+ \put(\dimexpr
+ .45\textwidth-4.75em\relax,-2.25\baselineskip){\vector(0,1){\dimexpr
+ 7mm+2.75\baselineskip\relax}}
+ }%
+ \end{picture}
+ %
+ }%
+ \put(0,0){%
+ \begin{picture}(\textwidth,30mm)
+ \thinlines
+ \small
+ % linke Seite
+ \put(0,0){\line(1,0){.49\textwidth}}%
+ \put(0,0){\line(0,1){20mm}}%
+ \multiput(0,20mm)(0,1mm){10}{\line(0,1){.5mm}}%
+ \put(.49\textwidth,0){\line(0,1){15mm}}%
+ \put(.05\textwidth,15mm){\thicklines\line(1,0){.415\textwidth}}%
+ \put(.05\textwidth,10mm){\makebox(0em,5mm)[l]{\slshape outer\strut$\longrightarrow$}}%
+ \put(.465\textwidth,10mm){\makebox(0em,5mm)[r]{\slshape $\longleftarrow$inner\strut}}%
+ \put(.2575\textwidth,10mm){\makebox(0em,5mm)[c]{\slshape $\longleftarrow$centre\strut$\longrightarrow$}}%
+ \put(.05\textwidth,10mm){\thicklines\line(1,0){.415\textwidth}}%
+ % rechte Seite
+ \put(.51\textwidth,0){\line(1,0){.49\textwidth}}%
+ \put(.51\textwidth,0){\line(0,1){15mm}}%
+ \put(\textwidth,0){\line(0,1){20mm}}%
+ \multiput(\textwidth,20mm)(0,1mm){10}{\line(0,1){.5mm}}%
+ \put(.535\textwidth,15mm){\thicklines\line(1,0){.415\textwidth}}%
+ \put(.535\textwidth,10mm){\makebox(0em,5mm)[l]{\slshape inner\strut$\longrightarrow$}}%
+ \put(.95\textwidth,10mm){\makebox(0em,5mm)[r]{\slshape $\longleftarrow$outer\strut}}%
+ \put(.7425\textwidth,10mm){\makebox(0em,5mm)[c]{\slshape $\longleftarrow$centre\strut$\longrightarrow$}}%
+ \put(.535\textwidth,10mm){\thicklines\line(1,0){.415\textwidth}}%
+ % commands for both pages
+ \iffree{\color{red}}{}%
+ \put(.5\textwidth,20mm){\makebox(0,\baselineskip)[c]{\PName{inner foot
+ element}}}%
+ \put(.5\textwidth,25mm){\makebox(0,\baselineskip)[c]{\PName{centre
+ foot element}}}%
+ \put(.5\textwidth,30mm){\makebox(0,\baselineskip)[c]{\PName{outer foot
+ element}}}%
+ \put(\dimexpr.5\textwidth-2em,.5\baselineskip){%
+ \put(-1.5em,\dimexpr 20mm-.5\baselineskip\relax){\vector(0,-1){6mm}}%
+ \put(-3.5em,25mm){\line(-1,0){\dimexpr .25\textwidth-6.5em\relax}}%
+ \put(-\dimexpr .25\textwidth-3em\relax,25mm){\vector(0,-1){\dimexpr
+ .5\baselineskip + 11mm\relax}}%
+ \put(-3em,30mm){\line(-1,0){\dimexpr .45\textwidth-7.5em\relax}}%
+ \put(-\dimexpr .45\textwidth-4.5em\relax,30mm){\vector(0,-1){\dimexpr
+ .5\baselineskip + 16mm\relax}}%
+ }%
+ \put(\dimexpr.5\textwidth+2em,.5\baselineskip){%
+ \put(1.5em,\dimexpr 20mm-.5\baselineskip\relax){\vector(0,-1){6mm}}%
+ \put(3.5em,25mm){\line(1,0){\dimexpr .25\textwidth-6.5em\relax}}%
+ \put(\dimexpr .25\textwidth-3em\relax,25mm){\vector(0,-1){\dimexpr
+ .5\baselineskip + 11mm\relax}}%
+ \put(3em,30mm){\line(1,0){\dimexpr .45\textwidth-7.5em\relax}}%
+ \put(\dimexpr .45\textwidth-4.5em\relax,30mm){\vector(0,-1){\dimexpr
+ .5\baselineskip + 16mm\relax}}%
+ }%
+ \end{picture}
+ }%
+ \thinlines\small\iffree{\color{blue}}{}%
+ \put(0.055\textwidth,45mm){\vector(0,1){25mm}}%
+ \put(0.945\textwidth,45mm){\vector(0,1){25mm}}%
+ \put(0.055\textwidth,45mm){\vector(0,-1){30mm}}%
+ \put(0.945\textwidth,45mm){\vector(0,-1){30mm}}%
+ \put(0.055\textwidth,45mm){\line(1,0){\dimexpr
+ .445\textwidth-7.5em\relax}}%
+ \put(0.945\textwidth,45mm){\line(-1,0){\dimexpr
+ .445\textwidth-7.5em\relax}}%
+ \put(0.5\textwidth,45mm){\makebox(0,0)[c]{\PName{thickness of the inner lines}}}%
+ \iffree{\color{green}}{}%
+ \put(0.025\textwidth,40mm){\line(0,1){35mm}}%
+ \put(0.025\textwidth,75mm){\vector(1,0){3.75mm}}%
+ \put(0.975\textwidth,40mm){\line(0,1){35mm}}%
+ \put(0.975\textwidth,40mm){\line(0,1){35mm}}%
+ \put(0.975\textwidth,75mm){\vector(-1,0){3.75mm}}%
+ \put(0.025\textwidth,40mm){\line(0,-1){30mm}}%
+ \put(0.025\textwidth,10mm){\vector(1,0){3.75mm}}%
+ \put(0.975\textwidth,40mm){\line(0,-1){30mm}}%
+ \put(0.975\textwidth,40mm){\line(0,-1){30mm}}%
+ \put(0.975\textwidth,10mm){\vector(-1,0){3.75mm}}%
+ \put(0.025\textwidth,40mm){\line(1,0){\dimexpr
+ .475\textwidth-7.5em\relax}}%
+ \put(0.975\textwidth,40mm){\line(-1,0){\dimexpr
+ .475\textwidth-7.5em\relax}}%
+ \put(0.5\textwidth,40mm){\makebox(0,0)[c]{\PName{thickness of the outer lines}}}%
+ \end{picture}
+ \caption[{Elements of a three parts page style}]{Schematic double page with
+ the elements of a tripartite page style of commands
+ \Macro{deftriplepagestyle}, \Macro{newtriplepagestyle},
+ \Macro{providetriplepagestyle}, and \Macro{renewtriplepagestyle}}
+ \label{fig:scrlayer-scrpage.triplepagestyle}
+\end{figure}
+
+With the commands that are described here, it is not possible to activate only
+a single line, e.\,g., only below the page head but not above the page
+footer. If you need so, you should either use the commands of the previous or
+the following section.
+
+The length of a single element\textnote{Attention!} is not limited by the
+existence of a neighbour element. So in inappropriate circumstances it can
+happen that one elements overwrites a neighbour element or even both of
+them. The user himself is responsible to avoid such inappropriate cases. With
+automatic running heads this could, e.\,g., be done using the optional
+argument of the section commands. See the manual of the document class for
+more information about those commands.
+
+Command \Macro{deftriplepagestyle} defines a page style independent from
+whether or not a page style with the same \PName{name of the page style}
+already exists. In difference to this \Macro{newtriplepagestyle} and
+\Macro{providetriplepagestyle} define the page style only, if the \PName{name
+ of the page style} is not the name of an already defined page
+style. Otherwise \Macro{providepagestyle} will simply do nothing, but
+\Macro{newtriplepagestyle} would throw an error. Command
+\Macro{renewtriplepagestyle} is something like the opposite of
+\Macro{newtriplepagestyle}. It would throw an error, if there has not been
+a page style with the \PName{name of the page style} before, and defines the
+page style only, if there has been already a page style with the given name.
+
+\BeginIndex{Cmd}{deftripstyle}%
+The command \Macro{deftriplestyle} of \Package{scrpage2} conforms to
+\Macro{deftriplepagestyle}. Because of unification reasons it has been renamed
+and should not be used with it's old name any longer. Using the old name would
+result in a warning message. Nevertheless, the result would be the expected
+one.%
+\EndIndex{Cmd}{deftripstyle}%
+\EndIndex{Cmd}{providetriplepagestyle}%
+\EndIndex{Cmd}{renewtriplepagestyle}%
+\EndIndex{Cmd}{newtriplepagestyle}%
+\EndIndex{Cmd}{deftriplepagestyle}%
+
+
+\section{Definition of Complex Page Styles}
+\label{sec:scrlayer-scrpage.pagestyle.experts}
+
+Beside predefined page styles and the definition of new pairs of page styles,
+and beside the definition of page styles with tripartite head and foot that
+are not recommended any longer, package \Package{scrlayer-scrpage} provides
+also a more basic features to define new page styles. All already described
+page style definitions of \Package{scrlayer-scrpage} use internally these basic
+features. Because of the complexity of this user interface it is recommended
+for advanced users only. Less advanced users should be able to reach almost all
+using one of the previously described features. So less advanced users do not
+need to read this section.
+
+\begin{Declaration}
+ \Macro{defpagestyle}%
+ \Parameter{name}\Parameter{head definition}\Parameter{foot definition}\\
+ \Macro{newpagestyle}%
+ \Parameter{name}\Parameter{head definition}\Parameter{foot definition}\\
+ \Macro{providepagestyle}%
+ \Parameter{name}\Parameter{head definition}\Parameter{foot definition}\\
+ \Macro{renewpagestyle}%
+ \Parameter{name}\Parameter{head definition}\Parameter{foot definition}%
+\end{Declaration}
+\BeginIndex{Cmd}{defpagestyle}%
+\BeginIndex{Cmd}{newpagestyle}%
+\BeginIndex{Cmd}{providepagestyle}%
+\BeginIndex{Cmd}{renewpagestyle}%
+These commands can be used to define a single page style with maximum
+flexibility. Thereby \PName{name} is the name of the page style that should
+be defined.
+
+The arguments \PName{head definition} and \PName{foot definition} have
+identical structure:
+\begin{quote}\raggedright
+ \texttt{%
+ (\PName{length of the line above},\PName{thickness of the line above})\%\\
+ \Parameter{definition for the left page in two-side layout}\%\\
+ \Parameter{definition for the right page in two-side layout}\%\\
+ \Parameter{definition for all pages in one-side laypout}\%\\
+ (\PName{length of the line below},\PName{thickness of the line below})%
+ }
+\end{quote}
+Thereby the arguments in the round brackets are options, this means, you may
+omit them together with the brackets. In that case, the length and thickness
+of the corresponding horizontal line would be given by the \KOMAScript{}
+options \Option{headtopline}, \Option{headsepline}, \Option{footsepline} or
+\Option{footbotline} (see \autoref{sec:scrlayer-scrpage.pagestyle.content},
+\autopageref{desc:scrlayer-scrpage.option.headtopline}).
+
+All three definition arguments are mandatory and will be used depending on the
+page and the layout settings. The contents of the definitions are
+arbitrary. But for page styles with running heads usage of \Macro{headmark},
+\Macro{leftmark}, or \Macro{rightmark} is recommended inside the
+definition. In no case section numbers or section headings should be used in
+the definition. Ignoring this could result in wrong numbers or texts in the
+page head or footer, because of the asynchronous page building of \LaTeX{}.
+
+Command \Macro{defpagestyle} will define the page style independent from
+whether or not a page style with the same \PName{name} already exists. Command
+\Macro{newpagestyle} would throw an error, if such a page style already
+exists. In difference to this, \Macro{providepagestyle} will simple do nothing
+in such a case. In opposite to \Macro{newpagestyle} command
+\Macro{renewpagestyle} would throw the error, if a page style with the
+\PName{name} does not already exist, and therefore may be used to redefine an
+existing page style.
+
+All these commands base on command \Macro{DeclareLayerPageStyle} of package
+\Package{scrlayer} internally. Thereby for a page style \PName{Name} the
+layer \PName{Name}\PValue{.head.above.line} will be defined for the horizontal
+line above the page head, the layer \PName{Name}\PValue{.head.odd} will be
+defined for the page head of odd pages in two-side layout,
+\PName{Name}\PValue{.head.even} will be defined for the page head of even pages
+in two-side layout, \PName{Name}\PValue{.head.oneside} will be defined for the
+page head of all pages in one-side layout, \PName{Name}\PValue{.head.below}
+will be defined for the horizontal line below the page head,
+\PName{Name}\PValue{.foot.above.line} will be defined for the horizontal line
+above the page foot, \PName{Name}\PValue{.foot.odd} will be defined for the
+page foot of odd pages in two-side layout, \PName{Name}\PValue{.foot.even} for
+the page foot of even pages in two-side layout,
+\PName{Name}\PValue{.foot.oneside} for the page foot of all pages in one-side
+layout, and last but not least \PName{Name}\PValue{.foot.below} for the
+horizontal line below the page foot. More information about layers and layer
+page styles can be found from \autopageref{cha:scrlayer} in
+\autoref{cha:scrlayer} also in \autoref{part:forExperts}.%
+%
+\begin{Example}
+ Assume you want to background the whole head of page style
+ \Pagestyle{scrheadings} with a colour. Because you read the introduction to
+ this chapter, you know, that \Pagestyle{scrheadings} last but not least is a
+ layer page style with, e.\,g., layers \PValue{scrheadings.head.even},
+ \PValue{scrheadings.head.odd}, and \PValue{scrheadings.head.oneside}. So you
+ define three more layers for the backgrounds and add them at the very
+ beginning of the page style:
+\begin{lstcode}
+ \documentclass{scrartcl}
+ \usepackage[automark]{scrlayer-scrpage}
+ \usepackage{xcolor}
+ \usepackage{blindtext}
+ \DeclareLayer[clone=scrheadings.head.oneside,
+ contents={%
+ \color{yellow}\rule[-\dp\strutbox]{\layerwidth}{\layerheight}%
+ }%
+ ]{scrheadings.head.oneside.background}
+ \DeclareLayer[clone=scrheadings.head.odd,
+ contents={%
+ \color{yellow}\rule[-\dp\strutbox]{\layerwidth}{\layerheight}%
+ }%
+ ]{scrheadings.head.odd.background}
+ \DeclareLayer[clone=scrheadings.head.even,
+ contents={%
+ \color{yellow}\rule[-\dp\strutbox]{\layerwidth}{\layerheight}%
+ }%
+ ]{scrheadings.head.even.background}
+ \AddLayersAtBeginOfPageStyle{scrheadings}{%
+ scrheadings.head.oneside.background,%
+ scrheadings.head.odd.background,%
+ scrheadings.head.even.background%
+ }
+ \pagestyle{scrheadings}
+ \begin{document}
+ \blinddocument
+ \end{document}
+\end{lstcode}
+ As you can see, the example uses three layers, so the position and size of
+ that background layers may simply be copied from the corresponding head
+ layer using option \Option{clone}. This is much easier than using only one
+ background layer and dynamically calculate the position time by time.
+
+ The coloured background have been printed using a \Macro{rule} command in
+ this example. The size arguments of this \Macro{rule} are given by
+ \Macro{layerwidth} and \Macro{layerheight} which contain the current width
+ and height of the layer itself. The optional argument of \Macro{rule} has
+ been used to move the rule down by the height of a descender.
+\end{Example}
+%
+Instead of using new layers for the background colours like in the example
+above, \Macro{colorbox} and \Macro{chead} could have been used. It is
+recommended to build such a solution as an exercise. Another change could be
+to add the background layers one by one and just before the contents
+layers. You may do this as an exercise too.%
+\EndIndex{Cmd}{renewpagestyle}%
+\EndIndex{Cmd}{providepagestyle}%
+\EndIndex{Cmd}{newpagestyle}%
+\EndIndex{Cmd}{defpagestyle}%
+
+\begin{Declaration}
+ \KOption{hmode}\PValue{simple switch}
+\end{Declaration}
+\BeginIndex{Option}{hmode}%
+Package \Package{scrpage2} outputs page heads and page foots in horizontal
+mode always. In opposite to this \Package{scrlayer-scrpage} does not switch
+into horizontal mode itself, but the output of horizontal material will do
+so. Nevertheless, you can activate option \Option{hmode} to make
+\Package{scrlayer-scrpage} more compatible with \Package{scrpage2} in this
+aspect. But this would have implications to, i.\,e., white
+spaces at the start of the output or the vertical alignment of the output.
+
+The options knows the standard values for simple switches that are given at
+\autoref{tab:truefalseswitch} on \autopageref{tab:truefalseswitch}. The option
+is deactivated by default.%
+\EndIndex{Option}{hmode}%
+%
+\EndIndex{Package}{scrlayer-scrpage}%
+
+%%% Local Variables:
+%%% mode: latex
+%%% mode: flyspell
+%%% coding: us-ascii
+%%% ispell-local-dictionary: "en_GB"
+%%% TeX-master: "../guide"
+%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage.tex
new file mode 100644
index 00000000000..34d3a727741
--- /dev/null
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer-scrpage.tex
@@ -0,0 +1,1128 @@
+% ======================================================================
+% scrlayer-scrpage.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ----------------------------------------------------------------------
+% scrlayer-scrpage.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ======================================================================
+%
+% Chapter about scrlayer-scrpage of the KOMA-Script guide
+%
+% ----------------------------------------------------------------------
+%
+% Kapitel ueber scrlayer-scrpage in der KOMA-Script-Anleitung
+%
+% ============================================================================
+
+\KOMAProvidesFile{scrlayer-scrpage.tex}%
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (chapter: scrlayer-scrpage)]
+\translator{Markus Kohm\and Jana Schubert\and Jens H\"uhne}
+
+% Date version of the translated file: 2013-11-15
+
+\chapter[{Adapting Page Headers and Footers with \Package{scrlayer-scrpage}}]
+ {Adapting\ChangedAt{v3.12}{\Package{scrlayer-scrpage}} Page Headers and
+ Footers with \Package{scrlayer-scrpage}}
+\labelbase{scrlayer-scrpage}
+%
+\BeginIndex{Package}{scrlayer-scrpage}%
+
+Until version 3.11b of \KOMAScript, package \Package{scrpage2} has been the
+recommended way to customise page headers and footers beyond the options
+provided by the page styles \Pagestyle{headings}, \Pagestyle{myheadings},
+\Pagestyle{plain}, and \Pagestyle{empty} of the standard \KOMAScript{}
+classes. Until 2001 there was also package \Package{scrpage} as a supported
+solution for the same purpose. It was then made obsolete and in 2013, more
+than ten years later, it was finally removed from the regular
+\KOMAScript~distribution.
+
+In 2013 package \Package{scrlayer}\IndexPackage{scrlayer} became a basic
+module of \KOMAScript. That package provides a layer scheme and a new page
+style scheme based upon the layer scheme. Nevertheless, the flexibility it
+provides and the resulting complexity may be too demanding for the average
+user to handle. More about \Package{scrlayer} may be found in
+\autoref{cha:scrlayer} of \autoref{part:forExperts}. Potential problems with
+the controllability of \Package{scrlayer} apart, there are lots of users who
+are already familiar with the user interface of package \Package{scrpage2}.
+
+As a consequence the additional package \Package{scrlayer-scrpage} provides a
+user interface, which is largely compatible with \Package{scrpage2} and based
+on \Package{scrlayer}. Thus, if you are already familiar with \Package{scrpage2}
+and refrain from using dirty tricks, like calling internal commands of
+\Package{scrpage2} directly, it should be easy for you to use
+\Package{scrlayer-scrpage} as a drop-in replacement. Most examples covering
+\Package{scrpage2} in \LaTeX{} books or online resources should also work
+with \Package{scrlayer-scrpage} either directly or with only minor
+code changes provided that they stick to the standard interfaces.
+
+Apart from the aforementioned \KOMAScript{} packages, you could in principle
+also use \Package{fancyhdr}\IndexPackage{fancyhdr} (see
+\cite{package:fancyhdr}) in conjunction with a \KOMAScript{} class. However,
+\Package{fancyhdr}\ has no support for several \KOMAScript{} features, e.\,g.,
+the element scheme (see \Macro{setkomafont}, \Macro{addtokomafont}, and
+\Macro{usekomafont} in \autoref{sec:maincls.textmarkup}, from
+\autopageref{desc:maincls.cmd.setkomafont}) or the configurable numbering
+format for dynamic headers (see option \Option{numbers} and, e.\,g.,
+\Macro{chaptermarkformat} in \autoref{sec:maincls.structure},
+\autopageref{desc:maincls.option.numbers} and
+\autopageref{desc:maincls.cmd.chaptermarkformat}). Hence, if you are using a
+\KOMAScript{} class, the usage of package \Package{scrlayer-scrpage} is
+recommended. Of course you can use \Package{scrlayer-scrpage} with other
+classes, namely the \LaTeX{} standard classes, too.
+
+Besides the features described in this chapter, \Package{scrlayer-scrpage}
+provides several more that are likely only of minor interest to the average
+user and for this reason are described from
+\autopageref{cha:scrlayer-scrpage-experts} onwards in
+\autoref{cha:scrlayer-scrpage-experts} of \autoref{part:forExperts}.
+Nevertheless, should the options described in \autoref{part:forAuthors} be
+insufficient for your purposes you are encouraged to examine
+\autoref{cha:scrlayer-scrpage-experts}.
+
+\LoadCommon{0} % \section{Early or late Selection of Options}
+
+\LoadCommon{20} % \section{Head and Foot Width}
+
+\section{Usage of Predefined Page Styles}
+\label{sec:scrlayer-scrpage.predefined.pagestyles}
+
+The easiest way to get a requested design of page head and foot with
+\Package{scrlayer-scrpage} is the usage of a predefined page style.
+
+\begin{Declaration}
+ \Pagestyle{scrheadings}\\
+ \Pagestyle{plain.scrheadings}
+\end{Declaration}
+\BeginIndex{Pagestyle}{scrheadings}%
+\BeginIndex{Pagestyle}{plain.scrheadings}%
+Package \Package{scrlayer-scrpage} provides two page styles that may be
+reconfigured depending on your own requests. Let's first of all talk about
+page style \Pagestyle{scrheadings} which has been designed to be used with
+running heads. Its defaults are similar to the page style
+\Pagestyle{headings}\IndexPagestyle{headings} of \LaTeX's standard classes or
+the \KOMAScript{} classes. The commands and options that may be used to
+configure the exact contents of the header and footer will be described
+consecutively.
+
+Second there's page style \Pagestyle{plain.scrheadings} which has been
+designed to be used without any running head. Its defaults are very similar to
+page style \Pagestyle{plain}\IndexPagestyle{plain} of \LaTeX's standard
+classes or the \KOMAScript{} classes. Once more the commands and options that
+may be used to configure the exact contents of the header and footer will be
+described consecutively.
+
+Fore sure, you could configure \Pagestyle{scrheadings} to be a page style
+without a running head and \Pagestyle{plain.scrheadings} to be a page style
+with running heads. Nevertheless, it is more useful to fit the conventions
+declared above, mainly, because both page styles influence each other. If you
+select one of these page styles, \Pagestyle{scrheadings} will become
+accessible as \Pagestyle{headings} and the page style
+\Pagestyle{plain.scrheadings} will become accessible as \Pagestyle{plain}. So,
+if you have a class or package that automatically switches between
+\Pagestyle{headings} and \Pagestyle{plain}, you need to select
+\Pagestyle{scrheadings} or \Pagestyle{plain.scrheadings} only once and then
+the class or package will switch between \Pagestyle{scrheadings} and
+\Pagestyle{plain.scrheadings} without even knowing these page styles. Patches
+or other adaptions of classes (or packages) will not be necessary. So these page
+styles are something like a pair that may be used as a drop-in replacement
+for \Pagestyle{headings} and \Pagestyle{plain}.
+
+At this point I'd like to mention that for compatibility with
+\Package{scrpage2} page style \Pagestyle{plain.scrheadings} can also be used
+with the alias name \Pagestyle{scrplain}\IndexPagestyle[indexmain]{scrplain}.
+%
+\EndIndex{Pagestyle}{plain.scrheadings}%
+\EndIndex{Pagestyle}{scrheadings}%
+
+\begin{Declaration}
+ \Macro{lehead}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}\\
+ \Macro{cehead}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}\\
+ \Macro{rehead}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}\\
+ \Macro{lohead}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}\\
+ \Macro{cohead}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}\\
+ \Macro{rohead}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}
+\end{Declaration}
+\BeginIndex{Cmd}{lehead}%
+\BeginIndex{Cmd}{cehead}%
+\BeginIndex{Cmd}{rehead}%
+\BeginIndex{Cmd}{lohead}%
+\BeginIndex{Cmd}{cohead}%
+\BeginIndex{Cmd}{rohead}%
+The contents of the header of page style \Pagestyle{plain.scrheadings} and
+\Pagestyle{scrheadings} can be defined using these commands. Thereby the
+optional argument defines the content of an element of page style
+\Pagestyle{plain.scrheadings}, while the mandatory argument sets the content
+of the corresponding element of page style \Pagestyle{scrheadings}.
+
+Contents of left\,---\,so called even\,---\,pages can be set with
+\Macro{lehead}, \Macro{cehead}, and \Macro{rohead}. Remark: The ``\texttt{e}''
+at the second position of the commands' names means ``\emph{even}''.
+
+Contents of right\,---\,so called odd\,---\,pages can be set with
+\Macro{lohead}, \Macro{cohead}, and \Macro{rohead}. Remark: The ``\texttt{o}''
+at the second position of the commands' names means ``\emph{odd}''.
+
+Please note\textnote{Attention!} that there are only odd pages within single
+side layouts independent of whether or not they have an odd page number.
+
+Each header consists of a left aligned element that will be defined by
+\Macro{lehead} respectively \Macro{lohead}. Remark: The ``\texttt{l}'' at the
+first position of the commands' names means ``\emph{left aligned}''.
+
+Similarly each header has a centred element that will be defined by
+\Macro{cehead} respectively \Macro{cohead}. Remark: The ``\texttt{c}'' at the
+first position of the command' names means ``\emph{centred}''.
+
+Similarly each header has a right aligned element that will be defined by
+\Macro{rehead} respectively \Macro{rohead}. Remark: The ``\texttt{r}'' at the
+first position of the commands' names means ``\emph{right aligned}''.
+
+\BeginIndex{FontElement}{pagehead}%
+\BeginIndex{FontElement}{pageheadfoot}%
+However, these elements do not have their own font attributes that may be
+changed using commands \Macro{setkomafont} and \Macro{addtokomafont} (see
+\autoref{sec:maincls.textmarkup}, \autopageref{desc:maincls.cmd.setkomafont}),
+but are grouped in an element named \FontElement{pagehead}. And before the
+font of that element additionally the font of element
+\FontElement{pageheadfoot} will be used. See
+\autoref{tab:scrlayer-scrpage.fontelements} for the font default of these
+elements.%
+\EndIndex{FontElement}{pageheadfoot}%
+\EndIndex{FontElement}{pagehead}%
+
+\begin{desclist}
+ \desccaption[{Elements of \Package{scrlayer-scrpage} whose type style can be
+ changed with \KOMAScript{} command \Macro{setkomafont} or
+ \Macro{addtokomafont}}]%
+ {Elements of \Package{scrlayer-scrpage} whose type style can be changed with
+ \KOMAScript{} command \Macro{setkomafont} or \Macro{addtokomafont} and the
+ default of those, if they have not been defined before loading
+ \Package{scrlayer-scrpage}%
+ \label{tab:scrlayer-scrpage.fontelements}%
+ }%
+ {Elements whose type style can be changed (\emph{continuation})}%
+ \feentry{footbotline}{%
+ Horizontal line below the footer of a page style defined using
+ \Package{scrlayer-scrpage}. The font will be used after
+ \Macro{normalfont}\IndexCmd{normalfont} and the fonts of elements
+ \FontElement{pageheadfoot}\IndexFontElement{pageheadfoot} and
+ \FontElement{pagefoot}\FontElement{pagefoot}. It is recommended to use
+ this element for colour changes only.\par
+ Default: \emph{empty}%
+ }%
+ \feentry{footsepline}{%
+ Horizontal line above the footer of a page style defined using
+ \Package{scrlayer-scrpage}. The font will be used after
+ \Macro{normalfont}\IndexCmd{normalfont} and the fonts of elements
+ \FontElement{pageheadfoot}\IndexFontElement{pageheadfoot} and
+ \FontElement{pagefoot}\FontElement{pagefoot}. It is recommended to use
+ this element for colour changes only.\par
+ Default: \emph{empty}%
+ }%
+ \feentry{headsepline}{%
+ Horizontal line below the header of a page style defined using
+ \Package{scrlayer-scrpage}. The font will be used after
+ \Macro{normalfont}\IndexCmd{normalfont} and the fonts of elements
+ \FontElement{pageheadfoot}\IndexFontElement{pageheadfoot} and
+ \FontElement{pagehead}\FontElement{pagehead}. It is recommended to use
+ this element for colour changes only.\par
+ Default: \emph{empty}%
+ }%
+ \feentry{headtopline}{%
+ Horizontal line above the header of a page style defined using
+ \Package{scrlayer-scrpage}. The font will be used after
+ \Macro{normalfont}\IndexCmd{normalfont} and the fonts of elements
+ \FontElement{pageheadfoot}\IndexFontElement{pageheadfoot} and
+ \FontElement{pagehead}\FontElement{pagehead}. It is recommended to use
+ this element for colour changes only.\par
+ Default: \emph{empty}%
+ }%
+ \feentry{pagefoot}{%
+ Contents of the page footer of a page style defined using
+ \Package{scrlayer-scrpage}. The font will be used after
+ \Macro{normalfont}\IndexCmd{normalfont} and the font of element
+ \FontElement{pageheadfoot}\IndexFontElement{pageheadfoot}.\par
+ Default: \emph{empty}%
+ }%
+ \feentry{pagehead}{%
+ Contents of the page header of a page style defined using
+ \Package{scrlayer-scrpage}. The font will be used after
+ \Macro{normalfont}\IndexCmd{normalfont} and the font of element
+ \FontElement{pageheadfoot}\IndexFontElement{pageheadfoot}.\par
+ Default: \emph{empty}%
+ }%
+ \feentry{pageheadfoot}{%
+ Contents of the page header or footer of a page style defined using
+ \Package{scrlayer-scrpage}. The font will be used after
+ \Macro{normalfont}\IndexCmd{normalfont}.\par
+ Default: \Macro{normalcolor}\Macro{slshape}%
+ }%
+ \feentry{pagenumber}{%
+ Pagination set with \Macro{pagemark}. If you redefine \Macro{pagemark},
+ you have to take care that your redefinition also uses
+ \Macro{usekomafont}\PParameter{pagenumber}!\par
+ Default: \Macro{normalfont}%
+ }%
+\end{desclist}
+%
+The semantics of the described commands within two-sided layouts are also
+sketched in \autoref{fig:scrlayer-scrpage.head}.%
+%
+\begin{figure}[tp]
+ \centering
+ \begin{picture}(\textwidth,30mm)(0,-10mm)
+ \thinlines
+ \small\ttfamily
+ % left/even page
+ \put(0,20mm){\line(1,0){.49\textwidth}}%
+ \put(0,0){\line(0,1){20mm}}%
+ \multiput(0,0)(0,-1mm){10}{\line(0,-1){.5mm}}%
+ \put(.49\textwidth,5mm){\line(0,1){15mm}}%
+ \put(.05\textwidth,10mm){%
+ \iffree{\color{red}}{}%
+ \put(-.5em,0){\line(1,0){4em}}%
+ \multiput(3.5em,0)(.25em,0){5}{\line(1,0){.125em}}%
+ \put(-.5em,0){\line(0,1){\baselineskip}}%
+ \put(-.5em,\baselineskip){\line(1,0){4em}}%
+ \multiput(3.5em,\baselineskip)(.25em,0){5}{\line(1,0){.125em}}%
+ \makebox(4em,5mm)[l]{\Macro{lehead}}%
+ }%
+ \put(.465\textwidth,10mm){%
+ \iffree{\color{blue}}{}%
+ \put(-4em,0){\line(1,0){4em}}%
+ \multiput(-4em,0)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(0,0){\line(0,1){\baselineskip}}%
+ \put(-4em,\baselineskip){\line(1,0){4em}}%
+ \multiput(-4em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-4.5em,0){\makebox(4em,5mm)[r]{\Macro{rehead}}}%
+ }%
+ \put(.2525\textwidth,10mm){%
+ \iffree{\color{green}}{}%
+ \put(-2em,0){\line(1,0){4em}}%
+ \multiput(2em,0)(.25em,0){5}{\line(1,0){.125em}}%
+ \multiput(-2em,0)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-2em,\baselineskip){\line(1,0){4em}}%
+ \multiput(2em,\baselineskip)(.25em,0){5}{\line(1,0){.125em}}%
+ \multiput(-2em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-2em,0){\makebox(4em,5mm)[c]{\Macro{cehead}}}%
+ }%
+ % right/odd page
+ \put(.51\textwidth,20mm){\line(1,0){.49\textwidth}}%
+ \put(.51\textwidth,5mm){\line(0,1){15mm}}%
+ \put(\textwidth,0){\line(0,1){20mm}}%
+ \multiput(\textwidth,0)(0,-1mm){10}{\line(0,-1){.5mm}}%
+ \put(.5325\textwidth,10mm){%
+ \iffree{\color{blue}}{}%
+ \put(0,0){\line(1,0){4em}}%
+ \multiput(4em,0)(.25em,0){5}{\line(1,0){.125em}}%
+ \put(0,0){\line(0,1){\baselineskip}}%
+ \put(0em,\baselineskip){\line(1,0){4em}}%
+ \multiput(4em,\baselineskip)(.25em,0){5}{\line(1,0){.125em}}%
+ \put(.5em,0){\makebox(4em,5mm)[l]{\Macro{lohead}}}%
+ }%
+ \put(.965\textwidth,10mm){%
+ \iffree{\color{red}}{}%
+ \put(-4em,0){\line(1,0){4em}}%
+ \multiput(-4em,0)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(0,0){\line(0,1){\baselineskip}}%
+ \put(-4em,\baselineskip){\line(1,0){4em}}%
+ \multiput(-4em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-4.5em,0){\makebox(4em,5mm)[r]{\Macro{rohead}}}%
+ }%
+ \put(.75\textwidth,10mm){%
+ \iffree{\color{green}}{}%
+ \put(-2em,0){\line(1,0){4em}}%
+ \multiput(2em,0)(.25em,0){5}{\line(1,0){.125em}}%
+ \multiput(-2em,0)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-2em,\baselineskip){\line(1,0){4em}}%
+ \multiput(2em,\baselineskip)(.25em,0){5}{\line(1,0){.125em}}%
+ \multiput(-2em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-2em,0){\makebox(4em,5mm)[c]{\Macro{cohead}}}%
+ }%
+ % commands for both pages
+ \iffree{\color{blue}}{}%
+ \put(.5\textwidth,0){\makebox(0,\baselineskip)[c]{\Macro{ihead}}}%
+ \iffree{\color{green}}{}%
+ \put(.5\textwidth,-5mm){\makebox(0,\baselineskip)[c]{\Macro{chead}}}
+ \iffree{\color{red}}{}%
+ \put(.5\textwidth,-10mm){\makebox(0,\baselineskip)[c]{\Macro{ohead}}}
+ \put(\dimexpr.5\textwidth-2em,.5\baselineskip){%
+ \iffree{\color{blue}}{}%
+ \put(0,0){\line(-1,0){1.5em}}%
+ \put(-1.5em,0){\vector(0,1){5mm}}%
+ \iffree{\color{green}}{}%
+ \put(0,-1.25\baselineskip){\line(-1,0){\dimexpr .25\textwidth-2em\relax}}%
+ \put(-\dimexpr
+ .25\textwidth-2em\relax,-1.25\baselineskip){\vector(0,1){\dimexpr
+ 5mm+1.25\baselineskip\relax}}
+ \iffree{\color{red}}{}%
+ \put(0,-2.5\baselineskip){\line(-1,0){\dimexpr .45\textwidth-4em\relax}}%
+ \put(-\dimexpr
+ .45\textwidth-4em\relax,-2.5\baselineskip){\vector(0,1){\dimexpr
+ 5mm+2.5\baselineskip\relax}}
+ }%
+ \put(\dimexpr.5\textwidth+2em,.5\baselineskip){%
+ \iffree{\color{blue}}{}%
+ \put(0,0){\line(1,0){1.5em}}%
+ \put(1.5em,0){\vector(0,1){5mm}}%
+ \iffree{\color{green}}{}%
+ \put(0,-1.25\baselineskip){\line(1,0){\dimexpr .25\textwidth-2em\relax}}
+ \put(\dimexpr
+ .25\textwidth-2em\relax,-1.25\baselineskip){\vector(0,1){\dimexpr
+ 5mm+1.25\baselineskip\relax}}
+ \iffree{\color{red}}{}%
+ \put(0,-2.5\baselineskip){\line(1,0){\dimexpr .45\textwidth-4em\relax}}
+ \put(\dimexpr
+ .45\textwidth-4em\relax,-2.5\baselineskip){\vector(0,1){\dimexpr
+ 5mm+2.5\baselineskip\relax}}
+ }%
+ \end{picture}
+ \caption[Commands to define the page head]%
+ {The meaning of the commands to define the contents of the page head
+ of the page styles sketched on a schematic double page}
+ \label{fig:scrlayer-scrpage.head}
+\end{figure}
+%
+\begin{Example}
+ Assume you're writing a short article and you want the title of that
+ article to be shown left aligned and the author's name to be
+ shown right aligned at the page head. You may for example use:
+\begin{lstcode}
+ \documentclass{scrartcl}
+ \usepackage{scrlayer-scrpage}
+ \lohead{John Doe}
+ \rohead{Page style with \KOMAScript}
+ \pagestyle{scrheadings}
+ \begin{document}
+ \title{Page styles with \KOMAScript}
+ \author{John Doe}
+ \maketitle
+ \end{document}
+\end{lstcode}
+ But what happens: On the first page there's only a page number at the page
+ foot, but the header is empty!
+
+ The explanation is very easy. Document class \Class{scrartcl} switches to
+ page style \Pagestyle{plain} for the page with the title head. After command
+ \Macro{pagestyle}\PParameter{scrheadings} in the preamble of the short
+ document this will actually result in page style
+ \Pagestyle{plain.scrheadings}. Using a \KOMAScript{} class the default of
+ this page style is an empty page header and a page number in the footer. In
+ the example code the optional arguments of \Macro{lohead} and \Macro{rohead}
+ are omitted. So page style \Pagestyle{plain.scrheadings} remains
+ unchanged as default and the result for the first page is indeed correct.
+
+ Please add some text below \Macro{maketitle} until a second page will be
+ printed. Alternatively you may just add
+ \Macro{usepackage}\PParameter{lipsum}\IndexPackage{lipsum} into the document
+ preamble and \Macro{lipsum}\IndexCmd{lipsum} below \Macro{maketitle}. You
+ will see that the head of the second page will show the author and the
+ document title as we wanted.
+
+ To see the difference you should also add an optional argument to
+ \Macro{lohead} and \Macro{rohead} containing some content. To do so, change
+ the example above:
+ \begin{lstcode}
+ \documentclass{scrartcl}
+ \usepackage{scrlayer-scrpage}
+ \lohead[John Doe]
+ {John Doe}
+ \rohead[Page style with \KOMAScript]
+ {Page style with \KOMAScript}
+ \pagestyle{scrheadings}
+ \begin{document}
+ \title{Page styles with \KOMAScript}
+ \author{John Doe}
+ \maketitle
+ \end{document}
+\end{lstcode}
+ Now, you also get a page header above the title head of the first
+ page. That is because you have reconfigured page style
+ \Pagestyle{plain.scrheadings} with the two optional arguments. Most of you
+ will also recognise that it would be better to leave this page style
+ unchanged, because the running head above the document title is certainly
+ annoying.
+\end{Example}
+
+Allow me an important note:\textnote{Attention!} You should never put a
+section heading or section number directly into the page head using a new
+declaration by one of these commands. This could result in a wrong number or
+heading text in the running head, because of the asynchronous page generation
+and output of \TeX. Instead you should use the mark mechanism and ideally you
+should use it together with the automatism described in the following
+section.%
+\EndIndex{Cmd}{rohead}%
+\EndIndex{Cmd}{cohead}%
+\EndIndex{Cmd}{lohead}%
+\EndIndex{Cmd}{rehead}%
+\EndIndex{Cmd}{cehead}%
+\EndIndex{Cmd}{lehead}%
+
+\begin{Declaration}
+ \Macro{lefoot}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}\\
+ \Macro{cefoot}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}\\
+ \Macro{refoot}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}\\
+ \Macro{lofoot}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}\\
+ \Macro{cofoot}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}\\
+ \Macro{rofoot}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}
+\end{Declaration}
+\BeginIndex{Cmd}{lefoot}%
+\BeginIndex{Cmd}{cefoot}%
+\BeginIndex{Cmd}{refoot}%
+\BeginIndex{Cmd}{lofoot}%
+\BeginIndex{Cmd}{cofoot}%
+\BeginIndex{Cmd}{rofoot}%
+The contents of the footer of page style \Pagestyle{plain.scrheadings} and
+\Pagestyle{scrheadings} can be defined using these commands. Thereby the
+optional argument defines the content of an element of page style
+\Pagestyle{plain.scrheadings}, while the mandatory argument sets the content
+of the corresponding element of page style \Pagestyle{scrheadings}.
+
+Contents of left\,---\,so called even\,---\,pages can be set with
+\Macro{lefoot}, \Macro{cefoot}, and \Macro{rohead}. Remark: The ``\texttt{e}''
+at the second position of the commands' names means ``\emph{even}''.
+
+Contents of odd pages can be set with \Macro{lofoot}, \Macro{cofoot}, and
+\Macro{rofoot}. Remark: The ``\texttt{o}'' at the second position of the
+commands' names means ``\emph{odd}''.
+
+Please note\textnote{Attention!} that there are only odd pages within single
+side layouts independent of whether or not they have an odd page number.
+
+Each footer consists of a left aligned element that will be defined by
+\Macro{lefoot} respectively \Macro{lofoot}. Remark: The ``\texttt{l}'' at the
+first position of the commands' names means ``\emph{left aligned}''.
+
+Similarly each footer has a centred element that will be defined by
+\Macro{cefoot} respectively \Macro{cofoot}. Remark: The ``\texttt{c}'' at the
+first position of the command' names means ``\emph{centred}''.
+
+Similarly each footer has a right aligned element that will be defined by
+\Macro{refoot} respectively \Macro{rofoot}. Remark: The ``\texttt{r}'' at the
+first position of the commands' names means ``\emph{right aligned}''.
+
+\BeginIndex{FontElement}{pagefoot}%
+\BeginIndex{FontElement}{pageheadfoot}%
+However, these elements do not have their own font attributes that may be
+changed using commands \Macro{setkomafont} and \Macro{addtokomafont} (see
+\autoref{sec:maincls.textmarkup}, \autopageref{desc:maincls.cmd.setkomafont}),
+but are grouped in an element named \FontElement{pagefoot}. And before the
+font of that element additionally the font of element
+\FontElement{pageheadfoot} will be used. See
+\autoref{tab:scrlayer-scrpage.fontelements} for the defaults of the fonts of
+these elements.%
+\EndIndex{FontElement}{pageheadfoot}%
+\EndIndex{FontElement}{pagefoot}%
+
+The semantics of the described commands within two-sided layouts are also
+sketched in \autoref{fig:scrlayer-scrpage.foot}.%
+%
+\begin{figure}[bp]
+ \centering
+ \begin{picture}(\textwidth,30mm)
+ \thinlines
+ \small\ttfamily
+ % left page
+ \put(0,0){\line(1,0){.49\textwidth}}%
+ \put(0,0){\line(0,1){20mm}}%
+ \multiput(0,20mm)(0,1mm){10}{\line(0,1){.5mm}}%
+ \put(.49\textwidth,0){\line(0,1){15mm}}%
+ \put(.05\textwidth,5mm){%
+ \iffree{\color{red}}{}%
+ \put(-.5em,0){\line(1,0){4em}}%
+ \multiput(3.5em,0)(.25em,0){5}{\line(1,0){.125em}}%
+ \put(-.5em,0){\line(0,1){\baselineskip}}%
+ \put(-.5em,\baselineskip){\line(1,0){4em}}%
+ \multiput(3.5em,\baselineskip)(.25em,0){5}{\line(1,0){.125em}}%
+ \makebox(4em,5mm)[l]{\Macro{lefoot}}%
+ }%
+ \put(.465\textwidth,5mm){%
+ \iffree{\color{blue}}{}%
+ \put(-4em,0){\line(1,0){4em}}%
+ \multiput(-4em,0)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(0,0){\line(0,1){\baselineskip}}%
+ \put(-4em,\baselineskip){\line(1,0){4em}}%
+ \multiput(-4em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-4.5em,0){\makebox(4em,5mm)[r]{\Macro{refoot}}}%
+ }%
+ \put(.2525\textwidth,5mm){%
+ \iffree{\color{green}}{}%
+ \put(-2em,0){\line(1,0){4em}}%
+ \multiput(2em,0)(.25em,0){5}{\line(1,0){.125em}}%
+ \multiput(-2em,0)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-2em,\baselineskip){\line(1,0){4em}}%
+ \multiput(2em,\baselineskip)(.25em,0){5}{\line(1,0){.125em}}%
+ \multiput(-2em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-2em,0){\makebox(4em,5mm)[c]{\Macro{cefoot}}}%
+ }%
+ % right page
+ \put(.51\textwidth,0){\line(1,0){.49\textwidth}}%
+ \put(.51\textwidth,0){\line(0,1){15mm}}%
+ \put(\textwidth,0){\line(0,1){20mm}}%
+ \multiput(\textwidth,20mm)(0,1mm){10}{\line(0,1){.5mm}}%
+ \put(.5325\textwidth,5mm){%
+ \iffree{\color{blue}}{}%
+ \put(0,0){\line(1,0){4em}}%
+ \multiput(4em,0)(.25em,0){5}{\line(1,0){.125em}}%
+ \put(0,0){\line(0,1){\baselineskip}}%
+ \put(0em,\baselineskip){\line(1,0){4em}}%
+ \multiput(4em,\baselineskip)(.25em,0){5}{\line(1,0){.125em}}%
+ \put(.5em,0){\makebox(4em,5mm)[l]{\Macro{lofoot}}}%
+ }%
+ \put(.965\textwidth,5mm){%
+ \iffree{\color{red}}{}%
+ \put(-4em,0){\line(1,0){4em}}%
+ \multiput(-4em,0)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(0,0){\line(0,1){\baselineskip}}%
+ \put(-4em,\baselineskip){\line(1,0){4em}}%
+ \multiput(-4em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-4.5em,0){\makebox(4em,5mm)[r]{\Macro{rofoot}}}%
+ }%
+ \put(.75\textwidth,5mm){%
+ \iffree{\color{green}}{}%
+ \put(-2em,0){\line(1,0){4em}}%
+ \multiput(2em,0)(.25em,0){5}{\line(1,0){.125em}}%
+ \multiput(-2em,0)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-2em,\baselineskip){\line(1,0){4em}}%
+ \multiput(2em,\baselineskip)(.25em,0){5}{\line(1,0){.125em}}%
+ \multiput(-2em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-2em,0){\makebox(4em,5mm)[c]{\Macro{cofoot}}}%
+ }%
+ % both pages
+ \iffree{\color{blue}}{}%
+ \put(.5\textwidth,15mm){\makebox(0,\baselineskip)[c]{\Macro{ifoot}}}%
+ \iffree{\color{green}}{}%
+ \put(.5\textwidth,20mm){\makebox(0,\baselineskip)[c]{\Macro{cfoot}}}
+ \iffree{\color{red}}{}%
+ \put(.5\textwidth,25mm){\makebox(0,\baselineskip)[c]{\Macro{ofoot}}}
+ \put(\dimexpr.5\textwidth-2em,.5\baselineskip){%
+ \iffree{\color{blue}}{}%
+ \put(0,15mm){\line(-1,0){1.5em}}%
+ \put(-1.5em,15mm){\vector(0,-1){5mm}}%
+ \iffree{\color{green}}{}%
+ \put(0,20mm){\line(-1,0){\dimexpr .25\textwidth-2em\relax}}%
+ \put(-\dimexpr .25\textwidth-2em\relax,20mm){\vector(0,-1){10mm}}%
+ \iffree{\color{red}}{}%
+ \put(0,25mm){\line(-1,0){\dimexpr .45\textwidth-4em\relax}}%
+ \put(-\dimexpr .45\textwidth-4em\relax,25mm){\vector(0,-1){15mm}}%
+ }%
+ \put(\dimexpr.5\textwidth+2em,.5\baselineskip){%
+ \iffree{\color{blue}}{}%
+ \put(0,15mm){\line(1,0){1.5em}}%
+ \put(1.5em,15mm){\vector(0,-1){5mm}}%
+ \iffree{\color{green}}{}%
+ \put(0,20mm){\line(1,0){\dimexpr .25\textwidth-2em\relax}}%
+ \put(\dimexpr .25\textwidth-2em\relax,20mm){\vector(0,-1){10mm}}%
+ \iffree{\color{red}}{}%
+ \put(0,25mm){\line(1,0){\dimexpr .45\textwidth-4em\relax}}%
+ \put(\dimexpr .45\textwidth-4em\relax,25mm){\vector(0,-1){15mm}}%
+ }%
+ \end{picture}
+ \caption[Commands to define the page footer]%
+ {The meaning of the commands to define the contents of the page
+ footer of the page styles sketched on a schematic double page}%
+ \label{fig:scrlayer-scrpage.foot}
+\end{figure}
+%
+\begin{Example}
+ Let's return to the example of the short article. Assuming you want to print
+ the publisher at the left side of the page footer, you would change the
+ example above into:
+\begin{lstcode}
+ \documentclass{scrartcl}
+ \usepackage{scrlayer-scrpage}
+ \lohead{John Doe}
+ \rohead{Page style with \KOMAScript}
+ \lofoot{Smart Alec Publishing}
+ \pagestyle{scrheadings}
+ \usepackage{lipsum}
+ \begin{document}
+ \title{Page styles with \KOMAScript}
+ \author{John Doe}
+ \maketitle
+ \lipsum
+ \end{document}
+\end{lstcode}
+ Once again the publisher is not printed on the first page with the title
+ head. For the reason see the explanation about \Macro{lohead} in the example
+ above. And again the solution to print the publisher on the first page would
+ be similar:
+\begin{lstcode}
+ \lofoot[Smart Alec Publishing]
+ {Smart Alec Publishing}
+\end{lstcode}
+ But now you also want to replace the slanted font used in page head and
+ footer by a upright smaller font. This may be done using:
+\begin{lstcode}
+ \setkomafont{pageheadfoot}{\small}
+\end{lstcode}
+ Furthermore, the head but not the footer should be bold:
+\begin{lstcode}
+ \setkomafont{pagehead}{\bfseries}
+\end{lstcode}
+ For the last command it is important to have it just after
+ \Package{scrpage-scrlayer} has been loaded, because
+ the \KOMAScript{} class already defines \FontElement{pagehead} and
+ \FontElement{pageheadfoot} but with the same meaning. Only loading
+ \Package{scrpage-scrlayer} changes the meaning of \FontElement{pagehead} and
+ makes it an element independent of \FontElement{pageheadfoot}.
+
+ Now, please add one more \Macro{lipsum} and add option \Option{twoside} to
+ the loading of \Class{scrartcl}. First of all, you will see the page number
+ moving from the middle of the page footer to the outer margin, due to the
+ changed defaults of \Pagestyle{scrheadings} and
+ \Pagestyle{plain.scrheadings} using double-sided layout and a \KOMAScript{}
+ class.
+
+ Simultaneously the author, document title and publisher will vanish from
+ page~2. It only appears on page~3. This is a consequence of using only
+ commands for odd pages. You can recognise this by the ``\texttt{o}'' on the
+ second position of the commands' names.
+
+ Now, we could simply copy those commands and replace the ``\texttt{o}'' by
+ an ``\texttt{e}'' to define the contents of \emph{even} pages. But with
+ double sided layout it makes more sense to use mirror-inverted elements. So
+ the left element of an odd page should become the right element of the even
+ page and visa versa. To achieve this, we also replace the first letter
+ ``\texttt{l}'' by ``\texttt{r}'':
+\begin{lstcode}
+ \documentclass[twoside]{scrartcl}
+ \usepackage{scrlayer-scrpage}
+ \lohead{John Doe}
+ \rohead{Page style with \KOMAScript}
+ \lofoot[Smart Alec Publishing]
+ {Smart Alec Publishing}
+ \rehead{John Doe}
+ \lohead{Page style with \KOMAScript}
+ \refoot[Smart Alec Publishing]
+ {Smart Alec Publishing}
+ \pagestyle{scrheadings}
+ \usepackage{lipsum}
+ \begin{document}
+ \title{Page styles with \KOMAScript}
+ \author{John Doe}
+ \maketitle
+ \lipsum\lipsum
+ \end{document}
+\end{lstcode}
+\end{Example}
+%
+After reading the example it may appear to you that it is somehow
+uncomfortable to duplicate commands to have the same contents on mirror
+positions of the page header or footer of a double page. Therefore you will
+learn to know an easier solution for this standard case next.
+
+Before allow me an important note:\textnote{Attention!} You should never put a
+section heading or section number directly into the page's footer using a new
+declaration by one of these commands. This could result in a wrong number or
+heading text in the running footer, because of the asynchronous page
+generation and output of \TeX. Instead you should use the mark mechanism
+ideally together with the automatism described in the following section.%
+\EndIndex{Cmd}{rofoot}%
+\EndIndex{Cmd}{cofoot}%
+\EndIndex{Cmd}{lofoot}%
+\EndIndex{Cmd}{refoot}%
+\EndIndex{Cmd}{cefoot}%
+\EndIndex{Cmd}{lefoot}%
+
+\begin{Declaration}
+ \Macro{ohead}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}\\
+ \Macro{chead}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}\\
+ \Macro{ihead}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}\\
+ \Macro{ofoot}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}\\
+ \Macro{cfoot}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}\\
+ \Macro{ifoot}\OParameter{plain.scrheadings's content}%
+ \Parameter{scrheadings's content}
+\end{Declaration}
+\BeginIndex{Cmd}{ohead}%
+\BeginIndex{Cmd}{chead}%
+\BeginIndex{Cmd}{ihead}%
+\BeginIndex{Cmd}{ofoot}%
+\BeginIndex{Cmd}{cfoot}%
+\BeginIndex{Cmd}{ifoot}%
+To define the contents of page headers and footers of odd and the even pages
+of a double-sided layout using the commands described before, you would have to
+define the contents of the even page different from the contents of the odd
+page. But in general the pages should be symmetric. An element, that should be
+printed left aligned on an even page, should be right aligned on an odd page
+and vise versa. Elements, that are centred on odd pages, should be centred on
+even pages too.
+
+To simplify the definition of such symmetric page styles,
+\Package{scrlayer-scrpage} provides a kind of abbreviation. Command
+\Macro{ohead} is same like usage of both \Macro{lehead} and
+\Macro{rohead}. Command \Macro{chead} is same like \Macro{cehead} and
+\Macro{cohead}. And command \Macro{ihead} is same like \Macro{rehead} and
+\Macro{lohead}. The corresponding commands for the page footer are defined
+accordingly. A sketch of these commands can be found also in
+\autoref{fig:scrlayer-scrpage.head} on \autopageref{fig:scrlayer-scrpage.head}
+and \autoref{fig:scrlayer-scrpage.foot} on
+\autopageref{fig:scrlayer-scrpage.foot} together with the relationships of all
+the page header and footer commands.
+%
+\begin{Example}
+ You can simplify the example before using the new commands:
+\begin{lstcode}
+ \documentclass[twoside]{scrartcl}
+ \usepackage{scrlayer-scrpage}
+ \ihead{John Doe}
+ \ohead{Page style with \KOMAScript}
+ \ifoot[Smart Alec Publishing]
+ {Smart Alec Publishing}
+ \pagestyle{scrheadings}
+ \usepackage{lipsum}
+ \begin{document}
+ \title{Page styles with \KOMAScript}
+ \author{John Doe}
+ \maketitle
+ \lipsum\lipsum
+ \end{document}
+\end{lstcode}
+ As you can see, you can spare half of the commands but get the same result.
+\end{Example}
+%
+In single-sided layouts all pages are odd pages. So in LaTeX's single-sided
+mode these commands are synonymous for the odd page commands. Therefore in
+most cases you will only need these six commands instead of the twelve
+described before.
+
+Once again, allow me an important note:\textnote{Attention!} You should never
+put a section heading or section number directly into the page head or
+page foot using a new declaration by one of these commands. This could result in
+a wrong number or heading text in the running header or footer, because of the
+asynchronous page generation and output of \TeX. Instead you should use the
+mark mechanism ideally together with the automatism described in the following
+section.%
+\EndIndex{Cmd}{ihead}%
+\EndIndex{Cmd}{chead}%
+\EndIndex{Cmd}{ohead}%
+\EndIndex{Cmd}{ifoot}%
+\EndIndex{Cmd}{cfoot}%
+\EndIndex{Cmd}{ofoot}%
+
+
+\begin{Declaration}
+ \KOption{pagestyleset}\PName{setting}
+\end{Declaration}
+\BeginIndex{Option}{pagestyleset~=KOMA-Script}%
+\BeginIndex{Option}{pagestyleset~=standard}%
+In the examples above you can already find some information about the defaults
+of \Pagestyle{scrheadings}\IndexPagestyle{scrheadings} and
+\Pagestyle{plain.scrheadings}\IndexPagestyle{plain.scrheadings}. Indeed
+\Package{scrlayer-scrpage} provides two different defaults yet. You may select
+one of those defaults manually using option \Option{pagestyleset}.
+
+If \PName{setting} is \PValue{KOMA-Script} the defaults will be used that
+would also be activated automatically if a \KOMAScript{} class has been
+detected. In this case and within double-sided layout \Pagestyle{scrheadings}
+uses running heads outer aligned in the page head. The page number will be
+printed outer aligned in the page footer. Within single-sided layout the
+running head will be printed in the middle of the page head and the page
+number in the middle of the page footer. Upper and lower case will be used for
+the automatic running head as given by the words you have typed. This would be
+same like using Option
+\OptionValue{markcase}{used}\IndexOption{markcase~=used}. Pagestyle
+\Pagestyle{plain.scrheadings} has not got running heads, but the page numbers
+will be printed in the same manner.
+
+If \PName{setting} is \PValue{standard} the defaults will be used that are
+similar to page style \Pagestyle{headings} and \Pagestyle{plain} of the
+standard classes. This \PName{setting} will also be activated automatically
+if the option has not been used and \KOMAScript{} class cannot be
+detected. Within double-sided layout thereby \Pagestyle{scrheadings} uses
+running heads aligned inner in the page head and the page numbers will be
+printed\,---\,also in the page head\,---\,aligned outer. Within single-sided
+layout \Pagestyle{scrheadings} is the same. But because of single side layout
+knows only odd pages, the running head will be aligned left always and the
+page number will be aligned right. In spite of typographic objection, the
+automatic running head will be converted into upper cases like they would
+using \OptionValue{markcase}{upper}\IndexOption{markcase~=upper}. Within
+single side layout page style \Pagestyle{plain.scrheadings} differs a lot from
+\Pagestyle{scrheading}, because the page number will be printed in the middle
+of the page footer. Using double side layout page style
+\Pagestyle{plain.scrheadings} differs from standard classes'
+\Pagestyle{plain}. The standard classes would print the page number in the
+middle of the page footer. But this would not harmonise with the
+\Pagestyle{scrheadings}, so \Pagestyle{plain.scrheadings} does not print a page
+number. But like \Pagestyle{plain} it does not print a running head.
+
+Please note\textnote{Attention!} that together with this option page style
+\Pagestyle{scrheadings} will be activated. This will be also the case, if you
+use the option inside the document.
+
+\BeginIndex{Option}{komastyle}%
+\BeginIndex{Option}{standardstyle}%
+Options \Option{komastyle} and \Option{standardstyle}, provided by
+\Package{scrpage}, are defined only for compatibility reasons in
+\Package{scrlayer-scrpage}. But they are implemented using option
+\Option{pagestyleset}. They are deprecated and you should not use them.%
+%
+\EndIndex{Option}{standardstyle}%
+\EndIndex{Option}{komastyle}%
+\EndIndex{Option}{pagestyleset~=standard}%
+\EndIndex{Option}{pagestyleset~=KOMA-Script}%
+
+\LoadCommon{21} % \section{Manipulation of Defined Page Styles}
+
+\begin{Declaration}
+ \KOption{headwidth}\PName{width\textup{:}offset}\\
+ \KOption{footwidth}\PName{width\textup{:}offset}
+\end{Declaration}
+\BeginIndex{Option}{headwidth~=\PName{offset\textup{:}width}}%
+\BeginIndex{Option}{footwidth~=\PName{offset\textup{:}width}}%
+By default the page head\Index{head>width} and foot\Index{foot>width} are as
+wide as the type area. This can be changed using these \KOMAScript{}
+options. The value \PName{width} is the wanted width of the head respective
+foot. The \PName{offset} defines how much the head or foot should be moved
+towards the outer\,---\,in single side layout to the right\,---\,margin. Both
+values are optional and can be omitted. If you omit both values, you can also
+omit the colon. If you only use one value without colon, this will be the
+\PName{width}.
+
+For the \PName{width} as well as the \PName{offset} you can use any valid
+length value, \LaTeX{} length, \TeX{} dimension or \TeX{} skip. In addition
+you may use an \eTeX{} dimension expression with basic arithmetic operations
+\texttt{+}, \texttt{-}, \texttt{*}, \texttt{/}, and parenthesis. See
+\cite[section~3.5]{manual:eTeX} for more information on such expressions. See
+\autoref{sec:scrlayer-scrpage.options} for more information on using,
+e.\,g., a \LaTeX{} length as an option value. The \PName{width} can
+alternatively be one of the symbolic values shown in
+\autoref{tab:scrlayer-scrpage.symbolic.values}.
+
+By default the head and the foot are as wide as the text area. The default
+\PName{offset} depends on the used \PName{width}. In single side layout
+generally the half of the difference of \PName{width} and the width of the
+text area will be used. This results in horizontal centring the page head
+above or the page footer below the text area. In difference to this, in double
+side layout generally a third of the difference of \PName{offset} and the
+width of the text area will be used. But if \PName{width} is the width of the
+whole text area plus the marginal note column, default \PName{offset} will be
+zero. If you think, this is complicated, you should simply use an explicit
+\PName{offset}.
+%
+\begin{table}
+ \centering
+ \caption[Symbolic values for options \Option{headwidth} and
+ \Option{footwidth}]{Possible symbolic values for the \PName{width} value of
+ options \Option{headwidth} and \Option{footwidth}}
+ \label{tab:scrlayer-scrpage.symbolic.values}
+ \begin{desctabular}
+ \ventry{foot}{%
+ the current width of the page foot%
+ }%
+ \ventry{footbotline}{%
+ the current length of the horizontal line below the page foot%
+ }%
+ \ventry{footsepline}{%
+ the current length of the horizontal line above the page foot%
+ } \ventry{head}{%
+ the current width of the page head%
+ }%
+ \ventry{headsepline}{%
+ the current length of the horizontal line below the page head%
+ }%
+ \ventry{headtopline}{%
+ the current lenght of the horizontal line above the page head%
+ }%
+ \ventry{marginpar}{%
+ the current width of the marginal note column including the distance
+ between the text area and the marginal note column%
+ }%
+ \ventry{page}{%
+ the current width of the page considering a binding correction of
+ package \Package{typearea} (see option \Option{BCOR} in
+ \autoref{sec:typearea.typearea},
+ \autopageref{desc:typearea.option.BCOR})%
+ }%
+ \ventry{paper}{%
+ the current width of the paper without considering a binding correction%
+ }%
+ \ventry{text}{%
+ the current width of the text area%
+ }%
+ \ventry{textwithmarginpar}{%
+ the current width of the text area plus the marginal note column
+ including the distance between them (note: in this case and only in this
+ case the default of \PName{offset} would be zero)%
+ }%
+ \end{desctabular}
+\end{table}
+%
+\EndIndex{Option}{footwidth~=\PName{offset\textup{:}width}}%
+\EndIndex{Option}{headwidth~=\PName{offset\textup{:}width}}%
+
+\begin{Declaration}
+ \KOption{headtopline}\PName{thickness\textup{:}length}\\
+ \KOption{headsepline}\PName{thickness\textup{:}length}\\
+ \KOption{footsepline}\PName{thickness\textup{:}length}\\
+ \KOption{footbotline}\PName{thickness\textup{:}length}
+\end{Declaration}
+\BeginIndex{Option}{headtopline~=\PName{thickness\textup{:}length}}%
+\BeginIndex{Option}{headsepline~=\PName{thickness\textup{:}length}}%
+\BeginIndex{Option}{footsepline~=\PName{thickness\textup{:}length}}%
+\BeginIndex{Option}{footbotline~=\PName{thickness\textup{:}length}}%
+The \KOMAScript{} classes provide only a separation line below the page head
+and above the page head, and you may only switch each of these lines on or
+off. But package \Package{scrlayer-scrpage} provides four such horizontal
+lines: one above the head, one below the head, one above the foot, and one
+below the foot. And you can not only switch them on an off, but also configure
+the \PName{length} and \PName{thickness} of each of these lines.
+
+Both values are optional. If you omit the \PName{thickness}, a default value
+of 0.4\Unit{pt} will be used, a so called \emph{hairline}. If you omit the
+\PName{length}, the width of the head respective the foot will be used. If you
+omit both, you can also omit the colon. If you use only one value without
+colon, this will be the \PName{thickness}.
+
+For sure, the \PName{length} can be not only shorter than the current width of
+the page head respectively the page foot, but also longer. See additionally
+options \Option{ilines}\IndexOption{ilines},
+\Option{clines}\IndexOption{clines}, and \Option{olines}\IndexOption{olines}
+later in this section.
+
+\BeginIndex{FontElement}{headtopline}%
+\BeginIndex{FontElement}{headsepline}%
+\BeginIndex{FontElement}{footsepline}%
+\BeginIndex{FontElement}{footbotline}%
+Beside the length and thickness also the colour of the lines can be
+changed. First of all the colour depends on the colour of the head or
+foot. But independent from those or additional to them the settings of the
+corresponding elements \FontElement{headtopline}, \FontElement{headsepline},
+\FontElement{footsepline}, and \FontElement{footbotline} will be used. You may
+change these using command \Macro{setkomafont} or \Macro{addtokomafont} (see
+\autoref{sec:maincls.textmarkup} from
+\autopageref{desc:maincls.cmd.setkomafont}). By default those settings are
+empty, which means no change of the current font or colour. Change of font in
+opposite to colour would not make sense and is not recommended for these
+elements.%
+\EndIndex{FontElement}{footbotline}%
+\EndIndex{FontElement}{footsepline}%
+\EndIndex{FontElement}{headsepline}%
+\EndIndex{FontElement}{headtopline}%
+
+\BeginIndex{Cmd}{setheadtopline}%
+\BeginIndex{Cmd}{setheadseoline}%
+\BeginIndex{Cmd}{setfootsepline}%
+\BeginIndex{Cmd}{setfootbotline}%
+Package \Package{scrpage2} has additionally to the options that do not take
+any values, also four commands
+\Macro{setheadtopline}\IndexCmd[indexmain]{setheadtopline},
+\Macro{setheadsepline}\IndexCmd[indexmain]{setheadsepline},
+\Macro{setfootsepline}\IndexCmd[indexmain]{setfootsepline}, and
+\Macro{setfootbotline}\IndexCmd[indexmain]{setfootbotline}. These have a first
+optional argument for the \PName{length}, a second mandatory argument for the
+\PName{thickness}, and a third optional argument for the setting of font or
+colour. Package \Package{scrlayer-scrpage} does also provide those
+commands. Nevertheless, these commands are deprecated and should not be used
+any longer. To get it clear: These commands have never been made to
+switch the lines on or off. They have been made to configure already switched
+on lines. Users often ignored this!%
+\EndIndex{Cmd}{setfootbotline}%
+\EndIndex{Cmd}{setfootsepline}%
+\EndIndex{Cmd}{setheadseoline}%
+\EndIndex{Cmd}{setheadtopline}%
+%
+\EndIndex{Option}{footbotline~=\PName{thickness\textup{:}length}}%
+\EndIndex{Option}{footsepline~=\PName{thickness\textup{:}length}}%
+\EndIndex{Option}{headsepline~=\PName{thickness\textup{:}length}}%
+\EndIndex{Option}{headtopline~=\PName{thickness\textup{:}length}}%
+
+
+\begin{Declaration}
+ \KOption{plainheadtopline}\PName{simple switch}\\
+ \KOption{plainheadsepline}\PName{simple switch}\\
+ \KOption{plainfootsepline}\PName{simple switch}\\
+ \KOption{plainfootbotline}\PName{simple switch}
+\end{Declaration}
+\BeginIndex{Option}{plainheadtopline~=\PName{simple switch}}%
+\BeginIndex{Option}{plainheadsepline~=\PName{simple switch}}%
+\BeginIndex{Option}{plainfootsepline~=\PName{simple switch}}%
+\BeginIndex{Option}{plainfootbotline~=\PName{simple switch}}%
+These options can be used to inherit the settings of the lines also for the
+\Pagestyle{plain} page style. Possible values for \PName{simple switch} can be
+found in \autoref{tab:truefalseswitch} on
+\autopageref{tab:truefalseswitch}. If a option is activated, the
+\Pagestyle{plain} page style will use the line settings given by the options
+and commands described above. If the option is deactivated, the
+\Pagestyle{plain} will not show the corresponding line.%
+\EndIndex{Option}{plainfootbotline~=\PName{simple switch}}%
+\EndIndex{Option}{plainfootsepline~=\PName{simple switch}}%
+\EndIndex{Option}{plainheadsepline~=\PName{simple switch}}%
+\EndIndex{Option}{plainheadtopline~=\PName{simple switch}}%
+
+\begin{Declaration}
+ \Option{ilines}\\
+ \Option{clines}\\
+ \Option{olines}
+\end{Declaration}
+\BeginIndex{Option}{ilines}%
+\BeginIndex{Option}{clines}%
+\BeginIndex{Option}{olines}%
+You have already been told that the horizontal lines above or below the page
+head or foot can be shorter or longer than the page head or page foot
+itself. Only the answer to the question about the alignment of those lines is
+still missing. By default all lines are left aligned at single side layout and
+aligned to the inner margin of the head or foot at double side layout. This
+is same like using option \Option{ilines}. Alternatively, you can use option
+\Option{clines} to centre the lines in the head or foot, or option
+\Option{olines} to align them right respectively to the outer margin.%
+\EndIndex{Option}{olines}%
+\EndIndex{Option}{clines}%
+\EndIndex{Option}{ilines}%
+%
+\EndIndex{Package}{scrlayer-scrpage}%
+
+%%% Local Variables:
+%%% mode: latex
+%%% mode: flyspell
+%%% coding: us-ascii
+%%% ispell-local-dictionary: "en_GB"
+%%% TeX-master: "../guide"
+%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer.tex
new file mode 100644
index 00000000000..2e413bf8d7d
--- /dev/null
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlayer.tex
@@ -0,0 +1,1242 @@
+% ======================================================================
+% scrlayer.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ----------------------------------------------------------------------
+% scrlayer.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ======================================================================
+%
+% Chapter about scrlayer of the KOMA-Script guide
+% Maintained by Markus Kohm
+%
+% ----------------------------------------------------------------------
+%
+% Kapitel ueber scrlayer in der KOMA-Script-Anleitung
+% Verwaltet von Markus Kohm
+%
+% ============================================================================
+
+\KOMAProvidesFile{scrlayer.tex}
+ [$Date: 2013-12-13 17:39:21 +0100 (Fr, 13 Dez 2013) $
+ KOMA-Script guide (chapter:scrlayer)]
+
+\translator{Markus Kohm}
+
+% Date of the translated file: 2013-10-31
+
+\chapter[{Defining Layers and Page Styles Using \Package{scrlayer}}]%
+{Defining Layers and Page Styles Using \Package{scrlayer}%
+}
+\labelbase{scrlayer}
+
+\BeginIndex{Package}{scrlayer}
+
+Most users of graphics software already know layer models for pages or working
+sheets. \LaTeX{} itself does not know layers, but there are already packages
+like \Package{eso-pic} or \Package{textpos}, that provide a kind of
+background or foreground layer. \Package{scrlayer} is another package,
+that provides such background and foreground layers, but in difference
+to the other packages mentioned above these layers are part of the
+page style definition. With this you may simply switch between usage
+of layers by switching the page style.
+
+To do so, the package also supports a low level interface to define page
+styles using a layer stack, to put layers onto a page style's layer stack, to
+put layers at the lowest position of a page style's layer stack, to put layers
+before or after a layer of a page style's layer stack, to remove a layer from
+a page style's layer stack and to remove doublets of layers of a page style's
+layer stack. In short words: The page style interface of \Package{scrlayer}
+provides commands to define layer-stack-based page styles and to manage those
+layer stacks.
+
+Nevertheless, using the layers directly is recommended for advanced users only.
+End user interfaces for beginners or average users are provided by additional
+packages, that load \Package{scrlayer} on their own. See
+\autoref{cha:scrlayer-scrpage} in \autoref{part:forAuthors} of this
+\iffree{manual}{book}.
+
+\section{State of Development Note}
+\label{sec:scrlayer.draft}
+
+Development of this package has not been finished yet. Parts of the package
+are even still experimental. Because of this, especially internal
+functionality may be changed in future. Most likely the package will be
+extended. And because of the early state of development, you should not expect
+a complete and finished user manual. Nevertheless, this manual, which is
+recommended for advanced users and developers, describes the current state of
+development and the released parts of \Package{scrlayer}. Everything, not
+documented here, should not be used for anything else but testing.
+
+\LoadCommon{0} % \section{Early or Late Selection of Options}
+
+\section{Some Generic Information}
+\label{sec:scrlayer.generic}
+
+The package needs some generic information about the class. Class authors may
+help \Package{scrlayer} by setting this information. Otherwise the package tries
+to detect the information itself. This works, e.g., for the standard classes
+and the \KOMAScript{} classes. But it may or may not fail with other classes.
+
+This section describes some of the information, that class authors may
+provide. Generally users need not to care about this.
+
+\begin{Declaration}
+ \Macro{if@chapter}\ \PName{then code} \Macro{else}\ \PName{else code}
+ \Macro{fi}%
+\end{Declaration}
+\BeginIndex{Cmd}{if@chapter}%
+If \Macro{if@chapter} is \Macro{iftrue}, \Package{scrlayer} will additionally
+consider the chapter level, e.g., processing option \Option{automark}. If it
+is defined, but differs from \Macro{iftrue}, only part, section, subsection,
+sub\dots subsection, paragraph, subparagraph, sub\dots subparagraph will be
+considered. If the macro is not defined, \Package{scrlayer} searches for
+\Macro{chapter}. If \Macro{chapter} is defined and not \Macro{relax},
+\Package{scrlayer} will define \Macro{if@chapter} to \Macro{iftrue}, otherwise
+\Macro{if@chapter} will become \Macro{iffalse}.%
+\EndIndex{Cmd}{if@chapter}
+
+\begin{Declaration}
+ \Macro{if@mainmatter}\ \PName{then code} \Macro{else}\ \PName{else code}
+ \Macro{fi}%
+\end{Declaration}
+\BeginIndex{Cmd}{if@mainmatter}%
+Classes like \Class{book} define \Macro{frontmatter}, \Macro{mainmatter}, and
+\Macro{backmatter}. They also use \Macro{if@mainmatter} to distinguish whether
+or not the current matter is the main matter. Classes like \Class{report} and
+\Class{article} do not have \Macro{frontmatter}, \Macro{mainmatter}, or
+\Macro{backmatter} and therefore also do not have \Macro{if@mainmatter}.
+
+For \Package{scrlayer} it's easier not to test always for the existence of the
+matter commands, but to use \Macro{if@mainmatter} even with classes like
+\Class{report} and \Class{article}, simply set to \Macro{iftrue}. So if
+\Macro{if@mainmatter} is not defined, it will be defined to \Macro{iftrue}.
+
+Some classes have \Macro{frontmatter}, \Macro{mainmatter}, or
+\Macro{backmatter} but not \Macro{if@mainmatter}. In this case
+\Package{scrlayer} also defines \Macro{if@mainmatter} to be \Macro{iftrue}
+and it extends definition of \Macro{frontmatter}, \Macro{mainmatter}, and
+\Macro{backmatter} to set \Macro{if@mainmatter} properly. Other matter
+commands are not known, not tested, and not extended. So if there are other
+matter commands \Package{scrlayer} needs help of the class author to set
+\Macro{if@mainmatter} correctly.%
+\EndIndex{Cmd}{if@mainmatter}
+
+\begin{Declaration}
+ \Macro{DeclareSectionNumberDepth}%^^A
+ \Parameter{level name}\Parameter{level depth}
+\end{Declaration}
+\BeginIndex{Cmd}{DeclareSectionNumberDepth}%
+Generally each section level is related to an integer number indicating its
+depth in the document structure. \LaTeX{} needs this to manage hierarchic
+section levels. But normally only the document class, that defines the section
+commands, itself knows that \PName{level depth} of a section level and uses
+these numerical values inside the corresponding commands, when needed.
+
+But \Package{scrlayer} also needs information about the section hierarchy.
+With command \Macro{DeclareSectionNumberDepth} you can map
+the name of a heading level to a \PName{level depth}. With standard class
+book, e.g., the \PName{level name} could be \PValue{part}, \PValue{chapter},
+\PValue{section}, \PValue{subsection}, \PValue{subsubsection},
+\PValue{paragraph}, or \PValue{subparagraph} and the corresponding
+\PName{level depth}s would be -1, 0, 1, 2, 3, 4, and 5.
+
+Package \Package{scrlayer} tries to determine the \PName{level depth}s on its
+own while loading and again while \Macro{begin}\PParameter{document}. But, if
+it fails, i.\,e., if completely different section commands are used, it would
+be useful, to be able to define the relationship explicitly. For such cases
+\Macro{DeclareSectionNumberDepth} gives the class author the opportunity to
+define the relationship explicitly.%
+\EndIndex{Cmd}{DeclareSectionNumberDepth}
+
+\section{Declaration of Layers}
+\label{sec:scrlayer.layers}
+
+A layer is a kind of virtual sheet of transparent paper (in opposite to a
+physical sheet of paper). One layer is stacked onto another layer and opaque
+material on one layer may hide material on the layers below. The stack of all
+layers together makes the physical page. Package \Package{scrlayer}
+provides two such layer stacks for each page: a background layer stack and a
+foreground layer stack. The background layer stack is behind the normal page
+contents, the foreground layer stack is above the normal page contents. So the
+normal contents is a kind of a separating layer between the background layer
+stack and the foreground layer stack.
+
+A layer has several attributes. The first attribute states, whether or not the
+layer is part of the foreground or the background. During page building
+background layers will be printed first, followed by the main contents and the
+foreground layers. Therefore, in the output the background layers show up
+behind the main contents and the foreground layers in front of the main
+contents. By default, a layer is both, a background layer \emph{and} a
+foreground layer and therefore will be printed twice.
+
+The horizontal position of the layer is set by the second attribute, the
+vertical position by the third. The forth and fifth attributes determine the
+horizontal and vertical size of the layer. As you can see, a layer may be
+smaller or larger than the paper.
+
+But having two numerical values of the second and third attribute does not
+directly give us the position of the layer on the page. For each dimension we
+need two reference points, one on the page and one on the layer. The
+numerical value than states the distance between these reference.
+Reference points in layouts are also known as alignment and are set by the
+sixth attribute.
+
+The seventh attribute states, whether or not a layer should be
+printed onto left or right pages. By default a layer will be printed on both,
+left and right pages. Note, that \LaTeX{} names left pages as even pages and
+right pages as odd pages and that there are no left or even pages in
+single-sided mode.
+
+The eighth attribute states, whether or not a layer should be printed in
+single-side mode or in two-side mode. By default a layer will be printed in
+both, single-side mode and two-side mode. Nevertheless, an even page layer will
+never be printed in single-side mode and therefore is not really a two-side
+mode layer.
+
+The ninth attribute is, whether or not a layer should be printed onto float
+pages or non-float pages. \LaTeX{} produces float pages for float environments
+like tables or figures, if they are allowed to be printed on a page without
+normal page contents (see option \PValue{p} for \Environment{figure} or
+\Environment{table}). So from some point of view a float page is a page, that
+may itself flow. Non-float pages are not pages without floats, but pages, that
+are not float pages. They may contain floats inside the text, on the top of
+the page, or on the bottom of the page. Very large floats may seem to be page
+floats, while in reality they are top floats.
+
+The tenth and last attribute is the contents of the layer. This is simply,
+what should be printed, whenever the layer will be printed.
+
+So we have ten attributes yet. Below in this manual we will describe
+additional attributes. However, they are just defined for convenience and can
+be expressed by a combination of the ten attributes stated above. We call
+these ten attributes the primary attributes.
+
+\begin{Declaration}
+ \Macro{DeclareLayer}\OParameter{option list}\Parameter{layer name}\\
+ \Macro{DeclareNewLayer}\OParameter{option list}\Parameter{layer name}\\
+ \Macro{ProvideLayer}\OParameter{option list}\Parameter{layer name}\\
+ \Macro{RedeclareLayer}\OParameter{option list}\Parameter{layer name}\\
+ \Macro{ModifyLayer}\OParameter{option list}\Parameter{layer name}
+\end{Declaration}
+\BeginIndex{Cmd}{DeclareLayer}%
+\BeginIndex{Cmd}{DeclareNewLayer}%
+\BeginIndex{Cmd}{ProvideLayer}%
+\BeginIndex{Cmd}{RedeclareLayer}%
+\BeginIndex{Cmd}{ModifyLayer}%
+These commands can be used to define a layer. The \PName{layer name} has to be
+fully expandable and should expand to letters only. Some additional characters
+are tolerated, but are not recommended.
+
+Command \Macro{DeclareLayer} does not care whether or not a layer with the
+given \PName{layer name} already exists. It will under all circumstances
+define the layer with the attribute defined by the \PName{option list}.
+An
+\PName{option} can be either a key or a key followed by an
+equal sign followed by a value. Several options may be concatenated to
+a \PName{option list} and have to be separated by comma. If you'd like to have
+a comma or a white space inside the value of an option, you should put the
+value inside curly brackets. See \autoref{tab:scrlayer.layerkeys} for
+more information on keys, values, and the corresponding
+attributes.
+
+In contrast to \Macro{DeclareLayer} using \Macro{DeclareNewLayer} results in
+an error, if a layer with the same \PName{layer name} already exists. So you
+may prevent yourself using the same \PName{layer name} more than once by
+mistake. This would be useful, e.\,g., if a class or package also defines
+layers internally.
+
+If you use \Macro{ProvideLayer} instead of \Macro{DeclareLayer}, the
+declaration will be ignored in case a layer with the same layer name already
+exists. It could be paraphrased by: \emph{declare the layer only, if it has not
+ been declared already.}
+
+If an existing layer should be redefined, \Macro{RedeclareLayer} or
+\Macro{ModifyLayer} can be used. \Macro{RedeclareLayer} would simply define
+the layer as if it would be defined newly. In difference to this,
+\Macro{ModifyLayer} would change only those attributes, that are represented
+by an option of the \PName{option list}. All other attributes will stay
+unchanged and will not be reset to the initial default value. Using either
+\Macro{RedeclareLayer} or \Macro{ModifyLayer} will result in an error, in case
+there has not been a layer with \PName{layer name} defined before.
+
+\begin{desclist}
+ \desccaption{%
+ Options for the definition of page layers with description of the
+ corresponding layer attribute\label{tab:scrlayer.layerkeys}%
+ }{%
+ Options for the definition of layers (\emph{Continuation})%
+ }%
+ \nentry{\KOption{align}{\PName{alignment characters}}}{%
+ The \PName{alignment characters} define the desired alignment of the
+ layer. Each \PName{alignment character} influences either, how argument
+ \PName{length} of option \Option{hoffset} or \Option{voffset} will be
+ used. Several \PName{alignment characters} may be used together (without
+ comma or space) and will be interpreted in the order of occurrence. No
+ macros should be used here! Valid \PName{alignment character}s are:
+ \begin{description}
+ \item[\PValue{b} --] align the layer at its bottom edge; the
+ value of
+ \Option{voffset} is interpreted as the distance from the top edge of the
+ paper to the bottom edge of the layer.
+ \item[\PValue{c} --] align the layer at its centre; the values of
+ \Option{voffset} and \Option{hoffset} are interpreted as the distance
+ from the top left corner of the paper to the centre of the layer.
+ \item[\PValue{l} --] align the layer at its left edge: the value of
+ \Option{hoffset} is interpreted as the distance from the left edge of
+ the paper to the left edge of the layer.
+ \item[\PValue{r} --] align the layer at its right edge; the value of
+ \Option{hoffset} is interpreted as the distance from the left edge of
+ the paper to the right edge of the layer.
+ \item[\PValue{t} --] align the layer at its top edge; the value of
+ \Option{voffset} is interpreted as the distance from the top edge of the
+ paper to the top edge of the layer.
+ \end{description}%
+ }%
+ \nentry{\KOption{area}{%^^A
+ \Parameter{hoffset}\Parameter{voffset}%^^A
+ \Parameter{width}\Parameter{height}}}{%
+ The composed option results in \OptionValue{hoffset}{\PName{hoffset}},
+ \OptionValue{voffset}{\PName{voffset}},
+ \OptionValue{width}{\PName{width}}, \OptionValue{height}{\PName{height}}.%
+ }%
+ \entry{\Option{background}}{%
+ Print the layer only in the background, but not in the foreground. This
+ makes a background-only layer in opposite to the default of layers which
+ are both, background and foreground layers and therefore would be printed
+ twice. The option does not expect any value. By the default the attribute
+ is not set.%
+ }%
+ \entry{\Option{bottommargin}}{%
+ The composed option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} to horizontally span
+ the paper from the left edge to the right and vertically span the area
+ below the footer down to the bottom edge of the paper.%
+ }%
+ \nentry{\KOption{clone}{\PName{layer name}}}{%
+ The composed option sets all primary attributes of the layer to the same
+ values as the primary attributes of the layer with the given \PName{layer
+ name}. Note, that \PName{layer name} has to be fully expandable and
+ should expand to letters only. Some additional characters are tolerated,
+ but are not recommended!%
+ }%
+ \nentry{\KOption{contents}{\PName{code}}}{%
+ The \PName{code} will be expanded whenever the layer is printed. So the
+ \PName{code} is what you will see. Code validity is not checked. So errors
+ in \PName{code} may result in several failures on each page, that prints
+ the layer.%
+ }%
+ \entry{\Option{evenpage}}{%
+ Print the layer on even pages only, but not on odd pages. The option does
+ not expect any value. By the default the option is not set and therefore
+ layers would be printed on odd pages and on even pages. Note, that this
+ attribute subsumes \Option{twoside}.%
+ }%
+ \entry{\Option{floatpage}}{%
+ Print the layer on float pages only, but not on other pages. The option
+ does not expect any value. By the default the attribute is not set and
+ therefore layers would be printed on float pages and on non-float pages.%
+ }%
+ \entry{\Option{foot}}{%
+ The composed option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} to horizontally span
+ the text area and vertically span the page footer defined by the new
+ \LaTeX{} length \Length{footheight}.%
+ }%
+ \entry{\Option{footskip}}{%
+ The composed option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} to horizontally span
+ the text area and vertically span the distance between the text area and
+ the page footer (note, that this is not the same like \Length{footskip}).%
+ }%
+ \entry{\Option{foreground}}{%
+ Print the layer only in the foreground, but not in the background. This
+ makes a foreground-only layer in opposite to the default of layers which
+ are both, background and foreground layers and therefore would be printed
+ twice. The option does not expect any value. By the default the attribute
+ is not set.%
+ }%
+ \entry{\Option{head}}{%
+ The composed option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} to horizontally span
+ the text area and vertically span the page head defined by usual \LaTeX{}
+ length \Length{headheight}.%
+ }%
+ \entry{\Option{headsep}}{%
+ The composed option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} to horizontally span
+ the text area and vertically span the distance between the page head and
+ the text area.%
+ }%
+ \nentry{\KOption{height}{\PName{length}}}{%
+ Sets the height of the layer. Note, that \PName{length} can either be a
+ \LaTeX{} length, declared using \Macro{newlength}, or a \TeX{} length,
+ declared using \Macro{newdimen} or \Macro{newskip}, a length value like
+ 10\,pt, or a dimensional expression using +, -, /, *, (, and ). For more
+ information about valid dimensional expressions see
+ \cite[section~3.5]{manual:eTeX}.%
+ }%
+ \nentry{\KOption{hoffset}{\PName{length}}}{%
+ Sets the offset of the layer (depending on \Option{align} either left edge
+ of the layer, middle of the layer or right edge of the layer) from the
+ left edge of the paper. See \Option{height} for more information about
+ valid content of \PName{length}.%
+ }%
+ \entry{\Option{innermargin}}{%
+ The composed option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} to horizontally span
+ the distance between the right edge of text area and the right edge of the
+ paper on even pages or the distance between the left edge of the paper and
+ the left edge of the text area on odd pages and vertically span the whole
+ paper from the top edge to the bottom edge.%
+ }%
+ \entry{\Option{leftmargin}}{%
+ The composed option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} to horizontally span
+ the distance between the left edge of the paper and the left edge of the
+ text area and vertically span the whole paper from the top edge to the
+ bottom edge.%
+ }%
+ \entry{\Option{nonfloatpage}}{%
+ Restricts the layer to pages, that are not float pages. The option does
+ not expect any value. By the default the attribute is not set and
+ therefore layers would be printed on float pages and on non-float pages.%
+ }%
+ \entry{\Option{oddpage}}{%
+ Print the layer on odd pages only, but not on even pages. The option does
+ not expect any value. By the default the option is not set and therefore
+ layers would be printed on odd pages and on even pages.%
+ }%
+ \entry{\Option{oneside}}{%
+ Print the layer in single-side mode only, but not in two-side mode. The
+ option does not expect any value. By the default the attribute is not set
+ and therefore layers would be printed in single-side and two-side mode.%
+ }%
+ \entry{\Option{outermargin}}{%
+ The composed option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} to horizontally span
+ the distance between the left edge of the paper and the left edge of the
+ text area on even pages or the distance between the right edge of the text
+ area and the right edge of the paper on odd pages and vertically span the
+ whole paper from the top edge to the bottom edge.%
+ }%
+ \entry{\Option{page}}{%
+ The composed option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} to horizontally and
+ vertically span the whole paper from the left edge to the right edge and
+ the top edge to the bottom edge.%
+ }%
+ \entry{\Option{rightmargin}}{%
+ The composed option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} to horizontally span
+ the distance between the right edge of text area and the right edge of the
+ paper and vertically span the whole paper from the top edge to the bottom
+ edge.%
+ }%
+ \entry{\Option{textarea}}{%
+ The composed option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} to horizontally and
+ vertically span the whole text area from the left edge to the right edge
+ and the top edge to the bottom edge.%
+ }%
+ \entry{\Option{topmargin}}{%
+ The composed option sets \Option{hoffset}, \Option{voffset},
+ \Option{width}, \Option{height}, and \Option{align} to horizontally span
+ the whole page from the left edge to the right edge and vertically span
+ the distance between the top edge of the paper and the page head.%
+ }%
+ \entry{\Option{twoside}}{%
+ Print the layer in two-side mode only, but not in single-side mode. The
+ option does not expect any value. By the default the attribute is not set
+ and therefore layers would be printed in single-side and two-side mode.%
+ }%
+ \nentry{\KOption{voffset}{\PName{length}}}{%
+ Sets the offset of the layer (depending on \Option{align} either top edge
+ of the layer, middle of the layer or bottom edge of the layer) from the
+ top edge of the paper. See \Option{height} for more information about
+ valid content of \PName{length}.%
+ }%
+ \nentry{\KOption{width}{\PName{length}}}{%
+ Sets the width of the layer. See \Option{height} for more information
+ about valid content of \PName{length}.%
+ }%
+\end{desclist}
+%
+\EndIndex{Cmd}{ModifyLayer}%
+\EndIndex{Cmd}{RedeclareLayer}%
+\EndIndex{Cmd}{ProvideLayer}%
+\EndIndex{Cmd}{DeclareNewLayer}%
+\EndIndex{Cmd}{DeclareLayer}%
+
+\begin{Declaration}
+ \Macro{layerxoffset}\\
+ \Macro{layeryoffset}\\
+ \Macro{layerwidth}\\
+ \Macro{layerheight}%
+\end{Declaration}
+\BeginIndex{Cmd}{layerxoffset}%
+\BeginIndex{Cmd}{layeryoffset}%
+\BeginIndex{Cmd}{layerwidth}%
+\BeginIndex{Cmd}{layerheight}%
+These commands are valid during output of the layer's contents only. So they
+can only be used inside the \PName{code} of option \Option{contents} of the
+previously described commands. In this case they give the effective position
+and dimension of the layer, that will be used for the output. However, the
+effective dimension of the layer's contents may differ, i.\,e., if the
+contents are oversized or do not fill the layer completely. Redefinition of
+the commands to change the stored values is strictly forbidden and would
+result in unpredictable issues.%
+\EndIndex{Cmd}{layerheight}%
+\EndIndex{Cmd}{layerwidth}%
+\EndIndex{Cmd}{layeryoffset}%
+\EndIndex{Cmd}{layerxoffset}%
+
+\begin{Declaration}
+ \Macro{IfLayerExists}%
+ \Parameter{string}\Parameter{then-code}\Parameter{else-code}
+\end{Declaration}
+\BeginIndex{Cmd}{IfLayerExists}%
+This command may be used to execute code depending on whether or not a layer
+has been defined already. If the layer exists \PName{then-code} will be
+executed, otherwise \PName{else-code}. Note, the command cannot really
+test whether a layer exists. It uses a heuristic, that will never be false
+negative, but may be false positive. Nevertheless, if it is false positive
+something went wrong, either an incompatible package has been used or the user
+made something he should not do.%
+\EndIndex{Cmd}{IfLayerExists}
+
+\begin{Declaration}
+ \Macro{DestroyLayer}\Parameter{layer name}
+\end{Declaration}
+\BeginIndex{Cmd}{DestroyLayer}%
+This command sets all macros corresponding with the layer with given
+\PName{layer name} to \Macro{relax}, if a layer with that name exists. As a result the layer cannot be used any longer. It does not matter, if the layer
+is still part of the layer list of a page style, because such destroyed layers
+will be ignored. Nevertheless, destroyed layers may be defined again using
+\Macro{DeclareNewLayer} or \Macro{ProvideLayer}, but cannot be changed using
+\Macro{RedeclareLayer} or \Macro{ModifyLayer} any longer.
+
+The command is intended to be used inside
+\Macro{scrlayerOnAutoRemoveInterface} to remove layers, which have been
+defined using removable macros of an interface, whenever the interface would
+be removed.%
+\EndIndex{Cmd}{DestroyLayer}
+
+\begin{Declaration}
+ \Macro{layercontentsmeasure}%
+\end{Declaration}
+\BeginIndex{Cmd}{layercontentsmeasure}%
+The command \Macro{layercontentsmeasure} is internally used, if option
+\Option{draft} has been set, so visualise the layers. The visualisation will
+be done with a centimetre ruler at the top and left edge of the layer and an
+inch ruler at the bottom and right edge of the layer. The rulers will be drawn
+behind the content of the layer. If you would, you could also use it as
+exclusive content of a layer.%
+\EndIndex{Cmd}{layercontentsmeasure}
+
+
+\section{Declaration and Management of Page Styles}
+\label{sec:scrlayer.pagestyles}
+
+Until now we know layers, but we do not know how to use them. The
+perhaps astonishing answer is: with page styles. In \LaTeX{}, page
+styles usually define heads and foots of odd and even pages.
+
+The head and foot of odd pages will be printed on pages with odd
+page number in two-side mode or on all pages in single-side mode. This is
+something like the layer attributes \Option{oddpage} and \Option{evenpage}.
+
+The page head will be printed before the main contents of a page. The page
+footer will be printed after the main contents of a page. So this is something
+like the layer attributes \Option{background} and \Option{foreground}.
+
+So it's obvious to declare page styles to be a list of layers. But instead of
+having only four attributes \Option{oddpage}, \Option{evenpage},
+\Option{background}, and \Option{foreground} all the attributes of layers
+shown in \autoref{sec:scrlayer.layers} may be used.
+
+The outcome of this is that layer page styles are one type of page styles
+\Package{scrlayer} provides. A layer page style consists of layers and
+several \emph{hooks}. For description of layers see
+\autoref{sec:scrlayer.layers}. The \emph{hooks} are points in the expansion
+or execution of page styles and you may add additional code that will be
+expanded there. Advanced users know this already from commands like
+\Macro{AtBeginDocument} (see \cite{latex:usrguide}) or
+\Macro{BeforeClosingMainAux} (see
+\autopageref{desc:scrlfile.cmd.BeforeClosingMainAux}).
+
+Alias page styles are another type of page styles, provided by
+\Package{scrlayer}. An alias page style simply consists of another page
+style. In other words, the name of an alias page style is an alias name of
+another page style, the aliased or original page style. Because of this, the
+manipulation of an alias page style results in the manipulation of the
+original page style. If the original page style is an alias page style too,
+the manipulation will result in the manipulation of the aliased page style of
+that original page style and so on until a real page style will be
+manipulated. You may not only alias layer page styles made with
+\Package{scrlayer}, but all kind of page styles.
+
+\begin{Declaration}
+ \Macro{currentpagestyle}
+\end{Declaration}
+\BeginIndex{Cmd}{currentpagestyle}%
+Package scrlayer patches \Macro{pagestyle} to set \Macro{currentpagestyle} to
+the currently active page style. Note, \Macro{thispagestyle} does not
+change \Macro{currentpagestyle}. But if you use \Macro{thispagestyle} the
+result of \Macro{currentpagestyle} may be changed while execution of the
+\LaTeX{} output routine. This may be relevant only, if
+\Macro{currentpagestyle} has been used protected until execution of the output
+routine.
+
+Note, the layer page styles described later in this section, will not need
+the patch of \Macro{pagestyle} to set \Macro{currentpagestyle}. The patch has
+been made for usage with other page styles. Note also,
+\Macro{currentpagestyle} is empty before the first \Macro{pagestyle} after
+loading \Package{scrlayer}. So if you define an end user page style interface,
+it may be useful to use an implicit \Macro{pagestyle} to set the current page
+style to a default page style.%
+\EndIndex{Cmd}{currentpagestyle}
+
+\begin{Declaration}
+ \Macro{BeforeSelectAnyPageStyle}\Parameter{code}\\
+ \Macro{AfterSelectAnyPageStyle}\Parameter{code}%^^A
+\end{Declaration}
+\BeginIndex{Cmd}{BeforeSelectAnyPageStyle}%
+\BeginIndex{Cmd}{AfterSelectAnyPageStyle}%
+The command \Macro{BeforeSelectAnyPageStyle} adds \PName{code} to the hook
+that will be executed inside of \Macro{pagestyle} just before the page style
+will be selected. You may use \texttt{\#1} as a placeholder for the argument
+of \Macro{pagestyle}.
+
+The command \Macro{AfterSelectAnyPageStyle} is similar, but the \PName{code}
+will be executed just after the page style has been selected and after
+\Macro{currentpagestyle} has been set to the name of real page style.
+
+Note\textnote{Attention!}, \PName{code} of both commands will be executed
+only, if a page style will be selected using \Macro{pagestyle}, but not,
+e.\,g., if a page style will be selected using \Macro{thispagestyle}. Note
+also, you cannot remove \PName{code} from the hook after adding it. But
+the \PName{code} will be added locally, so you may use a group to limit the
+scope of \PName{code}.%^^A
+\EndIndex{Cmd}{AfterSelectAnyPageStyle}
+\EndIndex{Cmd}{BeforeSelectAnyPageStyle}
+
+\begin{Declaration}
+ \Macro{DeclarePageStyleAlias}%
+ \Parameter{alias page style name}\Parameter{original page style name}\\
+ \Macro{DeclareNewPageStyleAlias}%
+ \Parameter{alias page style name}\Parameter{original page style name}\\
+ \Macro{ProvidePageStyleAlias}%
+ \Parameter{alias page style name}\Parameter{original page style name}\\
+ \Macro{RedeclarePageStyleAlias}%
+ \Parameter{alias page style name}\Parameter{original page style name}
+\end{Declaration}
+\BeginIndex{Cmd}{DeclarePageStyleAlias}%
+\BeginIndex{Cmd}{DeclareNewPageStyleAlias}%
+\BeginIndex{Cmd}{ProvidePageStyleAlias}%
+\BeginIndex{Cmd}{RedeclarePageStyleAlias}%
+These commands may be used to define a page style with name \PName{alias page
+ style name} that is simply an alias for an already existing page style with
+name \PName{original page style name}. If there's already a page style
+\PName{alias page style name} it will be destroyed before creating the alias
+using \Macro{DeclarePageStyleAlias} or \Macro{RedeclarePageStyleAlias}.
+
+\Macro{DeclareNewPageStyleAlias} will throw an error message, if a page style
+\PName{alias page style name} has already been defined before. It does not
+matter if the already defined page style is a layer page style, an alias page
+style or another page style.
+
+\Macro{ProvidePageStyleAlias} will define the alias only, if a page style
+\PName{alias page style name} has not been defined before. If a page style
+\PName{alias page style name} already exists nothing will be done.
+
+\Macro{RedeclarePageStyleAlias} expects an already existing page style
+\PName{alias page style name}. It will destroy that page style and afterwards
+define the alias. If the page style \PName{alias page style name} does not
+exist, then you will get an error.%
+\EndIndex{Cmd}{RedeclarePageStyleAlias}%
+\EndIndex{Cmd}{ProvidePageStyleAlias}%
+\EndIndex{Cmd}{DeclareNewPageStyleAlias}%
+\EndIndex{Cmd}{DeclarePageStyleAlias}
+
+\begin{Declaration}
+ \Macro{DestroyPageStyleAlias}\Parameter{page style name}%
+\end{Declaration}
+\BeginIndex{Cmd}{DestroyPageStyleAlias}%
+This command makes the page style with given \PName{page style name}
+\LaTeX-undefined, if it is an alias for another page style. After this, the
+page style may be defined newly with, e.g., \Macro{DeclareNewAliasPageStyle}
+or \Macro{ProvideAliasPageStyle}.
+
+The command is intended to be used inside of
+\Macro{scrlayerOnAutoRemoveInterface} to remove page styles that have been
+declared by an interface and uses removable macros of that interface.%
+\EndIndex{Cmd}{DestroyPageStyleAlias}
+
+\begin{Declaration}
+ \Macro{GetRealPageStyle}\Parameter{page style name}%
+\end{Declaration}
+\BeginIndex{Cmd}{GetRealPageStyle}%
+The command will result in the (recursive) real page name of the page style,
+if the page style with given name \PName{page style name} is an alias of
+another page style. In all other cases, even if there's no alias and no page
+style named \PName{page style name}, the result would be simply \PName{page
+ style name}. The command is fully expandable and may be used, e.g., in the
+second argument of \Macro{edef}.%
+\EndIndex{Cmd}{GetRealPageStyle}
+
+\begin{Declaration}
+ \Macro{DeclarePageStyleByLayers}%
+ \OParameter{option list}\Parameter{page style name}\Parameter{layer list}\\
+ \Macro{DeclareNewPageStyleByLayers}%
+ \OParameter{option list}\Parameter{page style name}\Parameter{layer list}\\
+ \Macro{ProvidePageStyleByLayers}%
+ \OParameter{option list}\Parameter{page style name}\Parameter{layer list}\\
+ \Macro{RedeclarePageStyleByLayers}%^
+ \OParameter{option list}\Parameter{page style name}\Parameter{layer list}%
+\end{Declaration}
+\BeginIndex{Cmd}{DeclarePageStyleByLayers}%
+\BeginIndex{Cmd}{DeclareNewPageStyleByLayers}%
+\BeginIndex{Cmd}{ProvidePageStyleByLayers}%
+\BeginIndex{Cmd}{RedeclarePageStyleByLayers}%
+These commands declare a page style with \PName{page style name}. The page
+style will consist of the layers given in \PName{layer list}, a comma
+separated list of layer names. Note, the \PName{page style name} and the
+layer names at the \PName{layer list} must be fully expandable and should
+expand to letters. Several other characters are tolerated, but,
+nevertheless, are not recommended.
+
+The \PName{option list} is a comma separated list of
+\OptionValue{\PName{key}}{\PName{value}} options. These options may be used to
+set additional features. Currently they are used to set the code that should
+be expanded or executed at several \emph{hooks}. See the introduction to this
+section for more general information about \emph{hooks}. See
+\autoref{tab:scrlayer.pagestyle.hooks} for more information about the hooks
+and their purpose.
+
+\begin{desclist}
+ \desccaption{%
+ The \emph{hook} options for page styles (in order of
+ execution)\label{tab:scrlayer.pagestyle.hooks}%
+ }{%
+ The \emph{hook} options for page styles (\emph{Continuation})%
+ }%
+ \entry{\KOption{onselect}\PName{code}}{%
+ Execute \PName{code} whenever the page style will be selected using, e.g.,
+ \Macro{pagestyle}. Note\textnote{Attention!}, \Macro{thispagestyle}
+ does not select the page style immediately, but asynchronously inside
+ \LaTeX's output routine.%
+ }%
+ \entry{\KOption{oninit}\PName{code}}{%
+ Execute \PName{code} whenever the output of the layers of a page style
+ will be initialised. Note\textnote{Attention!}, this will be done
+ twice for every page: once for background layers and once for foreground
+ layers.%
+ }%
+ \entry{\KOption{ononeside}\PName{code}}{%
+ Execute \PName{code} whenever the output of the layers of a page style in
+ single-side mode will initialised. Note\textnote{Attention!}, this
+ will be done twice for every page: once for background layers and once for
+ foreground layers.%
+ }%
+ \entry{\KOption{ontwoside}\PName{code}}{%
+ Execute \PName{code} whenever the output of the layers of a page style in
+ two-side mode will initialised. Note\textnote{Attention!}, this will
+ be done twice for every page: once for background layers and once for
+ foreground layers.%
+ }%
+ \entry{\KOption{onoddpage}\PName{code}}{%
+ Execute \PName{code} whenever the output of the layers of a page style on
+ an odd page will initialised. Note\textnote{Attention!}, this will be
+ done twice for every page: once for background layers and once for
+ foreground layers. Note\textnote{Attention!} also, in single-side
+ mode all pages are odd pages, not only pages with odd page numbers.%
+ }%
+ \entry{\KOption{onevenpage}\PName{code}}{%
+ Execute \PName{code} whenever the output of the layers of a page style on
+ an even page will initialised. Note\textnote{Attention!}, this will
+ be done twice for every page: once for background layers and once for
+ foreground layers. Note\textnote{Attention!} also, there are not even
+ pages in single-side mode, but all pages are odd pages, not only pages
+ with odd page numbers.%
+ }%
+ \entry{\KOption{onfloatpage}\PName{code}}{%
+ Execute \PName{code} whenever the output of the layers of a page style on
+ a float page will initialised. Note\textnote{Attention!}, this will
+ be done twice for every page: once for background layers and once for
+ foreground layers. Note\textnote{Attention!} also, float pages are
+ only those pages with p-placed floating objects.%
+ }%
+ \entry{\KOption{onnonfloatpage}\PName{code}}{%
+ Execute \PName{code} whenever the output of the layers of a page style on
+ a non-float page will initialised. Note\textnote{Attention!}, this
+ will be done twice for every page: once for background layers and once for
+ foreground layers. Note\textnote{Attention!} also, non-float pages
+ are all pages that are not float-pages. Those pages may have t-placed,
+ h-placed, b-placed, or no floating objects.%
+ }%
+ \entry{\KOption{onbackground}\PName{code}}{%
+ Execute \PName{code} whenever the output of the layers of a page style in
+ the background of a page will initialised. Note\textnote{Attention!},
+ this will be done once for every page.%
+ }%
+ \entry{\KOption{onforeground}\PName{code}}{%
+ Execute \PName{code} whenever the output of the layers of a page style in
+ the foreground of a page will initialised. Note\textnote{Attention!},
+ this will be done once for every page.%
+ }%
+\end{desclist}
+
+The difference of \Macro{DeclarePageStyleByLayers} and
+\Macro{DeclareNewPageStyleByLayers} is that \Macro{DeclareNewPageStyleByLayers}
+will result in an error, if a page style with name \PName{page style name}
+already exists. Note, declaring a page style, which is an alias of another
+page style (see \Macro{DeclareAliasPageStyle} prior in this section), will not
+re-declare the page style itself, but it's real page style (see
+\Macro{GetRealPageStyle} prior in this section).
+
+The difference of \Macro{DeclarePageStyleByLayers} and
+\Macro{ProvidePageStyleByLayers} is that \Macro{ProvidePageStyleByLayers}
+will simply do nothing, if there's already a page style with name \PName{page
+ style name}. In difference to \Macro{DeclareNewPageStyleByLayers} it will not
+raise an error in this case.
+
+The difference of \Macro{DeclarePageStyleByLayers} and
+\Macro{RedeclarePageStyleByLayers} is, that \Macro{RedeclarePageStyleByLayers}
+may be used only, if the real page style of \PName{page style name} already
+exists. Otherwise an error would occur.
+
+Please have also a look at the notes to following pseudo page style
+\Pagestyle{@everystyle@}.%
+\EndIndex{Cmd}{RedeclarePageStyleByLayers}%
+\EndIndex{Cmd}{ProvidePageStyleByLayers}%
+\EndIndex{Cmd}{DeclareNewPageStyleByLayers}%
+\EndIndex{Cmd}{DeclarePageStyleByLayers}%
+
+\begin{Declaration}
+ \Pagestyle{@everystyle@}\\
+ \Pagestyle{empty}
+\end{Declaration}
+\BeginIndex{Pagestyle}{@everysel@}%
+\BeginIndex{Pagestyle}{empty}%
+There are two somehow special, default layer page styles. The first one is
+\Pagestyle{@everystyle@}. This page style should not be used normally, but the
+layers of this page style will be used by all the other layer page styles. So
+adding a layer to this page style would be similar to adding this layer to all
+other layer page styles even the empty one. There's one difference: Layer
+referencing commands of the page style interface like
+\Macro{ForEachLayerOfPageStyle}, \Macro{AddLayerToPageStyleBeforeLayer}, or
+\Macro{AddLayerToPageStyleAfterLayer} ignore the layers of
+\Pagestyle{@everystyle@} if they are used for another layer page style.
+
+The other somehow special page style is \Pagestyle{empty}. Normally page style
+\Pagestyle{empty} is defined by the \LaTeX{} kernel, to be a page style
+without page head or page foot. Package \Package{scrlayer} re-defines it to be
+a layer page style without any layer. Nevertheless, you may use it like every
+other layer page style too. The main advantage above the \LaTeX{} kernel's
+empty page style is that it also executes the layers of special layer page
+style \Pagestyle{@everysel@}.%
+\EndIndex{Pagestyle}{empty}%
+\EndIndex{Pagestyle}{@everysel@}%
+
+\begin{Declaration}
+ \KOption{onpsselect}\PValue{code}\\
+ \KOption{onpsinit}\PValue{code}\\
+ \KOption{onpsoneside}\PValue{code}\\
+ \KOption{onpstwoside}\PValue{code}\\
+ \KOption{onpsoddpage}\PValue{code}\\
+ \KOption{onpsevenpage}\PValue{code}\\
+ \KOption{onpsfloatpage}\PValue{code}\\
+ \KOption{onpsnonfloatpage}\PValue{code}\\
+ \KOption{onpsbackground}\PValue{code}\\
+ \KOption{onpsforeground}\PValue{code}
+\end{Declaration}
+\BeginIndex{Option}{onpsselect~=\PName{code}}%
+\BeginIndex{Option}{onpsinit~=\PName{code}}%
+\BeginIndex{Option}{onpsoneside~=\PName{code}}%
+\BeginIndex{Option}{onpstwoside~=\PName{code}}%
+\BeginIndex{Option}{onpsoddpage~=\PName{code}}%
+\BeginIndex{Option}{onpsevenpage~=\PName{code}}%
+\BeginIndex{Option}{onpsfloatpage~=\PName{code}}%
+\BeginIndex{Option}{onpsnonfloatpage~=\PName{code}}%
+\BeginIndex{Option}{onpsbackground~=\PName{code}}%
+\BeginIndex{Option}{onpsforeground~=\PName{code}}%
+There's also a \KOMAScript{} option for each of those \texttt{hooks}. The
+names of the \KOMAScript{} options are similar to the names of the page style
+options, but with ``\texttt{ps}'' inserted behind ``\texttt{on}''. The value of
+the \KOMAScript{} options are the initial defaults of the corresponding
+\texttt{hooks}. This default will be extended by every usage of the page style
+options at the \PName{option list}. You may remove the default, using
+\Macro{ModifyLayerPageStyleOptions} described later in this section.%
+\EndIndex{Option}{onpsforeground~=\PName{code}}%
+\EndIndex{Option}{onpsbackground~=\PName{code}}%
+\EndIndex{Option}{onpsnonfloatpage~=\PName{code}}%
+\EndIndex{Option}{onpsfloatpage~=\PName{code}}%
+\EndIndex{Option}{onpsevenpage~=\PName{code}}%
+\EndIndex{Option}{onpsoddpage~=\PName{code}}%
+\EndIndex{Option}{onpstwoside~=\PName{code}}%
+\EndIndex{Option}{onpsoneside~=\PName{code}}%
+\EndIndex{Option}{onpsinit~=\PName{code}}%
+\EndIndex{Option}{onpsselect~=\PName{code}}%
+
+\begin{Declaration}
+ \KOption{deactivatepagestylelayers}\PName{simple switch}\\
+ \Macro{ForEachLayerOfPageStyle}\Parameter{page style name}\Parameter{code}
+\end{Declaration}
+\BeginIndex{Cmd}{ForEachLayerOfPageStyle}%
+As long as \KOMAScript{} option \Option{deactivatepagestylelayers} has not been
+activated command \Macro{ForEachLayerOfPageStyle} can be used to process
+\PName{code} for every layer that is a member of the layers list of a page
+style with given \PName{page style name}. Inside of \PName{code} the place
+holder \PValue{\#1} may be used for the name of the current layer.
+\begin{Example}
+ If you want to output the names of all layers of page style
+ \PValue{scrheadings}, you may us:
+\begin{lstcode}
+ \let\commaatlist\empty
+ \ForEachLayerOfPageStyle{scrheadings}{%
+ \commaatlist#1\gdef\commaatlist{, }}
+\end{lstcode}
+\end{Example}
+Usage of \Macro{gdef} instead of \Macro{def} is necessary in the example
+above, because \Macro{ForEachLayerOfPageStyle} executes the \PName{code}
+inside of a group to minimise side effects. Here \Macro{gdef} redefines
+\Macro{commaatlist} globally, so it would be still valid at the execution of
+\PName{code} for the next layer.
+
+Several other commands of \Package{scrlayer} also
+use \Macro{ForEachLayerOfPageStyle} internally. So these also do not process
+any layer if \KOMAScript{} option \Option{deactivatepagestylelayers} would be
+activated. So you may use this options, e.g., to hide all layers of all layer
+page styles.%
+\EndIndex{Cmd}{ForEachLayerOfPageStyle}%
+
+\begin{Declaration}
+ \Macro{AddLayersToPageStyle}%
+ \Parameter{page style name}\Parameter{layer list}\\
+ \Macro{AddLayersAtBeginOfPageStyle}%
+ \Parameter{page style name}\Parameter{layer list}\\
+ \Macro{AddLayersAtEndOfPageStyle}%
+ \Parameter{page style name}\Parameter{layer list}\\
+ \Macro{RemoveLayersFromPageStyle}%
+ \Parameter{page style name}\Parameter{layer list}%
+\end{Declaration}
+\BeginIndex{Cmd}{AddLayersToPageStyle}%
+\BeginIndex{Cmd}{AddLayersAtBeginOfPageStyle}%
+\BeginIndex{Cmd}{AddLayersAtEndOfPageStyle}%
+\BeginIndex{Cmd}{RemoveLayersFromPageStyle}%
+You can use these commands to add layers to a layer page style or to remove
+layers from a layer page style. The page style will be referenced by it
+\PName{page style name}. The layers are given by a comma separated
+\PName{layer list}.
+
+The commands \Macro{AddLayersToPageStyle} and \Macro{AddLayersAtEndOfPageStyle}
+add all layers of the comma separated list of layers \PName{layer list} at
+the end of the layer list of layer page style \PName{page style
+ name}. Logically the added layers would be above or in front of the old
+layers of the page style. Nevertheless, new background layers would be behind
+the text layer and therefore behind all foreground layers.
+
+Command \Macro{AddLayersAtBeginOfPageStyle} adds the new layers at the begin
+of the layer list of the page style. Note, the layers
+will be added in the order of the \PName{layer list}. The first layer at
+\PName{layer list} will be added first, the second layer will be added second
+and so on. So with \Macro{AddLayersAtBeginOfPageStyle} the last layer at
+\PName{layer list} will become the new first layer of the layer list of layer
+page style \PName{page style name}.
+
+Command \Macro{RemoveLayersFromPageStyle} may be used to remove layers from
+the layer list of layer page style \PName{page style name} instead of adding
+them. Note, layers, which are part of \PName{layer list}, but not part of
+the page style's layer list, will be ignored. But adding or removing layers
+from a page style, which is not a layer page style or an alias of a layer page
+style, would be a mistake and result in an error message.%
+\EndIndex{Cmd}{RemoveLayersFromPageStyle}%
+\EndIndex{Cmd}{AddLayersAtEndOfPageStyle}%
+\EndIndex{Cmd}{AddLayersAtBeginOfPageStyle}%
+\EndIndex{Cmd}{AddLayersToPageStyle}
+
+\begin{Declaration}
+ \Macro{AddLayersToPageStyleBeforeLayer}%
+ \Parameter{page style name}\Parameter{layer list}%
+ \Parameter{reference layer name}\\
+ \Macro{AddLayersToPageStyleAfterLayer}%
+ \Parameter{page style name}\Parameter{layer list}%
+ \Parameter{reference layer name}
+\end{Declaration}
+\BeginIndex{Cmd}{AddLayersToPageStyleBeforeLayer}%
+\BeginIndex{Cmd}{AddLayersToPageStyleAfterLayer}%
+These commands are similar to the commands described before, but they do not
+add the layers at the begin or end of the layer list of a layer page style,
+but just before or after a reference layer at the layer list of a layer page
+style. Note, in this case the order of the \PName{layer list} will be
+same in the layer list of \PName{page style name} after adding. If the
+reference layer named \PName{reference layer name} is not part of the layer
+list of the layer page style, nothing happens.%
+\EndIndex{Cmd}{AddLayersToPageStyleAfterLayer}%
+\EndIndex{Cmd}{AddLayersToPageStyleBeforeLayer}
+
+\begin{Declaration}
+ \Macro{UnifyLayersAtPageStyle}\Parameter{page style name}
+\end{Declaration}
+\BeginIndex{Cmd}{UnifyLayersAtPageStyle}%
+With the commands described before in this section you may not only add
+different layers to a page style, but even add the same layer several times to
+a page style. In most cases it does not make sense to have one layer several
+times at the layer list of a layer page style. So you may use
+\Macro{UnifyLayersAtPageStyle} to remove all dupes of layers from the layer
+list of a layer page style.
+
+Note\textnote{Attention!}, the order of layers may change! So if
+you want a special order, you should remove all layers and add the layers in
+the order you want instead of using \Macro{UnifyLayersAtPageStyle}.%
+\EndIndex{Cmd}{UnifyLayersAtPageStyle}
+
+\begin{Declaration}
+ \Macro{ModifyLayerPageStyleOptions}%
+ \Parameter{page style name}\Parameter{option list}\\
+ \Macro{AddToLayerPageStyleOptions}%
+ \Parameter{page style name}\Parameter{option list}
+\end{Declaration}
+\BeginIndex{Cmd}{ModifyLayerPageStyleOptions}%
+\BeginIndex{Cmd}{AddToLayerPageStyleOptions}%
+Command \Macro{ModifyLayerPageStyleOptions} may be used to modify the page
+style options of a layer page style. Only options at the comma separated
+\PName{option list} will be set to the new values given in \PName{option list}
+if the new value is not empty. Options, which are not at \PName{option list},
+will stay unchanged. If you want to set an option to \emph{do nothing} you may
+use value \Macro{relax}. Note, setting an option to a new value using
+\Macro{ModifyLayerPageStyleOptions} will remove the previous value including
+the global default value.
+
+\Macro{AddToLayerPageStyleOptions} differs from
+\Macro{ModifyLayerPageStyleOptions} in that point. It will not overwrite the
+previous values, but adds\,---\,or more precisely: concatenates\,---\, the new
+values to the previous values of the options at \PName{option list}.%
+\EndIndex{Cmd}{AddToLayerPageStyleOptions}%
+\EndIndex{Cmd}{ModifyLayerPageStyleOptions}%
+
+\begin{Declaration}
+ \Macro{IfLayerPageStyleExists}%
+ \Parameter{page style name}\Parameter{then code}\Parameter{else code}\\
+ \Macro{IfRealLayerPageStyleExists}%^
+ \Parameter{page style name}\Parameter{then code}\Parameter{else code}%
+\end{Declaration}
+\BeginIndex{Cmd}{IfLayerPageStyleExists}%
+\BeginIndex{Cmd}{IfRealLayerPageStyleExists}%
+Command \Macro{IfLayerPageStyleExists} tests, whether or not the real page
+style of \PName{page style name} is a layer page style. If the test is true,
+\PName{then code} will be executed. If \PName{page style name} is neither a
+layer page style, nor an alias of a layer page style, nor an alias of an alias
+of \dots\ a layer page style, \PName{else code} will be executed. Internally
+this command is often used to throw an error message if you use one of the
+layer page style commands with an \PName{page style name} that does not
+correspond with a layer page style.
+
+Command \Macro{IfRealLayerPageStyleExists} is similar, but \PName{then code}
+will only be executed, if \PName{page style name} itself is the name of a
+layer page style. So \PName{else code} will even be executed, if \PName{page
+ style name} is an alias name of a layer page style or the alias name of an
+alias name of \dots\ a layer page style.%
+\EndIndex{Cmd}{IfRealLayerPageStyleExists}%
+\EndIndex{Cmd}{IfLayerPageStyleExists}%
+
+\begin{Declaration}
+ \Macro{IfLayerAtPageStyle}%
+ \Parameter{page style name}\Parameter{layer name}%
+ \Parameter{then code}\Parameter{else code}\\
+ \Macro{IfSomeLayerAtPageStyle}%
+ \Parameter{page style name}\Parameter{layer list}%^
+ \Parameter{then code}\Parameter{else code}\\
+ \Macro{IfLayerAtPageStyle}%
+ \Parameter{page style name}\Parameter{layer list}%
+ \Parameter{then code}\Parameter{else code}%
+\end{Declaration}
+\BeginIndex{Cmd}{IfLayerAtPageStyle}%
+\BeginIndex{Cmd}{IfSomeLayersAtPageStyle}%
+\BeginIndex{Cmd}{IfLayersAtPageStyle}%
+Command \Macro{IfLayerAtPageStyle} may be used to test, whether or not a layer
+named \PName{layer name} is a member of the layer list of a given page
+style. If the test is true, the \PName{then code} will be executed. If the
+layer is not a member of the layer list of \PName{page style name}, the
+\PName{else code} will be executed.
+
+Commands \Macro{IfSomeLayerAtPageStyle} and \Macro{IfLayersAtPageStyle} do not
+only test one layer but several layers at a given, comma separated
+\PName{layer list}. \Macro{IfSomeLayerAtPageStyle} will execute the
+\PName{then code} if \emph{at least one} of the layers at \PName{layer list}
+is a member of the layer list of \PName{page style name}. In difference
+\Macro{IfLayersAtPageStyle} executes the \PName{then code} only, if \emph{all}
+of the layers at \PName{layer list} are members of the layer list of
+\PName{page style name}.%
+\EndIndex{Cmd}{IfLayersAtPageStyle}%
+\EndIndex{Cmd}{IfSomeLayersAtPageStyle}%
+\EndIndex{Cmd}{IfLayerAtPageStyle}
+
+\begin{Declaration}
+ \Macro{DestroyRealLayerPageStyle}\Parameter{page style name}
+\end{Declaration}
+\BeginIndex{Cmd}{DestroyRealLayerPageStyle}%
+Command \Macro{DestroyRealLayerPageStyle} makes the page style named
+\PName{page style name} undefined, if and only if it is a layer page
+style. Nothing will be happen if it is an alias name of a layer page style, if
+it is another page style, or if it is not a page style.
+
+If \PName{page style name} is the name of the current page style the current
+page style will become a kind of empty page style. If the special page
+style\,---\,this may be set using \Macro{thispagestyle}\,---\,is \PName{page
+ style name}, this will be simply reset. So the previous
+\Macro{thispagestyle} will become invalid.
+
+Note, the layers of the page style will not be destroyed
+automatically. If you want to destroy the layers too, you may use
+\begin{lstcode}
+ \ForEachLayerOfPageStyle{...}{\DestroyLayer{#1}}
+\end{lstcode}
+\emph{before} destroying the layer page style.
+
+The command is intended to be used inside the auto-remove code of an interface
+See \autoref{sec:scrlayer.enduserinterfaces} below for more information about
+auto-remove code.%
+\EndIndex{Cmd}{DestroyRealLayerPageStyle}
+
+\LoadCommon{20} % \section{Height of Page Head and Foot}
+
+\LoadCommon{21} % \section{Manipulation of Defined Page Styles}
+
+\section{End User Interfaces}
+\label{sec:scrlayer.enduserinterfaces}
+
+Package \Package{scrlayer} provides an interface to define and manage
+(concurrent) end user interfaces. Maybe future releases of \KOMAScript{} will
+provide parts of this by package \Package{scrbase} and remove those commands
+from \Package{scrlayer}. But currently this part if \Package{scrlayer} is very
+experimental, so package \Package{scrlayer} provides its own interface
+definition commands. Currently you should not depend on correct working of
+auto-removing a concurrent end user interface. Instead you should avoid using
+concurrent end user interfaces.
+
+This section only describes the interface commands for defining end user
+interfaces. This is not interesting for end users, but only for authors of end
+user interfaces. End users will find information about the end user interfaces
+in the sections about the particular end user interface, e.g.,
+\autoref{cha:scrlayer-scrpage}, \autoref{cha:scrlayer-scrpage-experts}, and
+\autoref{cha:scrlayer-notecolumn}.
+
+\begin{Declaration}
+ \Macro{scrlayerInitInterface}\OParameter{interface name}
+\end{Declaration}
+\BeginIndex{Cmd}{scrlayerInitInterface}%
+Command \Macro{scrlayerInitInterface}
+registers a new interface. The \PName{interface name} must be unique. If you
+try to initialise an already initialised interface an error will occur. This
+command is obligatory and mandatory for interfaces. It should be the first
+interface command and therefore has been described first. If the optional
+argument is omitted, \PValue{\Macro{@currname}.\Macro{@currext}} will be
+used instead. For classes and packages this will be the file name of the class
+or package while loading the class or package. But you may use any sequence of
+characters with category letter or other.%
+\EndIndex{Cmd}{scrlayerInitInterface}
+
+\begin{Declaration}
+ \KOption{forceoverwrite}\PName{simple switch}\\
+ \KOption{autoremoveinterfaces}\PName{simple switch}\\
+ \Macro{scrlayerAddToInterface}%
+ \OParameter{interface name}\Parameter{command}\Parameter{code}\\
+ \Macro{scrlayerAddCsToInterface}%
+ \OParameter{interface name}\Parameter{command sequence}\Parameter{code}
+\end{Declaration}
+\BeginIndex{Option}{forceoverwrite}%
+\BeginIndex{Option}{autoremoveinterfaces}%
+\BeginIndex{Cmd}{scrlayerAddToInterface}%
+\BeginIndex{Cmd}{scrlayerAddCsToInterface}%
+One of the special features of end user interfaces is that they should
+register all interface dependent commands (also known as \emph{macros}). You
+may do this using \Macro{scrlayerAddToInterface}%^^A
+. If your interface generates macros not only at load time but also at run
+time or if the interface name should not be the class's or package's name, you
+have to use the optional argument to add the command to a dedicated
+interface. An error will occur, if the interface has not been initialised
+before.
+
+The first mandatory argument is the \PName{command}\footnote{The
+ \PName{command} consists of the backslash followed by a \PName{command
+ sequence} consisting of characters with category code letter or one other
+ character, or \PName{command} consists of one active character (without
+ backslash).} that should be added to the interface. If the command can be
+added to the interface, it will be added to the interface, will be set to
+\Macro{relax} and \PName{code} will be executed. You can use, e.g.,
+\Macro{newcommand}\PName{command} inside of \PName{code} to define
+\PName{command}.
+
+But when can a command be defined? If a command is undefined or \Macro{relax}
+it can be defined. If a command has already been defined and registered for
+another interface \emph{and} if \KOMAScript{} option
+\Option{autoremoveinterface} has been switched on, the other interface will be
+removed automatically and the new command will be set to \Macro{relax} and
+will be registered for the given interface. If a command
+has already been defined but is not part of another interface \emph{and} if
+\KOMAScript{} option \Option{forceoverwrite} has been switched on, the command
+will be set to \Macro{relax} and will be registered for the given interface.
+
+Command \Macro{scrlayerAddCsToInterface} is similar to
+\Macro{scrlayerAddToInterface} but does not expect a command as first,
+mandatory argument, but a command sequence\footnote{A command sequence may
+ consist of any characters with category code letter or other.}.%
+\EndIndex{Cmd}{scrlayerAddCsToInterface}%
+\EndIndex{Cmd}{scrlayerAddToInterface}
+\EndIndex{Option}{autoremoveinterfaces}%
+\EndIndex{Option}{forceoverwrite}%
+
+\begin{Declaration}
+ \Macro{scrlayerOnAutoRemoveInterface}%^^A
+ \OParameter{interface name}\Parameter{code}
+\end{Declaration}
+\BeginIndex{Cmd}{scrlayerOnAutoRemoveInterface}%
+Command \Macro{scrlayerOnAutoRemoveInterface}
+registers \PName{code} to be executed, if the interface will be automatically
+removed (see \Option{autoremoveinterfaces} prior in this section). This may be
+used, e.g., to automatically destroy layers or page styles (see
+\Macro{DestroyLayer}, \Macro{DestroyAliasPageStyle}, and
+\Macro{DestroyRealLayerPageStyle}).%
+\EndIndex{Cmd}{scrlayerOnAutoRemoveInterface}%
+%
+\EndIndex{Package}{scrlayer}
+
+%%% Local Variables:
+%%% mode: latex
+%%% mode: flyspell
+%%% coding: us-ascii
+%%% ispell-local-dictionary: "en_GB"
+%%% TeX-master: "../guide"
+%%% End:
+
+
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlfile.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlfile.tex
index a3bfa1aab2e..a01d445a1cf 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlfile.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlfile.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlfile.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlfile.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,10 +45,12 @@
%
% ============================================================================
-\ProvidesFile{scrlfile.tex}[2012/02/24 KOMA-Script guide (chapter: scrlfile)]
+\KOMAProvidesFile{scrlfile.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (chapter: scrlfile)]
\translator{Gernot Hassenpflug\and Markus Kohm}
-% Date of translated german file: 2012/02/25
+% Date of translated german file: 2013/11/24
\chapter{Control Package Dependencies with \Package{scrlfile}}
\labelbase{scrlfile}
@@ -210,10 +212,10 @@ The\important[i]{\Macro{AfterClass+}\\\Macro{AfterPackage+}}
plussed\ChangedAt{v3.09}{\Package{scrlfile}} version executes the
\PName{instructions} after loading of the class or package has been
finished. The difference to the starred version is only valid, if loading of
-the class or package already started but hasn't been finished
+the class or package already started but has not been finished
yet. Nevertheless, \PName{instructions} will be executed before the
instructions of \Macro{AtEndOfClass} or \Macro{AtEndOfPackage} when loading of
-the class or package hasn't been finished already.
+the class or package has not been finished already.
If\important[i]{\Macro{AfterClass!}\\\Macro{AfterPackage!}} a class uses
\Macro{AtEndOfClass} or a package uses \Macro{AtEndOfPackage} to execute
@@ -355,7 +357,7 @@ page of the document already have been shipped out before
\Macro{end}\PParameter{document}, the code above will not result in any
writing into the \File{aux}-file. If someone would try to fix this new problem
using \Macro{immediate} just before \Macro{write}, the inverse problem would
-occur: If the last page wasn't shipped out before
+occur: If the last page was not shipped out before
\Macro{end}\PParameter{document} the \Macro{writethistoaux} would be written
into \File{aux}-file before ship-out the last page. Another often seen
suggestion for this problem therefore is:
@@ -377,7 +379,7 @@ been enforced by the \Macro{clearpage}. After that, instructions like
Note at the end of the document.\par
}
\end{lstcode}
-wouldn't any longer output the note at the end of the last page of the
+would not any longer output the note at the end of the last page of the
document but at the end of one more page. Additionally \Macro{writethistoaux}
would be written one page to early into the \File{aux}-file again.
@@ -395,7 +397,7 @@ immediately after the final \Macro{clearpage}, that is part of
}
\end{lstcode}
This would be successful even if the final \Macro{clearpage} inside of
-\Macro{end}\PParameter{document} wouldn't really ship-out any page or if
+\Macro{end}\PParameter{document} would not really ship-out any page or if
someone have had used \Macro{clearpage} in the argument of
\Macro{AtEndDocument}.
@@ -517,7 +519,7 @@ Please\textnote{Attention!} note, that the \PName{replacement class} or the
\PName{replacement package} will be loaded with the same options, the
\PName{source class} or \PName{replacement class} would until it has been
replaced. Replacement of a class or package by a class or package, that
-doesn't support a requested option, would result in a warning or even an error
+does not support a requested option, would result in a warning or even an error
message. But you may declare such missing options using \Macro{BeforeClass} or
\Macro{BeforePackage}.
@@ -528,7 +530,7 @@ message. But you may declare such missing options using \Macro{BeforeClass} or
\ReplacePackage{oldfoo}{newfoo}
\end{lstcode}
Assumed the old package provides an option \Option{oldopt}, but the new
- package doesn't. Using
+ package does not. Using
\begin{lstcode}
\BeforePackage{newfoo}{%
\DeclareOption{oldopt}{%
@@ -578,6 +580,23 @@ class using \Macro{RequirePackage} instead of \Macro{usepackage}.
\EndIndex{Cmd}{ReplacePackage}%
\EndIndex{Cmd}{ReplaceClass}%
+\begin{Declaration}
+ \Macro{UnReplaceInput}\Parameter{file name}\\
+ \Macro{UnReplacePackage}\Parameter{package}\\
+ \Macro{UnReplaceClass}\Parameter{class}%
+\end{Declaration}
+\BeginIndex{Cmd}{UnReplaceInput}%
+\BeginIndex{Cmd}{UnReplacePackage}%
+\BeginIndex{Cmd}{UnReplaceClass}%
+A\ChangedAt{v3.12}{\Package{scrlfile}} replacement definition can be removed
+using one of these commands. The replacement definition of a input file should
+be removed using \Macro{UnReplaceInput}, the replacement definition of a
+package should be removed using \Macro{UnReplacePackage}, and the replacement
+definition of a class should be removed using \Macro{UnReplaceClass}.%
+\EndIndex{Cmd}{UnReplaceClass}%
+\EndIndex{Cmd}{UnReplacePackage}%
+\EndIndex{Cmd}{UnReplaceInput}%
+
\section{Prevent File Loading}
\label{sec:scrlfile.prevent}
@@ -590,9 +609,13 @@ of that package has to prevented. For this purpose \Package{scrlfile} again
provides a solution.
\begin{Declaration}
- \Macro{PreventPackageFromLoading}\Parameter{package list}
+ \Macro{PreventPackageFromLoading}\OParameter{instead code}%
+ \Parameter{package list}\\
+ \Macro{PreventPackageFromLoading*}\OParameter{instead code}%
+ \Parameter{package list}
\end{Declaration}
\BeginIndex{Cmd}{PreventPackageFromLoading}%
+\BeginIndex{Cmd}{PreventPackageFromLoading*}%
Calling this command\ChangedAt{v3.08}{\Package{scrlfile}} before loading a
package using \Macro{usepackage}\IndexCmd{usepackage},
\Macro{RequirePackage}\IndexCmd{RequirePackage}, or
@@ -610,7 +633,7 @@ the \PName{package list}.
\end{lstcode}
But now, you want to use
X\kern-.125em\lower.5ex\hbox{\reflectbox{E}}\LaTeX{} oder Lua\LaTeX{} the
- first time. In this case loading of \Package{fontenc} wouldn't be a good
+ first time. In this case loading of \Package{fontenc} would not be a good
suggestion and Latin-Modern would be the default font of the recommended
package \Package{fontspec}. Because of this you want to prevent both
packages from being loaded. This may be done, loading the class like this:
@@ -623,8 +646,21 @@ the \PName{package list}.
The example above also shows, that package \Package{scrlfile} may be loaded
before the class. In this case \Macro{RequirePackage}\IndexCmd{RequirePackage}
has to be used, because \Macro{usepackage} before \Macro{documentclass} is not
-permitted.%
-%
+permitted.
+
+If \PName{package list} is empty or contains a package, that already has been
+loaded, \Macro{PreventPackageFromLoading} will warn. If you'd prefer an
+info\ChangedAt{v3.12}{\Package{scrlfile}} at the log-file only, you may use
+\Macro{PreventPackageFromLoading*} instead.
+
+The optional argument\ChangedAt{v3.12}{\Package{scrlfile}} may be used to
+execute code instead of loading the package. But you must not load another
+packages or files inside \PName{instead code}. See \Macro{ReplacePackage} in
+\autoref{sec:scrlfile.macros} on
+\autopageref{desc:scrlfile.cmd.ReplacePackage} for information about replacing
+a package by another one. Note also, that the \PName{instead code} will be
+executed several times, if you try to load the package more than once!%
+\EndIndex{Cmd}{PreventPackageFromLoading*}%
\EndIndex{Cmd}{PreventPackageFromLoading}
\begin{Declaration}
@@ -670,9 +706,51 @@ been stored using \Macro{StorePreventPackageFromLoading} is responsible for
the correct restorability. For example the list elements must be separated by
comma, must not contain white space or group braces, and must be fully
expandable.
-%
+
+Please note\textnote{Attention!}, that \Macro{ResetPreventPackageFromLoading}
+does not clean the \PName{instead code} of a package. Only the execution is not
+done as long as the prevention is not reactivated.%
\EndIndex{Cmd}{ResetPreventPackageFromLoading}%
\EndIndex{Cmd}{StorePreventPackageFromLoading}%
+
+\begin{Declaration}
+ \Macro{UnPreventPackageFromLoading}\Parameter{package list}\\
+ \Macro{UnPreventPackageFromLoading*}\Parameter{package list}
+\end{Declaration}
+\BeginIndex{Cmd}{UnPreventPackageFromLoading}%
+\BeginIndex{Cmd}{UnPreventPackageFromLoading*}%
+Instead\ChangedAt{v3.12}{\Package{scrlfile}} of resetting the whole list of
+packages, that should prevented from being loaded, you may also remove some
+packages from that list. The star version of the command does also clean the
+\PName{instead code}. So reactivation of the prevent package list, e.\,g.,
+from a stored one, will not reactivate the \PName{instead code} of the
+packages.%
+%
+\begin{Example}
+ Assuming, you want to prevent a package \Package{foo} from being loaded, but
+ you do not want an already stored \PName{instead code} to be
+ executed. Instead of that code, you're own \PName{instead code} should be
+ executed. You can do this:
+\begin{lstcode}
+ \UnPreventPackageFromLoading*{foo}
+ \PreventPackageFromLoading[\typeout{Stattdessencode}]{foo}
+\end{lstcode}
+ For \Macro{UnPreventPackageFromLoading} it does not matter whether or not
+ the package has been prevented from being loaded before.
+
+ Surely you can use the command also to remove only the \PName{instead code}
+ of all packages:
+\begin{lstcode}
+ \StorePreventPackageFromLoading\TheWholePreventList
+ \UnPreventPackageFromLoading*{\TheWholePreventList}
+ \PreventPackageFromLoading{\TheWholePreventList}
+\end{lstcode}
+ In this case the packages, that has been prevented from being loaded, are
+ still prevented from being loaded, but their \PName{instead code} has been
+ cleaned and will not be executed any longer.%
+\end{Example}%
+\EndIndex{Cmd}{UnPreventPackageFromLoading*}%
+\EndIndex{Cmd}{UnPreventPackageFromLoading}%
%
\EndIndex{Package}{scrlfile}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2-experts.tex
index c2d08cc4fe0..9ed1ae7f361 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2-experts.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2-experts.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlttr2-experts.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlttr2-experts.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,13 +45,14 @@
%
% ============================================================================
-\ProvidesFile{scrlttr2-experts.tex}[2012/03/01 KOMA-Script guide (chapter:
-scrlttr2 for experts)]
+\KOMAProvidesFile{scrlttr2-experts.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (chapter: scrlttr2 for experts)]
\translator{Harald Bongartz\and Georg Grandke\and Raimund Kohl\and Jens-Uwe
Morawski\and Stephan Hennig\and Gernot Hassenpflug\and Markus Kohm}
-% Date of the translated German file: 2012/03/01
+% Date of the translated German file: 2013/10/04
\chapter{Additional Information about the Letter Class
\Class{scrlttr2}}
@@ -59,14 +60,14 @@ scrlttr2 for experts)]
This chapter gives additional information about the \KOMAScript{} class
\Class{scrlttr2}. \iffree{Some parts of the chapter are subject to the
- \KOMAScript{} book \cite{book:komascript} only. This shouldn't be a problem,
- because the}{The} average user, who only want to use the package, won't need
-the information. Other information is addressed to users, who want additional
-information about details. For example the first section will describe
-pseudo-lengths in detail. These may be used to modify the note paper. Another
-part of the information describes features of the class that exist only
-because of compatibility to deprecated \Class{scrlettr} class. Last but not
-least it will be described in detail how to change a document from the old
+ \KOMAScript{} book \cite{book:komascript} only. This should not be a
+ problem, because the}{The} average user, who only want to use the package,
+does not need the information. Other information is addressed to users, who
+want additional information about details. For example the first section will
+describe pseudo-lengths in detail. These may be used to modify the note paper.
+Another part of the information describes features of the class that exist
+only because of compatibility to deprecated \Class{scrlettr} class. Last but
+not least it will be described in detail how to change a document from the old
\Class{scrlettr} class to be used with the current \Class{scrlttr2} class.
@@ -84,9 +85,16 @@ registers for the first page alone. {\LaTeX} itself already uses 40 of these
registers. The \Package{typearea} package needs some of them too; thus,
approximately a quarter of the precious registers would already be in
use. That is the reason why lengths specific to letters in \Class{scrlttr2}
-are defined with macros instead of lengths. The drawback of this approach is
-that computations with macros is somewhat more complicated than with real
-lengths.
+are internally defined with macros instead of lengths. The drawback of this
+approach is that computations with macros is somewhat more complicated than
+with real lengths.
+
+Please note\textnote{Attention!}: Even though these pseudo-lengths are
+internally implemented as macros, the commands for pseudo-length management
+expect only the names of the pseudo-lengths not the macros representing the
+pseudo-lengths. The names of pseudo-lengths are without backslash at the very
+beginning similar to the names of \LaTeX{} counters and in opposite to macros
+or \LaTeX{} lengths.
It can be pointed out that the now recommended {\LaTeX} installation with
{\eTeX} no longer suffers from the above-mentioned limitation. However, that
@@ -100,8 +108,8 @@ given in the table.
A schematic display of the most important distances of the note paper is shown
in \autoref{fig:scrlttr2-experts.pseudoLength} at
\autopageref{fig:scrlttr2-experts.pseudoLength}. Beside the
-pseudo-lengths for the modifiable distances, also some lengths, that may not
-be modified are shown in light gray. Some rarely needed pseudo-length of the
+pseudo-lengths for the modifiable distances, also some lengths, which may not
+be modified, are shown in light gray. Some rarely needed pseudo-length of the
note paper have been omitted to get a more clear arrangement.
%
\begin{desclist}
@@ -425,21 +433,18 @@ shifted in the vertical direction.
\BeginIndex{PLength}{tfoldmarkvpos}%
\BeginIndex{PLength}{bfoldmarkvpos}%
\BeginIndex{PLength}{mfoldmarkvpos}%
-The letter class \Class{scrlttr2} knows a total of three
-vertically placed configurable foldmarks. The position of the topmost
-foldmark, taken from the upper edge of the paper, is governed by the
-pseudo-length \PLength{tfoldmarkvpos}, that of the middle foldmark by
-pseudo-length
-\PLength{mfoldmarkvpos}\ChangedAt{v2.97e}{\Class{scrlttr2}}, and that
-of the bottommost foldmark by pseudo-length \PLength{bfoldmarkvpos}. With
-the addition of the puncher hole\Index{puncher hole mark} or
-center\Index{center mark|see{punch hole mark}}
-mark, there is still a fourth horizontal mark. This one is however
-always placed at the vertical center of the paper.
+The letter class \Class{scrlttr2} knows a total of three vertically placed
+configurable foldmarks. The position of the topmost foldmark, taken from the
+upper edge of the paper, is governed by the pseudo-length
+\PLength{tfoldmarkvpos}; the position of the middle foldmark by pseudo-length
+\PLength{mfoldmarkvpos}\ChangedAt{v2.97e}{\Class{scrlttr2}}; the position of
+the bottommost foldmark by pseudo-length \PLength{bfoldmarkvpos}. With the
+addition of the puncher hole\Index{puncher hole mark} or center\Index{center
+ mark|see{punch hole mark}} mark, there is still a fourth horizontal
+mark. This one is however always placed at the vertical center of the paper.
\iffalse% Umbruchkorrekturtext
-There's no pseudo-length for this last mark, because it vertical position
-isn't configurable.
-\fi
+There's no pseudo-length for this last mark, because it vertical position is
+not configurable. \fi
The\textnote{Attention!} topmost and bottommost foldmarks do not serve to
divide the paper into exactly equal thirds. Instead, with their help, the
@@ -777,8 +782,8 @@ For window envelopes the sender is often printed with small font at one line
above the addressee. This kind of sender's information is known as return
address\textnote{return address}\Index{return address}, because it is visible
at the address window and will be used by the post officers to return the
-letter (back) to the sender. In this return address only the information
-should be, that is needed for this purpose.
+letter (back) to the sender. In this return address only that information
+should be that is needed for this purpose.
The height, that is reserved for the return address at the top of the address
field, is given by pseudo-length \PLength{backaddrheight}. A typical value for
@@ -832,7 +837,7 @@ the height, that will be reserved for the Port-Pay\'e head using the options
\PLength{PPheadwidth} will be used only with \OptionValue{addrfield}{PP} (see
\autoref{sec:scrlttr2.firstpage},
\autopageref{desc:scrlttr2.option.addrfield}) and gives the width of the left
-field in the Port-Pay\'e head, that contains P.\,P. logo, zip-code and
+field in the Port-Pay\'e head that contains P.\,P. logo, zip-code and
place. The width of the right field with the sender's code and the priority is
the remaining width.
@@ -966,7 +971,7 @@ fields line is centered, while with
\OptionValue{refline}{narrow}\IndexOption{refline~=\PValue{narrow}} it is
aligned on the left inside the typing area.
-If \PLength{refwidth} isn't null, i.\,e., the width of the reference fields
+If \PLength{refwidth} is not null, i.\,e., the width of the reference fields
line is therefore not determined by the option \Option{refline}, then
\PLength{refhpos} gives the distance of the reference fields line from the
left edge of the paper. If\textnote{Attention!} this distance is null, then
@@ -1206,7 +1211,7 @@ variables in the business line\Index{business line}.
With \Macro{newkomavar} a new variable is defined. This variable is
addressed via \PName{name}. As an option you can define a
\PName{description} for the variable \PName{name}. In opposite to \PName{name}
-the \PName{description} won't be used to reference a variable. In fact the
+the \PName{description} is not used to reference a variable. In fact the
\PName{description} defines an addition to the content of a variable, that may
be output similar to the variable content.
@@ -1243,7 +1248,7 @@ The command \Macro{defaultreffields} acts to reset the reference
fields line to its predefined format. In doing so, all custom-defined
variables are removed from the reference fields line.
-The\textnote{Attention!} date shouldn't be added to the reference fields line
+The\textnote{Attention!} date should not be added to the reference fields line
using \Macro{addtoreffields}. Instead option \Option{date}\important[i]{\OptionValue{refline}{dateleft}\\
\OptionValue{refline}{dateright}\\
\OptionValue{refline}{nodate}}%
@@ -1310,7 +1315,7 @@ to be used as the argument of, e.\,g., \Macro{markboth} or \Macro{footnote}.%
\section{\File{lco}-Files for Experienced Users}
-\label{sec:scrlttr2-experts.variables}
+\label{sec:scrlttr2-experts.lcoFile}
\BeginIndex{File}{lco}%
\BeginIndex{}{lco-file=\File{lco}-file}%
@@ -1319,7 +1324,7 @@ Even though each paper size, that may be set up using package
\Package{typearea}, may be also used with \Class{scrlttr2}, the result of the
first page may be unwanted with some of those page sizes. The conception of
the class is not the reason for this, but the fact, that there are mainly
-parameter sets for ISO~A4 paper. Unfortunately their aren't any universal
+parameter sets for ISO~A4 paper. Unfortunately their are not any universal
rules, to calculate, e.\,g., the position of the address field or similar for
every available paper sizes. But it is possible to make parameter sets for any
paper size that is needed.%
@@ -1361,7 +1366,7 @@ forget about this option and skip the example.%
into standard C6 window envelopes. In that case, the position of the address
field would be the same as for a DIN standard letter on A4-sized paper. The
main difference is that A5 paper needs only one fold. So you want to disable
- the topmost and bottommost folding marks. If their wouldn't be options for
+ the topmost and bottommost folding marks. If their would not be options for
this, the easiest way to achieve this would be to place the marks outside of
the paper area.
\begin{lstcode}
@@ -1444,13 +1449,13 @@ commands\Macro{setkomafont} und \Macro{addtokomafont} (see
\BeginIndex{Cmd}{edgesize}
The default for the visualization of single areas are
frames\important{\PValue{frame}} around the areas. Areas with open top or
-bottom won't be framed completely but have an open edge with arrows at the end
+bottom are not framed completely but have an open edge with arrows at the end
of the ending lines. Alternatively\important{\PValue{rule}} the
\PName{visualization style} \PValue{rule} may be used. In this case a
-background color will be used to visualize the areas. This doesn't differ open
+background color will be used to visualize the areas. This does not differ open
and closed areas. Instead a minimal height will be used for open areas. The
-third\important{\PValue{edge}} available \PName{visualization style} is
-\PValue{edge}. This will mark the corners of the areas. The corner marks at
+third\important{\PValue{edges}} available \PName{visualization style} is
+\PValue{edges}. This will mark the corners of the areas. The corner marks at
the open edge of open areas will be omitted. The size of two edges of the
corner marks are given by the macro \Macro{edgesize} with default 1\Unit{ex}.%
\EndIndex{Cmd}{edgesize}%
@@ -1830,7 +1835,7 @@ How\important[i]{%
}]{%
Default settings for language-dependent terms using languages
\Option{english} and \Option{ngerman}, as long as language selection
- packages haven't been used%
+ packages have not been used%
\label{tab:scrlttr2-experts.languageTerms}%
}[l]
\begin{tabular}[t]{lll}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex
index cabf94914ce..ab944d13090 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlttr2.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlttr2.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,12 +45,14 @@
%
% ============================================================================
-\ProvidesFile{scrlttr2.tex}[2012/05/15 KOMA-Script guide (chapter: scrlttr2)]
+\KOMAProvidesFile{scrlttr2.tex}%
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (chapter: scrlttr2)]
\translator{Harald Bongartz\and Georg Grandke\and Raimund Kohl\and Jens-Uwe
Morawski\and Stephan Hennig\and Gernot Hassenpflug\and Markus Kohm}
-% Date of translated german file: < 2007-09-17
+% Date of translated german file: 2013/11/07
\chapter{The New Letter Class \Class{scrlttr2}}
\labelbase{scrlttr2}
@@ -175,6 +177,11 @@ of all variables is given in \autoref{tab:scrlttr2.variables}.
commands for inserting the sender's logo %
(\autoref{sec:scrlttr2.firstpage},
\autopageref{desc:scrlttr2.variable.fromlogo})}%
+ \ventry{frommobilephone}{%
+ \ChangedAt{v3.12}{\Class{scrlttr2}}%
+ sender's mobile telephone number %
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.frommobilephone})}%
\ventry{fromname}{%
complete name of sender %
(\autoref{sec:scrlttr2.firstpage},
@@ -414,6 +421,12 @@ of this, definition of pseudo-lengths will be described in the expert part at
new values is also a work for advanced users. So this will be described in the
expert part too at \autopageref{desc:scrlttr2-experts.cmd.@setplength}.
+Please note\textnote{Attention!}: Even though these pseudo-lengths are
+internally implemented as macros, the commands for pseudo-length management
+expect only the names of the pseudo-lengths not the macros representing the
+pseudo-lengths. The names of pseudo-lengths are without backslash at the very
+beginning similar to the names of \LaTeX{} counters and in opposite to macros
+or \LaTeX{} lengths.
\begin{Declaration}
\Macro{useplength}\Parameter{name}
@@ -471,7 +484,7 @@ of a \PName{pseudo-length} to the \PName{length}.
\LoadCommon[scrlttr]{3} % \section{Page Layout}
Normally it makes no sense to distinguish letters with single-side layout and
-letters with double-side layout. Mostly letters won't be bound like
+letters with double-side layout. Mostly letters are not bound like
books. Therefor each page will be viewed on its own. This is also true if both
sides of the paper sheet will be used for printing. Vertical adjustment is
unusual at letters too. Nevertheless, if you need or want it, you may read the
@@ -642,7 +655,7 @@ the standard letter class.
\end{document}
\end{lstcode}
However, this would not result in any printable output. At least there
- wouldn't be an addressee at the note paper sheet. The reason for this will
+ would not be an addressee at the note paper sheet. The reason for this will
be explained at the description of command \Macro{opening} at
\autopageref{desc:scrlttr2.cmd.opening}.
\end{Example}
@@ -922,125 +935,8 @@ and content of the variable
%
\EndIndex{}{font>size}
-
\LoadCommon[scrlttr]{5} % \section{Text Markup}
-With command \Macro{usekomafont} the current font style may be changed into
-the font style of the selected \PName{element}.
-
-A general example for the usage of \Macro{setkomafont} and \Macro{usekomafont}
-may be found in \autoref{sec:maincls.textmarkup} at
-\autopageref{desc:maincls.setkomafont.example}.
-
-\begin{desclist}
- \desccaption{%
- Alphabetical list of elements whose font can be changed in
- \Class{scrlttr2} using the commands \Macro{setkomafont} and
- \Macro{addtokomafont}\label{tab:scrlttr2.elementsWithoutText}%
- }{%
- Elements whose font can be changed (\emph{continuation})%
- }%
- \feentry{addressee}{name und address in address field %
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.option.addrfield})}%
- \feentry{backaddress}{%
- return address for a window envelope %
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.option.backaddress})}%
- \feentry{descriptionlabel}{%
- label, i.\,e., the optional argument of \Macro{item}, in a
- \Environment{description} environment %
- (\autoref{sec:scrlttr2.lists},
- \autopageref{desc:scrlttr2.env.description})}%
- \feentry{foldmark}{%
- foldmark on the letter page; intended for color settings %
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.option.foldmarks})}%
- \feentry{footnote}{%
- footnote text and marker %
- (see \autoref{sec:scrlttr2.footnotes},
- \autopageref{desc:scrlttr2.cmd.footnote})}%
- \feentry{footnotelabel}{%
- mark of a footnote; used according to the element \FontElement{footnote} %
- (see \autoref{sec:scrlttr2.footnotes},
- \autopageref{desc:scrlttr2.cmd.footnote})}%
- \feentry{footnotereference}{%
- footnote reference in the text %
- (see \autoref{sec:scrlttr2.footnotes},
- \autopageref{desc:scrlttr2.cmd.footnote})}%
- \feentry{footnoterule}{%
- horizontal rule\ChangedAt{v3.07}{\Class{scrlttr2}} above the footnotes at
- the end of the text area %
- (see \autoref{sec:maincls.footnotes},
- \autopageref{desc:maincls.cmd.setfootnoterule})}%
- \feentry{labelinglabel}{%
- labels, i.\,e., the optional argument of \Macro{item} in the
- \Environment{labeling} environment %
- (see \autoref{sec:scrlttr2.lists},
- \autopageref{desc:scrlttr2.env.labeling})}%
- \feentry{labelingseparator}{%
- separator, i.\,e., the optional argument of the \Environment{labeling}
- environment; used according to the element \FontElement{labelinglabel} %
- (see \autoref{sec:scrlttr2.lists},
- \autopageref{desc:scrlttr2.env.labeling})}%
- \feentry{pagefoot}{%
- used after element \FontElement{pageheadfoot} for the page foot, that has
- been defined with variable \Variable{nextfoot}\IndexVariable{nextfoot}, or
- for the page foot of package \Package{scrpage2} %
- (\autoref{cha:scrpage}, \autopageref{desc:scrpage.fontelement.pagefoot})}%
- \feentry{pagehead}{%
- another name for \FontElement{pageheadfoot}}%
- \feentry{pageheadfoot}{%
- the head of a page, but also the foot of a page at all page style, that
- has been defined using \KOMAScript{} %
- (see \autoref{sec:scrlttr2.pagestyle},
- \autopageref{desc:scrlttr2.fontelement.pageheadfoot})}%
- \feentry{pagenumber}{%
- page number in the header or footer %
- (see \autoref{sec:scrlttr2.pagestyle},
- \autopageref{desc:scrlttr2.fontelement.pagenumber})}%
- \feentry{pagination}{%
- another name for \FontElement{pagenumber}}%
- \feentry{refname}{%
- description or title of the fields in the reference line %
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.variable.yourref})}%
- \feentry{refvalue}{%
- content of the fields in the reference line %
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.variable.yourref})}%
- \feentry{specialmail}{%
- mode of dispatch in the address field %
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.variable.specialmail})}%
- \feentry{subject}{%
- subject in the opening of the letter %
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.variable.subject})}%
- \feentry{title}{%
- title in the opening of the letter %
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.variable.title})}%
- \feentry{toaddress}{%
- variation of the element \FontElement{addressee} for setting the addressee
- address (less the name) in the address field %
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.variable.toaddress})}%
- \feentry{toname}{%
- variation of the element \FontElement{addressee} for the name (only) of
- the addressee in the address field %
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.variable.toname})}%
-\end{desclist}
-%
-\EndIndex{Cmd}{setkomafont}%
-\EndIndex{Cmd}{addtokomafont}%
-\EndIndex{Cmd}{usekomafont}%
-%
-\EndIndex{}{font}%
-\EndIndex{}{text>markup}
-
-
\section{Note Paper}
\label{sec:scrlttr2.firstpage}
\BeginIndex{}{note paper}%
@@ -1136,7 +1032,7 @@ chosen for a letter. Default values are \PValue{true} and \PValue{TBMPL}.
Assume that you would like to deactivate all folding marks except the punching
mark. This you can accomplish with, for example:
\begin{lstlisting}
- \KOMAoption{foldmarks=blmt}
+ \KOMAoptions{foldmarks=blmt}
\end{lstlisting}
as long as the defaults have not been changed previously. If some changes
might have been made before, a safer method should be used. This changes our
@@ -1372,7 +1268,7 @@ information about colors.%
\label{fig:scrlttr2.letter-10-11}
\end{figure}
In difference to this, the left letter has been set once again with the
- standard letter head, that doesn't react on the additional option.
+ standard letter head, that does not react on the additional option.
\end{Example}
An\textnote{Attention!} important note concerns the sender's address: within
@@ -1394,12 +1290,16 @@ signature (see variable \Variable{signature},
\begin{Declaration}
+ \KOption{symbolicnames}\PName{simple switch}\\
\KOption{fromphone}\PName{simple switch}\\
+ \KOption{frommobilephone}\PName{simple switch}\\
\KOption{fromfax}\PName{simple switch}\\
\KOption{fromemail}\PName{simple switch}\\
\KOption{fromurl}\PName{simple switch}\\
\Macro{setkomavar}\PParameter{\Variable{fromphone}}%
\OParameter{description}\Parameter{content}\\
+ \Macro{setkomavar}\PParameter{\Variable{frommobilephone}}%
+ \OParameter{description}\Parameter{content}\\
\Macro{setkomavar}\PParameter{\Variable{fromfax}}%
\OParameter{description}\Parameter{content}\\
\Macro{setkomavar}\PParameter{\Variable{fromemail}}%
@@ -1408,6 +1308,8 @@ signature (see variable \Variable{signature},
\OParameter{description}\Parameter{content}\\
\Macro{setkomavar}\PParameter{\Variable{phoneseparator}}%
\OParameter{description}\Parameter{content}\\
+ \Macro{setkomavar}\PParameter{\Variable{mobilephoneseparator}}%
+ \OParameter{description}\Parameter{content}\\
\Macro{setkomavar}\PParameter{\Variable{faxseparator}}%
\OParameter{description}\Parameter{content}\\
\Macro{setkomavar}\PParameter{\Variable{emailseparator}}%
@@ -1415,30 +1317,49 @@ signature (see variable \Variable{signature},
\Macro{setkomavar}\PParameter{\Variable{urlseparator}}%
\OParameter{description}\Parameter{content}%
\end{Declaration}%
+\BeginIndex{Option}{symbolicnames~=\PName{simple switch}}%
\BeginIndex{Option}{fromphone~=\PName{simple switch}}%
+\BeginIndex{Option}{frommobilephone~=\PName{simple switch}}%
\BeginIndex{Option}{fromfax~=\PName{simple switch}}%
\BeginIndex{Option}{fromemail~=\PName{simple switch}}%
\BeginIndex{Option}{fromurl~=\PName{simple switch}}%
\BeginIndex{Variable}{fromphone}%
+\BeginIndex{Variable}{frommobilephone}%
\BeginIndex{Variable}{fromfax}%
\BeginIndex{Variable}{fromemail}%
\BeginIndex{Variable}{fromurl}%
\BeginIndex{Variable}{emailseparator}%
\BeginIndex{Variable}{faxseparator}%
\BeginIndex{Variable}{phoneseparator}%
+\BeginIndex{Variable}{mobilephoneseparator}%
\BeginIndex{Variable}{urlseparator}%
-Whether or not a telephone number\Index{telephone}\Index{phone}, a fax
-number\Index{fax}, an e-mail address\Index{e-mail}, or a sender's URL should
-be set as part of the letterhead may be configured by the options
-\Option{fromphone}, \Option{fromfax}, \Option{fromemail}, and
-\Option{fromurl}. Any standard value for simple switches from
-\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} may be
-assigned to these options. Default is \PValue{false} for all of them. The
-\PName{contents} depends on the corresponding variable. The default of the
-\PName{description} or title of each variable may be found in
-\autoref{tab:scrlttr2.fromTerm}. The separators, that will be inserted between
-\PName{description} and \PName{content}, may be found in
-\autoref{tab:scrlttr2.fromSeparator}.
+Whether or not a telephone number\Index{telephone}\Index{phone}, a
+mobile\ChangedAt{v3.12}{\Class{scrlttr2}} telephone number\Index{mobile
+ phone}\Index{cell phone}\Index{cellphone}, a fax number\Index{fax}, an
+e-mail address\Index{e-mail}, or a sender's URL should be set as part of the
+letterhead may be configured by the options \Option{fromphone},
+\Option{fromfax}, \Option{fromemail}, and \Option{fromurl}. Any standard value
+for simple switches from \autoref{tab:truefalseswitch},
+\autopageref{tab:truefalseswitch} may be assigned to these options. Default is
+\PValue{false} for all of them. The \PName{contents} depends on the
+corresponding variable. The default of the \PName{description} or title of
+each variable may be found in \autoref{tab:scrlttr2.fromTerm}. The separators,
+that will be inserted between \PName{description} and \PName{content}, may be
+found in \autoref{tab:scrlttr2.fromSeparator}.
+
+You may\ChangedAt{v3.12}{\Class{scrlttr2}}\important{\Option{symbolicnames}}
+change the defaults for the description of the separator variables at once
+using option \Option{symbolicnames}. The option understands the values for
+simple switches from \autoref{tab:truefalseswitch},
+\autopageref{tab:truefalseswitch}. Switching on the option replaces the
+descriptions from the language depending terms \Macro{emailname},
+\Macro{faxname}, \Macro{mobilephonename}, and \Macro{phonename} into symbols
+of the package \Package{marvosym}\IndexPackage{marvosym}. Also the colon will
+be removed from the content of the separator variables. And in this case the
+description and the content of the URL separator will be
+empty. Note\textnote{Attention!}, that you have to load package
+\Package{marvosym} on your own, if you switch on \Option{symbolicnames}
+first time after \Macro{begin}\PParameter{document}.
\begin{table}
\centering
@@ -1451,6 +1372,10 @@ assigned to these options. Default is \PValue{false} for all of them. The
\Macro{usekomavar}\PParameter{emailseparator}}%
\ventry{fromfax}{\Macro{usekomavar*}\PParameter{faxseparator}%
\Macro{usekomavar}\PParameter{faxseparator}}%
+ \ventry{frommobilephone}{%
+ \ChangedAt{v3.12}{\Class{scrlttr2}}%
+ \Macro{usekomavar*}\PParameter{mobilephoneseparator}%
+ \Macro{usekomavar}\PParameter{mobilephoneseparator}}%
\ventry{fromname}{\Macro{headfromname}}%
\ventry{fromphone}{\Macro{usekomavar*}\PParameter{phoneseparator}%
\Macro{usekomavar}\PParameter{phoneseparator}}%
@@ -1466,7 +1391,7 @@ assigned to these options. Default is \PValue{false} for all of them. The
\setcapindent{0pt}%
% \caption
\begin{captionbeside}{Predefined description and content of the separators
- at the letterhead}
+ at the letterhead without option \Option{symbolicnames}}
[l]
\begin{tabular}[t]{lll}
\toprule
@@ -1474,6 +1399,7 @@ assigned to these options. Default is \PValue{false} for all of them. The
\midrule
\Variable{emailseparator} & \Macro{emailname} & \texttt{:\~} \\
\Variable{faxseparator} & \Macro{faxname} & \texttt{:\~} \\
+ \Variable{mobilephoneseparator} & \Macro{mobilephonename} & \Macro{usekomavaer}\PParameter{phoneseparator} \\
\Variable{phoneseparator} & \Macro{phonename} & \texttt{:\~} \\
\Variable{urlseparator} & \Macro{wwwname} & \texttt{:\~} \\
\bottomrule
@@ -1533,17 +1459,21 @@ assigned to these options. Default is \PValue{false} for all of them. The
\end{Example}
%
\EndIndex{Variable}{urlseparator}%
+\EndIndex{Variable}{mobilephoneseparator}%
\EndIndex{Variable}{phoneseparator}%
\EndIndex{Variable}{faxseparator}%
\EndIndex{Variable}{emailseparator}%
\EndIndex{Variable}{fromurl}
\EndIndex{Variable}{fromemail}
\EndIndex{Variable}{fromfax}
+\EndIndex{Variable}{frommobilephone}%
\EndIndex{Variable}{fromphone}%
\EndIndex{Option}{fromurl~=\PName{simple switch}}%
\EndIndex{Option}{fromemail~=\PName{simple switch}}%
\EndIndex{Option}{fromfax~=\PName{simple switch}}%
+\EndIndex{Option}{frommobilephone~=\PName{simple switch}}%
\EndIndex{Option}{fromphone~=\PName{simple switch}}%
+\EndIndex{Option}{symbolicnames~=\PName{simple switch}}%
\begin{Declaration}
\KOption{fromlogo}\PName{simple switch}\\
@@ -1558,7 +1488,7 @@ logo\Index{Logo} at the letterhead. The option value may be any \PName{simple
\autopageref{tab:truefalseswitch}. Default is \PValue{false}, that means no
logo. The logo itself is defined by the \PName{content} of variable
\Variable{fromlogo}. The \PName{description} of the logo is empty by default
-and \KOMAScript{} won't use it anywhere at the predefined note papers (see
+and \KOMAScript{} does not use it anywhere at the predefined note papers (see
also \autoref{tab:scrlttr2.fromTerm}).%
\begin{Example}
Mr Public likes to use a letterhead with logo. He generated a graphics file
@@ -1610,7 +1540,7 @@ construction as content of variable \Variable{firsthead}. Within
or one underneath the other. An advanced user will thus be able to
create a letterhead on his own. Of course the construct may
and should use other variables with the help of
-\Macro{usekomavar}. \KOMAScript{} doesn't use the
+\Macro{usekomavar}. \KOMAScript{} does not use the
\PName{description} of variable \Variable{firsthead}.
\iffree{}{A detailed example for the definition of a letterhead will be shown
in \autoref{cha:modernletters}.}
@@ -1733,7 +1663,7 @@ will be printed. Option \Option{backaddress} defines whether a return address
for window envelopes will be set. This
option\important{\OptionValue{backaddress}{false}} can take the standard
values for simple switches, as listed in \autoref{tab:truefalseswitch},
-\autopageref{tab:truefalseswitch}. These values don't change style of the
+\autopageref{tab:truefalseswitch}. These values do not change style of the
return address. On the other hand,
additionally\ChangedAt{v2.96}{\Class{scrlttr2}} to switching on the return
address, the style of the return address may be selected. Option value
@@ -1748,7 +1678,7 @@ The return address itself is defined by the \PName{content} of variable
and \Variable{toaddress} with redefinition of the double backslash to set the
\PName{content} of variable \Variable{backaddressseparator}. The predefined
separator \PName{content} is a comma followed by a non-breakable white
-space. The \PName{description} of variable \Variable{backaddress} isn't used
+space. The \PName{description} of variable \Variable{backaddress} is not used
by \KOMAScript. The font style of the return address is configurable via
element
\FontElement{backaddress}\important{\FontElement{backaddress}}. Default for
@@ -1813,7 +1743,7 @@ type\Index{mode of dispatch}\Index{dispatch type} can be output within the
address field between the return address and the addressee address, This will
be done only if variable \Variable{specialmail} is not empty and
\OptionValue{priority}{manual}\ChangedAt{v3.03}{\Class{scrlttr2}} has been
-selected, which is also the default. Class \Class{scrlttr2} itself doesn't use
+selected, which is also the default. Class \Class{scrlttr2} itself does not use
the \PName{description} of variable \Variable{specialmail}. The alignment is
defined by the pseudo-lengths PLength{specialmailindent} and
\PLength{specialmailrightindent} (siehe
@@ -1910,7 +1840,7 @@ With\important[i]{\begin{tabular}[t]{@{}l@{}}
\OptionValue{addrfield}{backgroundimage}\ChangedAt{v3.03}{\Class{scrlttr2}}
or \OptionValue{addrfield}{image} a picture will be print inside the address
field. The \PName{content} of variable \Variable{addresseeimage} will be used
-for this. \KOMAScript{} doesn't use the \PName{description} of that
+for this. \KOMAScript{} does not use the \PName{description} of that
variable. Nothing else but the picture will be printed with option
\OptionValue{addrfield}{image}. But with option
\OptionValue{addrfield}{backgroundimage} the addressee's name and address from
@@ -1994,7 +1924,7 @@ option are shown in \autoref{tab:scrlttr2.locfield}. Default is
The contents of the sender's extension field is determined by the
variable \Variable{location}. To set this variable's \PName{content}, it is
permitted to use formatting commands like \Macro{raggedright}. \KOMAScript{}
-doesn't use the \PName{description} of the variable.
+does not use the \PName{description} of the variable.
\begin{Example}
Mr Public likes to show some additional information about his
@@ -2048,12 +1978,14 @@ standard date presentation.
\BeginIndex{Variable}{date}%
The date in the selected presentation will become the \PName{content} of
variable \Variable{date}. The selection of option \Option{numericaldate}
-doesn't influence the date any longer, if the \PName{content} of this variable
+does not influence the date any longer, if the \PName{content} of this variable
will be changed by the user. Normally the date will be part of the reference
-line. This is the case even if all other elements of the reference line will
-be empty and therefore unused. For more information about the automatic
-printing of the date may be found in following description of option
-\Option{refline}.%
+line. If all other elements of the reference line will be empty and therefore
+unused a date line instead of a reference line will be printed. See the
+description of variable \Variable{place} on
+\autopageref{desc:scrlttr2.variable.placeseparator} for more information about
+the date line. You should note, that you can change the automatic printing of
+the date using option \Option{refline}, that will be described next.
%
\EndIndex{Variable}{date}%
\EndIndex{Option}{numericaldate~=\PName{switch}}%
@@ -2072,7 +2004,7 @@ be named \emph{reference line}\textnote{reference line} in this manual.
With the \Class{scrlttr2} class, the header, footer, address, and sender
attributes may extend beyond the normal type area to the left and to the
-right. Option \Option{refline}{wide} defines that this should also apply to
+right. Option \OptionValue{refline}{wide} defines that this should also apply to
the reference fields line. Normally, the reference fields line contains at
least the date, but it can hold additional data. Possible values for this
option are shown in \autoref{tab:scrlttr2.refline}. Default is \PValue{narrow}
@@ -2092,7 +2024,7 @@ and \PValue{dateright}\ChangedAt{v3.09}{\Class{scrlttr2}}.%
\pventry{narrow}{The reference line will be restricted to type
area.}%
\pventry{nodate}{\ChangedAt{v3.09}{\Class{scrlttr2}}%
- The date won't be placed automatically into the reference line.}%
+ The date is not placed automatically into the reference line.}%
\pventry{wide}{The with of the reference line corresponds to address and
sender's additional information.}%
\end{desctabular}
@@ -2202,6 +2134,21 @@ unset also. The predefined \PName{content} of \Variable{date} is
\Macro{today}\IndexCmd{today} and depends on the setting of the option
\Option{numericaldate} (see \autopageref{desc:scrlttr2.option.numericaldate}).
+Since version~3.09\ChangedAt{v3.09}{\Class{scrlttr2}} place and date the
+alignment of place and date is given by option \Option{refline}. The available
+alignment values for this option are listed in \autoref{tab:scrlttr2.refline}.
+
+\BeginIndex{FontElement}{placeanddate}%
+The\ChangedAt{v3.12}{\Class{scrlttr2}} font setting of place and date in the
+date line are given by font
+element\FontElement{placeanddate}\important[i]{\FontElement{placeanddate}}
+instead of element \FontElement{refvalue}, which would be used for general
+reference lines. You can change the empty default of the font element using
+commands \Macro{setkomafont} and \Macro{addtokomafont} (see
+\autoref{sec:scrlttr2.textmarkup},
+\autopageref{desc:scrlttr2.cmd.setkomafont}).%
+\EndIndex{FontElement}{placeanddate}%
+
\begin{Example}
Now Mr Public also sets the place:%
\lstinputcode[xleftmargin=1em]{letter-20.tex}%
@@ -2419,10 +2366,10 @@ the setting of the letter foot.
The first page's footer is preset to
empty. However\ChangedAt{v3.08}{\Class{scrlttr2}}, a new construction may be
made at the \PName{content} of variable \Variable{firstfoot}. \KOMAScript{}
-doesn't use the \PName{description} of the variable. For more information see
+does not use the \PName{description} of the variable. For more information see
the example following the next description. Only for compatibility reason the
deprecated command \Macro{firstfoot}\IndexCmd[indexmain]{firstfoot} of
-\Class{scrlttr2} before release~3.08 still exists. Nevertheless it shouldn't
+\Class{scrlttr2} before release~3.08 still exists. Nevertheless it should not
be used any longer.
\begin{Declaration}
@@ -2545,14 +2492,14 @@ head. Activation\important{\OptionValue{footsepline}{true}} of option
\Option{footsepline} switches on a rule above the page foot. Deactivation of
the options switches of the corresponding rules.
-Obviously option \Option{headsepline} doesn't influence page styles
+Obviously option \Option{headsepline} does not influence page styles
\PValue{empty}\important[i]{\Pagestyle{empty}\\
\Pagestyle{plain}} and \PValue{plain} (see afterwards at this
-section). These page styles explicitly don't use any page head.
+section). These page styles explicitly do not use any page head.
Typographically\important[i]{\Pagestyle{headings}\\
\Pagestyle{myheadings}} such a rule make a hard optical connection of head
-or foot and the text area. This wouldn't mean, that the distance between head
+or foot and the text area. This would not mean, that the distance between head
and text or text and foot should be increased. Instead of this the head or
foot should be seen as parts of the typing area, while calculation of margins
and typing area. To achieve this \KOMAScript{} will pass option
@@ -2761,12 +2708,12 @@ boxes side by side or one beneath the other by use of the \Macro{parbox}
command (see \cite{latex:usrguide}). A more advanced user should have no
problems creating letterheads of footers of his own. Within \PName{content}
you can and should of course also make use of other variables by using
-\Macro{usekomavar}. \KOMAScript{} doesn't use the \PName{description} of both
+\Macro{usekomavar}. \KOMAScript{} does not use the \PName{description} of both
variables.
Only\textnote{Attention!} for compatibility reason the deprecated commands \Macro{nexthead}\IndexCmd[indexmain]{nexthead} and
\Macro{nextfoot}\IndexCmd[indexmain]{nextfoot} of former \Class{scrlttr2}
-releases before 3.08 are also implemented. Nevertheless, you shouldn't use
+releases before 3.08 are also implemented. Nevertheless, you should not use
those.%
%
\EndIndex{Variable}{nextfoot}%
@@ -2798,12 +2745,12 @@ There are not math environments implemented at the \KOMAScript{}
classes. Instead of this, the math features of the \LaTeX{} kernel have been
supported. Furthermore\textnote{Attention!} regular math with numbered
equations or formulas is very unusual at letters. Because of this
-\Class{scrlttr2} doesn't actively support numbered equations. Therefore
+\Class{scrlttr2} does not actively support numbered equations. Therefore
options \Option{leqno} and \Option{fleqn}, that has been described for
\Class{scrbook}, \Class{scrreprt}, and \Class{scrartcl} at
\autoref{sec:maincls.math} are not available from \Class{scrlttr2}.
-You won't find a description of the math environments of the \LaTeX{} kernel
+You will not find a description of the math environments of the \LaTeX{} kernel
here. If you want to use \Environment{displaymath}\IndexEnv{displaymath},
\Environment{equation}\IndexEnv{equation} and
\Environment{eqnarray}\IndexEnv{eqnarray} you should read a short introduction
@@ -2819,7 +2766,7 @@ recommended (see \cite{package:amsmath}).%
\label{sec:scrlttr2.floats}
Floating environments for tables or figures are very unusual in
-letters. Therefore\textnote{Attention!} \Class{scrlttr2} doesn't provide
+letters. Therefore\textnote{Attention!} \Class{scrlttr2} does not provide
them. If someone nevertheless needs floating environments, then this is often
points out a malpractice of the letter class. In such cases you may try to
define the floating environments with help of packages like \Package{tocbasic}\important{\Package{tocbasic}} (siehe
@@ -3000,13 +2947,13 @@ If\ChangedAt{v2.97}{\Class{scrlttr2}} an \File{lco}-file is loaded via
\begin{Example}
Since Mr~Public often writes letters with the same options and parameters,
- he doesn't like to copy all these to each new letter. To simplify the effort
+ he does not like to copy all these to each new letter. To simplify the effort
of writing a new letter, he therefore makes a \File{lco}-file:%
\lstinputcode[xleftmargin=1em]{ich.lco}%
With this the size of the previous letter decreases to:
\lstinputcode[xleftmargin=1em]{letter-23.tex}%
Nevertheless, as shown in \autoref{fig:scrlttr2.letter-23}, the result
- doesn't change.
+ does not change.
\begin{figure}
\setcapindent{0pt}%
\begin{captionbeside}[{Example: letter with extended sender, logo,
@@ -3397,7 +3344,9 @@ current version of \Package{adrconv} supports the \Macro{addrentry} and
%%% Local Variables:
%%% mode: latex
+%%% mode: flyspell
%%% coding: us-ascii
+%%% ispell-local-dictionary: "en_GB"
%%% TeX-master: "../guide"
%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrpage2.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrpage2.tex
index 603adeb934d..937acdec0b0 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrpage2.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrpage2.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrpage2.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrpage2.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,12 +45,14 @@
%
% ============================================================================
-\ProvidesFile{scrpage2.tex}[2012/02/22 KOMA-Script guide (chapter:scrpage2)]
+\KOMAProvidesFile{scrpage2.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (chapter:scrpage2)]
\translator{Jens-Uwe Morawski\and Karl-Heinz Zimmer\and Christoph Bier\and
Gernot Hassenpflug\and Markus Kohm}
-% date of translated german file: 2012/02/22
+% date of translated german file: 2013/07/22
\chapter{Adapting Page Headers and Footers with \Package{scrpage2}}
\labelbase{scrpage}
@@ -97,7 +99,7 @@ documentation describes only \Package{scrpage2}. The package
\end{Explain}
-Package \Package{scrpage2} doesn't distinguish between page styles with
+Package \Package{scrpage2} does not distinguish between page styles with
automatic, running headings and page styles with manual headings. The way to
deal with automatic and manual headings is independent from the page style and
so the page style is independent from the choice of automatic or manual
@@ -745,7 +747,7 @@ elements \FontElement{headtopline}\important[i]{\FontElement{headtopline}\\
\FontElement{footbotline}. These can then be extended via
\Macro{addtokomafont}\IndexCmd{addtokomafont}. See
\autoref{sec:maincls.textmarkup}, \autopageref{desc:maincls.cmd.setkomafont}
-for details on the \Macro{setkomafont} and \Macro{addkomafont} commands.
+for details on the \Macro{setkomafont} and \Macro{addtokomafont} commands.
\EndIndex{FontElement}{footbottomline}%
\EndIndex{FontElement}{footbotline}%
\EndIndex{FontElement}{footsepline}%
@@ -853,7 +855,7 @@ together with other package options in the next
In opposite to the \KOMAScript{} classes, where the most options may be
changed using \Macro{KOMAoptions} or \Macro{KOMAoption} also after loading the
-class, package \Package{scrpage2} doesn't provide this feature\iffree{
+class, package \Package{scrpage2} does not provide this feature\iffree{
currently}{}. All options to \Package{scrpage2} have to be global options,
i.\,e. be part of the optional argument of \Macro{documentclass}, or
package option, i.\,e. be part of the optional argument of \Macro{usepackage}.
@@ -867,7 +869,7 @@ package option, i.\,e. be part of the optional argument of \Macro{usepackage}.
\BeginIndex{Option}{headinclude}\BeginIndex{Option}{footinclude}%
\BeginIndex{Option}{headexclude}\BeginIndex{Option}{footexclude}%
Since\textnote{Attention!} \KOMAScript~3\ChangedAt{v2.3}{\Package{scrpage2}}
-this options shouldn't be passed to \Package{scrpage2} any longer using
+this options should not be passed to \Package{scrpage2} any longer using
\Macro{PassOptionsToPackage} or the optional argument of
\Macro{usepackage}. Only for compatibility reason \Package{scrpage2} still
declares them and pass them as \Option{headinclude},
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrwfile.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrwfile.tex
index baf1d38f565..9d69c9d2fc7 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrwfile.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrwfile.tex
@@ -6,7 +6,7 @@
%%
%% scrwfile.dtx (with options: `doc')
%%
-%% Copyright (c) 2010-2012 by Markus Kohm <komascript(at)gmx.info>
+%% Copyright (c) 2010-2013 by Markus Kohm <komascript(at)gmx.info>
%%
%% This file was generated from file(s) of the KOMA-Script bundle.
%% ---------------------------------------------------------------
@@ -43,9 +43,9 @@
%% EVERYTHING MAY CHANGE IN FUTURE!
%% THERE IS NO SUPPORT, IF YOU USE THIS PACKAGE!
%%
-%%% From File: scrwfile.dtx
+%%% From File: $Id: scrwfile.dtx 1562 2013-12-19 07:51:16Z mjk $
\ProvidesFile{scrwfile.tex}
- [2012/03/05 v0.1d-alpha LaTeX2e KOMA-Script package (write and clone files)]
+ [2013/08/05 v0.1f-alpha LaTeX2e KOMA-Script package (write and clone files)]
\chapter[{Spare and Replace Files Using \Package{scrwfile}}]
{Spare and Replace Files Using \Package{scrwfile}%
}
@@ -143,7 +143,7 @@ limited any longer.
Sometimes it is useful to input a file not only once but several times. As
\Macro{@starttoc} does not open files for writing any longer, this may be
-done by simply using \Macro{\@starttoc} several times with the same
+done by simply using \Macro{@starttoc} several times with the same
extension. But sometimes you may have additional entries in only some of the
content directories. Because of this, \Package{scrwfile} allows to copy all
entries of a file to another file, too. We call this cloning.
@@ -178,23 +178,53 @@ contents:
\begin{lstcode}
\usepackage{scrwfile}
\TOCclone[Short \contentsname]{toc}{stoc}
- \AtBeginDocument{%
- % aux first opened at \begin{document}. So wait until this:
- \addtocontents{toc}{% first toc entry:
- \proctect\addcontentsline{stoc}{% write to Short Contents
- \protect\tableofcontents% Contents
- }%
- }%
+\end{lstcode}
+This would create a new table of contents with the heading ^^c2^^bbShort
+Contents^^c2^^ab. The new table of contents uses a helper file with extension
+\File{stoc}. All entries to the helper file with extension \File{toc} will
+also be copied to this new helper file.
+
+The new short table of contents should only have the chapter entries. This may
+be done using:
+\begin{lstcode}
+ \addtocontents{stoc}{\protect\value{tocdepth}=0}
+\end{lstcode}
+Normally you cannot write into a helper file before
+\Macro{begin}\PParameter{document}. But using \Package{scrwfile} changes
+this. So the code above will be successful after loading \Package{scrwfile}.
+
+To show the new short contents of helper file extension \File{stoc} we will
+use
+\begin{lstcode}[moretexcs={listofsttoc}]
+ \listofstoc
+\end{lstcode}
+somewhere after \Macro{begin}\PParameter{document}.
+
+If we also want an entry for the table of contents at the short contents, we
+cannot use
+\begin{lstcode}
+ \addtocontents{toc}{% write to the Contents
+ \protect\addcontentslinedefault{stoc}% write to Short Contents
+ {chapter}% a chapter entry with
+ {\contentsname}% the Contents' name
+ }
+\end{lstcode}
+because the \Macro{addcontentsline} command would be copied to \File{stoc}
+too. So we cannot add the command to the \File{toc}-file. Package
+\Package{tocbasic}\important{\Package{tocbasic}} may be used to solve this:
+\csname phantomsection\endcsname\label{example:scrwfile.AfterStartingTOC}
+\begin{lstcode}
+ \AfterStartingTOC[toc]{%
+ \addcontentslinedefault{stoc}{chapter}
+ {\protect\contentsname}%
}
- \begin{document}
- \setcounter{tocdepth}{1}% show chapters only
- \listofstoc% Write short table of contents
- \setcounter{tocdepth}{6}% show all levels
- \tableofcontents% Write table of contents
\end{lstcode}
-You need at least three \LaTeX{} runs to get a short table of contents and a
-detailed table of contents. The detailed one produces an entry at the short
-one but this entry will not be part of the detailed table of contents.
+But this needs, that the file with extension \File{toc} is under control of
+package \Package{tocbasic}, which is indeed the case within all \KOMAScript{}
+classes.
+See \autoref{sec:tocbasic.toc} on
+\autopageref{desc:tocbasic.cmd.AfterStartingTOC} for more information about
+\Macro{AfterStartingTOC}.%
\end{Example}
\EndIndex{Cmd}{TOCclone}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex
index 0e84fc54c33..3e240f8f973 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex
@@ -1,48 +1,59 @@
+\immediate\write17{^^J%
++----------------------------------------------------------------------^^J%
+| WARNING (`tocbasic.tex'):^^J%
++----------------------------------------------------------------------^^J%
+| YOU SHOULD NOTE, THAT THIS IS NOT AN OFFICIAL RELEASE!^^J%
+| THIS VERSION IS INTENDED TO BE USED FOR TESTING ONLY!^^J%
+| USAGE FOR PURPOSES OTHER THAN INTENDED IS DANGEROUS!^^J%
+| DON'T EXPECT ANY SUPPORT FOR THIS VERSION!^^J%
++----------------------------------------------------------------------^^J%
+}
%%
%% This is file `tocbasic.tex',
-%% generated with the docstrip utility.
+%% generated with the docstrip utility, extended by scrdocstrip.
%%
%% The original source files were:
%%
%% tocbasic.dtx (with options: `doc')
%%
-%% Copyright (c) 2007-2012
-%% Markus Kohm and any individual authors listed elsewhere in this file.
+%% Copyright (c) 2008-2013 Markus Kohm [komascript at gmx info]
%%
%% This file was generated from file(s) of the 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.
+%% It may be distributed under the conditions of the
+%% LaTeX Project Public License in the version distributed together
+%% with KOMA-Script, see file `lppl.txt' or `lppl-de.txt'.
%%
-%% This work has the LPPL maintenance status "author-maintained".
+%% This file may only be distributed together with a copy of the
+%% KOMA-Script bundle. You may however distribute the
+%% KOMA-Script bundle without all such generated files. See also
+%% `lppl.txt' or `lppl-de.txt' for additional information.
%%
-%% The Current Maintainer and author of this work is Markus Kohm.
+%% The list of files belonging to KOMA-Script distribution is given in
+%% the file `manifest.txt'. See also `lppl.txt' or `lppl-de.txt' for
+%% additional information.
%%
-%% This file may only be distributed together with the files
-%% `scrlogo.dtx' and `tocbasic.dtx'. You may however distribute the files
-%% `scrlogo.dtx' and `tocbasic.dtx' without this file.
-%% See also `tocbasic.dtx' for additional information.
+%% If this file is a beta version, you may not be allowed to distribute
+%% it. Look at the comments below to see if this is the case.
%%
-%% If this file is a beta version, you are not allowed to distribute it.
+%% English and German manuals are part of KOMA-Script bundle.
+%% ----------------------------------------------------------
%%
-%% Currently there is only a short english manual at `tocbasic.dtx', that
-%% should also be found as `tocbasic.pdf'.
+%% See `README'.
%%
%% The KOMA-Script bundle (but maybe not this file) was based upon the
-%% LaTeX2.09 Script family created by Frank Neukam 1993 and the LaTeX2e
-%% standard classes created by The LaTeX3 Project 1994-1996.
+%% LaTeX 2.09 Script family created by Frank Neukam 1993 and the LaTeX2e
+%% standard classes created by The LaTeX3 Project 1994-1996. You may
+%% find a complete unmodified copy of LaTeX2e at
+%% <http://www.ctan.org/pub/tex-archive/macros/latex/base/>.
%%
-%%% From File: tocbasic.dtx
-\def\tocbasicversion{2012/04/04 v3.10b}
-\ProvidesFile{tocbasic.tex}
- [\tocbasicversion\space KOMA-Script package
- (manual)%
- ]
+%%% From File: $Id: tocbasic.dtx 1533 2013-12-10 18:06:14Z mjk $
+\ProvidesFile{tocbasic.tex}[%
+ 2013/12/19 v3.12 KOMA-Script
+ package
+ (handling toc-files)%
+]
\translator{Markus Kohm}
@@ -65,7 +76,7 @@ the list of figures and the list of tables and thereby allow other classes or
packages some types of controll about these. For examples package
\Package{tocbasic} delegates language control of all these tables and lists of
contents to package \Package{babel}\IndexPackage{babel}%^^A
-(see \cite{package:babel})%^^A
+\ (see \cite{package:babel})%^^A
. So automatic change of language will be provides inside
all these tables and lists of contents. Using \Package{tocbasic} will
exculpate authors of classes and packages from implementation of such
@@ -333,37 +344,89 @@ Commands, that shouldn't be expanded while writing, should be prefixed by
\EndIndex{Cmd}{addtoeachtocfile}%
\begin{Declaration}
- \Macro{addcontentslinetoeachtocfile}\OParameter{owner}\Parameter{level}%
- \Parameter{contentsline}
+ \Macro{addxcontentsline}%
+ \Parameter{extension}\Parameter{level}\OParameter{number}%^^A
+ \Parameter{text}
+\end{Declaration}
+\BeginIndex{Cmd}{addxcontentsline}%
+The command \Macro{addxcontentsline}
+adds an entry of given \PName{level} to toc-file with \PName{extension}. If
+the \Parameter{number} is empty or omitted the entry won't have a number for
+the entry with the given \PName{text}. Entries without number may be left
+aligned to the number of the numbered entries of the same \PName{level} or
+indented like the text of the numbered entries of the same \PName{level},
+depending on the \PValue{numberline} feature.
+
+\begin{Example}
+ Maybe you are not using a \KOMAScript{} class but need a not numbered
+ chapter with entry to the table of contents. This may be done using
+\begin{lstcode}
+ \cleardoublepage
+ \csname phantomsection\endcsname
+ \addxcontentsline{toc}{chapter}
+ {Chapters without Numbers}
+ \chapter*{Chapters without Numbers}
+ \markboth{Chapters without Numbers}{}
+\end{lstcode}
+ As you can see, you simply have to replace usual \Macro{addcontentsline} by
+ \Macro{addxcontentsline} to support the \Package{tocbasic} feature
+ \PValue{numberline}.
+\end{Example}
+
+Note, that \Macro{addxcontentsline} uses
+\Macro{add\PName{level}\PName{extension}entry} if such a macro exists and
+\Macro{tocbasic@addxcontentsline} otherwise. Therefore you cannot define
+a macro \Macro{add\PName{level}\PName{extension}entry} using
+\Macro{addxcontentsline} but \Macro{tocbasic@addxcontentsline}.
+
+It is recommended to use \Macro{addxcontentsline} instead of
+\Macro{addcontentsline} whenever possible.%
+\EndIndex{Cmd}{addxcontentsline}
+
+\begin{Declaration}
+ \Macro{addcontentslinetoeachtocfile}\OParameter{owner}\Parameter{level}%^^A
+ \Parameter{contentsline}\\
+ \Macro{addxcontentslinetoeachtocfile}\OParameter{owner}%^^A
+ \Parameter{level}\OParameter{number}\Parameter{text}
\end{Declaration}
\BeginIndex{Cmd}{addcontentslinetoeachtocfile}%
-This command
+\BeginIndex{Cmd}{addxcontentslinetoeachtocfile}%
+The first command
is something like \Macro{addcontentsline} from \LaTeX{} kernel. In difference
to that it writes the \PName{contentsline} not only
into one file, but into all files of all known file extensions or of all known
file extensions of a given owner.
+
+The Command \Macro{addxcontentslinetoeachtocfile}%^^A
+\ is similar but uses
+\Macro{addxcontentsline} instead of \Macro{addcontentsline} and
+therefore supports \Package{tocbasic} feature \PValue{numberline}.
\begin{Example}
You are a class author and want to write the chapter entry not only to the
table of contents toc-file but to all toc-files, while \texttt{\#1} is the
title, that should be written to the files.
\begin{lstcode}
- \addcontentslinetoeachtocfile{chapter}{%
- \protect\numberline{\thechapter}#1}
+ \addxcontentslinetoeachtocfile
+ {chapter}[\thechapter]{#1}%
\end{lstcode}
In this case the current chapter number should be expanded while writing
into the file. So it isn't protected from expansion using \Macro{protect}.
\end{Example}
-While writing
-\Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} is the file
-extension of the file into which \PName{contentsline} will be written.
+While writing \Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}}
+is the file extension of the file into which \PName{contentsline} will be
+written.
+
+It is recommended to use \Macro{addxcontentslinetoeachtocfile} instead
+of \Macro{addcontentslinetoeachtocfile} whenever possible.
+\EndIndex{Cmd}{addxcontentslinetoeachtocfile}%
\EndIndex{Cmd}{addcontentslinetoeachtocfile}%
\begin{Declaration}
- \Macro{listoftoc}\OParameter{list of title}\Parameter{extension}
+ \Macro{listoftoc}\OParameter{list of title}\Parameter{extension}%^^A
\\
- \Macro{listoftoc*}\Parameter{extension}
+ \Macro{listoftoc*}\Parameter{extension}%^^A
\\
- \Macro{listofeachtoc}\OParameter{owner}
+ \Macro{listofeachtoc}\OParameter{owner}%^^A
\\
\Macro{listof\PName{file-extension}name}
\end{Declaration}
@@ -603,6 +666,11 @@ features. \Package{tocbasic} does know following features:
\OptionValue{listof}{numbered}\important{\OptionValue{listof}{numbered}}%
\IndexOption{listof~=\PValue{numbered}} for all file extensions of the owner
\PValue{float}.
+\item[\texttt{numberline}] \leavevmode\ChangedAt{v3.12}{\Package{tocbasic}}%
+ redefines \Macro{nonumberline} to use \Macro{numberline}. With this the not
+ numbered entries generated by \KOMAScript{} or using \Macro{nonumberline} at
+ the very beginning of the last argument of \Macro{addcontentline} will also
+ be indented like numbered entries of the same type.
\item[\texttt{onecolumn}] \leavevmode\ChangedAt{v3.01}{\Package{tocbasic}}%
typesets the corresponding table of contents or list of something with
internal one column mode of
@@ -843,6 +911,18 @@ toc-entry, and running head, if it was defined. If it was not defined it will
be defined and used in \Macro{tocbasic@listhead} automatically.
\EndIndex{Cmd}{tocbasic@listhead@\PName{extension}}%
+\begin{Declaration}
+ \Macro{tocbasic@addxcontentsline}%
+ \Parameter{extension}\Parameter{level}\Parameter{number}\Parameter{text}
+\end{Declaration}
+\BeginIndex{Cmd}{tocbasic@addxcontentsline}%
+This command
+uses \Macro{addcontentsline} to either create a numbered or not numbered text
+entry to toc-file with given \PName{extension}. Note, that all parameters of
+\Macro{tocbasic@addxcontentsline} are mandatory. But you may use an
+empty \PName{number} argument, if you don't want a number.
+\EndIndex{Cmd}{tocbasic@addxcontentsline}
+
\section{A Complete Example}
\label{sec:tocbasic.example}
@@ -1137,6 +1217,79 @@ may be found in \autoref{tab:tocbasic.DeclareNewTOC-options}.
additionally, then a non-floating environment \Environment{remarkbox-} will
be also defined. You may use \Macro{caption}\IndexCmd{caption} inside of
that non-floating environment as usual for floating environments.
+ \hyperref[tab:tocbasic.comparison]{Figure~\ref*{tab:tocbasic.comparison}}
+ showes a comparison of the commands, counters and environments of the
+ example environment \Environment{remarkbox} and of the commands, counters
+ and environments for figures.%
+ \begin{table}
+ \centering
+ \caption{Comparison of example environment \Environment{remarkbox}
+ and environment \Environment{figure}}
+ \label{tab:tocbasic.comparison}
+ \begin{tabularx}{\textwidth}{ll>{\raggedright}p{6em}X}
+ \toprule
+ \Environment{remarkbox} & \Environment{figure}
+ & options of \Macro{DeclareNewTOC} & short description \\[1ex]
+ \midrule
+ \Environment{remarkbox} & \Environment{figure}
+ & \Option{type}, \Option{float}
+ & floating environments of the respective types\\[1ex]
+ \Environment{remarkbox*} & \Environment{figure*}
+ & \Option{type}, \Option{float}
+ & columns spanning floating environments of the respective types\\[1ex]
+ \Counter{remarkbox} & \Counter{figure}
+ & \Option{type}, \Option{float}
+ & counter used by \Macro{caption}\\[1ex]
+ \Macro{theremarkbox} & \Macro{thefigure}
+ & \Option{type}, \Option{float}
+ & output command to the respective counters\\[1ex]
+ \Macro{remarkboxformat} & \Macro{figureformat}
+ & \Option{type}, \Option{float}
+ & formating command to the respective counters used by
+ \Macro{caption}\\[1ex]
+ \Macro{remarkboxname} & \Macro{figurename}
+ & \Option{type}, \Option{float}, \Option{name}
+ & names used in the label of \Macro{caption}\\[1ex]
+ \Macro{listofremarkboxes} & \Macro{listoffigures}
+ & \Option{types}, \Option{float}
+ & command to show the list of the respective environments\\[1ex]
+ \Macro{listremarboxname} & \Macro{listfigurename}
+ & \Option{type}, \Option{float}, \Option{listname}
+ & heading text of the respective list \\[1ex]
+ \Macro{fps@remarkbox} & \Macro{fps@figure}
+ & \Option{type}, \Option{float}, \Option{floattype}
+ & numeric float type for order perputation\\[1ex]
+ \File{lor} & \File{lof}
+ &
+ & file extension of the helper file of the respective list \\
+ \bottomrule
+ \end{tabularx}
+ \end{table}
+
+ And now a possible usage of the example environment:
+\begin{lstcode}
+ \begin{remarkbox}
+ \centering
+ Equal should be typeset equally
+ and with equal formatting.
+ \caption{First theorem of typography}
+ \label{rem:typo1}
+ \end{remarkbox}
+\end{lstcode}
+ A segment of an example page with this environment could be:
+ \begin{center}\footnotesize
+ \begin{tabular}
+ {|!{\hspace{.1\linewidth}}p{.55\linewidth}!{\hspace{.1\linewidth}}|}
+ \\
+ \centering
+ Equal should be typeset equally
+ and with equal formatting.\\[\abovecaptionskip]
+ {%
+ \usekomafont{caption}\footnotesize{\usekomafont{captionlabel}%
+ Remark 1: }First theorem of typography
+ }\\
+ \end{tabular}%
+ \end{center}%
\end{Example}
\EndIndex{Cmd}{DeclareNewTOC}%
\EndIndex{Package}{tocbasic}%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/typearea-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/typearea-experts.tex
index 15bfc38d8dd..7a2d45bc612 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/typearea-experts.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/typearea-experts.tex
@@ -1,6 +1,6 @@
% ======================================================================
-% typearea.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% typearea-experts.tex
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -17,8 +17,8 @@
%
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
-% typearea.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% typearea-experts.tex
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,31 +45,33 @@
%
% ======================================================================
-\ProvidesFile{typearea-experts.tex}[2012/04/17 KOMA-Script guide (chapter: typearea)]
+\KOMAProvidesFile{typearea-experts.tex}
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (chapter: typearea)]
\translator{Markus Kohm\and Gernot Hassenpflug}
-% Date of the translated German file: 2012/04/17
+% Date of the translated German file: 2013/05/31
\chapter{Additional Information about package \Package{typearea}}
\labelbase{typearea-experts}
This chapter gives additional information about package
\Package{typearea}. \iffree{Some parts of the chapter are subject to the
- \KOMAScript{} book \cite{book:komascript} only. This shouldn't be a problem,
- because the}{The} average user, who only want to use the package, won't need
-the information, that is addressed to users with non-standard requirements or
-who want to write their own packages using \Package{typearea}. Another part of
-the information describes features of \Package{typearea} that exist only
-because of compatibility to former releases of \KOMAScript{} or the standard
-classes. The features, that exist only because of compatibility to former
-\KOMAScript{} releases, are printed with a sans serif font. You shouldn't use
-them any longer.
+ \KOMAScript{} book \cite{book:komascript} only. This should not be a
+ problem, because the}{The} average user, who only want to use the package,
+does not need the information that is addressed to users with non-standard
+requirements or who want to write their own packages using
+\Package{typearea}. Another part of the information describes features of
+\Package{typearea} that exist only because of compatibility to former releases
+of \KOMAScript{} or the standard classes. The features, that exist only
+because of compatibility to former \KOMAScript{} releases, are printed with a
+sans serif font. You should not use them any longer.
\section{Expert Commands}
\label{sec:typearea-experts.experts}
-This section describes commands, that aren't of interest for average
+This section describes commands that are not of interest for average
users. Nevertheless these commands provide additional features for
experts. Because the information is addressed to experts it's condensed.
@@ -96,7 +98,7 @@ after usage of \Macro{activateareas}. Moreover all changes of
\Macro{storeareas}\Parameter{\Macro{command}}
\end{Declaration}
\BeginIndex{Cmd}{storearea}%
-With \Macro{storeareas} a \PName{\Macro{command}} will be defined, that may be
+With \Macro{storeareas} a \PName{\Macro{command}} will be defined that may be
used to restore all current settings of typing area and margins. This provides
to store the current settings, change them, do anything with valid changed
settings and restore the previous settings afterwards.
@@ -108,21 +110,25 @@ settings and restore the previous settings afterwards.
\documentclass[pagesize]{scrartcl}
\begin{document}
- \rule{\textwidth}{\textheight}
+ \noindent\rule{\textwidth}{\textheight}
\storeareas\MySavedValues
\KOMAoptions{paper=landscape,DIV=current}
- \rule{\textwidth}{\textheight}
+ \noindent\rule{\textwidth}{\textheight}
\clearpage
\MySavedValues
- \rule{\textwidth}{\textheight}
+ \noindent\rule{\textwidth}{\textheight}
\end{document}
\end{lstcode}
Command \Macro{clearpage}\textnote{Attention} before calling
\Macro{MySavedValues} is important to restore the saved values at the next
page.
\end{Example}
+In the example \Macro{noindent} has been used to avoid the paragraph indent of
+the black boxes. Without these commands the boxes would not show the
+typing area correctly.
+
Please note\textnote{Attention!} that neither \Macro{storeareas} nor the
defined \PName{\Macro{command}} should be used inside a group. Internally
\Macro{newcommand}\IndexCmd{newcommand*}\important{\Macro{newcommand*}} is
@@ -143,13 +149,14 @@ These commands manage \emph{hooks}. \Macro{AfterCalculatingTypearea} and it's
star version provide experts to execute \PName{instructions} every time
\Package{typearea} has recalculated the typing area and margins either
implicitly or because of an explicit usage of \Macro{typearea}. Similar
-\Macro{AfterSettingArea} and it's star version provide execution of
-\PName{instructions} every time \Macro{areaset} has been used. While normal
-versions work globally the influence of the star versions is only
-local. The \PName{instructions} will be executed instantly before execution of
-\Macro{activateareas}.\iffree{}{ In \autoref{cha:modernletters}
- \Macro{AfterCalculatingTypearea} will be used in letter class option
- \File{asymTypB.lco} to change the division of the margins.}%
+\Macro{AfterSettingArea}\ChangedAt{v3.11}{\Package{typearea}} and it's star
+version provide execution of \PName{instructions} every time \Macro{areaset}
+has been used. While normal versions work globally the influence of the star
+versions is only local. The \PName{instructions} will be executed instantly
+before execution of \Macro{activateareas}.\iffree{}{ In
+ \autoref{cha:modernletters} \Macro{AfterCalculatingTypearea} will be used in
+ letter class option \File{asymTypB.lco} to change the division of the
+ margins.}%
%
\EndIndex{Cmd}{AfterCalculatingTypearea}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/typearea.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/typearea.tex
index db2bce403f2..a752145682b 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/typearea.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/typearea.tex
@@ -1,6 +1,6 @@
% ======================================================================
% typearea.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% typearea.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,10 +45,12 @@
%
% ======================================================================
-\ProvidesFile{typearea.tex}[2012/07/22 KOMA-Script guide (chapter: typearea)]
+\KOMAProvidesFile{typearea.tex}%
+ [$Date: 2013-12-13 12:11:01 +0100 (Fr, 13. Dez 2013) $
+ KOMA-Script guide (chapter: typearea)]
\translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi}
-% Date of translated german file: 2012/07/22
+% Date of translated german file: 2013/11/21
\chapter{Construction of the Page Layout with \Package{typearea}}
\labelbase{typearea}
@@ -355,7 +357,7 @@ user, but rather at authors of classes and packages.
\cite{JTsch87}.
A disadvantage of this late Middle Age method is that the width of
- the text area is no longer dependent on the font. Thus, one doesn't
+ the text area is no longer dependent on the font. Thus, one does not
choose the text area to match the font, but the author or typesetter
has to choose the font according to the text area. This can be
considered a ``must''.
@@ -465,24 +467,24 @@ construction method is found in
larger the \PName{Factor}, the larger the text block and the smaller
the margins. Any integer value greater than 4 is valid for
\PName{Factor}. Please note that large values can lead to
-unfulfillment of various minor conditions in the type-area, depending
+unfulfillment of various minor conditions in the type area, depending
on further options chosen. Thus, in an extreme case, the header may
fall outside of the page. Users applying the option
\KOption{DIV}\PName{Factor} are themselves responsible for fulfillment
of the marginal conditions and setting of a typographically aesthetic
line length.
-In \autoref{tab:typearea.typearea} are found the type-area sizes for
+In \autoref{tab:typearea.typearea} are found the type area sizes for
several \Var{DIV} factors for an A4 page without binding correction. Here
the minor conditions dependent on font size are not considered.
\begin{table}
\centering
- \caption{Type-area dimensions dependent on \Var{DIV} for A4}
+ \caption{Type area dimensions dependent on \Var{DIV} for A4}
\begin{tabular}{ccccc}
\toprule
&
- \multicolumn{2}{c}{Type-area} & \multicolumn{2}{c}{Margins}\\
+ \multicolumn{2}{c}{Type area} & \multicolumn{2}{c}{Margins}\\
%\raisebox{1.5ex}[0pt]{
\Var{DIV}
%}
@@ -658,7 +660,7 @@ class is used together with a font package.
With \KOption{DIV}\PName{current}\ChangedAt{v3.00}{\Package{typearea}}
a renewed calculation of text block and margin is requested, in which
the currently set \Var{DIV} will be used. This is less of interest for
-renewed type-area calculations after loading a different font; it is
+renewed type area calculations after loading a different font; it is
rather more useful for determining, for example, after changing the
leading, while keeping \Var{DIV} the same, that the marginal condition
is fulfilled that \Length{textheight} less
@@ -670,7 +672,7 @@ exactly the same setting is used as in the last calculation.
\begin{Example}
Let us take up the previous example again, in which a good line
- length is required for a type-area using the Bookman font. At the
+ length is required for a type area using the Bookman font. At the
same time, a {\KOMAScript} class is to be used. This is easily
possible using the symbolic value \PValue{last} and the command
\Macro{KOMAoptions}:
@@ -697,25 +699,25 @@ can also lead to \LaTeX{} loading a different font.
\begin{desctabular}
\pventry{areaset}{Recalculate page
layout.\IndexOption{DIV~=areaset}}%
- \pventry{calc}{Recalculate type-area including choice of
+ \pventry{calc}{Recalculate type area including choice of
appropriate \Var{DIV} value.\IndexOption{DIV~=calc}}%
- \pventry{classic}{Recalculate type-area using Middle Age book
+ \pventry{classic}{Recalculate type area using Middle Age book
design canon (circle-based
calculation).\IndexOption{DIV~=classic}}%
- \pventry{current}{Recalculate type-area using current \Var{DIV}
+ \pventry{current}{Recalculate type area using current \Var{DIV}
value.\IndexOption{DIV~=current}}%
- \pventry{default}{Recalculate type-area using the standard value
+ \pventry{default}{Recalculate type area using the standard value
for the current page format and current font size. If no
standard value exists, \PValue{calc} is
used.\IndexOption{DIV~=default}}%
- \pventry{last}{Recalculate type-area using the same \PName{DIV}
+ \pventry{last}{Recalculate type area using the same \PName{DIV}
argument as was used in the last call.\IndexOption{DIV~=last}}%
\end{desctabular}
\end{table}
-Often the renewed type-area calculation is required in combination
+Often the renewed type area calculation is required in combination
with a change in the line spacing
-(\emph{leading})\Index{leading}. Since the type-area should be
+(\emph{leading})\Index{leading}. Since the type area should be
calculated such that an integer number of lines fit in the text block,
a change in the leading normally requires a recalculation of the page
layout.
@@ -733,7 +735,7 @@ layout.
\KOMAoptions{DIV=last}
\end{lstcode}\IndexCmd{linespread}
Since \Package{typearea} always executes the command
-\Macro{normalsize} itself upon calculation of a new type-area, it is
+\Macro{normalsize} itself upon calculation of a new type area, it is
not necessary to activate the chosen leading with \Macro{selectfont}
after \Macro{linespread}, since this will be used already in the
recalculation.
@@ -755,21 +757,26 @@ page should be reset to the normal value.
A complete example would be:
\fi
\begin{lstcode}
- \documentclass[10pt,twoside,BCOR=12mm,DIV=calc]{scrreprt}
+ \documentclass[10pt,twoside,BCOR=12mm,DIV=calc]
+ {scrreprt}
\usepackage{setspace}
\onehalfspacing
+ \AfterTOCHead{\singlespacing}
\KOMAoptions{DIV=last}
\begin{document}
\title{Title}
\author{Markus Kohm}
\begin{spacing}{1}
\maketitle
- \tableofcontents
\end{spacing}
+ \tableofcontents
\chapter{Ok}
\end{document}
\end{lstcode}
- See further also the notes in \autoref{sec:typearea.tips}.
+ See further also the notes in \autoref{sec:typearea.tips}. The command
+ \Macro{AfterTOCHead}\IndexCmd{AfterTOCHead} will be described in
+ \autoref{cha:tocbasic} of \autoref{part:forExoerts} on
+ \autopageref{desc:tocbasic.cmd.AfterTOCHead}.
\end{Example}
Please note that when using this option with one of the {\KOMAScript}
@@ -813,7 +820,7 @@ margins are automatically recalculated anew.%
\Macro{typearea}\OParameter{BCOR}\Parameter{DIV}}
\label{tab:symbolicBCOR}
\begin{desctabular}
- \pventry{current}{Recalculate type-area with the currently valid
+ \pventry{current}{Recalculate type area with the currently valid
\Var{BCOR} value.\IndexOption{BCOR~=current}}
\end{desctabular}
\end{table}
@@ -828,7 +835,7 @@ change to \PName{BCOR}.
\begin{Explain}
The command \Macro{typearea} is currently defined so as to make it
- possible to change the type-area anywhere within a
+ possible to change the type area anywhere within a
document. Several assumptions about the structure of the {\LaTeX}
kernel are however made and internal definitions and sizes of the
kernel changed. There is a definite possibility, but no guarantee,
@@ -838,7 +845,7 @@ change to \PName{BCOR}.
Since \Macro{typearea}\POParameter{current}\PParameter{last} or
\Macro{KOMAoptions}\PParameter{DIV=last} are often needed for
-recalculation of the type-area, there exists specially the
+recalculation of the type area, there exists specially the
abbreviated command
\Macro{recalctypearea}\ChangedAt{v3.00}{\Package{typearea}}.
@@ -882,38 +889,42 @@ typesetting is carried out. Deactivation of the option leads to
single-sided typesetting.
\begin{table}
- \begin{minipage}{\textwidth}
\centering
\caption{Standard values for simple switches in \KOMAScript}
\begin{tabular}{ll}
\toprule
Value & Description \\
\midrule
- \PValue{true}\footnote{This value will be used also, if you use the option
- without assigning any value.} & activates the option \\
+ \PValue{true} & activates the option \\
\PValue{on} & activates the option \\
- \PValue{yes} & activates the option \\
+ \PValue{yes} & activates the option \\
\PValue{false}& deactivates the option \\
\PValue{off} & deactivates the option \\
- \PValue{no} & deactivates the option \\
+ \PValue{no} & deactivates the option \\
\bottomrule
\end{tabular}
\label{tab:truefalseswitch}
- \end{minipage}
\end{table}
Apart from the values in \autoref{tab:truefalseswitch} the value
-\PValue{semi}\ChangedAt{v3.00}{\Package{typearea}} can also be
-given. The value \PValue{semi} results in a double-sided typesetting
-with single-sided margins and single-sided, i.\ e., not alternating,
-margin notes.
+\PValue{semi}\ChangedAt{v3.00}{\Package{typearea}} can also be given. The
+value \PValue{semi} results in a double-sided typesetting with single-sided
+margins and single-sided, i.\ e., not alternating, margin
+notes. Nevertheless\ChangedAt{v3.12}{\Package{typearea}}, since \KOMAScript{}
+version 3.12 binding corrections (see \Option{BCOR},
+\autopageref{desc:typearea.option.BCOR}) will be part of the left margin on
+odd pages but part of the right margin on even pages. But if you use
+compatibility with prior versions of \KOMAScript (see
+\autoref{sec:typearea.compatibilityOptions},
+\autopageref{sec:typearea.compatibilityOptions}), binding correction will be
+part of the left margin on both pages while using \OptionValue{twoside}{semi}.
The option can also be passed as class option in
\Macro{documentclass}, as package option to \Macro{usepackage}, or
even after loading of the \Package{typearea} package with the use of
\Macro{KOMAoptions} or \Macro{KOMAoption}. Use of the option after
loading the \Package{typearea} package results automatically in
-recalculation of the type-area using \Macro{recalctypearea} (see
+recalculation of the type area using \Macro{recalctypearea} (see
\autopageref{desc:typearea.cmd.recalctypearea}). If double-sided
typesetting was active before the option was set, then before the
recalculation a page break is made to the next odd page.%
@@ -925,11 +936,11 @@ recalculation a page break is made to the next odd page.%
\begin{Declaration}
\KOption{twocolumn}\PName{simple switch}
\end{Declaration}
-For the calculation of a good type-area with the help of
+For the calculation of a good type area with the help of
\OptionValue{DIV}{calc} it is useful to know in advance if the
document is to be typeset one-column or two-column. Since the
observations about line length in \autoref{sec:typearea.basics} then
-apply to each column, the width of a type-area in a two-column
+apply to each column, the width of a type area in a two-column
document can be up to double that in a one-column document.
To implement this difference, the \Package{typearea} package must be
@@ -945,7 +956,7 @@ The option can also be passed as class option in
even after loading of the \Package{typearea} package with the use of
\Macro{KOMAoptions} or \Macro{KOMAoption}. Use of the option after
loading the \Package{typearea} package results automatically in
-recalculation of the type-area using \Macro{recalctypearea} (see
+recalculation of the type area using \Macro{recalctypearea} (see
\autopageref{desc:typearea.cmd.recalctypearea}).%
%
\EndIndex{Option}{twocolumn~=\PName{simple switch}}
@@ -958,8 +969,8 @@ recalculation of the type-area using \Macro{recalctypearea} (see
\KOption{footinclude}\PName{simple switch}
\end{Declaration}%
\begin{Explain}%
- So far we have discussed how the type-area is
- calculated\Index{type-area} and the relationship of the
+ So far we have discussed how the type area is
+ calculated\Index{type area} and the relationship of the
margins\Index{margins} to one another and between margins and text
block. However, one important question has not been answered: What
constitutes the margins?
@@ -1039,9 +1050,9 @@ Please note that when using these options with one of the
either as a class option, or passed via \Macro{KOMAoptions} or
\Macro{KOMAoption} after loading the class. Changing of these options
after loading the \Package{typearea} package does not result in an
-automatic recalculation of the type-area. Instead, the changes only
-take effect at the next recalculation of the type-area. For
-recalculation of the type-area, refer to the \Option{DIV} option with
+automatic recalculation of the type area. Instead, the changes only
+take effect at the next recalculation of the type area. For
+recalculation of the type area, refer to the \Option{DIV} option with
the values \PValue{last} or \PValue{current} (see
\autopageref{desc:typearea.option.DIV.last}) or the
\Macro{recalctypearea} command (see
@@ -1083,7 +1094,7 @@ double-sided page layout has been chosen. The option
ragged text gives no homogeneous optical impression, the long lines
can reach right into the normal margin. This can be done using
option \Option{mpinclude} and by an enlargement of length
- \Length{marginparwidth} after the type-area has been set up. The
+ \Length{marginparwidth} after the type area has been set up. The
length can be easily enlarged with the command \Macro{addtolength}.
How much the length has to be enlarged depends on the special
situation and it requires some flair. This is another reason the
@@ -1098,7 +1109,7 @@ double-sided page layout has been chosen. The option
Currently there is no option to enlarge the margin by a given
amount. The only solution is to either not use the option
\Option{mpinclude} or to set \Option{mpinclude} to \PValue{false},
- and after the type-area has been calculated, one reduces the
+ and after the type area has been calculated, one reduces the
width of the text body \Length{textwidth} and enlarges the margin
width \Length{marginparwidth} by the same amount. Unfortunately,
this cannot be combined with automatic calculation of the
@@ -1113,9 +1124,9 @@ classes as in the example above, it must be used either as a class
option, or passed via \Macro{KOMAoptions} or \Macro{KOMAoption} after
loading the class. Changing of this option after loading the
\Package{typearea} package does not result in an automatic
-recalculation of the type-area. Instead, the changes only take effect
-at the next recalculation of the type-area. For recalculation of the
-type-area, refer to the \Option{DIV} option with the values
+recalculation of the type area. Instead, the changes only take effect
+at the next recalculation of the type area. For recalculation of the
+type area, refer to the \Option{DIV} option with the values
\PValue{last} or \PValue{current} (see
\autopageref{desc:typearea.option.DIV.last}) or the
\Macro{recalctypearea} command (see
@@ -1130,7 +1141,7 @@ type-area, refer to the \Option{DIV} option with the values
\KOption{headlines}\PName{number of lines}\\
\KOption{headheight}\PName{height}
\end{Declaration}%
-We have seen how to calculate the type-area using the
+We have seen how to calculate the type area using the
\Package{typearea} package and how to specify whether header and
footer are part of the text or the margins. However, in particular for
the header, we still have to specify the height. This is achieved with
@@ -1149,7 +1160,7 @@ its default value and adapt it only in special cases.
Assume that you want to use a header with two lines. Normally this would
result in an ``\texttt{overfull} \Macro{vbox}'' warning for each page. To
prevent this from happening, the \Package{typearea} package is told to
- calculate an appropriate type-area:
+ calculate an appropriate type area:
\begin{lstcode}
\documentclass[a4paper]{article}
\usepackage[headlines=2.1]{typearea}
@@ -1159,8 +1170,8 @@ directly as a class option:
\begin{lstcode}
\documentclass[a4paper,headlines=2.1]{scrartcl}
\end{lstcode}
-Commands that can be used to define the contents of a header with two
-lines are described in \autoref{cha:scrpage}.
+Commands that can be used to define the contents of a header with two lines
+are described in \autoref{cha:scrpage} and \autoref{cha:scrlayer-scrpage}.
\end{Example}
In some cases it is useful to be able to specify the header height not
@@ -1169,7 +1180,7 @@ with the aid of the alternative option \Option{headheight}. For
\PName{height} any lengths and sizes that \LaTeX{} understands are
valid. It should be noted though that when using a \LaTeX{} length
such as \Length{baselineskip} its value at the time of the calculation
-of the type-area and margins, not at the time of setting of the
+of the type area and margins, not at the time of setting of the
option, is decisive.
Please note that when using these options with one of the
@@ -1177,9 +1188,9 @@ Please note that when using these options with one of the
either as a class option, or passed via \Macro{KOMAoptions} or
\Macro{KOMAoption} after loading the class. Changing of these options
after loading the \Package{typearea} package does not result in an
-automatic recalculation of the type-area. Instead, the changes only
-take effect at the next recalculation of the type-area. For
-recalculation of the type-area, refer to the \Option{DIV} option with
+automatic recalculation of the type area. Instead, the changes only
+take effect at the next recalculation of the type area. For
+recalculation of the type area, refer to the \Option{DIV} option with
the values \PValue{last} or \PValue{current} (see
\autopageref{desc:typearea.option.DIV.last}) or the
\Macro{recalctypearea} command (see
@@ -1188,13 +1199,87 @@ the values \PValue{last} or \PValue{current} (see
\EndIndex{Option}{headheight~=\PName{height}}%
\EndIndex{Option}{headlines~=\PName{number}}
+\begin{Declaration}
+ \KOption{footlines}\PName{number}\\
+ \KOption{footheight}\PName{height}
+\end{Declaration}
+\BeginIndex{Option}{footlines~=\PName{number}}%
+\BeginIndex{Option}{footheight~=\PName{height}}%
+As\ChangedAt{v3.12}{\Package{typearea}} well as we needed a height value for
+the head, we need a height value for the page footer. But in difference to the
+height of the head, \LaTeX itself do not provide a length for the height of
+the page footer. So \Package{typearea} defines the new length
+\Length{footheight}\IndexLength[indexmain]{footheight}, if it does not
+exist. Wether or not this length will be used by classes or packages depends
+on the classes and packages, that will be used. The \KOMAScript{} package
+\Package{scrlayer-scrpage} incorporates \Length{footheight} and actively
+cooperates with \Package{typearea}. The \KOMAScript{} classes do not recognize
+\Length{footheight}, because without any package assistance they provide only
+page styles with single-line page footers.
+
+You can use \Option{footlines} to setup the \PName{number} of lines in the
+page footer, similar to \Option{headlines} for the number of lines in the page
+header. By default \Package{typearea} uses 1.25 footlines. This is a
+compromise, large enough for overlining or underlining footers and small
+enough that the relative weight of the bottom margin is not affected too mich
+when the footer is neither over- nor underlined. Thus in most cases you may
+leave \PName{footlines} at its default value and adapt it only in special
+cases.
+
+\begin{Example}
+ Assume a two-lined copyright note should be placed in the page
+ footer. Indeed, \LaTeX{} itself does not test, whether or not the footer has
+ room enough for that, exceeding of the available height would probably could
+ result in unbalanced margins. Moreover, for example package
+ \Package{scrlayer-scrpage}, that may be used to define such a page footer,
+ would definitely do such a test and would notify a recognised oversize. So
+ it makes sense, to declare the needed footheight already for the calculation
+ of the text area and the margins:
+\begin{lstcode}
+ \documentclass[a4paper]{article}
+ \usepackage[footlines=2.1]{typearea}
+\end{lstcode}
+ Again, if you use a \KOMAScript{} class, it is recommended to pass this
+ option directly a a class option:
+\begin{lstcode}
+ \documentclass[footlines=2.1]{scrartcl}
+\end{lstcode}
+ Commands that can be used to define the contents of a footer with two lines
+ are described in \autoref{cha:scrlayer-scrpage}.
+\end{Example}
+
+In some cases it is useful to be able to specify the footer height not
+in lines but directly as a length measurement. This is accomplished
+with the aid of the alternative option \Option{footheight}. For
+\PName{height} any lengths and sizes that \LaTeX{} understands are
+valid. It should be noted though that when using a \LaTeX{} length
+such as \Length{baselineskip} its value at the time of the calculation
+of the type area and margins, not at the time of setting of the
+option, is decisive.
+
+Please note that when using these options with one of the
+{\KOMAScript} classes as in the example above, they must be used
+either as a class option, or passed via \Macro{KOMAoptions} or
+\Macro{KOMAoption} after loading the class. Changing of these options
+after loading the \Package{typearea} package does not result in an
+automatic recalculation of the type area. Instead, the changes only
+take effect at the next recalculation of the type area. For
+recalculation of the type area, refer to the \Option{DIV} option with
+the values \PValue{last} or \PValue{current} (see
+\autopageref{desc:typearea.option.DIV.last}) or the
+\Macro{recalctypearea} command (see
+\autopageref{desc:typearea.cmd.recalctypearea}).%
+\EndIndex{Option}{footheight~=\PName{height}}%
+\EndIndex{Option}{footlines~=\PName{number}}%
+
+
\BeginIndex{Cmd}{areaset}%
\begin{Declaration}
\Macro{areaset}\OParameter{BCOR}\Parameter{Width}\Parameter{Height}
\end{Declaration}%
So far we have seen how a good or even very good
-type-area\Index{type-area} is calculated and how the
+type area\Index{type area} is calculated and how the
\Package{typearea} package can support these calculations, giving you
at the same time the freedom to adapt the layout to your needs.
However, there are cases where the text body has to fit exactly some
@@ -1230,7 +1315,7 @@ text line is \Macro{topskip} below the top margin of the type area, as
long as the height of the topmost line is less than
\Macro{topskip}. Thus, the uppermost line does not require any
height. The descenders of characters on the lowermost line, on the
-other hand, hang below the dimensions of the type-area.
+other hand, hang below the dimensions of the type area.
\item A poetry book with a square text body with a page length of
15\Unit{cm} and a binding correction of 1\Unit{cm} could be
@@ -1248,7 +1333,7 @@ other hand, hang below the dimensions of the type-area.
\OptionValue{DIV}{areaset}
\end{Declaration}%
In\ChangedAt{v3.00}{\Package{typearea}} rare cases it is useful to be
-able to reconstruct the current type-area anew. This is possible via
+able to reconstruct the current type area anew. This is possible via
the option \OptionValue{DIV}{areaset}, where
\Macro{KOMAoptions}\PParameter{DIV=areaset} corresponds to the
\begin{lstcode}[belowskip=\dp\strutbox]
@@ -1356,8 +1441,8 @@ classes, it must be used either as a class option, or passed via
\Macro{KOMAoptions} or \Macro{KOMAoption} after loading the
class. Changing of this option after loading the \Package{typearea}
package does not result in an automatic recalculation of the
-type-area. Instead, the changes only take effect at the next
-recalculation of the type-area. For recalculation of the type-area,
+type area. Instead, the changes only take effect at the next
+recalculation of the type area. For recalculation of the type area,
refer to the \Option{DIV} option with the values \PValue{last} or
\PValue{current} (see \autopageref{desc:typearea.option.DIV.last}) or
the \Macro{recalctypearea} command (see
@@ -1375,7 +1460,7 @@ the \Macro{recalctypearea} command (see
The above-mentioned mechanisms for choice of paper format only
affect the output insofar as internal {\LaTeX} lengths are set. The
\Package{typearea} package then uses them in the division of the
- page into type-area and margins.
+ page into type area and margins.
The specification of the DVI
formats\Index{DVI}, however, does not include any indications of paper
format. If printing is done directly from DVI format to a low-level
@@ -1421,7 +1506,7 @@ at \autoref{tab:typearea.outputdriver}. The default is
\Macro{mediaheight}\IndexLength{mediaheight} are defined, they will be
set additionally.\IndexOption{pagesize~=\PValue{automedia}}}%
\entry{\PValue{false}, \PValue{no}, \PValue{off}}{%
- Doesn't set any output driver and doesn't send page size information to
+ Does not set any output driver and does not send page size information to
the output driver.\IndexOption{pagesize~=\PValue{false}}}%
\pventry{dvipdfmx}{\ChangedAt{v3.05a}{\Package{typearea}}Writes paper size
into DVI files using
@@ -1516,7 +1601,7 @@ not as a fixed, but as an average or maximal value.%
As executed, record regulations are usually intended to obtain a
usable result even if the author does not know what needs to be
considered. \emph{Usable} frequently means readable and correctable. In
-the author's opinion the type-area of a text set with {\LaTeX} and the
+the author's opinion the type area of a text set with {\LaTeX} and the
\Package{typearea} package meets these criteria well right from the
start. Thus if one is confronted with regulations which deviate
obviously substantially from it, then the author recommends submitting
@@ -1527,7 +1612,7 @@ modification of option \Option{DIV}. The author advises against the
use of \Macro{areaset} for this purpose however. In the worst case
one may make use of the geometry package (see
\cite{package:geometry}), which is not part of \KOMAScript, or change
-the type-area parameters of \LaTeX. One may find the values
+the type area parameters of \LaTeX. One may find the values
determined by \Package{typearea} in the \File{log} file of one's
document. Thus moderate adjustments should be possible. However, one
should make absolutely sure that the proportions of the text area
@@ -1542,7 +1627,7 @@ too frequently, it has been obsolete since the introduction of
\Macro{linespread}. The author recommends the package
\Package{setspace}\IndexPackage{setspace} (see
\cite{package:setspace}), which is not part of \KOMAScript. Also one
-should let \Package{typearea} recalculate a new type-area after the
+should let \Package{typearea} recalculate a new type area after the
conversion of the line spacing. However, one should switch back to
the normal line spacing for the title, preferably also for the table
contents and various listings\,---\,as well as the bibliography and
@@ -1557,7 +1642,7 @@ respective document. Thus one can select a smaller value easily after
the first {\LaTeX} run.
The question is not infrequently put to the author, why he spends an
-entire chapter discussing type-area calculations, when it would be
+entire chapter discussing type area calculations, when it would be
very much simpler to merely give the world a package with which anyone
can adjust the margins like in a word processor. Often it is added
that such a package would in any case be the better solution, since
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/guide.bib b/Master/texmf-dist/source/latex/koma-script/doc/guide.bib
index 8bc465fd7b7..1a9b3ea8bd1 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/guide.bib
+++ b/Master/texmf-dist/source/latex/koma-script/doc/guide.bib
@@ -1,6 +1,6 @@
% ======================================================================
% guide.bib
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% guide.bib
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -80,12 +80,12 @@
author = {Kohm, Markus and Morawski, Jens-Uwe},
title = {{\KOMAScript}},
subtitle= {Eine Sammlung von Klassen und Paketen für {\LaTeXe}},
- year = 2008,
- edition = 3,
+ year = 2012,
+ edition = 4,
publisher={Lehmanns Media},
address = {Berlin},
series = {Edition DANTE},
- isbn = {978-3-86541-291-1}
+ isbn = {978-3-86541-459-5}
}
@Book{ DUDEN,
@@ -172,6 +172,15 @@
address = {Berlin}
}
+@Manual{ manual:eTeX,
+ language = {english},
+ author = {The {\NTS} Team},
+ title = {The {\eTeX} manual},
+ year = {1998},
+ month = feb,
+ url = {CTAN://systems/e-tex/v2/doc/etex_man.pdf}
+}
+
@Manual{ latex:source2e,
language = {english},
author = {Johannes Braams and David Carlisle and Alan Jeffrey and Leslie Lamport and Frank Mittelbach and Chris Rowley and Rainer Schöpf},
@@ -201,11 +210,11 @@
@Manual{ l2kurz,
language = {ngerman},
- author = {Walter Schmidt and Jörg Knappen and Hubert Partl and Irene
-Hyna},
+ author = {Marco Daniel and Patrick Gundlach and Walter Schmidt and Jörg Knappen and Hubert Partl and Irene Hyna},
title = {{\LaTeXe}-Kurzbeschreibung},
- year = 1999,
- month = apr,
+ year = 2012,
+ month = jul,
+ version = {3.0},
url = {CTAN://info/lshort/german/}
}
@@ -214,10 +223,10 @@ Hyna},
author = {Tobias Oetker and Hubert Partl and Irene Hyna and Elisabeth
Schlegl},
title = {The Not So Short Introduction to {\LaTeXe}},
- year = 1999,
+ year = 2011,
month = apr,
- version = {3.7},
- url = {CTAN://info/lshort/}
+ version = {5.01},
+ url = {CTAN://info/lshort/english}
}
@Book{ latexbook,
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/guide.tex b/Master/texmf-dist/source/latex/koma-script/doc/guide.tex
index 6fc6a8c55dd..41ba9402133 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/guide.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/guide.tex
@@ -45,7 +45,7 @@
%
% ======================================================================
-\ProvidesFile{guide.tex}[2012/02/22 KOMA-Script guide main file]
+\ProvidesFile{guide.tex}[2013/10/14 KOMA-Script guide main file]
\documentclass[\languagename]{scrguide}
@@ -95,6 +95,7 @@
\include{scrbookreportarticle}
\include{scrlttr2}
\include{scrpage2}
+\include{scrlayer-scrpage}
\include{scrdatetime}
\include{scraddr}
\include{adrconvnote}
@@ -106,6 +107,9 @@
\include{scrwfile}
\include{tocbasic}
\include{scrhack}
+\include{scrlayer}
+\include{scrlayer-scrpage-experts}
+\include{scrlayer-notecolumn}
\include{typearea-experts}
\include{scrbookreportarticle-experts}
\include{scrlttr2-experts}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-0.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-0.tex
index 8954468a96f..1838631a98a 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-0.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-0.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-0.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-0.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-0.tex}[2011/08/26 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-0.tex}
+ [$Date: 2013-12-12 12:01:33 +0100 (Do, 12. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\makeatletter
\@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}%
@@ -78,13 +80,26 @@ neben %
"~Klassen }%
\IfCommon{scrjura}{\Package{scrjura} auch andere \KOMAScript-Pakete und
"~Klassen }%
-betrifft. Damit die Anwender alle Informationen zu einem Paket oder einer
-Klasse im jeweiligen Kapitel finden, ist dieser Abschnitt nahezu gleichlautend
-in mehreren Kapiteln zu finden. Anwender, die nicht nur an der Anleitung zu
-einem Paket oder einer Klasse interessiert sind, sondern sich einen
-Gesamtüberblick über \KOMAScript{} verschaffen wollen, brauchen diesen
-Abschnitt nur in einem der Kapitel zu lesen und können ihn beim weiteren
-Studium der Anleitung dann überspringen.
+\IfCommon{scrlayer}{\Package{scrlayer} auch andere \KOMAScript-Pakete und
+ "-Klassen }%
+\IfCommon{scrlayer-scrpage}{\Package{scrlayer} auch andere \KOMAScript-Pakete
+ und "-Klassen }%
+betrifft. %
+% Umbruchvarianten:
+\IfNotCommon{scrlttr2}{Damit die Anwender alle Informationen zu einem Paket
+ oder einer Klasse im jeweiligen Kapitel finden, ist dieser Abschnitt nahezu
+ gleichlautend in mehreren Kapiteln zu finden. Anwender, die nicht nur an
+ der Anleitung zu einem Paket oder einer Klasse interessiert sind, sondern
+ sich einen Gesamtüberblick über \KOMAScript{} verschaffen wollen, brauchen
+ diesen Abschnitt nur in einem der Kapitel zu lesen und können ihn
+ \IfCommon{maincls}{bei den weiteren Kapitel überspringen.}%
+ \IfNotCommon{maincls}{beim weiteren Studium der Anleitung dann
+ überspringen.}%
+} %
+\IfCommon{scrlttr2}{Im Sinne der Abgeschlossenheit der Kapitel ist dieser
+ Abschnitt nahezu identisch in mehreren Kapiteln zu finden, braucht aber beim
+ Studium des gesamten von \KOMAScript{} natürlich nur in einem gelesen
+ werden.}
\begin{Declaration}
\Macro{documentclass}\OParameter{Optionenliste}%
@@ -111,19 +126,44 @@ arbeiten \Macro{documentclass} und \Macro{usepackage} bei \KOMAScript{} wie in
\cite{latex:usrguide} oder jeder \LaTeX-Einführung, beispielsweise
\cite{l2kurz}, beschrieben.%
%
-\IfNotCommon{scrjura}{\IfNotCommon{scrhack}{\IfNotCommon{scrextend}{\par%
- Bei Verwendung einer \KOMAScript-Klasse\textnote{Achtung!} sollten im
- Übrigen beim
+\iffree{}{\IfCommon{scrlayer-scrpage}{\par
+ Das als veraltet zu betrachtende Paket
+ \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}
+ besitzt diese Erweiterung übrigens nicht. Es versteht daher nur einfache
+ Optionen ohne Wertzuweisung.\par}}%
+%
+\IfNotCommon{scrjura}{%
+ \IfNotCommon{scrhack}{%
+ \IfNotCommon{scrlayer}{%
+ \IfNotCommon{scrlayer-scrpage}{%
+ \IfNotCommon{scrlayer-notecolumn}{%
+ \IfNotCommon{scrextend}{\par%
+ Bei Verwendung einer \KOMAScript-Klasse\textnote{Achtung!} sollten
+ im Übrigen beim
% Die Alternativen an dieser Stelle dienen der Verbesserung des Umbruchs
-\IfCommon{typearea}{überflüssigen, expliziten }%
-Laden des Pakets \Package{typearea} oder \Package{scrbase} keine Optionen
-angegeben werden. Das ist darin begründet, dass die Klasse diese Pakete
-bereits ohne Optionen lädt und \LaTeX{} das mehrmalige Laden eines Pakets mit
-unterschiedlicher Angabe von Optionen verweigert.%
-\IfCommon{maincls}{\ Überhaupt ist es bei Verwendung einer \KOMAScript-Klasse
- nicht notwendig, eines dieser Pakete auch noch explizit zu laden.}%
-\IfCommon{scrlttr2}{\ Überhaupt ist es bei Verwendung einer \KOMAScript-Klasse
- nicht notwendig, eines dieser Pakete auch noch explizit zu laden.}}}}%
+ \IfCommon{typearea}{überflüssigen, expliziten }%
+ Laden des Pakets \Package{typearea} oder \Package{scrbase} keine
+ Optionen angegeben werden. Das ist darin begründet, dass die
+ Klasse diese Pakete bereits ohne Optionen lädt und \LaTeX{} das
+ mehrmalige Laden eines Pakets mit unterschiedlicher Angabe von
+ Optionen verweigert.%
+% \IfCommon{maincls}{\ Überhaupt ist es bei Verwendung einer
+% \KOMAScript-Klasse nicht notwendig, eines dieser Pakete auch
+% noch explizit zu laden.}%
+ \IfCommon{scrlttr2}{\ Überhaupt ist es bei Verwendung einer
+ \KOMAScript-Klasse nicht notwendig, eines dieser Pakete auch
+ noch explizit zu laden.}}}}}}}
+
+Gegenüber der nachfolgend vorgestellten Schnittstelle zu Einstellungen von
+Optionen haben \Macro{documentclass} und \Macro{usepackage} einen Nachteil,
+der unbedingt zu beachten\textnote{Achtung!} ist: Anweisungen, Längen, Zähler
+und ähnliches können darin leicht zerbrechen. So führt die Verwendung einer
+\LaTeX-Länge im Wert einer Option bei diesen Anweisungen zu einer
+Fehlermeldung, noch bevor der Wert an \KOMAScript{} übergeben wird, es also
+die Kontrolle darüber übernehmen könnte. Wertzuweisungen mit \LaTeX-Längen
+oder \LaTeX-Zählern sollten daher nie per \Macro{documentclass} oder
+\Macro{usepackage}, sondern immer mit den nachfolgend dokumentierten
+Anweisungen \Macro{KOMAoptions} oder \Macro{KOMAoption} vorgenommen werden.%
%
\EndIndex{Cmd}{usepackage}%
\EndIndex{Cmd}{documentclass}%
@@ -149,34 +189,40 @@ einfach in der Form \PName{Option}, so wird automatisch dieser Säumniswert
angenommen.
Manche Optionen können %
-\IfCommon{maincls}{auch }% Umbruchkorrektur
-\IfCommon{scrlttr2}{auch }% Umbruchkorrektur
+%\IfCommon{maincls}{auch }% Umbruchkorrektur
+%\IfCommon{scrlttr2}{auch }% Umbruchkorrektur
gleichzeitig mehrere Werte besitzen. Für solche Optionen besteht die
-Möglichkeit, mit Hilfe von \Macro{KOMAoption} der einen \PName{Option}
+Möglichkeit, mit \Macro{KOMAoption} der einen \PName{Option}
nacheinander eine Reihe von Werten zuzuweisen. Die einzelnen Werte sind dabei
in der \PName{Werteliste} durch Komma voneinander getrennt.
-\begin{Explain}
- \looseness=-1
- Falls man in der \PName{Optionenliste} eine Option auf einen unzulässigen
- Wert setzt oder die \PName{Werteliste} einen unzulässigen Wert enthält, so
- wird ein Fehler gemeldet. Wird \LaTeX{} in einem Modus verwendet, in dem im
- Fehlerfall Interaktionen möglich sind, so stoppt \LaTeX{} in diesem
- Fall. Durch Eingabe von »\texttt{h}« erhält man dann eine Hilfe, in der
- auch die möglichen Werte für die entsprechende Option angegeben sind.
-
- Soll\textnote{Achtung!} in einem \PName{Wert} ein Gleichheitszeichen oder
- ein Komma vorkommen, so ist der \PName{Wert} in geschweifte Klammern zu
- setzen.
+Soll\textnote{Achtung!} ein \PName{Wert} ein Gleichheitszeichen oder ein Komma
+enthalten, so ist der \PName{Wert} in geschweifte Klammern zu setzen.
+\begin{Explain}
\KOMAScript{} bedient sich für die Realisierung dieser Möglichkeit der
Anweisungen \Macro{FamilyOptions} und \Macro{FamilyOption} mit der Familie
- »\PValue{KOMA}«. Näheres zu diesen Anweisungen ist %
+ »\PValue{KOMA}«.
+\iffalse % Umbruchkorrektur
+ Näheres zu diesen Anweisungen ist %
\IfCommon{maincls}{für Experten }%
\IfCommon{scrlttr2}{für Experten }%
in \autoref{sec:scrbase.keyvalue},
\autopageref{desc:scrbase.cmd.FamilyOptions} zu finden.
-\end{Explain}
+\else
+ %
+ Siehe dazu \autoref{part:forExperts}, \autoref{sec:scrbase.keyvalue},
+ \autopageref{desc:scrbase.cmd.FamilyOptions}.
+ %
+\fi
+
+\end{Explain}%
+\iffree{}{\IfCommon{scrlayer-scrpage}{\par
+ Das als veraltet zu betrachtende Paket
+ \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}
+ besitzt diese Erweiterung übrigens nicht. Optionen können daher nur über
+ die zuvor erklärte Möglichkeit während des Ladens des Pakets gesetzt
+ werden.}}%
%
\EndIndex{Cmd}{KOMAoption}%
\EndIndex{Cmd}{KOMAoptions}%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-1.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-1.tex
index c02527550df..60ded49b399 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-1.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-1.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-1.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-1.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-1.tex}[2011/09/20 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-1.tex}
+ [$Date: 2013-12-12 12:01:33 +0100 (Do, 12. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\makeatletter
\@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}%
@@ -67,15 +69,14 @@ geschrieben wurde. \IfCommon{scrlttr2}{Allerdings existiert diese Möglichkeit
\IfCommon{typearea}{Wer seine Dokumente im Quellcode archiviert, legt in der
Regel allergrößten Wert darauf, dass bei zukünftigen \LaTeX{}-Läufen immer
- wieder exakt dasselbe Ergebnis erzielt wird. In einigen Fällen ist es aber
- so, dass Verbesserungen und Korrekturen am Paket zu Änderungen im
- Verhalten, inbesondere beim Umbruch, führen. Dies ist in einigen Fällen
- jedoch eher unerwünscht.}%
+ wieder exakt dasselbe Ergebnis erzielt wird. In einigen Fällen führen aber
+ Verbesserungen und Korrekturen am Paket zu Änderungen im Verhalten,
+ inbesondere beim Umbruch. Dies ist jedoch manchmal eher unerwünscht.}%
\IfCommon{maincls}{Wer seine Dokumente im Quellcode archiviert, legt in der
Regel allergrößten Wert darauf, dass bei zukünftigen \LaTeX{}-Läufen immer
- wieder exakt dasselbe Ergebnis erzielt wird. In einigen Fällen ist es aber
- so, dass Verbesserungen und Korrekturen an der Klasse zu Änderungen im
- Verhalten, inbesondere beim Umbruch, führen.}%
+ wieder exakt dasselbe Ergebnis erzielt wird. In einigen Fällen führen aber
+ Verbesserungen und Korrekturen am Paket zu unerwünschten Änderungen im
+ Verhalten und insbesondere bezüglich des Umbruchs.}%
\IfCommon{scrextend}{Wer seine Dokumente im Quellcode archiviert, legt in der
Regel allergrößten Wert darauf, dass bei zukünftigen \LaTeX{}-Läufen immer
wieder exakt dasselbe Ergebnis erzielt wird. In einigen Fällen ist es aber
@@ -167,8 +168,12 @@ dem Laden %
\IfCommon{scrlttr2}{der Klasse }%
\IfCommon{typearea}{des Pakets \Package{typearea} }%
\IfCommon{scrextend}{des Pakets \Package{scrextend} }%
-nicht mehr verändert werden kann. Das Setzen mit \Macro{KOMAoptions} oder
-\Macro{KOMAoption} ist für diese Option daher nicht vorgesehen.%
+nicht mehr verändert werden kann.
+Das Setzen mit \Macro{KOMAoptions} oder
+\Macro{KOMAoption} ist
+% Umbruchkorrektur
+\IfNotCommon{scrlttr2}{für diese Option }%
+daher nicht vorgesehen.%
%
\EndIndex{Option}{version~=\PName{Wert}}%
\EndIndex{Option}{version~=\PValue{first}}%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-11.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-11.tex
index 66e4e0d0976..7cc374f52f8 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-11.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-11.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-11.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-11.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-11.tex}[2012/01/01 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-11.tex}
+ [$Date: 2013-12-11 20:21:09 +0100 (Mi, 11. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\makeatletter
\@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}%
@@ -90,7 +92,8 @@ Definition:
% Umbruchkorrektur: listings korrigieren!
\begin{lstcode}[belowskip=\dp\strutbox]
\deffootnote[1em]{1.5em}{1em}{%
- \textsuperscript{\thefootnotemark}}
+ \textsuperscript{\thefootnotemark}%
+ }
\end{lstcode}
Dabei wird mit Hilfe von \Macro{textsuperscript} sowohl die Hochstellung als
auch die Wahl einer kleineren Schrift erreicht. Die Anweisung
@@ -231,7 +234,8 @@ Schriftart kann mit den Anweisungen \Macro{setkomafont} und
erhalten werden:
\begin{lstcode}
\deffootnote{1.5em}{1em}{%
- \makebox[1.5em][l]{\thefootnotemark}}
+ \makebox[1.5em][l]{\thefootnotemark}%
+ }
\end{lstcode}
Sollen jedoch die Fußnoten insgesamt lediglich in einer anderen Schriftart,
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-12.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-12.tex
index 492368c9c8d..26dd4e78e3e 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-12.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-12.tex
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-12.tex}[2011/09/21 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-12.tex}
+ [$Date: 2013-12-11 20:21:09 +0100 (Mi, 11. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\makeatletter
\@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}%
@@ -125,7 +127,6 @@ einzelnen Stichpunkte werden mit \Macro{item} eingeleitet.%
\item Flugzeuge
\begin{itemize}
\item Doppeldecker
- \item Jets
\item Transportmaschinen
\begin{itemize}
\item einmotorig
@@ -142,10 +143,6 @@ einzelnen Stichpunkte werden mit \Macro{item} eingeleitet.%
\item Drehflügler
\end{itemize}
\item Motorräder
- \begin{itemize}
- \item historisch korrekt
- \item futurisch nicht real
- \end{itemize}
\item Automobile
\begin{itemize}
\item Rennwagen
@@ -163,7 +160,7 @@ einzelnen Stichpunkte werden mit \Macro{item} eingeleitet.%
\item Flugzeuge
\begin{itemize}
\item Doppeldecker
- \item Jets
+% \item Jets
\item Transportmaschinen
\begin{itemize}
\item einmotorig
@@ -180,10 +177,10 @@ einzelnen Stichpunkte werden mit \Macro{item} eingeleitet.%
\item Drehflügler
\end{itemize}
\item Motorräder
- \begin{itemize}
- \item historisch korrekt
- \item futurisch nicht real
- \end{itemize}
+% \begin{itemize}
+% \item historisch korrekt
+% \item futurisch nicht real
+% \end{itemize}
\item Automobile
\begin{itemize}
\item Rennwagen
@@ -634,9 +631,14 @@ ersten Absatz einer \Environment{quotation}-Umgebung% Umbruchkorrektur
\begin{Example}
\phantomsection\label{desc:maincls.env.quote.example}%
Sie wollen eine kleine Anekdote hervorheben. Also schreiben Sie
- folgende \Environment{quotation}-Umgebung:
+ unter Verwendung der Umgebung \Environment{quotation}:
%
\begin{lstcode}
+ \documentclass[paper=a5,pagesize]{scrartcl}
+ \usepackage{selinput}
+ \SelectInputMappings{adieresis={ä},germandbls={ß}}
+ \usepackage[ngerman]{babel}
+ \begin{document}
Ein kleines Beispiel für eine Anekdote, die sich
einst in Schwaben zugetragen haben soll:
\begin{quotation}
@@ -656,8 +658,9 @@ ersten Absatz einer \Environment{quotation}-Umgebung% Umbruchkorrektur
"`Guda Moh, Sie missat sich halt zwinga!"'
\end{quotation}
+ \end{document}
\end{lstcode}
- Das Ergebnis ist dann:
+ Das Ergebnis könnte dann so aussehen:
\begin{ShowOutput}
\iftrue% Umbruchkorrekturtext
Ein kleines Beispiel für eine Anekdote, die sich einst
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-14.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-14.tex
index b70c6537975..2f9983066c7 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-14.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-14.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-14.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-14.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-14.tex}[2012/01/01 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-14.tex}
+ [$Date: 2013-12-12 16:57:36 +0100 (Do, 12 Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\makeatletter
\@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}%
@@ -100,17 +102,20 @@ ersetzt werden.
\else %------------------------------------------------------- nur maincls -
\begin{Declaration}
- \KOption{titlepage}\PName{Ein-Aus-Wert}
+ \KOption{titlepage}\PName{Ein-Aus-Wert}\\
+ \OptionValue{titlepage}{firstiscover}
\end{Declaration}%
\BeginIndex{Option}{titlepage~=\PName{Ein-Aus-Wert}}%
-Mit dieser Option\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} wird ausgewählt, ob für die mit \Macro{maketitle}
-(siehe \autopageref{desc:\csname label@base\endcsname.cmd.maketitle}) gesetzte
-Titelei eigene Seiten\Index{Titel>Seite} verwendet werden, oder stattdessen
-die Titelei von \Macro{maketitle} als Titelkopf\Index{Titel>Kopf} gesetzt
-wird. Als \PName{Ein-Aus-Wert} kann einer der Standardwerte für einfache
-Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}
-verwendet werden.
+\BeginIndex{Option}{titlepage~=\PValue{firstiscover}}%
+Mit dieser Option\IfCommon{maincls}{\ChangedAt{v3.00}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}}} wird ausgewählt, ob für die mit
+\Macro{maketitle} (siehe \autopageref{desc:\csname
+ label@base\endcsname.cmd.maketitle}) gesetzte Titelei eigene
+Seiten\Index{Titel>Seite} verwendet werden, oder stattdessen die Titelei von
+\Macro{maketitle} als Titelkopf\Index{Titel>Kopf} gesetzt wird. Als
+\PName{Ein-Aus-Wert} kann einer der Standardwerte für einfache Schalter aus
+\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet
+werden.
Mit \OptionValue{titlepage}{true}\important{\OptionValue{titlepage}{true}}
\IfNotCommon{scrextend}{oder \Option{titlepage} }wird die Titelei in Form von
@@ -127,6 +132,30 @@ heißt, die Titelei wird lediglich speziell hervorgehoben, auf der Seite mit
dem Titel kann aber nachfolgend weiteres Material, beispielsweise eine
Zusammenfassung oder ein Abschnitt gesetzt werden.
+Mit\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}} der dritten Möglichkeit,
+\OptionValue{titlepage}{firstiscover}%
+\important{\OptionValue{titlepage}{firstiscover}}, werden nicht nur
+Titelseiten aktiviert. Es wird auch dafür gesorgt, dass die erste von
+\Macro{maketitle}\IndexCmd{maketitle} ausgegebene Titelseite, also entweder
+der Schmutztitel oder der Haupttitel, als Umschlagseite\Index{Umschlag}
+ausgegeben wird. Jede andere Einstellung für Option \Option{titlepage} hebt
+diese Einstellung wieder auf. Die Ränder\important{%
+ \Macro{coverpagetopmargin}\\
+ \Macro{coverpageleftmargin}\\
+ \Macro{coverpagerightmargin}\\
+ \Macro{coverpagebottommargin}} dieser Umschlagseite werden über
+\Macro{coverpagetopmargin}\IndexCmd[indexmain]{coverpagetopmargin} (oberer
+Rand), \Macro{coverpageleftmargin}\IndexCmd[indexmain]{coverpageleftmargin}
+(linker Rand),
+\Macro{coverpagerightmargin}\IndexCmd[indexmain]{coverpagerightmargin}
+(rechter Rand) und natürlich
+\Macro{coverpagebottommargin}\IndexCmd[indexmain]{coverpagebottommargin}
+(unterer Rand) bestimmt. Die Voreinstellungen sind von den Längen
+\Length{topmargin}\IndexLength{topmargin} und
+\Length{evensidemargin}\IndexLength{evensidemargin} abhängig und können mit
+\Macro{renewcommand} geändert werden.
+
\IfCommon{maincls}{Bei den Klassen \Class{scrbook} und \Class{scrreprt} sind
Titelseiten voreingestellt. Demgegenüber verwendet \Class{scrartcl} in der
Voreinstellung einen Titelkopf.}%
@@ -135,7 +164,8 @@ Zusammenfassung oder ein Abschnitt gesetzt werden.
erkannt. Setzt eine Klasse keine entsprechende Voreinstellung, so ist der
Titelkopf voreingestellt.}%
%
-\EndIndex{Option}{titlepage~=\PName{Ein-Aus-Wert}}
+\EndIndex{Option}{titlepage~=\PValue{firstiscover}}%
+\EndIndex{Option}{titlepage~=\PName{Ein-Aus-Wert}}%
\begin{Declaration}
@@ -340,16 +370,24 @@ Der\important{\Macro{titlehead}}
\PName{Kopf}\Index[indexmain]{Titel>Seitenkopf} des Haupttitels wird mit der
Anweisung \Macro{titlehead} definiert. Er wird über die gesamte Textbreite in
normalem Blocksatz am Anfang der Seite ausgegeben. Er kann vom Anwender frei
-gestaltet werden.
+gestaltet werden. Seine\IndexFontElement[indexmain]{titlehead}
+Schrift\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}} wird über das Element
+\FontElement{titlehead}\important{\FontElement{titlehead}} mit Hilfe der
+Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} (siehe
+\autoref{sec:\csname label@base\endcsname.textmarkup},
+\autopageref{desc:\csname label@base\endcsname.cmd.setkomafont})
+gesteuert. Die Voreinstellung ist \autoref{tab:maincls.titlefonts}%
+\IfNotCommon{maincls}{, \autopageref{tab:maincls.titlefonts}} zu entnehmen.
Die\important{\Macro{subject}}
\PName{Typisierung}\Index[indexmain]{Typisierung} wird unmittelbar über dem
\PName{Titel} ausgegeben. Dabei\ChangedAt{v2.95}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}} findet die Schriftumschaltung für das
-Element
-\FontElement{subject}\IndexFontElement{subject}\important{\FontElement{subject}}
-Anwendung. Die Voreinstellung, die in \autoref{tab:maincls.titlefonts}%
-\IfNotCommon{maincls}{, \autopageref{tab:maincls.titlefonts} }%
+Element \FontElement{subject}\IndexFontElement[indexmain]{subject}%
+\important{\FontElement{subject}} Anwendung. Die Voreinstellung, die in
+\autoref{tab:maincls.titlefonts}%
+\IfNotCommon{maincls}{, \autopageref{tab:maincls.titlefonts}}%
\ zu finden ist, kann mit Hilfe der Anweisungen \Macro{setkomafont} und
\Macro{addtokomafont} (siehe \autoref{sec:\csname
label@base\endcsname.textmarkup}, \autopageref{desc:\csname
@@ -358,9 +396,9 @@ Anwendung. Die Voreinstellung, die in \autoref{tab:maincls.titlefonts}%
Der\important{\Macro{title}} \PName{Titel} wird in einer sehr großen Schrift
ausgegeben. Dabei\ChangedAt{v2.8p}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} findet abgesehen von der Größe auch die Schriftumschaltung
-für das Element
-\FontElement{title}\IndexFontElement{title}\important{\FontElement{title}}
-Anwendung. Voreingestellt ist die gleiche Schrift, die für das Element
+für das Element \FontElement{title}\IndexFontElement[indexmain]{title}%
+\important{\FontElement{title}} Anwendung. Voreingestellt ist die gleiche
+Schrift, die für das Element
\FontElement{disposition}\IndexFontElement{disposition} verwendet wird (siehe
\autoref{tab:maincls.elementsWithoutText},
\autopageref{tab:maincls.elementsWithoutText}). Die Voreinstellungen können
@@ -373,7 +411,7 @@ werden. Die Größe\textnote{Achtung!} ist jedoch davon unabhängig (siehe
Der\important{\Macro{subtitle}}
\PName{Untertitel}\ChangedAt{v2.97c}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} wird in der über das Element
-\FontElement{subtitle}\IndexFontElement{subtitle}%
+\FontElement{subtitle}\IndexFontElement[indexmain]{subtitle}%
\important{\FontElement{subtitle}} eingestellten Schrift knapp unter dem Titel
ausgegeben. Die Voreinstellung, die \autoref{tab:maincls.titlefonts}%
\IfNotCommon{maincls}{, \autopageref{tab:maincls.titlefonts}}%
@@ -398,36 +436,71 @@ ausgegeben. Die Voreinstellung, die \autoref{tab:maincls.titlefonts}%
\toprule
Element-Name & Voreinstellung \\
\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{title} & \Macro{usekomafont}\PParameter{disposition} \\
\FontElement{subtitle} &
\Macro{usekomafont}\PParameter{title}\Macro{large} \\
+ \FontElement{title} & \Macro{usekomafont}\PParameter{disposition} \\
+ \FontElement{titlehead} & \\
\bottomrule
\end{tabular}
\end{captionbeside}
\end{table}}
Unter\important{\Macro{author}} dem \PName{Untertitel} folgt der
-\PName{Autor}\Index[indexmain]{Autor}. Es kann auch durchaus mehr als ein
+\PName{Autor}\Index[indexmain]{Autor}. Es kann auch durchaus mehr als ein
Autor innerhalb des Arguments von \Macro{author} angegeben werden. Die Autoren
-sind dann mit \Macro{and} voneinander zu trennen.
+sind dann mit \Macro{and} voneinander zu
+trennen. Auch\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}} für die
+Autoren\important{\FontElement{author}} kann die Schrift über das gleichnamige
+Element \FontElement{author}\IndexFontElement[indexmain]{author}, dessen
+Voreinstellung \autoref{tab:maincls.titlefonts}%
+\IfNotCommon{maincls}{, \autopageref{tab:maincls.titlefonts}}%
+\ zu entnehmen ist, mit Hilfe der Anweisungen \Macro{setkomafont} und
+\Macro{addtokomafont} (siehe \autoref{sec:\csname
+ label@base\endcsname.textmarkup}, \autopageref{desc:\csname
+ label@base\endcsname.cmd.setkomafont}) verändert werden.
Unter\important{\Macro{date}} dem Autor oder den Autoren folgt das
Datum\Index{Datum}. Dabei ist das aktuelle Datum,
\Macro{today}\IndexCmd{today}, voreingestellt. Es kann jedoch mit \Macro{date}
-eine beliebige Angabe -- auch ein leere -- erreicht werden.
+eine beliebige Angabe -- auch ein leere -- erreicht werden. Die
+Schrift\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}}\important{\FontElement{date}} wird
+über das Element \FontElement{date}\IndexFontElement[indexmain]{date} mit
+Hilfe der Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} (siehe
+\autoref{sec:\csname label@base\endcsname.textmarkup},
+\autopageref{desc:\csname label@base\endcsname.cmd.setkomafont})
+gesteuert. Die Voreinstellung ist \autoref{tab:maincls.titlefonts}%
+\IfNotCommon{maincls}{, \autopageref{tab:maincls.titlefonts}}%
+\ zu entnehmen.
Als\important{\Macro{publishers}} Letztes folgt schließlich der
-\PName{Verlag}\Index[indexmain]{Verlag}. Selbstverständlich
-kann diese Anweisung auch für andere Angaben geringer Wichtigkeit
-verwendet werden. Notfalls kann durch Verwendung einer \Macro{parbox}
-über die gesamte Seitenbreite auch erreicht werden, dass diese Angabe
-nicht zentriert, sondern im Blocksatz gesetzt wird. Sie ist dann als
-Äquivalent zum Kopf zu betrachten. Dabei ist jedoch zu beachten,
-dass sie oberhalb von eventuell vorhandenen Fußnoten ausgegeben wird.
-
-\looseness=-1 % Umbruchoptimierung!
+\PName{Verlag}\Index[indexmain]{Verlag}. Selbstverständlich kann diese
+Anweisung auch für andere Angaben geringer Wichtigkeit verwendet
+werden. Notfalls kann durch Verwendung einer \Macro{parbox} über die gesamte
+Seitenbreite auch erreicht werden, dass diese Angabe nicht zentriert, sondern
+im Blocksatz gesetzt wird. Sie ist dann als Äquivalent zum Kopf zu
+betrachten. Dabei ist jedoch zu beachten, dass sie oberhalb von eventuell
+vorhandenen Fußnoten ausgegeben wird. Die\ChangedAt{v3.12}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}\and
+ \Package{scrextend}} Schrift\important{\FontElement{publishers}} der
+Verlagsangaben ist über das Element
+\FontElement{publishers}\IndexFontElement[indexmain]{publishers} mit Hilfe der
+Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} (siehe
+\autoref{sec:\csname label@base\endcsname.textmarkup},
+\autopageref{desc:\csname label@base\endcsname.cmd.setkomafont})
+veränderbar. Die Voreinstellung ist wiederum in
+\autoref{tab:maincls.titlefonts}%
+\IfNotCommon{maincls}{, \autopageref{tab:maincls.titlefonts}}%
+\ angegeben.
+
+%\looseness=-1 % Umbruchoptimierung!
Fußnoten\important{\Macro{thanks}}\Index{Fussnoten=Fußnoten} werden auf der
Titelseite nicht mit \Macro{footnote}, sondern mit der Anweisung
\Macro{thanks} erzeugt. Sie dienen in der Regel für Anmerkungen bei den
@@ -459,16 +532,16 @@ horizontal zentriert. Diese Angaben sind noch einmal kurz zusammengefasst in
\toprule
Element & Anweisung & Schrift & Satz \\
\midrule
- Seitenkopf & \Macro{titlehead} & \Macro{normalsize} & Block- \\
+ Seitenkopf & \Macro{titlehead} & \Macro{usekomafont}\PParameter{titlehead} & Block- \\
Typisierung & \Macro{subject} & \Macro{usekomafont}\PParameter{subject}
& zentriert \\
Titel & \Macro{title} &
- \Macro{huge}\Macro{usekomafont}\PParameter{title} & zentriert \\
+ \Macro{usekomafont}\PParameter{title}\Macro{huge} & zentriert \\
Untertitel & \Macro{subtitle} &
\Macro{usekomafont}\PParameter{subtitle} & zentriert \\
- Autoren & \Macro{author} & \Macro{Large} & zentriert \\
- Datum & \Macro{date} & \Macro{Large} & zentriert \\
- Verlag & \Macro{publishers} & \Macro{Large} & zentriert \\
+ Autoren & \Macro{author} & \Macro{usekomafont}\PParameter{author} & zentriert \\
+ Datum & \Macro{date} & \Macro{usekomafont}\PParameter{date} & zentriert \\
+ Verlag & \Macro{publishers} & \Macro{usekomafont}\PParameter{publishers} & zentriert \\
\bottomrule
\end{tabular}
\end{captionbeside}
@@ -483,7 +556,7 @@ horizontal zentriert. Diese Angaben sind noch einmal kurz zusammengefasst in
Außerdem soll der Betreuer angegeben und zu erkennen sein, dass es
sich um eine Diplomarbeit handelt. Sie könnten das wie folgt
erreichen:
-\ifCommonmaincls
+\ifCommonmaincls % Umbruchvarianten
\begin{lstcode}
\documentclass{scrbook}
\usepackage[ngerman]{babel}
@@ -531,24 +604,30 @@ horizontal zentriert. Diese Angaben sind noch einmal kurz zusammengefasst in
\begin{Explain}
Ein häufiges Missverständnis betrifft die Bedeutung der
Haupttitelseite. Irrtümlich wird oft angenommen, es handle sich dabei um den
- Buchumschlag\textnote{Umschlag} oder Buchdeckel. Daher wird häufig
- erwartet, dass die Titelseite nicht den Randvorgaben für doppelseitige
- Satzspiegel gehorcht, sondern rechts und links gleich große Ränder besitzt.
-
- Nimmt man jedoch einmal ein Buch zur Hand und klappt es auf, trifft man sehr
- schnell auf mindestens eine Titelseite\textnote{Titelseiten} unter dem
- Buchdeckel innerhalb des so genannten Buchblocks. Genau diese Titelseiten
- werden mit \Macro{maketitle} gesetzt.
+ Buchumschlag\textnote{Umschlag}\Index{Umschlag} oder Buchdeckel. Daher wird
+ häufig erwartet, dass die Titelseite nicht den Randvorgaben für
+ doppelseitige Satzspiegel gehorcht, sondern rechts und links gleich große
+ Ränder besitzt. Nimmt man jedoch einmal ein Buch zur Hand und klappt es auf,
+ trifft man sehr schnell auf mindestens eine Titelseite\textnote{Titelseiten}
+ unter dem Buchdeckel innerhalb des so genannten Buchblocks. Genau diese
+ Titelseiten werden mit \Macro{maketitle} gesetzt.
Wie beim Schmutztitel handelt es sich also auch bei der Haupttitelseite um
eine Seite innerhalb des Buchblocks, die deshalb dem Satzspiegel des
gesamten Dokuments gehorcht. Überhaupt ist ein Buchdeckel, das \emph{Cover},
- etwas, was man in einem getrennten Dokument erstellt. Schließlich hat er oft
+ etwas, das man in einem getrennten Dokument erstellt. Schließlich hat er oft
eine sehr individuelle Gestalt. Es spricht auch nichts dagegen, hierfür ein
Grafik- oder DTP-Programm zu Hilfe zu nehmen. Ein getrenntes Dokument sollte
auch deshalb verwendet werden, weil es später auf ein anderes Druckmedium,
etwa Karton, und möglicherweise mit einem anderen Drucker ausgegeben werden
soll.
+
+ Seit \KOMAScript~3.12 kann man die erste von \Macro{maketitle} ausgegebene
+ Titelseite alternativ aber auch als Umschlagseite formatieren lassen. Dabei
+ ändern sich nur die für diese Seite verwendeten Ränder (siehe Option
+ \OptionValue{titlepage}{firstiscover}%
+ \IndexOption{titlepage~=\PValue{firstiscover}} auf \autopageref{desc:\csname
+ label@base\endcsname.option.titlepage}).
\end{Explain}
%
\EndIndex{Cmd}{titlehead}%
@@ -588,17 +667,28 @@ umgekehrt. \iffree{Nimmt man diese Anleitung als Beispiel, so wurde der
\Macro{dedication}\Parameter{Widmung}
\end{Declaration}%
\BeginIndex{Cmd}{dedication}%
-{\KOMAScript} bietet eine eigene Widmungsseite. Diese
-Widmung\Index{Widmung} wird zentriert und in etwas größerer Schrift
-gesetzt. Die Rückseite ist wie bei der Seite mit dem Schmutztitel
-grundsätzlich leer. Die Widmungsseite wird zusammen mit der restlichen
-Titelei mit \Macro{maketitle} ausgegeben und muss daher vor dieser
-Anweisung definiert sein.
+{\KOMAScript} bietet eine eigene Widmungsseite. Diese Widmung\Index{Widmung}
+wird zentriert und in der Voreinstellung mit etwas größerer Schrift
+gesetzt. Die\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and
+ \Package{scrextend}}\important{\FontElement{dedication}} genaue
+Schrifteinstellung für das Element
+\FontElement{dedication}\IndexFontElement[indexmain]{dedication}, die
+\autoref{tab:maincls.titlefonts}, \autopageref{tab:maincls.titlefonts}
+zu entnehmen ist, kann über die Anweisungen \Macro{setkomafont} und
+\Macro{addtokomafont} (siehe \autoref{sec:\csname
+ label@base\endcsname.textmarkup}, \autopageref{desc:\csname
+ label@base\endcsname.cmd.setkomafont}) verändert werden.
+
+Die Rückseite ist wie bei der Seite mit dem Schmutztitel grundsätzlich
+leer. Die Widmungsseite wird zusammen mit der restlichen Titelei mit
+\Macro{maketitle} ausgegeben und muss daher vor dieser Anweisung definiert
+sein.
\begin{Example}
Nehmen wir dieses Mal an, dass Sie einen Gedichtband schreiben, den
Sie Ihrer Frau widmen wollen. Das könnte wie folgt aussehen:
-\ifCommonmaincls
+\ifCommonmaincls% Umbruchkorrekturvariante
\begin{lstcode}
\documentclass{scrbook}
\usepackage[ngerman]{babel}
@@ -610,9 +700,11 @@ Anweisung definiert sein.
\lowertitleback{%
Dieser Gedichtband wurde mit Hilfe von
{\KOMAScript} und {\LaTeX} gesetzt.}
- \uppertitleback{Selbstverlach\par
+ \uppertitleback{%
+ Selbstverlach\par
Auf"|lage: 1 Exemplar}
- \dedication{Meinem Schnuckelchen\\
+ \dedication{%
+ Meinem Schnuckelchen\\
in ewiger Liebe\\
von Deinem Hasenboppelchen.}
\maketitle
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-20.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-20.tex
new file mode 100644
index 00000000000..90f0862c5ad
--- /dev/null
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-20.tex
@@ -0,0 +1,136 @@
+% ======================================================================
+% common-20.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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-20.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ======================================================================
+%
+% Text that is common for several chapters of the KOMA-Script guide
+% Maintained by Markus Kohm
+%
+% ----------------------------------------------------------------------
+%
+% Absätze, die mehreren Kapitels in der KOMA-Script-Anleitung gemeinsam sind
+% Verwaltet von Markus Kohm
+%
+% ============================================================================
+
+\KOMAProvidesFile{common-20.tex}
+ [$Date: 2013-12-17 08:45:48 +0100 (Di, 17 Dez 2013) $
+ KOMA-Script guide (common paragraph: Head and Foot Height)]
+
+\makeatletter
+\@ifundefined{ifCommonscrlayer}{\newif\ifCommonscrlayer}{}%
+\@ifundefined{ifCommoonscrlayer-scrpage}{\expandafter\newif\csname ifCommonscrlayer-scrpage\endcsname}{}%
+\@ifundefined{ifIgnoreThis}{\newif\ifIgnoreThis}{}%
+\makeatother
+
+\section{Höhe von Kopf und Fuß}
+\label{sec:\csname label@base\endcsname.height}
+
+\begin{Explain}%
+ \IfCommon{scrlayer-scrpage}{%
+ Vermutlich, weil der Fuß bei den Standardklassen kaum besetzt ist und
+ zudem als \Macro{mbox} immer einzeilig ist, gibt es bei \LaTeX{} keine
+ definierte Höhe des Fußes. Zwar ist der Abstand von der letzten Grundlinie
+ des Textblocks zur Grundlinie des Fußes mit
+ \Length{footskip}\IndexLength[indexmain]{footskip} durchaus
+ definiert. Wenn allerdings der Fuß höher als eine Zeile wird, dann ist
+ nicht hinreichend festgelegt, wie sich diese Höhe niederschlägt bzw. ob
+ \Length{footskip} den Abstand zur obersten oder untersten Grundlinie des
+ Fußes darstellt.
+
+ Obwohl auch der Kopf bei den Seitenstilen der Standardklassen in einer
+ horizontalen Box ausgegeben wird und damit immer einzeilig ist, hat
+ \LaTeX{} für die Kopfhöhe tatsächlich selbst eine Länge zur Einstellung
+ ihrer Höhe vorgesehen. Dies erklärt sich vermutlich daraus, dass diese
+ Höhe zur Bestimmung des Anfangs des Textbereichs benötigt wird.%
+ }%
+\end{Explain}
+
+\ifshortversion\IgnoreThisfalse\IfNotCommon{scrlayer-scrpage}{\IgnoreThistrue}\fi
+\ifIgnoreThis %++++++++++++++++++++++++++++++++++++++ nicht scrlayer-scrpage +
+Für grundlegende Informationen zur Höhe von Kopf und Fuß siehe
+\autoref{sec:scrlayer-scrpage.height},
+\autopageref{sec:scrlayer-scrpage.height}.
+\else % ----------------------------------------------- nur scrlayer-scrpage -
+
+\begin{Declaration}
+ \Length{footheight}\\
+ \Length{headheight}
+\end{Declaration}
+\BeginIndex{Length}{footheight}%
+\BeginIndex{Length}{headheight}%
+Das Paket \Package{scrlayer} führt als neue Länge \Length{footheight} analog
+zur Höhe \Length{headheight} ein. Gleichzeitig interpretiert
+\Package{scrlayer-scrpage} \Length{footskip} so, dass es den Abstand der
+letzten Grundlinie des Textbereichs von der ersten Standard-Grundlinie des
+Fußes darstellt. Das Paket \Package{typearea}\IndexPackage{typearea}
+betrachtet dies in gleicher Weise, so dass die dortigen Optionen zum Setzen
+der Höhe des Fußes (siehe die Optionen \Option{footheight} und
+\Option{footlines} in \autoref{sec:typearea.typearea},
+\autopageref{desc:typearea.option.footheight}) und zur Berücksichtigung des
+Fußes bei der Berechnung des Satzspiegels (siehe Option \Option{footinclude}
+in demselben Abschnitt, \autopageref{desc:typearea.option.footinclude}) sehr
+gut zum Setzen der Werte für \Package{scrlayer} verwendet werden können und
+auch das gewünschte Ergebnis liefern.
+
+Wird das Paket \Package{typearea} nicht verwendet, so sollte man
+gegebenenfalls die Höhe von Kopf und Fuß über entsprechende Werte für die
+Längen einstellen. Zumindest für den Kopf bietet aber beispielsweise auch das
+Paket \Package{geometry} entsprechende Einstellmöglichkeiten. Wurde der Kopf
+oder der Fuß für den tatsächlich verwendeten Inhalt zu klein gewählt, so
+versucht \Package{scrlayer-scrpage} die Längen selbst entsprechend
+anzupassen. Gleichzeitig wird eine entsprechende Warnung ausgegeben, die auch
+Ratschläge für passende Einstellungen enthält. Die automatischen Änderungen
+haben dann ab dem Zeitpunkt, an dem ihre Notwendigkeit erkannt wurde,
+Gültigkeit und werden nicht automatisch aufgehoben, wenn beispielsweise der
+Inhalt von Kopf oder Fuß wieder kleiner wird.%
+\EndIndex{Length}{headheight}%
+\EndIndex{Length}{footheight}%
+
+\fi % ********************************************* Ende nur scrlayer-scrpage *
+
+%%% Local Variables:
+%%% mode: latex
+%%% mode: flyspell
+%%% coding: iso-latin-1
+%%% ispell-local-dictionary: "de_DE"
+%%% TeX-master: "scrlayer-de.tex"
+%%% TeX-PDF-mode: t
+%%% End:
+
+% LocalWords: Seitenstilen Ebenenmodell scrpage headings myheadings plain
+% LocalWords: empty scrlayer Seitenstil Rückgriffe Gliederungsnummern
+% LocalWords: Standardklassen Seitenstile konsistenteren Befehlssatzes
+% LocalWords: Einstellmöglichkeiten Seiteninhalts Gliederungsüberschrift
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-21.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-21.tex
new file mode 100644
index 00000000000..649d22299f6
--- /dev/null
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-21.tex
@@ -0,0 +1,873 @@
+% ======================================================================
+% common-21.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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-21.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ======================================================================
+%
+% Text that is common for several chapters of the KOMA-Script guide
+% Maintained by Markus Kohm
+%
+% ----------------------------------------------------------------------
+%
+% Absätze, die mehreren Kapitels in der KOMA-Script-Anleitung gemeinsam sind
+% Verwaltet von Markus Kohm
+%
+% ============================================================================
+
+\KOMAProvidesFile{common-21.tex}
+ [$Date: 2013-12-18 07:42:31 +0100 (Mi, 18. Dez 2013) $
+ KOMA-Script guide (common paragraph:
+ Setting up defined page styles)]
+
+\makeatletter
+\@ifundefined{ifCommonscrlayer}{\newif\ifCommonscrlayer}{}%
+\@ifundefined{ifCommonscrlayerscrpage}{\newif\ifCommonscrlayerscrpage}{}%
+\@ifundefined{ifCommonscrlayerscrpageexperts}{\newif\ifCommonscrlayerscrpageexperts}{}
+\@ifundefined{ifIgnoreThis}{\newif\ifIgnoreThis}{}%
+\makeatother
+
+\section{Beeinflussung von definierten Seitenstilen}
+\label{sec:\csname label@base\endcsname.pagestyle.content}
+
+\IfCommon{scrlayer}{%
+ Obwohl \Package{scrlayer} selbst keine konkreten Seitenstile mit Inhalt
+ definiert -- die erwähnten Seitenstile \Pagestyle{@everystyle@} und
+ \Pagestyle{empty} werden ja zunächst ohne Ebenen, also leer definiert --,
+ stellt es einige Optionen und Befehle zur Beeinflussung von Inhalten zur
+ Verfügung.%
+}
+
+\IfCommon{scrlayer-scrpage}{%
+ In \autoref{sec:scrlayer-scrpage.predefined.pagestyles} wurde erklärt, wie
+ die Seitenstile \Pagestyle{scrheadings} und \Pagestyle{plain.scrheadings}
+ grundlegend vordefiniert sind und wie diese Vorbelegung grundsätzlich
+ geändert werden kann. Es fehlen jedoch noch Informationen, wie
+ beispielsweise die Kolumnentitel zustande kommen, wie man die Breite des
+ Kopfes und Fußes verändern kann und wie man Linien über oder unter Kopf oder
+ Fuß setzen kann. Obwohl dies eigentlich Fähigkeiten des Pakets
+ \Package{scrlayer} sind, werden sie nachfolgend erläutert, da diese
+ grundlegenden Eigenschaften von \Package{scrlayer} einen wichtigen Teil der
+ Möglichkeiten von \Package{scrlayer-scrpage} ausmachen.%
+}
+
+\IfCommon{scrlayer-scrpage-experts}{%
+ Dieser Abschnitt ist als Ergänzung zu
+ \autoref{sec:scrlayer.pagestyle.content} zu verstehen und beschreibt Dinge,
+ die sich dem Anfänger nicht unbedingt sofort erschließen.%
+}
+
+\ifCommonscrlayerscrpageexperts\else % ------- nicht scrlayer-scrpage-experts -
+\ifshortversion\IgnoreThistrue\IfCommon{scrlayer-scrpage}{\IgnoreThisfalse}\fi
+\ifIgnoreThis %++++++++++++++++++++++++++++++++++++++ nicht scrlayer-scrpage +
+\else %------------------------------------------------ nur scrlayer-scrpage -
+
+\begin{Declaration}
+ \Macro{automark}\OParameter{Gliederungsebene der rechten Marke}\\
+ \phantom{\XMacro{automark}}\Parameter{Gliederungsebene der linken Marke}\\
+ \Macro{automark*}\OParameter{Gliederungsebene der rechten Marke}\\
+ \phantom{\XMacro{automark*}}\Parameter{Gliederungsebene der linken Marke}\\
+ \Macro{manualmark}\\
+ \Option{automark}\\
+ \KOption{autooneside}\PName{Ein-Aus-Wert}\\
+ \Option{manualmark}
+\end{Declaration}
+\BeginIndex{Cmd}{automark}%
+\BeginIndex{Cmd}{manualmark}%
+\BeginIndex{Option}{automark}%
+\BeginIndex{Option}{manualmark}%
+\BeginIndex{Option}{autooneside~=\PName{Ein-Aus-Wert}}%
+\begin{Explain}
+ Bei den Standardklassen und auch bei den \KOMAScript-Klassen fällt die
+ Entscheidung, ob mit lebenden oder statischen
+ Kolumnentiteln\Index{Kolumnentitel>lebend}\Index{Kolumnentitel>statisch}
+ gearbeitet werden soll über die Wahl des entsprechenden Seitenstils. Wie
+ bereits in \autoref{sec:maincls.pagestyle} erklärt, erhält man bei Wahl von
+ \Pagestyle{headings}\IndexPagestyle{headings}\important{\Pagestyle{headings}}
+ lebende Kolumnentitel. Unter lebenden Kolumnentiteln versteht man die
+ Wiederholung eines für die Seite oder die \emph{Kolumne} markanten Textes
+ meist im Kopf, seltener im Fuß der Seite.
+
+ Bei den Artikel-Klassen\OnlyAt{\Class{article}\and \Class{scrartcl}}
+ \Class{article} oder \Class{scrartcl} wird für den lebenden
+ Kolumnentitel\textnote{lebende Kolumnentitel} im einseitigen Modus die
+ Abschnittsüberschrift, also das obligatorische oder das optionale Argument
+ von \Macro{section} verwendet. Diese wird als \emph{rechte Marke}
+ behandelt. Im doppelseitigen Satz wird dieselbe Überschrift als \emph{linke
+ Marke} verwendet und gleichzeitig die Unterabschnittsüberschrift als
+ \emph{rechte Marke}. Ausgegeben wird die linke Marke wie der Name schon sagt
+ auf der linken Seite, während die rechte Marke auf rechten Seiten -- im
+ einseitigen Modus also auf allen Seiten -- ausgegeben wird. Beim Setzen der
+ linken Marke für den Abschnitt werden von den Klassen in der Voreinstellung
+ außerdem auch immer die rechten Marken gelöscht.
+
+ Bei den Bericht- und Buch-Klassen\OnlyAt{\Class{report}\and
+ \Class{scrreprt}\and \Class{book}\and \Class{scrbook}} wird eine Ebene
+ höher begonnen. Im einseitigen Modus wird also die Kapitelüberschrift als
+ rechte Marke gesetzt. Im doppelseitigen Satz wird die Kapitelüberschrift als
+ linke Marke und die Abschnittsüberschrift als rechte Marke gesetzt.
+
+ Verwendet man hingegen als Seitenstil
+ \Pagestyle{myheadings}\IndexPagestyle{myheadings}%
+ \important{\Pagestyle{myheadings}}\textnote{manuelle Kolumnentitel}, so
+ existieren zwar die Marken im Kopf genauso und auch die Seitenzahlen werden
+ gleich platziert, allerdings werden die Marken nicht automatisch durch die
+ Überschriften gesetzt. Man kann sie dann nur
+ manuell\important{\Macro{markright}\\\Macro{markboth}} über die später in
+ diesem Abschnitt dokumentierten Anweisungen \Macro{markright} und
+ \Macro{markboth} befüllen.
+\end{Explain}
+
+Genau diese Unterscheidung wurde bei \Package{scrpage2} und nun auch bei
+\Package{scrlayer} aufgehoben. Statt die Unterscheidung zwischen
+automatischen\textnote{lebende und manuelle Kolumnentitel} und manuellen
+Kolumnentiteln über den Seitenstil vorzunehmen, gibt es die beiden Anweisungen
+\Macro{automark} und \Macro{manualmark}.
+
+Mit \Macro{manualmark}\important{\Macro{manualmark}} wird dabei auf manuelle
+Marken umgeschaltet. Es deaktiviert also das automatische Setzen der
+Marken. Demgegenüber kann mit \Macro{automark}\important{\Macro{automark}} und
+\Macro{automark*} festgelegt werden, welche Gliederungsebenen für das
+automatische Setzen der Marke verwendet werden sollen. Das optionale Argument
+gibt dabei die \PName{Gliederungsebene der rechten Marke} an, während das
+obligatorische Argument die \PName{Gliederungsebene der linken Marke} ist. Als
+Argument werden jeweils die Namen der Gliederungsebenen angegeben, also
+\PValue{part}, \PValue{chapter}, \PValue{section}, \PValue{subsection},
+\PValue{subsubsection}, \PValue{paragraph} oder \PValue{subparagraph}.
+
+Normalerweise sollte die höhere Ebene die linke Marke setzen, während die
+tiefere Ebene für die rechte Marke zu verwenden ist. Diese übliche Konvention
+ist jedoch keine Pflicht, sondern lediglich sinnvoll.
+
+Der Unterschied zwischen \Macro{automark} und
+\Macro{automark*}\important{\Macro{automark*}} liegt darin, dass
+\Macro{automark} alle vorherigen Befehle zum automatischen Setzen der Marken
+aufhebt, während die Stern-Version \Macro{automark*} lediglich die Aktionen
+für die angegebenen Gliederungsebenen ändert. Man kann so auch relativ
+komplexe Fälle abdecken.%
+\iffree{}{\par
+ Das veraltete Paket
+ \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}
+ kennt sowohl \Macro{manualmark} als auch \Macro{automark}, jedoch nicht
+ \Macro{automark*}. Daher sind die nachfolgenden Beispielen nicht vollständig
+ auf die Verwendung von \Package{scrpage2} übertragbar.}%
+%
+\begin{Example}
+ Angenommen Sie wollen, dass wie üblich auf den linken Seiten eines
+ Buches die Kapitelüberschriften als automatische Kolumnentitel verwendet
+ werden und auf den rechten Seiten die Abschnittsüberschriften. Allerdings
+ soll auf rechte Seiten so lange ebenfalls die Kapitelüberschrift verwendet
+ werden, bis der erste Abschnitt auftaucht. Dazu wird
+ zuerst \Package{scrlayer-scrpage} geladen und der Seitenstil
+ \Pagestyle{scrheadings} aktiviert. Das Dokument beginnt also mit:
+\begin{lstcode}
+ \documentclass{scrbook}
+ \usepackage{scrlayer-scrpage}
+ \pagestyle{scrheadings}
+\end{lstcode}
+ Als nächstes wird dafür gesorgt, dass die Kapitelüberschriften sowohl die
+ linke als auch die rechte Marke setzen:
+\begin{lstcode}
+ \automark[chapter]{chapter}
+\end{lstcode}
+ Dann sollen die Abschnittsüberschriften zusätzlich die rechten Marken
+ setzen:
+\begin{lstcode}
+ \automark*[section]{}
+\end{lstcode}
+ Hier findet die Stern-Version Anwendung, da die vorherige
+ \Macro{automark}-Anweisung weiterhin wirksam bleiben soll. Außerdem bleibt
+ das Argument für die \PName{Gliederungsebene der linken Marke} leer, weil
+ diese Marke unverändert bleiben soll.
+
+ Alles, was jetzt noch fehlt, ist ein wenig Dokumentinhalt:
+\begin{lstcode}
+ \usepackage{lipsum}
+ \begin{document}
+ \chapter{Kapitel}
+ \lipsum[1-20]
+ \section{Abschnitt}
+ \lipsum[21-40]
+ \end{document}
+\end{lstcode}
+ Dabei ist das Paket \Package{lipsum}\IndexPackage{lipsum} mit seiner
+ Anweisung \Macro{lipsum}\IndexCmd{lipsum} sehr nützlich.
+
+ Wenn Sie dieses Beispiel einmal testen, werden Sie sehen, dass die
+ Kapitelanfangsseite wie üblich ohne Kolumnentitel ist, da sie automatisch im
+ \Pagestyle{plain}-Seitenstil \Pagestyle{plain.scrheadings} gesetzt
+ wird. Seite~2 bis 4 tragen als Kolumnentitel die Kapitelüberschrift. Nachdem
+ auf Seite~4 eine Abschnittsüberschrift ausgegeben wurde, ändert sich der
+ Kolumnentitel auf Seite~5 in die Abschnittsüberschrift. Ab dann werden die
+ beiden Überschriften im Kopf wechselweise ausgegeben, auf linken Seiten die
+ Kapitelüberschrift, auf rechten Seiten die Abschnittsüberschrift.
+\end{Example}
+
+Außer mit den Befehlen kann auch direkt mit den beiden Optionen
+\Option{manualmark}\important{\Option{manualmark}\\\Option{automark}} und
+\Option{automark} zwischen automatischen und manuellen Kolumnentiteln hin- und
+hergeschaltet werden. Dabei verwendet \Option{automark} bei Klassen mit
+\Macro{chapter}-Anweisung immer die Voreinstellung
+\begin{lstcode}[belowskip=\dp\strutbox]
+ \automark[section]{chapter}
+\end{lstcode}
+und bei anderen Klassen
+\begin{lstcode}[belowskip=\dp\strutbox]
+ \automark[subsection]{section}
+\end{lstcode}
+
+Im einseitigen Modus\textnote{einseitiger Satz} will man in der Regel nicht,
+dass die untergeordnete Ebene die rechte Marke beeinflusst. Stattdessen soll
+auch mit der Voreinstellung nur die höhere Ebene, die beispielsweise im
+doppelseitigen Modus in der Voreinstellung alleine die linke Marke
+beeinflusst, den Kolumnentitel aller Seiten vorgeben. Diese Voreinstellung
+entspricht einer aktiven Option
+\Option{autooneside}\important{\Option{autooneside}}. Die Option versteht die
+Werte für einfache Schalter, die in \autoref{tab:truefalseswitch} auf
+\autopageref{tab:truefalseswitch} angegeben sind. Wird die Option deaktiviert,
+so wirken sich im einseitigen Satz sowohl das optionale als auch das
+obligatorische Argument auf den Kolumnentitel aus.%
+%
+\begin{Example}
+ Angenommen, Sie wollen im einseitigen Modus eines Berichts eine ganz
+ ähnliche Verwendung des Kolumnentitels erreichen, wie im vorherigen
+ Beispiel. Konkret soll so lange die Kapitelüberschrift verwendet werden, bis
+ ein Abschnitt gesetzt wird. Ab dann soll nur noch die Abschnittsüberschrift
+ verwendet werden. Dazu wird das Beispiel wie folgt abgewandelt:
+\begin{lstcode}
+ \documentclass{scrreprt}
+ \usepackage[autooneside=false]{scrlayer-scrpage}
+ \pagestyle{scrheadings}
+ \automark[section]{chapter}
+ \usepackage{lipsum}
+ \begin{document}
+ \chapter{Kapitel}
+ \lipsum[1-20]
+ \section{Abschnitt}
+ \lipsum[21-40]
+ \end{document}
+\end{lstcode}
+ Wie zu sehen ist, wird in diesem Fall keine ergänzende
+ \Macro{automark*}-Anweisung benötigt. Sie sollten zum Vergleich die Option
+ \Option{autooneside} auch einmal auf \PValue{true} setzen oder sie
+ entfernen. Ein Unterschied ist dann ab Seite~4 im Kolumnentitel im Kopf der
+ Seiten zu sehen.
+\end{Example}
+
+Das\textnote{Achtung!} Laden des Pakets selbst hat übrigens noch keine
+Auswirkung darauf, ob mit automatischen Kolumnentiteln gearbeitet wird oder
+nicht. Erst die explizite Verwendung einer der Optionen \Option{automark} oder
+\Option{manualmark} oder einer der beiden Anweisungen \Macro{automark} oder
+\Macro{manualmark} schafft hier klare Verhältnisse.%
+\EndIndex{Option}{autooneside~=\PName{Ein-Aus-Wert}}%
+\EndIndex{Option}{manualmark}%
+\EndIndex{Option}{automark}%
+\EndIndex{Cmd}{manualmark}%
+\EndIndex{Cmd}{automark}%
+\fi % ******************************************** Ende nur scrlayer-scrpage *
+
+\ifshortversion\IgnoreThistrue\IfCommon{scrlayer}{\IgnoreThisfalse}\fi
+\ifIgnoreThis %++++++++++++++++++++++++++++++++++++++++++++++ nicht scrlayer +
+\else %-------------------------------------------------------- nur scrlayer -
+\begin{Declaration}
+ \KOption{draft}\PName{Ein-Aus-Wert}
+\end{Declaration}
+\BeginIndex{Option}{draft~=\PName{Ein-Aus-Wert}}%
+Die \KOMAScript-Option versteht die Standardwerte für einfache Schalter, die
+in \autoref{tab:truefalseswitch} auf \autopageref{tab:truefalseswitch}
+angegeben sind. Ist die Option aktiviert, so werden alle Elemente der
+Seitenstile zusätzlich mit Maßlinien versehen. Dies kann während der
+Entwurfsphase manchmal nützlich sein. Falls diese Option global gesetzt wurde,
+die Maßlinien aber nicht gewünscht sind, kann die Option auch nur für das
+Paket deaktiviert werden, indem man \OptionValue{draft}{false} als optionales
+Argument von \Macro{usepackage} beim Laden des Pakets angibt.%
+\EndIndex{Option}{draft~=\PName{Ein-Aus-Wert}}%
+
+\begin{Declaration}
+ \Macro{MakeMarkcase}\Parameter{Text}
+\end{Declaration}
+\BeginIndex{Cmd}{MakeMarkcase}%
+Die automatischen, nicht jedoch die manuellen Kolumnentitel verwenden
+\Macro{MakeMarkcase} für ihre Ausgabe. Ist die Anweisung beim Laden von
+\Package{scrlayer} nicht definiert, so wird sie in der Voreinstellung derart
+definiert, dass sie ihr Argument \PName{Text} unverändert ausgibt. Diese
+Voreinstellung kann jedoch entweder durch Umdefinierung von
+\Macro{MakeMarkcase} oder durch die %
+\ifshortversion in \autoref{sec:scrlayer-scrpage.pagestyle.content} %
+\else später in diesem Abschnitt %
+\fi%
+dokumentierte Option
+\Option{markcase}\IndexOption{markcase}\important{\Option{markcase}} geändert
+werden. Je nach Einstellung wird das Argument dann beispielsweise in Groß-
+oder Kleinbuchstaben umgewandelt.
+%
+\EndIndex{Cmd}{MakeMarkcase}%
+\fi %***************************************************** Ende nur scrlayer *
+
+\ifshortversion\IgnoreThistrue\IfCommon{scrlayer-scrpage}{\IgnoreThisfalse}\fi
+\ifIgnoreThis %++++++++++++++++++++++++++++++++++++++ nicht scrlayer-scrpage +
+\else %------------------------------------------------ nur scrlayer-scrpage -
+\begin{Declaration}
+ \KOption{markcase}\PName{Wert}
+\end{Declaration}
+\BeginIndex{Option}{markcase~=\PName{Wert}}%
+Wie bereits früher erläutert kann man bei \Package{scrlayer} zwischen
+manuellen und automatischen Kolumnentiteln wählen. Bei den automatischen
+Kolumnentiteln werden dabei die entsprechenden Marken über die
+Gliederungsbefehle gesetzt. In manchen Kulturkreisen ist es im Gegensatz zur
+Typografie des deutschsprachigen Raums üblich, die Kolumnentitel in
+Großbuchstaben zu setzen. Die Standardklassen machen genau dies in der
+Voreinstellung. Das Paket \Package{scrlayer} unterstützt das optional
+ebenfalls. Hierzu gibt man als Option
+\OptionValue{markcase}{upper}\important{\OptionValue{markcase}{upper}}%
+\IndexOption[indexmain]{markcase~=upper} an. Im Endeffekt führt das zu einer
+Umdefinierung von \Macro{MakeMarkcase}\IndexCmd[indexmain]{MakeMarkcase},
+einer Anweisung, die von \Package{scrlayer} beim Setzen von automatischen
+Kolumnentiteln verwendet wird.
+
+Leider führt die von \LaTeX{} für derartigen
+Versalsatz\Index{Versalsatz} vorgesehene Anweisung
+\Macro{MakeUppercase}\IndexCmd{MakeUppercase} zu einem sehr unzureichenden
+Satz, da weder gesperrt noch ausgeglichen wird. Dies liegt teilweise sicher
+daran, dass für typografisch korrekten Versalsatz eine Glyphenanalyse
+notwendig ist, um die konkrete Form der Buchstaben und ihrer Kombinationen in
+den Ausgleich der Sperrung einfließen zu lassen. Der \KOMAScript-Autor
+empfiehlt daher, auf Versalsatz für die Kolumnentitel zu verzichten. Dies ist
+normalerweise mit
+\OptionValue{markcase}{used}\important{\OptionValue{markcase}{used}}%
+\IndexOption[indexmain]{markcase~=used} möglich. Allerdings fügen einige
+Klassen selbst beispielsweise bei den Kolumnentitel für Verzeichnisse ein
+\Macro{MakeUppercase} oder sogar die \TeX-Anweisung \Macro{uppercase} ein. Für
+diese Fälle gibt es auch noch die Einstellung
+\OptionValue{markcase}{noupper}\important{\OptionValue{markcase}{noupper}}%
+\IndexOption[indexmain]{markcase~=noupper}, mit deren Hilfe
+\Macro{MakeUppercase} und \Macro{uppercase} für die Kolumnentitel lokal
+deaktiviert werden können.
+
+Alle für \Option{markcase} möglichen Werte sind noch einmal in
+\autoref{tab:\csname label@base\endcsname.markcase} zusammengefasst.
+%
+\begin{table}
+ \centering
+ \caption[Mögliche Werte für Option \Option{markcase}]{Mögliche Werte für
+ Option \Option{markcase} zur Wahl von Groß-/Kleinschreibung in
+ automatischen Kolumnentiteln}%
+ \label{tab:\csname label@base\endcsname.markcase}%
+ \begin{desctabular}
+ \pventry{lower}{\IndexOption{markcase~=\PValue{lower}}%
+ definiert \Macro{MakeMarkcase} so um, dass automatische Kolumnentitel
+ mit Hilfe von \Macro{MakeLowercase} in Kleinbuchstaben gewandelt werden
+ (Minuskelsatz).%
+ }%
+ \pventry{upper}{\IndexOption{markcase~=\PValue{upper}}%
+ definiert \Macro{MakeMarkcase} so um, dass automatische Kolumnentitel
+ mit Hilfe von \Macro{MakeUppercase} in Großbuchstaben gewandelt werden
+ (Versalsatz).%
+ }%
+ \pventry{used}{\IndexOption{markcase~=\PValue{used}}%
+ definiert \Macro{MakeMarkcase} so um, dass für automatische
+ Kolumnentitel keine automatische Veränderung der Groß-/Kleinschreibung
+ durchgeführt wird.%
+ }%
+ \entry{\PValue{ignoreuppercase}, \PValue{nouppercase},
+ \PValue{ignoreupper},
+ \PValue{noupper}}{\IndexOption{markcase~=\PValue{noupper}}%
+ definiert nicht nur \Macro{MakeMarkcase} so um, dass für automatische
+ Kolumnentitel keine automatische Veränderung der Groß-/Kleinschreibung
+ durchgeführt wird, sondern deaktiviert zusätzlich lokal für alle Ebenen
+ aller Seitenstile \Macro{MakeUppercase} und \Macro{uppercase}.%
+ }%
+ \end{desctabular}
+\end{table}
+%
+\EndIndex{Option}{markcase~=\PName{Wert}}%
+
+\begin{Declaration}
+ \Macro{leftmark}\\
+ \Macro{rightmark}\\
+ \Macro{headmark}\\
+ \Macro{pagemark}
+\end{Declaration}
+\BeginIndex{Cmd}{leftmark}%
+\BeginIndex{Cmd}{rightmark}%
+\BeginIndex{Cmd}{headmark}%
+\BeginIndex{Cmd}{pagemark}%
+Will man von den vordefinierten Seitenstilen abweichen, so muss man in der
+Regel auch selbst entscheiden können, wo die Marken gesetzt werden sollen. Mit
+\Macro{leftmark}\important{\Macro{leftmark}} platziert man die linke
+Marke. Diese wird dann bei der Ausgabe der Seite durch den entsprechenden
+Inhalt ersetzt.
+
+Dementsprechend kann man mit \Macro{rightmark}\important{\Macro{rightmark}}
+die rechte Marke platzieren, die dann bei der Ausgabe der Seite durch den
+entsprechenden Inhalt ersetzt wird. Für einige Feinheiten dabei, sei auch auf
+die weiterführenden Erklärungen zu \Macro{rightmark} in
+\autoref{sec:maincls-experts.addInfos},
+\autopageref{desc:maincls-experts.cmd.rightmark} verwiesen.
+
+Mit \Macro{headmark}\important{\Macro{headmark}} kann man sich das Leben
+erleichtern. Diese Erweiterung von \Package{scrlayer} entspricht je nachdem,
+ob die aktuelle Seite eine linke oder rechte ist, \Macro{leftmark} oder
+\Macro{rightmark}.
+
+Die Anweisung \Macro{pagemark}\important{\Macro{pagemark}} hat genau genommen
+nichts mit den Marken von \TeX{} zu tun. Sie dient dazu eine formatierte
+Seitenzahl zu platzieren.
+\BeginIndex{FontElement}{pagenumber}%
+Bei ihrer Ausgabe wird dann auch die Schrifteinstellung für das Element
+\FontElement{pagenumber}\important{\FontElement{pagenumber}} verwendet. Diese
+kann mit Hilfe der Anweisungen \Macro{setkomafont} und \Macro{addtokomafont}
+verändert werden (siehe auch \autoref{sec:maincls.textmarkup},
+\autopageref{desc:maincls.cmd.setkomafont}).%
+\EndIndex{FontElement}{pagenumber}%
+%
+\begin{Example}
+ Angenommen, Sie wollen, dass auch im einseitigen Modus der Kolumnentitel
+ immer am linken Rand und die Seitenzahl immer am rechten Rand ausgerichtet
+ wird. Beide sollen im Kopf platziert werden. Das folgende, vollständige
+ Minimalbeispiel liefert genau dies:
+\begin{lstcode}
+ \documentclass{scrreprt}
+ \usepackage{blindtext}
+ \usepackage[automark]{scrlayer-scrpage}
+ \pagestyle{scrheadings}
+ \ihead{\headmark}
+ \ohead[\pagemark]{\pagemark}
+ \chead{}
+ \cfoot[]{}
+ \begin{document}
+ \blinddocument
+ \end{document}
+\end{lstcode}
+ Das Paket \Package{blindtext}\IndexPackage{blindtext} mit seiner Anweisung
+ \Macro{blinddocument}\IndexCmd{blinddocument} wird hier für die komfortable
+ Erzeugung eines Beispieldokumentinhalts verwendet.
+
+ Mit den Anweisungen \Macro{ihead}\IndexCmd{ihead} und
+ \Macro{ohead}\IndexCmd{ohead} werden die gewünschten Marken platziert. Dabei
+ wird die Seitenzahl-Marke mit Hilfe des optionalen Argument von
+ \Macro{ohead} nicht nur auf den mit
+ \Pagestyle{scrheadings}\IndexPagestyle{scrheadings} gesetzten Seiten,
+ sondern auch für den auf der ersten Seite automatisch verwendeten
+ \Pagestyle{plain}-Seitenstil
+ \Pagestyle{plain.scrheadings}\IndexPagestyle{plain.scrheadings}
+ konfiguriert.
+
+ Da die beiden Seitenstile bereits mit Marken in der Mitte von Kopf und Fuß
+ vordefiniert sind, werden diese beiden Elemente mit \Macro{chead} und
+ \Macro{cfoot} gelöscht. Hierzu werden leere Argumente verwendet. Alternativ
+ dazu hätte man auch
+ \Macro{clearpairofpagestyles}\IndexCmd{clearpairofpagestyles} \emph{vor}
+ \Macro{ihead} verwenden können. Diese Anweisung wird jedoch erst in
+ \autoref{sec:scrlayer-scrpage-experts.pagestyle.pairs} auf
+ \autopageref{desc:scrlayer-scrpage-experts.cmd.clearpairofpagestyles} erklärt
+ werden.
+\end{Example}
+
+Bitte beachten Sie, dass das leere optionale Argument bei \Macro{cfoot} im
+Beispiel nicht gleichbedeutend mit dem Weglassen dieses optionalen Arguments
+ist. Sie sollten das einmal selbst ausprobieren und dabei den Fuß der ersten
+Seite beobachten.%
+\EndIndex{Cmd}{pagemark}%
+\EndIndex{Cmd}{headmark}%
+\EndIndex{Cmd}{rightmark}%
+\EndIndex{Cmd}{leftmark}%
+
+\begin{Declaration}
+ \Macro{partmarkformat}\\
+ \Macro{chaptermarkformat}\\
+ \Macro{sectionmarkformat}\\
+ \Macro{subsectionmarkformat}\\
+ \Macro{subsubsectionmarkformat}\\
+ \Macro{paragraphmarkformat}\\
+ \Macro{subparagraphmarkformat}
+\end{Declaration}
+\BeginIndex{Cmd}{partmarkformat}%
+\BeginIndex{Cmd}{chaptermarkformat}%
+\BeginIndex{Cmd}{sectionmarkformat}%
+\BeginIndex{Cmd}{subsectionmarkformat}%
+\BeginIndex{Cmd}{subsubsectionmarkformat}%
+\BeginIndex{Cmd}{paragraphmarkformat}%
+\BeginIndex{Cmd}{subparagraphmarkformat}%
+Diese Anweisungen werden von den \KOMAScript-Klassen und auch von
+\Package{scrlayer} intern üblicherweise verwendet, um die Gliederungsnummern
+der automatischen Kolumnentitel zu formatieren. Dabei wird auch der
+\Macro{autodot}-Mechanismus der \KOMAScript-Klassen unterstützt. Bei Bedarf
+können diese Anweisungen umdefiniert werden, um eine andere Formatierung der
+Nummern zu erreichen.
+%
+\begin{Example}
+ Angenommen, Sie wollen, dass Abschnittsüberschriften im Kolumnentitel ohne
+ Gliederungsnummer gesetzt werden, so ist das ganz einfach mit:
+\begin{lstcode}
+ \renewcommand*{\sectionmarkformat}{}
+\end{lstcode}
+ zu erreichen.
+\end{Example}%
+%
+\EndIndex{Cmd}{subparagraphmarkformat}%
+\EndIndex{Cmd}{paragraphmarkformat}%
+\EndIndex{Cmd}{subsubsectionmarkformat}%
+\EndIndex{Cmd}{subsectionmarkformat}%
+\EndIndex{Cmd}{sectionmarkformat}%
+\EndIndex{Cmd}{chaptermarkformat}%
+\EndIndex{Cmd}{partmarkformat}%
+
+\begin{Declaration}
+ \Macro{partmark}\Parameter{Text}\\
+ \Macro{chaptermark}\Parameter{Text}\\
+ \Macro{sectionmark}\Parameter{Text}\\
+ \Macro{subsectionmark}\Parameter{Text}\\
+ \Macro{subsubsectionmark}\Parameter{Text}\\
+ \Macro{paragraphmark}\Parameter{Text}\\
+ \Macro{subparagraphmark}\Parameter{Text}
+\end{Declaration}
+\BeginIndex{Cmd}{partmark}%
+\BeginIndex{Cmd}{chaptermark}%
+\BeginIndex{Cmd}{sectionmark}%
+\BeginIndex{Cmd}{subsectionmark}%
+\BeginIndex{Cmd}{subsubsectionmark}%
+\BeginIndex{Cmd}{paragraphmark}%
+\BeginIndex{Cmd}{subparagraphmark}%
+Diese Anweisungen werden intern von den meisten Klassen verwendet, um die
+Marken entsprechend der Gliederungsbefehle zu setzen. Dabei wird als Argument
+lediglich der Text, nicht jedoch die Nummer erwartet. Die Nummer wird
+stattdessen automatisch über den aktuellen Zählerstand ermittelt, falls mit
+nummerierten Überschriften gearbeitet wird.
+
+Falls diese Anweisungen vom Anwender umdefiniert werden, sollte
+er\textnote{Achtung!} unbedingt darauf achten, vor dem Setzen der Nummer
+ebenfalls über \Counter{secnumdepth} zu prüfen, ob die Nummern auszugeben
+sind. Dies gilt auch, wenn der Anwender \Counter{secnumdepth} selbst nicht
+verändert, weil Pakete und Klassen sich eventuell auf die Wirkung von
+\Counter{secnumdepth} verlassen!
+
+Das Paket \Package{scrlayer} definiert diese Anweisungen außerdem bei jedem
+Aufruf von \Macro{automark} oder \Macro{manualmark} oder den entsprechenden
+Optionen teilweise neu, um so die gewünschten automatischen oder manuellen
+Kolumnentitel zu erreichen.%
+\EndIndex{Cmd}{subparagraphmark}%
+\EndIndex{Cmd}{paragraphmark}%
+\EndIndex{Cmd}{subsubsectionmark}%
+\EndIndex{Cmd}{subsectionmark}%
+\EndIndex{Cmd}{sectionmark}%
+\EndIndex{Cmd}{chaptermark}%
+\EndIndex{Cmd}{partmark}%
+
+\begin{Declaration}
+ \Macro{markleft}\Parameter{linke Marke}\\
+ \Macro{markright}\Parameter{rechte Marke}\\
+ \Macro{markboth}\Parameter{linke Marke}\Parameter{rechte Marke}
+\end{Declaration}
+\BeginIndex{Cmd}{markleft}%
+\BeginIndex{Cmd}{markright}%
+\BeginIndex{Cmd}{markboth}%
+Unabhängig davon, ob gerade mit manuellen oder automatischen Kolumnentiteln
+gearbeitet wird, kann man jederzeit die \PName{linke Marke} oder \PName{rechte
+ Marke} mit einer dieser Anweisungen setzen. Dabei ist zu beachten, dass die
+resultierende linke Marke in
+\Macro{leftmark}\IndexCmd{leftmark}\important{\Macro{leftmark}} die letzte auf
+der entsprechenden Seite gesetzte Marke ist, während die resultierende rechte
+Marke in \Macro{rightmark}\IndexCmd{rightmark}\important{\Macro{rightmark}}
+die erste auf der entsprechenden Seite gesetzte Marke ausgibt. Näheres dazu
+ist den weiterführenden Erklärungen zu \Macro{rightmark} in
+\autoref{sec:maincls-experts.addInfos},
+\autopageref{desc:maincls-experts.cmd.rightmark} zu entnehmen.
+
+Wird mit manuellen Kolumnentiteln\Index{Kolumnentitel>manuell} gearbeitet, so
+bleiben die Marken gültig, bis sie durch erneute Verwendung der entsprechenden
+Anweisung explizit ersetzt werden. Bei automatischen Kolumnentiteln können
+Marken hingegen je nach Konfigurierung des Automatismus ihre Gültigkeit mit
+einer der nächsten Gliederungsüberschriften verlieren.
+
+Auch im Zusammenhang mit den Sternvarianten der Gliederungsbefehle können
+diese Anweisungen nützlich sein.%
+%
+\begin{Example}
+ Angenommen Sie schreiben noch vor dem Inhaltsverzeichnis ein Vorwort über
+ mehrere Seiten, das jedoch im Inhaltsverzeichnis nicht auftauchen
+ soll. Da Sie aber Trennlinien im Kopf verwenden, soll der Kolumnentitel das
+ Vorwort dennoch zeigen:
+\begin{lstcode}
+ \documentclass[headsepline]{book}
+ \usepackage{scrlayer-scrpage}
+ \pagestyle{scrheadings}
+ \usepackage{blindtext}
+ \begin{document}
+ \chapter*{Vorwort}
+ \markboth{Vorwort}{Vorwort}
+ \blindtext[20]
+ \tableofcontents
+ \blinddocument
+ \end{document}
+\end{lstcode}
+ Zunächst erscheint das Ergebnis wunschgemäß. Beim zweiten Blick fällt aber
+ auf, dass der Kolumnentitel »\texttt{Vorwort}« im Gegensatz zu den übrigen
+ Kolumnentiteln nicht im Versalsatz erscheint. Das ist jedoch leicht zu
+ ändern:
+\begin{lstcode}
+ \documentclass[headsepline]{book}
+ \usepackage{scrlayer-scrpage}
+ \pagestyle{scrheadings}
+ \usepackage{blindtext}
+ \begin{document}
+ \chapter*{Vorwort}
+ \markboth{\MakeMarkcase{Vorwort}}
+ {\MakeMarkcase{Vorwort}}
+ \blindtext[20]
+ \tableofcontents
+ \blinddocument
+ \end{document}
+\end{lstcode}
+ Wie zu sehen ist, wurde
+ \Macro{MakeMarkcase}\IndexCmd{MakeMarkcase}\important{\Macro{MakeMarkcase}}
+ verwendet, um auch den manuell korrigierten Kolumnentitel des Vorworts
+ entsprechend der automatischen Kolumnentitel des restlichen Dokuments
+ anzupassen.
+
+ Verschieben Sie nun einmal \Macro{tableofcontents}%
+ \Index{Inhaltsverzeichnis}\IndexCmd{tableofcontents}%
+ \important{\Macro{tableofcontents}} vor das Vorwort und entfernen Sie die
+ \Macro{markboth}-Anweisung. Sie werden entdecken, dass das Vorwort als
+ Kolumnentitel nun »\texttt{CONTENTS}« trägt. Das liegt an einer Eigenart von
+ \Macro{chapter*}\IndexCmd{chapter*}\important{\Macro{chapter*}} (siehe auch
+ in \autoref{sec:maincls.structure} auf
+ \autopageref{desc:maincls.cmd.chapter*}). Soll hier stattdessen kein
+ Kolumnentitel erscheinen, so ist dies sehr einfach mit \Macro{markboth} mit
+ zwei leeren Argumenten zu erreichen:
+\begin{lstcode}
+ \documentclass[headsepline]{book}
+ \usepackage{scrlayer-scrpage}
+ \pagestyle{scrheadings}
+ \usepackage{blindtext}
+ \begin{document}
+ \tableofcontents
+ \chapter*{Vorwort}
+ \markboth{}{}
+ \blindtext[20]
+ \blinddocument
+ \end{document}
+\end{lstcode}
+\end{Example}
+%
+\EndIndex{Cmd}{markboth}%
+\EndIndex{Cmd}{markright}%
+\EndIndex{Cmd}{markleft}%
+
+\fi %********************************************* Ende nur scrlayer-scrpage *
+\fi %*********************************** Ende nicht scrlayer-scrpage-experts *
+
+
+\ifshortversion\IgnoreThisfalse\IfCommon{scrlayer-scrpage}{\IgnoreThistrue}\fi
+\ifIgnoreThis %+++++++++++++++++++++++++++++++++++++++ auch scrlayer-scrpage +
+\else %---------------------------------------------- nicht scrlayer-scrpage -
+\ifCommonscrlayerscrpage\else %---------------------- nicht scrlayer-scrpage -
+\begin{Declaration}
+ \Macro{GenericMarkFormat}\Parameter{Gliederungsname}
+\end{Declaration}
+\BeginIndex{Cmd}{GenericMarkFormat}%
+Diese Anweisung wird in der Voreinstellung zur Formatierung aller
+Gliederungsnummern in automatischen Kolumnentiteln unterhalb der
+Unterabschnitte und bei Klassen ohne \Macro{chapter} zusätzlich auch für die
+Ebene der Abschnitte und Unterabschnitte verwendet, soweit die entsprechenden
+Mark-Anweisungen nicht bereits anderweitig definiert sind. Dabei verwendet die
+Anweisung in der Voreinstellung
+\Macro{@seccntmarkformat}\IndexCmd{@seccntmarkformat}%
+\important{\Macro{@seccntmarkformat}}, wenn eine solche interne Anweisung wie
+bei den \KOMAScript-Klassen definiert ist. Anderenfalls wird mit
+\Macro{@seccntformat}\IndexCmd{@seccntformat}\important{\Macro{@seccntformat}}
+eine Anweisung verwendet, die bereits vom \LaTeX-Kern für Klassen und Pakete
+bereitgestellt wird. Als Argument erwartet \Macro{GenericMarkFormat} den Namen
+der Gliederung, also beispielsweise \PValue{chapter} oder \PValue{section}
+\emph{ohne} vorangestellten umgekehrten Schrägstrich (engl. \emph{backslash}).
+
+Durch Umdefinierung dieser Anweisung kann damit die Standardformatierung aller
+Gliederungsnummern im Kolumnentitel geändert werden, die darauf
+zurückgreifen. Ebenso kann eine Klasse darüber eine andere
+Standardformatierung vorgeben, ohne alle Befehle einzeln ändern zu müssen.%
+%
+\begin{Example}
+ Angenommen, Sie wollen, dass bei allen Gliederungsnummern im Kolumnentitel
+ eines Artikels die Nummer als weiße Schrift auf einem schwarzen Kasten
+ ausgegeben wird. Da bei Artikeln mit \Class{article} die Anweisungen
+ \Macro{sectionmarkformat}\IndexCmd{sectionmarkformat}%
+ \important{\Macro{sectionmarkformat}\\\Macro{subsectionmarkformat}} und
+ \Macro{subsectionmarkformat}\IndexCmd{subsectionmarkformat} von
+ \Package{scrlayer} mit Hilfe von \Macro{GenericMarkFormat} definiert werden,
+ genügt dafür die entsprechende Umdefinierung dieser einen Anweisung:
+\begin{lstcode}[moretexcs={colorbox,textcolor}]
+ \documentclass{article}
+ \usepackage{blindtext}
+ \usepackage[automark]{scrlayer-scrpage}
+ \pagestyle{scrheadings}
+ \usepackage{xcolor}
+ \newcommand*{\numberbox}[1]{%
+ \colorbox{black}{%
+ \strut~\textcolor{white}{#1}~%
+ }%
+ }
+ \renewcommand*{\GenericMarkFormat}[1]{%
+ \protect\numberbox{\csname the#1\endcsname}%
+ \enskip
+ }
+ \begin{document}
+ \blinddocument
+ \end{document}
+\end{lstcode}
+ Für die Farbumschaltungen werden Anweisungen des Pakets
+ \Package{xcolor}\IndexPackage{xcolor} verwendet. Näheres dazu ist der
+ Anleitung zum Paket zu entnehmen (siehe \cite{package:xcolor}).
+
+ Außerdem wird eine unsichtbare Stütze mit \Macro{strut} eingefügt. Diese
+ Anweisung sollte in keiner ausführlichen \LaTeX-Einführung fehlen.
+
+ Für den Kasten mit der Nummer wird eine eigene Hilfsanweisung
+ \Macro{numberbox} definiert. Diese wird in der Umdefinierung von
+ \Macro{GenericMarkFormat} mit
+ \Macro{protect}\IndexCmd{protect}\important{\Macro{protect}} vor der
+ Expansion geschützt. Dies ist notwendig, weil sonst durch das
+ \Macro{MakeUppercase}\IndexCmd{MakeUppercase}\important{\Macro{MakeUppercase}}
+ für den Versalsatz der Kolumnentitel nicht mehr die Farben »\texttt{black}«
+ und »\texttt{white}«, sondern die Farben »\texttt{BLACK}« und
+ »\texttt{WHITE}« verlangt werden, die gar nicht definiert sind. Alternativ
+ könnte man \Macro{numberbox} auch mit Hilfe von
+ \Macro{DeclareRobustCommand*} statt mit \Macro{newcommand*} definieren
+ (siehe \cite{latex:clsguide}).
+
+ Wollte man dasselbe mit einer \KOMAScript-Klasse oder mit den
+ Standardklassen \Class{book} oder \Class{report} erreichen, so müsste man
+ übrigens zusätzlich \Macro{sectionmarkformat}\IndexCmd{sectionmarkformat}%
+ \important{\Macro{sectionmarkformat}} und -- je nach Klasse --
+ \Macro{subsectionmarkformat}\IndexCmd{subsectionmarkformat}%
+ \important{\Macro{subsectionmarkformat}} beziehungsweise
+ \Macro{chaptermarkformat}\IndexCmd{chaptermarkformat}%
+ \important{\Macro{chaptermarkformat}} umdefinieren, da diese bei Verwendung
+ der genannten Klassen \Macro{GenericMarkFormat} nicht verwenden:
+\begin{lstcode}[moretexcs={colorbox,textcolor}]
+ \documentclass{scrbook}
+ \usepackage{blindtext}
+ \usepackage[automark]{scrlayer-scrpage}
+ \pagestyle{scrheadings}
+ \usepackage{xcolor}
+ \newcommand*{\numberbox}[1]{%
+ \colorbox{black}{%
+ \strut~\textcolor{white}{#1}~%
+ }%
+ }
+ \renewcommand*{\GenericMarkFormat}[1]{%
+ \protect\numberbox{\csname the#1\endcsname}%
+ \enskip
+ }
+ \renewcommand*{\chaptermarkformat}{%
+ \GenericMarkFormat{chapter}%
+ }
+ \renewcommand*{\sectionmarkformat}{%
+ \GenericMarkFormat{section}%
+ }
+ \begin{document}
+ \blinddocument
+ \end{document}
+\end{lstcode}
+\end{Example}
+\EndIndex{Cmd}{GenericMarkFormat}%
+
+\begin{Declaration}
+ \Macro{@mkleft}\Parameter{linke Marke}\\
+ \Macro{@mkright}\Parameter{rechte Marke}\\
+ \Macro{@mkdouble}\Parameter{Marke}\\
+ \Macro{@mkboth}\Parameter{linke Marke}\Parameter{rechte Marke}
+\end{Declaration}
+\BeginIndex{Cmd}{@mkleft}%
+\BeginIndex{Cmd}{@mkright}%
+\BeginIndex{Cmd}{@mkdouble}%
+\BeginIndex{Cmd}{@mkboth}%
+Innerhalb der Klassen und Pakete kommt es vor, dass Kolumnentitel nur dann
+gesetzt werden sollen, wenn automatische Kolumnentitel (siehe Option
+\Option{automark} und Anweisung \Macro{automark} auf
+\autopageref{desc:scrlayer-scrpage.cmd.automark}) aktiviert sind. Bei den
+Standardklassen geht dies ausschließlich über \Macro{@mkboth}. Diese Anweisung
+entspricht entweder \Macro{\@gobbletwo}, einer Anweisung, die ihre beiden
+Argumente vernichtet, oder \Macro{markboth}, einer Anweisung, mit der sowohl
+eine \PName{linke Marke} als auch eine \PName{rechte Marke} gesetzt
+wird. Pakete wie \Package{babel} hängen sich ebenfalls in \Macro{\@mkboth}
+ein, um beispielsweise noch eine Sprachumschaltung im Kolumnentitel
+vorzunehmen.
+
+Will man nun jedoch nur eine \PName{linke Marke} oder nur eine \PName{rechte
+ Marke} setzen, ohne die jeweils andere Marke zu verändern, so fehlen
+entsprechende Anweisungen. Das Paket \Package{scrlayer} selbst benötigt
+entsprechende Anweisungen beispielsweise im Rahmen der automatischen
+Kolumnentitel. Sind \Macro{@mkleft} zum Setzen nur der \PName{linken Marke},
+\Macro{@mkright} zum Setzen nur der \PName{rechten Marke} oder
+\Macro{@mkdouble} zum Setzen sowohl der rechten als auch der linken
+\PName{Marke} mit demselben Inhalt beim Laden von \Package{scrlayer} nicht
+definiert, so werden sie vom Paket selbst definiert. Dabei wird eine
+Definition gewählt, die am Zustand von \Macro{@mkboth} erkennt, ob mit
+automatischen Kolumnentiteln gearbeitet wird. Nur in diesem Fall setzen die
+Befehle auch eine entsprechende Marke.%
+
+Klassen- und Paketautoren können ebenfalls auf diese Anweisungen
+zurückgreifen, wenn sie nur linke oder nur rechte Marken setzen wollen und
+auch diese nur, wenn mit automatischen Kolumnentiteln gearbeitet wird.%
+\EndIndex{Cmd}{@mkboth}%
+\EndIndex{Cmd}{@mkdouble}%
+\EndIndex{Cmd}{@mkright}%
+\EndIndex{Cmd}{@mkleft}%
+
+\fi %******************************************* Ende nicht scrlayer-scrpage *
+\fi %******************************************* Ende nicht scrlayer-scrpage *
+
+\ifshortversion%
+\IfCommon{scrlayer}{%
+ Zu weiteren Möglichkeiten zur Beeinflussung der Inhalte von Seitenstilen
+ siehe auch \autoref{sec:scrlayer-scrpage.pagestyle.content},
+ \autopageref{sec:scrlayer-scrpage.pagestyle.content}.%
+}%
+\fi
+
+%%% Local Variables:
+%%% mode: latex
+%%% mode: flyspell
+%%% coding: iso-latin-1
+%%% ispell-local-dictionary: "de_DE"
+%%% TeX-master: "scrlayer-de.tex"
+%%% TeX-PDF-mode: t
+%%% End:
+
+% LocalWords: Seitenstilen Ebenenmodell scrpage headings myheadings plain
+% LocalWords: empty scrlayer Seitenstil Rückgriffe Gliederungsnummern
+% LocalWords: Standardklassen Seitenstile konsistenteren Befehlssatzes
+% LocalWords: Einstellmöglichkeiten Seiteninhalts Gliederungsüberschrift
+% LocalWords: Maßlinien Entwurfsphase Unterabschnittsüberschrift Versalsatz
+% LocalWords: Abschnittsüberschrift Kapitelüberschrift Glyphenanalyse
+% LocalWords: Hilfsanweisung
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-5.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-5.tex
index 849dd14f962..e820a04c572 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-5.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-5.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-5.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-5.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,33 +45,41 @@
%
% ======================================================================
-\ProvidesFile{common-5.tex}[2012/01/01 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-5.tex}
+ [$Date: 2013-12-12 12:01:33 +0100 (Do, 12. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\makeatletter
\@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}%
\@ifundefined{ifCommonscrextend}{\newif\ifCommonscrextend}{}%
\@ifundefined{ifCommonscrlttr}{\newif\ifCommonscrlttr}{}%
\@ifundefined{ifIgnoreThis}{\newif\ifIgnoreThis}{}%
+\@ifundefined{ifCommonscrlayer-scrpage}{%
+ \expandafter\newif\csname ifCommonscrlayer-scrpage\endcsname
+}{}
+\expandafter\let\expandafter\ifCommonscrlayerscrpage
+\csname ifCommonscrlayer-scrpage\endcsname
\makeatother
-
\section{Textauszeichnungen}
\label{sec:\csname label@base\endcsname.textmarkup}%
-\ifshortversion\IgnoreThisfalse\IfCommon{scrlttr2}{\IgnoreThistrue}\fi%
-\ifIgnoreThis %++++++++++++++++++++++++++++++++++++++++++++++ nur scrlttr2 +
+\IgnoreThisfalse
+\ifshortversion\IgnoreThistrue\ifCommonmaincls\IgnoreThisfalse\fi\fi%
+\ifIgnoreThis %+++++++++++++++++++++++++++++++ Kurzfassung (nicht maincls) +
Es gilt sinngemäß, was in \autoref{sec:maincls.textmarkup} geschrieben
wurde. Dabei sind Namen und Bedeutung der einzelnen Elemente in
-\else %---------------------------------------------------- nicht scrlttr2 -
+\else %----------------------------------------- Langfassung (nur maincls) -
\BeginIndex{}{Text>Auszeichnung}%
\BeginIndex{}{Schrift>Art}%
-\LaTeX{} verfügt über eine ganze Reihe von Anweisungen zur
-Textauszeichnung. Neben der Wahl der Schriftart gehören dazu auch Befehle zur
-Wahl einer Textgröße oder der Textausrichtung. Näheres zu den normalerweise
-definierten Möglichkeiten ist \cite{l2kurz}, \cite{latex:usrguide} und
-\cite{latex:fntguide} zu entnehmen.
-
+\LaTeX{} verfügt über eine ganze Reihe von Anweisungen zur Textauszeichnung. %
+% Umbruchkorrektur
+\IfNotCommon{scrlttr2}{Neben der Wahl der Schriftart gehören dazu auch Befehle
+ zur Wahl einer Textgröße oder der Textausrichtung. }%
+Näheres zu den normalerweise definierten Möglichkeiten ist \cite{l2kurz},
+\cite{latex:usrguide} und \cite{latex:fntguide} zu entnehmen.
+\ifCommonscrlayerscrpage\else
\begin{Declaration}
\Macro{textsuperscript}\Parameter{Text}\\
\Macro{textsubscript}\Parameter{Text}
@@ -151,6 +159,7 @@ geschweifte Klammern gesetzt wurden.%
%
\EndIndex{Cmd}{textsuperscript}%
\EndIndex{Cmd}{textsubscript}%
+\fi% \ifCommonscrlayerscrpage
\begin{Declaration}
@@ -179,34 +188,516 @@ entnehmen Sie bitte \cite{l2kurz}, \cite{latex:usrguide} oder
\cite{latex:fntguide}. Auch Farbumschaltungen wie \Macro{normalcolor} sind
möglich (siehe \cite{package:graphics} und \cite{package:xcolor}).
\iffalse % Umbruchkorrekturtext
-Das Verhalten bei Verwendung anderer Anweisungen, inbesondere solcher, die zu
-Umdefinierungen führen oder Ausgaben tätigen, ist nicht definiert. Seltsames
-Verhalten ist möglich und stellt keinen Fehler dar. \else Die Verwendung
-anderer Anweisungen, inbesondere solcher, die Umdefinierungen vornehmen oder
-zu Ausgaben führen, ist nicht vorgesehen. Seltsames Verhalten ist in diesen
-Fällen möglich und stellt keinen Fehler dar. \fi
+ Das Verhalten bei Verwendung anderer Anweisungen, inbesondere solcher, die
+ zu Umdefinierungen führen oder Ausgaben tätigen, ist nicht
+ definiert. Seltsames Verhalten ist möglich und stellt keinen Fehler dar.
+ \else Die Verwendung anderer Anweisungen, inbesondere solcher, die
+ Umdefinierungen vornehmen oder zu Ausgaben führen, ist nicht vorgesehen.
+ Seltsames Verhalten ist in diesen Fällen möglich und stellt keinen Fehler
+ dar.%
+\fi
Mit \Macro{setkomafont} wird die Schriftumschaltung eines Elements mit einer
völlig neuen Definition versehen. Demgegenüber wird mit \Macro{addtokomafont}
die existierende Definition lediglich erweitert. Es wird empfohlen, beide
Anweisungen nicht innerhalb des Dokuments, sondern nur in der Dokumentpräambel
zu verwenden. Beispiele für die Verwendung entnehmen Sie bitte den Abschnitten
-zu den jeweiligen Elementen. Namen und Bedeutung der einzelnen Elemente sind
+zu den jeweiligen Elementen. Namen und Bedeutung der einzelnen Elemente
+\IfCommon{scrlayer-scrpage}{und deren Voreinstellungen }sind
in %
-\fi %************************************************* Ende nicht scrlttr2 *
-\IfNotCommon{scrextend}{\autoref{tab:\csname
- label@base\endcsname.elementsWithoutText} }%
+\fi %******************************************* Ende Langform (nur maincls) *
+\IfNotCommon{scrextend}{\IfNotCommon{scrlayer-scrpage}{\autoref{tab:\csname
+ label@base\endcsname.elementsWithoutText} }}%
\IfCommon{scrextend}{\autoref{tab:maincls.elementsWithoutText},
\autopageref{tab:maincls.elementsWithoutText} }%
+\IfCommon{scrlayer-scrpage}{\autoref{tab:scrlayer-scrpage.fontelements},
+ \autopageref{tab:scrlayer-scrpage.fontelements} }%
aufgelistet. %
\IfCommon{scrextend}{Allerdings werden davon in \Package{scrextend} nur die
Elemente für den Dokumenttitel, den schlauen Spruch, die Fußnoten und die
- \Environment{labeling}-Umgebung
- behandelt. Das Element \FontElement{disposition} ist zwar auch verfügbar,
- wird jedoch von \Package{scrextend} ebenfalls nur für den Dokumenttitel
- verwendet. }%
-Die Voreinstellungen sind den jeweiligen Abschnitten zu entnehmen.
+ \Environment{labeling}-Umgebung behandelt. Das Element
+ \FontElement{disposition} ist zwar auch verfügbar, wird jedoch von
+ \Package{scrextend} ebenfalls nur für den Dokumenttitel verwendet.%
+}%
+\IfNotCommon{scrlayer-scrpage}{Die Voreinstellungen sind den jeweiligen
+ Abschnitten zu entnehmen.}%
+
+\ifIgnoreThis %+++++++++++++++++++++++++++++++ Kurzfassung (nicht maincls) +
+\else %----------------------------------------- Langfassung (nur maincls) -
+
+Mit der Anweisung \Macro{usekomafont} kann die aktuelle Schriftart auf
+diejenige umgeschaltet werden, die für das angegebene \PName{Element}
+definiert ist.
+\ifCommonmaincls % +++++++++++++++++++++++++++++++++++++++++++ nur maincls +
+\begin{Example}
+ \phantomsection\label{desc:maincls.setkomafont.example}%
+ Angenommen, für das Element
+ \FontElement{captionlabel} soll dieselbe Schriftart wie
+ für \FontElement{descriptionlabel} verwenden. Das
+ erreichen Sie einfach mit:
+\begin{lstcode}
+ \setkomafont{captionlabel}{%
+ \usekomafont{descriptionlabel}%
+ }
+\end{lstcode}
+ Weitere Beispiele finden Sie in den Abschnitten zu den jeweiligen
+ Elementen.
+\end{Example}
+\begin{desclist}
+ \desccaption{%
+ Elemente, deren Schrift bei \Class{scrbook}, \Class{scrreprt} oder
+ \Class{scrartcl} mit \Macro{setkomafont} und \Macro{addtokomafont}
+ verändert werden kann\label{tab:maincls.elementsWithoutText}%
+ }{%
+ Elemente, deren Schrift verändert werden kann (\emph{Fortsetzung})%
+ }%
+ \feentry{author}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}}%
+ Autorangaben im Haupttitel des Dokuments mit \Macro{maketitle}, also das
+ Argument von \Macro{author} (siehe \autoref{sec:maincls.titlepage},
+ \autopageref{desc:maincls.cmd.author})}%
+ \feentry{caption}{Text einer Abbildungs- oder Tabellenunter- oder
+ "~überschrift (siehe \autoref{sec:maincls.floats},
+ \autopageref{desc:maincls.cmd.caption})}%
+ \feentry{captionlabel}{%
+ Label einer Abbildungs- oder Tabellenunter- oder "~überschrift; Anwendung
+ erfolgt nach dem Element \FontElement{caption} (siehe
+ \autoref{sec:maincls.floats}, \autopageref{desc:maincls.cmd.caption})}%
+ \feentry{chapter}{%
+ Überschrift der Ebene \Macro{chapter} (siehe
+ \autoref{sec:maincls.structure}, \autopageref{desc:maincls.cmd.chapter})}%
+ \feentry{chapterentry}{%
+ Inhaltsverzeichniseintrag der Ebene \Macro{chapter} (siehe
+ \autoref{sec:maincls.toc},
+ \autopageref{desc:maincls.cmd.tableofcontents})}%
+ \feentry{chapterentrypagenumber}{%
+ Seitenzahl des Inhaltsverzeichniseintrags der Ebene \Macro{chapter}
+ abweichend vom Element \FontElement{chapterentry} (siehe
+ \autoref{sec:maincls.toc},
+ \autopageref{desc:maincls.cmd.tableofcontents})}%
+ \feentry{chapterprefix}{%
+ Kapitelnummernzeile bei Einstellung \OptionValue{chapterprefix}{true} oder
+ \OptionValue{appendixprefix}{true} (siehe \autoref{sec:maincls.structure},
+ \autopageref{desc:maincls.option.chapterprefix})}%
+ \feentry{date}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}}%
+ Datum im Haupttitel des Dokuments mit \Macro{maketitle}, also das Argument
+ von \Macro{date} (siehe \autoref{sec:maincls.titlepage},
+ \autopageref{desc:maincls.cmd.date})}%
+ \feentry{dedication}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}}%
+ Widmung nach dem Haupttitel des Dokuments mit \Macro{maketitle}, also das
+ Argument von \Macro{dedication} (siehe \autoref{sec:maincls.titlepage},
+ \autopageref{desc:maincls.cmd.dedication})}%
+ \feentry{descriptionlabel}{%
+ Label, also das optionale Argument der \Macro{item}-Anweisung, in einer
+ \Environment{description}-Umgebung (siehe \autoref{sec:maincls.lists},
+ \autopageref{desc:maincls.env.description})}%
+ \feentry{dictum}{%
+ mit \Macro{dictum} gesetzter schlauer Spruch (siehe
+ \autoref{sec:maincls.dictum}, \autopageref{desc:maincls.cmd.dictum})}%
+ \feentry{dictumauthor}{%
+ Urheber eines schlauen Spruchs; Anwendung erfolgt nach dem Element
+ \FontElement{dictum} (siehe \autoref{sec:maincls.dictum},
+ \autopageref{desc:maincls.cmd.dictum})}%
+ \feentry{dictumtext}{%
+ alternative Bezeichnung für \FontElement{dictum}}%
+ \feentry{disposition}{%
+ alle Gliederungsüberschriften, also die Argumente von \Macro{part} bis
+ \Macro{subparagraph} und \Macro{minisec} sowie die Überschrift der
+ Zusammenfassung; die Anwendung erfolgt vor dem Element der jeweiligen
+ Gliederungsebene (siehe \autoref{sec:maincls.structure} ab
+ \autopageref{sec:maincls.structure})}%
+ \feentry{footnote}{%
+ Marke und Text einer Fußnote (siehe \autoref{sec:maincls.footnotes},
+ \autopageref{desc:maincls.cmd.footnote})}%
+ \feentry{footnotelabel}{%
+ Marke einer Fußnote; Anwendung erfolgt nach dem Element
+ \FontElement{footnote} (siehe \autoref{sec:maincls.footnotes},
+ \autopageref{desc:maincls.cmd.footnote})}%
+ \feentry{footnotereference}{%
+ Referenzierung der Fußnotenmarke im Text (siehe
+ \autoref{sec:maincls.footnotes},
+ \autopageref{desc:maincls.cmd.footnote})}%
+ \feentry{footnoterule}{%
+ Linie\ChangedAt{v3.07}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} über dem Fußnotenapparat (siehe
+ \autoref{sec:maincls.footnotes},
+ \autopageref{desc:maincls.cmd.setfootnoterule})}%
+ \feentry{labelinglabel}{%
+ Label, also das optionale Argument der \Macro{item}-Anweisung, und
+ Trennzeichen, also das optionale Argument der
+ \Environment{labeling}-Umgebung, in einer \Environment{labeling}-Umgebung
+ (siehe \autoref{sec:maincls.lists},
+ \autopageref{desc:maincls.env.labeling})}%
+ \feentry{labelingseparator}{%
+ Trennzeichen, also das optionale Argument der
+ \Environment{labeling}-Umgebung, in einer \Environment{labeling}-Umgebung;
+ Anwendung erfolgt nach dem Element \FontElement{labelinglabel} (siehe
+ \autoref{sec:maincls.lists}, \autopageref{desc:maincls.env.labeling})}%
+ \feentry{minisec}{%
+ mit \Macro{minisec} gesetzte Überschrift (siehe
+ \autoref{sec:maincls.structure} ab
+ \autopageref{desc:maincls.cmd.minisec})}%
+ \feentry{pagefoot}{%
+ wird nur verwendet, wenn das Paket \Package{scrlayer-scrpage}\iffree{ oder
+ \Package{scrpage2}}{} geladen ist (siehe
+ \autoref{cha:scrlayer-scrpage},
+ \autopageref{desc:scrlayer-scrpage.fontelement.pagefoot}\iffree{
+ beziehungsweise \autoref{cha:scrpage},
+ \autopageref{desc:scrpage.fontelement.pagefoot}}{})}%
+ \feentry{pagehead}{%
+ alternative Bezeichnung für \FontElement{pageheadfoot}}%
+ \feentry{pageheadfoot}{%
+ Seitenkopf und Seitenfuß bei allen von \KOMAScript{} definierten
+ Seitenstilen (siehe \autoref{sec:maincls.pagestyle} ab
+ \autopageref{sec:maincls.pagestyle})}%
+ \feentry{pagenumber}{%
+ Seitenzahl im Kopf oder Fuß der Seite (siehe
+ \autoref{sec:maincls.pagestyle})}%
+ \feentry{pagination}{%
+ alternative Bezeichnung für \FontElement{pagenumber}}%
+ \feentry{paragraph}{%
+ Überschrift der Ebene \Macro{paragraph} (siehe
+ \autoref{sec:maincls.structure},
+ \autopageref{desc:maincls.cmd.paragraph})}%
+ \feentry{part}{%
+ Überschrift der Ebene \Macro{part}, jedoch ohne die Zeile mit der Nummer
+ des Teils (siehe \autoref{sec:maincls.structure},
+ \autopageref{desc:maincls.cmd.part})}%
+ \feentry{partentry}{%
+ Inhaltsverzeichniseintrag der Ebene \Macro{part} (siehe
+ \autoref{sec:maincls.toc},
+ \autopageref{desc:maincls.cmd.tableofcontents})}%
+ \feentry{partentrypagenumber}{%
+ Seitenzahl des Inhaltsverzeichniseintrags der Ebene \Macro{part}
+ abweichend vom Element \FontElement{partentry} (siehe
+ \autoref{sec:maincls.toc},
+ \autopageref{desc:maincls.cmd.tableofcontents})}%
+ \feentry{partnumber}{%
+ Zeile mit der Nummer des Teils in Überschrift der Ebene \Macro{part}
+ (siehe \autoref{sec:maincls.structure},
+ \autopageref{desc:maincls.cmd.part})}%
+ \feentry{publishers}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}}%
+ Verlagsangabe im Haupttitel des Dokuments mit \Macro{maketitle}, also das
+ Argument von \Macro{publishers} (siehe \autoref{sec:maincls.titlepage},
+ \autopageref{desc:maincls.cmd.publishers})}%
+ \feentry{section}{%
+ Überschrift der Ebene \Macro{section} (siehe
+ \autoref{sec:maincls.structure}, \autopageref{desc:maincls.cmd.section})}%
+ \feentry{sectionentry}{%
+ Inhaltsverzeichniseintrag der Ebene \Macro{section} (nur bei
+ \Class{scrartcl} verfügbar, siehe \autoref{sec:maincls.toc},
+ \autopageref{desc:maincls.cmd.tableofcontents})}%
+ \feentry{sectionentrypagenumber}{%
+ Seitenzahl des Inhaltsverzeichniseintrags der Ebene \Macro{section}
+ abweichend vom Element \FontElement{sectionentry} (nur bei
+ \Class{scrartcl} verfügbar, siehe \autoref{sec:maincls.toc},
+ \autopageref{desc:maincls.cmd.tableofcontents})}%
+ \feentry{sectioning}{%
+ alternative Bezeichnung für \FontElement{disposition}}%
+ \feentry{subject}{%
+ Typisierung des Dokuments, also das Argument von \Macro{subject} auf der
+ Haupttitelseite mit \Macro{maketitle} (siehe
+ \autoref{sec:maincls.titlepage}, \autopageref{desc:maincls.cmd.subject})}%
+ \feentry{subparagraph}{%
+ Überschrift der Ebene \Macro{subparagraph} (siehe
+ \autoref{sec:maincls.structure},
+ \autopageref{desc:maincls.cmd.subparagraph})}%
+ \feentry{subsection}{%
+ Überschrift der Ebene \Macro{subsection} (siehe
+ \autoref{sec:maincls.structure},
+ \autopageref{desc:maincls.cmd.subsection})}%
+ \feentry{subsubsection}{%
+ Überschrift der Ebene \Macro{subsubsection} (siehe
+ \autoref{sec:maincls.structure},
+ \autopageref{desc:maincls.cmd.subsubsection})}%
+ \feentry{subtitle}{%
+ Untertitel des Dokuments, also das Argument von \Macro{subtitle} auf der
+ Haupttitelseite mit \Macro{maketitle} (siehe
+ \autoref{sec:maincls.titlepage}, \autopageref{desc:maincls.cmd.title})}%
+ \feentry{title}{%
+ Haupttitel des Dokuments, also das Argument von \Macro{title} bei
+ Verwendung von \Macro{maketitle} (bezüglich der Größe des Haupttitels
+ siehe die ergänzenden Bemerkungen im Text von
+ \autoref{sec:maincls.titlepage} ab \autopageref{desc:maincls.cmd.title})}%
+ \feentry{titlehead}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}}%
+ Kopf über dem Haupttitel des Dokuments, also das Argument von
+ \Macro{titlehead} mit \Macro{maketitle} (siehe
+ \autoref{sec:maincls.titlepage},
+ \autopageref{desc:maincls.cmd.titlehead})}%
+\end{desclist}
+%
+\fi % *************************************************** Ende nur maincls *
+\ifCommonscrextend % +++++++++++++++++++++++++++++++++++++++ nur scrextend +
+\begin{Example}
+ Angenommen, Sie wollen, dass der Titel in Serifenschrift und rot gesetzt
+ wird. Das erreichen Sie einfach mit:
+\begin{lstcode}
+ \setkomafont{title}{\color{red}}
+\end{lstcode}
+ Für die Anweisung \lstinline|\color{red}| wird das Paket \Package{color}
+ oder \Package{xcolor} benötigt. Die zusätzliche Angabe von
+ \Macro{normalfont} ist in diesem Beispiel deshalb nicht notwendig, weil
+ diese Anweisung bereits in der Definition des Titels enthalten
+ ist. Das\textnote{Achtung!} Beispiel setzt voraus, dass
+ \OptionValue{extendedfeature}{title} gesetzt ist (siehe
+ \autoref{sec:scrextend.optionalFeatures},
+ \autopageref{desc:scrextend.option.extendedfeature}).
+\end{Example}
+\fi % ************************************************* Ende nur scrextend *
+\ifCommonscrlttr % ++++++++++++++++++++++++++++++++++++++++++ nur scrlttr2 +
+\par
+Ein allgemeines Beispiel für die Anwendung von \Macro{setkomafont} und
+\Macro{usekomafont} finden Sie in \autoref{sec:maincls.textmarkup},
+\autopageref{desc:maincls.setkomafont.example}.
+\fi % ************************************************** Ende nur scrlttr2 *
+\fi %***************************************** Ende Langform (nur maincls) *
+\ifCommonscrlttr % ++++++++++++++++++++++++++++++++++++++++++ nur scrlttr2 +
+\begin{desclist}
+ \desccaption{%
+ Elemente, deren Schrift bei der Klasse \Class{scrlttr2} mit
+ \Macro{setkomafont} und \Macro{addtokomafont} verändert werden
+ kann\label{tab:scrlttr2.elementsWithoutText}%
+ }{%
+ Elemente, deren Schrift verändert werden kann (\emph{Fortsetzung})%
+ }%
+ \feentry{addressee}{Name und Anschrift im Anschriftfenster
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.option.addrfield})}%
+ \feentry{backaddress}{Rücksendeadresse für einen Fensterbriefumschlag
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.option.backaddress})}%
+ \feentry{descriptionlabel}{Label, also das optionale Argument von
+ \Macro{item}, in einer \Environment{description}-Umgebung
+ (\autoref{sec:scrlttr2.lists},
+ \autopageref{desc:scrlttr2.env.description})}%
+ \feentry{foldmark}{Faltmarke auf dem Briefpapier; ermöglicht Änderung der
+ Linienfarbe (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.option.foldmarks})}%
+ \feentry{footnote}{%
+ Marke und Text einer Fußnote (\autoref{sec:scrlttr2.footnotes},
+ \autopageref{desc:scrlttr2.cmd.footnote})}%
+ \feentry{footnotelabel}{%
+ Marke einer Fußnote; Anwendung erfolgt nach dem Element
+ \FontElement{footnote} (\autoref{sec:scrlttr2.footnotes},
+ \autopageref{desc:scrlttr2.cmd.footnote})}%
+ \feentry{footnotereference}{%
+ Referenzierung der Fußnotenmarke im Text
+ (\autoref{sec:scrlttr2.footnotes},
+ \autopageref{desc:scrlttr2.cmd.footnote})}%
+ \feentry{footnoterule}{%
+ Linie\ChangedAt{v3.07}{\Class{scrlttr2}} über dem Fußnotenapparat
+ (\autoref{sec:scrlttr2.footnotes},
+ \autopageref{desc:scrlttr2.cmd.setfootnoterule})}%
+ \feentry{fromaddress}{Absenderadresse im Briefkopf
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.fromaddress})}%
+ \feentry{fromname}{Name des Absenders im Briefkopf abweichend von
+ \PValue{fromaddress} (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.fromname})}%
+ \feentry{fromrule}{Linie im Absender im Briefkopf; gedacht für
+ Farbänderungen (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.option.fromrule})}%
+ \feentry{labelinglabel}{%
+ Label, also das optionale Argument der \Macro{item}-Anweisung, und
+ Trennzeichen, also das optionale Argument der
+ \Environment{labeling}-Umgebung, in einer \Environment{labeling}-Umgebung
+ (siehe \autoref{sec:scrlttr2.lists},
+ \autopageref{desc:scrlttr2.env.labeling})}%
+ \feentry{labelingseparator}{%
+ Trennzeichen, also das optionale Argument der
+ \Environment{labeling}-Umgebung, in einer \Environment{labeling}-Umgebung;
+ Anwendung erfolgt nach dem Element \FontElement{labelinglabel} (siehe
+ \autoref{sec:scrlttr2.lists}, \autopageref{desc:scrlttr2.env.labeling})}%
+ \feentry{pagefoot}{%
+ wird nach dem Element \FontElement{pageheadfoot} für den mit Variable
+ \Variable{nextfoot}\IndexVariable{nextfoot} definieren Seitenfuß verwendet
+ oder wenn das Paket \Package{scrpage2} geladen ist
+ (\autoref{cha:scrlayer-scrpage},
+ \autopageref{desc:scrlayer-scrpage.fontelement.pagefoot}\iffree{ oder
+ \autoref{cha:scrpage},
+ \autopageref{desc:scrpage.fontelement.pagefoot}}{})}%
+ \feentry{pagehead}{%
+ alternative Bezeichnung für \FontElement{pageheadfoot}}%
+ \feentry{pageheadfoot}{%
+ Seitenkopf und Seitenfuß bei allen von \KOMAScript{} definierten
+ Seitenstilen (\autoref{sec:scrlttr2.pagestyle},
+ \autopageref{desc:scrlttr2.fontelement.pageheadfoot})}%
+ \feentry{pagenumber}{%
+ Seitenzahl im Kopf oder Fuß der Seite (\autoref{sec:scrlttr2.pagestyle},
+ \autopageref{desc:scrlttr2.fontelement.pagenumber})}%
+ \feentry{pagination}{%
+ alternative Bezeichnung für \FontElement{pagenumber}}%
+ \feentry{placeanddate}{%
+ \ChangedAt{v3.12}{\Class{scrlttr2}}%
+ Ort und Datum, falls statt einer Geschäftszeile nur eine Datumszeile
+ verwendet wird (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.placeseparator})}%
+ \feentry{refname}{%
+ Bezeichnung der Felder in der Geschäftszeile
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.yourref})}%
+ \feentry{refvalue}{%
+ Werte der Felder in der Geschäftszeile (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.yourref})}%
+ \feentry{specialmail}{Versandart im Anschriftfenster
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.specialmail})}%
+ \feentry{subject}{Betreff in der Brieferöffnung
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.subject})}%
+ \feentry{title}{Titel in der Brieferöffnung
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.title})}%
+ \feentry{toaddress}{Abweichung vom Element \FontElement{addressee} für die
+ Anschrift (ohne Name) des Empfängers im Anschriftfeld
+ (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.toaddress})}%
+ \feentry{toname}{Abweichung vom Element \FontElement{addressee} für den
+ Namen des Empfängers im Anschriftfeld (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.toname})}%
+\end{desclist}
+\fi % ************************************************** Ende nur scrlttr2 *
+\ifCommonscrlayerscrpage % ++++++++++++++++++++++++++ nur scrlayer-scrpage +
+\begin{desclist}
+ \desccaption[{Elemente, deren Schrift bei \Package{scrlayer-scrpage} mit
+ \Macro{setkomafont} und \Macro{addtokomafont} verändert werden kann, sowie
+ deren Voreinstellung}]%
+ {Elemente, deren Schrift bei \Package{scrlayer-scrpage} mit
+ \Macro{setkomafont} und \Macro{addtokomafont} verändert werden kann, sowie
+ deren Voreinstellung, falls die Elemente beim Laden von
+ \Package{scrlayer-scrpage} nicht bereits definiert sind%
+ \label{tab:scrlayer-scrpage.fontelements}%
+ }%
+ {Elemente, deren Schrift verändert werden kann (\emph{Fortsetzung})}%
+ \feentry{footbotline}{%
+ Linie unter dem Fuß eines mit \Package{scrlayer-scrpage} definierten
+ Seitenstils (siehe \autoref{sec:scrlayer-scrpage.pagestyle.content},
+ \autopageref{desc:scrlayer-scrpage.fontelement.footbotline}). Das Element
+ wird nach \Macro{normalfont}\IndexCmd{normalfont} und nach den Elementen
+ \FontElement{pageheadfoot}\IndexFontElement{pageheadfoot} und
+ \FontElement{pagefoot}\IndexFontElement{pagefoot} angewandt. Es wird
+ empfohlen dieses Element lediglich für Farbänderungen zu verwenden.\par
+ Voreinstellung: \emph{leer} }%
+ \feentry{footsepline}{%
+ Linie über dem Fuß eines mit \Package{scrlayer-scrpage} definierten
+ Seitenstils (siehe \autoref{sec:scrlayer-scrpage.pagestyle.content},
+ \autopageref{desc:scrlayer-scrpage.fontelement.footsepline}). Das Element
+ wird nach \Macro{normalfont}\IndexCmd{normalfont} und nach den Elementen
+ \FontElement{pageheadfoot}\IndexFontElement{pageheadfoot} und
+ \FontElement{pagefoot}\IndexFontElement{pagefoot} angewandt. Es wird
+ empfohlen dieses Element lediglich für Farbänderungen zu verwenden.\par
+ Voreinstellung: \emph{leer}%
+ }%
+ \feentry{headsepline}{%
+ Linie unter dem Kopf eines mit \Package{scrlayer-scrpage} definierten
+ Seitenstils (siehe \autoref{sec:scrlayer-scrpage.pagestyle.content},
+ \autopageref{desc:scrlayer-scrpage.fontelement.headsepline}). Das Element
+ wird nach \Macro{normalfont}\IndexCmd{normalfont} und nach den Elementen
+ \FontElement{pageheadfoot}\IndexFontElement{pageheadfoot} und
+ \FontElement{pagehead}\IndexFontElement{pagehead} angewandt. Es wird
+ empfohlen dieses Element lediglich für Farbänderungen zu verwenden.\par
+ Voreinstellung: \emph{leer}%
+ }%
+ \feentry{headtopline}{%
+ Linie über dem Kopf eines mit \Package{scrlayer-scrpage} definierten
+ Seitenstils (siehe \autoref{sec:scrlayer-scrpage.pagestyle.content},
+ \autopageref{desc:scrlayer-scrpage.fontelement.headtopline}). Das Element
+ wird nach \Macro{normalfont}\IndexCmd{normalfont} und nach den Elementen
+ \FontElement{pageheadfoot}\IndexFontElement{pageheadfoot} und
+ \FontElement{pagehead}\IndexFontElement{pagehead} angewandt. Es wird
+ empfohlen dieses Element lediglich für Farbänderungen zu verwenden.\par
+ Voreinstellung: \emph{leer}%
+ }%
+ \feentry{pagefoot}{%
+ Inhalt eines Fußes eines mit \Package{scrlayer-scrpage} definierten
+ Seitenstils (siehe \autoref{sec:scrlayer-scrpage.predefined.pagestyles},
+ \autopageref{desc:scrlayer-scrpage.fontelement.pagefoot}). Das Element
+ wird nach \Macro{normalfont}\IndexCmd{normalfont} und nach dem Element
+ \FontElement{pageheadfoot}\IndexFontElement{pageheadfoot} angewandt.\par
+ Voreinstellung: \emph{leer}%
+ }%
+ \feentry{pagehead}{%
+ Inhalt eines Kopfes eines mit \Package{scrlayer-scrpage} definierten
+ Seitenstils (siehe \autoref{sec:scrlayer-scrpage.predefined.pagestyles},
+ \autopageref{desc:scrlayer-scrpage.fontelement.pagehead}). Das Element
+ wird nach \Macro{normalfont}\IndexCmd{normalfont} und nach Element
+ \FontElement{pageheadfoot}\IndexFontElement{pageheadfoot} angewandt.\par
+ Voreinstellung: \emph{leer}%
+ }%
+ \feentry{pageheadfoot}{%
+ Inhalt eines Kopfes oder Fußes eines mit \Package{scrlayer-scrpage}
+ definierten Seitenstils (siehe
+ \autoref{sec:scrlayer-scrpage.predefined.pagestyles},
+ \autopageref{desc:scrlayer-scrpage.fontelement.pageheadfoot}). Das Element
+ wird nach \Macro{normalfont}\IndexCmd{normalfont} angewandt.\par
+ Voreinstellung: \Macro{normalcolor}\Macro{slshape}%
+ }%
+ \feentry{pagenumber}{%
+ Die mit \Macro{pagemark} gesetzte Paginierung (siehe
+ \autoref{sec:scrlayer-scrpage.predefined.pagestyles},
+ \autopageref{desc:scrlayer-scrpage.fontelement.pagenumber}). Bei einer
+ etwaigen Umdefinierung von \Macro{pagemark} ist dafür zu sorgen, dass die
+ Umdefinierung auch ein \Macro{usekomafont}\PParameter{pagenumber}
+ enthält!\par
+ Voreinstellung: \Macro{normalfont}%
+ }%
+\end{desclist}
+\fi % ****************************************** Ende nur scrlayer-scrpage *
+\ifIgnoreThis %+++++++++++++++++++++++++++++++ Kurzfassung (nicht maincls) +
+\else %----------------------------------------- Langfassung (nur maincls) -
+\EndIndex{Cmd}{setkomafont}%
+\EndIndex{Cmd}{addtokomafont}%
+\EndIndex{Cmd}{usekomafont}%
+
+\begin{Declaration}
+ \Macro{usefontofkomafont}\Parameter{Element}\\
+ \Macro{useencodingofkomafont}\Parameter{Element}\\
+ \Macro{usesizeofkomafont}\Parameter{Element}\\
+ \Macro{usefamilyofkomafont}\Parameter{Element}\\
+ \Macro{useseriesofkomafont}\Parameter{Element}\\
+ \Macro{useshapeofkomafont}\Parameter{Element}
+\end{Declaration}
+\BeginIndex{Cmd}{usefontofkomafont}%
+\BeginIndex{Cmd}{useencodingofkomafont}%
+\BeginIndex{Cmd}{usesizeofkomafont}%
+\BeginIndex{Cmd}{usefamilyofkomafont}%
+\BeginIndex{Cmd}{useseriesofkomafont}%
+\BeginIndex{Cmd}{useshapeofkomafont}%
+Manchmal\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Package{scrextend}} werden in der Schrifteinstellung
+eines Elements auch Dinge vorgenommen, die mit der Schrift eigentlich gar
+nichts zu tun haben, obwohl dies ausdrücklich nicht empfohlen wird. Soll dann
+nur die Schrifteinstellung aber keine dieser zusätzlichen Einstellungen
+ausgeführt werden, so kann statt \Macro{usekomafont} die Anweisung
+\Macro{usefontofkomafont} verwendet werden. Diese Anweisung übernimmt nur die
+Schriftgröße und den Grundlinienabstand, die Codierung
+(engl. \emph{encoding}), die Familie (engl. \emph{family}), die Strichstärke
+oder Ausprägung (engl. \emph{font series}) und die Form oder Ausrichtung
+(engl. \emph{font shape}).
+
+Mit den übrigen Anweisungen können auch einzelne Schriftattribute
+übernommen werden. Dabei übernimmt \Macro{usesizeofkomafont} sowohl die
+Schriftgröße als auch den Grundlinienabstand.
+\EndIndex{Cmd}{useshapeofkomafont}%
+\EndIndex{Cmd}{useseriesofkomafont}%
+\EndIndex{Cmd}{usefamilyofkomafont}%
+\EndIndex{Cmd}{usesizeofkomafont}%
+\EndIndex{Cmd}{useencodingofkomafont}%
+\EndIndex{Cmd}{usefontofkomafont}%
+%
+\EndIndex{}{Schrift>Art}%
+\EndIndex{}{Text>Auszeichnung}
+\fi %***************************************** Ende Langform (nur maincls) *
%%% Local Variables:
%%% mode: latex
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-8.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-8.tex
index b2507a244b1..11360076599 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-8.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-8.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-8.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-8.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{common-8.tex}[2011/09/21 KOMA-Script guide (common paragraphs)]
+\KOMAProvidesFile{common-8.tex}%
+ [$Date: 2013-12-11 20:21:09 +0100 (Mi, 11. Dez 2013) $
+ KOMA-Script guide (common paragraphs)]
\makeatletter
\@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}%
@@ -66,18 +68,22 @@ wurde.
\BeginIndex{}{Seiten>Stil}%
\IfNotCommon{scrlttr2}{Vakatseiten sind Seiten, die beim Satz eines Dokuments
- absichtlich leer bleiben. Ursprünglich sind diese Seiten wirklich komplett
- leer. Bei \LaTeX{} werden sie jedoch in der Voreinstellung mit dem aktuell
- gültigen Seitenstil gesetzt. \KOMAScript{} bietet hier diverse
- Erweiterungen.
+ absichtlich leer bleiben. Bei \LaTeX{} werden sie jedoch in der
+ Voreinstellung mit dem aktuell gültigen Seitenstil gesetzt. \KOMAScript{}
+ bietet hier diverse Erweiterungen.
Vakatseiten findet man hauptsächlich in Büchern. Da es bei Büchern üblich
ist, dass Kapitel auf einer rechten Seite beginnen, muss in dem Fall, dass
das vorherigen Kapitel ebenfalls auf einer rechten Seite endet, eine leere
linke Seite eingefügt werden. Aus dieser Erklärung ergibt sich auch, dass
- Vakatseiten normalerweise nur im doppelseitigen Satz existieren. Die leeren
+ Vakatseiten normalerweise nur im doppelseitigen Satz existieren.
+%
+\iffalse % Umbruchkorrektur
+ Die leeren
Rückseiten im einseitigen Druck werden eher nicht als Vakatseiten
- bezeichnet, obwohl sie auf Druckbögen im Ergebnis als solche erscheinen.}%
+ bezeichnet, obwohl sie auf Druckbögen im Ergebnis als solche erscheinen.
+%
+\fi}%
\fi %**************************************************** Ende nur maincls *
\ifIgnoreThis %+++++++++++++++++++++++++++++++++++++++++++++ nicht maincls +
\IfCommon{scrlttr2}{Aber}
@@ -106,25 +112,27 @@ Mit Hilfe dieser Option\ChangedAt{v3.00}{\Class{scrbook}\and
umbrechen. Als \PName{Seitenstil} sind dabei alle bereits definierten
Seitenstile (siehe \autoref{sec:\csname label@base\endcsname.pagestyle} ab
\autopageref{sec:\csname label@base\endcsname.pagestyle} und
-\autoref{cha:scrpage} ab \autopageref{cha:scrpage}) verwendbar. Daneben ist
-auch \OptionValue{cleardoublepage}{current} möglich. Dieser Fall entspricht
-der Voreinstellung von \KOMAScript{} bis Version~2.98c und führt dazu, dass
-die Vakatseite mit dem Seitenstil erzeugt wird, der beim Einfügen gerade
-aktuell ist. Ab Version~3.00\ChangedAt{v3.00}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}\and \Class{scrlttr2}} werden in der
-Voreinstellung entsprechend der typografischen Gepflogenheiten Vakatseiten mit
-dem Seitenstil \Pagestyle{empty} erzeugt, wenn man nicht Kompatibilität zu
-früheren \KOMAScript-Versionen eingestellt hat (siehe Option \Option{version},
+\autoref{cha:scrlayer-scrpage} ab \autopageref{cha:scrlayer-scrpage}\iffree{
+ beziehungsweise \autoref{cha:scrpage} ab \autopageref{cha:scrpage}}{})
+verwendbar. Daneben ist auch \OptionValue{cleardoublepage}{current}
+möglich. Dieser Fall entspricht der Voreinstellung von \KOMAScript{} bis
+Version~2.98c und führt dazu, dass die Vakatseite mit dem Seitenstil erzeugt
+wird, der beim Einfügen gerade aktuell ist. Ab
+Version~3.00\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Class{scrlttr2}} werden in der Voreinstellung
+entsprechend der typografischen Gepflogenheiten Vakatseiten mit dem Seitenstil
+\Pagestyle{empty} erzeugt, wenn man nicht Kompatibilität zu früheren
+\KOMAScript-Versionen eingestellt hat (siehe Option \Option{version},
\autoref{sec:\csname label@base\endcsname.compatibilityOptions},
\autopageref{desc:\csname label@base\endcsname.option.version}).
\ifCommonmaincls
\begin{Example}
\phantomsection\label{desc:maincls.option.cleardoublepage.example}
Angenommen Sie wollen, dass die Vakatseiten bis auf die Paginierung leer
- sind, also mit Seitenstil \Pagestyle{plain} erzeugt werden. Dies erreichen
- Sie beispielsweise mit
+ sind\iffree{, also mit Seitenstil \Pagestyle{plain} erzeugt werden}{}. Dies
+ erreichen Sie \iffree{beispielsweise }{}mit:
\begin{lstcode}
- \KOMAoption{cleardoublepage=plain}
+ \KOMAoptions{cleardoublepage=plain}
\end{lstcode}
Näheres zum Seitenstil \Pagestyle{plain} ist in
\autoref{sec:maincls.pagestyle}, \autopageref{desc:maincls.pagestyle.plain}
@@ -138,7 +146,7 @@ früheren \KOMAScript-Versionen eingestellt hat (siehe Option \Option{version},
sind, also mit Seitenstil \Pagestyle{plain} erzeugt werden. Dies erreichen
Sie beispielsweise mit
\begin{lstcode}
- \KOMAoption{cleardoublepage=plain}
+ \KOMAoptions{cleardoublepage=plain}
\end{lstcode}
Näheres zum Seitenstil \Pagestyle{plain} ist in
\autoref{sec:maincls.pagestyle}, \autopageref{desc:maincls.pagestyle.plain}
@@ -206,7 +214,8 @@ linken Seite zusätzlich auf \Pagestyle{plain}\IndexPagestyle{plain}, um den %
leer. Will man für die Vakatseite einen eigenen \PName{Seitenstil} vorgeben,
so ist dieser als Argument von \Macro{cleardoubleoddusingstyle}
anzugeben. Dabei kann jeder bereits definierte Seitenstil (siehe auch
-\autoref{cha:scrpage}) verwendet werden.
+\autoref{cha:scrlayer-scrpage}\iffree{ oder \autoref{cha:scrpage}}{})
+verwendet werden.
\IfNotCommon{scrlttr2}{%
Manchmal möchte man nicht, dass Kapitel mit neuen
@@ -302,6 +311,8 @@ erläuterten Anweisungen.
%%% Local Variables:
%%% mode: latex
+%%% mode: flyspell
%%% coding: iso-latin-1
+%%% ispell-local-dictionary: "de_DE"
%%% TeX-master: "../guide"
%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide-ngerman.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide-ngerman.tex
index 840c58d3ee3..bc5cf702c80 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide-ngerman.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide-ngerman.tex
@@ -1,6 +1,6 @@
% ======================================================================
% guide-ngerman.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% guide-ngerman.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -40,13 +40,14 @@
%
% ----------------------------------------------------------------------
%
-% Sprachabhängigkeiten (ngerman) der KOMA-Script-Anleitung
+% Sprachabhaengigkeiten (ngerman) der KOMA-Script-Anleitung
% Verwaltet von Markus Kohm
%
% ======================================================================
%
-\ProvidesFile{guide-ngerman.tex}[{2012/02/26
- KOMA-Script guide language dependencies}]
+\KOMAProvidesFile{guide-ngerman.tex}
+ [$Date: 2013-12-11 08:22:22 +0100 (Mi, 11 Dez 2013) $
+ KOMA-Script guide language dependencies]
%
% \section{Title}
%
@@ -65,33 +66,33 @@
\newcommand*{\GuideTitle}{\KOMAScript}%
\newcommand*{\GuideSubTitle}{ein wandelbares \LaTeXe-Paket}%
\newcommand*{\GuideAuthorHeadline}{Autoren des \KOMAScript-Pakets}%
-\newcommand*{\GuideTranslatorHeadline}{An der deutschen Übersetzung dieser
+\newcommand*{\GuideTranslatorHeadline}{An der deutschen \"Ubersetzung dieser
Anleitung haben mitgewirkt: }
\newcommand*{\GuideWarrantyHeadline}{Rechtliche Hinweise:}%
-\newcommand*{\GuideWarranty}{Die Autoren dieser Anleitung sind in ihrer
- Eigenschaft als Autoren dieser Anleitung nicht verantwortlich für die
+\newcommand*{\GuideWarranty}{Der Autor dieser Anleitung ist in dieser
+ Eigenschaft nicht verantwortlich f\"ur die
Funktion oder Fehler der in dieser Anleitung beschriebenen Software. Bei der
- Erstellung von Texten und Abbildungen wurde mit größter Sorgfalt
- vorgegangen. Trotzdem können Fehler nicht vollständig ausgeschlossen
+ Erstellung von Texten und Abbildungen wurde mit gro\ss er Sorgfalt
+ vorgegangen. Trotzdem k\"onnen Fehler nicht vollst\"andig ausgeschlossen
werden.\par\medskip%
- Die Autoren können jedoch für fehlerhafte Angaben und deren Folgen weder
- eine juristische Verantwortung noch irgendeine Haftung übernehmen. Für
- Verbesserungsvorschläge und Hinweise auf Fehler sind die Autoren
+ Der Autor kann jedoch f\"ur fehlerhafte Angaben und deren Folgen weder
+ eine juristische Verantwortung noch irgendeine Haftung \"ubernehmen. F\"ur
+ Verbesserungsvorschl\"age und Hinweise auf Fehler ist der Autor
dankbar.\par\medskip%
- In dieser Anleitung werden Warennamen ohne der Gewährleistung der freien
+ In dieser Anleitung werden Warennamen ohne der Gew\"ahrleistung der freien
Verwendbarkeit und ohne besondere Kennzeichnung benutzt. Es ist jedoch davon
auszugehen, dass viele der Warennamen gleichzeitig eingetragene
Warenzeichnen oder als solche zu betrachten sind.}%
\newcommand*{\GuideCopyright}{Freie Bildschirm-Version ohne Optimierung des
Umbruchs\par\medskip%
Diese Anleitung ist als Bestandteil von \KOMAScript{} frei im Sinne der
- \LaTeX{} Project Public License Version 1.3c. Eine für \KOMAScript{} gültige
- deutsche Übersetzung liegt \KOMAScript{} in der Datei »\texttt{lppl-de.txt}«
+ \LaTeX{} Project Public License Version 1.3c. Eine f\"ur \KOMAScript{} g\"ultige
+ deutsche \"Ubersetzung liegt \KOMAScript{} in der Datei »\texttt{lppl-de.txt}«
bei. Diese Anleitung --~auch in gedruckter Form~-- darf nur zusammen mit den
- übrigen Bestandteilen von \KOMAScript{} weitergegeben und verteilt werden.
- Eine Verteilung der Anleitung unabhängig von den übrigen Bestandteilen von
- \KOMAScript{} bedarf der ausdrücklichen Genehmigung der
- Autoren.\par\medskip%
+ \"ubrigen Bestandteilen von \KOMAScript{} weitergegeben und verteilt werden.
+ Eine Verteilung der Anleitung unabh\"angig von den \"ubrigen Bestandteilen von
+ \KOMAScript{} bedarf der ausdr\"ucklichen Genehmigung des
+ Autors.\par\medskip%
Eine umbruchoptimierte und erweiterte Ausgabe der \KOMAScript-Anleitung ist
in der dante-Edition von Lehmanns Media erschienen (siehe
\cite{book:komascript}).}%
@@ -112,7 +113,7 @@
%
% \begin{macro}{\GuideCTANserver}
% \begin{macrocode}
-\newcommand*{\GuideCTANserver}{ftp.dante.de}
+\newcommand*{\GuideCTANserver}{mirror.ctan.org}
% \end{macrocode}
% \end{macro}
%
@@ -124,7 +125,7 @@
% \begin{macro}{\GuideClass}
% \begin{macro}{\GuideClassIndexCategory}
% \begin{macro}{\GuideClassIndexCategoryExpanded}
-% The term »class«.
+% The term ``class''.
% \begin{macrocode}
\newcommand*{\GuideClass}{Klasse}
\newcommand*{\GuideClassIndexCategory}{Klassen}
@@ -137,10 +138,10 @@
% \begin{macro}{\GuideCounter}
% \begin{macro}{\GuideCounterIndexCategory}
% \begin{macro}{\GuideCounterIndexCategoryExpanded}
-% The term »counter«.
+% The term ``counter''.
% \begin{macrocode}
-\newcommand*{\GuideCounter}{Zähler}
-\newcommand*{\GuideCounterIndexCategory}{Zähler}
+\newcommand*{\GuideCounter}{Z\"ahler}
+\newcommand*{\GuideCounterIndexCategory}{Z\"ahler}
\let\GuideCounterIndexCategoryExpanded\GuideCounterIndexCategory
% \end{macrocode}
% \end{macro}
@@ -150,7 +151,7 @@
% \begin{macro}{\GuideEnvironment}
% \begin{macro}{\GuideEnvIndexCategory}
% \begin{macro}{\GuideEnvIndexCategoryExpanded}
-% The term »environment«.
+% The term ``environment''.
% \begin{macrocode}
\newcommand*{\GuideEnvironment}{Umgebung}
\newcommand*{\GuideEnvIndexCategory}{Umgebungen}
@@ -161,7 +162,7 @@
% \end{macro}
%
% \begin{macro}{\GuideExample}
-% The term »Example« used at a kind of heading, so it should be upper case.
+% The term ``Example'' used at a kind of heading, so it should be upper case.
% \begin{macrocode}
\newcommand*{\GuideExample}{Beispiel}
% \end{macrocode}
@@ -170,7 +171,7 @@
% \begin{macro}{\GuideFile}
% \begin{macro}{\GuideFileIndexCategory}
% \begin{macro}{\GuideFileIndexCategoryExpanded}
-% The term »file«.
+% The term ``file''.
% \begin{macrocode}
\newcommand*{\GuideFile}{Datei}
\newcommand*{\GuideFileIndexCategory}{Dateien}
@@ -183,7 +184,7 @@
% \begin{macro}{\GuideFloatstyle}
% \begin{macro}{\GuideFloatstyleIndexCategory}
% \begin{macro}{\GuideFloatstyleIndexCategoryExpanded}
-% The term »\Package{float} style«.
+% The term ``\Package{float} style''.
% \begin{macrocode}
\newcommand*{\GuideFloatstyle}{\Package{float}-Stil}
\newcommand*{\GuideFloatstyleIndexCategory}{\Package{float}-Stile}
@@ -196,7 +197,7 @@
% \begin{macro}{\GuideFontElement}
% \begin{macro}{\GuideFontElementIndexCategory}
% \begin{macro}{\GuideFontElementIndexCategoryExpanded}
-% The term »element«.
+% The term ``element''.
% \begin{macrocode}
\newcommand*{\GuideFontElement}{Element}
\newcommand*{\GuideFontElementIndexCategory}{Elemente}
@@ -209,10 +210,10 @@
% \begin{macro}{\GuideLength}
% \begin{macro}{\GuideLengthIndexCategory}
% \begin{macro}{\GuideLengthIndexCategoryExpanded}
-% The term »length«.
+% The term ``length''.
% \begin{macrocode}
-\newcommand*{\GuideLength}{Länge}
-\newcommand*{\GuideLengthIndexCategory}{Längen}
+\newcommand*{\GuideLength}{L\"ange}
+\newcommand*{\GuideLengthIndexCategory}{L\"angen}
\let\GuideLengthIndexCategoryExpanded\GuideLengthIndexCategory
% \end{macrocode}
% \end{macro}
@@ -225,7 +226,7 @@
% \begin{macro}{\GuideCommand}
% \begin{macro}{\GuideCommandIndexCategory}
% \begin{macro}{\GuideCommandIndexCategoryExpanded}
-% The term »command«.
+% The term ``command''.
% \begin{macrocode}
\newcommand*{\GuideMacro}{Befehl}
\let\GuideCommand\GuideMacro
@@ -244,7 +245,7 @@
% \begin{macro}{\GuideOption}
% \begin{macro}{\GuideOptionIndexCategory}
% \begin{macro}{\GuideOptionIndexCategoryExpanded}
-% The term »option«.
+% The term ``option''.
% \begin{macrocode}
\newcommand*{\GuideOption}{Option}
\newcommand*{\GuideOptionIndexCategory}{Optionen}
@@ -257,7 +258,7 @@
% \begin{macro}{\GuidePackage}
% \begin{macro}{\GuidePackageIndexCategory}
% \begin{macro}{\GuidePackageIndexCategoryExpanded}
-% The term »package«.
+% The term ``package''.
% \begin{macrocode}
\newcommand*{\GuidePackage}{Paket}
\newcommand*{\GuidePackageIndexCategory}{Pakete}
@@ -270,7 +271,7 @@
% \begin{macro}{\GuidePagestyle}
% \begin{macro}{\GuidePagestyleIndexCategory}
% \begin{macro}{\GuidePagestyleIndexCategoryExpanded}
-% The term »page style«.
+% The term ``page style''.
% \begin{macrocode}
\newcommand*{\GuidePagestyle}{Seitenstil}
\newcommand*{\GuidePagestyleIndexCategory}{Seitenstile}
@@ -284,11 +285,11 @@
% \begin{macro}{\GuidePLengthIndexCategory}
% \begin{macro}{\GuidePLengthIndexCategoryExpanded}
% \begin{macro}{\GuidePseudoPrefix}
-% The prefix »pseudo« at the term »pseudo length« and the term itself.
+% The prefix ``pseudo'' at the term ``pseudo length'' and the term itself.
% \begin{macrocode}
\newcommand*{\GuidePseudoPrefix}{Pseudo-}
-\newcommand*{\GuidePLength}{Pseudolänge}
-\newcommand*{\GuidePLengthIndexCategory}{Pseudolängen}
+\newcommand*{\GuidePLength}{Pseudol\"ange}
+\newcommand*{\GuidePLengthIndexCategory}{Pseudol\"angen}
\let\GuidePLengthIndexCategoryExpanded\GuidePLengthIndexCategory
% \end{macrocode}
% \end{macro}
@@ -299,7 +300,7 @@
% \begin{macro}{\GuideVariable}
% \begin{macro}{\GuideVariableIndexCategory}
% \begin{macro}{\GuideVariableIndexCategoryExpanded}
-% The term »variable«.
+% The term ``variable''.
% \begin{macrocode}
\newcommand*{\GuideVariable}{Variable}
\newcommand*{\GuideVariableIndexCategory}{Variablen}
@@ -419,7 +420,7 @@
Der Pr\"afix \glqq \url{CTAN://}\grqq{} steht dabei f\"ur das
\TeX-Archiv eines jeden CTAN-Servers oder -Spiegels. Sie k\"onnen
den Pr\"afix beispielsweise durch
- \url{ftp://\GuideCTANserver/tex-archive/} ersetzen. Bei
+ \url{http://\GuideCTANserver/tex-archive/} ersetzen. Bei
\LaTeX-Paketen ist au\ss erdem zu beachten, dass versucht wurde,
die Version anzugeben, auf die im Text Bezug genommen wurde. Bei
einigen Paketen war es mehr ein Ratespiel, eine einheitliche
@@ -519,7 +520,7 @@
\newcommand*{\GuideLanguageExtensions}{%
% \end{macrocode}
% \begin{macro}{\pageautorefname}
-% The term »page« that will be put before the reference of a page set by
+% The term ``page'' that will be put before the reference of a page set by
% |\autopageref|.
% \begin{macrocode}
\let\pageautorefname\pagename
@@ -529,7 +530,7 @@
% \begin{macro}{\subsubsectionautorefname}
% \begin{macro}{\paragraphautorefname}
% \begin{macro}{\subparagraphautorefname}
-% I'll call them all »section«.
+% I'll call them all ``section''.
% \begin{macrocode}
\let\subsectionautorefname=\sectionautorefname
\let\subsubsectionautorefname=\sectionautorefname
@@ -576,5 +577,6 @@
\endinput
%%% Local Variables:
%%% mode: doctex
+%%% coding: iso-latin-1
%%% TeX-master: "../guide.tex"
%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide.tex
index 6fc6a8c55dd..41ba9402133 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/guide.tex
@@ -45,7 +45,7 @@
%
% ======================================================================
-\ProvidesFile{guide.tex}[2012/02/22 KOMA-Script guide main file]
+\ProvidesFile{guide.tex}[2013/10/14 KOMA-Script guide main file]
\documentclass[\languagename]{scrguide}
@@ -95,6 +95,7 @@
\include{scrbookreportarticle}
\include{scrlttr2}
\include{scrpage2}
+\include{scrlayer-scrpage}
\include{scrdatetime}
\include{scraddr}
\include{adrconvnote}
@@ -106,6 +107,9 @@
\include{scrwfile}
\include{tocbasic}
\include{scrhack}
+\include{scrlayer}
+\include{scrlayer-scrpage-experts}
+\include{scrlayer-notecolumn}
\include{typearea-experts}
\include{scrbookreportarticle-experts}
\include{scrlttr2-experts}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/htmlsetup b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/htmlsetup
index e0ccde385ea..92dd812ff4e 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/htmlsetup
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/htmlsetup
@@ -1,6 +1,6 @@
# ======================================================================
# htmlsetup
-# Copyright (c) Markus Kohm, 2002-2009
+# Copyright (c) Markus Kohm, 2002-2013
#
# This file is part of the LaTeX2e KOMA-Script bundle.
#
@@ -18,7 +18,7 @@
# This work consists of all files listed in manifest.txt.
# ----------------------------------------------------------------------
# htmlsetup
-# Copyright (c) Markus Kohm, 2002-2009
+# Copyright (c) Markus Kohm, 2002-2013
#
# Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
# Version 1.3c, verteilt und/oder veraendert werden.
@@ -54,6 +54,7 @@ alt=\"Valid HTML 4.0 Strict\" height=\"31\" width=\"88\"></a>
%titles=( "option" => "Optionen",
"macro" => "Anweisungen",
"environment" => "Umgebungen",
+ "length" => "Längen",
"plength" => "Pseudolängen",
"variable" => "Variablen",
"pagestyle" => "Seitenstile",
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/introduction.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/introduction.tex
index c17cd67d45d..5b0a0cc633e 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/introduction.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/introduction.tex
@@ -1,6 +1,6 @@
% ======================================================================
% introduction.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% introduction.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{introduction.tex}[2012/07/17 KOMA-Script guide introduction]
+\KOMAProvidesFile{introduction.tex}
+ [$Date: 2013-12-11 10:18:01 +0100 (Mi, 11. Dez 2013) $
+ KOMA-Script guide introduction]
\chapter{Einleitung}
\labelbase{introduction}
@@ -53,8 +55,11 @@
Dieses Kapitel enthält \iffree{unter anderem }{}wichtige Informationen über
den Aufbau \iffree{der Anleitung}{des Buches} und die Geschichte von
\KOMAScript, die Jahre vor der ersten Version beginnt. Darüber hinaus finden
-Sie Informationen für den Fall, dass Sie \KOMAScript{} noch nicht installiert
-haben, oder auf Fehler stoßen.
+Sie Informationen für den Fall, dass Sie %
+\iffalse % Umbruchkorreturauslassung
+ \KOMAScript{} noch nicht installiert haben, oder %
+\fi%
+auf Fehler stoßen.
\iffree{%
\section{Vorwort}
@@ -80,17 +85,17 @@ dass {\KOMAScript} in der Regel nicht gelehrt wird. Das heißt, es gibt
keinen Lehrer, der seine Schüler kennt und damit den Unterricht und
das Unterrichtsmaterial entsprechend wählen und anpassen kann. Es wäre
ein Leichtes, die Dokumentation für irgendeine Zielgruppe zu
-verfassen. Die Schwierigkeit, der sich die Autoren gegenüber sehen,
+verfassen. Die Schwierigkeit, der sich der Autor gegenüber sieht,
besteht jedoch darin, dass eine Anleitung für alle möglichen
-Zielgruppen benötigt wird. Wir haben uns bemüht, eine Anleitung zu
+Zielgruppen benötigt wird. Ich habe mich bemüht, eine Anleitung zu
erstellen, die für den Informatiker gleichermaßen geeignet ist wie für
-die Sekretärin des Fischhändlers. Wir haben uns bemüht, obwohl es sich
+die Sekretärin des Fischhändlers. Ich habe mich bemüht, obwohl es sich
dabei eigentlich um ein unmögliches Unterfangen handelt. Ergebnis sind
-zahlreiche Kompromisse. Wir bitten jedoch, die Problematik bei
+zahlreiche Kompromisse. Ich bitte jedoch, die Problematik bei
eventuellen Beschwerden zu berücksichtigen und bei der Verbesserung
-unserer derzeitigen Lösung zu helfen.
+der derzeitigen Lösung zu helfen.
-Trotz des Umfangs der Anleitung bitten wir außerdem darum, im Falle von
+Trotz des Umfangs der Anleitung bitte ich außerdem darum, im Falle von
Problemen zunächst die Dokumentation zu konsultieren. Als erste Anlaufstelle
sei auf den mehrteiligen Index am Ende des \iffree{Dokuments}{Buches}
hingewiesen. \iffree{Zur Dokumentation gehören neben dieser Anleitung auch
@@ -167,10 +172,10 @@ anders angezeigt als \File{Dateinamen}. \Option{Optionen}, \Macro{Anweisungen},
\PLength{Pseudolängen} werden einheitlich hervorgehoben. Der
\PName{Platzhalter} für einen Parameter wird jedoch anders dargestellt als ein
konkreter \PValue{Wert} eines Parameters. So zeigt etwa
-\Macro{begin}\Parameter{Umgebungsname}, wie eine Umgebung ganz allgemein
+\Macro{begin}\Parameter{Umgebung}, wie eine Umgebung ganz allgemein
eingeleitet wird, wohingegen \Macro{begin}\PParameter{document} angibt, wie die
konkrete Umgebung \Environment{document} beginnt. Dabei ist dann
-\PValue{document} ein konkreter Wert für den Parameter \PName{Umgebungsname}
+\PValue{document} ein konkreter Wert für den Parameter \PName{Umgebung}
der Anweisung \Macro{begin}.
\iffalse% Umbruchkorrekturtext
@@ -237,30 +242,27 @@ auch zu lesen.
\section{Danksagung}
\label{sec:introduction.thanks}
-Eine Danksagung in der Einleitung? Gehört sie nicht vielmehr an den Schluss?
-Richtig! Eigentlich gehört die an das Ende. Mein Dank gilt hier jedoch nicht
-primär denjenigen, die diese Anleitung möglich gemacht haben. Für den Dank an
-die Guide-Autoren mache ich den Leser zuständig! Mein persönlicher Dank gilt
-Frank Neukam, ohne dessen \Script-Familie es vermutlich {\KOMAScript} nie
-gegeben hätte. Mein Dank gilt denjenigen, die an der Entstehung von
-{\KOMAScript} und den Anleitungen mitgewirkt haben. Stellvertretend für andere
-möchte ich hier Jens-Uwe Morawski, Torsten Krüger und Gernot Hassenpflug
-nennen. Jens' unermüdlichem Einsatz ist neben vielem Anderen die englische
-Übersetzung der Anleitung zu verdanken, die Gernot in wesentlichen Teilen
-mitgestaltet hat. Torsten ist der beste Betatester, den ich je hatte. Er hat
-damit insbesondere an der Verwendbarkeit von \Class{scrlttr2} und
-\Class{scrpage2} einen erheblichen Anteil. Mein Dank gilt auch allen, die mich
-immer wieder aufgemuntert haben, weiter zu machen und dieses oder jenes noch
-besser, weniger fehlerhaft oder schlicht zusätzlich zu implementieren.
-
-Ganz besonderen Dank bin ich den Gründern von DANTE, Deutschsprachige
-Anwendervereinigung \TeX~e.V\kern-.18em., schuldig, durch die letztlich die
-Verbreitung von \TeX{} und \LaTeX{} und allen Paketen einschließlich
-{\KOMAScript} an einer zentralen Stelle überhaupt ermöglicht wird. In gleicher
-Weise bedanke ich mich bei den aktiven Helfern auf der Mailingliste
-\texttt{\TeX-D-L} (siehe \cite{DANTE:FAQ}) und in der Usenet-Gruppe
-\texttt{de.comp.text.tex}, die mir so manche Antwort auf Fragen zu
-{\KOMAScript} abnehmen.
+Mein persönlicher Dank gilt Frank Neukam, ohne dessen \Script-Familie es
+vermutlich {\KOMAScript} nie gegeben hätte. Mein Dank gilt denjenigen, die an
+der Entstehung von {\KOMAScript} und den Anleitungen mitgewirkt
+haben. Dieses Mal danke ich Elke, Jana, Ben und Edoardo stellvertretend für
+Beta-Test und Kritik. Ich hoffe, ihr macht damit noch weiter.
+
+Ganz besonderen Dank bin ich den Gründern und den Mitgliedern von DANTE,
+Deutschsprachige Anwendervereinigung \TeX~e.V\kern-.18em., schuldig, durch die
+letztlich die Verbreitung von \TeX{} und \LaTeX{} und allen Paketen
+einschließlich {\KOMAScript} an einer zentralen Stelle überhaupt ermöglicht
+wird. In gleicher Weise bedanke ich mich bei den aktiven Helfern auf der
+Mailingliste \texttt{\TeX-D-L} (siehe \cite{DANTE:FAQ})m in der Usenet-Gruppe
+\texttt{de.comp.text.tex} und den vielen \LaTeX-Foren im Internet, die mir so
+manche Antwort auf Fragen zu {\KOMAScript} abnehmen.
+
+Mein Dank gilt aber auch allen, die mich immer wieder aufgemuntert haben,
+weiter zu machen und dieses oder jenes noch besser, weniger fehlerhaft oder
+schlicht zusätzlich zu implementieren. Ganz besonders bedanke ich mich noch
+einmal bei dem äußerst großzügigen Spender, der mich mit dem bisher und
+vermutlich für alle Zeiten größten Einzelbetrag für die bisher geleistete
+Arbeit an \KOMAScript{} bedacht hat.
\section{Rechtliches}
@@ -296,102 +298,101 @@ auch die jeweilige Dokumentation zur installierten \TeX-Distribution.
\label{sec:introduction.errors}
\iffree{%
-Sollten Sie der Meinung sein, dass Sie einen Fehler in der Anleitung,
-einer der \KOMAScript-Klassen, einem der \KOMAScript-Pakete oder einem
-anderen Bestandteil von \KOMAScript{} gefunden haben, so sollten Sie
-wie folgt vorgehen. Prüfen Sie zunächst, ob inzwischen eine neue
-Version von \KOMAScript{} erschienen ist. Installieren Sie diese neue
-Version und kontrollieren Sie, ob der Fehler oder das
-Problem auch dann noch vorhanden ist.
-
-Wenn es sich nicht um einen Fehler in der Dokumentation handelt und
-der Fehler oder das Problem nach einem Update noch immer auf"|tritt,
-erstellen Sie bitte wie in \cite{DANTE:FAQ} angegeben ein minimales
-Beispiel. Gehen Sie dazu wie unten beschrieben vor.
-%Ein solches Beispiel sollte nur einen minimalen Text und
-%nur die Pakete und Definitionen enthalten, die für die Verdeutlichung
-%des Fehlers unbedingt notwendig sind. Auf exotische Pakete sollte
-%möglichst ganz verzichtet werden.
-Oft lässt sich ein Problem durch ein minimales Beispiel so weit
-eingrenzen, dass bereits vom Anwender selbst festgestellt werden kann,
-ob es sich um einen Anwendungsfehler handelt oder nicht. Auch ist so
-sehr häufig zu erkennen, welche Pakete oder Klassen konkret das
-Problem verursachen und ob es sich überhaupt um ein
-\KOMAScript-Problem handelt. Dies können Sie gegebenenfalls
-zusätzlich überprüfen, indem Sie statt einer \KOMAScript-Klasse einen
-Test mit der entsprechenden Standardklasse vornehmen. Danach ist dann
-auch klar, ob der Fehlerbericht an den Autor von \KOMAScript{} oder an
-den Autor eines anderen Pakets zu richten ist. Sie sollten spätestens
-jetzt noch einmal gründlich die Anleitungen der entsprechenden Paket,
-Klassen und \KOMAScript-Bestandteile studieren sowie \cite{DANTE:FAQ}
-konsultieren. Möglicherweise existiert ja bereits eine Lösung für Ihr
-Problem, so dass sich eine Fehlermeldung erübrigt.
-
-Wenn Sie denken, dass Sie einen noch unbekannten Fehler gefunden haben, oder
-es aus anderem Grund für sinnvoll oder notwendig erachten, den
-\KOMAScript-Autor zu kontaktieren, so sollten Sie dabei folgende Angaben
-keinesfalls vergessen:
-\begin{itemize}
-\item Tritt das Problem auch auf, wenn statt einer \KOMAScript-Klasse eine
- Standardklasse verwendet wird? In dem Fall liegt der Fehler höchst
- wahrscheinlich nicht bei \KOMAScript. Es ist dann sinnvoller, die Frage in
- einem öffentlichen Forum, einer Mailingliste oder im Usenet zu stellen.
-\item Welche \KOMAScript-Version verwenden Sie? Entsprechende Informationen
- finden Sie in der \File{log}-Datei des \LaTeX-Laufs jedes Dokuments, das
- eine \KOMAScript-Klasse verwendet.
-\item Welches Betriebssystem und welche \TeX-Distribution wird verwendet?
- Diese Angaben erscheinen bei einem bestriebssystemunabhängigen Paket wie
- \KOMAScript{} oder \LaTeX{} eher überflüssig. Es zeigt sich aber immer
- wieder, dass sie durchaus eine Rolle spielen können.
-\item Was genau ist das Problem oder der Fehler? Beschreiben Sie das Problem
- oder den Fehler lieber zu ausführlich als zu knapp. Oftmals ist es sinnvoll
- auch die Hintergründe zu erläutern.
-\item Wie sieht ein vollständiges Minimalbeispiel aus? Ein solches
- vollständiges Minimalbeispiel kann jeder leicht selbst erstellen, indem
- Schritt für Schritt Inhalte und Pakete aus dem Problemdokument
- auskommentiert werden. Am Ende bleibt ein Dokument, das nur die Pakete lädt
- und nur die Teile enthält, die für das Problem notwendig sind. Außerdem
- sollten alle geladenen Abbildungen durch \Macro{rule}-Anweisungen
- entsprechender Größe ersetzt werden. Vor dem Verschicken entfernt man nun
- die auskommentierten Teile, fügt als erste Zeile die Anweisung
- \Macro{listfiles} ein und führt einen weiteren \LaTeX-Lauf durch. Man erhält
- dann am Ende der \File{log}-Datei eine Übersicht über die verwendeten
- Pakete. Das vollständige Minimalbeispiel und die \File{log}-Datei fügen Sie
- ihrer Beschreibung hinzu.
-\end{itemize}
-Schicken Sie keine Pakete, PDF- oder PS- oder DVI-Dateien mit. Falls die
-gesamte Problem- oder Fehlerbeschreibung einschließlich Minimalbeispiel und
-\File{log}-Datei größer als ein paar Dutzend KByte ist, haben Sie mit größter
-Wahrscheinlichkeit etwas falsch gemacht. Anderenfalls schicken Sie Ihre
-Mitteilung an \href{mailto:komascript@gmx.info}{komascript@gmx.info}.
-
-Häufig werden Sie eine Frage zu \KOMAScript{} oder im Zusammenhang mit
-\KOMAScript{} lieber öffentlich, beispielsweise in \texttt{de.comp.text.tex}
-oder dem Forum auf \cite{homepage}, stellen wollen. Auch in diesem Fall
-sollten Sie obige Punkte beachten, in der Regel jedoch auf die
-\File{log}-Datei verzichten. Fügen Sie stattdessen nur die Liste der Pakete
-und Paketversionen aus der \File{log}-Datei an. Im Falle einer Fehlermeldung
-zitieren Sie diese ebenfalls aus der \File{log}-Datei.%
+ Sollten Sie der Meinung sein, dass Sie einen Fehler in der Anleitung, einer
+ der \KOMAScript-Klassen, einem der \KOMAScript-Pakete oder einem anderen
+ Bestandteil von \KOMAScript{} gefunden haben, so sollten Sie wie folgt
+ vorgehen. Prüfen Sie zunächst, ob inzwischen eine neue Version von
+ \KOMAScript{} erschienen ist. Installieren Sie diese neue Version und
+ kontrollieren Sie, ob der Fehler oder das Problem auch dann noch vorhanden
+ ist.
+
+ Wenn es sich nicht um einen Fehler in der Dokumentation handelt und der
+ Fehler oder das Problem nach einem Update noch immer auf"|tritt, erstellen
+ Sie bitte wie in \cite{DANTE:FAQ} angegeben ein minimales Beispiel. Gehen
+ Sie dazu wie unten beschrieben vor.
+ % Ein solches Beispiel sollte nur einen minimalen Text und nur die Pakete
+ % und Definitionen enthalten, die für die Verdeutlichung des Fehlers
+ % unbedingt notwendig sind. Auf exotische Pakete sollte möglichst ganz
+ % verzichtet werden.
+ Oft lässt sich ein Problem durch ein minimales Beispiel so weit eingrenzen,
+ dass bereits vom Anwender selbst festgestellt werden kann, ob es sich um
+ einen Anwendungsfehler handelt oder nicht. Auch ist so sehr häufig zu
+ erkennen, welche Pakete oder Klassen konkret das Problem verursachen und ob
+ es sich überhaupt um ein \KOMAScript-Problem handelt. Dies können Sie
+ gegebenenfalls zusätzlich überprüfen, indem Sie statt einer
+ \KOMAScript-Klasse einen Test mit der entsprechenden Standardklasse
+ vornehmen. Danach ist dann auch klar, ob der Fehlerbericht an den Autor von
+ \KOMAScript{} oder an den Autor eines anderen Pakets zu richten ist. Sie
+ sollten spätestens jetzt noch einmal gründlich die Anleitungen der
+ entsprechenden Paket, Klassen und \KOMAScript-Bestandteile studieren sowie
+ \cite{DANTE:FAQ} konsultieren. Möglicherweise existiert ja bereits eine
+ Lösung für Ihr Problem, so dass sich eine Fehlermeldung erübrigt.
+
+ Wenn Sie denken, dass Sie einen noch unbekannten Fehler gefunden haben, oder
+ es aus anderem Grund für sinnvoll oder notwendig erachten, den
+ \KOMAScript-Autor zu kontaktieren, so sollten Sie dabei folgende Angaben
+ keinesfalls vergessen:
+ \begin{itemize}
+ \item Tritt das Problem auch auf, wenn statt einer \KOMAScript-Klasse eine
+ Standardklasse verwendet wird? In dem Fall liegt der Fehler höchst
+ wahrscheinlich nicht bei \KOMAScript. Es ist dann sinnvoller, die Frage in
+ einem öffentlichen Forum, einer Mailingliste oder im Usenet zu stellen.
+ \item Welche \KOMAScript-Version verwenden Sie? Entsprechende Informationen
+ finden Sie in der \File{log}-Datei des \LaTeX-Laufs jedes Dokuments, das
+ eine \KOMAScript-Klasse verwendet.
+ \item Welches Betriebssystem und welche \TeX-Distribution wird verwendet?
+ Diese Angaben erscheinen bei einem bestriebssystemunabhängigen Paket wie
+ \KOMAScript{} oder \LaTeX{} eher überflüssig. Es zeigt sich aber immer
+ wieder, dass sie durchaus eine Rolle spielen können.
+ \item Was genau ist das Problem oder der Fehler? Beschreiben Sie das Problem
+ oder den Fehler lieber zu ausführlich als zu knapp. Oftmals ist es
+ sinnvoll auch die Hintergründe zu erläutern.
+ \item Wie sieht ein vollständiges Minimalbeispiel aus? Ein solches
+ vollständiges Minimalbeispiel kann jeder leicht selbst erstellen, indem
+ Schritt für Schritt Inhalte und Pakete aus dem Problemdokument
+ auskommentiert werden. Am Ende bleibt ein Dokument, das nur die Pakete
+ lädt und nur die Teile enthält, die für das Problem notwendig
+ sind. Außerdem sollten alle geladenen Abbildungen durch
+ \Macro{rule}-Anweisungen entsprechender Größe ersetzt werden. Vor dem
+ Verschicken entfernt man nun die auskommentierten Teile, fügt als erste
+ Zeile die Anweisung \Macro{listfiles} ein und führt einen weiteren
+ \LaTeX-Lauf durch. Man erhält dann am Ende der \File{log}-Datei eine
+ Übersicht über die verwendeten Pakete. Das vollständige Minimalbeispiel
+ und die \File{log}-Datei fügen Sie ihrer Beschreibung hinzu.
+ \end{itemize}
+ Schicken Sie keine Pakete, PDF- oder PS- oder DVI-Dateien mit. Falls die
+ gesamte Problem- oder Fehlerbeschreibung einschließlich Minimalbeispiel und
+ \File{log}-Datei größer als ein paar Dutzend KByte ist, haben Sie mit
+ größter Wahrscheinlichkeit etwas falsch gemacht. Anderenfalls schicken Sie
+ Ihre Mitteilung an \href{mailto:komascript@gmx.info}{komascript@gmx.info}.
+
+ Häufig werden Sie eine Frage zu \KOMAScript{} oder im Zusammenhang mit
+ \KOMAScript{} lieber öffentlich, beispielsweise in \texttt{de.comp.text.tex}
+ oder dem Forum auf \cite{homepage}, stellen wollen. Auch in diesem Fall
+ sollten Sie obige Punkte beachten, in der Regel jedoch auf die
+ \File{log}-Datei verzichten. Fügen Sie stattdessen nur die Liste der Pakete
+ und Paketversionen aus der \File{log}-Datei an. Im Falle einer Fehlermeldung
+ zitieren Sie diese ebenfalls aus der \File{log}-Datei.%
}{%
-Die Autoren haben sich größte Mühe gegeben, Fehler in diesem Buch zu
-vermeiden. Die Beispiele, die in diesem Buch abgedruckt sind, wurden
-größtenteils während ihrer Entstehung getestet. Leider sind trotzdem weder
-orthografische noch inhaltliche Fehler komplett auszuschließen. Sollten Sie
-Fehler in diesem Buch finden, so wenden Sie sich bitte an die Autoren. Sie
-können diese per E-Mail über die \KOMAScript-Support-Adresse,
-\mbox{komascript@gmx.info}, oder über \cite{homepage} erreichen.
-
-Wenn Sie hingegen Fehler in \KOMAScript{} selbst melden wollen, so verwenden
-Sie bitte die dafür vorgesehene Prozedur. Diese ist in der Einleitung der
-freien \KOMAScript-Anleitung, die jeder korrekten Verteilung von \KOMAScript{}
-beiliegt, ausführlich erklärt.}
+ Der Autor hat sich große Mühe gegeben, Fehler in diesem Buch zu
+ vermeiden. Die Beispiele, die in diesem Buch abgedruckt sind, wurden
+ größtenteils während ihrer Entstehung getestet. Leider sind trotzdem weder
+ orthografische noch inhaltliche Fehler komplett auszuschließen. Sollten Sie
+ Fehler in diesem Buch finden, so melden Sie diese bitte über die
+ \KOMAScript-Support-Adresse, \mbox{komascript@gmx.info}, oder über
+ \cite{homepage} an den Autor.
+
+ Bei Fehlern an \KOMAScript{} selbst beachten Sie bitte die Prozedur, die in
+ der Einleitung der freien \KOMAScript-Anleitung erklärt ist. Nur so ist
+ sichergestellt, dass das Problem auch reproduziert werden kann. Dies ist
+ für die Beseitigung eventueller Fehler eine Grundvoraussetzung.%
+}
Bitte beachten Sie, dass typografisch nicht optimale Voreinstellungen keine
-Fehler darstellen. Aus Gründen der Langzeit-Kompatibilität werden
-Voreinstellungen nach Möglichkeit auch in neuen \KOMAScript-Versionen
-beibehalten. Darüber hinaus ist Typografie auch eine Frage der Sprache und
-Kultur. Die Voreinstellungen von \KOMAScript{} stellen daher zwangsläufig
-einen Kompromiss dar.
+Fehler darstellen. Aus Gründen der Kompatibilität werden Voreinstellungen nach
+Möglichkeit auch in neuen \KOMAScript-Versionen beibehalten. Darüber hinaus
+ist Typografie auch eine Frage der Sprache und Kultur. Die Voreinstellungen
+von \KOMAScript{} stellen daher zwangsläufig einen Kompromiss dar.
\iffree{%
\section{Weitere Informationen}
@@ -409,6 +410,8 @@ konzipiert. Für Anfänger sind sie wenig oder nicht geeignet.
\endinput
%%% Local Variables:
%%% mode: latex
+%%% mode: flyspell
%%% coding: iso-latin-1
+%%% ispell-local-dictionary: "de_DE"
%%% TeX-master: "../guide.tex"
%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbase.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbase.tex
index 12b94fb89c6..0f84bda93e0 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbase.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbase.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrbase.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrbase.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ======================================================================
-\ProvidesFile{scrbase.tex}[2012/03/04 KOMA-Script package scrbase]
+\KOMAProvidesFile{scrbase.tex}
+ [$Date: 2013-11-06 12:44:59 +0100 (Mi, 06. Nov 2013) $
+ KOMA-Script package scrbase]
\chapter{Grundlegende Funktionen im Paket \Package{scrbase}}
\labelbase{scrbase}
@@ -186,10 +188,20 @@ Pakete im Gesamtpaket als Mitglied zu verwenden.
\EndIndex{Cmd}{DefineFamily}%
\BeginIndex{Cmd}{DefineFamilyKey}%
+\BeginIndex{Cmd}{FamilyKeyState}%
+\BeginIndex{Cmd}{FamilyKeyStateUnknown}%
+\BeginIndex{Cmd}{FamilyKeyStateProcessed}%
+\BeginIndex{Cmd}{FamilyKeyStateUnknownValue}%
+\BeginIndex{Cmd}{FamilyKeyStateNeedValue}%
\begin{Declaration}
\Macro{DefineFamilyKey}\OParameter{Mitglied}\Parameter{Familie}%
\Parameter{Schlüssel}\OParameter{Säumniswert}\\
- \hphantom{\Macro{DefineFamilyKey}}\Parameter{Aktion}
+ \hphantom{\Macro{DefineFamilyKey}}\Parameter{Aktion}\\
+ \Macro{FamilyKeyState}\\
+ \Macro{FamilyKeyStateUnknown}\\
+ \Macro{FamilyKeyStateProcessed}\\
+ \Macro{FamilyKeyStateUnknownValue}\\
+ \Macro{FamilyKeyStateNeedValue}
\end{Declaration}
Mit dieser Anweisung wird ein \PName{Schlüssel} definiert. Ist ein
\PName{Mitglied} angegeben, so ist der \PName{Schlüssel} eine Eigenschaft
@@ -202,6 +214,7 @@ ausgeführt, wobei der Wert als Parameter übergeben wird. Innerhalb von
kein Wert übergeben, so wird stattdessen der \PName{Säumniswert}
eingesetzt. Falls kein \PName{Säumniswert} angegeben wird, kann später der
\PName{Schlüssel} nur mit Wertübergabe verwendet werden.
+
\begin{Explain}
\phantomsection\label{explain:scrbase.macro.DefineFamilyKey}%
Letztlich führt
@@ -209,41 +222,50 @@ eingesetzt. Falls kein \PName{Säumniswert} angegeben wird, kann später der
\DefineFamilyKey[»\PName{Mitglied}«]{»\PName{Familie}«}{»\PName{Schlüssel}«}
[»\PName{Säumniswert}«]{»\PName{Aktion}«}
\end{lstcode}
-\iffalse% oder so
- \begin{flushleft}\begin{tabular}{l@{}l}
- \Macro{DefineFamilyKey}&\OParameter{Mitglied}\Parameter{Familie}%
- \Parameter{Schlüssel}\\
- &\OParameter{Säumniswert}\Parameter{Aktion}
- \end{tabular}\end{flushleft}
-\fi
zu dem Aufruf
\begin{lstcode}[moretexcs={define@key},escapeinside=»«]
\define@key{»\PName{Familie\,Mitglied}«}{»\PName{Schlüssel}«}
- [»\PName{Säumniswert}«]{»\PName{Aktion}«}
+ [»\PName{Säumniswert}«]{»\PName{erweiterte Aktion}«}
\end{lstcode}
-\iffalse% oder so
- \begin{flushleft}\begin{tabular}{l@{}l}
- \Macro{define@key}&\Parameter{Familie\,Mitglied}%
- \Parameter{Schlüssel}\\
- &\OParameter{Säumniswert}\Parameter{Aktion}
- \end{tabular}\end{flushleft}
-\fi
wobei \Macro{define@key} im \Package{keyval}-Paket\IndexPackage{keyval}
- definiert ist (siehe \cite{package:keyval}).
-\iffalse% Umbruchkorrektur
- Prinzipiell könnte daher dem
- Schlüssel eines Familienmitglieds per
-\begin{lstcode}[moretexcs={setkeys},escapeinside=»«]
- \setkeys{»\PName{Familie\,Mitglied}«}{»\PName{Schlüssel}«=»\PName{Wert}«}
-\end{lstcode}
-\iffalse% oder so
- \begin{flushleft}\begin{tabular}{l@{}l}
- \Macro{setkeys}&\Parameter{Familie\,Mitglied}\Parameter{Schlüssel=Wert}
- \end{tabular}\end{flushleft}
-\fi
- ein Wert zugewiesen werden.
-\fi
+ definiert ist (siehe \cite{package:keyval}). Allerdings kommen zu dem Aufruf
+ von \Macro{define@key} noch einige zusätzliche Vorkehrungen und auch die
+ \PName{Aktion} wird um zusätzliche Vorkehrungen erweitert.
\end{Explain}
+
+Erfolg\ChangedAt{v3.12}{\Package{scrbase}} oder Misserfolg der Ausführung der
+\PName{Aktion} werden über \Macro{FamilyKeyState} an \Package{scrbase} zurück
+gemeldet, damit dieses je nach Bedarf und Verwendung der Option weitere
+Maßnahmen ergreifen kann. In der Voreinstellung ist \Macro{FamilyKeyState}
+identisch mit \Macro{FamilyKeyStateUnknown}. Das bedeutet, dass es nicht
+sicher ist, ob die Option korrekt verarbeitet werden konnte. Findet
+\Package{scrbase} nach Ausführung der \PName{Aktion} noch immer diesen Zustand
+vor, so wird ein Hinweis in die \File{log}-Datei geschrieben und im weiteren
+der Zustand \Macro{FamilyKeyStateProcessed} angenommen.
+
+Der Zustand \Macro{FamilyKeyStateProcessed} signalisiert, dass die Option und
+die Wertzuweisung an die Option vollständig abgeschlossen wurde und alles in
+Ordnung ist. Auf den Zustand kann einfach durch Aufruf von
+\Macro{FamilyKeyStateProcessed} selbst umgeschaltet werden.
+
+Der Zustand \Macro{FamilyKeyStateUnknownValue} signalisiert, dass die Option
+zwar verarbeitet wurde, ihr jedoch ein Wert zugewiesen werden sollte, der
+nicht erlaubt ist. Diesen Zustand meldet beispielsweise \Package{typearea},
+wenn versucht wird, an Option \Option{twoside} den Wert \PValue{unbekannt}
+zuzuweisen. Die Umschaltung auf den Zustand erfolgt einfach durch Aufruf von
+\Macro{FamilyKeyStateUnknownValue} selbst.
+
+Der Zustand \Macro{FamilyKeyStateNeedValue} signalisiert, dass die Option nicht
+verarbeitet werden konnte, weil sie zwingend einen Wert erwartet, sie aber
+ohne Wertzuweisung aufgerufen wurde. Dieser Zustand wird automatisch gesetzt,
+wenn eine Option, die keinen \PName{Säumniswert} besitzt, ohne Wertzuweisung
+verwendet wird. Theoretisch wäre aber auch eine explizite Umschaltung darauf
+durch Aufruf von \Macro{FamilyKeyStateNeedValue} selbst möglich.
+
+Desweiteren können zusätzliche Fehlerzustände definiert werden, indem man
+\Macro{FamilyKeyState} auf eine kurze Meldung umdefiniert. In der Regel
+sollten jedoch die vier vordefinierten Zustände verwendet werden.
+
\begin{Example}
Nehmen wir an, jedes der drei Pakete aus dem letzten Beispiel soll einen
Schlüssel \PValue{Aufschnitt} erhalten. Wird dieser aufgerufen, so soll in
@@ -256,19 +278,27 @@ eingesetzt. Falls kein \PName{Säumniswert} angegeben wird, kann später der
{Aufschnitt}[true]{%
\expandafter\let\expandafter\if@Salami@Aufschnitt
\csname if#1\endcsname
+ \FamilyKeyStateProcessed
}
\end{lstcode}
Als Wert sind daher beim Aufruf \PValue{true} oder \PValue{false}
erlaubt. Ein Test auf unerlaubte Werte existiert in diesem Beispiel
- nicht. Wird der Schlüssel später verwendet, so muss entweder einer der
- erlaubten Werte zugewiesen oder ein Aufruf ohne Wertzuweisung verwendet
- werden. In letzterem Fall wird der Säumniswert \PName{true} zugewiesen.
+ nicht. Stattdessen wird immer zurück gemeldet, dass die Option vollständig
+ und korrekt verarbeitet wwurde. Wird der Schlüssel später verwendet, so muss
+ entweder einer der erlaubten Werte zugewiesen oder ein Aufruf ohne
+ Wertzuweisung verwendet werden. In letzterem Fall wird der Säumniswert
+ \PName{true} zugewiesen.
Für die anderen beiden Pakete kann das fast identisch definiert
werden. Lediglich die Zeichenfolge »\texttt{Salami}« ist jeweils zu
ersetzen.
\end{Example}
%
+\EndIndex{Cmd}{FamilyKeyStateNeedValue}%
+\EndIndex{Cmd}{FamilyKeyStateUnknownValue}%
+\EndIndex{Cmd}{FamilyKeyStateProcessed}%
+\EndIndex{Cmd}{FamilyKeyStateUnknown}%
+\EndIndex{Cmd}{FamilyKeyState}%
\EndIndex{Cmd}{DefineFamilyKey}%
@@ -313,6 +343,11 @@ Man kann \Macro{FamilyProcessOptions} wahlweise als Erweiterung von
\PName{Schlüssel=Wert}-Mechanismus von \Package{keyval} verstehen. Letztlich
werden mit Hilfe von \Macro{FamilyProcessOptions} aus
\PName{Schlüssel=Wert}-Paaren Optionen.
+
+Während der Ausführung von Optionen darf \Macro{FamilyProcessOptions} nicht
+verwendet werden. Es ist also insbesondere nicht erlaubt, innerhalb der
+Ausführung von Optionen Pakete zu laden, die selbst
+\Macro{FamilyProcessOptions} verwenden.%
%
\EndIndex{Cmd}{FamilyProcessOptions}%
@@ -343,16 +378,16 @@ Mitglieds gesetzt wird.
\end{lstcode}
ergänzt werden.
\end{Example}
+
+Diese Anweisung darf auch innerhalb dere Ausführung von Optionen verwendet
+werden.%
%
\EndIndex{Cmd}{FamilyExecuteOptions}%
\BeginIndex{Cmd}{FamilyOptions}%
-\BeginIndex{Cmd}{Family@Options}%
\begin{Declaration}
- \Macro{FamilyOptions}\Parameter{Familie}\Parameter{Optionenliste}\\
- \Macro{Family@Options}\Parameter{Familie}\Parameter{Optionenliste}%
- \Parameter{Fehleraktion}
+ \Macro{FamilyOptions}\Parameter{Familie}\Parameter{Optionenliste}%
\end{Declaration}
Die \PName{Optionenliste} hat dabei die Form:
\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
@@ -371,9 +406,9 @@ Eigenschaft der Familie selbst, so wird dieser Familien-Schlüssel zuerst
gesetzt. Danach folgen die Mitglieder-Schlüssel in der Reihenfolge, in der die
Mitglieder definiert wurden. Existiert ein angegebener \PName{Schlüssel} weder
für die Familie noch für ein Mitglied der Familie, so wird von
-\Macro{FamilyOptions} ein Fehler ausgegeben. Bei \Macro{Family@Options} kann
-man hingegen die Fehleraktion selbst wählen. Diese interne Anweisung ist
-Klassen- und Paketautoren vorbehalten.
+\Macro{FamilyOptions} ein Fehler ausgegeben. Dies geschieht ebenfalls, wenn
+zwar für einige Mitglieder ein Schlüssel existiert, jedoch jedes dieser
+Mitglieder über \Macro{FamilyKeyState} einen Fehler zurückmeldet.
\begin{Example}
Sie ergänzen das Fleischermeister-Projekt um ein weiteres Paket
\Package{Wurstsalat}. Wird dieses Paket verwendet, so sollen alle
@@ -408,16 +443,12 @@ Klassen- und Paketautoren vorbehalten.
ist, wird nun auch gleich noch eine Warnung ausgegeben.
\end{Example}
%
-\EndIndex{Cmd}{Family@Options}%
\EndIndex{Cmd}{FamilyOptions}%
\BeginIndex{Cmd}{FamilyOption}%
-\BeginIndex{Cmd}{Family@Option}%
\begin{Declaration}
\Macro{FamilyOption}\Parameter{Familie}%
- \Parameter{Option}\Parameter{Werteliste}\\
- \Macro{Family@Option}\Parameter{Familie}%
- \Parameter{Option}\Parameter{Werteliste}\Parameter{Fehleraktion}
+ \Parameter{Option}\Parameter{Werteliste}%
\end{Declaration}
Neben Optionen, die sich gegenseitig ausschließende Werte besitzen, kann es
auch Optionen geben, die gleichzeitig mehrere Werte annehmen können. Für diese
@@ -432,7 +463,7 @@ einzigen \PName{Option} eine ganze \PName{Werteliste} zuweisen. Die
In diesem Zusammenhang sei darauf hingewiesen, dass die Verwendung eines
Kommas in einem Wert möglich ist, wenn man den Wert in geschweifte Klammern
setzt. Die weiteren Funktionsweise ist der vorhergehenden Erklärung zu
-\Macro{FamilyOptions} und \Macro{Family@Options} zu entnehmen.
+\Macro{FamilyOptions} zu entnehmen.
\begin{Example}
Das Paket \Package{Wurstsalat} soll eine Option bekommen, über die man
weitere Zutaten bestimmen kann. Für jede Zutat wird dabei wieder ein
@@ -462,9 +493,25 @@ setzt. Die weiteren Funktionsweise ist der vorhergehenden Erklärung zu
verwenden.
\end{Example}
%
-\EndIndex{Cmd}{Family@Option}%
\EndIndex{Cmd}{FamilyOption}%
+
+\begin{Declaration}
+ \Macro{AtEndOfFamilyOptions}\Parameter{Aktion}%
+\end{Declaration}
+\BeginIndex{Cmd}{AtEndOfFamilyOptions}%
+Manchmal\ChangedAt{v3.12}{\Package{scrbase}} ist es vorteilhafter, wenn nicht
+jede Wertzuweisung an eine Option eine \PName{Aktion} auslöst, sondern dies
+erst geschieht, wenn alle Wertzuweisungen innerhalb eines Aufrufs von
+\Macro{FamilyProcessOptions}, \Macro{FamilyExecuteOptions},
+\Macro{FamilyOptions} oder \Macro{FamilyOption} abgeschlossen sind. Genau dies
+ist mit Hilfe von \Macro{AtEndOfFamilyOptions} möglich. Die Rückmeldung von
+Fehlerzuständen ist über diese Anweisung jedoch ebenso wenig möglich, wie die
+Verwendung dieser Anweisung außerhalb der Ausführung von Optionen.
+%
+\EndIndex{Cmd}{AtEndOfFamilyOptions}%
+
+
\BeginIndex{Cmd}{FamilyBoolKey}%
\BeginIndex{Cmd}{FamilySetBool}%
\begin{Declaration}
@@ -489,14 +536,16 @@ definiert und mit \PName{false} voreingestellt. Intern verwendet
\Macro{DefineFamilyKey}. Der Säumniswert für eine solche Option ist immer
\PValue{true}.
-\Macro{FamilySetBool} wiederum versteht als \PName{Wert} neben
-\PValue{true} auch die Werte \PValue{on} und \PValue{yes} zum Einschalten und
-neben \PValue{false} auch die Werte \PValue{off} und \PValue{no} zum
+\Macro{FamilySetBool} wiederum versteht als \PName{Wert} neben \PValue{true}
+auch die Werte \PValue{on} und \PValue{yes} zum Einschalten und neben
+\PValue{false} auch die Werte \PValue{off} und \PValue{no} zum
Ausschalten. Wird ein unbekannter Wert übergeben, so wird die Anweisung
\Macro{FamilyUnkownKeyValue} mit den Argumenten \PName{Familie},
-\PName{Schlüssel} und \PName{Wert} aufgerufen. Dadurch wird dann eine
-Fehlermeldung über unbekannte Wertzuweisung ausgegeben (siehe auch
-\autopageref{desc:scrbase.cmd.FamilyUnkownKeyValue}).
+\PName{Schlüssel} und \PName{Wert} aufgerufen und so \Macro{FamilyKeyState}
+entsprechend gesetzt. Dadurch wird dann gegebenenfalls eine Meldung über
+unbekannte Wertzuweisung ausgegeben (siehe auch
+\autopageref{desc:scrbase.cmd.FamilyUnkownKeyValue} und
+\autopageref{desc:scrbase.cmd.FamilyKeyState}).
\begin{Example}
Der Schlüssel \Option{Aufschnitt} soll in den Wurstpaketen etwas robuster
definiert werden. Außerdem sollen alle Wurstpakete denselben Schalter
@@ -521,7 +570,7 @@ Fehlermeldung über unbekannte Wertzuweisung ausgegeben (siehe auch
\@ifundefined{if@Aufschnitt}{%
\expandafter\newif\csname if@Aufschnitt\endcsname
}{}%
- \define@key{Fleischermeister}{Aufschnitt}[true]{%
+ \DefineFamilyKey[]{Fleischermeister}{Aufschnitt}[true]{%
\FamilySetBool{Fleischermeister}{Aufschnitt}%
{@Aufschnitt}%
{#1}%
@@ -536,11 +585,29 @@ Fehlermeldung über unbekannte Wertzuweisung ausgegeben (siehe auch
\autopageref{explain:scrbase.macro.DefineFamilyKey}, der nicht nur für
\Macro{DefineFamilyKey}, sondern entsprechend auch für \Macro{FamilyBoolKey}
gilt.
+
+ Da \Macro{FamilyKeyState} bereits von \Macro{FamilySetBool} gesetzt wird,
+ kann innerhalb der Definition der Option mit Hilfe von
+ \Macro{DefineFamilyKey} der Status gegebenenfalls auch abgefragt werden. So
+ könnte man im ersten Fall beispielsweise nach \Macro{FamilySetBool} einen
+ Test der Art:
+\begin{lstcode}
+ \ifx\FamilyKeyState\FamilyKeyStateProcessed
+ ...
+ \else
+ ...
+ \fi
+\end{lstcode}
+ zusätzliche Aktionen in Abhängigkeit davon, ob \Macro{FamilySetBool}
+ erfolgreich war oder nicht, ausführen. Es ist zu beachten, dass an dieser
+ Stelle unbedingt ein Test mit Hilfe von \Macro{ifx} vorzunehmen
+ ist. Expandierende Tests wie \Macro{ifstr} sind hier zu vermeiden.
\end{Example}
%
\EndIndex{Cmd}{FamilySetBool}%
\EndIndex{Cmd}{FamilyBoolKey}
+
\BeginIndex{Cmd}{FamilyNumericalKey}%
\BeginIndex{Cmd}{FamilySetNumerical}%
\begin{Declaration}
@@ -632,6 +699,9 @@ Schlüssel ein unbekannter Wert übergeben, so wird von
Argumenten \PName{Familie}, \PName{Schlüssel} und \PName{Wert}
aufgerufen. Dadurch wird dann eine Fehlermeldung über unbekannte Wertzuweisung
ausgegeben.
+
+Beim Aufruf von \Macro{FamilySetNumerical} wird wiederum auch der Erfolg oder
+Misserfolg automatisch via \Macro{FamilyKeyState} signalisiert.
%
\EndIndex{Cmd}{FamilySetNumerical}%
\EndIndex{Cmd}{FamilyNumericalKey}%
@@ -660,7 +730,8 @@ das optionale Argument für den \PName{Säumniswert} so entspricht der Aufruf
\Parameter{Schlüssel}\\
\hphantom{\Macro{DefineFamilyKey}}%
\OParameter{Säumniswert}%
-\PParameter{\Macro{def}\PName{Makro}\string{\#1\string}}.
+\PParameter{\Macro{def}\PName{Makro}\string{\#1\string}%
+\Macro{FamilyKeyStateProcessed}}.
\end{quote}
Ist
\PName{Makro} noch nicht definiert, so wird es als leeres Makro definiert.
@@ -691,27 +762,19 @@ Wertzuweisung an den Schlüssel keine Absätze enthalten sein dürfen.
\EndIndex{Cmd}{FamilyStringKey}%
\BeginIndex{Cmd}{FamilyUnkownKeyValue}%
-\BeginIndex{Cmd}{FamilyElseValues}%
\begin{Declaration}
\Macro{FamilyUnkownKeyValue}\Parameter{Familie}\Parameter{Schlüssel}%
- \Parameter{Wert}\Parameter{Werteliste}\\
- \Macro{FamilyElseValues}
+ \Parameter{Wert}\Parameter{Werteliste}
\end{Declaration}
-Die Anweisung \Macro{FamilyUnkownKeyValue} gibt eine Fehlermeldung über einen
-unbekannten Wert für einen bekannten Schlüssel aus. Als \PName{Werteliste}
+Die Anweisung \Macro{FamilyUnkownKeyValue} signalisiert über
+\Macro{FamilyKeyState} einen Fehler aufgrund eines unbekannten oder
+unerlaubten Werts. Als \PName{Werteliste}
wird dabei eine durch Komma separierte Liste von erlaubten Werten der Form
\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
`\PName{Wert}'\texttt{,} `\PName{Wert}' \dots
\end{tabular}\vskip\dp\strutbox\end{flushleft}
-erwartet. Darüber hinaus kann die Anweisung \Macro{FamilyElseValues} weitere
-erlaubte Werte in der Form
-\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
- \texttt{,} `\PName{Wert}'\texttt{,} `\PName{Wert}' \dots
-\end{tabular}\vskip\dp\strutbox\end{flushleft}
-enthalten, die dann ebenfalls in der Fehlermeldung mit ausgegeben werden. Sowohl
-\Macro{FamilySetBool} als auch \Macro{FamilySetNumerical} leeren das
-Makro \Macro{FamilyElseValues} am Ende automatisch -- unabhängig davon, ob ein
-Fehler zu melden war oder nicht.
+erwartet. Allerdings\ChangedAt{v3.12}{\Package{scrbase}} wird die
+\PName{Werteliste} derzeit nicht ausgewertet.
\begin{Example}
Für den Aufschnitt soll nun zusätzlich wählbar sein, ob er grob oder
fein geschnitten werden soll. Dabei ist grob die Voreinstellung, die auch
@@ -726,26 +789,56 @@ Fehler zu melden war oder nicht.
\newif\csname if@Aufschnitt\endcsname}{}
\DefineFamilyKey{Fleischermeister}%
{Aufschnitt}[true]{%
- \ifstr{#1}{fein}{%
- \@Aufschnitttrue
- \@Feinschnittrue
- }{%
+ \FamilySetBool{Fleischermeister}{Aufschnitt}%
+ {@Aufschnitt}%
+ {#1}%
+ \ifx\FamilyKeyState\FamilyKeyStateProcessed
\@Feinschnittfalse
- \def\FamilyElseValue{, `fein'}%
- \FamilySetBool{Fleischermeister}{Aufschnitt}%
- {@Aufschnitt}%
- {#1}%
- }%
+ \else
+ \ifstr{#1}{fein}{%
+ \@Aufschnitttrue
+ \@Feinschnittrue
+ \FamilyKeyStateProcessed
+ }{}%
+ \fi
}%
\end{lstcode}
- Die hierbei verwendete Anweisung \Macro{ifstr} ist auf
+ Hier wird zunächst versucht, den boolschen Schalter für Aufschnitt über
+ \Macro{FamilySetBool} zu setzen. Wenn dies über \Macro{FamilyKeyState} den
+ Erfolgs-Status \Macro{FamilyKeyStateProcessed} zurück liefert, wird nur noch
+ der Feinschnitt abgeschaltet. Anderenfalls wird überprüft, ob als Wert
+ keiner für den boolschen Schalter, sondern \PValue{fein} übergeben wurde. In
+ diesem Fall wird sowohl der Feinschnitt, als auch Aufschnitt aktiviert und
+ mit Hilfe von \Macro{FamilyKeyStateProcessed} der Erfolgs-Status
+ gesetzt. Ist auch das nicht der Fall, bleibt der von \Macro{FamilySetBool}
+ signalisierte Fehler-Zustand bestehen.
+
+ Die bei den Tests verwendete Anweisung \Macro{ifstr} ist auf
\autopageref{desc:scrbase.cmd.ifstr} in \autoref{sec:scrbase.if}
erklärt.
\end{Example}
%
-\EndIndex{Cmd}{FamilyElseValues}%
\EndIndex{Cmd}{FamilyUnkownKeyValue}%
+\BeginIndex{Cmd}{FamilyElseValues}%
+\begin{Declaration}
+ \Macro{FamilyElseValues}
+\end{Declaration}
+In\ChangedAt{v3.12}{\Package{scrbase}} früheren Versionen von
+\Package{scrbase} konnte man über die Anweisung \Macro{FamilyElseValues} weitere
+erlaubte Werte für die Bearbeitung durch \Macro{FamilyUnknownValue} in der Form
+\begin{flushleft}\vskip\dp\strutbox\begin{tabular}{l}
+ \texttt{,} `\PName{Wert}'\texttt{,} `\PName{Wert}' \dots
+\end{tabular}\vskip\dp\strutbox\end{flushleft}
+ablegen, die dann ebenfalls in einer Fehlermeldung mit ausgegeben wurden. Seit
+Version~3.12 gibt \Macro{FamilyUnknownValue} selbst keine Fehlermeldungen mehr
+aus, sondern setzt nur noch \Macro{FamilyKeyState} entsprechend. Damit ist die
+Verwendung von \Macro{FamilyElseValue} ebenfalls überholt. Ihre Verwendung
+wird jedoch erkannt und führt dann zu einer Aufforderung, den Code
+entsprechend anzupassen.
+%
+\EndIndex{Cmd}{FamilyElseValues}%
+
\section{Verzweigungen}
\label{sec:scrbase.if}
@@ -905,6 +998,139 @@ interne Variante.
%
\EndIndex{Cmd}{ifstr}
+\begin{Declaration}
+ \Macro{ifstrstart}\Parameter{Zeichenfolge}\Parameter{Zeichenfolge}%
+ \Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+\end{Declaration}
+\BeginIndex{Cmd}{ifstrstart}%
+Die\ChangedAt{v3.12}{\Package{scrbase}} beiden Argumente \PName{Zeichenfolge}
+werden expandiert und dann verglichen. Beginnt die erste Zeichenfolge von
+Leerzeichen abgesehen mit der zweiten Zeichenfolge, so wird der
+\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Von dieser
+Anweisung gibt es keine interne Variante.%
+\EndIndex{Cmd}{ifstrstart}%
+
+\begin{Declaration}
+ \Macro{ifisdimen}\Parameter{Code}\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+\end{Declaration}
+\BeginIndex{Cmd}{ifisdimen}%
+Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
+einem \Macro{dimen}, also einem \TeX-Längenregister, resultiert, wird der
+\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Die
+Anweisung ist nicht voll expandierbar. Von dieser
+Anweisung gibt es keine interne Variante.%
+\EndIndex{Cmd}{ifisdimen}%
+
+\begin{Declaration}
+ \Macro{ifisdimension}\Parameter{Code}%
+ \Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+\end{Declaration}
+\BeginIndex{Cmd}{ifisdimension}%
+Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
+etwas resultiert, das syntaktisch dem Wert einer Länge entspricht, wird der
+\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Es ist zu
+beachten,\textnote{Achtung!} dass derzeit unbekannte Einheiten zu einer
+Fehlermeldung führen. Die Anweisung ist nicht voll expandierbar. Von dieser
+Anweisung gibt es keine interne Variante.%
+\EndIndex{Cmd}{ifisdimension}%
+
+\begin{Declaration}
+ \Macro{ifisdimexpr}\Parameter{Code}\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+\end{Declaration}
+\BeginIndex{Cmd}{ifisdimexpr}%
+Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
+einer \Macro{dimexpr}, also einem \TeX-Längenausdruck resultiert, wird der
+\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Es ist zu
+beachten,\textnote{Achtung!} dass fehlerhafte Ausdrücke zu Fehlermeldungen
+führen! Die Anweisung ist nicht voll expandierbar. Von dieser
+Anweisung gibt es keine interne Variante.%
+\EndIndex{Cmd}{ifisdimexpr}%
+
+\begin{Declaration}
+ \Macro{ifisskip}\Parameter{Code}\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+\end{Declaration}
+\BeginIndex{Cmd}{ifisskip}%
+Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
+einem \Macro{skip}, also einem \TeX-Abstand, resultiert, wird der
+\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Die
+Anweisung ist nicht voll expandierbar. Von dieser
+Anweisung gibt es keine interne Variante.%
+\EndIndex{Cmd}{ifisskip}%
+
+\begin{Declaration}
+ \Macro{ifisglue}\Parameter{Code}%
+ \Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+\end{Declaration}
+\BeginIndex{Cmd}{ifisglue}%
+Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
+etwas resultiert, das syntaktisch dem Wert eines Abstandes entspricht, wird der
+\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Es ist zu
+beachten,\textnote{Achtung!} dass derzeit unbekannte Einheiten zu einer
+Fehlermeldung führen. Die Anweisung ist nicht voll expandierbar. Von dieser
+Anweisung gibt es keine interne Variante.%
+\EndIndex{Cmd}{ifisglue}%
+
+\begin{Declaration}
+ \Macro{ifisglueexpr}\Parameter{Code}%
+ \Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+\end{Declaration}
+\BeginIndex{Cmd}{ifisglueexpr}%
+Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
+einer \Macro{glueexpr}, also einem \TeX-Abstandsausdruck resultiert, wird der
+\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Es ist zu
+beachten,\textnote{Achtung!} dass fehlerhafte Ausdrücke zu Fehlermeldungen
+führen! Die Anweisung ist nicht voll expandierbar. Von dieser
+Anweisung gibt es keine interne Variante.%
+\EndIndex{Cmd}{ifisglueexpr}%
+
+\begin{Declaration}
+ \Macro{ifiscount}\Parameter{Code}\Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+\end{Declaration}
+\BeginIndex{Cmd}{ifiscount}%
+Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
+einem \Macro{count}, also einem \TeX-Zähler, resultiert, wird der
+\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Die
+Anweisung ist nicht voll expandierbar. Für einen Test auf einen \LaTeX-Zähler
+siehe \Macro{ifiscounter}. Von dieser
+Anweisung gibt es keine interne Variante.%
+\EndIndex{Cmd}{ifiscount}%
+
+\begin{Declaration}
+ \Macro{ifisnumber}\Parameter{Code}%
+ \Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+\end{Declaration}
+\BeginIndex{Cmd}{ifisnumber}%
+Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
+etwas resultiert, das syntaktisch dem Wert eines Zählers entspricht, also eine
+negative oder positive ganze Zahl ist, wird der \PName{Dann-Teil} ausgeführt,
+anderenfalls der \PName{Sonst-Teil}. Die Anweisung ist nicht voll
+expandierbar. Von dieser Anweisung gibt es keine interne Variante.%
+\EndIndex{Cmd}{ifisnumber}%
+
+\begin{Declaration}
+ \Macro{ifisnumexpr}\Parameter{Code}%
+ \Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+\end{Declaration}
+\BeginIndex{Cmd}{ifisnumexpr}%
+Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in
+einer \Macro{numexpr}, also einem \TeX-Zahlenausdruck resultiert, wird der
+\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Es ist zu
+beachten,\textnote{Achtung!} dass fehlerhafte Ausdrücke zu Fehlermeldungen
+führen! Die Anweisung ist nicht voll expandierbar. Von dieser
+Anweisung gibt es keine interne Variante.%
+\EndIndex{Cmd}{ifisnumexpr}%
+
+\begin{Declaration}
+ \Macro{ifiscounter}\Parameter{Zähler}%
+ \Parameter{Dann-Teil}\Parameter{Sonst-Teil}
+\end{Declaration}
+\BeginIndex{Cmd}{ifiscounter}%
+Wenn\ChangedAt{v3.12}{\Package{scrbase}} \PName{Zähler} ein definierter
+\LaTeX-Zähler ist, wird der \PName{Dann-Teil} ausgeführt, anderenfalls der
+\PName{Sonst-Teil}. Die Anweisung ist nicht voll expandierbar. Von dieser
+Anweisung gibt es keine interne Variante.%
+\EndIndex{Cmd}{ifiscounter}%
+
\BeginIndex{Cmd}{ifnumber}
\begin{Declaration}
\Macro{ifnumber}\Parameter{Zeichenfolge}%
@@ -913,8 +1139,7 @@ interne Variante.
Hier werden keine Zahlen verglichen. Der \PName{Dann-Teil} wird vielmehr
ausgeführt, wenn die Expansion der \PName{Zeichenfolge} nur aus Ziffern
besteht. Anderenfalls wird der \PName{Sonst-Teil} verwendet. Von dieser
-Anweisung gibt es keine interne Variante.
-%
+Anweisung gibt es keine interne Variante.%
\EndIndex{Cmd}{ifnumber}
\BeginIndex{Cmd}{ifdimen}
@@ -966,48 +1191,61 @@ sondern hinter \Macro{begin}\PParameter{document} einfügen. Das Paket
\Package{scrbase} bietet ihm für die Definition selbst einige zusätzliche
Anweisungen.
+\BeginIndex{Cmd}{defcaptionname}%
\BeginIndex{Cmd}{providecaptionname}%
\BeginIndex{Cmd}{newcaptionname}%
\BeginIndex{Cmd}{renewcaptionname}%
\begin{Declaration}
+ \Macro{defcaptionname}%
+ \Parameter{Sprachliste}\Parameter{Begriff}\Parameter{Inhalt}\\
\Macro{providecaptionname}%
- \Parameter{Sprache}\Parameter{Begriff}\Parameter{Inhalt}\\
+ \Parameter{Sprachliste}\Parameter{Begriff}\Parameter{Inhalt}\\
\Macro{newcaptionname}%
- \Parameter{Sprache}\Parameter{Begriff}\Parameter{Inhalt}\\
+ \Parameter{Sprachliste}\Parameter{Begriff}\Parameter{Inhalt}\\
\Macro{renewcaptionname}%
- \Parameter{Sprache}\Parameter{Begriff}\Parameter{Inhalt}
+ \Parameter{Sprachliste}\Parameter{Begriff}\Parameter{Inhalt}\\
+ \Macro{defcaptionname*}%
+ \Parameter{Sprachliste}\Parameter{Begriff}\Parameter{Inhalt}\\
+ \Macro{providecaptionname*}%
+ \Parameter{Sprachliste}\Parameter{Begriff}\Parameter{Inhalt}\\
+ \Macro{newcaptionname*}%
+ \Parameter{Sprachliste}\Parameter{Begriff}\Parameter{Inhalt}\\
+ \Macro{renewcaptionname*}%
+ \Parameter{Sprachliste}\Parameter{Begriff}\Parameter{Inhalt}
\end{Declaration}
Mit Hilfe dieser drei Anweisungen ist es möglich, einem \PName{Begriff} in
-Abhängigkeit der \PName{Sprache} einen \PName{Inhalt} zuzuweisen. Der
-\PName{Begriff} ist dabei immer ein Makro. Die Arbeitsweise der drei
-Anweisungen unterscheidet sich je nachdem, ob eine \PName{Sprache} und ein
-\PName{Begriff} innerhalb dieser \PName{Sprache} zum Zeitpunkt des Aufrufs
-bereits definiert ist.
+Abhängigkeit der Sprache einen \PName{Inhalt} zuzuweisen. Mehrere Sprachen
+können durch Komma voneinander getrennt als
+\PName{Sprachliste}\ChangedAt{v3.12}{\Package{scrbase}} angegeben werden.
-Ist eine \PName{Sprache} nicht definiert, so tut \Macro{providecaptionname}
+Der \PName{Begriff} ist immer ein Makro. Die Arbeitsweise der drei Anweisungen
+unterscheidet sich je nachdem, ob eine Sprache und ein \PName{Begriff}
+innerhalb dieser Sprache zum Zeitpunkt des Aufrufs bereits definiert ist.
+
+Ist eine Sprache nicht definiert, so tut \Macro{providecaptionname}
nichts weiter, als dies in der \File{log}-Datei zu vermerken. Dabei wird für
jede Sprache nur einmal eine entsprechende Information in die \File{log}-Datei
geschrieben. Ist die Sprache definiert, enthält aber bisher keinen
entsprechenden \PName{Begriff}, so wird er mit dem angegebenen \PName{Inhalt}
-definiert. Ist der \PName{Begriff} hingegen in der \PName{Sprache} bereits
+definiert. Ist der \PName{Begriff} hingegen in der Sprache bereits
definiert, so wird er nicht umdefiniert, sondern ein entsprechender Hinweis in
die \File{log}-Datei geschrieben.
Die Anweisung \Macro{newcaptionname} verhält sich etwas anders. Ist bei ihr
-die \PName{Sprache} nicht definiert, dann wird diese neu definiert, indem eine
-entsprechende Anweisung definiert wird. Für die \PName{Sprache}
+eine Sprache nicht definiert, dann wird diese neu definiert, indem eine
+entsprechende Anweisung definiert wird. Für die Sprache
\PValue{ngerman} wäre das beispielsweise \Macro{captionsngerman}. Außerdem
-wird darüber auch in der \File{log}-Datei informiert. Ist die \PName{Sprache}
-definiert, der \PName{Begriff} in dieser \PName{Sprache} aber noch nicht
+wird darüber auch in der \File{log}-Datei informiert. Ist die Sprache
+definiert, der \PName{Begriff} in dieser Sprache aber noch nicht
vorhanden, so wird er mit dem gewünschten \PName{Inhalt} definiert. Ist der
-\PName{Begriff} in der \PName{Sprache} bereits vorhanden, so wird eine
+\PName{Begriff} in der Sprache bereits vorhanden, so wird eine
Fehlermeldung ausgegeben.
Die Anweisung \Macro{renewcaptionname} verhält sich noch einmal anders. Ist
-die \PName{Sprache} nicht definiert, so wird eine Fehlermeldung
-ausgegeben. Ist die \PName{Sprache} definiert, der \PName{Begriff} in dieser
-\PName{Sprache} jedoch nicht, so wird ebenfalls eine Fehlermeldung
-ausgegeben. Ist der \PName{Begriff} in der \PName{Sprache} definiert, so wird
+eine Sprache nicht definiert, so wird eine Fehlermeldung
+ausgegeben. Ist die Sprache definiert, der \PName{Begriff} in dieser
+Sprache jedoch nicht, so wird ebenfalls eine Fehlermeldung
+ausgegeben. Ist der \PName{Begriff} in der Sprache definiert, so wird
er auf den gewünschten \PName{Inhalt} umdefiniert.
\KOMAScript{} selbst verwendet \Macro{providecaptionname} um die Begriffe aus
@@ -1015,18 +1253,37 @@ er auf den gewünschten \PName{Inhalt} umdefiniert.
\begin{Example}
Möchten Sie statt »Abbildung« in den Abbildungsunterschriften lieber »Abb.«
- stehen haben, so erreichen Sie dies mit
+ stehen haben, so erreichen Sie dies mit:
\begin{lstcode}
\renewcaptionname{ngerman}{\figurename}{Abb.}
\end{lstcode}
+ Soll dieselbe Änderung nicht nur für die Sprache \PValue{ngerman}, sondern
+ auch für Sprache \PValue{naustrian}, also für Österreichisch gelten, so ist
+ es nicht notwendig eine zweite Anweisung:
+\begin{lstcode}
+ \renewcaptionname{naustrian}{\figurename}{Abb.}
+\end{lstcode}
+ hinzuzufügen. Stattdessen kann einfach, die \PName{Sprachliste} erweitert
+ werden:
+\begin{lstcode}
+ \renewcaptionname{ngerman,naustrian{\figurename}{Abb.}
+\end{lstcode}
+ In gleicher Weise können auch \PValue{german} und \PValue{austrian}, also
+ Deutsch und Österreichisch nach der veralteten Rechtschreibung, hinzugefügt
+ werden.
\end{Example}
-Da\important{Achtung!} mit \Macro{renewcaptionname} nur bereits vorhandene
-Begriffe in vorhandenen Sprachen umdefiniert werden können, müssen Sie diese
-Anweisung nach \Macro{begin}\PParameter{document} setzen oder mit Hilfe von
-\Macro{AtBeginDocument} verzögern. Außerdem werden Sie eine Fehlermeldung
-erhalten, wenn Sie kein Paket zur Sprachumschaltung auf \PValue{ngerman}
-verwenden.
+Seit \KOMAScript~3.12\ChangedAt{v3.12}{\Package{scrbase}} ist es auch nicht
+mehr erforderlich, die Definierung oder Umdefinierung mit Hilfe von
+\Macro{AtBeginDocument} bis \Macro{begin}\PParameter{document} zu
+verzögern. Stattdessen erledigt \Package{scrbase} dies selbst, falls die
+Anweisungen in der Dokumentpräambel aufgerufen werden. Außerdem prüft
+\Package{scrbase} nun auch, ob ein umzudefinierender Begriff statt in
+\Macro{captions\PName{Sprache}} in \Macro{extras\PName{Sprache}} zu definieren
+ist. Die neuen Sternvarianten der Befehle verwenden grundsätzlich
+\Macro{captions\PName{Sprache}}. Damit funktioniert nun in der Regel auch das
+Umdefinieren von sprachabhängigen Bezeichnern von Paketen wie
+\Package{hyperref}, die dafür \Macro{extras\PName{Sprache}} verwenden.
In \autoref{tab:scrbase.commonNames} ist ein Überblick über die üblicherweise
von Klassen und Sprachpaketen definierten Begriffe und deren Verwendung zu
@@ -1132,7 +1389,8 @@ finden.
\EndIndex{Cmd}{renewcaptionname}%
\EndIndex{Cmd}{newcaptionname}%
\EndIndex{Cmd}{providecaptionname}%
-
+\EndIndex{Cmd}{defcaptionname}%
+%
\EndIndex{}{Sprachdefinition}%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex
index 8c0d120142d..bda0be62839 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrbookreportarticle.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrbookreportarticle.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,8 +45,9 @@
%
% ============================================================================
-\ProvidesFile{scrbookreportarticle.tex}[2012/02/15 KOMA-Script guide (chapter:
-scrbook, scrreprt, scrartcl)]
+\KOMAProvidesFile{scrbookreportarticle.tex}
+ [$Date: 2013-12-16 18:08:48 +0100 (Mo, 16. Dez 2013) $
+ KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl)]
\chapter{Die Hauptklassen \Class{scrbook}, \Class{scrreprt}, \Class{scrartcl}}
\labelbase{maincls}%
@@ -117,7 +118,7 @@ Tabellen.
\LoadCommon{0} % \section{Frühe oder späte Optionenwahl}
-\iffree{}{\clearpage}% Umbruchkorrektur!!!
+%\iffree{}{\clearpage}% Umbruchkorrektur!!!
\LoadCommon{1} % \section{Kompatibilität zu früheren Versionen von \KOMAScript}
@@ -136,7 +137,8 @@ Tabellen.
nur alle ersten Zeilen eines Satzspiegels mit ihrer Grundlinie auf der
gleichen Höhe liegen, sondern auch die letzten Zeilen einer
Doppelseite. Enthält eine Seite nur Text ohne Absätze und Überschriften, so
- hat man das automatisch. Aber bereits dann, wenn Absätze mit einem halben
+ hat man das automatisch, wenn bei der Konstruktion des Satzspiegels einige
+ Grundregeln befolgt wurden. Aber bereits dann, wenn Absätze mit einem halben
Grundlinienabstand markiert werden, genügt es, wenn die Anzahl der Absätze
auf der einen Seite um eine ungerade Zahl von der auf der anderen Seite
abweicht, damit dieses Ziel nicht mehr erreicht werden kann. Es ist dann
@@ -178,193 +180,10 @@ voreingestellt. Dies ist bei einem Wechsel von den Standardklassen zu den
%
\EndIndex{}{Schrift>Groesse=Größe}
-
\LoadCommon{5} % \section{Textauszeichnungen}
-Mit der Anweisung \Macro{usekomafont} kann die aktuelle Schriftart auf
-diejenige umgeschaltet werden, die für das angegebene \PName{Element}
-definiert ist.
-
-\begin{Example}
- \phantomsection\label{desc:maincls.setkomafont.example}%
- Angenommen, für das Element
- \FontElement{captionlabel} soll dieselbe Schriftart wie
- für \FontElement{descriptionlabel} verwenden. Das
- erreichen Sie einfach mit:
-\begin{lstcode}
- \setkomafont{captionlabel}{%
- \usekomafont{descriptionlabel}%
- }
-\end{lstcode}
- Weitere Beispiele finden Sie in den Abschnitten zu den jeweiligen
- Elementen.
-\end{Example}
-
-\begin{desclist}
- \desccaption{%
- Elemente, deren Schrift bei \Class{scrbook}, \Class{scrreprt} oder
- \Class{scrartcl} mit \Macro{setkomafont} und \Macro{addtokomafont}
- verändert werden kann\label{tab:maincls.elementsWithoutText}%
- }{%
- Elemente, deren Schrift verändert werden kann (\emph{Fortsetzung})%
- }%
- \feentry{caption}{Text einer Abbildungs- oder Tabellenunter- oder
- "~überschrift (siehe \autoref{sec:maincls.floats},
- \autopageref{desc:maincls.cmd.caption})}%
- \feentry{captionlabel}{%
- Label einer Abbildungs- oder Tabellenunter- oder "~überschrift; Anwendung
- erfolgt nach dem Element \FontElement{caption} (siehe
- \autoref{sec:maincls.floats}, \autopageref{desc:maincls.cmd.caption})}%
- \feentry{chapter}{%
- Überschrift der Ebene \Macro{chapter} (siehe
- \autoref{sec:maincls.structure}, \autopageref{desc:maincls.cmd.chapter})}%
- \feentry{chapterentry}{%
- Inhaltsverzeichniseintrag der Ebene \Macro{chapter} (siehe
- \autoref{sec:maincls.toc},
- \autopageref{desc:maincls.cmd.tableofcontents})}%
- \feentry{chapterentrypagenumber}{%
- Seitenzahl des Inhaltsverzeichniseintrags der Ebene \Macro{chapter}
- abweichend vom Element \FontElement{chapterentry} (siehe
- \autoref{sec:maincls.toc},
- \autopageref{desc:maincls.cmd.tableofcontents})}%
- \feentry{chapterprefix}{%
- Kapitelnummernzeile bei Einstellung \OptionValue{chapterprefix}{true} oder
- \OptionValue{appendixprefix}{true} (siehe \autoref{sec:maincls.structure},
- \autopageref{desc:maincls.option.chapterprefix})}%
- \feentry{descriptionlabel}{%
- Label, also das optionale Argument der \Macro{item}-Anweisung, in einer
- \Environment{description}-Umgebung (siehe \autoref{sec:maincls.lists},
- \autopageref{desc:maincls.env.description})}%
- \feentry{dictum}{%
- mit \Macro{dictum} gesetzter schlauer Spruch (siehe
- \autoref{sec:maincls.dictum}, \autopageref{desc:maincls.cmd.dictum})}%
- \feentry{dictumauthor}{%
- Urheber eines schlauen Spruchs; Anwendung erfolgt nach dem Element
- \FontElement{dictum} (siehe \autoref{sec:maincls.dictum},
- \autopageref{desc:maincls.cmd.dictum})}%
- \feentry{dictumtext}{%
- alternative Bezeichnung für \FontElement{dictum}}%
- \feentry{disposition}{%
- alle Gliederungsüberschriften, also die Argumente von \Macro{part} bis
- \Macro{subparagraph} und \Macro{minisec} sowie die Überschrift der
- Zusammenfassung; die Anwendung erfolgt vor dem Element der jeweiligen
- Gliederungsebene (siehe \autoref{sec:maincls.structure} ab
- \autopageref{sec:maincls.structure})}%
- \feentry{footnote}{%
- Marke und Text einer Fußnote (siehe \autoref{sec:maincls.footnotes},
- \autopageref{desc:maincls.cmd.footnote})}%
- \feentry{footnotelabel}{%
- Marke einer Fußnote; Anwendung erfolgt nach dem Element
- \FontElement{footnote} (siehe \autoref{sec:maincls.footnotes},
- \autopageref{desc:maincls.cmd.footnote})}%
- \feentry{footnotereference}{%
- Referenzierung der Fußnotenmarke im Text (siehe
- \autoref{sec:maincls.footnotes},
- \autopageref{desc:maincls.cmd.footnote})}%
- \feentry{footnoterule}{%
- Linie\ChangedAt{v3.07}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}}
- über dem Fußnotenapparat (siehe \autoref{sec:maincls.footnotes},
- \autopageref{desc:maincls.cmd.setfootnoterule})}%
- \feentry{labelinglabel}{%
- Label, also das optionale Argument der \Macro{item}-Anweisung, und
- Trennzeichen, also das optionale Argument der
- \Environment{labeling}-Umgebung, in einer \Environment{labeling}-Umgebung
- (siehe \autoref{sec:maincls.lists}, \autopageref{desc:maincls.env.labeling})}%
- \feentry{labelingseparator}{%
- Trennzeichen, also das optionale Argument der
- \Environment{labeling}-Umgebung, in einer \Environment{labeling}-Umgebung;
- Anwendung erfolgt nach dem Element \FontElement{labelinglabel}
- (siehe \autoref{sec:maincls.lists}, \autopageref{desc:maincls.env.labeling})}%
- \feentry{minisec}{%
- mit \Macro{minisec} gesetzte Überschrift (siehe
- \autoref{sec:maincls.structure} ab
- \autopageref{desc:maincls.cmd.minisec})}%
- \feentry{pagefoot}{%
- wird nur verwendet, wenn das Paket \Package{scrpage2} geladen ist (siehe
- \autoref{cha:scrpage}, \autopageref{desc:scrpage.fontelement.pagefoot})}%
- \feentry{pagehead}{%
- alternative Bezeichnung für \FontElement{pageheadfoot}}%
- \feentry{pageheadfoot}{%
- Seitenkopf und Seitenfuß bei allen von \KOMAScript{} definierten
- Seitenstilen (siehe \autoref{sec:maincls.pagestyle} ab
- \autopageref{sec:maincls.pagestyle})}%
- \feentry{pagenumber}{%
- Seitenzahl im Kopf oder Fuß der Seite (siehe
- \autoref{sec:maincls.pagestyle})}%
- \feentry{pagination}{%
- alternative Bezeichnung für \FontElement{pagenumber}}%
- \feentry{paragraph}{%
- Überschrift der Ebene \Macro{paragraph} (siehe
- \autoref{sec:maincls.structure},
- \autopageref{desc:maincls.cmd.paragraph})}%
- \feentry{part}{%
- Überschrift der Ebene \Macro{part}, jedoch ohne die Zeile mit der Nummer
- des Teils (siehe \autoref{sec:maincls.structure},
- \autopageref{desc:maincls.cmd.part})}%
- \feentry{partentry}{%
- Inhaltsverzeichniseintrag der Ebene \Macro{part} (siehe
- \autoref{sec:maincls.toc},
- \autopageref{desc:maincls.cmd.tableofcontents})}%
- \feentry{partentrypagenumber}{%
- Seitenzahl des Inhaltsverzeichniseintrags der Ebene \Macro{part}
- abweichend vom Element \FontElement{partentry} (siehe
- \autoref{sec:maincls.toc},
- \autopageref{desc:maincls.cmd.tableofcontents})}%
- \feentry{partnumber}{%
- Zeile mit der Nummer des Teils in Überschrift der Ebene \Macro{part}
- (siehe \autoref{sec:maincls.structure},
- \autopageref{desc:maincls.cmd.part})}%
- \feentry{section}{%
- Überschrift der Ebene \Macro{section} (siehe
- \autoref{sec:maincls.structure}, \autopageref{desc:maincls.cmd.section})}%
- \feentry{sectionentry}{%
- Inhaltsverzeichniseintrag der Ebene \Macro{section} (nur bei
- \Class{scrartcl} verfügbar, siehe \autoref{sec:maincls.toc},
- \autopageref{desc:maincls.cmd.tableofcontents})}%
- \feentry{sectionentrypagenumber}{%
- Seitenzahl des Inhaltsverzeichniseintrags der Ebene \Macro{section}
- abweichend vom Element \FontElement{sectionentry} (nur bei
- \Class{scrartcl} verfügbar, siehe \autoref{sec:maincls.toc},
- \autopageref{desc:maincls.cmd.tableofcontents})}%
- \feentry{sectioning}{%
- alternative Bezeichnung für \FontElement{disposition}}%
- \feentry{subject}{%
- Typisierung des Dokuments, also das Argument von \Macro{subject} auf der
- Haupttitelseite (siehe \autoref{sec:maincls.titlepage},
- \autopageref{desc:maincls.cmd.subject})}%
- \feentry{subparagraph}{%
- Überschrift der Ebene \Macro{subparagraph} (siehe
- \autoref{sec:maincls.structure},
- \autopageref{desc:maincls.cmd.subparagraph})}%
- \feentry{subsection}{%
- Überschrift der Ebene \Macro{subsection} (siehe
- \autoref{sec:maincls.structure},
- \autopageref{desc:maincls.cmd.subsection})}%
- \feentry{subsubsection}{%
- Überschrift der Ebene \Macro{subsubsection} (siehe
- \autoref{sec:maincls.structure},
- \autopageref{desc:maincls.cmd.subsubsection})}%
- \feentry{subtitle}{%
- Untertitel des Dokuments, also das Argument von \Macro{subtitle} auf der
- Haupttitelseite (siehe \autoref{sec:maincls.titlepage},
- \autopageref{desc:maincls.cmd.title})}%
- \feentry{title}{%
- Haupttitel des Dokuments, also das Argument von \Macro{title} (bezüglich
- der Größe des Haupttitels siehe die ergänzenden Bemerkungen im Text von
- \autoref{sec:maincls.titlepage} ab \autopageref{desc:maincls.cmd.title})}%
-\end{desclist}
-%
-\EndIndex{Cmd}{setkomafont}%
-\EndIndex{Cmd}{addtokomafont}%
-\EndIndex{Cmd}{usekomafont}%
-%
-\EndIndex{}{Schrift>Art}%
-\EndIndex{}{Text>Auszeichnung}
-
\LoadCommon{14}% \section{Dokumenttitel}
-
\section{Zusammenfassung}
\label{sec:maincls.abstract}
\BeginIndex{}{Zusammenfassung}%
@@ -535,8 +354,8 @@ aus. In \cite{DANTE:FAQ} wird für solche Fälle vorgeschlagen, die Erzeugung
des Inhaltsverzeichnisses
umzudefinieren. \KOMAScript{}\important{\OptionValue{toc}{flat}} bietet jedoch
eine alternative Formatierung an, bei der das Problem nicht auf"|tritt. Bei
-Verwendung der Option \OptionValue{toc}{flat}\IndexOption{toc~=\PValue{flat}} werden
-die unterschiedlichen Gliederungsebenen nicht unterschiedlich weit
+Verwendung der Option \OptionValue{toc}{flat}\IndexOption{toc~=\PValue{flat}}
+werden die unterschiedlichen Gliederungsebenen nicht unterschiedlich weit
eingezogen. Stattdessen wird eine tabellenartige Form gewählt, in der alle
Gliederungsnummern und alle Gliederungstexte jeweils in einer Spalte
linksbündig untereinander stehen. Der für die Gliederungsnummern benötigte
@@ -572,10 +391,29 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von
Das Inhaltsverzeichnis erhält eine hierarchische Form. Es steht nur ein
begrenzter Platz für die Gliederungsnummern zur Verfügung.%
\IndexOption{toc~=\PValue{graduated}}}%
+ \entry{\PValue{indenttextentries}, \PValue{indentunnumbered},
+ \PValue{numberline}}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ Die Eigenschaft \PValue{numberline} (siehe \autoref{sec:tocbasic.toc},
+ \autopageref{desc:tocbasic.cmd.setuptoc}) wird für das Inhaltsverzeichnis
+ gesetzt. Dadurch werden nicht nummerierte Einträge linksbündig mit dem
+ Text von nummerierten Einträgen gleicher Ebene gesetzt.%
+ \IndexOption{toc~=\PValue{numberline}}}%
\entry{\PValue{index}, \PValue{idx}}{%
Das Stichwortverzeichnis erhält einen Eintrag im Inhaltsverzeichnis, ohne
dass es nummeriert wird.%
\IndexOption{toc~=\PValue{index}}}%
+ \entry{\PValue{leftaligntextentries}, \PValue{leftalignunnumbered},
+ \PValue{nonumberline}}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ Die Eigenschaft \PValue{numberline} (siehe \autoref{sec:tocbasic.toc},
+ \autopageref{desc:tocbasic.cmd.setuptoc}) wird für das Inhaltsverzeichnis
+ gelöscht. Dadurch werden nicht nummerierte Einträge linksbündig mit dem
+ Nummer von nummerierten Einträgen gleicher Ebene gesetzt. Dies entspricht
+ der Voreinstellung.%
+ \IndexOption{toc~=\PValue{numberline}}}%
\pventry{listof}{%
Die Verzeichnisse der Gleitumgebungen, beispielsweise das Abbildungs"~ und
das Tabellenverzeichnis, erhalten einen Eintrag im Inhaltsverzeichnis,
@@ -583,8 +421,8 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von
\IndexOption{toc~=\PValue{listof}}}%
\entry{\PValue{listofnumbered}, \PValue{numberedlistof}}{%
Die Verzeichnisse der Gleitumgebungen, beispielsweise das Abbildungs"~ und
- das Tabellenverzeichnis, erhalten einen Eintrag im Inhaltsverzeichnis
- und werden nummeriert.%
+ das Tabellenverzeichnis, erhalten einen Eintrag im Inhaltsverzeichnis und
+ werden nummeriert.%
\IndexOption{toc~=\PValue{listofnumbered}}}%
\entry{\PValue{nobibliography}, \PValue{nobib}}{%
Das Literaturverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis.%
@@ -630,19 +468,20 @@ Inhaltsverzeichniseinträge ist außerdem über die Elemente
und \Class{scrreprt} über
\FontElement{chapterentry}\IndexFontElement{chapterentry} beziehungsweise
\FontElement{sectionentry}\IndexFontElement{sectionentry} für \Class{scrartcl}
-einstellbar. Die Schrift der
-Seitenzahlen kann jeweils davon abweichend über die Elemente
+einstellbar. Die Schrift der Seitenzahlen kann jeweils davon abweichend über
+die Elemente
\FontElement{partentrypagenumber}\IndexFontElement{partentrypagenumber}%
\important{\FontElement{partentrypagenumber}} und
\FontElement{chapterentrypagenumber}\IndexFontElement{chapterentrypagenumber}%
\important[i]{\FontElement{chapterentrypagenumber}\\
- \FontElement{sectionentrypagenumber}} respektive
+ \FontElement{sectionentrypagenumber}} (\Class{scrbook} und \Class{scrreprt})
+beziehungsweise
\FontElement{sectionentrypagenumber}\IndexFontElement{sectionentrypagenumber}
-eingestellt werden (siehe auch \autoref{sec:maincls.textmarkup},
-\autopageref{desc:maincls.cmd.setkomafont}, sowie
-\autoref{tab:maincls.elementsWithoutText},
+(\Class{scrartcl}) eingestellt werden (siehe auch
+\autoref{sec:maincls.textmarkup}, \autopageref{desc:maincls.cmd.setkomafont},
+sowie \autoref{tab:maincls.elementsWithoutText},
\autopageref{tab:maincls.elementsWithoutText}). Die Voreinstellungen der
-Elemente ist \autoref{tab:maincls.tocelements} zu entnehmen.
+Elemente sind \autoref{tab:maincls.tocelements} zu entnehmen.
\begin{table}
% \centering
% \caption
@@ -691,11 +530,14 @@ Zählers kann bestimmt werden, bis zu welcher Gliederungsebene Einträge in das
Inhaltsverzeichnis erfolgen sollen. Dies ist übrigens bei den Standardklassen
ganz genauso.
-Bei Verwendung des \Package{scrpage2}-Pakets\IndexPackage{scrpage2} (siehe
-\autoref{cha:scrpage}) muss man sich nicht die nummerischen Werte der
-einzelnen Gliederungsebenen merken. Dann stehen dafür die Makros
-\Macro{partlevel}, \Macro{chapterlevel}, \Macro{sectionlevel} und so weiter
-bis hinunter zu \Macro{subparagraphlevel} zur Verfügung.
+Bitten beachten Sie\textnote{Achtung!}, dass die Werte für \Counter{tocdepth}
+und \Counter{secnumdepth}\IndexCounter{secnumdepth} (siehe
+\autoref{sec:maincls.structure},
+\autopageref{desc:maincls.counter.secnumdepth}) bei \Class{scrartcl} für
+\Macro{part} nicht übereinstimmen. Dies wurde aus Gründen der Kompatibilität
+von der Standardklasse \Class{article} übernommen. Daher sollte die Anweisung
+\Macro{partnumdepth}\IndexCmd{partnumdepth} nicht zum Setzen von
+\Counter{tocdepth} verwendet werden.%
\begin{Example}
Angenommen, Sie setzen einen Artikel, bei dem die Gliederungsebene
\Macro{subsubsection} verwendet wird. Gehen wir weiter davon aus,
@@ -716,9 +558,9 @@ bis hinunter zu \Macro{subparagraphlevel} zur Verfügung.
\documentclass{scrartcl}
\addtocounter{tocdepth}{-1}
\end{lstcode}
- Wie\textnote{Tipp!} viel Sie von \Counter{tocdepth} subtrahieren oder dazu
- addieren müssen, können Sie natürlich auch einfach nach einem ersten
- \LaTeX-Lauf im Inhaltsverzeichnis abzählen.
+ Den\textnote{Tipp!} Wert, den Sie zu \Counter{tocdepth} addieren oder davon
+ subtrahieren müssen, können Sie nach mindestens zwei \LaTeX-Läufen einfach im
+ Inhaltsverzeichnis abzählen.
\end{Example}
\iffalse % Umbruchausgleichstext
Falls\textnote{Tipp!} Sie sich nicht merken wollen, welche Nummer zu welcher
@@ -788,9 +630,12 @@ wird. Entsprechendes gilt bei \Option{footsepline} für
\Option{footinclude}\IndexOption{footinclude}\important{\Option{footinclude}}.
Im Gegensatz zu \Option{headsepline} wirkt sich die Option
\Option{footsepline} auch beim Seitenstil \PValue{plain} aus, da
-\PValue{plain} eine Seitenzahl im Fuß ausgibt. Das Paket
-\Package{scrpage2}\IndexPackage{scrpage2} (siehe \autoref{cha:scrpage}) bietet
-weitere Einflussmöglichkeiten für Linien im Kopf und Fuß.%
+\PValue{plain} eine Seitenzahl im Fuß ausgibt. \iffree{Die Pakete
+ \Package{scrpage2} und}{Das Paket}
+\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} (siehe
+\iffree{\autoref{cha:scrpage} beziehungsweise}{\ignorespaces}
+\autoref{cha:scrlayer-scrpage}) bietet weitere Einflussmöglichkeiten für
+Linien im Kopf und Fuß.%
%
\EndIndex{Option}{headsepline~=\PName{Ein-Aus-Wert}}%
\EndIndex{Option}{footsepline~=\PName{Ein-Aus-Wert}}%
@@ -863,8 +708,13 @@ weitere Einflussmöglichkeiten für Linien im Kopf und Fuß.%
jederzeit} gesetzt werden. Verwendet\textnote{Tipp!} man \Macro{pagestyle}
vor Anweisungen, die einen Seitenumbruch herbeiführen, und soll die Änderung
erst ab der neuen Seite gelten, so ist ein \Macro{cleardoublepage} davor
-nützlich. Üblicherweise verwendet man \Macro{pagestyle} aber nur einmal zu
+nützlich.
+%
+\iffalse % Umbruchkorrektur
+Üblicherweise verwendet man \Macro{pagestyle} aber nur einmal zu
Beginn des Dokuments oder in der Präambel.
+%
+\fi
Für\important{\Macro{thispagestyle}} eine Änderung des Seitenstils nur der
aktuellen Seite verwendet man stattdessen die Anweisung
@@ -873,13 +723,15 @@ automatisch. Beispielsweise wird bei allen Kapitelanfangsseiten implizit die
Anweisung \Macro{thispagestyle}\PParameter{\Macro{chapterpagestyle}}
ausgeführt.
-Bitte\textnote{Achtung!} beachten Sie auch, dass die Umschaltung zwischen
-automatischen und manuellen Kolumnentiteln bei Verwendung des Pakets
-\Package{scrpage2}\important{\Package{scrpage2}} nicht mehr über den
-Seitenstil, sondern mit speziellen Anweisungen erfolgt. Die beiden Seitenstile
-\Pagestyle{headings} und \Pagestyle{myheadings} sollten nicht zusammen mit
-diesem Paket verwendet werden (siehe \autoref{cha:scrpage},
-\autopageref{desc:scrpage.pagestyle.useheadings}).
+Bitte\textnote{Achtung!} beachten Sie, dass die Umschaltung zwischen
+automatischen und manuellen Kolumnentiteln bei Verwendung \iffree{des Pakets
+ \Package{scrpage2}\important{\Package{scrpage2}} oder }{}von
+\Package{scrlayer-scrpage}\important{\Package{scrlayer-scrpage}} nicht mehr
+über den Seitenstil, sondern mit speziellen Anweisungen erfolgt. Die beiden
+Seitenstile \Pagestyle{headings} und \Pagestyle{myheadings} sollten nicht
+zusammen mit \iffree{diesen Paketen}{diesem Paket} verwendet werden\iffree{
+ (siehe auch \autoref{cha:scrpage},
+ \autopageref{desc:scrpage.pagestyle.useheadings})}{}.
\BeginIndex[indexother]{}{Schrift>Art}%
\BeginIndex{FontElement}{pageheadfoot}%
@@ -898,9 +750,13 @@ heißt
\FontElement{pagenumber}\IndexFontElement{pagenumber}\important{\FontElement{pagenumber}}. Das
ebenfalls in den \KOMAScript-Klassen bereitgestellte Element
\FontElement{pagefoot}\IndexFontElement{pagefoot} wird nur verwendet, wenn man
-mit dem Paket \Package{scrpage2}\IndexPackage{scrpage2} (siehe
-\autoref{cha:scrpage}, \autopageref{desc:scrpage.fontelement.pagefoot}) einen
-Seitenstil definiert, bei dem auch der Fuß Text enthält.
+mit dem Paket \Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage}
+\iffree{oder \Package{scrpage2}\IndexPackage{scrpage2}}{\ignorespaces} (siehe
+\autoref{cha:scrlayer-scrpage},
+\autopageref{desc:scrlayer-scrpage.fontelement.pagefoot}
+\iffree{beziehungsweise \autoref{cha:scrpage},
+ \autopageref{desc:scrpage.fontelement.pagefoot}}{\unskip}) einen Seitenstil
+definiert, bei dem auch der Fuß Text enthält.
Die Voreinstellungen sind in \autoref{tab:maincls.defaultFontsHeadFoot} zu
finden.
@@ -940,8 +796,7 @@ finden.
Sie dies wie folgt erreichen:
\begin{lstcode}
\setkomafont{pageheadfoot}{%
- \normalfont\normalcolor\itshape\small
- }
+ \normalfont\normalcolor\itshape\small}
\setkomafont{pagenumber}{\normalfont\bfseries}
\end{lstcode}
Wollen Sie hingegen lediglich, dass zusätzlich zur bereits voreingestellten
@@ -957,23 +812,28 @@ finden.
\autopageref{tab:maincls.elementsWithoutText}).
\end{Example}
Es ist an dieser Stelle nicht möglich, Versalien für die automatischen
-Kolumnentitel zu erzwingen. Wenn Sie dies wünschen, verwenden Sie bitte das
-\Package{scrpage2}-Paket (siehe \autoref{cha:scrpage},
-\autopageref{desc:scrpage.option.markuppercase}).
+Kolumnentitel zu erzwingen. Wenn Sie dies wünschen, müssen Sie entweder
+\Macro{MakeMarkcase}\IndexCmd{MakeMarkcase} entsprechend umdefinieren. Es wird
+jedoch empfohlen, in solchen Fällen das Paket \Package{scrlayer-scrpage} zu
+verwenden (siehe \autoref{cha:scrlayer-scrpage},
+\autopageref{desc:scrlayer-scrpage.option.markcase}).
Werden\textnote{Tipp!} eigene Seitenstile definiert, sind eventuell die
Befehle \Macro{usekomafont}\PParameter{pageheadfoot},
\Macro{usekomafont}\PParameter{pagenumber} sowie
\Macro{usekomafont}\PParameter{pagefoot} nützlich. Insbesondere falls Sie
-dafür nicht das \KOMAScript-Paket \Package{scrpage2} (siehe
-\autoref{cha:scrpage}), sondern beispielsweise das Paket
+dafür nicht das \KOMAScript-Paket \Package{scrlayer-scrpage}\iffree{ oder
+ \Package{scrpage2}}{} (siehe \autoref{cha:scrlayer-scrpage}\iffree{
+ beziehungsweise \autoref{cha:scrpage}}{}), sondern beispielsweise das Paket
\Package{fancyhdr}\IndexPackage{fancyhdr}\important{\Package{fancyhdr}} (siehe
\cite{package:fancyhdr}) einsetzen, können Sie diese Befehle in Ihren
Definitionen verwenden. Dadurch bleiben Sie zu \KOMAScript{} möglichst
kompatibel. Verwenden Sie diese Befehle in Ihren eigenen Definitionen nicht,
so bleiben Schriftänderungen wie in den vorangehenden Beispielen
-unbeachtet. Das Paket \Package{scrpage2}\IndexPackage{scrpage2} sorgt selbst
-für maximale Kompatibilität.%
+unbeachtet. \iffree{Die Pakete}{Das Paket}
+\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} \iffree{und
+ Package{scrpage2}\IndexPackage{scrpage2} sorgen}{sorgt} selbst für maximale
+Kompatibilität.%
\EndIndex{FontElement}{pagenumber}%
\EndIndex{FontElement}{pagefoot}%
\EndIndex{FontElement}{pageheadfoot}%
@@ -999,8 +859,10 @@ und \Macro{markright}. Dabei wird die \PName{linke Marke} normalerweise im
Kopf linker Seiten und die \PName{rechte Marke} im Kopf rechter Seiten
verwendet. Im einseitigen Satz existiert nur die rechte Marke. Bei Verwendung
des Paketes
-\Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}} steht
-außerdem die Anweisung
+\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage}\important{\Package{scrlayer-scrpage}}\iffree{
+ oder
+ \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}}{}
+steht außerdem die Anweisung
\Macro{markleft}\IndexCmd{markleft}\important{\Macro{markleft}} zur Verfügung.
Die Anweisungen können auch zusammen mit anderen Seitenstilen verwendet
@@ -1064,12 +926,12 @@ werden.
wird. Natürlich können Sie auch einen selbst definierten Seitenstil
verwenden.
- Angenommen, Sie haben mit dem Paket \Package{scrpage2} (siehe
- \autoref{cha:scrpage}) einen eigenen Seitenstil für
+ Angenommen, Sie haben mit dem Paket \Package{scrlayer-scrpage} (siehe
+ \autoref{cha:scrlayer-scrpage}) einen eigenen Seitenstil für
Kapitelanfangsseiten\Index{Kapitel>Seitenstil}%
\textnote{Kapitel\-anfangs\-seiten}
definiert. Diesem Seitenstil haben Sie den passenden Namen \PValue{chapter}
- gegeben. Um diesen nun auch tatsächlich zu verwenden, definieren Sie
+ gegeben. Um diesen auch tatsächlich zu verwenden, definieren Sie
\Macro{chapterpagestyle} entsprechend um:
\begin{lstcode}
\renewcommand*{\chapterpagestyle}{chapter}
@@ -1111,8 +973,7 @@ werden.
\begin{Explain}
Wer nun glaubt, er könne auf Kapitelanfangsseiten ebenfalls mit
- lebenden Kolumnentiteln arbeiten, indem er einfach eine Definition
- wie
+ lebenden Kolumnentiteln arbeiten, indem er einfach
\begin{lstcode}
\renewcommand*{\chapterpagestyle}{headings}
\end{lstcode}
@@ -1304,7 +1165,8 @@ Zusammenfassung der möglichen Werte findet sich noch einmal in
\Macro{cleardoublepage}
erzeugen einen Seitenumbruch und fügen ggf. eine
Vakatseite\Index{Vakatseite} ein, um im doppelseitigen
- Satz auf die nächste linke Seite zu gelangen.\IndexOption{open~=\PValue{left}}}%
+ Satz auf die nächste linke Seite zu gelangen.%
+ \IndexOption{open~=\PValue{left}}}%
\pventry{right}{Die Anweisungen
\Macro{cleardoublepageusingstyle},
\Macro{cleardoublestandardpage},
@@ -1321,7 +1183,7 @@ Zusammenfassung der möglichen Werte findet sich noch einmal in
\begin{sloppypar}% Umbruchoptimierung
Neben den Kapitelanfängen wirkt sich die Option auch auf die explizite
-Verwendung der Anweisung\Macro{cleardoublepage} ebenso wie auf
+Verwendung der Anweisung \Macro{cleardoublepage} ebenso wie auf
\Macro{cleardoublepageusingstyle},
\Macro{cleardoublestandardpage}, \Macro{cleardoubleplainpage} und
\Macro{cleardoubleemptypage} aus. Siehe dazu \autoref{sec:maincls.pagestyle},
@@ -1473,7 +1335,6 @@ Eine Zusammenfassung der möglichen Einstellungen für Option \Option{headings}
finden Sie in \autoref{tab:maincls.headings}. Beispiele zu Verwendung einiger
der möglichen Einstellungen sind in den nachfolgenden Beschreibungen
der Gliederungsbefehle enthalten.
-\iffree{}{\vskip-\ht\strutbox\enlargethispage*{\ht\strutbox}}% Umbruchkorrektur
\begin{desclist}
\renewcommand*{\abovecaptionskipcorrection}{-\normalbaselineskip}%
\desccaption[{Mögliche Werte für Option \Option{headings}}]{%
@@ -1522,26 +1383,26 @@ der Gliederungsbefehle enthalten.
\IndexOption{headings~=\PValue{openright}}}%
\pventry{optiontohead}{%
Die\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} erweiterte Funktion des optionalen Argument der
+ \Class{scrartcl}} erweiterte Funktion des optionalen Arguments der
Gliederungsbefehle wird aktiviert. In der Voreinstellung wird das
optionale Argument ausschließlich für den Kolumnentitel verwendet.%
- \IndexOption{headings=~optiontohead}%
+ \IndexOption{headings~=\PValue{optiontohead}}%
}%
\entry{\PValue{optiontoheadandtoc}, \PValue{optiontotocandhead}%
\IndexOption{headings~=\PValue{optiontoheadandtoc}}}{%
Die\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} erweiterte Funktion des optionalen Argument der
+ \Class{scrartcl}} erweiterte Funktion des optionalen Arguments der
Gliederungsbefehle wird aktiviert. In der Voreinstellung wird das
optionale Argument sowohl für den Kolumnentitel als auch den Eintrag ins
Inhaltsverzeichnis verwendet.%
}%
\pventry{optiontotoc}{%
Die\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} erweiterte Funktion des optionalen Argument der
+ \Class{scrartcl}} erweiterte Funktion des optionalen Arguments der
Gliederungsbefehle wird aktiviert. In der Voreinstellung wird das
optionale Argument ausschließlich für den Eintrag ins Inhaltsverzeichnis
verwendet.%
- \IndexOption{headings=~optiontohead}%
+ \IndexOption{headings~=\PValue{optiontohead}}%
}%
\pventry{small}{%
Verwende kleine Überschriften mit kleinen Abständen darüber und darunter.%
@@ -1697,10 +1558,11 @@ Einstellung\important{\Option{headings}}
\OptionValue{headings}{optiontohead}\IndexOption[indexmain]{headings~=\PValue{optiontohead}}
wird das optionale Argument bei \KOMAScript{} hingegen nur noch für den
Kolumnentitel verwendet. Ein konkreter Eintrag in den Kolumnentitel erfolgt
-natürlich nur, wenn ein Seitenstil\Index{Seiten>Stil} gewählt wird, bei dem die
-entsprechende Gliederungsebene überhaupt für den Kolumnentitel verwendet
+natürlich nur, wenn ein Seitenstil\Index{Seiten>Stil} gewählt wird, bei dem
+die entsprechende Gliederungsebene überhaupt für den Kolumnentitel verwendet
wird. Siehe hierzu \autoref{sec:maincls.pagestyle} sowie
-\autoref{cha:scrpage}. Mit der Einstellung
+\autoref{cha:scrlayer-scrpage}\iffree{ beziehungsweise
+ \autoref{cha:scrpage}}{}. Mit der Einstellung
\OptionValue{headings}{optiontotoc}\IndexOption[indexmain]{headings~=\PValue{optiontotoc}}
wird das optionale Argument hingegen ausschließlich für den Eintrag ins
Inhaltsverzeichnis verwendet. Auch dies selbstverständlich nur, wenn die
@@ -1720,10 +1582,10 @@ dies der Fall, so wird das optionale Argument der Gliederungsbefehle selbst
statt als \PName{Kurzform} als \PName{Optionenliste} interpretiert. Dabei
werden die beiden Optionen
\Option{head=}\PName{Kolumnentitel}\important{\Option{head}} und
-\Option{tocentry=}\PName{Inhaltsverzeichniseintrag} akzeptiert. Um ein
-Gleichheitszeichen oder ein Komma in einem der beiden Werte dieser Optionen
-unter zu bringen, muss dieses in zusätzliche geschweifte Klammern gesetzt
-werden.
+\Option{tocentry=}\PName{Inhaltsverzeichniseintrag}\important{\Option{tocentry}}
+akzeptiert. Um ein Gleichheitszeichen oder ein Komma in einem der beiden Werte
+dieser Optionen unter zu bringen, muss dieses in zusätzliche geschweifte
+Klammern gesetzt werden.
Bitte\textnote{Achtung!} beachten Sie, dass dieser Mechanismus nur
funktioniert, solange \KOMAScript{} die Kontrolle über die Gliederungsbefehle
@@ -2258,8 +2120,12 @@ das Element \FontElement{disposition} wirkt.%
% »Mauseschnappfalle«, das dem Tierschutz zum Opfer gefallen ist.
\end{ShowOutput}
Zum Verständnis der Verwendung des Pakets
- \Package{selinput}\IndexPackage{selinput} und der darin definierten
- Anweisung \Macro{SelectInputMappings} sei auf \cite{package:selinput}
+ \Package{selinput}\IndexPackage{selinput} und
+ %
+ \iffalse % Umbruchkorrektur
+ der darin definierten Anweisung %
+ \fi %
+ \Macro{SelectInputMappings} sei auf \cite{package:selinput}
verwiesen.
\end{Example}
%
@@ -2471,12 +2337,16 @@ gibt, existieren die beiden Anweisungen auch nur bei diesen Klassen.%
\begin{Declaration}
\Macro{chaptermark}\Parameter{Kolumnentitel}\\
+ \Macro{addchapmark}\Parameter{Kolumnentitel}\\
\Macro{sectionmark}\Parameter{Kolumnentitel}\\
+ \Macro{addsecmark}\Parameter{Kolumnentitel}\\
\Macro{subsectionmark}\Parameter{Kolumnentitel}\\
\Macro{chaptermarkformat}\\
\Macro{sectionmarkformat}\\
\Macro{subsectionmarkformat}
\end{Declaration}%
+\BeginIndex{Cmd}{addchapmark}%
+\BeginIndex{Cmd}{addsecmark}%
\BeginIndex{Cmd}{chaptermark}\Index{Kapitel}%
\BeginIndex{Cmd}{sectionmark}\Index{Abschnitt}%
\BeginIndex{Cmd}{subsectionmark}%
@@ -2498,13 +2368,29 @@ gibt, existieren die beiden Anweisungen auch nur bei diesen Klassen.%
einer der drei Anweisungen \Macro{chaptermarkformat},
\Macro{sectionmarkformat} und \Macro{subsectionmarkformat}.
- \OnlyAt{\Class{scrbook}\and \Class{scrreprt}}Während bei \Class{scrartcl}
- \Macro{chaptermark} und \Macro{chaptermarkformat} nicht existieren, gibt es
- die Anweisungen
+ Da\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} \KOMAScript{} zusätzlich die Gliederungsanweisungen
+ \Macro{addchap} und \Macro{addsec} bereitstellt, die nicht nummerierte
+ Überschriften erzeugen, existieren für diese auch korrespondierende
+ Anweisungen für den Kolumnentitel. Es ist zu beachten\textnote{Achtung!},
+ dass diese in der Voreinstellung ebenfalls auf \Macro{chaptermark} und
+ \Macro{sectionmark} zurück greifen, dabei aber lokal den Zähler
+ \Counter{secnumdepth} auf -1 setzen, um die Nummerierung von Kapiteln und
+ Abschnitten abzuschalten. Dies sollte man beispielsweise bei der
+ Umdefinierung von \Macro{chaptermark} und \Macro{sectionmark}
+ berücksichtigen (siehe \Macro{ifnumbered} auf
+ \autopageref{desc:maincls.cmd.ifnumbered}) oder \Macro{addchapmark} und
+ \Macro{addsecmark} ebenfalls dazu passend umdefinieren.
+
+ Während\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} bei \Class{scrartcl}
+ weder \Macro{chaptermark} noch \Macro{addchapmark} oder
+ \Macro{chaptermarkformat} existieren, gibt es die beiden Anweisungen
\OnlyAt{\Class{scrartcl}}\Macro{subsectionmark} und
- \Macro{subsectionmarkformat} nur bei \Class{scrartcl}. Dies ändert sich
- allerdings bei Verwendung des \Package{scrpage2}-Pakets (siehe
- \autoref{cha:scrpage}).
+ \Macro{subsectionmarkformat} nur bei \Class{scrartcl}. Bei Verwendung des
+ Pakets \Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage}\iffree{
+ oder \Package{scrpage2}\IndexPackage{scrpage2}}{} ändert sich dies jedoch
+ (siehe \autoref{cha:scrlayer-scrpage}\iffree{ beziehungsweise
+ \autoref{cha:scrpage}}).
\end{Explain}
So wie mit \Macro{chapterformat} und \Macro{othersectionlevelsformat} die
Nummern der Gliederungsüberschriften formatiert ausgegeben werden, werden mit
@@ -2516,7 +2402,8 @@ Originaldefinitionen aus den {\KOMAScript}-Klassen sind:
\begin{lstcode}
\newcommand*{\chaptermarkformat}{%
\chapappifchapterprefix{\ }\thechapter\autodot\enskip}
- \newcommand*{\sectionmarkformat}{\thesection\autodot\enskip}
+ \newcommand*{\sectionmarkformat}{%
+ \thesection\autodot\enskip}
\newcommand*{\subsectionmarkformat}{%
\thesubsection\autodot\enskip}
\end{lstcode}
@@ -2529,38 +2416,108 @@ Originaldefinitionen aus den {\KOMAScript}-Klassen sind:
\chapapp~\thechapter\autodot\enskip}
\end{lstcode}
\end{Example}
-Wie Sie sehen, finden hier bei der Umdefinierung die Anweisungen
-\Macro{chapappifchapterprefix} und \Macro{chapapp} Verwendung, die weiter oben
-erklärt wurden.%
-%
+Wie Sie sehen, finden hier die beiden Anweisungen \Macro{chapapp} und
+\Macro{chapappifchapterprefix} Verwendung, die weiter oben erklärt wurden.%
\EndIndex{Cmd}{chaptermark}%
\EndIndex{Cmd}{sectionmark}%
\EndIndex{Cmd}{subsectionmark}%
\EndIndex{Cmd}{chaptermarkformat}%
\EndIndex{Cmd}{sectionmarkformat}%
\EndIndex{Cmd}{subsectionmarkformat}%
+\EndIndex{Cmd}{addsecmark}%
+\EndIndex{Cmd}{addchapmark}%
\begin{Declaration}
- \Counter{secnumdepth}
+ \Counter{secnumdepth}\\
+ \Macro{partnumdepth}\\
+ \Macro{chapternumdepth}\\
+ \Macro{sectionnumdepth}\\
+ \Macro{subsectionnumdepth}\\
+ \Macro{subsubsectionnumdepth}\\
+ \Macro{paragraphnumdepth}\\
+ \Macro{subparagraphnumdepth}
\end{Declaration}%
\BeginIndex{Counter}{secnumdepth}\BeginIndex{}{Nummerierung}%
+\BeginIndex{Cmd}{partnumdepth}%
+\BeginIndex{Cmd}{chapternumdepth}%
+\BeginIndex{Cmd}{sectionnumdepth}%
+\BeginIndex{Cmd}{subsectionnumdepth}%
+\BeginIndex{Cmd}{subsubsectionnumdepth}%
+\BeginIndex{Cmd}{paragraphnumdepth}%
+\BeginIndex{Cmd}{subparagraphnumdepth}%
Normalerweise werden bei den Klassen \Class{scrbook}\IndexClass{scrbook} und
\Class{scrreprt}\IndexClass{scrreprt} die Gliederungsebenen
\Macro{part}\IndexCmd{part}\IndexCmd{chapter}\IndexCmd{section} bis
\Macro{subsection}\IndexCmd{subsection} und bei der Klasse
\Class{scrartcl}\IndexClass{scrartcl} die Ebenen \Macro{part} bis
\Macro{subsubsection}\IndexCmd{subsubsection} nummeriert. Gesteuert wird dies
-über den \LaTeX-Zähler \Counter{secnumdepth}. Dabei steht der Wert \(-\)1 für
-\Macro{part}, 0 für \Macro{chapter} und so weiter. Durch Setzen oder Erhöhen
-oder Verringern des Zählers kann bestimmt werden, bis zu welcher
-Gliederungsebene eine Nummerierung erfolgen soll. Dies ist übrigens bei den
-Standardklassen ganz genauso. Vergleichen Sie hierzu auch die Erklärung zum
-Zähler \Counter{tocdepth} in \autoref{sec:maincls.toc},
-\autopageref{desc:maincls.counter.tocdepth}.%
+über den \LaTeX-Zähler \Counter{secnumdepth}.
+
+Damit\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} sich der Anwender keine abstrakten Nummern merken muss, um
+einstellen zu können, bis zu welcher Gliederungsebene die Überschriften
+nummeriert werden sollen, gibt es die Anweisungen \Macro{partnumdepth} bis
+\Macro{subparagraphnumdepth}. Diese liefern die entsprechende Nummer zur
+jeweiligen Gliederungsebene.
+\begin{Example}
+ Sie wollen, dass in einem Buchprojekt nur die Gliederungsebenen vom Teil
+ (engl. \emph{part}) über das Kapitel (engl. \emph{chapter}) bis zum
+ Abschnitt (engl. \emph{section}) nummeriert werden. Dazu müssen Sie
+ in der Dokumentpräambel den Zähler \Counter{secnumdepth} auf den Wert
+ setzen, den die Anweisung \Macro{sectionnumdepth} liefert:
+\begin{lstcode}
+ \setcounter{secnumdepth}{\sectionnumdepth}
+\end{lstcode}
+\end{Example}
+Eine Umdefinierung der Anweisungen ist nicht vorgesehen und wird ausdrücklich
+nicht empfohlen, da dies zu unvorhergesehenen Ergebnissen sowohl mit
+\KOMAScript{} als auch bei Verwendung von Drittpaketen führen kann.
+
+Der Zähler \Counter{secnumdepth} ist nicht zu verwechseln mit dem Zähler
+\Counter{tocdepth} (siehe \autoref{sec:maincls.toc},
+\autopageref{desc:maincls.counter.tocdepth}). Auch sind die Werte je nach
+Klasse nicht eins zu eins übertragbar.%
%
+\EndIndex{Cmd}{subparagraphnumdepth}%
+\EndIndex{Cmd}{paragraphnumdepth}%
+\EndIndex{Cmd}{subsubsectionnumdepth}%
+\EndIndex{Cmd}{subsectionnumdepth}%
+\EndIndex{Cmd}{sectionnumdepth}%
+\EndIndex{Cmd}{chapternumdepth}%
+\EndIndex{Cmd}{partnumdepth}%
\EndIndex{Counter}{secnumdepth}\EndIndex{}{Nummerierung}
+\begin{Declaration}
+ \Macro{ifnumbered}\Parameter{Gliederungsebene}%
+ \Parameter{Dann-Teil}\Parameter{Else-Teil}\\
+ \Macro{ifunnumbered}\Parameter{Gliederungsebene}%
+ \Parameter{Dann-Teil}\Parameter{Else-Teil}
+\end{Declaration}
+\BeginIndex{Cmd}{ifnumbered}%
+\BeginIndex{Cmd}{ifunnumbered}%
+Nachdem\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} zuvor erklärt wurde, wie man bestimmen kann, welche
+Gliederungsebenen nummeriert werden sollen, kann mit diesen Anweisungen nun
+Code abhängig davon, ob eine \PName{Gliederungsebene} nummeriert wird oder
+nicht, ausgeführt werden. Wird mit den aktuellen Einstellungen eine
+\PName{Gliederungsebene} nummeriert, so führt \Macro{ifnumbered} den
+\PName{Dann-Teil} aus, während \Macro{ifunnumbered} den \PName{Else-Teil}
+ausführt. Wird mit den aktuellen Einstellungen eine \PName{Gliederungsebene}
+nicht nummeriert, dann führt \Macro{ifnumbered} den \PName{Else-Teil} aus,
+wohingegen \Macro{ifunnumbered} den \PName{Dann-Teil} ausführt. Als
+\PName{Gliederungsebene} wird der englische Name der Ebene angegeben, also
+\PValue{part}, \PValue{chapter}, \PValue{section}, \PValue{subsection},
+\PValue{subsubsection}, \PValue{paragraph} oder \PValue{subparagraph}.
+
+\KOMAScript{} selbst verwendet diesen Test beispielsweise in der Definition
+von \Macro{chaptermark}\IndexCmd{chaptermark} beim Seitenstil
+\Pagestyle{headings}\IndexPagestyle{headings}. Dadurch wird indirekt auch
+sichergestellt, dass Überschriften mit \Macro{addchap} den Kolumnentitel nicht
+mit einer Nummer versehen (siehe auch \Macro{addchapmark},
+\autopageref{desc:maincls.cmd.addchapmark}).%
+\EndIndex{Cmd}{ifnumbered}%
+\EndIndex{Cmd}{ifunnumbered}%
\begin{Declaration}
\Macro{setpartpreamble}%
@@ -2590,8 +2547,7 @@ Anweisung zum Setzen der \PName{Präambel} muss vor der jeweiligen
\setpartpreamble{%
\begin{abstract}
Dies ist ein Blindtext zur Demonstration.
- \end{abstract}
- }
+ \end{abstract}}
\part{Abteilung Grünschnitt}
\end{lstcode}
Je nach Einstellung der Optionen für die
@@ -2624,16 +2580,13 @@ optionale Argument \PName{Position} bestimmt über ein bis zwei
Buchstaben die Position, an der die Präambel ausgegeben wird. Für die
vertikale Position existieren derzeit zwei Möglichkeiten:
%\iffree{}{\pagebreak}% Umbruchoptimierung
-\begin{labeling}[~--]{\quad\PValue{o}}\itemsep=0pt
+\begin{labeling}[~--]{\quad\PValue{o}}\itemsep=-\parsep
\item [\quad\PValue{o}] über der Überschrift
\item [\quad\PValue{u}] unter der Überschrift
-\end{labeling}
-\iffree{Es kann jeweils eine Präambel unter und eine Präambel über der
- Überschrift gesetzt werden.}{Beide Möglichkeiten können nacheinander genutzt
- werden.}
-
-Für die horizontale Position existieren derzeit drei Möglichkeiten:
-\begin{labeling}[~--]{\quad\PValue{o}}\itemsep=0pt
+\end{labeling}\pagebreak[3]% Umbruchkorrektur
+Es kann so jeweils eine Präambel unter und über der Überschrift gesetzt werden,
+mit drei Möglichkeiten für die horizontale Position:
+\begin{labeling}[~--]{\quad\PValue{o}}\itemsep=-\parsep
\item [\quad\PValue{l}] linksbündig
\item [\quad\PValue{r}] rechtsbündig
\item [\quad\PValue{c}] zentriert
@@ -2781,8 +2734,8 @@ Unterschrift formatiert. Darüber hinaus wird zwischen ein"~ und mehrzeiligen
Unterschriften unterschieden, wobei einzeilige Unterschriften horizontal
zentriert werden.
-\leavevmode\phantomsection\nobreak
-\label{desc:maincls.option.captions.tableheading}\nobreak
+\leavevmode\phantomsection\nobreak%
+\label{desc:maincls.option.captions.tableheading}\nobreak%
Tabellen werden jedoch häufig mit Überschriften statt mit Unterschriften
versehen. Das liegt daran, dass es auch Tabellen geben kann, die sich über
mehrere Seiten erstrecken. Bei solchen Tabellen möchte man natürlich bereits
@@ -2790,9 +2743,9 @@ auf der ersten Seite wissen, worum es sich handelt. Darüber hinaus werden
Tabellen zeilenweise von oben nach unten gelesen. Damit gibt es mindestens
zwei gute Gründe, in der Regel alle Tabellen mit Überschriften zu
versehen. \KOMAScript{}\important{\OptionValue{captions}{tableheading}} bietet
-daher mit der Einstellung
-\OptionValue{captions}{tableheading}\IndexOption{captions~=\PValue{tableheading}} die
-Möglichkeit, bei Tabellen die Formatierung auf Überschriften zu ändern.
+daher mit der Einstellung \OptionValue{captions}{tableheading}%
+\IndexOption{captions~=\PValue{tableheading}} die Möglichkeit, bei Tabellen
+die Formatierung auf Überschriften zu ändern.
Es\textnote{Achtung!} sei an dieser Stelle darauf hingewiesen, dass
mehrseitige Tabellen nicht als Gleitumgebungen gesetzt werden können. Für den
@@ -2804,7 +2757,8 @@ Mit\important[i]{\begin{tabular}[t]{@{}l@{}}
\Option{captions=}\\
\quad\PValue{tablesignature}
\end{tabular}} der Einstellung
-\OptionValue{captions}{tablesignature}\IndexOption{captions~=\PValue{tablesignature}}
+\OptionValue{captions}{tablesignature}%
+\IndexOption{captions~=\PValue{tablesignature}}
wird wieder die Voreinstellung der Formatierung als Tabellenunterschrift
gewählt. Es\textnote{Achtung!} sei an dieser Stelle darauf hingewiesen, dass
die beiden Werte lediglich die Formatierung ändern. Der Ort, an dem die Über"~
@@ -2816,8 +2770,10 @@ verwendet wird. Dies ändert sich jedoch bei Verwendung des Pakets
Natürlich existiert\ChangedAt{v3.09}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} mit den Optionen
-\OptionValue{captions}{figureheading}\IndexOption{captions~=\PValue{figureheading}} und
-\OptionValue{captions}{figuresignature}\IndexOption{captions~=\PValue{figuresignature}}
+\OptionValue{captions}{figureheading}%
+\IndexOption{captions~=\PValue{figureheading}} und
+\OptionValue{captions}{figuresignature}%
+\IndexOption{captions~=\PValue{figuresignature}}
auch die entsprechende Funktion für Abbildungen. Allerdings werden Abbildungen
in der Regel wie im Falle von Fotos eher als Ganzes und im Falle von
Diagrammen oder Graphen eher von unten links her betrachtet. In den wenigsten
@@ -2828,12 +2784,13 @@ Manchmal wird jedoch gewünscht, alle Gleitumgebungen mit Überschriften zu
versehen. Daher gibt es bei \KOMAScript{} die Einstellung
\important[i]{\OptionValue{captions}{heading}\\
\OptionValue{captions}{signature}} Optionen
-\OptionValue{captions}{heading}\IndexOption{captions~=\PValue{heading}} und die
+\OptionValue{captions}{heading}%
+\IndexOption{captions~=\PValue{heading}} und die
umgekehrte Einstellung
-\OptionValue{captions}{signature}\IndexOption{captions~=\PValue{signature}}, mit der
-man die Formatierungen aller Gleitumgebungen entsprechend ändern kann. Diese
-entfalten ihre Wirkung auch noch, wenn sie innerhalb einer Gleitumgebung
-verwendet werden.
+\OptionValue{captions}{signature}\IndexOption{captions~=\PValue{signature}},
+mit der man die Formatierungen aller Gleitumgebungen entsprechend ändern
+kann. Diese entfalten ihre Wirkung auch noch, wenn sie innerhalb einer
+Gleitumgebung verwendet werden.
Bitte\textnote{Achtung!}\OnlyAt{\Package{float}}\IndexPackage{float} beachten
Sie, dass bei Verwendung des \Package{float}-Pakets die Einstellungen von
@@ -3117,7 +3074,7 @@ entnehmen.
\begin{lstcode}
\setkomafont{captionlabel}{\sffamily\bfseries}
\end{lstcode}
- Das Ergebnis wäre bei Verwendung von \Macro{addkomafont} in diesem Fall
+ Das Ergebnis wäre bei Verwendung von \Macro{addtokomafont} in diesem Fall
übrigens gleich.
\end{Example}%
\EndIndex[indexother]{}{Schrift>Art}%
@@ -3174,7 +3131,7 @@ Paket zu beachten!%
\captionaboveof{table}
[Maße des Rechtecks aus
Abbildung~\ref{fig:rechteck}]%
- {Maße des Rechtecks}
+ {Rechtecksmaße}
\label{tab:rechteck}
\begin{tabular}{ll}
Breite: & 4\,cm\\
@@ -3285,7 +3242,8 @@ der Gleitumgebungen verwendet werden. Der erste optionale Parameter
Ob der \PName{Titel} rechts oder links daneben gesetzt wird, kann mit
dem optionalen Parameter \PName{Anordnung} bestimmt werden. Es darf
genau einer der folgenden Buchstaben angegeben werden:
-\begin{labeling}[~--]{\quad\PValue{o}}\setlength{\itemsep}{0pt}%
+\iffree{}{\enlargethispage*{\dp\strutbox}}% Umbruchkorrektur
+\begin{labeling}[~--]{\quad\PValue{o}}\setlength{\itemsep}{-\parsep}%
\item[\quad\PValue{l}] links
\item[\quad\PValue{r}] rechts
\item[\quad\PValue{i}] innen: auf rechten Seiten links, auf
@@ -3300,10 +3258,11 @@ Voreinstellung\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
\autopageref{desc:maincls.option.captions}) und deren Werte
\PValue{innerbeside}\IndexOption[indexmain]{captions~=\PValue{innerbeside}},
\PValue{leftbeside}\IndexOption[indexmain]{captions~=\PValue{leftbeside}},
-\PValue{outerbeside}\IndexOption[indexmain]{captions~=\PValue{outerbeside}} und
-\PValue{rightbeside}\IndexOption[indexmain]{captions~=\PValue{rightbeside}} verändert
-werden. Bei Verwendung der Anordnung außen oder innen werden unter Umständen
-zwei \LaTeX-Läufe benötigt, um die korrekte Anordnung zu erreichen.
+\PValue{outerbeside}\IndexOption[indexmain]{captions~=\PValue{outerbeside}}
+und
+\PValue{rightbeside}\IndexOption[indexmain]{captions~=\PValue{rightbeside}}
+verändert werden. Bei Verwendung der Anordnung außen oder innen werden unter
+Umständen zwei \LaTeX-Läufe benötigt, um die korrekte Anordnung zu erreichen.
Normalerweise nehmen der Inhalt der Umgebung und der \PName{Titel} die
gesamte verfügbare Breite ein. Es besteht jedoch die Möglichkeit, mit
@@ -3336,14 +3295,15 @@ Einstellung\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
\Option{captions}\IndexOption{captions} (siehe
\autopageref{desc:maincls.option.captions}) und deren Werte
\PValue{topbeside}\IndexOption[indexmain]{captions~=\PValue{topbeside}},
-\PValue{centeredbeside}\IndexOption[indexmain]{captions~=\PValue{centeredbeside}} und
-\PValue{bottombeside}\IndexOption[indexmain]{captions~=\PValue{bottombeside}} verändert
-werden. Bei der Einstellung \PValue{topbeside} werden die oberen Grundlinien
-von Gleitobjektinhalt und \PName{Titel} auf einer Höhe ausgerichtet, während
-bei \PValue{centeredbeside} eine Zentrierung stattfindet. In diesem
-Zusammenhang sei erwähnt, dass Abbildungen normalerweise die Grundlinie unten
-haben. Dies kann beispielsweise mit der Anweisung
-\Macro{raisebox}\IndexCmd{raisebox} verändert werden.
+\PValue{centeredbeside}\IndexOption[indexmain]{captions~=\PValue{centeredbeside}}
+und
+\PValue{bottombeside}\IndexOption[indexmain]{captions~=\PValue{bottombeside}}
+verändert werden. Bei der Einstellung \PValue{topbeside} werden die oberen
+Grundlinien von Gleitobjektinhalt und \PName{Titel} auf einer Höhe
+ausgerichtet, während bei \PValue{centeredbeside} eine Zentrierung
+stattfindet. In diesem Zusammenhang sei erwähnt, dass Abbildungen
+normalerweise die Grundlinie unten haben. Dies kann beispielsweise mit der
+Anweisung \Macro{raisebox}\IndexCmd{raisebox} verändert werden.
\begin{Example}
Ein Beispiel für die Verwendung der
@@ -3379,22 +3339,29 @@ haben. Dies kann beispielsweise mit der Anweisung
\label{fig:maincls.captionbeside}
\end{figure}
Die Gesamtbreite ist also die aktuell verfügbare Breite
- \PValue{\Macro{linewidth}}. Diese wird jedoch mit \PValue{2em} nach
+ \PValue{\Macro{linewidth}}. Diese wird jedoch mit um $\Length{marginparwidth}
+ + \Length{marginparsep}$ nach
außen verschoben. Der Titel oder die Beschreibung steht innen neben
- der Abbildung. Damit erscheint die Abbildung selbst um 2\Unit{em} in
- den Rand gerückt.
+ der Abbildung. Damit erscheint die Abbildung selbst bis in die
+ Marginalienspalte in den Rand gerückt.
+\iffalse% Umbruchkorrekturtext
Mit \Macro{dimexpr} wird hier eine \eTeX-Anweisung verwendet, da
\KOMAScript{} dessen Verwendung voraussetzt und bei jeder halbwegs aktuellen
- \LaTeX-Distribution ohnehin \eTeX{} verwendet wird.
+ \LaTeX-Distribution ohnehin \eTeX{} verwendet wird.%
+\fi
Die Zentrierung der Bildbeschreibung mit
\begin{lstcode}
\KOMAoption{captions}{centeredbeside}
\end{lstcode}
- zeigt \autoref{fig:maincls.captionbesidecentered}. Auch der typografisch
- weniger bewanderte Anfänger wird sofort
- erkennen, dass von dieser Ausrichtung normalerweise abzusehen ist.
+ zeigt \autoref{fig:maincls.captionbesidecentered}. %
+\iffalse % Umbruchalternativen
+ Auch der typografisch weniger bewanderte Anfänger wird sofort
+ erkennen, dass von dieser Ausrichtung normalerweise abzusehen ist.%
+\else
+ Das ist jedoch sicher keine empfehlswerte Lösung.%
+\fi
\begin{figure}
\KOMAoption{captions}{centeredbeside}
@@ -3877,14 +3844,16 @@ auch bei den Standardklassen gibt, dient dazu, diese Verzeichnisse nach
Kapiteln zu gruppieren. Es entspricht bei \KOMAScript{} der
Einstellung\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}
-\OptionValue{listof}{chaptergapsmall}\IndexOption{listof~=\PValue{chaptergapsmall}}.
+\OptionValue{listof}{chaptergapsmall}%
+\IndexOption{listof~=\PValue{chaptergapsmall}}.
Dabei wird ein fester vertikaler Abstand von 10\Unit{pt}
verwendet. Mit\important{\OptionValue{listof}{chaptergapline}} der Einstellung
-\OptionValue{listof}{chaptergapline}\IndexOption{listof~=\PValue{chaptergapline}} kann
+\OptionValue{listof}{chaptergapline}%
+\IndexOption{listof~=\PValue{chaptergapline}} kann
man stattdessen einen vertikalen Abstand von einer Zeile
erreichen. Mit\important{\OptionValue{listof}{nochaptergap}}
-\OptionValue{listof}{nochaptergap}\IndexOption{listof~=\PValue{nochaptergap}} kann man
-den vertikalen Abstand komplett
+\OptionValue{listof}{nochaptergap}\IndexOption{listof~=\PValue{nochaptergap}}
+kann man den vertikalen Abstand komplett
abschalten. Eine\important{\OptionValue{listof}{chapterentry}} Besonderheit
stellt die Einstellung
\OptionValue{listof}{chapterentry}\IndexOption{listof~=\PValue{chapterentry}}
@@ -3902,9 +3871,8 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von
\begin{desclist}
\desccaption[{Mögliche Werte für Option \Option{listof}}]{%
- Mögliche Werte für
- Option \Option{listof} zur Einstellung von Form und Inhalt der
- Verzeichnisse der Gleitumgebungen\label{tab:maincls.listof}%
+ Mögliche Werte für Option \Option{listof} zur Einstellung von Form und
+ Inhalt der Verzeichnisse der Gleitumgebungen\label{tab:maincls.listof}%
}{%
Mögliche Werte für Option \Option{listof} (\emph{Fortsetzung})%
}%
@@ -3941,6 +3909,38 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von
steht nur ein begrenzter Platz für die Gleitumgebungsnummern zur
Verfügung.%
\IndexOption{listof~=\PValue{graduated}}}%
+ \entry{\PValue{indenttextentries}, \PValue{indentunnumbered},
+ \PValue{numberline}}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ Die Eigenschaft \PValue{numberline} (siehe \autoref{sec:tocbasic.toc},
+ \autopageref{desc:tocbasic.cmd.setuptoc}) wird für die Verzeichnisse der
+ Gleitumgebungen, beispielsweise das Abbildungs"~ und das
+ Tabellenverzeichnis, gesetzt. Dadurch werden nicht nummerierte Einträge
+ linksbündig mit dem Text von nummerierten Einträgen gleicher Ebene
+ gesetzt. Allerdings bieten die \KOMAScript-Klassen selbst keine nicht
+ nummerierten Einträge in diese Verzeichnisse. Dies hat daher nur
+ Auswirkungen auf entsprechende Einträge, die nicht von den Klassen selbst,
+ aber dennoch mit Hilfe von \Macro{addxcontentsline} (siehe
+ \autoref{sec:tocbasic.toc},
+ \autopageref{desc:tocbasic.cmd.addxcontentsline}) erzeugt werden.%
+ \IndexOption{toc~=\PValue{numberline}}}%
+ \entry{\PValue{leftaligntextentries}, \PValue{leftalignunnumbered},
+ \PValue{nonumberline}}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ Die Eigenschaft \PValue{numberline} (siehe \autoref{sec:tocbasic.toc},
+ \autopageref{desc:tocbasic.cmd.setuptoc}) wird für die Verzeichnisse der
+ Gleitumgebungen, beispielsweise das Abbildungs"~ und das
+ Tabellenverzeichnis, gesetzt. Dadurch werden nicht nummerierte Einträge
+ linksbündig mit der Nummer von nummerierten Einträgen gleicher Ebene
+ gesetzt. Allerdings bieten die \KOMAScript-Klassen selbst keine nicht
+ nummerierten Einträge in diese Verzeichnisse. Dies hat daher nur
+ Auswirkungen auf entsprechende Einträge, die nicht von den Klassen selbst,
+ aber dennoch mit Hilfe von \Macro{addxcontentsline} (siehe
+ \autoref{sec:tocbasic.toc},
+ \autopageref{desc:tocbasic.cmd.addxcontentsline}) erzeugt werden.%
+ \IndexOption{toc~=\PValue{numberline}}}%
\entry{\PValue{leveldown}}{%
Die Verzeichnisse werden um eine Gliederungsebene nach unten verschoben.%
\IndexOption{listof~=\PValue{leveldown}}}%
@@ -4078,7 +4078,8 @@ Literaturverzeichnisses bestimmt, können über die Einstellungen von
einige wenige Eigenschaften der Formatierung der Einträge beeinflusst werden.
Mit\important{\OptionValue{bibliography}{oldstyle}}
-\OptionValue{bibliography}{oldstyle}\IndexOption{bibliography~=\PValue{oldstyle}} wird
+\OptionValue{bibliography}{oldstyle}%
+\IndexOption{bibliography~=\PValue{oldstyle}} wird
die kompakte Formatierung gewählt. Dabei führt die Anweisung
\Macro{newblock}\IndexCmd{newblock} in den einzelnen Einträgen lediglich zu
einem dehnbaren horizontalen Abstand. Der Name kommt daher, dass dies die
@@ -4087,7 +4088,8 @@ ist. Demgegenüber\important[i]{\begin{tabular}[t]{@{}l@{}}
\Option{bibliography=}\\
\quad\PValue{openstyle}\end{tabular}} erreicht
man die etwas modernere, offene Form mit der Einstellung
-\OptionValue{bibliography}{openstyle}\IndexOption{bibliography~=\PValue{openstyle}}. Der
+\OptionValue{bibliography}{openstyle}%
+\IndexOption{bibliography~=\PValue{openstyle}}. Der
Name kommt daher, dass hier die Anweisung \Macro{newblock} einen Absatz
einfügt. Die Einträge im Literaturverzeichnis werden so stärker
gegliedert. Sie sind weniger kompakt und deutlich aufgelockerter oder
@@ -4102,33 +4104,46 @@ aufgelistet, sondern auf externe Inhalte verwiesen
wird. Mit dieser Begründung
könnte man argumentieren, dass das Literaturverzeichnis ein eigenes Kapitel
bzw. einen eigenen Abschnitt darstellt und somit eine
-Nummer\important[i]{\begin{tabular}[t]{@{}l@{}}
+Nummer verdiene. Die
+Einstellung \OptionValue{bibliography}{totocnumbered}%
+\important[i]{\begin{tabular}[t]{@{}l@{}}
\Option{bibliography=}\\
\quad\PValue{totocnumbered}
- \end{tabular}} verdiene. Die
-Einstellung \OptionValue{bibliography}{totocnumbered}%
-\IndexOption{bibliography~=\PValue{totocnumbered}} führt genau dazu, einschließlich des
-dann fälligen Eintrags im Inhaltsverzeichnis. Ich selbst bin der Meinung,
-dass bei dieser Argumentation auch ein klassisches, kommentiertes
-Quellenverzeichnis ein eigenes Kapitel wäre. Außerdem ist das
+ \end{tabular}}\IndexOption{bibliography~=\PValue{totocnumbered}} führt genau
+dazu, einschließlich des dann fälligen Eintrags im Inhaltsverzeichnis. Ich
+selbst bin der Meinung, dass bei dieser Argumentation auch ein klassisches,
+kommentiertes Quellenverzeichnis ein eigenes Kapitel wäre. Außerdem ist das
Literaturverzeichnis letztlich nichts, was man selbst geschrieben
hat. Deshalb\important{\OptionValue{bibliography}{totoc}}
verdient es allenfalls einen nicht nummerierten Eintrag im
Inhaltsverzeichnis, was mit der Einstellung
-\OptionValue{bibliography}{totoc}\IndexOption{bibliography~=\PValue{totoc}} erreicht
-wird. Die Voreinstellung, bei der das Literaturverzeichnis als nicht
+\OptionValue{bibliography}{totoc}\IndexOption{bibliography~=\PValue{totoc}}
+erreicht wird. Die Voreinstellung, bei der das Literaturverzeichnis als nicht
nummeriertes Kapitel ohne eigenen Inhaltsverzeichniseintrag gesetzt wird,
-entspricht
-\OptionValue{bibliography}{nottotoc}\IndexOption{bibliography~=\PValue{nottotoc}}. Siehe
+entspricht \OptionValue{bibliography}{nottotoc}%
+\IndexOption{bibliography~=\PValue{nottotoc}}. Siehe
hierzu auch Option \Option{toc} in \autoref{sec:maincls.toc},
insbesondere die Werte \PValue{bibliographynumbered}, \PValue{bibliography}
und \PValue{nobibliography} ab
\autopageref{desc:maincls.option.toc.bibliography}.
-Eine Zusammenfassung der möglichen Werte für die \PName{Einstellung} von
-\Option{bibliography} ist in \autoref{tab:maincls.bibliography} zu finden. Es
-ist jedoch zu beachten, dass mit \Macro{newbibstyle}\IndexCmd{newbibstyle}
-weitere Werte definiert werden können.
+In\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}
+einigen Fällen wird nicht das gesamte Dokumente mit einem einzigen
+Literaturverzeichnis versehen, sondern jedes Kapitel eines mit \Class{scrbook}
+oder \Class{scrreprt} gesetzten Dokuments erhält sein eigenes
+Literaturverzeichnis. In diesem Fall ist es sinnvoll,
+wenn\important{\OptionValue{bibliography}{leveldown}} das Literaturverzeichnis
+selbst nicht auf Kapitel, sondern etwas tiefer auf Abschnittsebene angesiedelt
+wird. Dies ist mit Option \OptionValue{bibliography}{leveldown}%
+\IndexOption{bibliography~=\PValue{leveldown}} zu erreichen. Diese kann
+beispielsweise auch verwendet werden, wenn das Literaturverzeichnis zusammen
+mit anderen Verzeichnissen unter einer gemeinsamen Überschrift erscheinen
+soll. Daher ist diese Option auch in \Class{scrartcl} verfügbar.
+
+Eine Zusammenfassung möglicher Werte für \PName{Einstellung} ist
+\autoref{tab:maincls.bibliography} zu entnehmen. Es ist jedoch zu beachten,
+dass mit \Macro{newbibstyle}\IndexCmd{newbibstyle} weitere Werte definiert
+werden können.
\begin{table}
\caption[{Mögliche Werte für Option \Option{bibliography}}]{Vordefinierte
@@ -4136,6 +4151,12 @@ weitere Werte definiert werden können.
Literatur\-verzeichnisses}
\label{tab:maincls.bibliography}
\begin{desctabular}
+ \pventry{leveldown}{%
+ \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ Das Literaturverzeichnis wird um eine Gliederungsebene nach unten
+ verschoben.%
+ \IndexOption{bibliography~=\PValue{leveldown}}}%
\pventry{nottotoc}{%
Das Literaturverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis
und wird auch nicht nummeriert.%
@@ -4171,8 +4192,8 @@ Mit der Anweisung \Macro{setbibpreamble} kann eine Präambel für das
Literaturverzeichnis gesetzt werden. Bedingung dafür ist, dass die Präambel
vor der Anweisung zum Setzen des Literaturverzeichnisses gesetzt wird. Dies
muss nicht unmittelbar davor sein. Es kann also beispielsweise am Anfang des
-Dokuments erfolgen. Ebenso\textnote{Achtung!} wie die Optionen
-\OptionValue{bibliography}{totoc} und
+Dokuments erfolgen. Ebenso\textnote{Achtung!} wie Option
+\OptionValue{bibliography}{totoc} oder
\OptionValue{bibliography}{totocnumbered} kann die Anweisung aber nur
erfolgreich sein, wenn nicht ein Paket geladen wird, das dies durch
Umdefinierung der \Environment{thebibliography}-Umgebung verhindert. Obwohl
@@ -4272,7 +4293,8 @@ nicht jedoch bei Verwendung von
\end{Declaration}
\BeginIndex{Option}{index~=\PName{Einstellung}}%
\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
-In der Voreinstellung \OptionValue{index}{default}\IndexOption{index~=\PValue{default}}
+In der Voreinstellung
+\OptionValue{index}{default}\IndexOption{index~=\PValue{default}}
ist das Stichwortverzeichnis ein nicht nummeriertes Kapitel ohne Eintrag im
Inhaltsverzeichnis. Da\important{\OptionValue{index}{totoc}} das
Stichwortverzeichnis normalerweise in einem Buch oder ähnlichen Dokument
@@ -4280,8 +4302,8 @@ zuletzt steht, benötigt es eigentlich auch keinen
Inhaltsverzeichniseintrag. Wird dieser dennoch gewünscht, beispielsweise weil
wie in \iffree{dieser Anleitung}{diesem Buch} mit einem mehrgliedrigen
Stichwortverzeichnis gearbeitet wird, so kann dies mit der Einstellung
-\OptionValue{index}{totoc}\IndexOption{index~=\PValue{totoc}} erreicht werden. Siehe
-hierzu auch Option \Option{toc} mit dem Wert \PValue{index} in
+\OptionValue{index}{totoc}\IndexOption{index~=\PValue{totoc}} erreicht
+werden. Siehe hierzu auch Option \Option{toc} mit dem Wert \PValue{index} in
\autoref{sec:maincls.toc} ab \autopageref{desc:maincls.option.toc.index}.
Eine Zusammenfassung der möglichen Werte für die \PName{Einstellung} von
@@ -4338,9 +4360,12 @@ ist im Makro \Macro{indexpagestyle} abgelegt (siehe
Für die Erstellung, Sortierung und Ausgabe des Stichwortverzeichnisses
sind die üblichen Standard-\LaTeX-Pakete und Zusatzprogramme
-zuständig. Von {\KOMAScript} werden genau wie von den Standardklassen
-lediglich die grundlegenden Makros und Umgebungen dafür zur Verfügung
-gestellt.%
+zuständig.%
+\iffalse % Umbruchoptimierung
+ \ Von {\KOMAScript} werden genau wie von den Standardklassen
+ lediglich die grundlegenden Makros und Umgebungen dafür zur Verfügung
+ gestellt.%
+\fi
%
\EndIndex{Cmd}{setindexpreamble}%
%
@@ -4354,6 +4379,8 @@ gestellt.%
%%% Local Variables:
%%% mode: latex
+%%% mode: flyspell
%%% coding: iso-latin-1
-%%% TeX-master: "guide.tex"
+%%% ispell-local-dictionary: "de_DE"
+%%% TeX-master: "../guide.tex"
%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrextend.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrextend.tex
index 361d712f99e..c68e770ce5d 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrextend.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrextend.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrextend.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrextend.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,7 @@
%
% ======================================================================
-\ProvidesFile{scrextend.tex}[2008/09/12 KOMA-Script package scrextend]
+\ProvidesFile{scrextend.tex}[2013/05/31 KOMA-Script package scrextend]
\chapter[tocentry={Grundlegende Fähigkeiten der
\KOMAScript-Klassen\protect\linebreak
@@ -162,35 +162,6 @@ optionales Argument von \Macro{usepackage}\PParameter{scrextend} an.
\LoadCommon{5}% \section{Textauszeichnungen}
-Mit der Anweisung \Macro{usekomafont} kann die aktuelle Schriftart auf
-diejenige umgeschaltet werden, die für das angegebene \PName{Element}
-definiert ist.
-
-\begin{Example}
- Angenommen, Sie wollen, dass der Titel in Serifenschrift und rot gesetzt
- wird. Das erreichen Sie einfach mit:
-\begin{lstcode}
- \setkomafont{title}{\color{red}}
-\end{lstcode}
- Für die Anweisung \lstinline|\color{red}| wird das Paket \Package{color}
- oder \Package{xcolor} benötigt. Die zusätzliche Angabe von
- \Macro{normalfont} ist in diesem Beispiel deshalb nicht notwendig, weil
- diese Anweisung bereits in der Definition des Titels enthalten
- ist. Das\textnote{Achtung!} Beispiel setzt voraus, dass
- \OptionValue{extendedfeature}{title} gesetzt ist (siehe
- \autoref{sec:scrextend.optionalFeatures},
- \autopageref{desc:scrextend.option.extendedfeature}).
-\end{Example}
-%
-\EndIndex{Cmd}{setkomafont}%
-\EndIndex{Cmd}{addtokomafont}%
-\EndIndex{Cmd}{usekomafont}%
-%
-\EndIndex{}{Schrift>Art}%
-\EndIndex{}{Text>Auszeichnung}
-
-\newpage% Umbruchoptimierung!
-
\LoadCommon{14}% \section{Dokumenttitel}
\LoadCommon{7}% \section{Erkennung von rechten und linken Seiten}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-notecolumn-example.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-notecolumn-example.tex
new file mode 100644
index 00000000000..92d2ca4fd28
--- /dev/null
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-notecolumn-example.tex
@@ -0,0 +1,131 @@
+% ======================================================================
+% scrlayer-notecolumn-example.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ----------------------------------------------------------------------
+% scrlayer-notecolumn-example.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ======================================================================
+%
+% Example file for the chapter about scrlayer-notecolumn
+% of the KOMA-Script guide
+% Maintained by Markus Kohm
+%
+% ----------------------------------------------------------------------
+%
+% Beispieldatei für das Kapitel über scrlayer-notecolumn
+% in der KOMA-Script-Anleitung
+% Verwaltet von Markus Kohm
+%
+% ============================================================================
+\documentclass{scrartcl}
+\usepackage[ngerman]{babel}
+\usepackage{selinput}
+\SelectInputMappings{
+ adieresis={ä},
+ germandbls={ß},
+}
+\usepackage[T1]{fontenc}
+\usepackage{lmodern}
+\usepackage{xcolor}
+
+\usepackage{scrjura}
+\setkomafont{contract.Paragraph}{\bfseries}
+\setkeys{contract}{preskip=-\dp\strutbox}
+
+\usepackage{scrlayer-scrpage}
+\usepackage{scrlayer-notecolumn}
+
+\newlength{\paragraphscolwidth}
+\AfterCalculatingTypearea{%
+ \setlength{\paragraphscolwidth}{.333\textwidth}%
+ \addtolength{\paragraphscolwidth}{-\marginparsep}%
+}
+\recalctypearea
+\DeclareNewNoteColumn[%
+ position=\oddsidemargin+1in
+ +.667\textwidth
+ +\marginparsep,
+ width=\paragraphscolwidth,
+ font=\raggedright\footnotesize
+ \color{blue}
+]{paragraphs}
+
+\begin{document}
+
+\title{Kommentar zum GüdaVaS}
+\author{Professor R. O. Tenase}
+\date{11.\,11.\,2011}
+\maketitle
+\tableofcontents
+
+\section{Vormerkung}
+Das GüdaVaS ist ohne jeden Zweifel das wichtigste Gesetz, das in
+Spaßmaniern in den letzten eintausend Jahren verabschiedet wurde.
+Die erste Lesung fand bereits am 11.\,11\,1111 im obersten
+spaßmanischen Kongress statt, wurde aber vom damalige Spaßvesier
+abgelehnt. Erst nach Umwandlung der spaßmanischen, aberwitzigen Monarchie
+in eine repräsentative, witzige Monarchie durch W. Itzbold, den
+urkomischen, am 9.\,9.\,1999 war der Weg für dieses Gesetz endlich frei.
+
+\section{Analyse}
+
+\begin{addmargin}[0pt]{.333\textwidth}
+ \makenote[paragraphs]{%
+ \protect\begin{contract}
+ \protect\Paragraph{title={Kein Witz ohne Publikum}}
+ Ein Witz kann nur dort witzig sein, wo er auf ein Publikum trifft.
+ \protect\end{contract}
+ }
+ Dies ist eine der zentralsten Aussagen des Gesetzes. Sie ist derart
+ elementar, dass es durchaus angebracht ist, sich vor der Weisheit der
+ Verfasser zu verbeugen.
+
+ \syncwithnotecolumn[paragraphs]\bigskip
+ \makenote[paragraphs]{%
+ \protect\begin{contract}
+ \protect\Paragraph{title={Komik der Kultur}}
+ \setcounter{par}{0}Die Komik eines Witzes kann durch das kulturelle
+ Umfeld, in dem er erzählt wird, bestimmt sein.
+
+ Die Komik eines Witzes kann durch das kulturelle Umfeld, in dem er
+ spielt, bestimmt sein.
+ \protect\end{contract}
+ }
+ Die kulturelle Komponente eines Witzes ist tatsächlich nicht zu
+ vernachlässigen. Über die politische Korrektheit der Nutzung des kulturellen
+ Umfeldes kann zwar trefflich gestritten werden, nichtsdestotrotz ist die
+ Treffsicherheit einer solchen Komik in entsprechendem Umfeld frapierend. Auf
+ der anderen Seite kann ein vermeintlicher Witz im falschen kulturellen
+ Umfeld auch zu einer echten Gefahr für den Witzeerzähler werden.
+\end{addmargin}
+
+\end{document}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-notecolumn.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-notecolumn.tex
new file mode 100644
index 00000000000..53918019fc7
--- /dev/null
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-notecolumn.tex
@@ -0,0 +1,679 @@
+% ======================================================================
+% scrlayer-notecolumn.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ----------------------------------------------------------------------
+% scrlayer-notecolumn.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ======================================================================
+%
+% Chapter about scrlayer-notecolumn of the KOMA-Script guide
+% Maintained by Markus Kohm
+%
+% ----------------------------------------------------------------------
+%
+% Kapitel über scrlayer-notecolumn in der KOMA-Script-Anleitung
+% Verwaltet von Markus Kohm
+%
+% ============================================================================
+
+\KOMAProvidesFile{scrlayer-notecolumn.tex}%
+ [$Date: 2013-10-16 16:24:20 +0200 (Mi, 16. Okt 2013) $
+ KOMA-Script guide (chapter:scrlayer-notecolumn)]
+
+\chapter{Notizspalten mit \Package{scrlayer-notecolumn}}
+\labelbase{scrlayer-notecolumn}
+
+\BeginIndex{Package}{scrlayer-notecolumn}%
+Bis einschließlich Version~3.11b unterstützte \KOMAScript{} Notizspalten nur
+in Form der Marginalienspalte, die mit \Macro{marginpar} und
+\Macro{marginline} (siehe \autoref{sec:maincls.marginNotes},
+\autopageref{desc:maincls.cmd.marginline}) mit Inhalt versehen werden
+können. Jene Art der Randnotizen hat allerdings einige Nachteile:
+\begin{itemize}
+\item Randnotizen können nur vollständig auf einer einzelnen Seite gesetzt
+ werden. Seitenumbrüche innerhalb von Randnotizen sind nicht möglich. Dies
+ führt teilweise dazu, dass die Randnotizen bis in den unteren Rand hinein
+ ragen.
+\item Randnotizen in der Nähe des Seitenumbruchs können auf die nächste Seiten
+ rutschen und dort im Falle des doppelseitigen Layouts mit alternierenden
+ Marginalienspalten im falschen Rand ausgegeben werden. Dieses Problem ist
+ mit dem Zusatzpaket \Package{mparhack}\IndexPackage{mparhack} oder durch
+ Verwendung von \Macro{marginnote} aus dem Paket
+ \Package{marginnote}\IndexPackage{marginnote} lösbar.
+\item Randnotizen innerhalb von Gleitumgebungen oder Fußnoten sind nicht
+ möglich. Auch dieses Problem ist mit \Package{marginnote} lösbar.
+\item Es gibt nur eine Marginalienspalte oder, wenn mit
+ \Macro{reversemarginpar} und \Macro{normalmarginpar} gearbeitet wird, auch
+ zwei.
+\end{itemize}
+Die Verwendung von \Package{marginnote}\IndexPackage{marginnote} führt zu
+einem weiteren Problem. Da das Paket keine Kollisionserkennung besitzt, können
+sich Randnotizen, die in unmittelbarer Nähe veranlasst wurden, gegenseitig
+ganz oder teilweise überdecken. Darüber hinaus führt \Macro{marginnote} je
+nach den gewählten Einstellungen von \Package{marginnote} manchmal zu
+Veränderungen beim Zeilenabstand des normalen Textes.
+
+Das Paket \Package{scrlayer-notecolumn} tritt an, all diese Probleme zu
+lösen. Dazu stützt es sich auf die Grundfunktionalität von
+\Package{scrlayer}\IndexPackage{scrlayer}. Damit einher geht jedoch auch ein
+Nachteil:\textnote{Achtung!} Notizen können nur auf den Seiten ausgegeben
+werden, die einen auf \Package{scrlayer} basierenden Seitenstil
+besitzen. Dieser Nachteil lässt sich mit Hilfe von
+\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} jedoch leicht
+auflösen oder sogar in einen Vorteil verwandeln.
+
+
+\section{Hinweise zum Entwicklungsstand}
+\label{sec:scrlayer-notecolumn.draft}
+
+Obwohl sich das Paket derzeit noch in einem recht frühen Entwicklungsstadium
+befindet, ist die Stabilität von weiten Teilen weniger eine Frage von
+\Package{scrlayer-notecolumn} als von \Package{scrlayer}. Dennoch ist davon
+auszugehen, dass sich auch in \Package{scrlayer-notecolumn} noch Fehler
+befinden. Es wird darum gebeten, diese bei Auffinden zu melden. Einige
+\emph{Unzulänglichkeiten} des Pakets sind jedoch auch der Minimierung des
+Aufwands geschuldet. So können Notizspalten zwar über Seiten hinweg umbrochen
+werden, allerdings findet dabei kein neuerlicher Absatzumbruch statt. Dies ist
+bei \TeX{} schlicht nicht vorgesehen.
+
+Da das Paket derzeit noch als experimentell gilt, findet sich die Anleitung
+hier im zweiten Teil der \KOMAScript-Anleitung. Dementsprechend richtet sie
+sich auch in erster Linie an erfahrene Anwender. Für Anfänger oder Anwender,
+die sich bereits deutlich auf dem Weg zum \LaTeX-Experten befinden, mag
+einiges in den nachfolgenden Erklärungen unklar oder gar unverständlich
+sein. Ich bitte um Nachsicht, dass ich bei experimentellen Paketen den Aufwand
+für die Anleitung halbwegs erträglich halten will.
+
+\section{Deklaration neuer Notizspalten}
+\label{sec:scrlayer-notecolumn.declaration}
+
+Beim Laden des Pakets wird bereits automatisch eine Notizspalte namens
+\PName{marginpar} deklariert. Wie der Name andeutet, liegt diese Notizspalte
+auf der Marginalienspalte von \Macro{marginpar} und \Macro{marginline}. Dabei
+werden auch \Macro{reversemarginpar} und \Macro{normalmarginpar} beachtet,
+allerdings nicht für die einzelnen Notizen, sondern nur für die gesamten
+Notizen einer Seite. Maßgeblich ist dabei die Einstellung, die am Ende der
+Seite, nämlich bei der Ausgabe der Notizspalte gilt. Dies sind im Übrigen auch
+die Voreinstellungen für alle neue deklarierten Notizspalten, soweit bei der
+Deklaration nichts anderes angegeben wurde.
+
+Es ist zu beachten\textnote{Achtung!}, dass Notizspalten nur auf Seiten
+ausgegeben werden, deren Seitenstil auf dem Paket
+\Package{scrlayer}\IndexPackage{scrlayer} basiert. Das Paket
+\Package{scrlayer} wird von \Package{scrlayer-notecolumn} automatisch geladen
+und stellt in der Voreinstellung lediglich den Seitenstil
+\Pagestyle{empty}\IndexPagestyle{empty} bereit. Werden weitere Seitenstile
+benötigt, wird zusätzlich das Paket
+\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} empfohlen.
+
+\begin{Declaration}
+ \Macro{DeclareNoteColumn}%
+ \OParameter{Liste der Einstellungen}\Parameter{Name der Notizspalte}\\
+ \Macro{DeclareNewNoteColumn}%
+ \OParameter{Liste der Einstellungen}\Parameter{Name der Notizspalte}\\
+ \Macro{ProvideNoteColumn}%
+ \OParameter{Liste der Einstellungen}\Parameter{Name der Notizspalte}\\
+ \Macro{RedeclareNoteColumn}%
+ \OParameter{Liste der Einstellungen}\Parameter{Name der Notizspalte}%
+\end{Declaration}
+\BeginIndex{Cmd}{DeclareNoteColumn}%
+\BeginIndex{Cmd}{DeclareNewNoteColumn}%
+\BeginIndex{Cmd}{ProvideNoteColumn}%
+\BeginIndex{Cmd}{RedeclareNoteColumn}%
+Mit Hilfe dieser Anweisungen können Notizspalten angelegt werden. Dabei
+erzeugt \Macro{DeclareNoteColumn} die Notizspalte ungeachtet der Tatsache, ob
+sie bereits existiert oder nicht, während \Macro{DeclareNewNoteColumn} einen
+Fehler ausgibt, falls der \PName{Name der Notizspalte} bereits für eine andere
+Notizspalte vergeben ist, und \Macro{ProvideNoteColumn} in eben diesem Fall
+schlicht nichts tut. Mit \Macro{RedeclareNoteColumn} wiederum kann nur eine
+bereits existierende Notiz-Spalte neu konfiguriert werden.
+
+Bei der Neukonfigurierung bereits existierender Notizspalten mit
+\Macro{DeclareNoteColumn} oder \Macro{RedeclareNoteColumn} gehen im übrigen
+die bereits erzeugten Notizen für diese Spalte nicht verloren, sondern bleiben
+erhalten.
+
+\BeginIndex{FontElement}{notecolumn.\PName{Name der Notizspalte}}%
+\BeginIndex{FontElement}{notecolumn.marginpar}%
+Für neue Notizspalten wird immer ein Element zur Änderung der
+Schriftattribute mit \Macro{setkomafont} und \Macro{addtokomafont} angelegt,
+falls dieses noch nicht existiert. Als Name für das Element wird
+\PValue{notecolumn.}\PName{Name der Notizspalte} verwendet. Dementsprechend
+existiert für die vordefinierte Notizspalte \PValue{marginpar} das Element
+\PValue{notecolumn.marginpar}. Die Voreinstellung kann bei der Deklaration
+einer Notizspalte direkt über die Option \Option{font} innerhalb der
+optionalen \PName{Liste der Einstellungen} angegeben werden.%
+\EndIndex{FontElement}{notecolumn.marginpar}%
+\EndIndex{FontElement}{notecolumn.\PName{Name der Notizspalte}}%
+
+Die \PName{Liste der Einstellungen} ist eine durch Komma separierte Liste von
+Einstellungen oder Optionen. Die verfügbaren Optionen sind in
+\autoref{tab:scrlayer-notecolumn.note.column.options} zu finden. Als
+Voreinstellung ist \Option{marginpar} immer gesetzt, kann aber durch
+individuelle Einstellungen überschrieben werden.
+
+\begin{desclist}
+ \desccaption{%
+ Mögliche Einstellungen für die Deklaration von Notizspalten%
+ \label{tab:scrlayer-notecolumn.note.column.options}%
+ }{%
+ Mögliche Einstellungen für die Deklaration von Notizspalten
+ (\emph{Fortsetzung})%
+ }%
+ \entry{\KOption{font}\PName{Schriftattribute}}{%
+ Einstellung der \PName{Schriftattribute} der Notizspalte mit Hilfe von
+ \Macro{setkomafont}. Für erlaubte Werte sei auf
+ \autoref{sec:maincls.textmarkup},
+ \autopageref{desc:maincls.cmd.setkomafont} verwiesen.\par%
+ Voreinstellung: \emph{leer}%
+ }%
+ \entry{\Option{marginpar}}{%
+ Position und Breite der Notizspalte werden so eingestellt, dass sie der
+ Marginalienspalte von \Macro{marginpar} entsprechen. Eine Umschaltung
+ zwischen \Macro{reversemarginpar}\IndexCmd{reversemarginpar} und
+ \Macro{normalmarginpar}\IndexCmd{normalmarginpar} wird immer nur am Ende
+ der Seite bei der Ausgabe der Notizspalte beachtet. Es wird darauf
+ hingewiesen, dass diese Option kein Argument erwartet oder erlaubt.\par%
+ Voreinstellung: \emph{ja}
+ }%
+ \entry{\Option{normalmarginpar}}{%
+ Position und Breite der Notizspalte werden so eingestellt, dass sie der
+ Marginalienspalte von \Macro{marginpar} bei Einstellung
+ \Macro{normalmarginpar} entsprechen. Es wird darauf hingewiesen, dass
+ diese Option kein Argument erwartet oder erlaubt.\par%
+ Voreinstellung: \emph{nein}
+ }%
+ \entry{\KOption{position}\PName{Abstand}}{%
+ Die Notizspalte wird mit \PName{Abstand} vom linken Rand des Papiers
+ gesetzt. Dabei sind für \PName{Abstand} auch komplexe Ausdrücke gestattet,
+ solange diese voll expandierbar sind und zum Zeitpunkt der Ausgabe der
+ Notizspalte zu einer Länge oder zu einem Längenwert oder einem
+ Längenausdruck expandieren. Siehe \cite[Abschnitt~3.5]{manual:eTeX} für
+ weitere Informationen zu Längenausdrücken.\par%
+ Voreinstellung: \emph{durch Option \Option{marginpar}}%
+ }%
+ \entry{\KOption{width}\PName{Breite}}{%
+ Die Notizspalte wird mit der angegebenen Breite gesetzt. Dabei sind für
+ \PName{Breite} auch komplexe Ausdrücke gestattet, solange diese voll
+ expandierbar sind und zum Zeitpunkt der Ausgabe der Notizspalte zu einer
+ Länge oder einem Längenwert oder einem Längenausdruck expandieren. Siehe
+ \cite[Abschnitt~3.5]{manual:eTeX} für weitere Informationen zu
+ Längenausdrucken.\par%
+ Voreinstellung: \emph{durch Option \Option{marginpar}}%
+ }%
+ \entry{\Option{reversemarginpar}}{%
+ Position und Breite der Notizspalte werden so eingestellt, dass sie der
+ Marginalienspalte von \Macro{marginpar} bei Einstellung
+ \Macro{reversemarginpar} entsprechen. Es wird darauf hingewiesen, dass
+ diese Option kein Argument erwartet oder erlaubt.\par%
+ Voreinstellung: \emph{nein}
+ }%
+\end{desclist}
+
+Da die Notizspalten mit Hilfe von \Package{scrlayer} definiert werden, wird
+auch für jede Notizspalte eine Ebene angelegt. Als Name für diese Ebene wird
+ebenfalls \PValue{notecolumn.}\PName{Name der Notizspalte} verwendet. Näheres
+zu Ebenen ist \autoref{sec:scrlayer.layers} zu entnehmen.%
+%
+\begin{Example}
+ Angenommen Sie sind Professor für ulkiges Recht und wollen eine Abhandlung
+ über das neue »Gesetz über die ausgelassene Verbreitung allgemeiner Späße«,
+ kurz GüdaVaS, schreiben. Der Hauptaugenmerk soll dabei jeweils auf dem
+ Kommentar zu einzelnen Paragraphen liegen. Sie entscheiden sich für ein
+ zweispaltiges Layout, wobei der Kommentar in der Hauptspalte enthalten sein
+ soll und die Paragraphen jeweils klein\iffree{ und in Farbe}{} in einer
+ schmaleren Notizspalte rechts daneben.
+\begin{lstcode}
+ \documentclass{scrartcl}
+ \usepackage[ngerman]{babel}
+ \usepackage{selinput}
+ \SelectInputMappings{
+ adieresis={ä},
+ germandbls={ß},
+ }
+ \usepackage[T1]{fontenc}
+ \usepackage{lmodern}
+ \usepackage{xcolor}
+
+ \usepackage{scrjura}
+ \setkomafont{contract.Paragraph}{\bfseries}
+ \setkeys{contract}{preskip=-\dp\strutbox}
+
+ \usepackage{scrlayer-scrpage}
+ \usepackage{scrlayer-notecolumn}
+
+ \newlength{\paragraphscolwidth}
+ \AfterCalculatingTypearea{%
+ \setlength{\paragraphscolwidth}{.333\textwidth}%
+ \addtolength{\paragraphscolwidth}{-\marginparsep}%
+ }
+ \recalctypearea
+ \DeclareNewNoteColumn[%
+ position=\oddsidemargin+1in
+ +.667\textwidth
+ +\marginparsep,
+ width=\paragraphscolwidth,
+ font=\raggedright\footnotesize
+ \color{blue}
+ ]{paragraphs}
+\end{lstcode}
+ Es wird ein einseitiger Artikel verfasst. Dazu wird die Sprache mit Hilfe
+ des \Package{babel}\IndexPackage{babel}-Pakets auf Deutsch (neue
+ Rechtschreibung) festgelegt. Die Eingabecodierung wird mit Hilfe von
+ \Package{selinput}\IndexPackage{selinput} automatisch bestimmt. Als Schrift
+ wird Latin Modern in 8-Bit-Codierung verwendet.\iffree{ Für die
+ Farbeinstellungen wird das Paket \Package{xcolor}\IndexPackage{xcolor}
+ genutzt.}{}
+
+ Bezüglich des Setzens von Gesetzestexten mit \Package{scrjura} sei auf
+ \iffree{dessen Anleitung}{\autoref{cha:scrjura}} verwiesen.
+
+ Da ein Seitenstil mit Seitenzahl verwendet werden soll, wird das Paket
+ \Package{scrlayer-scrpage} verwendet. Somit können Notizspalten auf allen
+ Seiten ausgegeben werden.
+
+ Dann wird das Paket \Package{scrlayer-notecolumn} für die Notizspalten
+ geladen. Die gewünschte Breite der Notizspalte wird über
+ \Macro{AfterCalculatingTypearea} nach jeder etwaigen Neuberechnung des
+ Satzspiegels neu berechnet. Sie soll jeweils ein Drittel der
+ Satzspiegelbreite betragen, wobei der Abstand zwischen Text und Notizspalte
+ zu Lasten der Notizspalte geht.
+
+ Mit dieser Information kann dann die neue Notizspalte definiert werden. Bei
+ der Festlegung der Position wird ein einfacher Längenausdruck genutzt. Dabei
+ ist zu beachten, dass \Length{oddsidemargin} nicht der gesamte linke Rand
+ ist, sondern aus historischen Gründen der linke Rand abzüglich
+ 1\Unit{inch}. Daher muss dieser Wert noch hinzugezählt werden.
+
+ Damit ist die Deklaration abgeschlossen. Es ist zu beachten, dass die
+ Notizspalte bisher im Textbereich ausgegeben wird. Die Notizspalte würde
+ also den Text überschreiben.
+
+\begin{lstcode}
+ \begin{document}
+
+ \title{Kommentar zum GüdaVaS}
+ \author{Professor R. O. Tenase}
+ \date{11.\,11.~2011}
+ \maketitle
+ \tableofcontents
+
+ \section{Vormerkung}
+ Das GüdaVaS ist ohne jeden Zweifel das wichtigste Gesetz, das in
+ Spaßmanien in den letzten eintausend Jahren verabschiedet wurde.
+ Die erste Lesung fand bereits am 11.\,11.~1111 im obersten
+ spaßmanischen Kongress statt, wurde aber vom damalige Spaßvesier
+ abgelehnt. Erst nach Umwandlung der spaßmanischen, aberwitzigen
+ Monarchie in eine repräsentative, witzige Monarchie durch W. Itzbold,
+ den Urkomischen, am 9.\,9.~1999 war der Weg für dieses Gesetz
+ endlich frei.
+\end{lstcode}
+ Dadurch, dass der Textbereich nicht verkleinert wurde, wird hier der ganze
+ Vorspann über die Gesamtbreite ausgegeben. Um das Beispiel zu testen, können
+ Sie vorübergehend
+\begin{lstcode}
+ \end{document}
+\end{lstcode}
+ ergänzen.
+\end{Example}
+%
+Offen blieb in diesem Beispiel die Frage, wie dann aber der Text für den
+Kommentar schmaler gesetzt werden kann. Dies werden Sie bei der Fortsetzung
+des Beispiels erfahren.%
+\EndIndex{Cmd}{RedeclareNoteColumn}%
+\EndIndex{Cmd}{ProvideNoteColumn}%
+\EndIndex{Cmd}{DeclareNewNoteColumn}%
+\EndIndex{Cmd}{DeclareNoteColumn}%
+
+\section{Erstellen einer Notiz}
+\label{sec:scrlayer-notecolumn.makenote}
+
+Nachdem eine Notizspalte deklariert wurde, können Notizen für diese Spalte
+erstellt werden. Diese Notizen werden allerdings nicht unmittelbar ausgegeben,
+sondern zunächst nur in eine Hilfsdatei mit Endung »\File{.slnc}«
+geschrieben.\footnote{Ganz genau werden die Notizen sogar zunächst in die
+ \File{aux}-Datei geschrieben und erst beim Lesen der \File{aux}-Datei
+ innerhalb von \Macro{end}\PParameter{document} in die \File{slnc}-Datei
+ übertragen. Dabei wird gegebenenfalls auch die Einstellung \Macro{nofiles}
+ beachtet.} %
+Beim nächsten \LaTeX-Lauf wird diese Hilfsdatei dann Stück für Stück je nach
+Fortschritt des Dokuments wieder eingelesen und am Ende der Seite die Notizen
+für die jeweilige Seite ausgegeben.
+
+Es ist jedoch zu beachten\textnote{Achtung!}, dass Notizspalten nur auf Seiten
+ausgegeben werden, deren Seitenstil auf dem Paket
+\Package{scrlayer}\IndexPackage{scrlayer} basiert. Das Paket
+\Package{scrlayer} wird von \Package{scrlayer-notecolumn} automatisch geladen
+und stellt in der Voreinstellung lediglich den Seitenstil
+\Pagestyle{empty}\IndexPagestyle{empty} bereit. Werden weitere Seitenstile
+benötigt, wird zusätzlich das Paket
+\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage} empfohlen.
+
+\begin{Declaration}
+ \Macro{makenote}\OParameter{Name der Notizspalte}\Parameter{Notiz}
+\end{Declaration}
+\BeginIndex{Cmd}{makenote}%
+Mit Hilfe dieser Anweisung kann eine \PName{Notiz} erstellt werden. Dabei wird
+die aktuelle vertikale Position als vertikale Position für den Anfang der
+\PName{Notiz} verwendet. Die horizontale Position für die Notiz ergibt sich
+aus der definierten Position der Notizspalte. Für die korrekte Funktion ist
+das Paket dabei auf \Macro{pdfsavepos}, \Macro{pdflastypos} und
+\Macro{pdfpageheight} angewiesen. Ohne diese Befehle funktioniert
+\Package{scrlayer-notecolumn} nicht. Dabei wird außerdem davon ausgegangen,
+dass die genannten Primitiven exakt die Ergebnisse von PDF\TeX{} liefern.
+
+Wird allerdings bei der Ausgabe der \PName{Notiz} eine Kollision mit einer
+früheren Notiz in derselben Notizspalte erkannt, so wird die \PName{Notiz} bis
+unter diese frühere Notiz verschoben. Passt die \PName{Notiz} nicht mehr auf
+die Seite, so wird sie ganz oder teilweise auf die nächste Seite umbrochen.
+
+Für welche Notizspalte die \PName{Notiz} erstellt werden soll, wird über das
+optionale Argument \PName{Name der Notizspalte} bestimmt. Ist kein optionales
+Argument angegeben, so wird die vordefinierte Notizspalte \PValue{marginpar}
+verwendet.%
+\begin{Example}
+ Fügen wir nun dem Beispiel aus dem vorherigen Abschnitt einen kommentierten
+ Paragraphen hinzu, wobei der Paragraph selbst in der neu definierten
+ Notizspalte gesetzt werden soll.
+\begin{lstcode}
+ \section{Analyse}
+ \begin{addmargin}[0pt]{.333\textwidth}
+ \makenote[paragraphs]{%
+ \protect\begin{contract}
+ \protect\Paragraph{title={Kein Witz ohne Publikum}}
+ Ein Witz kann nur dort witzig sein, wo er auf ein Publikum
+ trifft.
+ \protect\end{contract}
+ }
+ Dies ist eine der zentralsten Aussagen des Gesetzes. Sie ist derart
+ elementar, dass es durchaus angebracht ist, sich vor der Weisheit der
+ Verfasser zu verbeugen.
+\end{lstcode}
+ Die in \autoref{sec:maincls.lists}, \autopageref{desc:maincls.env.addmargin}
+ dokumentierte Umgebung wird genutzt, um den Haupttext in der Breite um die
+ Spalte für die Paragraphen zu vermindern. Hier ist auch eines der wenigen
+ Probleme bei Verwendung von \Macro{makenote} zu erkennen. Da das
+ obligatorische Argument in Dateien geschrieben wird, können Befehle
+ innerhalb des Arguments leider \emph{zerbrechen}. Um das zu verhindern, wird
+ empfohlen, vor alle Befehle ein \Macro{protect} zu setzen. Anderenfalls kann
+ die Verwendung von Befehlen innerhalb dieses Arguments zu Fehlermeldungen
+ führen.
+
+ Prinzipiell könnten Sie das Beispiel nun bereits mit
+\begin{lstcode}
+ \end{addmargin}
+ \end{document}
+\end{lstcode}
+ beenden, wenn Sie ein Ergebnis sehen wollen.
+\end{Example}%
+Wenn Sie das Beispiel testen, werden Sie feststellen, dass die Gesetzes-Spalte
+tiefer hinunter reicht als der Kommentartext. Wenn Sie zwecks Übung einen
+weiteren Abschnitt mit einem weiteren Paragraphen hinzufügen, ergibt sich
+eventuell das Problem, dass der Kommentar nicht unterhalb des Gesetzestextes,
+sondern direkt im Anschluss an den bisherigen Kommentar fortgesetzt wird. Eine
+Lösung für dieses Problem, werden Sie gleich kennenlernen.%
+\EndIndex{Cmd}{makenote}%
+
+\begin{Declaration}
+ \Macro{syncwithnotecolumn}\OParameter{Name der Notizspalte}
+\end{Declaration}
+\BeginIndex{Cmd}{syncwithnotecolumn}%
+Mit Hilfe dieser Anweisung wird in einer Notizspalte und im Haupttext des
+Dokumente je ein Synchronisierungspunkt erstellt. Wann immer bei der Ausgabe
+einer Notizspalte oder des Haupttextes ein solcher Synchronisierungspunkt
+erreicht wird, wird eine Marke angelegt, deren Inhalt die aktuelle Seite und
+die aktuelle vertikale Position ist.
+
+Parallel zum Erstellen der Synchronisierungspunkte, wird ermittelt, ob in
+der Notizspalte und im Haupttext beim letzten \LaTeX-Lauf eine Marke angelegt
+wurde. Falls das der Fall ist, werden deren Werte miteinander
+verglichen. Liegt die Marke der Notizspalte tiefer auf der Seite oder auf
+einer späteren Seite, so wird im Haupttext bis zu der Stelle der Notizspalte
+vorgerückt.
+
+In der Regel sollten Synchronisierungspunkte nicht innerhalb eines Absatzes
+des Haupttextes, sondern nur zwischen diesen gesetzt werden. Wird
+\Macro{syncwithnotecolumn} dennoch innerhalb eines Absatzes verwendet, so
+wird der Synchronisierungspunkt im Haupttext tatsächlich erst nach der
+aktuellen Zeile eingefügt. In dieser Hinsicht ähnelt
+\Macro{syncwithnotecolumn} also beispielsweise \Macro{vspace}.
+
+Dadurch, dass Synchronisierungspunkte in den Notizspalten erst beim nächsten
+\LaTeX-Lauf erkannt werden, benötigt der Mechanismus mindestens drei
+\LaTeX-Läufe. Aus jeder neuen Synchronisierung können sich außerdem
+Verschiebungen für spätere Synchronisierungspunkte ergeben, was wiederum die
+Notwendigkeit weiterer \LaTeX-Läufe nach sich zieht. Zu erkennen
+sind solche Verschiebungen in der Regel an der Meldung: »\LaTeX{}
+Warning: Label(s) may have changed. Rerun to get cross-references right.« Aber
+auch Meldungen über undefinierte \emph{Labels} können auf die Notwendigkeit
+eines weiteren \LaTeX-Laufs hinweisen.
+
+Wird das optionale Argument nicht angegeben\footnote{Es sei an dieser Stelle
+ darauf hingewiesen, dass ein leeres optionales Argument nicht
+ gleichbedeutend mit dem Weglassen eines optionalen Arguments ist!}, so wird
+an seiner Stelle \PValue{marginpar}, also die vordefinierte Notizspalte
+verwendet.
+
+Es ist nicht erlaubt \Macro{syncwithnotecolumn} innerhalb einer Notiz selbst,
+also im obligatorischen Argument von \Macro{makenote}\IndexCmd{makenote} zu
+verwenden! Dieser Fehler kann derzeit nicht abgefangen werden und führt dazu,
+dass mit jedem \LaTeX-Lauf neue Verschiebungen auftreten, so dass nie ein
+endgültiger Zustand erreicht wird. Um zwei oder mehrere Notizspalten
+miteinander zu synchronisieren, sind diese stattdessen mit dem Haupttext zu
+synchronisieren, da dabei auch die Spalten miteinander synchronisiert
+werden. Die hierzu empfohlene Anweisung wird nachfolgend beschrieben.%
+%
+\begin{Example}
+ Führen wir nun das obige Beispiel fort, indem wir zunächst einen
+ Synchronisationspunkt und dann einen weiteren Paragraphen
+ mit Kommentar hinzufügen:
+\begin{lstcode}
+ \syncwithnotecolumn[paragraphs]\bigskip
+ \makenote[paragraphs]{%
+ \protect\begin{contract}
+ \protect\Paragraph{title={Komik der Kultur}}
+ \setcounter{par}{0}%
+ Die Komik eines Witzes kann durch das kulturelle
+ Umfeld, in dem er erzählt wird, bestimmt sein.
+
+ Die Komik eines Witzes kann durch das kulturelle Umfeld,
+ in dem er spielt, bestimmt sein.
+ \protect\end{contract}
+ }
+ Die kulturelle Komponente eines Witzes ist tatsächlich nicht zu
+ vernachlässigen. Über die politische Korrektheit der Nutzung des
+ kulturellen Umfeldes kann zwar trefflich gestritten werden,
+ nichtsdestotrotz ist die Treffsicherheit einer solchen Komik im
+ entsprechendem Umfeld frappierend. Auf der anderen Seite kann ein
+ vermeintlicher Witz im falschen kulturellen Umfeld auch zu einer
+ echten Gefahr für den Witzeerzähler werden.
+\end{lstcode}
+ Außer dem Synchronisationspunkt wurde hier auch noch ein vertikaler
+ Abstand mit \Macro{bigskip} eingefügt, um die einzelnen Paragraphen und ihre
+ Kommentare besser voneinander abzusetzen.
+
+ Außerdem wird hier ein weiterer Punkt, der zu einem Problem werden kann,
+ sichtbar. Da die Notizspalten mit Boxen arbeiten, die zusammengebaut und
+ zerlegt werden, kann es bei Zählern innerhalb der Notizspalten teilweise zu
+ Verschiebungen kommen. Im Beispiel würde daher der erste Absatz nicht mit 1,
+ sondern mit 2 nummeriert. Dies kann jedoch mit einem beherzten Zurücksetzen
+ des entsprechenden Zählers leicht korrigiert werden.
+
+ Das Beispiel ist damit fast fertig, was noch fehlt, ist das Ende der
+ Umgebungen:
+\begin{lstcode}
+ \end{addmargin}
+ \end{document}
+\end{lstcode}
+ Tatsächlich wären natürlich auch noch die restlichen Paragraphen des
+ Gesetztes zu kommentieren. Dies sei mir hier jedoch erlassen.
+\end{Example}%
+Doch halt! Was wäre, wenn in diesem Beispiel der Paragraph nicht mehr auf die
+Seiten passen würde? Würde er dann auf der nächsten Seite ausgegeben? Diese
+Frage wird im nächsten Abschnitt beantwortet werden.
+\EndIndex{Cmd}{syncwithnotecolumn}%
+
+\begin{Declaration}
+ \Macro{syncwithnotecolumns}\OParameter{Liste von Notizspalte-Namen}
+\end{Declaration}
+\BeginIndex{Cmd}{syncwithnotecolumns}%
+Diese Anweisung führt eine Synchronisierung des Haupttextes mit allen in der
+mit Komma separierten \PName{Liste von Notizspalten-Namen} durch. Dabei wird
+der Haupttext mit der Notizspalte synchronisiert, deren Marke am weitesten
+hinten im Dokument steht. Somit werden als Nebeneffekt auch die Notizspalten
+untereinander synchronisiert.
+
+Wird das optionale Argument nicht angegeben oder ist es leer (oder beginnt es
+mit \Macro{relax}), so wird mit allen deklarierten Notizspalten
+synchronisiert.%
+\EndIndex{Cmd}{syncwithnotecolumns}%
+
+
+\section{Erzwungene Ausgabe von Notizspalten}
+\label{sec:scrlayer-notecolumn.clearnotes}
+
+Neben der normalen Ausgabe der Notizspalten, wie sie in
+\autoref{sec:scrlayer-notecolumn.makenote} beschrieben ist, ist es manchmal
+auch erforderlich alle aufgesammelten Notizen, die noch nicht ausgegeben
+wurden, auszugeben. Das ist insbesondere dann sinnvoll, wenn längere Notizen
+dazu führen, dass immer mehr Notizen nach unten und auf neue Seiten verschoben
+werden. Ein guter Zeitpunkt für eine solche erzwungene Ausgabe ist
+beispielsweise das Ende eines Kapitels oder das Ende des Dokuments.
+
+\begin{Declaration}
+ \Macro{clearnotecolum}\OParameter{Name der Notizspalte}
+\end{Declaration}
+\BeginIndex{Cmd}{clearnotecolumn}%
+Mit dieser Anweisung werden alle Notizen einer bestimmen Notizspalte
+ausgegeben, die bis zum Ende der aktuellen Seite noch nicht ausgegeben sind,
+aber auf dieser oder einer vorherigen Seite erstellt wurden. Zur Ausgabe
+dieser noch anhängigen Notizen werden nach Bedarf Leerseiten erstellt. Während
+der Ausgabe der anhängigen Notizen dieser Notizspalte werden gegebenenfalls
+auch anhängige Notizen anderer Notizspalten ausgegeben, jedoch nur so lange,
+wie dies zu Ausgabe der anhängigen Notizen der angegebenen Notizspalte
+notwendig ist.
+
+Während der Ausgabe der anhängigen Notizen kann es auch geschehen, dass
+irrtümlich Notizen ausgegeben werden, die im vorherigen \LaTeX-Lauf auf den
+Seiten erstellt wurden, die nun durch die eingefügten Leerseiten ersetzt
+werden. Dies normalisiert sich in einem der nächsten \LaTeX-Läufe. Zu erkennen
+sind solche Verschiebungen in der Regel an der Meldung: »\LaTeX{}
+Warning: Label(s) may have changed. Rerun to get cross-references right.«
+
+Die Notizspalte, deren anhängige Notizen ausgegeben werden soll, ist über das
+optionale Argument, \PName{Name der Notizspalte}, angegeben. Ist kein solches
+Argument angegeben, so wird die vordefinierte Notizspalte \PValue{marginpar}
+verwendet.
+
+Dem aufmerksamen Leser wird nicht entgangen sein, dass die erzwungene Ausgabe
+einer Notizspalte der Synchronisierung nicht unähnlich ist. Allerdings
+befindet man sich nach der erzwungenen Ausgabe im Fall, dass tatsächlich eine
+Ausgabe stattfindet, am Anfang der Seite nach der letzten Ausgabe und nicht
+unmittelbar unterhalb der letzten Ausgabe. Dafür terminiert die erzwungene
+Ausgabe in der Regel mit weniger \LaTeX-Läufen.%
+\EndIndex{Cmd}{clearnotecolumn}%
+
+\begin{Declaration}
+ \Macro{clearnotecolumns}\OParameter{Liste von Notizspalten-Namen}
+\end{Declaration}
+\BeginIndex{Cmd}{clearnotecolumns}%
+Diese Anweisung arbeitet vergleichbar mit \Macro{clearnotecolumn}. Allerdings
+kann hier als optionales Argument nicht nur eine Notizspalte angegeben werden,
+sondern es ist eine durch Komma getrennte Liste mehrere Namen von
+Notizspalten erlaubt. Es werden dann die anhängigen Notizen all dieser Spalten
+ausgegeben.
+
+Wurde das optionale Argument nicht angegeben oder ist es leer, so werden die
+anhängigen Notizen aller Notizspalten ausgegeben.%
+\EndIndex{Cmd}{clearnotecolumns}%
+
+\begin{Declaration}
+ \KOption{autoclearnotecolumns}\PName{Ein-Aus-Schalter}
+\end{Declaration}
+\BeginIndex{Option}{autoclearnotecolumns}%
+In der Regel wird man anhängige Notizen immer dann ausgeben lassen, wenn im
+Dokument explizit oder implizit -- beispielsweise in Folge von \Macro{chapter}
+-- die Anweisung \Macro{clearpage} ausgeführt wird. Dies ist auch am Ende
+eines Dokuments innerhalb von \Macro{end}\PParameter{document} der Fall. Über
+Option \Option{autoclearnotecolumns} kann daher gesteuert werden, ob bei
+Ausführung von \Macro{clearpage} automatisch auch \Macro{clearnotecolumns}
+ohne Argument ausgeführt werden soll.
+
+Da davon ausgegangen wird, dass dies in der Regel erwünscht ist, ist die
+Option in der Voreinstellung aktiv. Man kann sie jedoch über die
+entsprechenden Werte für einfache Schalter (siehe
+\autoref{tab:truefalseswitch} auf \autopageref{tab:truefalseswitch}) jederzeit
+aus- und auch wieder einschalten.
+
+Es ist zu beachten, dass im Falle der Deaktivierung der automatischen Ausgabe
+anhängiger Notizen am Ende des Dokument Notizen ganz oder teilweise verloren
+gehen können. Daher sollte man in diesem Fall vor
+\Macro{end}\PParameter{document} sicherheitshalber ein
+\Macro{clearnotecolumns} einfügen.
+
+Damit ist nun auch die Frage nach dem Beispiel im letzten Abschnitt
+beantwortet, ob der Paragraph auch komplett ausgegeben würde, wenn er auf die
+nächste Seite umbrochen werden müsste. Dies ist in der Voreinstellung
+selbstverständlich der Fall. Da es jedoch nach dem Ende der
+\Environment{addmargin}-Umgebung geschehen würde, könnte es eventuell noch
+zu Überlappungen durch nachfolgenden Text kommen. Daher wäre es im Beispiel
+durchaus sinnvoll nach der \Environment{addmargin}-Umgebung einen weiteren
+Synchronisationspunkt einzufügen.
+
+Das Ergebnis des Beispiels ist übrigens in
+\autoref{fig:scrlayer-notecolumn.example} zu sehen.
+
+\begin{figure}
+ \KOMAoptions{captions=bottombeside}%
+ \setcapindent{0pt}%
+ \begin{captionbeside}[{Eine Ergebnisseite zu dem Beispiel in
+ \autoref{cha:scrlayer-notecolumn}}]{Eine Ergebnisseite zu dem Beispiel
+ aus diesem Kapitel\label{fig:scrlayer-notecolumn.example}}[l]
+ \frame{\includegraphics[width=.5\textwidth,keepaspectratio]%
+ {scrlayer-notecolumn-example}}
+ \end{captionbeside}
+\end{figure}
+\EndIndex{Option}{autoclearnotecolumns}%
+%
+\EndIndex{Package}{scrlayer-notecolumn}%
+
+%%% Local Variables:
+%%% mode: latex
+%%% mode: flyspell
+%%% coding: iso-latin-1
+%%% ispell-local-dictionary: "de_DE"
+%%% TeX-master: "scrlayer-de.tex"
+%%% TeX-PDF-mode: t
+%%% End:
+
+% LocalWords: Randnotizen Entwicklungsstadium Notizspalte Notizspalten
+% LocalWords: Neukonfigurierung Synchronisierungspunkt
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage-experts.tex
new file mode 100644
index 00000000000..ddcbe5a8284
--- /dev/null
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage-experts.tex
@@ -0,0 +1,672 @@
+% ======================================================================
+% scrlayer-scrpage-experts.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ----------------------------------------------------------------------
+% scrlayer-scrpage-experts.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ======================================================================
+%
+% Expert chapter about scrlayer-scrpage of the KOMA-Script guide
+%
+% ----------------------------------------------------------------------
+%
+% Expertenkapitel über scrlayer-scrpage in der KOMA-Script-Anleitung
+%
+% ============================================================================
+
+\KOMAProvidesFile{scrlayer-scrpage-experts.tex}%
+ [$Date: 2013-12-17 14:46:13 +0100 (Di, 17. Dez 2013) $
+ KOMA-Script guide (chapter: scrlayer-scrpage for experts)]
+
+\chapter[{Zusätzliche Möglichkeiten von \Package{scrlayer-scrpage}}]
+{Zusätzliche Möglichkeiten des
+ Pakets\ChangedAt{v3.12}{\Package{scrlayer-scrpage}}
+ \Package{scrlayer-scrpage}}
+\labelbase{scrlayer-scrpage-experts}
+%
+\BeginIndex{Package}{scrlayer-scrpage}%
+Über die Erklärungen in \autoref{cha:scrlayer-scrpage} von
+\autoref{part:forAuthors} diese\iffree{r Anleitung}{s Buches} hinaus, bietet das
+Paket \Package{scrlayer-scrpage} viele weitere Möglichkeiten. Diese stellen
+jedoch entweder Erweiterungen dar, die der durchschnittliche Anwender nicht
+zwingend benötigt oder sie existieren nur aus Gründen der Kompatibilität zu
+\Package{scrpage2}, so dass die meisten Anwender sie nicht wissen
+müssen. All diese Dinge werden daher in hier in \autoref{part:forExperts}
+dokumentiert.
+
+\LoadCommon[scrlayerscrpageexperts]{21}% \section{Beeinflussung von definierten Seitenstilen}
+
+\section{Definition eigener Seitenstil-Paare}
+\label{sec:scrlayer-scrpage-experts.pagestyle.pairs}
+
+In \autoref{sec:scrlayer-scrpage.predefined.pagestyles} wurden die beiden
+Seitenstile \Pagestyle{scrheadings} und \Pagestyle{plain.scrheadings}
+vorgestellt. Diese bilden quasi ein Paar, bei dem \Pagestyle{scrheadings} als
+Haupt-Seitenstil mit Kolumnentitel vorgesehen ist, während
+\Pagestyle{plain.scrheadings} ein dazu passender \Pagestyle{plain}-Seitenstil
+ohne Kolumnentitel aber üblicherweise mit Paginierung, also mit Seitenzahl
+ist. Neben der Konfiguration dieses vordefinierten Paars bietet
+\Package{scrlayer-scrpage} auch die Möglichkeit, zusätzliche Paare zu
+definieren. Der Name des Haupt-Seitenstils \Pagestyle{scrheadings} dient dabei
+quasi auch als Name des Seitenstil-Paars.
+
+Die allermeisten Anwender werden in der Regel mit dem einen vordefinierten
+Seitenstil-Paar \Pagestyle{scrheadings} auskommen. Die in diesem Abschnitt
+dokumentierten Anweisungen sind daher eher Ergänzungen für besondere Fälle. Da
+mir während des Abfassens dieser Anleitung keine handlichen
+Anwendungsbeispiele eingefallen sind, gibt es auch keine ausführlichen
+Beispiele. Sollte mir im Support einmal eine besonders schöne Anwendung
+begegnen, werde ich solche aber in zukünftigen Fassungen gerne aufgreifen. Ich
+bin jedoch gleichzeitig sicher, dass sich all diese Fälle auch mit dem einen
+Paar \Pagestyle{scrheadings} lösen lassen.
+
+\begin{Declaration}
+ \Macro{defpairofpagestyles}%
+ \OParameter{Eltern-Paar}\Parameter{Name}\Parameter{Definition}\\
+ \Macro{newpairofpagestyles}%
+ \OParameter{Eltern-Paar}\Parameter{Name}\Parameter{Definition}\\
+ \Macro{renewpairofpagestyles}%
+ \OParameter{Eltern-Paar}\Parameter{Name}\Parameter{Definition}\\
+ \Macro{providepairofpagestyles}%
+ \OParameter{Eltern-Paar}\Parameter{Name}\Parameter{Definition}
+\end{Declaration}
+\BeginIndex{Cmd}{defpairofpagestyles}%
+\BeginIndex{Cmd}{newpairofpagestyles}%
+\BeginIndex{Cmd}{renewpairofpagestyles}%
+\BeginIndex{Cmd}{providepairofpagestyles}%
+Mit diesen Anweisungen können Paare von Seitenstilen vergleichbar zu
+\Pagestyle{scrheadings} und \Pagestyle{plain.scrheadings} definiert
+werden. Dabei ist \PName{Name} der Name des zu \Pagestyle{scrheadings}
+vergleichbaren Hauptseitenstils, der für die Verwendung mit Kolumnentiteln
+ausgelegt ist. Für den Namen des zugehörigen \Pagestyle{plain}-Seitenstil wird
+\PName{Name} automatisch \PValue{plain.} vorangestellt. \PName{Name} ist also
+gleichzeitig der Name des Paares und des Hauptseitenstils dieses Paares, während
+\PValue{plain.}\PName{Name} der Name des \Pagestyle{plain}-Seitenstils dieses
+Paares ist.
+
+Ist das optionale Argument \PName{Eltern-Paar} angegeben, so ist dies der Name
+eines Seitenstil-Paars, mit dessen Einstellungen das neue Paar initialisiert
+werden soll. Das neue Paar erbt also quasi die Konfiguration des
+\PName{Eltern-Paar}s.
+
+Während in \autoref{sec:scrlayer-scrpage.predefined.pagestyles} der Eindruck
+entstanden ist, dass sich die in jenem Abschnitt erläuterten Anweisungen nur
+auf \Pagestyle{scrheadings} und \Pagestyle{plain.scrheadings} beziehen, gilt
+das tatsächlich nur, solange diese das einzige Seitenstil-Paar
+darstellen. Sobald es mehrere Seitenstil-Paare gibt, beziehen sich diese
+Anweisungen auf das zuletzt aktive Seitenstil-Paar. Dies gilt für
+\Macro{lehead}, \Macro{cehead}, \Macro{rehead}, \Macro{lohead},
+\Macro{cohead}, \Macro{rohead}, \Macro{lefoot}, \Macro{cefoot},
+\Macro{refoot}, \Macro{lofoot}, \Macro{cofoot}, \Macro{rofoot}, \Macro{ihead},
+\Macro{chead}, \Macro{ohead}, \Macro{ifoot}, \Macro{cfoot}, \Macro{ofoot} aus
+\autoref{sec:scrlayer-scrpage.predefined.pagestyles}.
+
+Genau jene Anweisung, sowie die nachfolgend dokumentierten Anweisungen
+\Macro{clearmainofpairofpagestyles}, \Macro{clearplainofpairofpagestyles} und
+\Macro{clearpairofpagestyles} sind auch für die Verwendung im letzten
+Parameter \PName{Definition} gedacht. In diesem Fall stellen sie eine Art
+Grundkonfiguration des Seitenstil-Paars dar, die immer dann ausgeführt wird,
+wenn das Seitenstil-Paar aktiviert wird. Ein Seitenstil-Paar wird aktiviert,
+indem einer der beiden Seitenstile des Paares aktiviert wird. Dies geschieht
+in der Regel mit Hilfe von \Macro{pagestyle}\IndexCmd{pagestyle}.
+
+Es sei darauf hingewiesen, dass die Anweisungen aus
+\autoref{sec:scrlayer-scrpage.pagestyle.content} ohnehin allgemeiner Natur
+sind und für alle mit \Pagestyle{scrlayer-scrpage} definierten Seitenstile
+gelten.
+
+Während \Macro{defpairofpagestyles} das Paar unabhängig davon, ob entsprechende
+Seitenstile bereits existieren, definiert, geschieht die Definition bei
+\Macro{newpairofpagestyles} und \Macro{providepairofpagestyles} nur, wenn die
+Seitenstile noch nicht definiert sind. Ist mindestens einer der beiden
+Seitenstile des Paares bereits definiert, so wird die neuerliche Definition
+bei \Macro{providepairofpagestyles} ignoriert, während sie bei
+\Macro{newpairofpagestyles} einen Fehler ergeben. Für die Umdefinierung
+bereits existierender Paare kann \Macro{renewpairofpagestyles} verwendet
+werden. Hier wird ein Fehler gemeldet, wenn einer der beiden Seitenstile oder
+beide Seitenstile des Paares noch nicht existieren.%
+\EndIndex{Cmd}{providepairofpagestyles}%
+\EndIndex{Cmd}{renewpairofpagestyles}%
+\EndIndex{Cmd}{newpairofpagestyles}%
+\EndIndex{Cmd}{defpairofpagestyles}%
+
+\begin{Declaration}
+ \Macro{clearmainofpairofpagestyles}\\
+ \Macro{clearplainofpairofpagestyles}\\
+ \Macro{clearpairofpagestyles}
+\end{Declaration}
+\BeginIndex{Cmd}{clearmainofpairofpagestyles}%
+\BeginIndex{Cmd}{clearplainofpairofpagestyles}%
+\BeginIndex{Cmd}{clearpairofpagestyles}%
+Mit der Anweisung \Macro{clearmainofpairofpagestyles} wird der Hauptseitenstil
+des zuletzt aktivierten Seitenstil-Paares leer konfiguriert. Dagegen wird mit
+der Anweisung \Macro{clearplainofpairofpagestyles} der
+\Pagestyle{plain}-Seitenstil des entsprechenden Seitenstil-Paares leer
+konfiguriert. Anweisung \Macro{clearpairofpagestyles} konfiguriert schließlich
+beide Seitenstile des entsprechenden Paares als leer.
+
+Es ist jedoch zu beachten\textnote{Achtung!}, dass keine dieser Anweisungen
+die Definitionen aus dem Parameter \PName{Definition}, der bei der Definition
+des Seitenstil-Paares angegeben wurde (siehe oben), entfernt. Bei der erneuten
+Auswahl eines Seitenstils des Paares werden jene Einstellungen also erneut
+ausgeführt!
+
+Die Anweisungen können selbst ebenfalls innerhalb von \PName{Definition}
+verwendet werden. Sie können aber auch jederzeit außerhalb der Definition
+eines Seitenstils verwendet werden. In diesem Fall beziehen sie sich auf das
+zuletzt aktivierte Seitenstil-Paar.
+
+\BeginIndex{Cmd}{clearscrheadings}%
+\BeginIndex{Cmd}{clearscrplain}%
+\BeginIndex{Cmd}{clearscrheadfoot}%
+Die Anweisungen \Macro{clearscrheadings}, \Macro{clearscrplain} und
+\Macro{clearscrheadfoot} sind Aliase für diese Anweisungen, die nur aus
+Gründen der Kompatibilität mit \Package{scrpage2} existieren. Sie sollten
+nicht mehr verwendet werden.%
+\EndIndex{Cmd}{clearscrheadfoot}%
+\EndIndex{Cmd}{clearscrplain}%
+\EndIndex{Cmd}{clearscrheadings}%
+%
+\EndIndex{Cmd}{clearpairofpagestyles}%
+\EndIndex{Cmd}{clearplainofpairofpagestyles}%
+\EndIndex{Cmd}{clearmainofpairofpagestyles}%
+
+
+\section{Definition einfacher Seitenstile mit dreigeteiltem Kopf und Fuß}
+\label{sec:scrlayer-scrpage-experts.pagestyle.triple}
+
+Neben den vordefinierten Seitenstilen und der Definition eigener
+Seitenstil-Paare, bietet \Package{scrlayer-scrpage} auch noch die Möglichkeit
+der Definition von Seitenstilen, bei denen sowohl der Kopf als auch der Fuß fest
+in drei Elemente aufgeteilt ist. Diese Schnittstelle existiert jedoch nur aus
+Gründen der Kompatibilität mit \Package{scrpage2}. Zum
+Zwecke eines konsistenteren Befehlssatzes wurde sie sogar noch
+erweitert. Dennoch wird empfohlen, für neue Dokumente nicht mehr auf diese
+Möglichkeit zurück zu greifen, sondern die deutlich überlegenen Möglichkeiten
+der vorherigen Abschnitte oder des nachfolgende Abschnitts zu nutzen.
+
+\begin{Declaration}
+ \Macro{deftriplepagestyle}%
+ \Parameter{Name des Seitenstils}\\
+ \hphantom{\XMacro{deftriplepagestyle}}%
+ \OParameter{Dicke der äußeren Linie}%
+ \OParameter{Dicke der inneren Linie}\\
+ \hphantom{\XMacro{deftriplepagestyle}}%
+ \Parameter{inneres Kopfelement}%
+ \Parameter{mittleres Kopfelement}%
+ \Parameter{äußeres Kopfelement}\\
+ \hphantom{\XMacro{deftriplepagestyle}}%
+ \Parameter{inneres Fußelement}%
+ \Parameter{mittleres Fußelement}%
+ \Parameter{äußeres Fußelement}\\
+ \Macro{newtriplepagestyle}%
+ \Parameter{Name des Seitenstils}\\
+ \hphantom{\XMacro{newtriplepagestyle}}%
+ \OParameter{Dicke der äußeren Linien}%
+ \OParameter{Dicke der inneren Linien}\\
+ \hphantom{\XMacro{newtriplepagestyle}}%
+ \Parameter{inneres Kopfelement}%
+ \Parameter{mittleres Kopfelement}%
+ \Parameter{äußeres Kopfelement}\\
+ \hphantom{\XMacro{newtriplepagestyle}}%
+ \Parameter{inneres Fußelement}%
+ \Parameter{mittleres Fußelement}%
+ \Parameter{äußeres Fußelement}\\
+ \Macro{renewtriplepagestyle}%
+ \Parameter{Name des Seitenstils}\\
+ \hphantom{\XMacro{renewtriplepagestyle}}%
+ \OParameter{Dicke der äußeren Linie}%
+ \OParameter{Dicke der inneren Linie}\\
+ \hphantom{\XMacro{renewtriplepagestyle}}%
+ \Parameter{inneres Kopfelement}%
+ \Parameter{mittleres Kopfelement}%
+ \Parameter{äußeres Kopfelement}\\
+ \hphantom{\XMacro{renewtriplepagestyle}}%
+ \Parameter{inneres Fußelement}%
+ \Parameter{mittleres Fußelement}%
+ \Parameter{äußeres Fußelement}\\
+ \Macro{providetriplepagestyle}%
+ \Parameter{Name des Seitenstils}\\
+ \hphantom{\XMacro{providetriplepagestyle}}%
+ \OParameter{Dicke der äußeren Linie}%
+ \OParameter{Dicke der inneren Linie}\\
+ \hphantom{\XMacro{providetriplepagestyle}}%
+ \Parameter{inneres Kopfelement}%
+ \Parameter{mittleres Kopfelement}%
+ \Parameter{äußeres Kopfelement}\\
+ \hphantom{\XMacro{providetriplepagestyle}}%
+ \Parameter{inneres Fußelement}%
+ \Parameter{mittleres Fußelement}%
+ \Parameter{äußeres Fußelement}
+\end{Declaration}
+\BeginIndex{Cmd}{deftriplepagestyle}%
+\BeginIndex{Cmd}{newtriplepagestyle}%
+\BeginIndex{Cmd}{renewtriplepagestyle}%
+\BeginIndex{Cmd}{providetriplepagestyle}%
+Mit diesen Anweisungen kann ein einzelner Seitenstil definiert werden, bei dem
+Kopf und Fuß in drei Elemente aufgeteilt sind: ein inneres Element, ein
+mittleres Element und ein äußeres Element. Diese werden über jeweils drei
+obligatorische Argumente angegeben.
+
+Das jeweilige innere Element wird auf linken Seiten rechtsbündig im Kopf
+respektive im Fuß platziert. Auf rechten Seiten wird es hingegen linksbündig
+platziert. Entsprechend wird das mittlere Element sowohl auf linken als auch
+auf rechten Seiten im Kopf respektive Fuß zentriert. Das äußere Element wird
+schließlich auf linken Seiten linksbündig und auf rechten Seiten rechtsbündig
+im Kopf respektive Fuß platziert.
+
+An\textnote{Achtung!} dieser Stelle sei noch einmal daran erinnert, dass im
+einseitigen Satz nur rechte Seiten existieren!
+
+Mit den beiden optionalen Argumenten können Linien in Kopf und Fuß aktiviert
+werden. Dazu gibt man die gewünschte Dicke der Linien als Argument an. Das
+erste optionale Argument betrifft die \PName{Dicke der äußeren Linien}. Diese
+Linien werden über dem Kopf und unter dem Fuß gezeichnet. Das zweite optionale
+Argument betrifft die \PName{Dicke der inneren Linien}. Diese beiden Linien
+werden unterhalb des Kopfes und oberhalb des Fußes gezeichnet. Ist nur ein
+optionales Argument angegeben, so ist dies die \PName{Dicke der inneren
+ Linien}. Die \PName{Dicke der äußeren Linien} ist dann Null, womit nur noch
+die beiden inneren Linien gezeichnet werden. Ist keines der optionalen
+Argumente angegeben, so entfallen alle Linien.
+
+Es ist zu beachten\textnote{Achtung!}, dass leere optionale Argumente nicht
+gleichbedeutend mit dem Weglassen der optionalen Argumente sind! Leere
+optionale Argumente sind in diesem Fall nicht erlaubt. Dagegen sind einfache
+Längenausdrücke, wie sie bereits bei Option \Option{headwidth} (siehe
+\autoref{sec:scrlayer-scrpage.pagestyle.content},
+\autopageref{desc:scrlayer-scrpage.option.headwidth}) erklärt wurden, erlaubt.
+
+Die Bedeutung der einzelnen Argumente ist in
+\autoref{fig:scrlayer-scrpage.triplepagestyle} noch einmal an einer
+schematischen Doppelseite veranschaulicht. Dabei dienen »\textsl{außen}«,
+»\textsl{innen}«, »\textsl{mittig}« als beispielhafte Inhalte. Die zugehörigen
+Pfeile verdeutlichen die Ausbreitung dieser Inhalte. Die \iffree{farbigen
+}{}Texte im Inneren der Seite sind die Namen der Argumente der Befehle. Die
+zugehörigen Pfeile \iffree{in gleicher Farbe }{}weisen auf die entsprechenden
+Elemente der Seite.
+
+\begin{figure}
+ \centering
+ \begin{picture}(\textwidth,80mm)
+ \put(0,50mm){%
+ %\
+ \begin{picture}(\textwidth,30mm)(0,-10mm)
+ \thinlines
+ \small
+ % linke Seite
+ \put(0,20mm){\line(1,0){.49\textwidth}}%
+ \put(0,0){\line(0,1){20mm}}%
+ \multiput(0,0)(0,-1mm){10}{\line(0,-1){.5mm}}%
+ \put(.49\textwidth,5mm){\line(0,1){15mm}}%
+ \put(.05\textwidth,15mm){\thicklines\line(1,0){.415\textwidth}}%
+ \put(.05\textwidth,10mm){\makebox(0em,5mm)[l]{\slshape außen\strut$\longrightarrow$}}%
+ \put(.465\textwidth,10mm){\makebox(0em,5mm)[r]{\slshape $\longleftarrow$innen\strut}}%
+ \put(.2575\textwidth,10mm){\makebox(0em,5mm)[c]{\slshape $\longleftarrow$mittig\strut$\longrightarrow$}}%
+ \put(.05\textwidth,10mm){\thicklines\line(1,0){.415\textwidth}}%
+ % rechte Seite
+ \put(0.51\textwidth,20mm){\line(1,0){.49\textwidth}}%
+ \put(0.51\textwidth,5mm){\line(0,1){15mm}}%
+ \multiput(\textwidth,0)(0,-1mm){10}{\line(0,-1){.5mm}}%
+ \put(\textwidth,0mm){\line(0,1){20mm}}%
+ \put(.535\textwidth,15mm){\thicklines\line(1,0){.415\textwidth}}%
+ \put(.535\textwidth,10mm){\makebox(0em,5mm)[l]{\slshape innen\strut$\longrightarrow$}}%
+ \put(.95\textwidth,10mm){\makebox(0em,5mm)[r]{\slshape $\longleftarrow$außen\strut}}%
+ \put(.7425\textwidth,10mm){\makebox(0em,5mm)[c]{\slshape $\longleftarrow$mittig\strut$\longrightarrow$}}%
+ \put(.535\textwidth,10mm){\thicklines\line(1,0){.415\textwidth}}%
+ % Befehle für beide Seiten
+ \iffree{\color{red}}{}%
+ \put(.5\textwidth,0){\makebox(0,\baselineskip)[c]{\PName{inneres Kopfelement}}}%
+ \put(.5\textwidth,-5mm){\makebox(0,\baselineskip)[c]{\PName{mittleres Kopfelement}}}%
+ \put(.5\textwidth,-10mm){\makebox(0,\baselineskip)[c]{\PName{äußeres Kopfelement}}}%
+ \put(\dimexpr.5\textwidth-2em,.5\baselineskip){%
+ \put(-1.5em,.5\baselineskip){\vector(0,1){7mm}}%
+ \put(-4em,-1\baselineskip){\line(-1,0){\dimexpr .25\textwidth-7em\relax}}%
+ \put(-\dimexpr
+ .25\textwidth-3em\relax,-1\baselineskip){\vector(0,1){\dimexpr
+ 7mm+1.5\baselineskip\relax}}
+ \put(-3.25em,-2.25\baselineskip){\line(-1,0){\dimexpr .45\textwidth-8em\relax}}%
+ \put(-\dimexpr
+ .45\textwidth-4.75em\relax,-2.25\baselineskip){\vector(0,1){\dimexpr
+ 7mm+2.75\baselineskip\relax}}
+ }%
+ \put(\dimexpr.5\textwidth+2em,.5\baselineskip){%
+ \put(1.5em,.5\baselineskip){\vector(0,1){7mm}}%
+ \put(4em,-1\baselineskip){\line(1,0){\dimexpr .25\textwidth-7em\relax}}
+ \put(\dimexpr
+ .25\textwidth-3em\relax,-1\baselineskip){\vector(0,1){\dimexpr
+ 7mm+1.5\baselineskip\relax}}
+ \put(3.25em,-2.25\baselineskip){\line(1,0){\dimexpr .45\textwidth-8em\relax}}
+ \put(\dimexpr
+ .45\textwidth-4.75em\relax,-2.25\baselineskip){\vector(0,1){\dimexpr
+ 7mm+2.75\baselineskip\relax}}
+ }%
+ \end{picture}
+ %
+ }%
+ \put(0,0){%
+ \begin{picture}(\textwidth,30mm)
+ \thinlines
+ \small
+ % linke Seite
+ \put(0,0){\line(1,0){.49\textwidth}}%
+ \put(0,0){\line(0,1){20mm}}%
+ \multiput(0,20mm)(0,1mm){10}{\line(0,1){.5mm}}%
+ \put(.49\textwidth,0){\line(0,1){15mm}}%
+ \put(.05\textwidth,15mm){\thicklines\line(1,0){.415\textwidth}}%
+ \put(.05\textwidth,10mm){\makebox(0em,5mm)[l]{\slshape außen\strut$\longrightarrow$}}%
+ \put(.465\textwidth,10mm){\makebox(0em,5mm)[r]{\slshape $\longleftarrow$innen\strut}}%
+ \put(.2575\textwidth,10mm){\makebox(0em,5mm)[c]{\slshape $\longleftarrow$mittig\strut$\longrightarrow$}}%
+ \put(.05\textwidth,10mm){\thicklines\line(1,0){.415\textwidth}}%
+ % rechte Seite
+ \put(.51\textwidth,0){\line(1,0){.49\textwidth}}%
+ \put(.51\textwidth,0){\line(0,1){15mm}}%
+ \put(\textwidth,0){\line(0,1){20mm}}%
+ \multiput(\textwidth,20mm)(0,1mm){10}{\line(0,1){.5mm}}%
+ \put(.535\textwidth,15mm){\thicklines\line(1,0){.415\textwidth}}%
+ \put(.535\textwidth,10mm){\makebox(0em,5mm)[l]{\slshape innen\strut$\longrightarrow$}}%
+ \put(.95\textwidth,10mm){\makebox(0em,5mm)[r]{\slshape $\longleftarrow$außen\strut}}%
+ \put(.7425\textwidth,10mm){\makebox(0em,5mm)[c]{\slshape $\longleftarrow$mittig\strut$\longrightarrow$}}%
+ \put(.535\textwidth,10mm){\thicklines\line(1,0){.415\textwidth}}%
+ % Befehle für beide Seiten
+ \iffree{\color{red}}{}%
+ \put(.5\textwidth,20mm){\makebox(0,\baselineskip)[c]{\PName{inneres Fußelement}}}%
+ \put(.5\textwidth,25mm){\makebox(0,\baselineskip)[c]{\PName{mittleres Fußelement}}}%
+ \put(.5\textwidth,30mm){\makebox(0,\baselineskip)[c]{\PName{äußeres Fußelement}}}%
+ \put(\dimexpr.5\textwidth-2em,.5\baselineskip){%
+ \put(-1.5em,\dimexpr 20mm-.5\baselineskip\relax){\vector(0,-1){6mm}}%
+ \put(-3.5em,25mm){\line(-1,0){\dimexpr .25\textwidth-6.5em\relax}}%
+ \put(-\dimexpr .25\textwidth-3em\relax,25mm){\vector(0,-1){\dimexpr
+ .5\baselineskip + 11mm\relax}}%
+ \put(-3em,30mm){\line(-1,0){\dimexpr .45\textwidth-7.5em\relax}}%
+ \put(-\dimexpr .45\textwidth-4.5em\relax,30mm){\vector(0,-1){\dimexpr
+ .5\baselineskip + 16mm\relax}}%
+ }%
+ \put(\dimexpr.5\textwidth+2em,.5\baselineskip){%
+ \put(1.5em,\dimexpr 20mm-.5\baselineskip\relax){\vector(0,-1){6mm}}%
+ \put(3.5em,25mm){\line(1,0){\dimexpr .25\textwidth-6.5em\relax}}%
+ \put(\dimexpr .25\textwidth-3em\relax,25mm){\vector(0,-1){\dimexpr
+ .5\baselineskip + 11mm\relax}}%
+ \put(3em,30mm){\line(1,0){\dimexpr .45\textwidth-7.5em\relax}}%
+ \put(\dimexpr .45\textwidth-4.5em\relax,30mm){\vector(0,-1){\dimexpr
+ .5\baselineskip + 16mm\relax}}%
+ }%
+ \end{picture}
+ }%
+ \thinlines\small\iffree{\color{blue}}{}%
+ \put(0.055\textwidth,45mm){\vector(0,1){25mm}}%
+ \put(0.945\textwidth,45mm){\vector(0,1){25mm}}%
+ \put(0.055\textwidth,45mm){\vector(0,-1){30mm}}%
+ \put(0.945\textwidth,45mm){\vector(0,-1){30mm}}%
+ \put(0.055\textwidth,45mm){\line(1,0){\dimexpr
+ .445\textwidth-6.5em\relax}}%
+ \put(0.945\textwidth,45mm){\line(-1,0){\dimexpr
+ .445\textwidth-6.5em\relax}}%
+ \put(0.5\textwidth,45mm){\makebox(0,0)[c]{\PName{Dicke der inneren
+ Linien}}}%
+ \iffree{\color{green}}{}%
+ \put(0.025\textwidth,40mm){\line(0,1){35mm}}%
+ \put(0.025\textwidth,75mm){\vector(1,0){3.75mm}}%
+ \put(0.975\textwidth,40mm){\line(0,1){35mm}}%
+ \put(0.975\textwidth,40mm){\line(0,1){35mm}}%
+ \put(0.975\textwidth,75mm){\vector(-1,0){3.75mm}}%
+ \put(0.025\textwidth,40mm){\line(0,-1){30mm}}%
+ \put(0.025\textwidth,10mm){\vector(1,0){3.75mm}}%
+ \put(0.975\textwidth,40mm){\line(0,-1){30mm}}%
+ \put(0.975\textwidth,40mm){\line(0,-1){30mm}}%
+ \put(0.975\textwidth,10mm){\vector(-1,0){3.75mm}}%
+ \put(0.025\textwidth,40mm){\line(1,0){\dimexpr
+ .475\textwidth-6.5em\relax}}%
+ \put(0.975\textwidth,40mm){\line(-1,0){\dimexpr
+ .475\textwidth-6.5em\relax}}%
+ \put(0.5\textwidth,40mm){\makebox(0,0)[c]{\PName{Dicke der äußeren Linien}}}%
+ \end{picture}
+ \caption[{Elemente dreigeteilter Seitenstile}]{Elemente einer Doppelseite
+ der dreigeteilten Seitenstile mit den Anweisungen
+ \Macro{deftriplepagestyle}, \Macro{newtriplepagestyle},
+ \Macro{providetriplepagestyle} und \Macro{renewtriplepagestyle}}
+ \label{fig:scrlayer-scrpage.triplepagestyle}
+\end{figure}
+
+
+Mit den hier dokumentierten Anweisungen ist es nicht möglich, einzelne Linien
+zu aktivieren, beispielsweise nur eine Linie unter dem Seitenkopf aber keine
+Linie über dem Seitenfuß zu haben. Verwenden Sie dafür stattdessen die
+Anweisungen aus einem der vorherigen oder aus dem nachfolgenden Abschnitt.
+
+Die\textnote{Achtung!} Länge der einzelnen Elemente ist nicht durch das
+Vorhandensein eines Nachbarelements beschränkt. Dadurch kann es bei
+ungünstiger Verwendung passieren, dass ein Element eines oder beide
+Nachbarelemente überschreibt. Der Anwender ist selbst für die Vermeidung
+dieses ungünstigen Falles verantwortlich. Bei lebenden Kolumnentiteln ist dies
+beispielsweise durch Verwendung des optionalen Arguments der
+Gliederungsbefehle möglich. Siehe dazu die Anleitung zu den
+Gliederungsbefehlen der jeweiligen Klasse.
+
+Während \Macro{deftriplepagestyle} einen Seitenstil unabhängig davon, ob er
+bereits früher definiert wurde, immer definiert, werden mit
+\Macro{newtriplepagestyle} und \Macro{providetriplepagestyle} nur Seitenstile
+definiert, die derzeit noch nicht definiert sind. Ist ein Seitenstil hingegen
+bereits definiert, so erhält man mit \Macro{newtriplepagestyle} eine
+Fehlermeldung, während \Macro{providetriplepagestyle} die neue Definition
+einfach verwirft. Ein vorhandener Seitenstil kann auch mit
+\Macro{renewtriplepagestyle} umdefiniert werden. Diese Anweisung meldet einen
+Fehler, falls ein Seitenstil dieses Namens noch nicht definiert war.%
+
+\BeginIndex{Cmd}{deftripstyle}%
+Die bei \Package{scrpage2} vorhandene Anweisung \Macro{deftripstyle}
+entspricht damit der neuen Anweisung \Macro{deftriplepagestyle}. Sie wurde aus
+Gründen der Vereinheitlichung der Namen der Anweisungen jedoch umbenannt und
+sollte nicht mehr verwendet werden. Wird sie dennoch verwendet, resultiert
+daraus eine Warnung.%
+\EndIndex{Cmd}{deftripstyle}%
+\EndIndex{Cmd}{providetriplepagestyle}%
+\EndIndex{Cmd}{renewtriplepagestyle}%
+\EndIndex{Cmd}{newtriplepagestyle}%
+\EndIndex{Cmd}{deftriplepagestyle}%
+
+
+\section{Definition komplexer Seitenstile}
+\label{sec:scrlayer-scrpage-experts.pagestyle.experts}
+
+Neben den vordefinierten Seitenstilen und der Definition eigener
+Seitenstil-Paare, sowie der nicht mehr empfohlenen Möglichkeit der Definition
+von Seitenstilen, bei denen sowohl der Kopf als auch der Fuß fest in drei
+Elemente aufgeteilt ist, bietet \Package{scrlayer-scrpage} auch noch eine eher
+grundlegende Möglichkeit der Definition von Seitenstilen. Die in den
+vorherigen Abschnitten erläuterten Konzepte greifen bei der Implementierung
+alle auf diese Möglichkeit zurück. Aufgrund ihrer Komplexität wird diese
+Schnittstelle jedoch nur erfahrenen Anwendern empfohlen. Weniger erfahrene
+Anwender können mit den vorgenannten Möglichkeiten bereits nahezu alles
+erreichen, was auch mit dieser grundlegenden Schnittstelle möglich
+ist. Weniger erfahrene Anwender dürfen den Rest dieses Kapitels daher gerne
+überspringen.
+
+\begin{Declaration}
+ \Macro{defpagestyle}%
+ \Parameter{Name}\Parameter{Kopfdefinition}\Parameter{Fußdefinition}\\
+ \Macro{newpagestyle}%
+ \Parameter{Name}\Parameter{Kopfdefinition}\Parameter{Fußdefinition}\\
+ \Macro{providepagestyle}%
+ \Parameter{Name}\Parameter{Kopfdefinition}\Parameter{Fußdefinition}\\
+ \Macro{renewpagestyle}%
+ \Parameter{Name}\Parameter{Kopfdefinition}\Parameter{Fußdefinition}%
+\end{Declaration}
+\BeginIndex{Cmd}{defpagestyle}%
+\BeginIndex{Cmd}{newpagestyle}%
+\BeginIndex{Cmd}{providepagestyle}%
+\BeginIndex{Cmd}{renewpagestyle}%
+Diese Anweisungen dienen der Definition eines einzelnen Seitenstils mit
+maximaler Flexibilität. Dabei \PName{Name} der Name des Seitenstils, der
+definiert werden soll.
+
+Die beiden Parameter \PName{Kopfdefinition} und \PName{Fußdefinition} haben
+den identischen Aufbau:
+\begin{quote}\raggedright
+ \texttt{(\PName{Länge der oberen Linie},\PName{Dicke der oberen Linie})\%\\
+ \Parameter{Definition für linke Seiten im doppelseitigen Layout}\%\\
+ \Parameter{Definition für rechte Seiten im doppelseitigen Layout}\%\\
+ \Parameter{Definition für Seiten im einseitigen Layout}\%\\
+ (\PName{Länge der unteren Linie},\PName{Dicke der unteren Linie})%
+ }
+\end{quote}
+Dabei sind die Argumente in den runden Klammern optional, das heißt, sie
+können zusammen mit den Klammern weggelassen werden. In diesem Fall richtigen
+sich die Längen und Dicken je nach Linie nach den Angaben der Option
+\Option{headtopline}, \Option{headsepline}, \Option{footsepline} oder
+\Option{footbotline} (siehe \autoref{sec:scrlayer-scrpage.pagestyle.content},
+\autopageref{desc:scrlayer-scrpage.option.headtopline}).
+
+Die drei Argumente mit den Definitionen sind obligatorisch und werden je nach
+Seite und Layouteinstellung verwendet. Der Inhalt der Definitionen ist frei
+wählbar. Für Seitenstile mit Kolumnentitel wird jedoch die Verwendung von
+\Macro{headmark}, \Macro{leftmark} oder \Macro{rightmark} innerhalb der
+Definitionen empfohlen. Keinesfalls sollte man hier direkt eine
+Gliederungsnummer oder einen Überschriftentext als Kolumnentitel
+angeben. Aufgrund des asynchronen Seitenaufbaus von \LaTeX{} kann sonst die
+falsche Nummer oder der falsche Text im Seitenkopf erscheinen.
+
+Bei \Macro{defpagestyle} wird der Seitenstil unabhängig davon, ob er bereits
+existiert oder nicht, neu definiert. Demgegenüber meldet \Macro{newpagestyle}
+einen Fehler, wenn bereits ein Seitenstil gleichen Namens existiert. Im
+Unterschied dazu, wird die Definition bei \Macro{providepagestyle} ignoriert,
+falls der \PName{Name} bereits für einen Seitenstil verwendet wurde. Umgekehrt
+kann mit \Macro{renewpagestyle} nur ein bereits vorhandener Seitenstil
+umdefiniert werden. Für einen neuen Namen meldet diese Anweisung dagegen einen
+Fehler.
+
+Intern basiert diese Anweisung auf der Anweisung \Macro{DeclareLayerPageStyle}
+des Pakets \Package{scrlayer}. Dabei werden für einen Seitenstil \PName{Name}
+die Ebenen \PName{Name}\PValue{.head.above.line} für die Linie über dem Kopf,
+\PName{Name}\PValue{.head.odd} für den Kopf von rechten Seiten im
+doppelseitigen Layout, \PName{Name}\PValue{.head.even} für den Kopf von linken
+Seiten im doppelseitigen Layout, \PName{Name}\PValue{.head.oneside} für den
+Kopf von Seiten im einseitigen Layout, \PName{Name}\PValue{.head.below} für
+die Linie unter dem Kopf, \PName{Name}\PValue{.foot.above.line} für die Linie
+über dem Fuß, \PName{Name}\PValue{.foot.odd} für den Fuß von rechten Seiten im
+doppelseitigen Layout, \PName{Name}\PValue{.foot.even} für den Fuß von linken
+Seiten im doppelseitigen Layout, \PName{Name}\PValue{.foot.oneside} für den
+Fuß von Seiten im einseitigen Layout und \PName{Name}\PValue{.foot.below} für
+die Linie unter dem Fuß definiert. Näheres zu Ebenen und Ebenen-Seitenstilen
+ist \autoref{cha:scrlayer} ab \autopageref{cha:scrlayer} in
+\autoref{part:forExperts} zu entnehmen.%
+%
+\begin{Example}
+ Angenommen, Sie wollen den gesamten Kopf des Seitenstil
+ \Pagestyle{scrheadings} mit einer Farbe hinterlegen. Da Sie die
+ Einleitung zu diesem Kapitel gelesen haben, wissen Sie, dass
+ \Pagestyle{scrheadings} letztlich ein Ebenen-Seitenstil ist, der unter
+ anderem aus den Ebenen \PValue{scrheadings.head.even},
+ \PValue{scrheadings.head.odd} und \PValue{scrheadings.head.oneside}
+ besteht. Sie definieren nun drei weitere Ebenen für deren Hintergrund und
+ fügen diese am Anfang des Seitenstils ein:
+\begin{lstcode}
+ \documentclass{scrartcl}
+ \usepackage[automark]{scrlayer-scrpage}
+ \usepackage{xcolor}
+ \usepackage{blindtext}
+ \DeclareLayer[clone=scrheadings.head.oneside,
+ contents={%
+ \color{yellow}\rule[-\dp\strutbox]{\layerwidth}{\layerheight}%
+ }%
+ ]{scrheadings.head.oneside.background}
+ \DeclareLayer[clone=scrheadings.head.odd,
+ contents={%
+ \color{yellow}\rule[-\dp\strutbox]{\layerwidth}{\layerheight}%
+ }%
+ ]{scrheadings.head.odd.background}
+ \DeclareLayer[clone=scrheadings.head.even,
+ contents={%
+ \color{yellow}\rule[-\dp\strutbox]{\layerwidth}{\layerheight}%
+ }%
+ ]{scrheadings.head.even.background}
+ \AddLayersAtBeginOfPageStyle{scrheadings}{%
+ scrheadings.head.oneside.background,%
+ scrheadings.head.odd.background,%
+ scrheadings.head.even.background%
+ }
+ \pagestyle{scrheadings}
+ \begin{document}
+ \blinddocument
+ \end{document}
+\end{lstcode}
+ Wie Sie sehen, wurden in dem Beispiel drei Ebenen verwendet, damit Position
+ und Größe der Hintergrund-Ebenen per Option \Option{clone} einfach jeweils
+ von der Ebene für den Kopf kopiert werden konnten. Das ist einfacher, als
+ nur eine Hintergrundebene zu verwenden und für diese die Position
+ umständlich dynamisch zu bestimmen.
+
+ Der farbige Hintergrund selbst wurde in diesem Beispiel mit einer
+ \Macro{rule}-Anweisung gesetzt. Für die Größe wurde dabei mit
+ \Macro{layerwidth} und \Macro{layerheight} die aktuelle Breite und Höhe der
+ Ebene verwendet. Diese wurde per optionalem Argument um die Höhe der
+ Unterlängen \Macro{dp}\Macro{strutbox} nach unten verschoben.
+\end{Example}
+%
+Statt wie im Beispiel für die Hintergrundfarbe neue Ebenen hinzuzufügen, hätte
+man das Problem übrigens auch mit \Macro{colorbox} und \Macro{chead} lösen
+können. Es wird empfohlen, eine entsprechende Lösung als Übung zu
+erarbeiten. Ebenso hätte man die Hintergrundebenen auch einzeln und jeweils
+unmittelbar vor der entsprechenden Inhaltsebene einfügen können. Auch dies
+sei als Übung empfohlen.%
+\EndIndex{Cmd}{renewpagestyle}%
+\EndIndex{Cmd}{providepagestyle}%
+\EndIndex{Cmd}{newpagestyle}%
+\EndIndex{Cmd}{defpagestyle}%
+
+\begin{Declaration}
+ \KOption{hmode}\PValue{Ein-Aus-Wert}
+\end{Declaration}
+\BeginIndex{Option}{hmode}%
+Bei \Package{scrpage2} wurden die Köpfe und Füße der Seitenstile noch
+grundsätzlich im horizontalen Modus ausgegeben. Bei \Package{scrlayer-scrpage}
+wird hingegen in der Voreinstellung erst durch entsprechende Ausgaben selbst
+in den horizontalen Modus geschaltet. Aktiviert man jedoch Option
+\Option{hmode} verhält sich \Package{scrlayer-scrpage} auch in dieser Hinsicht
+kompatibel mit \Package{scrpage2} und schaltet bereits vor der Ausgabe in den
+horizontalen Modus. Dies kann Auswirkungen sowohl auf die Verarbeitung von
+Leerzeichen am Anfang der Ausgabe als auch auf die vertikale Ausrichtung
+haben.
+
+Die Option versteht die Standardwerte für einfache Schalter, die in
+\autoref{tab:truefalseswitch} auf \autopageref{tab:truefalseswitch} angegeben
+sind. In der Voreinstellung ist der Schalter deaktiviert.%
+\EndIndex{Option}{hmode}%
+%
+\EndIndex{Package}{scrlayer-scrpage}%
+
+%%% Local Variables:
+%%% mode: latex
+%%% mode: flyspell
+%%% coding: iso-latin-1
+%%% ispell-local-dictionary: "de_DE"
+%%% TeX-master: "../guide"
+%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage.tex
new file mode 100644
index 00000000000..9b556d5cf21
--- /dev/null
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer-scrpage.tex
@@ -0,0 +1,1205 @@
+% ======================================================================
+% scrlayer-scrpage.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ----------------------------------------------------------------------
+% scrlayer-scrpage.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ======================================================================
+%
+% Chapter about scrlayer-scrpage of the KOMA-Script guide
+%
+% ----------------------------------------------------------------------
+%
+% Kapitel über scrlayer-scrpage in der KOMA-Script-Anleitung
+%
+% ============================================================================
+
+\KOMAProvidesFile{scrlayer-scrpage.tex}%
+ [$Date: 2013-12-18 07:42:31 +0100 (Mi, 18. Dez 2013) $
+ KOMA-Script guide (chapter:scrlayer-scrpage)]
+
+\chapter[{Kopf- und Fußzeilen mit \Package{scrlayer-scrpage}}]
+ {Kopf-\ChangedAt{v3.12}{\Package{scrlayer-scrpage}} und Fußzeilen mit
+ \Package{scrlayer-scrpage}}
+\labelbase{scrlayer-scrpage}
+%
+\BeginIndex{Package}{scrlayer-scrpage}%
+\begin{Explain}
+ Bis \KOMAScript~3.11b war das Paket
+ \Package{scrpage2}\IndexPackage{scrpage2} das Mittel der Wahl, wenn es darum
+ ging, den Kopf und den Fuß der Seite über das hinaus zu verändern, was die
+ \KOMAScript-Klassen mit den Seitenstilen \Pagestyle{headings},
+ \Pagestyle{myheadings}, \Pagestyle{plain} und \Pagestyle{empty} boten. Bis
+ 2001 gab es dafür auch noch das Paket
+ \Package{scrpage}\IndexPackage{scrpage}, das aber seit 2013 nicht mehr mit
+ \KOMAScript{} zusammen verteilt wird.
+
+ Seit 2013 ist das Paket \Package{scrlayer}\IndexPackage{scrlayer} als neuer,
+ grundlegender Baustein in \KOMAScript{} enthalten. Dieses Paket bietet ein
+ Ebenenmodell, sowie ein darauf basierendes Seitenstil-Modell an. Für die
+ direkte Verwendung durch den durchschnittlichen Anwender ist die
+ Schnittstelle dieses Pakets jedoch fast schon zu flexibel und damit
+ einhergehend auch nicht leicht zu durchschauen. Näheres zu dieser
+ Schnittstelle ist \autoref{cha:scrlayer} in \autoref{part:forExperts} zu
+ entnehmen. Einige wenige Möglichkeiten, die eigentlich zu \Package{scrlayer}
+ gehören und deshalb in jenem Kapitel noch einmal aufgegriffen werden, sind
+ jedoch auch in diesem Kapitel dokumentiert, da sie für die Verwendung von
+ \Package{scrlayer-scrpage} ebenfalls benötigt werden.
+
+ Viele Anwender sind bereits mit den Anweisungen aus \Package{scrpage2}
+ vertraut. Deshalb wurde mit \Package{scrlayer-scrpage} ein Paket geschaffen,
+ das basierend auf \Package{scrlayer} eine mit \Package{scrpage2} weitgehend
+ kompatible und gleichzeitig stark erweiterte Anwender-Schnittstelle
+ bereitstellt. Wer bereits mit \Package{scrpage2} vertraut ist und dort keine
+ unsauberen Rückgriffe auf interne Anweisungen getätigt hat, kann daher in
+ der Regel \Package{scrpage2} recht einfach durch \Package{scrlayer-scrpage}
+ ersetzen. Das gilt mit der genannten Einschränkung auch für die meisten
+ Beispiele in \LaTeX-Büchern oder im Internet.
+
+\iffree{}{Mit Erscheinen dieses Buches wird \Package{scrlayer-scrpage} für
+ \KOMAScript{} das empfohlene Mittel der Wahl, wenn es um Änderungen der
+ vordefinierten Seitenstile geht. Die Verwendung des als veraltet
+ anzusehenden Pakets \Package{scrpage2}\IndexPackage[indexmain]{scrpage2}%
+ \important{\Package{scrpage2}} wird hingegen nicht mehr empfohlen. Daher ist
+ die Anleitung zu diesem veralteten Paket auch nicht mehr Bestandteil dieses
+ Buches. Wenn Sie auf ältere Dokumente stoßen, die noch \Package{scrpage2}
+ verwenden, sollten Sie eine Umstellung auf \Package{scrlayer-scrpage}
+ erwägen. Für alle Fälle finden Sie in diesem Kapitel auch einige Hinweise
+ zur Verwendung von \Package{scrpage2}.}
+\end{Explain}
+
+Neben \Package{scrlayer-scrpage}\iffree{oder \Package{scrpage2}}{} wäre auch
+\Package{fancyhdr} (siehe \cite{package:fancyhdr}) grundsätzlich geeignet, um
+Kopf und Fuß der Seiten zu konfigurieren. Allerdings unterstützt dieses Paket
+diverse Möglichkeiten von \KOMAScript{}, angefangen von Änderungen der Schrift
+über das Elemente-Modell (siehe \Macro{setkomafont}, \Macro{addtokomafont} und
+\Macro{usekomafont} in \autoref{sec:maincls.textmarkup}, ab
+\autopageref{desc:maincls.cmd.setkomafont}) bis hin zum konfigurierbaren
+Format der Gliederungsnummern in Kolumnentiteln (siehe Option \Option{numbers}
+und beispielsweise Anweisung \Macro{chaptermarkformat} in
+\autoref{sec:maincls.structure}, \autopageref{desc:maincls.option.numbers} und
+\autopageref{desc:maincls.cmd.chaptermarkformat}), nicht. Daher wird für die
+Verwendung mit den \KOMAScript-Klassen das neue Paket
+\Package{scrlayer-scrpage} empfohlen. \iffree{Bei Problemen damit kann auch
+ auf \Package{scrpage2} zurückgegriffen werden.}{\ignorespaces} Natürlich
+kann \Package{scrlayer-scrpage} auch mit anderen Klassen, beispielsweise den
+Standardklassen verwendet werden.
+
+Über die in diesem Kapitel erklärten Möglichkeiten hinaus bietet das Paket
+\Package{scrlayer-scrpage} weiteres, das jedoch nur für einige, wenige
+Anwender von Interesse sein dürfte und daher in
+\autoref{cha:scrlayer-scrpage-experts} von \autoref{part:forExperts} ab
+\autopageref{cha:scrlayer-scrpage-experts} ausgeführt wird. Dennoch: Falls die
+hier in \autoref{part:forAuthors} dokumentierten Möglichkeiten für Sie nicht
+ausreichen, sei Ihnen auch jenes Kapitel nahe gelegt.
+
+\LoadCommon{0} % \section{Frühe oder späte Optionenwahl}
+
+\LoadCommon{20} % \section{Höhe von Kopf und Fuß}
+
+\LoadCommon{5} % \section{Textauszeichnung}
+
+\section{Verwendung vordefinierter Seitenstile}
+\label{sec:scrlayer-scrpage.predefined.pagestyles}
+
+Die einfachste Möglichkeit, mit \Package{scrlayer-scrpage} zu seinem
+Wunschdesign für Kopf und Fuß der Seite zu gelangen, ist die Verwendung eines
+vorgefertigten Seitenstils.
+%
+\iffalse % Umbruchoptimierung
+ In diesem Abschnitt werden die vom Paket \Package{scrlayer-scrpage} bereits
+ beim Laden definierten Seitenstile vorgestellt. Darüber hinaus werden
+ diejenigen Befehle erklärt, mit denen grundlegende Einstellungen bei diesen
+ Seitenstilen vorgenommen werden können. Weitere Optionen, Befehle und
+ Hintergründe sind in den nachfolgenden Abschnitten, aber auch in
+ \autoref{sec:scrlayer-scrpage-experts.pagestyle.pairs} in
+ \autoref{part:forExperts} zu finden.%
+\fi
+
+\begin{Declaration}
+ \Pagestyle{scrheadings}\\
+ \Pagestyle{plain.scrheadings}
+\end{Declaration}
+\BeginIndex{Pagestyle}{scrheadings}%
+\BeginIndex{Pagestyle}{plain.scrheadings}%
+Das Paket \Package{scrlayer-scrpage} stellt zwei Seitenstile zur Verfügung,
+die nach eigenen Wünschen umgestaltet werden können. Als erstes wäre der
+Seitenstil \Pagestyle{scrheadings}\important{\Pagestyle{scrheadings}} zu
+nennen. Dieser ist als Seitenstil mit Kolumnentitel vorgesehen. Er ähnelt in
+der Voreinstellung dem Seitenstil
+\Pagestyle{headings}\IndexPagestyle{headings} der Standard- oder der
+\KOMAScript-Klassen. Was genau im Kopf und Fuß ausgegeben wird, ist über die
+nachfolgend beschriebenen Befehle und Optionen einstellbar.
+
+Als zweites ist der Seitenstil
+\Pagestyle{plain.scrheadings}\important{\Pagestyle{plain.scrheadings}} zu
+nennen. Dieser ist als Seitenstil ohne Kolumnentitel vorgesehen. Er ähnelt in
+der Voreinstellung dem Seitenstil \Pagestyle{plain}\IndexPagestyle{plain} der
+Standard- oder der \KOMAScript-Klassen. Was genau im Kopf und Fuß ausgegeben
+wird, ist auch hier über die nachfolgend beschriebenen Befehle und Optionen
+einstellbar.
+
+Natürlich kann auch \Pagestyle{scrheadings} als Seitenstil ohne Kolumnentitel
+und \Pagestyle{plain.scrheadings} als Seitenstil mit Kolumnentitel
+konfiguriert werden. Es ist jedoch zweckmäßig, sich an die vorgenannte
+Konvention zu halten. Die beiden Seitenstile beeinflussen sich nämlich in
+gewisser Weise gegenseitig. Sobald einer der Seitenstile einmal ausgewählt
+wurde, ist \Pagestyle{scrheadings} auch unter dem Namen
+\Pagestyle{headings}\important{\Pagestyle{headings}}\IndexPagestyle{headings}
+und der Seitenstil \Pagestyle{plain.scrheadings} auch unter dem Namen
+\Pagestyle{plain}\important{\Pagestyle{plain}}\IndexPagestyle{plain}
+aktivierbar. Das hat den Vorteil, dass bei Klassen, die automatisch zwischen
+\Pagestyle{headings} und \Pagestyle{plain} umschalten, durch einmalige Auswahl
+von \Pagestyle{scrheadings} oder \Pagestyle{plain.scrheadings} nun zwischen
+diesen beiden Stilen umgeschaltet wird. Direkte Anpassungen der entsprechenden
+Klassen sind nicht erforderlich. Die beiden Seitenstile stellen also quasi ein
+Paar dar, das als Ersatz für \Pagestyle{headings} und \Pagestyle{plain}
+verwendet werden kann. Sollten weitere solche Paare benötigt werden, so sei
+auf \autoref{sec:scrlayer-scrpage-experts.pagestyle.pairs} in
+\autoref{part:forExperts} verwiesen.
+
+Für\important{\Package{scrpage2}} frühere Benutzer des alten
+\KOMAScript-Pakets \Package{scrpage2} sei ausdrücklich noch darauf
+hingewiesen, dass \Pagestyle{plain.scrheadings} aus Gründen der Kompatibilität
+mit jenem Paket auch unter dem Alias-Namen
+\Pagestyle{scrplain}\IndexPagestyle[indexmain]{scrplain} angesprochen werden
+kann.\iffree{}{ Bei Verwendung von \Package{scrpage2}\IndexPackage{scrpage2}
+ existiert hingegen \Pagestyle{plain.scrheadings} nicht. Dessen Funktion wird
+ dann vollständig vom Seitenstil \Pagestyle{scrplain} übernommen.}
+\EndIndex{Pagestyle}{plain.scrheadings}%
+\EndIndex{Pagestyle}{scrheadings}%
+
+\begin{Declaration}
+ \Macro{lehead}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}\\
+ \Macro{cehead}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}\\
+ \Macro{rehead}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}\\
+ \Macro{lohead}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}\\
+ \Macro{cohead}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}\\
+ \Macro{rohead}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}
+\end{Declaration}
+\BeginIndex{Cmd}{lehead}%
+\BeginIndex{Cmd}{cehead}%
+\BeginIndex{Cmd}{rehead}%
+\BeginIndex{Cmd}{lohead}%
+\BeginIndex{Cmd}{cohead}%
+\BeginIndex{Cmd}{rohead}%
+Was in den Kopf der Seitenstile \Pagestyle{plain.scrheadings}\iffree{}{ --
+ beim veralteten Paket
+ \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}
+ entsprechend in den Kopf von \Pagestyle{scrplain} --} und
+\Pagestyle{scrheadings} geschrieben wird, ist mit Hilfe dieser Befehle
+einstellbar. Dabei setzt das optionale Argument jeweils den Inhalt eines
+Elements in \Pagestyle{plain.scrheadings}\iffree{}{ beziehungsweise
+ \Pagestyle{scrplain}}, während das obligatorische Argument jeweils einen
+Inhalt in \Pagestyle{scrheadings} setzt.
+
+Die Inhalte für gerade, also linke Seiten\textnote{linke Seite} werden mit den
+Befehlen \Macro{lehead}, \Macro{cehead} und \Macro{rehead} gesetzt. Das
+»\texttt{e}« an zweiter Stelle des Befehlsnamens steht dabei für »\emph{even}«
+(engl. für »gerade«).
+
+Die Inhalte für ungerade, also rechte Seiten\textnote{rechte Seite} werden mit
+den Befehlen \Macro{lohead}, \Macro{cohead} und \Macro{rohead} gesetzt. Das
+»\texttt{o}« an zweiter Stelle des Befehlsnamens steht dabei für »\emph{odd}«
+(engl. für »ungerade«).
+
+Es\textnote{Achtung!} sei an dieser Stelle noch einmal darauf hingewiesen,
+dass im einseitigen Satz nur rechte Seiten existieren und diese von \LaTeX{}
+unabhängig von ihrer Nummer als ungerade Seiten bezeichnet werden.
+
+Jeder Kopf eines Seitenstils besitzt ein linksbündiges\textnote{linksbündig}
+Element, das mit \Macro{lehead} respektive \Macro{lohead} gesetzt werden
+kann. Das »\texttt{l}« am Anfang des Befehlsnamens steht hier für »\emph{left
+ aligned}« (engl. für »linksbündig«).
+
+Ebenso besitzt jeder Kopf eines Seitenstils ein zentriert\textnote{zentriert}
+gesetztes Element, das mit \Macro{cehead} respektive \Macro{cohead} gesetzt
+werden kann. Das »\texttt{c}« am Anfang des Befehlsnamens steht hier für
+»\emph{centred}« (engl. für »zentriert«).
+
+Entsprechend besitzt jeder Kopf eines Seitenstil auch ein
+rechtsbündiges\textnote{rechtsbündig} Element, das mit \Macro{rehead}
+respektive \Macro{rohead} gesetzt werden kann. Das »\texttt{r}« am Anfang des
+Befehlsnamens steht hier für »\emph{right aligned}« (engl. für
+»rechtsbündig«).
+
+\BeginIndex{FontElement}{pagehead}%
+\BeginIndex{FontElement}{pageheadfoot}%
+Diese Elemente besitzen jedoch nicht jedes für sich eine Schriftzuordnung mit
+Hilfe der Befehle \Macro{setkomafont} und \Macro{addtokomafont} (siehe
+\autoref{sec:maincls.textmarkup}, \autopageref{desc:maincls.cmd.setkomafont}),
+sondern alle zusammen über das Element
+\FontElement{pagehead}\important{\FontElement{pagehead}}. Vor diesem wird
+außerdem noch das Element
+\FontElement{pageheadfoot}\important{\FontElement{pageheadfoot}}
+angewandt. Die Voreinstellungen für diese beiden Elemente sind
+\autoref{tab:scrlayer-scrpage.fontelements},
+\autopageref{tab:scrlayer-scrpage.fontelements} zu entnehmen.%
+\EndIndex{FontElement}{pageheadfoot}%
+\EndIndex{FontElement}{pagehead}%
+
+In \autoref{fig:scrlayer-scrpage.head} ist die Bedeutung der einzelnen Befehle
+für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.%
+%
+\begin{figure}[tp]
+ \centering
+ \begin{picture}(\textwidth,30mm)(0,-10mm)
+ \thinlines
+ \small\ttfamily
+ % linke Seite
+ \put(0,20mm){\line(1,0){.49\textwidth}}%
+ \put(0,0){\line(0,1){20mm}}%
+ \multiput(0,0)(0,-1mm){10}{\line(0,-1){.5mm}}%
+ \put(.49\textwidth,5mm){\line(0,1){15mm}}%
+ \put(.05\textwidth,10mm){%
+ \iffree{\color{red}}{}%
+ \put(-.5em,0){\line(1,0){4em}}%
+ \multiput(3.5em,0)(.25em,0){5}{\line(1,0){.125em}}%
+ \put(-.5em,0){\line(0,1){\baselineskip}}%
+ \put(-.5em,\baselineskip){\line(1,0){4em}}%
+ \multiput(3.5em,\baselineskip)(.25em,0){5}{\line(1,0){.125em}}%
+ \makebox(4em,5mm)[l]{\Macro{lehead}}%
+ }%
+ \put(.465\textwidth,10mm){%
+ \iffree{\color{blue}}{}%
+ \put(-4em,0){\line(1,0){4em}}%
+ \multiput(-4em,0)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(0,0){\line(0,1){\baselineskip}}%
+ \put(-4em,\baselineskip){\line(1,0){4em}}%
+ \multiput(-4em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-4.5em,0){\makebox(4em,5mm)[r]{\Macro{rehead}}}%
+ }%
+ \put(.2525\textwidth,10mm){%
+ \iffree{\color{green}}{}%
+ \put(-2em,0){\line(1,0){4em}}%
+ \multiput(2em,0)(.25em,0){5}{\line(1,0){.125em}}%
+ \multiput(-2em,0)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-2em,\baselineskip){\line(1,0){4em}}%
+ \multiput(2em,\baselineskip)(.25em,0){5}{\line(1,0){.125em}}%
+ \multiput(-2em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-2em,0){\makebox(4em,5mm)[c]{\Macro{cehead}}}%
+ }%
+ % rechte Seite
+ \put(.51\textwidth,20mm){\line(1,0){.49\textwidth}}%
+ \put(.51\textwidth,5mm){\line(0,1){15mm}}%
+ \put(\textwidth,0){\line(0,1){20mm}}%
+ \multiput(\textwidth,0)(0,-1mm){10}{\line(0,-1){.5mm}}%
+ \put(.5325\textwidth,10mm){%
+ \iffree{\color{blue}}{}%
+ \put(0,0){\line(1,0){4em}}%
+ \multiput(4em,0)(.25em,0){5}{\line(1,0){.125em}}%
+ \put(0,0){\line(0,1){\baselineskip}}%
+ \put(0em,\baselineskip){\line(1,0){4em}}%
+ \multiput(4em,\baselineskip)(.25em,0){5}{\line(1,0){.125em}}%
+ \put(.5em,0){\makebox(4em,5mm)[l]{\Macro{lohead}}}%
+ }%
+ \put(.965\textwidth,10mm){%
+ \iffree{\color{red}}{}%
+ \put(-4em,0){\line(1,0){4em}}%
+ \multiput(-4em,0)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(0,0){\line(0,1){\baselineskip}}%
+ \put(-4em,\baselineskip){\line(1,0){4em}}%
+ \multiput(-4em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-4.5em,0){\makebox(4em,5mm)[r]{\Macro{rohead}}}%
+ }%
+ \put(.75\textwidth,10mm){%
+ \iffree{\color{green}}{}%
+ \put(-2em,0){\line(1,0){4em}}%
+ \multiput(2em,0)(.25em,0){5}{\line(1,0){.125em}}%
+ \multiput(-2em,0)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-2em,\baselineskip){\line(1,0){4em}}%
+ \multiput(2em,\baselineskip)(.25em,0){5}{\line(1,0){.125em}}%
+ \multiput(-2em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-2em,0){\makebox(4em,5mm)[c]{\Macro{cohead}}}%
+ }%
+ % Befehle für beide Seiten
+ \iffree{\color{blue}}{}%
+ \put(.5\textwidth,0){\makebox(0,\baselineskip)[c]{\Macro{ihead}}}%
+ \iffree{\color{green}}{}%
+ \put(.5\textwidth,-5mm){\makebox(0,\baselineskip)[c]{\Macro{chead}}}
+ \iffree{\color{red}}{}%
+ \put(.5\textwidth,-10mm){\makebox(0,\baselineskip)[c]{\Macro{ohead}}}
+ \put(\dimexpr.5\textwidth-2em,.5\baselineskip){%
+ \iffree{\color{blue}}{}%
+ \put(0,0){\line(-1,0){1.5em}}%
+ \put(-1.5em,0){\vector(0,1){5mm}}%
+ \iffree{\color{green}}{}%
+ \put(0,-1.25\baselineskip){\line(-1,0){\dimexpr .25\textwidth-2em\relax}}%
+ \put(-\dimexpr
+ .25\textwidth-2em\relax,-1.25\baselineskip){\vector(0,1){\dimexpr
+ 5mm+1.25\baselineskip\relax}}
+ \iffree{\color{red}}{}%
+ \put(0,-2.5\baselineskip){\line(-1,0){\dimexpr .45\textwidth-4em\relax}}%
+ \put(-\dimexpr
+ .45\textwidth-4em\relax,-2.5\baselineskip){\vector(0,1){\dimexpr
+ 5mm+2.5\baselineskip\relax}}
+ }%
+ \put(\dimexpr.5\textwidth+2em,.5\baselineskip){%
+ \iffree{\color{blue}}{}%
+ \put(0,0){\line(1,0){1.5em}}%
+ \put(1.5em,0){\vector(0,1){5mm}}%
+ \iffree{\color{green}}{}%
+ \put(0,-1.25\baselineskip){\line(1,0){\dimexpr .25\textwidth-2em\relax}}
+ \put(\dimexpr
+ .25\textwidth-2em\relax,-1.25\baselineskip){\vector(0,1){\dimexpr
+ 5mm+1.25\baselineskip\relax}}
+ \iffree{\color{red}}{}%
+ \put(0,-2.5\baselineskip){\line(1,0){\dimexpr .45\textwidth-4em\relax}}
+ \put(\dimexpr
+ .45\textwidth-4em\relax,-2.5\baselineskip){\vector(0,1){\dimexpr
+ 5mm+2.5\baselineskip\relax}}
+ }%
+ \end{picture}
+ \caption[Befehle zum Setzen des Seitenkopfes]%
+ {Die Bedeutung der Befehle zum Setzen der Inhalte des Kopfs eines
+ Seitenstils für die Seitenköpfe einer schematischen Doppelseite}
+ \label{fig:scrlayer-scrpage.head}
+\end{figure}
+%
+\begin{Example}
+ Angenommen, Sie verfassen einen kurzen Artikel und wollen, dass im Kopf der
+ Seiten links der Name des Autors und rechts der Titel des Artikels
+ steht. Sie schreiben daher beispielsweise:
+\begin{lstcode}
+ \documentclass{scrartcl}
+ \usepackage{scrlayer-scrpage}
+ \lohead{Peter Musterheinzel}
+ \rohead{Seitenstile mit \KOMAScript}
+ \pagestyle{scrheadings}
+ \begin{document}
+ \title{Seitenstile mit \KOMAScript}
+ \author{Peter Musterheinzel}
+ \maketitle
+ \end{document}
+\end{lstcode}
+ Doch, was ist das? Auf der ersten Seite erscheint nur eine Seitenzahl im
+ Fuß, der Kopf hingegen bleibt leer!
+
+ Die Erklärung dafür ist einfach: Die Klasse \Class{scrartcl} schaltet wie
+ auch die Standardklasse \Class{article} für die Seite mit dem Titelkopf in
+ der Voreinstellung auf den Seitenstil \Pagestyle{plain}. Nach der Anweisung
+ \Macro{pagestyle}\PParameter{scrheadings} in der Präambel unseres Beispiels
+ führt dies tatsächlich zur Verwendung des Seitenstils
+ \Pagestyle{plain.scrheadings} für die Seite mit dem Titelkopf. Dieser
+ Seitenstil ist bei Verwendung einer \KOMAScript-Klasse mit leerem Kopf und
+ Seitenzahl im Fuß vorkonfiguriert. Da im Beispiel das optionale Argument von
+ \Macro{lohead} und \Macro{rohead} gar nicht verwendet wird, bleibt der
+ Seitenstil \Pagestyle{plain.scrheadings} unverändert. Das Ergebnis ist für
+ die erste Seite also tatsächlich korrekt.
+
+ Fügen Sie jetzt im Beispiel nach \Macro{maketitle} so viel Text ein, dass
+ eine zweite Seite ausgegeben wird. Sie können dazu auch einfach
+ \Macro{usepackage}\PParameter{lipsum}\IndexPackage{lipsum} in der
+ Dokumentpräambel und \Macro{lipsum}\IndexCmd{lipsum} nach \Macro{maketitle}
+ ergänzen. Wie Sie sehen werden, enthält der Kopf der zweiten Seite nun,
+ genau wie gewünscht, den Namen des Autors und den Titel des Dokuments.
+
+ Zum Vergleich sollten Sie zusätzlich das optionale Argument der Anweisungen
+ \Macro{lohead} und \Macro{rohead} mit einem Inhalt versehen. Ändern Sie das
+ Beispiel dazu wie folgt ab:
+\begin{lstcode}
+ \documentclass{scrartcl}
+ \usepackage{scrlayer-scrpage}
+ \lohead[Peter Musterheinzel]
+ {Peter Musterheinzel}
+ \rohead[Seitenstile mit \KOMAScript]
+ {Seitenstile mit \KOMAScript}
+ \pagestyle{scrheadings}
+ \usepackage{lipsum}
+ \begin{document}
+ \title{Seitenstile mit \KOMAScript}
+ \author{Peter Musterheinzel}
+ \maketitle
+ \lipsum
+ \end{document}
+\end{lstcode}
+ Jetzt haben Sie den Kopf auch auf der ersten Seite direkt über dem Titelkopf
+ selbst. Das kommt daher, dass Sie mit den beiden optionalen Argumenten den
+ Seitenstil \Pagestyle{plain.scrheadings} nun ebenfalls entsprechend
+ konfiguriert haben. Wie Sie am Ergebnis vermutlich auch erkennen, ist es
+ jedoch besser, diesen Seitenstil unverändert zu lassen, da der Kolumnentitel
+ über dem Titelkopf doch eher störend ist.
+
+ Alternativ zur Konfigurierung von \Pagestyle{plain.scrheadings} hätte man
+ bei Verwendung einer \KOMAScript-Klasse übrigens auch den Seitenstil für
+ Seiten mit Titelkopf ändern können. Siehe dazu
+ \Macro{titlepagestyle}\important{\Macro{titlepagestyle}}%
+ \IndexCmd{titlepagestyle} in \autoref{sec:maincls.pagestyle},
+ \autopageref{desc:maincls.cmd.titlepagestyle}.
+\end{Example}
+%
+\iffree{}{Der Code aus dem Beispiel funktionieren übrigens unverändert auch
+ mit dem veralteten Paket
+ \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}.}%
+
+Erlauben Sie mir einen wichtigen Hinweis:\textnote{Achtung!} Sie sollten
+niemals die Überschrift oder die Nummer einer Gliederungsebene mit Hilfe einer
+dieser Anweisungen als Kolumnentitel in den Kopf der Seite setzen. Aufgrund
+der Asynchronizität von Seitenaufbau und Seitenausgabe kann es sonst leicht
+geschehen, dass die falsche Nummer oder die falsche Überschrift im
+Kolumnentitel ausgegeben wird. Stattdessen ist der Mark-Mechanismus idealer
+Weise in Verbindung mit den Automatismen, die im nächsten Abschnitt erklärt
+werden, zu verwenden.%
+\EndIndex{Cmd}{rohead}%
+\EndIndex{Cmd}{cohead}%
+\EndIndex{Cmd}{lohead}%
+\EndIndex{Cmd}{rehead}%
+\EndIndex{Cmd}{cehead}%
+\EndIndex{Cmd}{lehead}%
+
+\begin{Declaration}
+ \Macro{lefoot}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}\\
+ \Macro{cefoot}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}\\
+ \Macro{refoot}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}\\
+ \Macro{lofoot}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}\\
+ \Macro{cofoot}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}\\
+ \Macro{rofoot}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}
+\end{Declaration}
+\BeginIndex{Cmd}{lefoot}%
+\BeginIndex{Cmd}{cefoot}%
+\BeginIndex{Cmd}{refoot}%
+\BeginIndex{Cmd}{lofoot}%
+\BeginIndex{Cmd}{cofoot}%
+\BeginIndex{Cmd}{rofoot}%
+Was in den Fuß der Seitenstile \Pagestyle{plain.scrheadings}\iffree{}{ --
+ beim veralteten Paket
+ \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}
+ entsprechend in den Kopf von \Pagestyle{scrplain} --} und
+\Pagestyle{scrheadings} geschrieben wird, ist mit Hilfe dieser Befehle
+einstellbar. Dabei setzt das optionale Argument jeweils den Inhalt eines
+Elements in \Pagestyle{plain.scrheadings}, während das obligatorische Argument
+jeweils einen Inhalt in \Pagestyle{scrheadings} setzt.
+
+Die Inhalte für gerade, also linke Seiten\textnote{linke Seite} werden mit den
+Befehlen \Macro{lefoot}, \Macro{cefoot} und \Macro{refoot} gesetzt. Das
+»\texttt{e}« an zweiter Stelle des Befehlsnamens steht dabei für »\emph{even}«
+(engl. für »gerade«).
+
+Die Inhalte für ungerade, also rechte Seiten\textnote{rechte Seite} werden mit
+den Befehlen \Macro{lofoot}, \Macro{cofoot} und \Macro{rofoot} gesetzt. Das
+»\texttt{o}« an zweiter Stelle des Befehlsnamens steht dabei für »\emph{odd}«
+(engl. für »ungerade«).
+
+Es\textnote{Achtung!} sei an dieser Stelle noch einmal darauf hingewiesen,
+dass im einseitigen Satz nur rechte Seiten existieren und diese von \LaTeX{}
+unabhängig von ihrer Nummer als ungerade Seiten gezeichnet werden.
+
+Jeder Fuß eines Seitenstils besitzt ein linksbündiges\textnote{linksbündig}
+Element, das mit \Macro{lefoot} respektive \Macro{lofoot} gesetzt werden
+kann. Das »\texttt{l}« am Anfang des Befehlsnamens steht hier für »\emph{left
+ aligned}« (engl. für »linksbündig«).
+
+Ebenso besitzt jeder Fuß eines Seitenstils ein zentriert\textnote{zentriert}
+gesetztes Element, das mit \Macro{cefoot} respektive \Macro{cofoot} gesetzt
+werden kann. Das »\texttt{c}« am Anfang des Befehlsnamens steht hier für
+»\emph{centered}« (engl. für »zentriert«).
+
+Entsprechend besitzt jeder Fuß eines Seitenstil auch ein
+rechtsbündiges\textnote{rechtsbündig} Element, das mit \Macro{refoot}
+respektive \Macro{rofoot} gesetzt werden kann. Das »\texttt{r}« am Anfang des
+Befehlsnamens steht hier für »\emph{right aligned}« (engl. für
+»rechtsbündig«).
+
+\BeginIndex{FontElement}{pagefoot}%
+\BeginIndex{FontElement}{pageheadfoot}%
+Diese Elemente besitzen jedoch nicht jedes für sich eine Schriftzuordnung mit
+Hilfe der Befehle \Macro{setkomafont} und \Macro{addtokomafont} (siehe
+\autoref{sec:maincls.textmarkup}, \autopageref{desc:maincls.cmd.setkomafont}),
+sondern alle zusammen über das Element \FontElement{pagefoot}. Vor diesem wird
+außerdem noch das Element \FontElement{pageheadfoot} angewandt. Die
+Voreinstellungen für diese beiden Elemente sind
+\autoref{tab:scrlayer-scrpage.fontelements},
+\autopageref{tab:scrlayer-scrpage.fontelements} zu entnehmen.%
+\EndIndex{FontElement}{pageheadfoot}%
+\EndIndex{FontElement}{pagefoot}%
+
+In \autoref{fig:scrlayer-scrpage.foot} ist die Bedeutung der einzelnen Befehle
+für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert.
+%
+\begin{figure}[bp]
+ \centering
+ \begin{picture}(\textwidth,30mm)
+ \thinlines
+ \small\ttfamily
+ % linke Seite
+ \put(0,0){\line(1,0){.49\textwidth}}%
+ \put(0,0){\line(0,1){20mm}}%
+ \multiput(0,20mm)(0,1mm){10}{\line(0,1){.5mm}}%
+ \put(.49\textwidth,0){\line(0,1){15mm}}%
+ \put(.05\textwidth,5mm){%
+ \iffree{\color{red}}{}%
+ \put(-.5em,0){\line(1,0){4em}}%
+ \multiput(3.5em,0)(.25em,0){5}{\line(1,0){.125em}}%
+ \put(-.5em,0){\line(0,1){\baselineskip}}%
+ \put(-.5em,\baselineskip){\line(1,0){4em}}%
+ \multiput(3.5em,\baselineskip)(.25em,0){5}{\line(1,0){.125em}}%
+ \makebox(4em,5mm)[l]{\Macro{lefoot}}%
+ }%
+ \put(.465\textwidth,5mm){%
+ \iffree{\color{blue}}{}%
+ \put(-4em,0){\line(1,0){4em}}%
+ \multiput(-4em,0)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(0,0){\line(0,1){\baselineskip}}%
+ \put(-4em,\baselineskip){\line(1,0){4em}}%
+ \multiput(-4em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-4.5em,0){\makebox(4em,5mm)[r]{\Macro{refoot}}}%
+ }%
+ \put(.2525\textwidth,5mm){%
+ \iffree{\color{green}}{}%
+ \put(-2em,0){\line(1,0){4em}}%
+ \multiput(2em,0)(.25em,0){5}{\line(1,0){.125em}}%
+ \multiput(-2em,0)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-2em,\baselineskip){\line(1,0){4em}}%
+ \multiput(2em,\baselineskip)(.25em,0){5}{\line(1,0){.125em}}%
+ \multiput(-2em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-2em,0){\makebox(4em,5mm)[c]{\Macro{cefoot}}}%
+ }%
+ % rechte Seite
+ \put(.51\textwidth,0){\line(1,0){.49\textwidth}}%
+ \put(.51\textwidth,0){\line(0,1){15mm}}%
+ \put(\textwidth,0){\line(0,1){20mm}}%
+ \multiput(\textwidth,20mm)(0,1mm){10}{\line(0,1){.5mm}}%
+ \put(.5325\textwidth,5mm){%
+ \iffree{\color{blue}}{}%
+ \put(0,0){\line(1,0){4em}}%
+ \multiput(4em,0)(.25em,0){5}{\line(1,0){.125em}}%
+ \put(0,0){\line(0,1){\baselineskip}}%
+ \put(0em,\baselineskip){\line(1,0){4em}}%
+ \multiput(4em,\baselineskip)(.25em,0){5}{\line(1,0){.125em}}%
+ \put(.5em,0){\makebox(4em,5mm)[l]{\Macro{lofoot}}}%
+ }%
+ \put(.965\textwidth,5mm){%
+ \iffree{\color{red}}{}%
+ \put(-4em,0){\line(1,0){4em}}%
+ \multiput(-4em,0)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(0,0){\line(0,1){\baselineskip}}%
+ \put(-4em,\baselineskip){\line(1,0){4em}}%
+ \multiput(-4em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-4.5em,0){\makebox(4em,5mm)[r]{\Macro{rofoot}}}%
+ }%
+ \put(.75\textwidth,5mm){%
+ \iffree{\color{green}}{}%
+ \put(-2em,0){\line(1,0){4em}}%
+ \multiput(2em,0)(.25em,0){5}{\line(1,0){.125em}}%
+ \multiput(-2em,0)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-2em,\baselineskip){\line(1,0){4em}}%
+ \multiput(2em,\baselineskip)(.25em,0){5}{\line(1,0){.125em}}%
+ \multiput(-2em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}%
+ \put(-2em,0){\makebox(4em,5mm)[c]{\Macro{cofoot}}}%
+ }%
+ % Befehle für beide Seiten
+ \iffree{\color{blue}}{}%
+ \put(.5\textwidth,15mm){\makebox(0,\baselineskip)[c]{\Macro{ifoot}}}%
+ \iffree{\color{green}}{}%
+ \put(.5\textwidth,20mm){\makebox(0,\baselineskip)[c]{\Macro{cfoot}}}
+ \iffree{\color{red}}{}%
+ \put(.5\textwidth,25mm){\makebox(0,\baselineskip)[c]{\Macro{ofoot}}}
+ \put(\dimexpr.5\textwidth-2em,.5\baselineskip){%
+ \iffree{\color{blue}}{}%
+ \put(0,15mm){\line(-1,0){1.5em}}%
+ \put(-1.5em,15mm){\vector(0,-1){5mm}}%
+ \iffree{\color{green}}{}%
+ \put(0,20mm){\line(-1,0){\dimexpr .25\textwidth-2em\relax}}%
+ \put(-\dimexpr .25\textwidth-2em\relax,20mm){\vector(0,-1){10mm}}%
+ \iffree{\color{red}}{}%
+ \put(0,25mm){\line(-1,0){\dimexpr .45\textwidth-4em\relax}}%
+ \put(-\dimexpr .45\textwidth-4em\relax,25mm){\vector(0,-1){15mm}}%
+ }%
+ \put(\dimexpr.5\textwidth+2em,.5\baselineskip){%
+ \iffree{\color{blue}}{}%
+ \put(0,15mm){\line(1,0){1.5em}}%
+ \put(1.5em,15mm){\vector(0,-1){5mm}}%
+ \iffree{\color{green}}{}%
+ \put(0,20mm){\line(1,0){\dimexpr .25\textwidth-2em\relax}}%
+ \put(\dimexpr .25\textwidth-2em\relax,20mm){\vector(0,-1){10mm}}%
+ \iffree{\color{red}}{}%
+ \put(0,25mm){\line(1,0){\dimexpr .45\textwidth-4em\relax}}%
+ \put(\dimexpr .45\textwidth-4em\relax,25mm){\vector(0,-1){15mm}}%
+ }%
+ \end{picture}
+ \caption[Befehle zum Setzen des Seitenfußes]%
+ {Die Bedeutung der Befehle zum Setzen der Inhalte des Fußes eines
+ Seitenstils für die Seitenfüße einer schematischen Doppelseite.}
+ \label{fig:scrlayer-scrpage.foot}
+\end{figure}
+%
+\begin{Example}
+ Kommen wir zu dem Beispiel des kurzen Artikels zurück. Angenommen Sie wollen
+ nun links im Fuß zusätzlich den Verlag angegeben haben. Daher ergänzen Sie
+ das Beispiel zu
+\begin{lstcode}
+ \documentclass{scrartcl}
+ \usepackage{scrlayer-scrpage}
+ \lohead{Peter Musterheinzel}
+ \rohead{Seitenstile mit \KOMAScript}
+ \lofoot{Verlag Naseblau, Irgendwo}
+ \pagestyle{scrheadings}
+ \usepackage{lipsum}
+ \begin{document}
+ \title{Seitenstile mit \KOMAScript}
+ \author{Peter Musterheinzel}
+ \maketitle
+ \lipsum
+ \end{document}
+\end{lstcode}
+ Der Verlag wird Ihnen nun aber wiederum nicht auf der Seite mit dem
+ Titelkopf ausgegeben. Die Begründung ist dieselbe wie beim Beispiel zu
+ \Macro{lohead}. Ebenso ist die Lösung, um den Verlag auch auf diese Seite
+ zu bekommen, entsprechend:
+\begin{lstcode}
+ \lofoot[Verlag Naseblau, Irgendwo]
+ {Verlag Naseblau, Irgendwo}
+\end{lstcode}
+ Nun entscheiden Sie noch, dass
+ statt\textnote{Fontänderung}\important{\FontElement{pageheadfoot}}%
+ \IndexFontElement{pageheadfoot} der schrägen Schrift in Kopf und Fuß eine
+ aufrechte, aber kleinere Schrift verwendet werden soll%
+ % Umbruchoptimierung:
+ \iffree{}{. Dies erreichen
+ Sie, indem Sie in der Dokumentpräambel die folgende Codezeile ergänzen}%
+ :
+\begin{lstcode}
+ \setkomafont{pageheadfoot}{\small}
+\end{lstcode}
+
+ Darüber hinaus, soll der
+ Kopf\important{\FontElement{pagehad}}\IndexFontElement{pagefoot}, nicht
+ jedoch der Fuß fett gesetzt werden:
+\begin{lstcode}
+ \setkomafont{pagehead}{\bfseries}
+\end{lstcode}
+ Bei dieser Anweisung ist es wichtig, dass sie erst nach dem Laden von
+ \Package{scrpage-scrlayer} erfolgt, weil davor zwar bereits sowohl
+ \FontElement{pagehead} als auch \FontElement{pageheadfoot} vorhanden sind,
+ aber dasselbe Element, nämlich \FontElement{pageheadfoot}, bezeichnen. Erst
+ durch Laden von \Package{scrpage-scrlayer} werden daraus zwei unabhängige
+ Elemente.
+
+ Ergänzen Sie nun das Beispiel einmal durch ein weiteres \Macro{lipsum} und
+ fügen Sie gleichzeitig Option
+ \Option{twoside}\IndexOption{twoside}\important{\Option{twoside}} beim Laden
+ von \Class{scrartcl} hinzu. Zum einen wandert die Seitenzahl im Fuß nun von
+ der Mitte nach außen. Das liegt an der geänderten Voreinstellung für
+ \Pagestyle{scrheadings} und \Pagestyle{plain.scrheadings} für doppelseitige
+ Dokumente mit einer \KOMAScript-Klasse.
+
+ Gleichzeitig verschwinden aber auch Autor, Dokumenttitel und Verlag von
+ Seite~2. Diese finden sich erst auf Seite~3 wieder. Das liegt daran, dass
+ wir bisher nur Befehle für ungerade Seiten\textnote{rechte Seite}
+ verwendet haben. Zu erkennen ist das am »\texttt{o}« für \emph{odd} an der
+ zweiten Stelle der Befehlsnamen.
+
+ Nun könnten wir die Befehle einfach kopieren und in der Kopie dieses
+ »\texttt{o}« durch ein »\texttt{e}« für \emph{even}\textnote{linke Seite}
+ ersetzen. Allerdings ist es bei doppelseitigen Dokumenten meist sinnvoller,
+ wenn die Elemente spiegelverkehrt verwendet werden, dass also Elemente, die
+ auf linken Seiten links stehen, auf rechten Seiten rechts platziert werden
+ und umgekehrt. Daher vertauschen wir auch noch beim ersten Buchstaben
+ »\texttt{l}« durch »\texttt{r}« und umgekehrt:
+\begin{lstcode}
+ \documentclass[twoside]{scrartcl}
+ \usepackage{scrlayer-scrpage}
+ \lohead{Peter Musterheinzel}
+ \rohead{Seitenstile mit \KOMAScript}
+ \lofoot[Verlag Naseblau, Irgendwo}
+ {Verlag Naseblau, Irgendwo}
+ \rehead{Peter Musterheinzel}
+ \lehead{Seitenstile mit \KOMAScript}
+ \refoot[Verlag Naseblau, Irgendwo]
+ {Verlag Naseblau, Irgendwo}
+ \pagestyle{scrheadings}
+ \setkomafont{pageheadfoot}{\small}
+ \setkomafont{pagehead}{\bfseries}
+ \usepackage{lipsum}
+ \begin{document}
+ \title{Seitenstile mit \KOMAScript}
+ \author{Peter Musterheinzel}
+ \maketitle
+ \lipsum\lipsum
+ \end{document}
+\end{lstcode}
+\end{Example}%
+\iffree{}{Der Code dieses Beispiels funktioniert ebenfalls mit dem veralteten
+ Paket
+ \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}. Wegen
+ der Verwendung von \Macro{setkomafont} gilt das aber nur, solange eine
+ \KOMAScript-Klasse wie \Class{scrartcl} verwendet wird.}%
+
+Da es etwas umständlich ist, die Angaben bei doppelseitigen Dokumenten wie im
+letzten Beispiel immer getrennt für linke und rechte Seiten zu machen, wird
+nachfolgend eine schönere Lösung für diesen Standardfall eingeführt.
+
+Erlauben Sie mir zuvor noch einen wichtigen Hinweis:\textnote{Achtung!} Sie
+sollten niemals die Überschrift oder die Nummer einer Gliederungsebene mit
+Hilfe einer dieser Anweisungen als Kolumnentitel in den Fuß der
+Seite setzen. Aufgrund der Asynchronizität von Seitenaufbau und Seitenausgabe
+kann es sonst leicht geschehen, dass die falsche Nummer oder die falsche
+Überschrift im Kolumnentitel ausgegeben wird. Stattdessen ist der
+Mark-Mechanismus idealer Weise in Verbindung mit den Automatismen, die im
+nächsten Abschnitt erklärt werden, zu verwenden.%
+%
+\EndIndex{Cmd}{rofoot}%
+\EndIndex{Cmd}{cofoot}%
+\EndIndex{Cmd}{lofoot}%
+\EndIndex{Cmd}{refoot}%
+\EndIndex{Cmd}{cefoot}%
+\EndIndex{Cmd}{lefoot}%
+
+
+\begin{Declaration}
+ \Macro{ohead}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}\\
+ \Macro{chead}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}\\
+ \Macro{ihead}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}\\
+ \Macro{ofoot}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}\\
+ \Macro{cfoot}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}\\
+ \Macro{ifoot}\OParameter{Inhalt plain.scrheadings}%
+ \Parameter{Inhalt scrheadings}
+\end{Declaration}
+\BeginIndex{Cmd}{ohead}%
+\BeginIndex{Cmd}{chead}%
+\BeginIndex{Cmd}{ihead}%
+\BeginIndex{Cmd}{ofoot}%
+\BeginIndex{Cmd}{cfoot}%
+\BeginIndex{Cmd}{ifoot}%
+Um Kopf und Fuß im doppelseitigen Layout zu konfigurieren, müsste man mit den
+zuvor erklärten Befehlen die linken und die rechten Seiten getrennt
+voneinander konfigurieren. Meist ist es jedoch so, dass linke und rechte Seite
+mehr oder weniger symmetrisch zueinander sind. Ein Element das auf linken
+Seiten links steht, steht auf rechten Seiten rechts. Ein Element, das auf
+linken Seiten rechts steht, steht auf rechten Seiten links. Mittig angeordnete
+Elemente sind normalerweise auf beiden Seiten mittig angeordnet.
+
+Zur Vereinfachung der Einstellungen für diesen Standardfall gibt es bei
+\Package{scrlayer-scrpage} sozusagen Abkürzungen. Der Befehl \Macro{ohead}
+entspricht einem Aufruf sowohl von \Macro{lehead} als auch \Macro{rohead}. Der
+Befehl \Macro{chead} entspricht sowohl \Macro{cehead} als auch
+\Macro{cohead}. Und Befehl \Macro{ihead} entspricht \Macro{rehead} und
+\Macro{lohead}. Entsprechendes gilt für die Anweisungen des Fußes. In
+\autoref{fig:scrlayer-scrpage.head} auf
+\autopageref{fig:scrlayer-scrpage.head} und
+\autoref{fig:scrlayer-scrpage.foot} auf
+\autopageref{fig:scrlayer-scrpage.foot} werden auch diese Beziehungen
+skizziert.
+%
+\begin{Example}
+ Mit Hilfe der neuen Befehle, lässt sich das letzte Beispiel wie folgt
+ vereinfachen:
+\begin{lstcode}
+ \documentclass[twoside]{scrartcl}
+ \usepackage{scrlayer-scrpage}
+ \ihead{Peter Musterheinzel}
+ \ohead{Seitenstile mit \KOMAScript}
+ \ifoot[Verlag Naseblau, Irgendwo]
+ {Verlag Naseblau, Irgendwo}
+ \pagestyle{scrheadings}
+ \setkomafont{pageheadfoot}{\small}
+ \setkomafont{pagehead}{\bfseries}
+ \usepackage{lipsum}
+ \begin{document}
+ \title{Seitenstile mit \KOMAScript}
+ \author{Peter Musterheinzel}
+ \maketitle
+ \lipsum\lipsum
+ \end{document}
+\end{lstcode}
+ Wie zusehen ist, konnte die Hälfte der Befehle eingespart und trotzdem
+ dasselbe Ergebnis erzielt werden.
+\end{Example}%
+\iffree{}{Der Code dieses Beispiels funktioniert wiederum ohne Änderung auch
+ mit dem veralteten Paket
+ \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}},
+ solange eine \KOMAScript-Klasse wie \Class{scrartcl} verwendet wird.}%
+
+Da im einseitigen Layout alle Seiten als ungerade oder rechte Seiten behandelt
+werden, können im einseitigen Layout diese Befehle auch als Synonyme für die
+entsprechenden Befehle für rechte Seiten verwendet werden. In den meisten
+Fällen wird man daher eher diese sechs als die zwölf zuvor vorgestellten
+Befehle verwenden.
+
+Erlauben Sie mir noch einmal einen wichtigen Hinweis:\textnote{Achtung!} Sie
+sollten niemals die Überschrift oder die Nummer einer Gliederungsebene mit
+Hilfe einer dieser Anweisungen als Kolumnentitel in den Kopf oder Fuß der
+Seite setzen. Aufgrund der Asynchronizität von Seitenaufbau und Seitenausgabe
+kann es sonst leicht geschehen, dass die falsche Nummer oder die falsche
+Überschrift im Kolumnentitel ausgegeben wird. Stattdessen ist der
+Mark-Mechanismus idealer Weise in Verbindung mit den Automatismen, die im
+nächsten Abschnitt erklärt werden, zu verwenden.%
+\EndIndex{Cmd}{ifoot}%
+\EndIndex{Cmd}{cfoot}%
+\EndIndex{Cmd}{ofoot}%
+\EndIndex{Cmd}{ihead}%
+\EndIndex{Cmd}{chead}%
+\EndIndex{Cmd}{ohead}%
+
+\begin{Declaration}
+ \KOption{pagestyleset}\PName{Einstellung}
+\end{Declaration}
+\BeginIndex{Option}{pagestyleset~=KOMA-Script}%
+\BeginIndex{Option}{pagestyleset~=standard}%
+In den zurückliegenden Beispielen wurde bereits mehrfach auf die
+Voreinstellung der Seitenstile
+\Pagestyle{scrheadings}\IndexPagestyle{scrheadings} und
+\Pagestyle{plain.scrheadings}\IndexPagestyle{plain.scrheadings}
+hingewiesen. Tatsächlich unterstützt \Package{scrlayer-scrpage} derzeit zwei
+unterschiedliche Voreinstellungen. Diese sind von Hand über Option
+\Option{pagestyleset} auswählbar.
+
+Mit der \PName{Einstellung} \PValue{KOMA-Script}%
+\important{\KOption{pagestyleset}\quad\\\quad\PValue{KOMA-Script}}
+wird die Voreinstellung gewählt, die auch automatisch eingestellt wird, falls
+die Option nicht angegeben ist und eine \KOMAScript-Klasse erkannt
+wurde. Dabei werden für \Pagestyle{scrheadings} im doppelseitigen Satz
+Kolumnentitel außen im Kopf und Seitenzahlen außen im Fuß gesetzt. Im
+einseitigen Satz wird der Kolumnentitel stattdessen mittig im Kopf und die
+Seitenzahl mittig im Fuß platziert. Für die automatischen Kolumnentitel werden
+Groß- und Kleinbuchstaben verwendet, wie diese vorgefunden werden. Dies
+entspricht der gleichzeitigen Verwendung von Option
+\OptionValue{markcase}{used}\IndexOption{markcase~=used}%
+\important{\OptionValue{markcase}{used}}. Für \Pagestyle{plain.scrheadings}
+entfallen die Kolumnentitel. Die Seitenzahlen werden jedoch identisch
+platziert.
+
+Wird allerdings
+\Class{scrlttr2}\important{\Class{scrlttr2}}\IndexClass{scrlttr2} als Klasse
+erkannt, so werden die Voreinstellungen an die Seitenstile jener Klasse
+angelehnt. Siehe dazu \autoref{sec:scrlttr2.pagestyle}, ab
+\autopageref{sec:scrlttr2.pagestyle}.
+
+Mit der \PName{Einstellung} \PValue{standard}%
+\important{\KOption{pagestyleset}\quad\\\quad\PValue{standard}} wird die
+Voreinstellung gewählt, die den Standard-Klassen entspricht. Diese wird auch
+automatisch eingestellt, falls die Option nicht angegeben ist und keine
+\KOMAScript-Klasse erkannt wurde. Dabei wird für \Pagestyle{scrheadings} im
+doppelseitigen Satz der Kolumnentitel im Kopf innen und die Seitenzahl --
+ebenfalls im Kopf -- außen ausgerichtet platziert. Im einseitigen Satz werden
+dieselben Einstellungen verwendet. Da hierbei nur rechte Seiten existieren,
+steht der Kolumnentitel dann immer linksbündig im Kopf, die Seitenzahl
+entsprechend rechtsbündig. Die automatischen Kolumnentitel werden -- trotz
+erheblicher typografischer Bedenken -- entsprechend
+\OptionValue{markcase}{upper}\IndexOption{markcase~=upper}%
+\important{\OptionValue{markcase}{upper}} in Großbuchstaben
+umgewandelt. Von \Pagestyle{scrheadings} deutlich abweichend hat
+\Pagestyle{plain.scrheadings} die Seitenzahl im einseitigen Satz mittig im
+Fuß. Abweichend vom Seitenstil \Pagestyle{plain} der Standardklassen entfällt
+die Seitenzahl im doppelseitigen Modus. Die Standardklassen setzen die
+Seitenzahl stattdessen mittig im Fuß, was im doppelseitigen Satz nicht zum
+übrigen Stil der Seiten passt. Der Kolumnentitel entfällt beim
+\Pagestyle{plain.scrheadings} natürlich in jedem Fall.
+
+Es ist zu beachten\textnote{Achtung!}, dass mit der Verwendung dieser Option
+gleichzeitig der Seitenstil
+\Pagestyle{scrheadings}\IndexPagestyle{scrheadings}%
+\important{\Pagestyle{scrheadings}} aktiviert wird. Dies gilt auch, wenn die
+Option innerhalb eines Dokuments verwendet wird.
+
+\BeginIndex{Option}{komastyle}%
+\BeginIndex{Option}{standardstyle}%
+Die für \Package{scrpage2}\IndexPackage{scrpage2} dokumentierten Paketoptionen
+\Option{komastyle}\important{\Option{komastyle}\\ \Option{standardstyle}} und
+\Option{standardstyle} existieren in \Package{scrlayer-scrpage} nur aus
+Gründen der Kompatibilität. Sie werden jedoch auf Option \Option{pagestyleset}
+abgebildet, gelten als überholt und sollten nicht mehr verwendet
+werden.\iffree{}{ Bei Verwendung des veralteten Pakets
+ \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}} sind
+ sie hingegen die einzige Möglichkeit zwischen den beiden unterschiedlichen
+ Voreinstellungen umzuschalten, da dort Option \Option{pagestyleset} nicht
+ existiert.}%
+\EndIndex{Option}{standardstyle}%
+\EndIndex{Option}{komastyle}%
+\EndIndex{Option}{pagestyleset~=standard}%
+\EndIndex{Option}{pagestyleset~=KOMA-Script}%
+
+\LoadCommon[scrlayerscrpage]{21} % \section{Beeinflussung von definierten Seitenstilen}
+
+\begin{Declaration}
+ \KOption{headwidth}\PName{Breite\textup{:}Offset}\\
+ \KOption{footwidth}\PName{Breite\textup{:}Offset}
+\end{Declaration}
+\BeginIndex{Option}{headwidth~=\PName{Offset\textup{:}Breite}}%
+\BeginIndex{Option}{footwidth~=\PName{Offset\textup{:}Breite}}%
+In der Voreinstellung sind Kopf\Index{Kopf>Breite} und Fuß\Index{Fuß>Breite}
+genauso breit wie der Satzspiegel. Mit Hilfe dieser beiden
+\KOMAScript-Optionen lässt sich das jedoch ändern. Die \PName{Breite} ist
+dabei die gewünschte Breite des Kopfes beziehungsweise Fußes. Der
+\PName{Offset} gibt an, wie weit der Kopf respektive Fuß in Richtung des
+äußeren Randes -- im einseitigen Satz entsprechend in Richtung des rechten
+Randes -- verschoben werden soll. Dabei sind beide Werte optional, können also
+auch weggelassen werden. Falls beide Werte weggelassen werden, kann auch der
+Doppelpunkt entfallen. Ist nur ein Wert aber kein Doppelpunkt angegeben, so
+handelt es sich um die \PName{Breite}.
+
+Sowohl für \PName{Breite} als auch für \PName{Offset} kann jeder gültige
+Längenwert aber auch jede \LaTeX-Länge oder \TeX-Länge oder \TeX-Abstand
+eingesetzt werden. Darüber hinaus sind für beides auch \eTeX-Längen\-ausdrücke
+mit den Grundrechenarten \texttt{+}, \texttt{-}, \texttt{*}, \texttt{/} und
+runden Klammern erlaubt. Näheres zu solchen Längenausdrücken ist
+\cite[Abschnitt~3.5]{manual:eTeX} zu entnehmen. Für \PName{Breite} sind
+außerdem einige symbolische Werte zulässig. Diese sind
+\autoref{tab:scrlayer-scrpage.symbolic.values} zu entnehmen.
+
+Die Voreinstellung für \PName{Breite} ist die Breite des Textbereichs. Die
+Voreinstellung für \PName{Offset} hängt von der gewählten \PName{Breite}
+ab. In der Regel wird im einseitigen Satz die Hälfte des Unterschieds zwischen
+\PName{Breite} und der Breite des Textbereichs verwendet. Damit wird der Kopf
+über dem Textbereich zentriert. Im doppelseitigen Satz wird hingegen nur ein
+Drittel des Unterschieds zwischen \PName{Breite} und der Breite des
+Textbereichs verwendet. Ist \PName{Breite} jedoch die Breite des Textbereichs
+zuzüglich der Marginalienspalte, so ist die Voreinstellung von \PName{Offset}
+immer Null. Falls Ihnen das zu kompliziert ist, sollten Sie den gewünschten
+\PName{Offset} einfach selbst angeben.%
+%
+\begin{table}
+ \centering
+ \caption[Symbolische Werte für Option \Option{headwidth} und
+ \Option{footwidth}]{Erlaubte symbolische Werte für \PName{Breite} bei den
+ Optionen \Option{headwidth} und \Option{footwidth}}
+ \label{tab:scrlayer-scrpage.symbolic.values}
+ \begin{desctabular}
+ \ventry{foot}{%
+ die aktuelle Breite des Fußes%
+ }%
+ \ventry{footbotline}{%
+ die aktuelle Länge der horizontalen Linie unterhalb des Fußes%
+ }%
+ \ventry{footsepline}{ die aktuelle Länge der horizontalen Linie zwischen
+ dem Textbereich und dem Fuß%
+ } \ventry{head}{%
+ die aktuelle Breite des Kopfes%
+ }%
+ \ventry{headsepline}{%
+ die aktuelle Länge der horizontalen Linie zwischen dem Kopf und dem
+ Textbereich%
+ }%
+ \ventry{headtopline}{%
+ die aktuelle Länge der horizontalen Linie über dem Kopf%
+ }%
+ \ventry{marginpar}{%
+ die Breite der Marginalienspalte einschließlich des Abstandes zwischen
+ dem Textbereich und der Marginalienspalte%
+ }%
+ \ventry{page}{%
+ die Breite der Seite unter Berücksichtigung einer eventuell mit Hilfe
+ des Pakets \Package{typearea} definierten Bindekorrektur (siehe Option
+ \Option{BCOR} in \autoref{sec:typearea.typearea},
+ \autopageref{desc:typearea.option.BCOR})%
+ }%
+ \ventry{paper}{%
+ die Breite des Papiers ohne Berücksichtigung einer etwaigen
+ Bindekorrektur%
+ }%
+ \ventry{text}{%
+ die Breite des Textbereichs%
+ }%
+ \ventry{textwithmarginpar}{%
+ die Breite des Textbereichs einschließlich der Marginalienspalte und
+ natürlich des Abstandes zwischen den beiden (Achtung: Nur in diesem Fall
+ ist die Voreinstellung für \PName{Offset} Null)%
+ }%
+ \end{desctabular}
+\end{table}
+%
+\EndIndex{Option}{footwidth~=\PName{Offset\textup{:}Breite}}%
+\EndIndex{Option}{headwidth~=\PName{Offset\textup{:}Breite}}%
+
+\begin{Declaration}
+ \KOption{headtopline}\PName{Dicke\textup{:}Länge}\\
+ \KOption{headsepline}\PName{Dicke\textup{:}Länge}\\
+ \KOption{footsepline}\PName{Dicke\textup{:}Länge}\\
+ \KOption{footbotline}\PName{Dicke\textup{:}Länge}
+\end{Declaration}
+\BeginIndex{Option}{headtopline~=\PName{Dicke\textup{:}Länge}}%
+\BeginIndex{Option}{headsepline~=\PName{Dicke\textup{:}Länge}}%
+\BeginIndex{Option}{footsepline~=\PName{Dicke\textup{:}Länge}}%
+\BeginIndex{Option}{footbotline~=\PName{Dicke\textup{:}Länge}}%
+Während die \KOMAScript-Klassen nur eine Trennlinie unter dem Kopf und eine
+weitere über dem Fuß unterstützen und man diese nur wahlweise ein- und
+ausschalten kann, erlaubt das Paket \Package{scrlayer-scrpage} auch noch eine
+Linie über dem Kopf und unter dem Fuß, und man kann bei diesen beiden sowohl
+die \PName{Länge} als auch die \PName{Dicke} konfigurieren.
+
+Beide Werte sind optional. Lässt man die \PName{Dicke} weg, so wird
+0,4\Unit{pt} angenommen, also eine Haarlinie produziert. Verzichtet man auf
+eine Angabe der \PName{Länge}, so wird die Breite des Kopfes respektive des
+Fußes als gewünschter Wert angenommen. Wird beides weggelassen, so kann auch
+der Doppelpunkt entfallen. Wird nur ein Wert ohne Doppelpunkt angegeben, so
+ist dies die \PName{Dicke}.
+
+Natürlich darf die \PName{Länge} nicht nur kürzer als die aktuelle Breite des
+Kopfes respektive des Fußes sein. Sie darf auch länger sein. Siehe dazu auch
+die Optionen \Option{ilines}\IndexOption{ilines}\important{\Option{ilines},
+ \Option{clines}, \Option{olines}}, \Option{clines}\IndexOption{clines} und
+\Option{olines}\IndexOption{olines}, die später in diesem Abschnitt erklärt
+werden.
+
+\BeginIndex{FontElement}{headtopline}%
+\BeginIndex{FontElement}{headsepline}%
+\BeginIndex{FontElement}{footsepline}%
+\BeginIndex{FontElement}{footbotline}%
+Neben der Dicke und der Länge kann man auch die Farben der Linien
+ändern. Zunächst richtet sich diese natürlich nach der Farbe, die für den Kopf
+und den Fuß eingestellt ist. Davon unabhängig werden aber auch noch die
+Einstellungen für die gleich benannten Elemente
+\FontElement{headtopline}\important[i]{\FontElement{headtopline}\\
+\FontElement{headsepline}\\
+\FontElement{footsepline}\\
+\FontElement{footbotline}},
+\FontElement{headsepline}, \FontElement{footsepline} und
+\FontElement{footbotline} angewendet. Diese können mit den Anweisungen
+\Macro{setkomafont} und \Macro{addtokomafont} geändert werden (siehe
+\autoref{sec:maincls.textmarkup}, ab
+\autopageref{desc:maincls.cmd.setkomafont}). In der Voreinstellung sind die
+Einstellungen für diese Elemente leer, so dass sie zu keiner Änderung der
+Schrift oder Farbe führen. Änderungen der Schrift sind im Gegensatz zu
+Farbänderungen an dieser Stelle ohnehin nicht sinnvoll und werden daher nicht
+empfohlen.%
+\EndIndex{FontElement}{footbotline}%
+\EndIndex{FontElement}{footsepline}%
+\EndIndex{FontElement}{headsepline}%
+\EndIndex{FontElement}{headtopline}%
+
+\BeginIndex{Cmd}{setheadtopline}%
+\BeginIndex{Cmd}{setheadseoline}%
+\BeginIndex{Cmd}{setfootsepline}%
+\BeginIndex{Cmd}{setfootbotline}%
+\iffree{Neben den Optionen }{Das veraltete Paket
+ \Package{scrpage2}\important{\Package{scrpage2}}\IndexPackage{scrpage2}
+ kannte gleich benannte Paketoptionen, denen jedoch kein Wert zugewiesen
+ werden konnte. Man aktivierte Haarlinien in der Breite des Kopfes respektive
+ Fußes. Daneben }%
+gab es bei \Package{scrpage2} auch noch die nahezu
+gleichbedeutenden Befehle
+\Macro{setheadtopline}\IndexCmd[indexmain]{setheadtopline}%
+\important[i]{\Macro{setheadtopline}\\
+ \Macro{setheadsepline}\\
+ \Macro{setfootsepline}\\
+ \Macro{setfootbotline}},
+\Macro{setheadsepline}\IndexCmd[indexmain]{setheadsepline},
+\Macro{setfootsepline}\IndexCmd[indexmain]{setfootsepline} und
+\Macro{setfootbotline}\IndexCmd[indexmain]{setfootbotline}. Diese Befehle
+hatten als erstes, optionales Argument ebenfalls die \PName{Länge} der
+entsprechende Linie, als zweites, obligatorisches Argument die \PName{Dicke}
+und als zusätzliches drittes, optionales Argument Einstellungen, die direkt
+für die Schrift oder Farbe des entsprechenden Elements verwendet wurden. Diese
+Anweisungen existieren in \Package{scrlayer-scrpage} aus
+Kompatibilitätsgründen ebenfalls, wobei die ersten beiden Argumente
+entsprechend der Werte für die Optionen erweitert wurden. Allerdings sind die
+Befehle gleichzeitig als überholt anzusehen und sollten nicht mehr verwendet
+werden. Es sei an dieser Stelle auch darauf hingewiesen, dass diese Befehle
+nie dazu gedacht waren, die entsprechenden Linien einzuschalten. Vielmehr
+waren sie ausschließlich zur Einstellung von \PName{Länge} und \PName{Dicke}
+der Linien gedacht, wenn diese über die Optionen eingeschaltet wurden. Dies
+wurde von den Anwendern aber leider häufig nicht beachtet!%
+\EndIndex{Cmd}{setfootbotline}%
+\EndIndex{Cmd}{setfootsepline}%
+\EndIndex{Cmd}{setheadseoline}%
+\EndIndex{Cmd}{setheadtopline}%
+%
+\EndIndex{Option}{footbotline~=\PName{Dicke\textup{:}Länge}}%
+\EndIndex{Option}{footsepline~=\PName{Dicke\textup{:}Länge}}%
+\EndIndex{Option}{headsepline~=\PName{Dicke\textup{:}Länge}}%
+\EndIndex{Option}{headtopline~=\PName{Dicke\textup{:}Länge}}%
+
+
+\begin{Declaration}
+ \KOption{plainheadtopline}\PName{Ein-Aus-Wert}\\
+ \KOption{plainheadsepline}\PName{Ein-Aus-Wert}\\
+ \KOption{plainfootsepline}\PName{Ein-Aus-Wert}\\
+ \KOption{plainfootbotline}\PName{Ein-Aus-Wert}
+\end{Declaration}
+\BeginIndex{Option}{plainheadtopline~=\PName{Ein-Aus-Wert}}%
+\BeginIndex{Option}{plainheadsepline~=\PName{Ein-Aus-Wert}}%
+\BeginIndex{Option}{plainfootsepline~=\PName{Ein-Aus-Wert}}%
+\BeginIndex{Option}{plainfootbotline~=\PName{Ein-Aus-Wert}}%
+Mit diesen Optionen können die Einstellungen für die Linien auch für den
+\Pagestyle{plain}-Seitenstil übernommen werden. Als \PName{Ein-Aus-Wert}
+stehen die Standardwerte für einfache Schalter, die in
+\autoref{tab:truefalseswitch} auf \autopageref{tab:truefalseswitch} angegeben
+sind, zur Verfügung. Bei aktivierter Option werden die entsprechenden
+Linieneinstellungen übernommen. Bei deaktivierter Option wird die
+entsprechende Linie im \Pagestyle{plain}-Seitenstil hingegen nicht angezeigt.
+%
+\EndIndex{Option}{plainfootbotline~=\PName{Ein-Aus-Wert}}%
+\EndIndex{Option}{plainfootsepline~=\PName{Ein-Aus-Wert}}%
+\EndIndex{Option}{plainheadsepline~=\PName{Ein-Aus-Wert}}%
+\EndIndex{Option}{plainheadtopline~=\PName{Ein-Aus-Wert}}%
+
+
+\begin{Declaration}
+ \Option{ilines}\\
+ \Option{clines}\\
+ \Option{olines}
+\end{Declaration}
+\BeginIndex{Option}{ilines}%
+\BeginIndex{Option}{clines}%
+\BeginIndex{Option}{olines}%
+Wie bereits zuvor erklärt wurde, können Trennlinien für den Kopf oder Fuß
+konfiguriert werden, die länger oder kürzer als die Breite des Kopfes
+beziehungsweise des Fußes sind. Bisher blieb die Frage offen, wie diese Linien
+dann ausgerichtet werden. In der Voreinstellung sind sie im einseitigen Satz
+linksbündig und im doppelseitigen Satz bündig mit dem Anfang des inneren
+Randes. Dies entspricht Option \Option{ilines}. Alternativ können sie jedoch
+mit Option \Option{clines} auch horizontal bezüglich der Breite des Kopfes
+beziehungsweise Fußes zentriert werden. Ebenso ist mit Hilfe von Option
+\Option{olines} eine Ausrichtung am äußeren beziehungsweise rechten Rand
+möglich.%
+\EndIndex{Option}{olines}%
+\EndIndex{Option}{clines}%
+\EndIndex{Option}{ilines}%
+%
+\EndIndex{Package}{scrlayer-scrpage}%
+
+%%% Local Variables:
+%%% mode: latex
+%%% mode: flyspell
+%%% coding: iso-latin-1
+%%% ispell-local-dictionary: "de_DE"
+%%% TeX-master: "../guide"
+%%% End:
+
+% LocalWords: Paketoptionen
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex
new file mode 100644
index 00000000000..2bf8540ab0c
--- /dev/null
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex
@@ -0,0 +1,1436 @@
+% ======================================================================
+% scrlayer.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ----------------------------------------------------------------------
+% scrlayer.tex
+% Copyright (c) Markus Kohm, 2013
+%
+% 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.
+% ======================================================================
+%
+% Chapter about scrlayer of the KOMA-Script guide
+% Maintained by Markus Kohm
+%
+% ----------------------------------------------------------------------
+%
+% Kapitel über scrlayer in der KOMA-Script-Anleitung
+% Verwaltet von Markus Kohm
+%
+% ============================================================================
+
+\KOMAProvidesFile{scrlayer.tex}
+ [$Date: 2013-12-10 19:50:34 +0100 (Di, 10. Dez 2013) $
+ KOMA-Script guide (chapter:scrlayer)]
+
+\chapter[{Definition von Ebenen und Seitenstilen mit \Package{scrlayer}}]
+ {Definition\ChangedAt{v3.12}{\Package{scrlayer}} von Ebenen und Seitenstilen
+ mit \Package{scrlayer}}
+\labelbase{scrlayer}
+
+\BeginIndex{Package}{scrlayer}
+
+Anwender von Grafikprogrammen sind mit dem Modell der Ebenen für eine Seite
+bereits vertraut. \LaTeX{} selbst ist ein solches Modell jedoch eher
+fremd. Dennoch gibt es bereits einige Pakete wie \Package{eso-pic} oder
+\Package{textpos}, mit denen bereits eine Art Hintergrund- oder
+Vor\-der\-grund\-ebe\-ne in \LaTeX{} verfügbar gemacht wurden. Das Paket
+\Package{scrlayer} ist ein weiteres Paket, das solche Hintergrund- und
+Vordergrundebenen zur Verfügung stellt. Im Unterschied zu den anderen
+genannten Paketen sind die Ebenen bei \Package{scrlayer} jedoch Teil des
+Seitenstils. Dadurch ist eine einfache Umschaltung zwischen der Verwendung
+unterschiedlicher Ebenen durch die Umschaltung des Seitenstils möglich.
+
+Um dies zu erreichen, stellt das Paket auf unterer Stufe zusätzlich eine
+Schnittstelle zur Definition von Seitenstilen, die auf einem Stapel oder einer
+Liste von Ebenen beruhen, zum Hinzufügen von Ebenen wahlweise am Anfang oder
+Ende einer solchen Liste von Ebenen oder unmittelbar vor oder hinter einer
+anderen Ebene in einer solchen Liste, zum Löschen einer Ebene aus einer
+solchen Liste und zum Löschen aller Dubletten einer Ebene aus einer solchen
+Liste bereit. Oder kurz und verständlich gesagt: Die Seitenstil-Schnittstelle
+von \Package{scrlayer} stellt Befehle bereit, um einen Seitenstil, der auf
+einer Liste von Ebenen basiert, zu definieren und diese Ebenenliste zu
+verwalten.
+
+Nichtsdestoweniger wird die direkte Verwendung der Ebenen nur erfahrenen
+Anwendern empfohlen. Schnittstellen für Anfänger und durchschnittliche
+Anwender werden als zusätzliche Pakete angeboten, die dann ihrerseits
+\Package{scrlayer} laden. Siehe hierzu \autoref{cha:scrlayer-scrpage} in
+\autoref{part:forAuthors} diese\iffree{r Anleitung}{s Buches}.
+
+
+\section{Hinweis zum Entwicklungsstand}
+\label{sec:scrlayer.draft}
+
+Die Entwicklung dieses Pakets ist noch nicht abgeschlossen. Teile des Pakets
+sind auch noch als experimentell einzustufen. Daher können sich in Zukunft
+insbesondere die internen Funktionalitäten und Funktionsweisen noch ändern. Es
+ist auch noch mit Erweiterungen zu rechnen. Wegen dieses noch nicht
+abgeschlossenen Entwicklungsstandes sollte der Leser auch keine abgeschlossene
+Anleitung erwarten. Dennoch gibt diese Anleitung, die sich vor allem an
+erfahrene Anwender und Entwickler richtet, den aktuellen Entwicklungsstand der
+Teile von \Package{scrlayer} wieder, die als zur Verwendung freigegeben
+eingestuft sind. Dinge, die hier nicht dokumentiert sind, sollten allenfalls
+zu Testzwecken Verwendung finden.
+
+\LoadCommon{0} % \section{Frühe oder späte Optionenwahl}
+
+\section{Einige grundlegende Informationen}
+\label{sec:scrlayer.generic.information}
+
+Das Paket benötigt einige grundlegende Informationen über die
+verwendete Klasse. Autoren von Klassen können \Package{scrlayer} helfen, indem
+sie entsprechende Angaben machen. Anderenfalls versucht das Paket diese
+Informationen selbst zu ermitteln. Das funktioniert beispielsweise für die
+Standardklassen oder für die \KOMAScript-Klassen. Mit anderen Klassen kann es
+funktionieren oder auch ganz oder teilweise fehlschlagen.
+
+Dieser Abschnitt beschreibt einige der Informationen, die Autoren von Klassen
+bereitstellen können. Anwender sollten sich im Normalfall nicht darum zu
+kümmern brauchen.
+
+\begin{Declaration}
+ \Macro{if@chapter}\ \PName{Dann-Code} \Macro{else}\ \PName{Sonst-Code}
+ \Macro{fi}
+\end{Declaration}
+\BeginIndex{Cmd}{if@chapter}%
+Wenn \Macro{if@chapter} definiert ist und \Macro{iftrue}\IndexCmd{iftrue}
+entspricht, wird \Package{scrlayer} bei seiner Arbeit die Kapitel-Ebene
+beispielsweise bei Option \Option{automark} mit berücksichtigen. Wenn es
+definiert ist, aber nicht \Macro{iftrue} entspricht, behandelt
+\Package{scrlayer} nur die Ebenen der Befehle \Macro{part}, \Macro{section},
+\Macro{subsection}, \Macro{sub\dots subsection}, \Macro{paragraph},
+\Macro{subparagraph}, \Macro{sub\dots subparagraph}. Wenn das Makro nicht
+definiert ist, macht \Package{scrlayer} die Frage, ob auch die
+Kapitel-Ebene zu behandeln ist, an der Anweisung \Macro{chapter} fest. Ist
+diese Anweisung definiert und entspricht sie nicht \Macro{relax}, dann
+definiert \Package{scrlayer} das Makro \Macro{if@chapter} selbst als Synonym für
+\Macro{iftrue}. Anderenfalls definiert es \Macro{if@chapter} als Synonym für
+\Macro{iffalse}\IndexCmd{iffalse}.%
+%
+\EndIndex{Cmd}{if@chapter}%
+
+\begin{Declaration}
+ \Macro{if@mainmatter}\ \PName{Dann-Code} \Macro{else}\ \PName{Sonst-Code}
+ \Macro{fi}
+\end{Declaration}
+\BeginIndex{Cmd}{if@mainmatter}%
+Klassen wie \Class{book} definieren \Macro{frontmatter}\IndexCmd{frontmatter},
+\Macro{mainmatter}\IndexCmd{mainmatter} und
+\Macro{backmatter}\IndexCmd{backmatter}, um zwischen Vorderteil, Hauptteil und
+Endteil eines Buches umschalten zu können. In der Regel verwenden diese Klassen
+intern \Macro{if@mainmatter}, um entscheiden zu können, ob gerade im Hauptteil
+des Dokuments gearbeitet wird oder nicht. Klassen wie \Class{report} oder
+\Class{article} haben kein \Macro{frontmatter}, \Macro{mainmatter} oder
+\Macro{backmatter} und deshalb auch kein \Macro{if@mainmatter}. Stattdessen
+gehen sie davon aus, dass es nur einen Hauptteil gibt.
+
+Für \Package{scrlayer} ist es aber einfacher, nicht ständig erneut die
+Existenz und Verwendung der Umschaltanweisungen zu erkennen und damit zu
+entscheiden, ob nun gerade im Hauptteil gearbeitet wird oder nicht, sondern
+stattdessen auch bei Klassen wie \Class{report} oder \Class{article} mit
+\Macro{if@mainmatter} zu arbeiten. Das sollte bei den genannten Klassen dann
+schlicht \Macro{iftrue}\IndexCmd{iftrue} entsprechen. Wenn also
+\Macro{if@mainmatter} nicht definiert ist, dann definiert \Package{scrlayer}
+es als Synonym für \Macro{iftrue}.
+
+Einige Klassen haben jedoch tatsächlich \Macro{frontmatter},
+\Macro{mainmatter} oder \Macro{backmatter} und trotzdem kein
+\Macro{if@mainmatter}. In diesem Fall definiert \Package{scrlayer} ebenfalls
+\Macro{if@mainmatter} als Synonym für \Macro{iftrue} und erweitert
+die gefundenen Definitionen von \Macro{frontmatter}, \Macro{mainmatter} und
+\Macro{backmatter} so, dass diese \Macro{if@mainmatter} passend
+umdefinieren. Falls es jedoch weitere, vergleichbare Befehle zur Umschaltung
+zwischen unterschiedlichen Dokumentteilen gibt, so kennt \Package{scrlayer}
+diese nicht, testet nicht auf diese und erweitert sie daher auch nicht
+passend. In diesem Fall ist \Package{scrlayer} also auf die Mitarbeit des
+Klassenautors angewiesen.%
+\EndIndex{Cmd}{if@mainmatter}%
+
+\begin{Declaration}
+ \Macro{DeclareSectionNumberDepth}%
+ \Parameter{Name der Gliederungsebene}\Parameter{Tiefe der Gliederungsebene}
+\end{Declaration}
+\BeginIndex{Cmd}{DeclareSectionNumberDepth}%
+Jeder Gliederungsebene ist normalerweise eine nummerische Tiefe
+zugeordnet. Das ist notwendig, damit \LaTeX{} die Hierarchie der
+Gliederungsebenen verwalten kann. Allerdings sind die Werte normalerweise nur
+der jeweiligen Klasse bekannt, in der die Gliederungsbefehle definiert
+sind. Diese setzt dann in den entsprechenden \LaTeX-Befehlen selbst die
+zugehörigen Nummern ein.
+
+Das Paket \Package{scrlayer} benötigt ebenfalls Informationen über die
+Hierarchie. Mit Hilfe der Anweisung \Macro{DeclareSectionNumberDepth} kann
+\Package{scrlayer} zum Namen einer Gliederungsebene die zugehörige nummerische
+Tiefe bekannt gemacht werden. Für die Standardklassen wäre \Parameter{Name der
+ Gliederungsebene} beispielsweise \PValue{part}, \PValue{chapter},
+\PValue{section}, \PValue{subsection}, \PValue{subsubsection},
+\PValue{paragraph} oder \PValue{subparagraph} und die jeweils zugehörige
+\PName{Tiefe der Gliederungsebene} wäre -1, 0, 1, 2, 3, 4 oder 5.
+
+Das Paket \Package{scrlayer} versucht diese nummerischen Werte zunächst beim
+Laden des Pakets und dann noch einmal während
+\Macro{begin}\PParameter{document} selbst zu ermitteln. Aber für den Fall,
+dass dies einmal nicht zu einem korrekten Ergebnis führt, beispielsweise falls
+es vollkommen andere Gliederungsbefehle gibt, kann man die Zuordnung eben mit
+\Macro{DeclareSectionNumberDepth} auch explizit vornehmen.%
+%
+\EndIndex{Cmd}{DeclareSectionNumberDepth}%
+
+\section{Deklaration von Ebenen}
+\label{sec:scrlayer.layers}
+
+Eine Ebene (engl. \emph{layer}) ist ein Denkmodell für eine Seite. Im
+Gegensatz zu echtem, physischem Papier, ist diese Seite vollständig
+transparent. Üblicherweise werden mehrere Ebenen übereinander gestapelt und
+undurchsichtiges Material auf einer Ebene überdeckt Material auf den Ebenen
+darunter. Ein solcher Stapel von Ebenen wird dann auf eine reale Seite Papier
+abgebildet. Das Paket \Package{scrlayer} stellt zwei solche Stapel für jede
+Seite zur Verfügung: einen Hintergrundstapel und einen Vordergrundstapel. Der
+Hintergrundstapel befindet sich unter oder hinter dem normalen Seiteninhalt,
+während der Vordergrundstapel über oder vor dem normalen Seiteninhalt
+ausgegeben wird. Der normale Seiteninhalt ist daher eine Art von Trennebene
+zwischen den beiden Ebenenstapeln.
+
+Eine Ebene hat mehrere Eigenschaften. Die erste Eigenschaft ist Antwort auf
+die Frage, ob die Ebene zum Hintergrund oder zum Vordergrund
+gehört. Hintergrundebenen werden ausgegeben, bevor der normale Inhalt der
+Seite gedruckt wird. Optisch erscheinen sie daher \emph{hinter} oder
+\emph{unter} dem normalen Inhalt der Seite. Vordergrundebenen werden an den
+normalen Inhalt anschließend ausgegeben. Optisch erscheinen sie daher
+\emph{vor}, \emph{auf} oder \emph{über} dem normalen Inhalt der Seite. In der
+Voreinstellung ist eine Ebene sowohl eine Hintergrundebene als auch eine
+Vordergrundebene und wird daher zweimal ausgegeben.
+
+Die zweite und dritte Eigenschaft sind die horizontale und vertikale Position
+der Ebene. Die vierte und fünfte Eigenschaft sind die horizontale und
+vertikale Größe der Ebene. Daraus ergibt sich, dass eine Ebene auch kleiner
+oder größer als das Papier sein kann.
+
+Aber wie werden die horizontale und die vertikale Position gemessen? Aus der
+Antwort ergibt sich die sechste Eigenschaft, die Ausrichtung. Man kann von der
+linken Papierkante zur linken Kante der Ebene, zur Mitte der Ebene oder zur
+rechten Kante der Ebene messen. Entsprechend kann man von der oberen Kante des
+Papiers zur oberen Kante der Ebene, zur Mitte der Ebene oder zur unteren Kante
+der Ebene messen.
+
+Die siebte Eigenschaft ist, ob eine Ebene auf linken oder rechten Seiten eines
+Dokuments gedruckt werden soll. In der Voreinstellung wird eine Ebene auf
+allen Seiten gedruckt. Es ist zu beachten, dass \LaTeX{} Seiten mit geraden
+Seitenzahlen als linke Seiten und Seiten mit ungeraden Seitenzahlen als rechte
+Seiten behandelt, dass es jedoch im einseitigen Modus unabhängig von der
+Nummer nur rechte Seiten gibt. \LaTeX{} bezeichnet den Gepflogenheiten in der
+englischen Sprache entsprechend linke Seiten auch als gerade Seiten und rechte
+Seiten als ungerade Seiten.
+
+Die achte Eigenschaft ist, ob eine Ebene auf den einseitigen oder den
+doppelseitigen Modus beschränkt sein soll. In der Voreinstellung ist die Ebene
+diesbezüglich unbeschränkt, wird also sowohl im einseitigen als auch im
+doppelseitigen Modus ausgegeben. Nichtsdestotrotz wird eine Ebene, die auf
+gerade Seiten beschränkt ist, im einseitigen Modus niemals ausgegeben werden
+und ist daher auch keine einseitige Ebene.
+
+Die neunte Eigenschaft ist, ob eine Ebene auf Gleitseiten oder auf
+Normalseiten beschränkt ist. \LaTeX{} erzeugt Gleitseiten für Objekte aus
+Umgebungen wie \Environment{table} oder \Environment{figure}, wenn diesen
+erlaubt wurde, auf eigenen Seiten ohne Teile des normalen Dokumentinhalts
+ausgegeben zu werden (siehe Option \PValue{p} für \Environment{table} oder
+\Environment{figure}). In gewisser Weise ist es so der gesamten Seite erlaubt,
+im Dokument zu gleiten. Normalseiten in diesem Sinne sind alle Seiten, die
+keine Gleitseiten sind. Normalseiten können ebenfalls Gleitumgebungen am
+Anfang, im Inneren oder am Ende enthalten. Sehr große Gleitumgebungen können
+auch den Eindruck einer Gleitseite erzeugen, obwohl es sich bei ihnen in
+Wirklichkeit um oben auf einer Normalseite platzierte Gleitumgebungen handelt.
+
+Die zehnte und letzte Eigenschaft ist der Inhalt der Ebene. Das ist schlicht
+das, was gedruckt werden soll, wann immer die Ebene ausgegeben wird.
+
+Damit haben wir also zehn Eigenschaften. Später in dieser Anleitung werden wir
+weitere Eigenschaften sehen, die jedoch auf diese zehn Eigenschaften
+abgebildet werden können. Daher nennen wir diese zehn Eigenschaften die
+primären Eigenschaften.
+
+\begin{Declaration}
+ \Macro{DeclareLayer}\OParameter{Optionenliste}\Parameter{Name der Ebene}\\
+ \Macro{DeclareNewLayer}\OParameter{Optionenliste}\Parameter{Name der Ebene}\\
+ \Macro{ProvideLayer}\OParameter{Optionenliste}\Parameter{Name der Ebene}\\
+ \Macro{RedeclareLayer}\OParameter{Optionenliste}\Parameter{Name der Ebene}\\
+ \Macro{ModifyLayer}\OParameter{Optionenliste}\Parameter{Name der Ebene}
+\end{Declaration}
+\BeginIndex{Cmd}{DeclareLayer}%
+\BeginIndex{Cmd}{DeclareNewLayer}%
+\BeginIndex{Cmd}{ProvideLayer}%
+\BeginIndex{Cmd}{RedeclareLayer}%
+\BeginIndex{Cmd}{ModifyLayer}%
+Diese Anweisungen können verwendet werden, um Ebenen zu definieren. Der
+\PName{Name der Ebene} muss voll expandierbar sein. Die Expansion sollte in
+ASCII-Buchstaben resultieren. Einige zusätzliche Zeichen werden ebenfalls
+akzeptiert, ihre Verwendung wird jedoch nicht empfohlen.
+
+Dabei spielt es bei Verwendung von \Macro{DeclareLayer} keine Rolle, ob eine
+Ebene \PName{Name der Ebene} bereits existiert oder nicht. Sie wird in jedem
+Fall mit den über die \PName{Optionenliste} angegebenen Eigenschaften
+definiert. Einzelne Optionen bestehen entweder nur aus einem Schlüssel oder
+aus einem Schlüssel, gefolgt von einem Gleichheitszeichen und einem Wert. Die
+Optionen sind durch Komma voneinander getrennt. Um innerhalb der Werte einer
+Option ein Komma oder ein Leerzeichen verwenden zu können, muss der
+entsprechende Wert in geschweifte Klammern gesetzt werden. Eine Übersicht
+über die Optionen und die Eigenschaften, die sie repräsentieren, findet sich
+in \autoref{tab:scrlayer.layerkeys}.
+
+Im Unterschied zu \Macro{DeclareLayer} meldet \Macro{DeclareNewLayer} einen
+Fehler, falls eine Ebene mit dem angegebenen Namen bereits existiert. Damit
+wird der Anwender davor bewahrt, versehentlich mehrmals denselben Namen zu
+verwenden. Dies ist insbesondere auch dann nützlich, wenn Klassen oder Pakete
+intern ebenfalls Ebenen definieren.
+
+Dagegen definiert \Macro{ProvideLayer} die Ebene nur, wenn nicht bereits eine
+Ebene mit dem angegebenen Namen existiert. Ist der Name hingegen bereits für
+eine andere Ebene verwendet, so wird die neuerliche Definition ignoriert. Die
+Anweisung hat also die Bedeutung: \emph{Definiere die Ebene, falls sie noch
+ nicht existiert.}
+
+Soll eine bereits existierende Ebene umdefiniert werden, so kann wahlweise
+\Macro{RedeclareLayer} oder \Macro{ModifyLayer} verwendet werden. Während mit
+\Macro{RedeclareLayer} die Ebene zunächst auf die Grundeinstellungen
+zurückgesetzt und damit über die angegebene \PName{Optionenliste} komplett neu
+definiert wird, unterbleibt bei \Macro{ModifyLayer} das Zurücksetzen. Es
+werden dann nur die Eigenschaften geändert, für die in der
+\PName{Optionenliste} auch Angaben vorhanden sind. Die Anwendung auf eine
+zuvor noch nicht definierte Ebene stellt bei beiden Anweisungen einen Fehler
+dar.
+
+\begin{desclist}
+ \desccaption{%
+ Optionen für die Definition von Seiten-Ebenen mit ihrer jeweiligen
+ Bedeutung als Ebenen-Eigenschaft\label{tab:scrlayer.layerkeys}%
+ }{%
+ Optionen für die Definition von Ebenen (\emph{Fortsetzung})%
+ }%
+ \nentry{\KOption{align}\PName{Ausrichtungszeichen}}{%
+ Über die \PName{Ausrichtungszeichen} wird die gewünschte Ausrichtung der
+ Ebene bestimmt. Dabei steht jedes einzelne \PName{Ausrichtungszeichen} für
+ eine mögliche Anwendung der Werte \PName{Abstand} der Optionen
+ \Option{hoffset} oder \Option{voffset}. Mehrere
+ \PName{Ausrichtungszeichen} können ohne Leerzeichen oder Komma direkt
+ hintereinander geschrieben werden und werden in der Reihenfolge ihres
+ Auftretens ausgewertet. Makros sind im Wert der Option jedoch
+ nicht zulässig. Zulässige \PName{Ausrichtungszeichen} sind:
+ \begin{description}
+ \item[\PValue{b} --] der Wert der Option \Option{voffset} ist der Abstand
+ der Unterkante der Ebene von der Oberkante des Papiers.
+ \item[\PValue{c} --] die Werte der Optionen \Option{hoffset} und
+ \Option{voffset} sind die Abstände des Zentrums der Ebene von der linken
+ und der oberen Kante des Papiers.
+ \item[\PValue{l} --] der Wert der Option \Option{hoffset} ist der Abstand
+ der linken Kante der Ebene von der linken Kante des Papiers.
+ \item[\PValue{r} --] der Wert der Option \Option{hoffset} ist der Abstand
+ der rechten Kante der Ebene von der linken Kante des Papiers.
+ \item[\PValue{t} --] der Wert der Option \Option{voffset} ist der Abstand
+ der Oberkante der Ebene von der Oberkante des Papiers.
+ \end{description}
+ }%
+ \entry{\KOption{area}\Parameter{horizontaler Abstand}\Parameter{vertikaler
+ Abstand}\Parameter{Breite}\Parameter{Höhe}}{%
+ Die zusammengesetzte Eigenschaft, resultiert in den primären Eigenschaften
+ \KOption{hoffset}\PName{horizontaler Abstand},
+ \KOption{voffset}\PName{vertikaler Abstand},
+ \KOption{width}\PName{Breite}, \KOption{height}\PName{Höhe}.%
+ }%
+ \entry{\Option{background}}{%
+ Mit dieser Option wird die Ebene zu einer reinen Hintergrundebene. Sie
+ wird also im Gegensatz zur Grundeinstellung nicht mehr gleichzeitig im
+ Hintergrund und im Vordergrund, sondern nur noch im Hintergrund
+ ausgegeben. Diese Option erwartet und erlaubt keinen Wert.%
+ }%
+ \entry{\Option{bottommargin}}{%
+ Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften
+ \Option{hoffset}, \Option{voffset}, \Option{width}, \Option{height} und
+ \Option{align} so, dass die Ebene horizontal von der linken Kante bis zur
+ rechten Kante des Papiers reicht und vertikal den gesamten Bereich unter
+ dem Seitenfuß bis zur unteren Papierkante abdeckt. Diese Option erwartet
+ und erlaubt keinen Wert.%
+ }%
+ \entry{\KOption{clone}\PName{Name einer Ebene}}{%
+ Die zusammengesetzte Eigenschaft setzt alle primären Eigenschaften
+ entsprechend der aktuellen, primären Eigenschaften der Ebene mit dem
+ angegebenen \PName{Name einer Ebene}. Es ist zu beachten, dass \PName{Name
+ einer Ebene} voll expandierbar sein muss und zu Buchstaben expandieren
+ sollte. Einige weitere Zeichen werden toleriert, ihre Verwendung wird
+ jedoch nicht empfohlen! Die Ebene mit dem angegebenen \PName{Name einer
+ Ebene} muss außerdem bereits existieren.%
+ }%
+ \entry{\KOption{contents}\PName{Code}}{%
+ Der angegebene \PName{Code} wird immer dann expandiert und ausgeführt,
+ wenn die Ebene ausgegeben wird. Damit definiert \PName{Code} das, was auf
+ der Ebene zu sehen ist. Es werden keine Tests durchgeführt, ob
+ \PName{Code} gültig und korrekt ist. Fehler in \PName{Code} können daher
+ zu verschiedenen Fehlermeldungen auf jeder Seite führen, auf der die Ebene
+ ausgegeben wird.%
+ }%
+ \entry{\Option{evenpage}}{%
+ Mit dieser Option wird die Ebene zu einer Ebene für linke Seiten. Sie wird
+ also im Gegensatz zur Grundeinstellung nicht mehr sowohl auf linken als
+ auch auf rechten Seiten ausgegeben. Da es linke Seiten nur im
+ doppelseitigen Satz gibt, schließt diese Eigenschaft quasi
+ \Option{twoside} mit ein. Diese Option erwartet und erlaubt keinen Wert.%
+ }%
+ \entry{\Option{floatpage}}{%
+ Mit dieser Option wird die Ebene zu einer Gleitseitenebene. Sie wird also
+ im Gegensatz zur Grundeinstellung nicht mehr auf allen Seiten, sondern nur
+ noch auf Gleitseiten ausgegeben. Näheres zu Gleitseiten ist der Einleitung
+ zu diesem Abschnitt zu entnehmen. Diese Option erwartet und erlaubt keinen
+ Wert.%
+ }%
+ \entry{\Option{foot}}{%
+ Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften
+ \Option{hoffset}, \Option{voffset}, \Option{width}, \Option{height} und
+ \Option{align} so, dass die Ebene den Seitenfuß in der Breite des
+ Textbereichs überdeckt. Diese Option erwartet und erlaubt keinen Wert.%
+ }%
+ \entry{\Option{footskip}}{%
+ Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften
+ \Option{hoffset}, \Option{voffset}, \Option{width}, \Option{height} und
+ \Option{align} so, dass die Ebene vertikal den Bereich zwischen dem
+ Textbereich und dem Seitenfuß in Breite des Textbereichs überdeckt. Es ist
+ zu beachten, dass die Höhe dieses Bereichs zwar von der Länge
+ \Length{footskip} abhängt, dieser jedoch nicht entspricht. Diese Option
+ erwartet und erlaubt keinen Wert.%
+ }%
+ \entry{\Option{foreground}}{%
+ Mit dieser Option wird die Ebene zu einer reinen Vodergrundebene. Sie wird
+ also im Gegensatz zur Grundeinstellung nicht mehr gleichzeitig im
+ Hintergrund und im Vordergrund, sondern nur noch im Vordergrund
+ ausgegeben. Diese Option erwartet und erlaubt keinen Wert.%
+ }%
+ \entry{\Option{head}}{%
+ Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften
+ \Option{hoffset}, \Option{voffset}, \Option{width}, \Option{height} und
+ \Option{align} so, dass die Ebene den Seitenkopf in der Breite des
+ Textbereichs überdeckt. Diese Option erwartet und erlaubt keinen Wert.%
+ }%
+ \entry{\Option{headsep}}{%
+ Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften
+ \Option{hoffset}, \Option{voffset}, \Option{width}, \Option{height} und
+ \Option{align} so, dass die Ebene den Abstand zwischen dem Seitenkopf und
+ dem Textbereich in der Breite des Textbereichs überdeckt. Ihre Höhe
+ entspricht damit der Länge \Length{headsep}. Diese Option erwartet und
+ erlaubt keinen Wert.%
+ }%
+ \entry{\KOption{height}\PName{Höhe}}{%
+ Setzt die \PName{Höhe} der Ebene. Beachten Sie, dass \PName{Höhe}
+ wahlweise eine \LaTeX-Länge sein kann, die mit \Macro{newlength} definiert
+ wurde, eine \TeX-Länge, die mit \Macro{newdimen} oder \Macro{newskip}
+ definiert wurde, ein Längenwert wie 10\Unit{pt} oder ein Längenausdruck
+ unter Verwendung von +, -, /, *, (, und ). Die genaue Syntax eines
+ Längenausdrucks ist \cite[Abschnitt~3.5]{manual:eTeX} zu entnehmen.%
+ }%
+ \entry{\KOption{hoffset}\PName{Abstand}}{%
+ Setzt den \PName{Abstand} der Ebene von der linken Kante des Papiers. Wie
+ der \PName{Abstand} gemessen wird, hängt von Eigenschaft \Option{align}
+ ab. Beachten Sie, dass \PName{Abstand} wahlweise eine \LaTeX-Länge sein
+ kann, die mit \Macro{newlength} definiert wurde, eine \TeX-Länge, die mit
+ \Macro{newdimen} oder \Macro{newskip} definiert wurde, ein Längenwert wie
+ 10\Unit{pt} oder ein Längenausdruck unter Verwendung von +, -, /, *, (,
+ und ). Die genaue Syntax eines Längenausdrucks ist
+ \cite[Abschnitt~3.5]{manual:eTeX} zu entnehmen.%
+ }%
+ \entry{\Option{innermargin}}{%
+ Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften
+ \Option{hoffset}, \Option{voffset}, \Option{width}, \Option{height} und
+ \Option{align} so, dass die Ebene den inneren Rand der Seite von der
+ Papieroberkante bis zur Papierunterkante überdeckt. Der innere Rand
+ entspricht im einseitigen Satz dem linken Rand. Diese Option erwartet und
+ erlaubt keinen Wert.%
+ }%
+ \entry{\Option{leftmargin}}{%
+ Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften
+ \Option{hoffset}, \Option{voffset}, \Option{width}, \Option{height} und
+ \Option{align} so, dass die Ebene den linken Rand der Seite von der
+ Papieroberkante bis zur Papierunterkante überdeckt. Diese Option erwartet
+ und erlaubt keinen Wert.%
+ }%
+ \entry{\Option{nonfloatpage}}{%
+ Mit dieser Option wird die Ebene auf Seiten beschränkt, die keine
+ Gleitseiten sind. Sie wird also im Gegensatz zur Grundeinstellung nicht
+ mehr auf allen Seiten, sondern nur noch auf Nichtgleitseiten
+ ausgegeben. Näheres zu Gleitseiten und Nichtgleitseiten ist der Einleitung
+ zu diesem Abschnitt zu entnehmen. Diese Option erwartet und erlaubt keinen
+ Wert.%
+ }%
+ \entry{\Option{oddpage}}{%
+ Mit dieser Option wird die Ebene zu einer Ebene für rechte Seiten. Sie wird
+ also im Gegensatz zur Grundeinstellung nicht mehr sowohl auf linken als
+ auch auf rechten Seiten ausgegeben. Es ist zu beachten, dass im
+ einseitigen Satz alle Seiten unabhängig von der Seitenzahl rechte Seiten
+ sind. Diese Option erwartet und erlaubt keinen Wert.%
+ }%
+ \entry{\Option{oneside}}{%
+ Mit dieser Option wird die Ebene zu einer Ebene für den einseitigen
+ Satz. Sie wird also im Gegensatz zur Grundeinstellung nicht mehr sowohl
+ im einseitigen als auch im doppelseitigen Satz ausgegeben. Diese Option
+ erwartet und erlaubt keinen Wert.%
+ }%
+ \entry{\Option{outermargin}}{%
+ Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften
+ \Option{hoffset}, \Option{voffset}, \Option{width}, \Option{height} und
+ \Option{align} so, dass die Ebene den äußeren Rand der Seite von der
+ Papieroberkante bis zur Papierunterkante überdeckt. Der äußere Rand
+ entspricht im einseitigen Satz dem rechten Rand. Diese Option erwartet und
+ erlaubt keinen Wert.%
+ }%
+ \entry{\Option{page}}{%
+ Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften
+ \Option{hoffset}, \Option{voffset}, \Option{width}, \Option{height} und
+ \Option{align} so, dass die Ebene die komplette Seite überdeckt. Diese
+ Option erwartet und erlaubt keinen Wert.%
+ }%
+ \entry{\Option{rightmargin}}{%
+ Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften
+ \Option{hoffset}, \Option{voffset}, \Option{width}, \Option{height} und
+ \Option{align} so, dass die Ebene den rechten Rand der Seite von der
+ Papieroberkante bis zur Papierunterkante überdeckt. Diese Option erwartet
+ und erlaubt keinen Wert.%
+ }%
+ \entry{\Option{textarea}}{%
+ Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften
+ \Option{hoffset}, \Option{voffset}, \Option{width}, \Option{height} und
+ \Option{align} so, dass die Ebene den kompletten Textbereich
+ überdeckt. Diese Option erwartet und erlaubt keinen Wert.%
+ }%
+ \entry{\Option{topmargin}}{%
+ Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften
+ \Option{hoffset}, \Option{voffset}, \Option{width}, \Option{height} und
+ \Option{align} so, dass die Ebene den oberen Rand der Seite von der linken
+ Kante des Papiers bis zu dessen rechter Kante überdeckt. Diese Option
+ erwartet und erlaubt keinen Wert.%
+ }%
+ \entry{\Option{twoside}}{%
+ Mit dieser Option wird die Ebene zu einer Ebene für den doppelseitigen
+ Satz. Sie wird also im Gegensatz zur Grundeinstellung nicht mehr sowohl
+ im einseitigen als auch im doppelseitigen Satz ausgegeben. Diese Option
+ erwartet und erlaubt keinen Wert.%
+ }%
+ \entry{\KOption{voffset}\PName{Abstand}}{%
+ Setzt den \PName{Abstand} der Ebene von der Papieroberkante. Wie der
+ \PName{Abstand} gemessen wird, hängt von Eigenschaft \Option{align}
+ ab. Beachten Sie, dass \PName{Abstand} wahlweise eine \LaTeX-Länge sein
+ kann, die mit \Macro{newlength} definiert wurde, eine \TeX-Länge, die mit
+ \Macro{newdimen} oder \Macro{newskip} definiert wurde, ein Längenwert wie
+ 10\Unit{pt} oder ein Längenausdruck unter Verwendung von +, -, /, *, (,
+ und ). Die genaue Syntax eines Längenausdrucks ist
+ \cite[Abschnitt~3.5]{manual:eTeX} zu entnehmen.%
+ }%
+ \entry{\KOption{width}\PName{Breite}}{%
+ Setzt die \PName{Breite} der Ebene. Beachten Sie, dass \PName{Breite}
+ wahlweise eine \LaTeX-Länge sein kann, die mit \Macro{newlength} definiert
+ wurde, eine \TeX-Länge, die mit \Macro{newdimen} oder \Macro{newskip}
+ definiert wurde, ein Längenwert wie 10\Unit{pt} oder ein Längenausdruck
+ unter Verwendung von +, -, /, *, (, und ). Die genaue Syntax eines
+ Längenausdrucks ist \cite[Abschnitt~3.5]{manual:eTeX} zu entnehmen.%
+ }%
+\end{desclist}
+%
+\EndIndex{Cmd}{ModifyLayer}%
+\EndIndex{Cmd}{RedeclareLayer}%
+\EndIndex{Cmd}{ProvideLayer}%
+\EndIndex{Cmd}{DeclareNewLayer}%
+\EndIndex{Cmd}{DeclareLayer}%
+
+\begin{Declaration}
+ \Macro{layerxoffset}\\
+ \Macro{layeryoffset}\\
+ \Macro{layerwidth}\\
+ \Macro{layerheight}%
+\end{Declaration}
+\BeginIndex{Cmd}{layerxoffset}%
+\BeginIndex{Cmd}{layeryoffset}%
+\BeginIndex{Cmd}{layerwidth}%
+\BeginIndex{Cmd}{layerheight}%
+Diese Anweisungen sind nur innerhalb der Ausgabe des mit \Option{contents}
+angegebenen \PName{Code} gültig. In diesem Fall enthalten sie die tatsächlich
+verwendete Position und Ausdehnung der Ebene, die für die Ausgabe verwendet
+werden. Dies ist jedoch nicht zwangsläufig auch die tatsächliche Ausdehnung des
+Inhalts, falls dieser beispielsweise überbreit oder überhoch ist oder die
+Ebene nicht komplett ausfüllt. Eine Umdefinierung der Anweisungen und damit
+Änderung der in ihnen gespeicherten Werte ist nicht gestattet und führt zu
+unvorhersehbaren Ergebnissen.%
+\EndIndex{Cmd}{layerheight}%
+\EndIndex{Cmd}{layerwidth}%
+\EndIndex{Cmd}{layeryoffset}%
+\EndIndex{Cmd}{layerxoffset}%
+
+\begin{Declaration}
+ \Macro{IfLayerExists}%^^A
+ \Parameter{Name}\Parameter{Dann-Code}\Parameter{Sonst-Code}
+\end{Declaration}
+\BeginIndex{Cmd}{IfLayerExists}%
+Diese Anweisung kann dazu verwendet werden, Code in Abhängigkeit davon, ob ein
+eine Ebene existiert oder nicht, auszuführen. Wenn die Ebene mit dem
+angegebenen \PName{Name} existiert, so wird der \PName{Dann-Code}
+ausgeführt, anderenfalls der \PName{Sonst-Code}. Bitte beachten Sie, dass die
+Anweisung nicht wirklich testen kann, ob eine Ebene existiert. Sie verwendet
+stattdessen Heuristiken, die niemals falsch-negativ sein können, jedoch im
+Extremfall falsch-positiv sein könnten. Nichts desto trotz: Falls der Test
+falsch-positiv ist, läuft etwas schief. Beispielsweise könnte dies ein
+Indikator für die Verwendung eines inkompatiblen Pakets oder dafür sein, dass
+der Anwender etwas tut, was er besser nicht tun sollte.%
+\EndIndex{Cmd}{IfLayerExists}
+
+\begin{Declaration}
+ \Macro{DestroyLayer}\Parameter{Name der Ebene}
+\end{Declaration}
+\BeginIndex{Cmd}{DestroyLayer}%
+Existiert eine Ebene mit dem angegebenen \PName{Name der Ebene}, so werden
+alle zu dieser Ebene gehörenden Makros zu \Macro{relax}. Anschließend kann die
+Ebene nicht länger verwendet werden. Allerdings ist es kein Problem, falls die
+Ebene Bestandteil eines mit \Package{scrlayer} definierten Seitenstils ist, da
+derart zerstörte Ebenen schlicht ignoriert werden. Nichtsdestotrotz können
+zerstörte Ebenen anschließend mit \Macro{DeclareNewLayer} oder
+\Macro{ProvideLayer} neu definiert werden. Sie können jedoch vor einer
+neuerlichen Definition nicht länger mit \Macro{RedeclareLayer} oder
+\Macro{ModifyLayer} verändert werden.
+
+Die Anweisung ist dazu bestimmt, innerhalb von
+\Macro{scrlayerOnAutoRemoveInterface} verwendet zu werden. Damit können Ebenen
+die unter Verwendung von entfernbaren Anweisungen einer entfernbaren
+Benutzerschnittstelle definiert wurden, zusammen mit dieser
+Benutzerschnittstelle entfernt werden.%
+%
+\EndIndex{Cmd}{DestroyLayer}%
+
+
+\begin{Declaration}
+ \Macro{layercontentsmeasure}
+\end{Declaration}
+\BeginIndex{Cmd}{layercontentsmeasure}%
+Mit Hilfe der \KOMAScript-Option
+\Option{draft}\IndexOption{draft~=\PName{Ein-Aus-Wert}} kann für das Paket
+\Package{scrlayer} ein Entwurfsmodus aktiviert werden. In diesem Entwurfsmodus
+wird hinter jeder Ebene zunächst eine Bemaßung der Ebene ausgegeben. Diese
+Bemaßung erfolgt mit \Macro{layercontentsmeasure}. Diese Anweisung zeigt am
+oberen und linken Rand der Ebene ein Maßband in Zentimeter und am rechten und
+unteren Rand der Ebene ein Maßband in Zoll. Die Anweisung
+\Macro{layercontentsmeasure} kann statt über die Option auch schlicht als
+alleiniger \PName{Code} für die Eigenschaft \Option{contents} einer Ebene
+verwendet werden.%
+%
+\EndIndex{Cmd}{layercontentsmeasure}%
+
+
+\section{Deklaration und Verwaltung von Seitenstilen}
+\label{sec:scrlayer.pagestyles}
+
+Wir kennen nun Ebenen und wissen, wie diese definiert und verwaltet
+werden. Aber bisher wissen wir noch nicht, wie sie verwendet werden. Die
+möglicherweise überraschende Antwort lautet: mit Hilfe von
+Seitenstilen. Üblicherweise werden Seitenstile in \LaTeX{} zur Definition von
+Kopf und Fuß der Seite verwendet.
+
+Kopf und Fuß für ungerade oder rechte Seiten werden im doppelseitigen Modus
+auf Seiten mit ungerader Seitenzahl ausgegeben. Im einseitigen Modus werden
+sie auf allen Seiten verwendet. Das ist unmittelbar mit den Optionen
+\Option{oddpage} und \Option{evenpage} für Ebenen vergleichbar.
+
+Der Seitenkopf wird vor dem normalen Seiteninhalt ausgegeben. Der Seitenfuß
+wird entsprechend nach dem normalen Seiteninhalt ausgegeben. Dies
+korrespondiert also unmittelbar mit den Optionen \Option{background} und
+\Option{foreground} für Ebenen.
+
+Daher liegt es nahe, Seitenstile als Listen von Ebenen zu definieren. Aber
+statt nur die genannten vier Optionen, können dabei alle Eigenschaften
+verwendet werden, die in \autoref{sec:scrlayer.layers} erklärt wurden.
+
+Als Ergebnis dieser Überlegungen ist eine Form von Seitenstilen, die
+\Package{scrlayer} bietet, der Ebenen-Seitenstil. Ein solcher Ebenen-Seitenstil
+besteht aus Ebenen und zusätzlich aus mehreren Haken (engl. \emph{hooks}). Die
+Ebenen wurden bereits in \autoref{sec:scrlayer.layers} beschrieben. Die Haken
+sind Punkte in der Expansion oder Anwendung von Seitenstilen, zu denen
+zusätzlicher Code hinzugefügt werden kann. Erfahrene Anwender kennen dieses
+Konzept bereits von beispielsweise \Macro{AtBeginDocument} (siehe
+\cite{latex:usrguide}) oder \Macro{BeforeClosingMainAux} (siehe
+\autopageref{desc:scrlfile.cmd.BeforeClosingMainAux}).
+
+Eine zweite Form von Seitenstilen, die \Package{scrlayer} bietet, ist der
+Alias-Seitenstil oder Seitenstil-Alias. Ein Seitenstil-Alias besteht in
+Wirklichkeit aus einem anderen Seitenstil. Anders ausgedrückt ist der Name eines
+Seitenstil-Alias ein Alias-Name für einen anderen Seitenstil-Alias oder einen
+primären Seitenstil. Daher führt die Manipulation an einem Seitenstil-Alias
+zu einer Manipulation am originären Seitenstil. Ist der originäre Seitenstil
+selbst ebenfalls ein Seitenstil-Alias, so führt dessen Manipulation wiederum
+zu einer Manipulation dessen originären Seitenstils und immer so weiter, bis
+schließlich ein realer Seitenstil verändert wird. Der Ausdruck
+\emph{realer Seitenstil} wird zur Unterscheidung von einem Seitenstil-Alias
+verwendet. Alle Seitenstile, die kein Seitenstil-Alias sind, sind reale
+Seitenstile. Seitenstil-Aliase können nicht nur für Seitenstile definiert
+werden, die mit \Package{scrlayer} definiert wurden, sondern für alle
+Seitenstile.
+
+\begin{Declaration}
+ \Macro{currentpagestyle}
+\end{Declaration}
+\BeginIndex{Cmd}{currentpagestyle}%
+Das Paket \Package{scrlayer} erweitert die \LaTeX-Anweisung
+\Macro{pagestyle}\IndexCmd{pagestyle} so, dass diese \Macro{currentpagestyle}
+als den Namen des jeweils aktiven Seitenstils
+definiert. Es\textnote{Achtung!} ist zu beachten, dass
+\Macro{thispagestyle}\IndexCmd{thispagestyle} selbst \Macro{currentpagestyle}
+nicht verändert. Wird \Macro{thispagestyle} verwendet, so kann sich
+\Macro{currentpagestyle} aber innerhalb der \LaTeX-Ausgabefunktion
+verändern. Dies hat jedoch nur dann Auswirkungen, wenn
+\Macro{currentpagestyle} bis in die \LaTeX-Ausgabefunktion geschützt
+verwendet wird.
+
+Es sei darauf hingewiesen, dass die später in diesem Abschnitt dokumentierten
+Ebenen-Seitenstile nicht auf diese Erweiterung von \Macro{pagestyle} angewiesen
+sind, da sie selbst ebenfalls \Macro{currentpagestyle} umdefinieren. Die
+Erweiterung wurde für die Verwendung von anderen Seitenstilen, die nicht auf
+\Package{scrlayer} basieren, vorgenommen. Es ist außerdem zu
+beachten\textnote{Achtung!}, dass \Macro{currentpagestyle} vor der ersten
+Verwendung von \Macro{pagestyle} nach dem Laden von \Package{scrlayer} leer
+ist. Bei der Definition einer Endanwender-Schnittstelle dürfte es daher
+nützlich sein, mit einer impliziten \Macro{pagestyle}-Anweisung den aktuellen
+Seitenstil auf eine Voreinstellung zu setzen.%
+\EndIndex{Cmd}{currentpagestyle}%
+
+\begin{Declaration}
+ \Macro{BeforeSelectAnyPageStyle}\Parameter{Code}\\
+ \Macro{AfterSelectAnyPageStyle}\Parameter{Code}%
+\end{Declaration}
+\BeginIndex{Cmd}{BeforeSelectAnyPageStyle}%
+\BeginIndex{Cmd}{AfterSelectAnyPageStyle}%
+Die Anweisung \Macro{BeforeSelectAnyPageStyle} fügt einem Haken
+(engl. \emph{hook}) \PName{Code} hinzu, der innerhalb der Ausführung von
+\Macro{pagestyle}, unmittelbar vor der Auswahl des Seitenstils ausgeführt
+wird. Innerhalb von \PName{Code} kann \texttt{\#1} als Platzhalter für das
+Argument von \Macro{pagestyle} verwendet werden.
+
+Die Anweisung \Macro{AfterSelectAnyPageStyle} arbeitet ähnlich. Allerdings
+wird hier \PName{Code} ausgeführt, nachdem der Seitenstil gewählt und
+\Macro{currentpagestyle} auf den Namen des realen Seitenstils gesetzt wurde.
+
+Es ist zu beachten\textnote{Achtung!}, dass \PName{Code} jeweils nur bei der
+Wahl eines Seitenstils mit Hilfe von \Macro{pagestyle} ausgeführt wird. Wird
+ein Seitenstil auf andere Art, beispielsweise mit Hilfe von
+\Macro{thispagestyle}, gewählt, so wird \PName{Code} nicht ausgeführt. Es ist
+außerdem zu beachten\textnote{Achtung!}, dass einmal hinzugefügter
+\PName{Code} nicht mehr entfernt werden kann. Allerdings wird der \PName{Code}
+lokal hinzugefügt. Sein Gültigkeitsbereich kann daher mit einer Gruppe
+beschränkt werden.%
+\EndIndex{Cmd}{AfterSelectAnyPageStyle}%
+\EndIndex{Cmd}{BeforeSelectAnyPageStyle}%
+
+
+\begin{Declaration}
+ \Macro{DeclarePageStyleAlias}%
+ \Parameter{Seitenstil-Alias-Name}\Parameter{originärer Seitenstil-Name}\\
+ \Macro{DeclareNewPageStyleAlias}%
+ \Parameter{Seitenstil-Alias-Name}\Parameter{originärer Seitenstil-Name}\\
+ \Macro{ProvidePageStyleAlias}%
+ \Parameter{Seitenstil-Alias-Name}\Parameter{originärer Seitenstil-Name}\\
+ \Macro{RedeclarePageStyleAlias}%
+ \Parameter{Seitenstil-Alias-Name}\Parameter{originärer Seitenstil-Name}%
+\end{Declaration}
+\BeginIndex{Cmd}{DeclarePageStyleAlias}%
+\BeginIndex{Cmd}{DeclareNewPageStyleAlias}%
+\BeginIndex{Cmd}{ProvidePageStyleAlias}%
+\BeginIndex{Cmd}{RedeclarePageStyleAlias}%
+Diese Anweisungen können verwendet werden, um einen Seitenstil mit dem Namen
+\PName{Seitenstil-Alias-Name} zu definieren, der einfach nur ein Alias für
+einen bereits existierenden Seitenstil mit dem Namen \PName{originärer
+ Seitenstil-Name} ist. Falls bereits ein Seitenstil mit dem Namen
+\PName{Seitenstil-Alias-Name} existiert, wird dieser vor der Erzeugung des
+Alias mit \Macro{DeclarePageStyleAlias} oder \Macro{RedeclarePageStyleAlias}
+zerstört.
+
+Die Anweisung \Macro{DeclareNewPageStyleAlias} erzeugt eine Fehlermeldung,
+falls zuvor bereits ein Seitenstil mit dem Namen \PName{Seitenstil-Alias-Name}
+definiert wurde. Dabei spielt es keine Rolle, ob der existierende Seitenstil
+selbst ein Alias-Seitenstil, ein Ebenen-Seitenstil oder eine andere Art von
+Seitenstil ist.
+
+Die Anweisung \Macro{ProvidePageStyleAlias} definiert den Alias-Seitenstil
+nur, falls nicht bereits ein Seitenstil mit dem Namen
+\PName{Seitenstil-Alias-Name} existiert. Falls ein solcher Seitenstil
+existiert, bleibt dieser erhalten und die Anweisung tut schlicht nichts.
+
+Im Gegensatz zu den anderen Anweisungen erwartet
+\Macro{RedeclarePageStyleAlias}, dass bereits ein Seitenstil mit dem Namen
+\PName{Seitenstil-Alias-Name} existiert. Anderenfalls erzeugt die Anweisung
+eine Fehlermeldung.%
+\EndIndex{Cmd}{RedeclarePageStyleAlias}%
+\EndIndex{Cmd}{ProvidePageStyleAlias}%
+\EndIndex{Cmd}{DeclareNewPageStyleAlias}%
+\EndIndex{Cmd}{DeclarePageStyleAlias}
+
+\begin{Declaration}
+ \Macro{DestroyPageStyleAlias}\Parameter{Seitenstil-Alias-Name}%
+\end{Declaration}
+\BeginIndex{Cmd}{DestroyPageStyleAlias}%
+Mit dieser Anweisung wird der Seitenstil-Alias mit dem angegebenen Namen
+\PName{Seitenstil-Alias-Name} für \LaTeX{} wieder undefiniert, wenn es
+tatsächlich einen Alias-Seitenstil dieses Namens gibt. Anschließend kann der
+Seitenstil beispielsweise mit \Macro{DeclareNewAliasPageStyle} oder
+\Macro{ProvideAliasPageStyle} neu definiert werden.
+
+Die Anweisung ist dazu bestimmt innerhalb von
+\Macro{scrlayerOnAutoRemoveInterface} verwendet zu werden, um Seitenstile, die
+als Teil eines Endanwender-Interfaces definiert wurden, beim Entfernen dieses
+Interfaces mit zu entfernen.%
+\EndIndex{Cmd}{DestroyPageStyleAlias}%
+
+\begin{Declaration}
+ \Macro{GetRealPageStyle}\Parameter{Seitenstil-Name}%
+\end{Declaration}
+\BeginIndex{Cmd}{GetRealPageStyle}%
+Diese Anweisung sucht rekursiv nach dem tatsächlichen Namen eines
+Seitenstils, wenn der angegebene \PName{Seitenstil-Name} zu einem
+Alias-Seitenstil gehört. Ist \PName{Seitenstil-Name} nicht der Name eines
+Alias-Seitenstils, so ist das Ergebnis \PName{Seitenstil-Name} selbst. Das
+gilt auch, falls ein Seitenstil namens \PName{Seitenstil-Name} gar nicht
+existiert. Die Anweisung ist voll expandierbar und kann damit beispielsweise
+auch im zweiten Argument einer \Macro{edef}-Anweisung verwendet werden.
+%
+\EndIndex{Cmd}{GetRealPageStyle}%
+
+
+\begin{Declaration}
+ \Macro{DeclarePageStyleByLayers}%
+ \OParameter{Optionenliste}\Parameter{Seitenstil-Name}%
+ \Parameter{Ebenenliste}\\
+ \Macro{DeclareNewPageStyleByLayers}%
+ \OParameter{Optionenliste}\Parameter{Seitenstil-Name}%
+ \Parameter{Ebenenliste}\\
+ \Macro{ProvidePageStyleByLayers}%
+ \OParameter{Optionenliste}\Parameter{Seitenstil-Name}%
+ \Parameter{Ebenenliste}\\
+ \Macro{RedeclarePageStyleByLayers}%
+ \OParameter{Optionenliste}\Parameter{Seitenstil-Name}%
+ \Parameter{Ebenenliste}%
+\end{Declaration}
+\BeginIndex{Cmd}{DeclarePageStyleByLayers}%
+\BeginIndex{Cmd}{DeclareNewPageStyleByLayers}%
+\BeginIndex{Cmd}{ProvidePageStyleByLayers}%
+\BeginIndex{Cmd}{RedeclarePageStyleByLayers}%
+Diese Anweisungen deklarieren einen Seitenstil mit dem
+Namen \Parameter{Seitenstil-Name}. Der Seitenstil besteht aus einer Anzahl von
+Ebenen, die in der mit Komma separierten \PName{Ebenenliste} angegeben
+sind. Es ist zu beachten\textnote{Achtung!}, dass sowohl
+\PName{Seitenstil-Name} als auch \PName{Ebenenliste} voll expandierbar sein
+muss und die Expansion zu einer Reihe von Buchstaben führen sollte. Einige
+andere Zeichen werden zwar toleriert, ihre Verwendung wird jedoch nicht
+empfohlen.
+
+Die \PName{Optionenliste} ist eine mit Komma separierte Liste von
+\texttt{\PName{Schlüssel}=\PName{Wert}}-Optionen. Diese Optionen können
+verwendet werden, um zusätzliche Eigenschaften zu setzen und zusätzliche
+Möglichkeiten zu nutzen. Derzeit werden sie verwendet, um Code an bestimmten
+Stellen der Aktivierung oder Verwendung eines Seitenstils über Haken
+(engl. \emph{hooks}) auszuführen. Für allgemeine Informationen zu Haken sei
+auf die Einleitung zu diesem Abschnitt verwiesen. Details zu den Haken und
+ihrer Bedeutung sind \autoref{tab:scrlayer.pagestyle.hooks} zu entnehmen.
+
+\begin{desclist}
+ \desccaption{%
+ Optionen und gleichnamige Haken für Ebenen-Seitenstile (in der Reihenfolge
+ ihrer Abarbeitung)\label{tab:scrlayer.pagestyle.hooks}%
+ }{%
+ Optionen für die Haken von Ebenen-Seitenstilen (\emph{Fortsetzung})%
+ }%
+ \entry{\KOption{onselect}\PName{Code}}{%
+ Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn der
+ Seitenstil beispielsweise mit \Macro{pagestyle} ausgewählt wird. Es ist zu
+ beachten, dass \Macro{thispagestyle} selbst keinen Seitenstil unmittelbar
+ auswählt, sondern der Seitenstil in diesem Fall erst innerhalb der
+ Ausgaberoutine von \LaTeX{} aktiviert wird.%
+ }%
+ \entry{\KOption{oninit}\PName{Code}}{%
+ Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
+ Ausgabe der Ebenen für den Seitenstil initialisiert wird. Beachten Sie,
+ dass dies für jede Seite zweimal geschieht: einmal für Hintergrund-Ebenen
+ und einmal für Vordergrund-Ebenen.%
+ }%
+ \entry{\KOption{ononeside}\PName{Code}}{%
+ Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn im
+ einseitigen Modus die Ausgabe der Ebenen für den Seitenstil initialisiert
+ wird. Beachten Sie, dass dies für jede Seite zweimal geschieht: einmal für
+ Hintergrund-Ebenen und einmal für Vordergrund-Ebenen.%
+ }%
+ \entry{\KOption{ontwoside}\PName{Code}}{%
+ Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn im
+ doppelseitigen Modus die Ausgabe der Ebenen für den Seitenstil
+ initialisiert wird. Beachten Sie, dass dies für jede
+ Seite zweimal geschieht: einmal für Hintergrund-Ebenen und einmal für
+ Vordergrund-Ebenen.%
+ }%
+ \entry{\KOption{onoddpage}\PName{Code}}{%
+ Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
+ Ausgabe der Ebenen für den Seitenstil auf einer rechten Seite
+ initialisiert wird. Beachten Sie, dass dies für jede
+ Seite zweimal geschieht: einmal für Hintergrund-Ebenen und einmal für
+ Vordergrund-Ebenen. Beachten Sie außerdem, dass im
+ einseitigen Modus alle Seiten rechte Seiten sind.%
+ }%
+ \entry{\KOption{onevenpage}\PName{Code}}{%
+ Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
+ Ausgabe der Ebenen für den Seitenstil auf einer linken Seite initialisiert
+ wird. Beachten Sie, dass dies für jede Seite zweimal
+ geschieht: einmal für Hintergrund-Ebenen und einmal für
+ Vordergrund-Ebenen. Beachten Sie außerdem, dass im
+ einseitigen Modus keine linken Seiten existieren.%
+ }%
+ \entry{\KOption{onfloatpage}\PName{Code}}{%
+ Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
+ Ausgabe der Ebenen für den Seitenstil auf einer Gleitumgebungsseite
+ initialisiert wird. Beachten Sie, dass dies für jede
+ Seite zweimal geschieht: einmal für Hintergrund-Ebenen und einmal für
+ Vordergrund-Ebenen. Beachten Sie außerdem, dass
+ Gleitumgebungsseiten nur diejenigen Seiten sind, auf denen eine oder
+ mehrere p-platzierte Gleitumgebungen ausgegeben werden.%
+ }%
+ \entry{\KOption{onnonfloatpage}\PName{Code}}{%
+ Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
+ Ausgabe der Ebenen für den Seitenstil auf einer Seite initialisiert wird,
+ die keine Gleitumgebungsseite ist. Beachten Sie, dass
+ dies für jede Seite zweimal geschieht: einmal für Hintergrund-Ebenen und
+ einmal für Vordergrund-Ebenen. Beachten Sie außerdem,
+ dass Gleitumgebungsseiten nur diejenigen Seiten sind, auf denen eine oder
+ mehrere p-platzierte Gleitumgebungen ausgegeben werden, und auf anderen
+ Seiten sehr wohl t-, b- oder h-platzierte Gleitumgebungen stehen können.%
+ }%
+ \entry{\KOption{onbackground}\PName{Code}}{%
+ Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
+ Ausgabe der Ebenen für den Hintergrund einer Seite initialisiert
+ wird. Beachten Sie, dass dies auf jeder Seite genau
+ einmal der Fall ist.%
+ }%
+ \entry{\KOption{onforeground}\PName{Code}}{%
+ Der \PName{Code} dieses Hakens wird immer dann ausgeführt, wenn die
+ Ausgabe der Ebenen für den Vordergrund einer Seite initialisiert
+ wird. Beachten Sie, dass dies auf jeder Seite genau
+ einmal der Fall ist.%
+ }%
+\end{desclist}
+
+Der Unterschied zwischen \Macro{DeclarePageStyleByLayers} und
+\Macro{DeclareNewPageStyleByLayers} besteht darin, dass
+\Macro{DeclareNewPageStyleByLayers} eine Fehlermeldung erzeugt, falls bereits
+ein Seitenstil des Namens \PName{Seitenstil-Name}
+existiert. Beachten\textnote{Achtung!} Sie, dass die Deklaration eines
+Seitenstils, der bereits ein Alias für einen anderen Seitenstil ist (siehe
+\Macro{DeclareAliasPageStyle} zuvor in diesem Abschnitt) nicht zu der
+Umdefinierung des angegebenen Alias-Seitenstils, sondern des realen
+Seitenstils (siehe \Macro{GetRealPageStyle} zuvor in diesem Abschnitt) führt.
+
+Im Unterschied dazu wird bei \Macro{ProvidePageStyleByLayers} der Seitenstil
+unverändert erhalten, wenn bereits ein Seitenstil des Namens
+\PName{Seitenstil-Name} existiert. Existiert kein solcher Seitenstil, so wird
+er wie bei \Macro{DeclarePageStyleByLayers} oder
+\Macro{DeclareNewPageStyleByLayers} neu definiert.
+
+Die Anweisung \Macro{RedeclarePageStyleByLayers} wiederum erwartet, dass
+bereits ein Seitenstil des Namens \PName{Seitenstil-Name} existiert und
+definiert dessen realen Seitenstil dann um. Existiert jedoch noch kein
+Seitenstil des angegebenen Namens, so resultiert daraus eine Fehlermeldung.
+
+Beachten Sie auch die nachfolgenden Anmerkungen zum Pseudo-Seitenstil
+\Pagestyle{@everystyle@}.%
+\EndIndex{Cmd}{RedeclarePageStyleByLayers}%
+\EndIndex{Cmd}{ProvidePageStyleByLayers}%
+\EndIndex{Cmd}{DeclareNewPageStyleByLayers}%
+\EndIndex{Cmd}{DeclarePageStyleByLayers}%
+
+
+\begin{Declaration}
+ \Pagestyle{@everystyle@}\\
+ \Pagestyle{empty}
+\end{Declaration}
+\BeginIndex{Pagestyle}{@everysel@}%
+\BeginIndex{Pagestyle}{empty}%
+Das Paket \Package{scrlayer} definiert von sich aus bereits zwei in gewisser
+Weise spezielle Seitenstile. Der erste davon ist
+\Pagestyle{@everystyle@}. Dieser Seitenstil sollte niemals als normaler
+Seitenstil beispielsweise mit \Macro{pagestyle} oder \Macro{thispagestyle}
+oder als Ziel eines Alias-Seitenstils verwendet werden. Stattdessen werden die
+Ebenen und Haken dieses Seitenstils von allen anderen Ebenen-Seitenstilen mit
+verwendet. Dabei werden die Haken von \Pagestyle{@everystyle@} jeweils vor den
+entsprechenden Haken und die Ebenen jeweils vor den entsprechenden Ebenen des
+aktiven Seitenstils ausgeführt. Damit ist das Hinzufügen einer Ebene zum
+Seitenstil \Pagestyle{@everystyle@} oder von Code zu einem Haken dieses
+Seitenstils vergleichbar mit dem Hinzufügen einer Ebene beziehungsweise von
+Haken-Code zu allen Ebenen-Seitenstile. Der eine entscheidende Unterschied
+ist: Befehle, die sich auf die Ebenen eines Seitenstils beziehen,
+beispielsweise \Macro{ForEachLayerOfPageStyle},
+\Macro{AddLayersToPageStyleBeforeLayer} oder
+\Macro{AddLayersToPageStyleAfterLayer} lassen die Ebenen des Seitenstils
+\Pagestyle{@everystyle@} unberücksichtigt, wenn sie auf einen anderen
+Ebenen-Seitenstil angewendet werden.
+
+Der zweite etwas andere Ebenen-Seitenstil ist \Pagestyle{empty}. Normalerweise
+wird bereits vom \LaTeX-Kern ein Seitenstil dieses Namens definiert. Dieser
+Seitenstil hat einen leeren Kopf und Fuß. Das Paket \Package{scrlayer}
+definiert diesen Seitenstil als Ebenen-Seitenstil ohne Ebenen
+um. Nichtsdestotrotz kann er wie jeder andere Ebenen-Seitenstil verwendet
+werden. Der Hauptvorteil dieses Ebenen-Seitenstils gegenüber dem
+ursprünglichen Seitenstil aus dem \LaTeX-Kern ist, dass er ebenfalls die Haken
+und Ebenen des Pseudo-Seitenstils \Pagestyle{@everystyle@} ausführt.%
+\EndIndex{Pagestyle}{empty}%
+\EndIndex{Pagestyle}{@everysel@}%
+
+
+\begin{Declaration}
+ \KOption{onpsselect}\PValue{Code}\\
+ \KOption{onpsinit}\PValue{Code}\\
+ \KOption{onpsoneside}\PValue{Code}\\
+ \KOption{onpstwoside}\PValue{Code}\\
+ \KOption{onpsoddpage}\PValue{Code}\\
+ \KOption{onpsevenpage}\PValue{Code}\\
+ \KOption{onpsfloatpage}\PValue{Code}\\
+ \KOption{onpsnonfloatpage}\PValue{Code}\\
+ \KOption{onpsbackground}\PValue{Code}\\
+ \KOption{onpsforeground}\PValue{Code}
+\end{Declaration}
+\BeginIndex{Option}{onpsselect~=\PName{Code}}%
+\BeginIndex{Option}{onpsinit~=\PName{Code}}%
+\BeginIndex{Option}{onpsoneside~=\PName{Code}}%
+\BeginIndex{Option}{onpstwoside~=\PName{Code}}%
+\BeginIndex{Option}{onpsoddpage~=\PName{Code}}%
+\BeginIndex{Option}{onpsevenpage~=\PName{Code}}%
+\BeginIndex{Option}{onpsfloatpage~=\PName{Code}}%
+\BeginIndex{Option}{onpsnonfloatpage~=\PName{Code}}%
+\BeginIndex{Option}{onpsbackground~=\PName{Code}}%
+\BeginIndex{Option}{onpsforeground~=\PName{Code}}%
+Für jeden der Haken aus \autoref{tab:scrlayer.pagestyle.hooks} existiert
+außerdem eine \KOMAScript-Option. Die Namen der \KOMAScript-Optionen ähneln
+den Namen der Optionen für die Befehle zur Deklaration von
+Ebenen-Seitenstilen. Es wird lediglich ein »\texttt{ps}« nach dem
+»\texttt{on}« am Anfang des Namens eingefügt. Die Werte dieser
+\KOMAScript-Optionen werden als Anfangswerte für die entsprechenden Haken
+verwendet. Dieser Anfangswert wird dann um alle Werte, die dem entsprechenden
+Haken in der \PName{Optionenliste} der Deklarationsbefehle zugewiesen werden,
+erweitert. Der Anfangswert kann mit Hilfe der Anweisung
+\Macro{ModifyLayerPageStyleOptions}, die später in diesem Abschnitt erklärt
+wird, entfernt werden.%
+\EndIndex{Option}{onpsforeground~=\PName{Code}}%
+\EndIndex{Option}{onpsbackground~=\PName{Code}}%
+\EndIndex{Option}{onpsnonfloatpage~=\PName{Code}}%
+\EndIndex{Option}{onpsfloatpage~=\PName{Code}}%
+\EndIndex{Option}{onpsevenpage~=\PName{Code}}%
+\EndIndex{Option}{onpsoddpage~=\PName{Code}}%
+\EndIndex{Option}{onpstwoside~=\PName{Code}}%
+\EndIndex{Option}{onpsoneside~=\PName{Code}}%
+\EndIndex{Option}{onpsinit~=\PName{Code}}%
+\EndIndex{Option}{onpsselect~=\PName{Code}}%
+
+\begin{Declaration}
+ \KOption{deactivatepagestylelayers}\PName{Ein-Aus-Wert}\\
+ \Macro{ForEachLayerOfPageStyle}\Parameter{Seitenstil-Name}%
+ \Parameter{Code}
+\end{Declaration}
+\BeginIndex{Option}{deactivatepagestylelayers~=\PName{Ein-Aus-Wert}}%
+\BeginIndex{Cmd}{ForEachLayerOfPageStyle}%
+Solange die \KOMAScript-Option \Option{deactivatepagestylelayers} nicht
+aktiviert ist, kann mit \Macro{ForEachLayerOfPageStyle} für jede Ebene des
+Seitenstils mit dem Namen \PName{Seitenstil-Name} beliebiger \PName{Code}
+ausgeführt werden. Innerhalb von \PName{Code} dient dabei \PValue{\#1} als
+Platzhalter für den Namen der gerade abgearbeiteten Ebene.
+\begin{Example}
+ Angenommen, Sie wollen die Namen aller Ebenen des Seitenstils
+ \PValue{scrheadings} als Komma-separierte Liste, so können Sie dies mit
+\begin{lstcode}
+ \newcommand*\commaatlist{}
+ \ForEachLayerOfPageStyle{scrheadings}{%
+ \commaatlist#1\gdef\commaatlist{, }}
+ \let\commaatlist\relax
+\end{lstcode}
+ erreichen.
+\end{Example}
+Die Verwendung von \Macro{gdef} an Stelle von \Macro{def} ist im Beispiel
+notwendig, weil \PName{Code} innerhalb einer Gruppe ausgeführt wird, um
+unerwünschte Seiteneffekte zu minimieren. Die Anweisung \Macro{gdef} definiert
+\Macro{commaatlist} jedoch global um, so dass beim Aufruf des Codes für die
+nächste Ebene die Änderung Bestand hat.
+
+Diverse Anweisungen von \Package{scrlayer} setzen ebenfalls
+\Macro{ForEachLayerOfPageStyle} ein. Auch deren Funktion kann daher über die
+\KOMAScript-Option \Option{deactivatepagestylelayers} verändert werden. Diese
+Option kann daher verwendet werden, um alle Ebenen aller Seitenstile temporär
+zu deaktivieren oder zu verstecken.
+%
+\EndIndex{Cmd}{ForEachLayerOfPageStyle}%
+\EndIndex{Option}{deactivatepagestylelayers~=\PName{Ein-Aus-Wert}}%
+
+\begin{Declaration}
+ \Macro{AddLayersToPageStyle}%
+ \Parameter{Seitenstil-Name}\Parameter{Ebenenliste}\\
+ \Macro{AddLayersAtBeginOfPageStyle}%
+ \Parameter{Seitenstil-Name}\Parameter{Ebenenliste}\\
+ \Macro{AddLayersAtEndOfPageStyle}%
+ \Parameter{Seitenstil-Name}\Parameter{Ebenenliste}\\
+ \Macro{RemoveLayersFromPageStyle}%
+ \Parameter{Seitenstil-Name}\Parameter{Ebenenliste}%
+\end{Declaration}
+\BeginIndex{Cmd}{AddLayersToPageStyle}%
+\BeginIndex{Cmd}{AddLayersAtBeginOfPageStyle}%
+\BeginIndex{Cmd}{AddLayersAtEndOfPageStyle}%
+\BeginIndex{Cmd}{RemoveLayersFromPageStyle}%
+Diese Anweisungen können verwendet werden, um Ebenen zu einem Seitenstil
+hinzuzufügen oder davon zu entfernen. Der Seitenstil wird dabei über seinen
+\PName{Seitenstil-Name} referenziert. Die Ebenen werden in einer durch Komma
+separierten \PName{Ebenenliste} angegeben.
+
+Die Anweisungen \Macro{AddLayersToPageStyle} und
+\Macro{AddLayersAtEndOfPageStyle} fügen die Ebenen am Ende der Ebenenliste des
+Seitenstils ein. Logisch liegen die neu hinzugefügten Ebenen also über oder
+vor den bereits vorhandenen Ebenen, wobei Hintergrund-Ebenen natürlich
+weiterhin logisch hinter der Textebene und damit auch hinter allen
+Vordergrund-Ebenen liegen.
+
+Die Anweisung \Macro{AddLayersAtBeginOfPageStyle} fügt die Ebenen hingegen am
+Anfang der Ebenenliste des Seitenstils ein. Dabei werden die Ebenen in der
+Reihenfolge am Anfang eingefügt, in der sie auch in der \PName{Ebenenliste}
+stehen. Damit wird die Ebene, die ganz am Ende von \PName{Ebenenliste} steht,
+nach dem Einfügen die erste und damit die unterste oder hinterste Ebene
+(jeweils entweder der Vordergrund oder der Hintergrundebenen) sein.
+
+Der Versuch, mit Hilfe von \Macro{RemoveLayersFromPageStyle} Ebenen von einem
+Seitenstil zu entfernen, die gar nicht Teil des Seitenstils sind, wird
+ignoriert, führt also nicht zu einer Fehlermeldung. Dagegen ist der Versuch,
+Ebenen zu einem Seitenstil, der kein Ebenen-Seitenstil ist und auch kein
+Alias-Seitenstil, der zu einem Ebenen-Seitenstil führt, hinzuzufügen oder von
+einem solchen zu entfernen ein Fehler und wird als solcher gemeldet.%
+\EndIndex{Cmd}{RemoveLayersFromPageStyle}%
+\EndIndex{Cmd}{AddLayersAtEndOfPageStyle}%
+\EndIndex{Cmd}{AddLayersAtBeginOfPageStyle}%
+\EndIndex{Cmd}{AddLayersToPageStyle}%
+
+\begin{Declaration}
+ \Macro{AddLayersToPageStyleBeforeLayer}%
+ \Parameter{Seitenstil-Name}\Parameter{Ebenenliste}%
+ \Parameter{Referenzebenen-Name}\\
+ \Macro{AddLayersToPageStyleAfterLayer}%
+ \Parameter{Seitenstil-Name}\Parameter{Ebenenliste}%
+ \Parameter{Referenzebenen-Name}%
+\end{Declaration}
+\BeginIndex{Cmd}{AddLayersToPageStyleBeforeLayer}%
+\BeginIndex{Cmd}{AddLayersToPageStyleAfterLayer}%
+Diese beiden Befehle ähneln den vorangegangenen. Allerdings wird hier
+zusätzlich ein \PName{Referenzebenen-Name} angegeben. Die Ebenen des über den
+\PName{Seitenstil-Name} angegebenen Seitenstils werden nach dieser
+Referenzebene durchsucht. Die Ebenen der \PName{Ebenenliste} werden dann vor
+respektive nach jedem Auf"|treten der Referenzebene in die Ebenen des
+Seitenstils eingefügt. Dabei bleibt die Reihenfolge der Ebenen der
+\PName{Ebenenliste} erhalten.%|
+
+Ist die Referenzebene nicht Bestandteil des Seitenstils, so wird auch nichts
+eingefügt. Ist der Seitenstil hingegen kein Ebenen-Seitenstil und auch kein
+Alias-Seitenstil, der zu einem Ebenen-Seitenstil führt, so wird ein Fehler
+gemeldet.%
+\EndIndex{Cmd}{AddLayersToPageStyleAfterLayer}%
+\EndIndex{Cmd}{AddLayersToPageStyleBeforeLayer}%
+
+\begin{Declaration}
+ \Macro{UnifyLayersAtPageStyle}\Parameter{Seitenstil-Name}
+\end{Declaration}
+\BeginIndex{Cmd}{UnifyLayersAtPageStyle}%
+Bei den Befehlen zur Definition eines Seitenstils oder zum Hinzufügen von
+Ebenen zu einem Seitenstil wird nicht darauf geachtet, ob eine Ebene mehrfach
+Bestandteil eines Seitenstils ist oder wird. Dies ist also durchaus
+zulässig. In den meisten Fällen hat es allerdings keinen Sinn, eine Ebene
+mehrfach als Bestandteil eines Seitenstils zu haben. Daher kann mit Hilfe von
+\Macro{UnifyLayersAtPageStyle} dafür gesorgt werden, dass alle
+Ebenen-Dubletten vom Seitenstil mit dem angegebenen \PName{Seitenstil-Name}
+entfernt werden.
+
+Es ist zu beachten\textnote{Achtung!}, dass sich dabei die Reihenfolge der
+Ebenen ändern kann. Wird also eine spezielle Reihenfolge gewünscht, sollten
+stattdessen alle Ebenen entfernt und die gewünschten Ebenen in der erwarteten
+Reihenfolge neu hinzugefügt werden. \Macro{UnifyLayersAtPageStyle} ist in einem
+solchen Fall also nicht geeignet.%
+\EndIndex{Cmd}{UnifyLayersAtPageStyle}%
+
+\begin{Declaration}
+ \Macro{ModifyLayerPageStyleOptions}%
+ \Parameter{Seitenstil-Name}\Parameter{Optionenliste}\\
+ \Macro{AddToLayerPageStyleOptions}%
+ \Parameter{Seitenstil-Name}\Parameter{Optionenliste}%
+\end{Declaration}
+\BeginIndex{Cmd}{ModifyLayerPageStyleOptions}%
+\BeginIndex{Cmd}{AddToLayerPageStyleOptions}%
+Mit diesen beiden Anweisungen können die Optionen und damit die Haken eines
+Ebenen-Seitenstils nachträglich verändert werden. Bei
+\Macro{ModifyLayerPageStyleOptions} werden dabei genau die Optionen, die in
+der durch Komma separierten \PName{Optionenliste} angegeben sind auf die
+dortigen neuen Werte gesetzt. Die bisherigen Werte gehen dabei verloren. Es
+sind alle Optionen aus \autoref{tab:scrlayer.pagestyle.hooks},
+\autopageref{tab:scrlayer.pagestyle.hooks} erlaubt. Optionen beziehungsweise
+Haken, die nicht in der \PName{Optionenliste} angegeben sind, bleiben hingegen
+unverändert. Diese Anweisung ist damit auch die einzige Möglichkeit, die
+globalen Voreinstellungen der \KOMAScript-Optionen von einem Seitenstil zu
+entfernen.
+
+Die Anweisung \Macro{AddToLayerPageStyleOptions} unterscheidet sich insofern,
+als die neuen Werte die bisher vorhandenen Werte nicht überschreiben, sondern
+diesen hinzugefügt oder -- genauer gesagt -- an diese angehängt werden.%
+\EndIndex{Cmd}{AddToLayerPageStyleOptions}%
+\EndIndex{Cmd}{ModifyLayerPageStyleOptions}%
+
+\begin{Declaration}
+ \Macro{IfLayerPageStyleExists}%
+ \Parameter{Seitenstil-Name}\Parameter{Dann-Code}\Parameter{Sonst-Code}\\
+ \Macro{IfRealLayerPageStyleExists}%^
+ \Parameter{Seitenstil-Name}\Parameter{Dann-Code}\Parameter{Sonst-Code}%
+\end{Declaration}
+\BeginIndex{Cmd}{IfLayerPageStyleExists}%
+\BeginIndex{Cmd}{IfRealLayerPageStyleExists}%
+Mit diesen Anweisungen kann Code in Abhängigkeit davon ausgeführt werden, ob
+ein Seitenstil ein Ebenen-Seitenstil ist oder nicht. Dabei führt
+\Macro{IfLayerPageStyleExists} den \PName{Dann-Code} nur dann aus, wenn
+\PName{Seitenstil-Name} der Name eines Ebenen-Seitenstils oder der Name eines
+Alias-Seitenstils ist, der zu einem Ebenen-Seitenstil führt. Anderenfalls
+führt die Anweisung den \PName{Sonst-Code} aus.
+
+Die Anweisung \Macro{IfRealLayerPageStyleExists} geht einen Schritt weiter und
+führt den \PName{Dann-Code} nur dann aus, wenn der über
+\PName{Seitenstil-Name} angegebene Seitenstil selbst ein Ebenen-Seitenstil
+ist. Im Falle eines Alias-Seitenstils führt diese Anweisung also selbst dann
+\PName{Sonst-Code} aus, wenn dieser Alias-Seitenstil zu einem
+Ebenen-Seitenstil führt.%
+\EndIndex{Cmd}{IfRealLayerPageStyleExists}%
+\EndIndex{Cmd}{IfLayerPageStyleExists}%
+
+\begin{Declaration}
+ \Macro{IfLayerAtPageStyle}%
+ \Parameter{Seitenstil-Name}\Parameter{Ebenen-Name}%
+ \Parameter{Dann-Code}\Parameter{Sonst-Code}\\
+ \Macro{IfSomeLayersAtPageStyle}%
+ \Parameter{Seitenstil-Name}\Parameter{Ebenenliste}%
+ \Parameter{Dann-Code}\Parameter{Sonst-Code}\\
+ \Macro{IfLayersAtPageStyle}%
+ \Parameter{Seitenstil-Name}\Parameter{Ebenenliste}%
+ \Parameter{Dann-Code}\Parameter{Sonst-Code}%
+\end{Declaration}
+\BeginIndex{Cmd}{IfLayerAtPageStyle}%
+\BeginIndex{Cmd}{IfSomeLayersAtPageStyle}%
+\BeginIndex{Cmd}{IfLayersAtPageStyle}%
+Mit diesen Anweisungen kann überprüft werden ob ein oder mehrere Ebenen
+Bestandteil eines Seitenstils sind. Anweisung \Macro{IfLayerAtPageStyle}
+erwartet dabei nach dem \PName{Seitenstil-Name} im ersten Argument im zweiten
+Argument genau einen \PName{Ebenen-Name}. Ist die entsprechende Ebene
+Bestandteil des Seitenstils, so wird der \PName{Dann-Code} ausgeführt,
+anderenfalls der \PName{Sonst-Code}.
+
+Die Anweisungen \Macro{IfSomeLayersAtPageStyle} und
+\Macro{IfLayersAtPageStyle} erlauben hingegen im zweiten Argument eine durch
+Komma separierte \PName{Ebenenliste}. Dabei führt
+\Macro{IfSomeLayersAtPageStyle} den \PName{Dann-Code} bereits aus, wenn
+\emph{mindestens eine} der Ebenen Bestandteil des Seitenstils ist. Dagegen
+führt \Macro{IfLayersAtPageStyle} den \PName{Dann-Code} nur aus, wenn
+\emph{alle} Ebenen Bestandteil des Seitenstils sind. Ist die Bedingung nicht
+erfüllt, so wird jeweils \PName{Sonst-Code} ausgeführt.
+
+Durch geeignete Schachtelung sind auch komplexe Bedingungen abbildbar. Gibt
+man statt einer \PName{Ebenenliste} jeweils nur einen \PName{Ebenen-Name} an,
+so sind alle drei Anweisungen gleichbedeutend.%
+\EndIndex{Cmd}{IfLayersAtPageStyle}%
+\EndIndex{Cmd}{IfSomeLayersAtPageStyle}%
+\EndIndex{Cmd}{IfLayerAtPageStyle}%
+
+\begin{Declaration}
+ \Macro{DestroyRealLayerPageStyle}\Parameter{Ebenen-Seitenstil-Name}
+\end{Declaration}
+\BeginIndex{Cmd}{DestroyRealLayerPageStyle}%
+Mit dieser Anweisung kann ein Ebenen-Seitenstil aus \LaTeX-Sicht wieder
+undefiniert werden. Dies gilt jedoch nur, wenn es einen Ebenen-Seitenstil mit
+dem Namen \PName{Ebenen-Seitenstil-Name} auch tatsächlich gibt. Handelt es sich
+stattdessen um einen Alias-Seitentstil -- auch wenn dieser zu einem
+Ebenen-Seitenstil führt -- oder um einen anderen Seitenstil oder ist gar kein
+Seitenstil mit dem Namen \PName{Ebenen-Seitenstil-Name} bekannt, so geschieht
+nichts, die Anweisung wird ignoriert.
+
+Falls \PName{Ebenen-Seitenstil-Name} der Name des aktuellen Seitenstils ist, so
+wird der aktuelle Seitenstil auf eine Art leerer Seitenstil gesetzt. Falls der
+Spezial-Seitenstil, der durch \Macro{thispagestyle} gesetzt wurde, auf
+\PName{Ebenen-Seitenstil-Name} lautet, so wird dieser einfach nur
+zurückgesetzt. Die vorherige Anweisung \Macro{thispagestyle} verliert damit
+ihre aktuelle Auswirkung.
+
+Es ist zu beachten\textnote{Achtung!}, dass die Ebenen des Seitenstils nicht
+automatisch mit vernichtet werden. Falls Sie die Ebenen ebenfalls vernichten
+möchten, so können Sie dies beispielsweise mit:
+\begin{lstcode}[belowskip=\dp\strutbox]
+ \ForEachLayerOfPageStyle{...}{\DestroyLayer{#1}}
+\end{lstcode}
+vor der Vernichtung des Seitenstils selbst erreichen.
+
+Die Anweisung ist dazu gedacht innerhalb der automatischen Entfernung einer
+Endanwender-Schnittstelle verwendet zu werden. Siehe
+\autoref{sec:scrlayer.enduserinterfaces} für weitere Informationen zu diesem
+Thema.%
+\EndIndex{Cmd}{DestroyRealLayerPageStyle}%
+
+\LoadCommon{20} % \section{Höhe von Kopf und Fuß}
+
+\LoadCommon{21} % \section{Beeinflussung der Inhalte von Seitenstilen}
+
+\section{Definition und Verwaltung von Schnittstellen für Endanwender}
+\label{sec:scrlayer.enduserinterfaces}
+
+Das Paket \Package{scrlayer} stellt eine Benutzerschnittstelle zur Verfügung
+um (konkurrierende) Schnittstellen für Endanwender definieren und verwalten zu
+können. Möglicherweise wird diese Schnittstelle langfristig wieder aus
+\Package{scrlayer} verschwinden und dann stattdessen von \Package{scrbase}
+übernommen werden. Derzeit ist diese Schnittstelle aber noch hoch
+experimentell und wird daher von eigenen Befehlen innerhalb von
+\Package{scrlayer} nur für Unterpakete von \Package{scrlayer} bereit
+gestellt. Es empfiehlt sich derzeit nicht, sich darauf zu verlassen, dass die
+automatische Entfernung einer konkurrierenden Schnittstelle
+funktioniert. Stattdessen sollte die Verwendung konkurrierender Schnittstellen
+vermieden werden.
+
+Dieser Abschnitt beschreibt lediglich die Schnittstellen-Anweisungen für die
+Definition einer Endanwender-Schnittstelle. Für Endanwender selbst ist es
+damit von geringem Interesse. Vielmehr richtet sich dieser Teil der Anleitung
+an Autoren von Paketen und Klassen, die auf \Package{scrlayer}
+aufbauen. Endanwender finden Informationen zu konkreten
+Endanwender-Schnittstellen in \autoref{cha:scrlayer-scrpage},
+\autoref{cha:scrlayer-scrpage-experts} und \autoref{cha:scrlayer-notecolumn}.
+
+\begin{Declaration}
+ \Macro{scrlayerInitInterface}\OParameter{Schnittstellen-Name}
+\end{Declaration}
+\BeginIndex{Cmd}{scrlayerInitInterface}%
+Mit dieser Anweisung wird eine neue Schnittstelle mit dem Namen
+\PName{Schnittstellen-Name} registriert. Das Argument
+\PName{Schnittstellen-Name} muss einzigartig sein. Das bedeutet, dass eine
+Schnittstelle gleichen Namens noch nicht registriert sein darf. Sollte dies
+doch der Fall sein, so wird ein Fehler ausgegeben.
+
+Diese Anweisung sollte immer ganz am Anfang einer Endanwender-Schnittstelle
+stehen. Daher wird sie hier auch zuerst erklärt. Wird das optionale Argument
+-- einschließlich der eckigen Klammern -- weg gelassen, so wird dafür
+\PValue{\Macro{@currname}.\Macro{@currext}} verwendet. Für Klassen und
+Pakete ist dies der Dateiname der Klasse respektive des Pakets. Aber
+selbstverständlich kann jede andere Zeichenfolge der Kategorie \emph{letter}
+oder \emph{other} verwendet werden. Dies ist beispielsweise sinnvoll, wenn
+eine Klasse oder ein Paket mehrere Endanwender-Schnittstellen definiert.%
+\EndIndex{Cmd}{scrlayerInitInterface}%
+
+\begin{Declaration}
+ \KOption{forceoverwrite}\PName{Ein-Aus-Wert}\\
+ \KOption{autoremoveinterfaces}\PName{Ein-Aus-Wert}\\
+ \Macro{scrlayerAddToInterface}%
+ \OParameter{Schnittstellen-Name}\Parameter{Befehl}\Parameter{Code}\\
+ \Macro{scrlayerAddCsToInterface}%
+ \OParameter{Schnittstellen-Name}\Parameter{Befehlssequenz}\Parameter{Code}
+\end{Declaration}
+\BeginIndex{Option}{forceoverwrite}%
+\BeginIndex{Option}{autoremoveinterfaces}%
+\BeginIndex{Cmd}{scrlayerAddToInterface}%
+\BeginIndex{Cmd}{scrlayerAddCsToInterface}%
+Eine der besonderen Eigenschaften der Endanwender-Schnittstellen von
+\Package{scrlayer} ist es, dass die Schnittstelle verwendete Befehle (auch
+bekannt als \emph{Makros} oder engl. \emph{macros}) registrieren sollte. Dies
+kann mit \Macro{scrlayerAddToInterface} erfolgen. Das optionale Argument
+\PName{Schnittstellen-Name} entspricht hier dem Namen, der mit
+\Macro{scrlayerInitInterface} zuvor registriert wurde.
+
+Werden\textnote{Achtung!} Anweisungen nicht nur während des Ladens einer
+Klasse oder eines Pakets, sondern auch zur Laufzeit definiert, so ist das
+optionale Argument auch dann zu verwenden, wenn es dem Dateinamen der Klasse
+beziehungsweise des Pakets entspricht, da die Werte von \Macro{@currname} und
+\Macro{@currext} nur während des Ladens Gültigkeit besitzen.
+
+Das erste obligatorische Argument ist der \PName{Befehl}\footnote{\PName{Befehl}
+ besteht aus einem umgekehrten Schrägstrich (engl. \emph{backslash}) gefolgt
+ von einer \PName{Befehlssequenz}, die entweder aus Zeichen der
+ Kategorie \emph{letter} oder aus genau einem Zeichen der Kategorie
+ \emph{other} besteht, oder aus einem Zeichen der Kategorie \texttt{active}
+ (ohne umgekehrten Schrägstrich davor).}, der zu der
+Endanwender-Schnittstelle hinzugefügt werden soll. Falls der Befehl
+definiert werden kann, erfolgt dies. Außerdem wird dann der Befehl auf
+\Macro{relax} gesetzt und \PName{Code} wird ausgeführt. Innerhalb von
+\PName{Code} kann der \PName{Befehl} dann beispielsweise mit Hilfe von
+\Macro{newcommand}\PName{Befehl} definiert werden.
+
+Wann aber kann ein \PName{Befehl} definiert werden? Ist ein \PName{Befehl}
+undefiniert oder \Macro{relax}, so kann er immer definiert werden. Wurde ein
+\PName{Befehl} bereits definiert \emph{und} für eine andere
+Endanwender-Schnittstelle registriert \emph{und} wurde die \KOMAScript-Option
+\Option{autoremoveinterface} aktiviert, so wird diese andere
+Endanwender-Schnittstelle automatisch entfernt, der \PName{Befehl} auf
+\Macro{relax} gesetzt und für die angegebene neue Endanwender-Schnittstelle
+registriert. Damit ist \PName{Befehl} auch dann definierbar. Falls ein
+\PName{Befehl} bereits definiert ist, \emph{aber nicht} Teil einer anderen
+Endanwender-Schnittstelle ist, \emph{und} falls die \KOMAScript-Option
+\Option{forceoverwrite} aktiviert wurde, wird \PName{Befehl} ebenfalls
+\Macro{relax} und für die angegebene Endanwender-Schnittstelle
+registriert. Der \PName{Befehl} ist also auch in diesem Fall definierbar. In
+allen anderen Fällen ist er jedoch nicht definierbar, also insbesondere, falls
+er bereits definiert ist und die \KOMAScript-Optionen
+\Option{autoremoveinterface} und \Option{forceoverwrite} deaktiviert sind.
+
+Die Anweisung \Macro{scrlayerAddCsToInterface} arbeitet ganz ähnlich der
+vorgenannten Anweisung \Macro{scrlayerAddToInterface}. Allerdings erwartet sie
+als erstes Argument keinen \PName{Befehl}, sondern eine
+\PName{Befehlssequenz}\footnote{Eine \PName{Befehlssequenz} muss voll
+ expandierbar sein und ihre Expansion muss zu Zeichen der Kategorie
+ \emph{letter}, \emph{other} oder \emph{space} führen.}.%
+%
+\EndIndex{Cmd}{scrlayerAddCsToInterface}%
+\EndIndex{Cmd}{scrlayerAddToInterface}%
+\EndIndex{Option}{autoremoveinterfaces}%
+\EndIndex{Option}{forceoverwrite}%
+
+\begin{Declaration}
+ \Macro{scrlayerOnAutoRemoveInterface}%^^A
+ \OParameter{Schnittstellen-Name}\Parameter{Code}
+\end{Declaration}
+\BeginIndex{Cmd}{scrlayerOnAutoRemoveInterface}%
+Für den Fall, dass die Endanwender-Schnittstelle namens
+\PName{Schnittstellen-Name} automatisch entfernt wird (siehe
+\KOMAScript-Option \Option{autoremoveinterface} zuvor in diesem Abschnitt)
+kann zusätzlich \PName{Code} ausgeführt werden. Dies kann beispielsweise
+verwendet werden, um Ebenen oder Seitenstile automatisch mit zu vernichten
+(siehe \Macro{DestroyLayer}, \Macro{DestroyAliasPageStyle}, and
+\Macro{DestroyRealLayerPageStyle}), die auf Befehlen der
+Endanwender-Schnittstelle beruhen. Bezüglich des optionalen Arguments
+\PName{Schnittstellen-Name} sei auf die Erklärung zu
+\Macro{scrlayerInitInterface} verwiesen.%
+\EndIndex{Cmd}{scrlayerOnAutoRemoveInterface}%
+%
+\EndIndex{Package}{scrlayer}%
+
+%%% Local Variables:
+%%% mode: latex
+%%% mode: flyspell
+%%% coding: iso-latin-1
+%%% ispell-local-dictionary: "de_DE"
+%%% TeX-master: "../guide"
+%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex
index ea00f9fa9b3..c7dfe74b3f1 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlfile.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlfile.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ============================================================================
-\ProvidesFile{scrlfile.tex}[2012/02/25 KOMA-Script guide (chapter: scrlfile)]
+\KOMAProvidesFile{scrlfile.tex}
+ [$Date: 2013-11-24 10:49:38 +0100 (So, 24. Nov 2013) $
+ KOMA-Script guide (chapter: scrlfile)]
\chapter{Paketabhängigkeiten mit \Package{scrlfile}
beherrschen}
@@ -605,6 +607,28 @@ mit Hilfe von \Macro{RequirePackage} vor der Klasse zu laden.
\EndIndex{Cmd}{ReplacePackage}%
\EndIndex{Cmd}{ReplaceClass}%
+\begin{Declaration}
+ \Macro{UnReplaceInput}\Parameter{Dateinamen}\\
+ \Macro{UnReplacePackage}\Parameter{Paket}\\
+ \Macro{UnReplaceClass}\Parameter{Klasse}%
+\end{Declaration}
+\BeginIndex{Cmd}{UnReplaceInput}%
+\BeginIndex{Cmd}{UnReplacePackage}%
+\BeginIndex{Cmd}{UnReplaceClass}%
+Eine\ChangedAt{v3.12}{\Package{scrlfile}} Ersetzung kann auch wieder
+aufgehoben werden. Dabei sollten Ersetzungen von Dateien immer mit
+\Macro{UnReplaceInput}, Ersetzungen von Paketen mit \Macro{UnReplacePackage}
+und Ersetzungen von Klassen mit \Macro{UnReplaceClass} aufgehoben werden. Nach
+der Aufhebung der Ersetzung führen Ladebefehle für den entsprechenden
+\PName{Dateiname}, das entsprechende \PName{Paket} oder die entsprechende
+\PName{Klasse} dann wieder dazu, dass die Datei, das Paket oder die Klasse
+selbst an Stelle der Ersatzdatei, des Ersatzpakets oder der Ersatzklasse
+geladen wird.%
+\EndIndex{Cmd}{UnReplaceClass}%
+\EndIndex{Cmd}{UnReplacePackage}%
+\EndIndex{Cmd}{UnReplaceInput}%
+
+
\section{Dateien gar nicht erst einlesen}
\label{sec:scrlfile.prevent}
@@ -616,9 +640,13 @@ zu einem Problem kommt, muss man irgendwie das Laden des problematischen Paketes
verhindern. Auch hier bietet \Package{scrlfile} eine einfache Lösung.
\begin{Declaration}
- \Macro{PreventPackageFromLoading}\Parameter{Paketliste}
+ \Macro{PreventPackageFromLoading}\OParameter{Stattdessencode}%
+ \Parameter{Paketliste}\\
+ \Macro{PreventPackageFromLoading*}\OParameter{Stattdessencode}%
+ \Parameter{Paketliste}
\end{Declaration}
\BeginIndex{Cmd}{PreventPackageFromLoading}%
+\BeginIndex{Cmd}{PreventPackageFromLoading*}%
Wird diese Anweisung\ChangedAt{v3.08}{\Package{scrlfile}} vor dem
Laden eines Paket mit \Macro{usepackage}\IndexCmd{usepackage},
\Macro{RequirePackage}\IndexCmd{RequirePackage} oder
@@ -650,7 +678,22 @@ Wie im Beispiel zu sehen ist, kann man das Paket \Package{scrlfile} auch
bereits vor der Klasse laden. In diesem Fall muss das Laden dann aber mit
Hilfe von \Macro{RequirePackage}\IndexCmd{RequirePackage} erfolgen, da
\Macro{usepackage} vor \Macro{documentclass} verboten ist.
-%
+
+Wird eine leere \PName{Paketliste} angegeben, oder wird ein Paket angegeben,
+das bereits geladen ist, so gibt \Macro{PreventPackageFromLoading} eine
+Warnung aus, während
+\Macro{PreventPackageFromLoading*}\ChangedAt{v3.12}{\Package{scrlfile}}
+lediglich einen entsprechenden Hinweis in die Log-Datei schreibt.
+
+Das optionale Argument\ChangedAt{v3.12}{\Package{scrlfile}} kann verwendet
+werden, wenn an Stelle des Ladens des Pakets etwas anderes getan werden
+soll. Innerhalb des \PName{Stattdessencode}s dürfen jedoch keine anderen
+Pakete und keine Dateien geladen werden. Zum Laden eines anderen Pakets siehe
+\Macro{ReplacePackage} in \autoref{sec:scrlfile.macros} auf
+\autopageref{desc:scrlfile.cmd.ReplacePackage}. Beachten Sie bitte auch, dass
+der \PName{Stattdessencode} mehrfach ausgeführt wird, falls Sie versuchen,
+das Paket mehrfach zu laden!%
+\EndIndex{Cmd}{PreventPackageFromLoading*}%
\EndIndex{Cmd}{PreventPackageFromLoading}
\begin{Declaration}
@@ -699,14 +742,59 @@ An dieser Stelle sei darauf hingewiesen, dass Sie bei Manipulationen an der mit
\Macro{StorePreventPackageFromLoading} zwischengespeicherten Liste selbst die
Verantwortung für eine korrekte Wiederherstellbarkeit tragen. So muss die
Liste unbedingt mit Komma separiert sein, sollte keine Leerzeichen oder
-Gruppenklammern enthalten und muss voll expandierbar sein.
-%
+Gruppenklammern enthalten und muss voll expandierbar sein.%
+
+Beachten\textnote{Achtung!} Sie bitte auch, dass
+\Macro{ResetPreventPackageFromLoading} den \PName{Stattdessencode} für ein
+Paket nicht löscht, sondern nur vorübergehend dessen Ausführung nicht mehr
+erfolgt.%
\EndIndex{Cmd}{ResetPreventPackageFromLoading}%
\EndIndex{Cmd}{StorePreventPackageFromLoading}%
+
+\begin{Declaration}
+ \Macro{UnPreventPackageFromLoading}\Parameter{Paketliste}\\
+ \Macro{UnPreventPackageFromLoading*}\Parameter{Paketliste}
+\end{Declaration}
+\BeginIndex{Cmd}{UnPreventPackageFromLoading}%
+\BeginIndex{Cmd}{UnPreventPackageFromLoading*}%
+Statt\ChangedAt{v3.12}{\Package{scrlfile}} die Liste der Pakete, für die das
+Laden verhindert werden soll, komplett zurück zu setzen, kann man auch
+einzelne oder mehrere Pakete gezielt von dieser Liste entfernen. Die
+Sternvariante des Befehls löscht außerdem den \PName{Stattdessencode}, der für
+das Paket gespeichert ist. Falls die Verhinderungsliste beispielsweise aus
+einer gespeicherten Liste wiederhergestellt wird, wird dann der
+\PName{Stattdessencode} trotzdem nicht mehr ausgeführt.%
+%
+\begin{Example}
+ Angenommen, Sie wollen zwar verhindern, dass ein Paket \Package{foo}
+ geladen wird, wollen aber nicht, dass ein eventuell bereits gespeicherter
+ \PName{Stattdessencode} ausgeführt wird. Stattdessen soll nur Ihr neuer
+ \PName{Stattdessencode} ausgeführt werden. Dies ist wie folgt möglich:
+\begin{lstcode}
+ \UnPreventPackageFromLoading*{foo}
+ \PreventPackageFromLoading[\typeout{Stattdessencode}]{foo}
+\end{lstcode}
+ Sollte das Paket zuvor gar nicht vom Laden ausgenommen worden sein, so spielt
+ dies für die Anweisung \Macro{UnPreventPackageFromLoading*} keine Rolle.
+
+ Natürlich können Sie die Anweisung indirekt auch nutzen, um den
+ \PName{Stattdessencode} aller Pakete zu löschen:
+\begin{lstcode}
+ \StorePreventPackageFromLoading\TheWholePreventList
+ \UnPreventPackageFromLoading*{\TheWholePreventList}
+ \PreventPackageFromLoading{\TheWholePreventList}
+\end{lstcode}
+ Die Pakete werden dann zwar noch immer nicht geladen, ihr
+ \PName{Stattdessencode} existiert aber nicht mehr und wird nicht mehr
+ ausgeführt.%
+\end{Example}%
+\EndIndex{Cmd}{UnPreventPackageFromLoading*}%
+\EndIndex{Cmd}{UnPreventPackageFromLoading}%
%
\EndIndex{Package}{scrlfile}
%%% Local Variables:
%%% mode: latex
+%%% coding: iso-latin-1
%%% TeX-master: "../guide"
%%% End:
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex
index 8f1f41c862d..925f81c246b 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlttr2-experts.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlttr2-experts.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,7 @@
%
% ============================================================================
-\ProvidesFile{scrlttr2-experts.tex}[2012/03/01 KOMA-Script guide (chapter: scrlttr2 for experts)]
+\ProvidesFile{scrlttr2-experts.tex}[2013/10/04 KOMA-Script guide (chapter: scrlttr2 for experts)]
\chapter{Zusätzliche Informationen zur
Briefklasse \Class{scrlttr2}}
@@ -85,6 +85,12 @@ Längen in \Class{scrlttr2} eben nicht in Längen, sondern in Makros abgelegt,
den Pseudolängen. Der Nachteil dieses Vorgehens besteht darin, dass man mit
diesen Makros nicht so einfach rechnen kann wie mit echten Längen.
+Bitte beachten\textnote{Achtung!} Sie unbedingt, dass die Pseudolängen zwar
+intern als Makros implementiert sind, bei den Befehlen zur Nutzung der
+Pseudolängen jedoch nur die Namen anzugeben sind. Diese werden wie die Namen
+von \LaTeX-Zählern und im Gegensatz zu Makros oder echten Längen ohne
+umgekehrten Schrägstrich geschrieben!
+
Wer nun einwenden will, dass \LaTeX{} in der empfohlenen und für \KOMAScript{}
benötigten Installation mit \eTeX{} inzwischen das oben genannte
Beschränkungsproblem nicht mehr besitzt, hat Recht. Allerdings kam diese
@@ -94,7 +100,7 @@ Eine Auf"|listung aller von \Class{scrlttr2} definierten und verwendeten
Pseudolängen ist \autoref{tab:scrlttr2-experts.pseudoLengths} zu
entnehmen. Dabei ist auch angegeben, wo in den nachfolgenden Unterabschnitten
nähere Erklärungen zu der jeweiligen Pseudolänge zu finden
-sind.
+sind.%|
\autoref{fig:scrlttr2-experts.pseudoLengths} auf
\autopageref{fig:scrlttr2-experts.pseudoLengths} zeigt eine schematische
@@ -134,17 +140,17 @@ auf einige weniger häufig benötigten Pseudolängen jedoch auch verzichtet.
Abstand des Brief"|fußes von der linken Kante des Papiers; Werte
größer der Breite oder kleiner der negativen Breite des Papiers werden
gesondert behandelt (\autoref{sec:scrlttr2-experts.firstFoot},
- \autopageref{desc:scrlttr2-experts.plength.firstfoothpos})%
+ \autopageref{desc:scrlttr2-experts.plength.firstfoothpos})%|
}%
\pentry{firstfootvpos}{%
Abstand des Brief"|fußes von der oberen Kante des Papiers
(\autoref{sec:scrlttr2-experts.firstFoot},
- \autopageref{desc:scrlttr2-experts.plength.firstfootvpos})%
+ \autopageref{desc:scrlttr2-experts.plength.firstfootvpos})%|
}%
\pentry{firstfootwidth}{%
Breite des Brief"|fußes
(\autoref{sec:scrlttr2-experts.firstFoot},
- \autopageref{desc:scrlttr2-experts.plength.firstfootwidth})%
+ \autopageref{desc:scrlttr2-experts.plength.firstfootwidth})%|
}%
\pentry{firstheadhpos}{%
Abstand des Briefkopfes von der linken Kante des Papiers; Werte
@@ -1463,8 +1469,8 @@ der \PName{Visualisierungsstil} \PValue{rule} zur Verfügung. Dabei wird das
Feld farbig hinterlegt. Hierbei kann nicht zwischen geschlossenen und nach
unten offenen Feldern unterschieden werden. Stattdessen werden nach unten
offene Felder mit einer Mindesthöhe dargestellt. Der
-dritte\important{\PValue{edge}} verfügbare \PName{Visualisierungsstil} ist
-\PValue{edge}. Dabei werden die Ecken der Felder markiert. Bei nach unten
+dritte\important{\PValue{edges}} verfügbare \PName{Visualisierungsstil} ist
+\PValue{edges}. Dabei werden die Ecken der Felder markiert. Bei nach unten
offenen Feldern entfallen dabei die unteren Eckmarkierungen. Die Größe der
Eckmarkierungen ist im Makro \Macro{edgesize} abgelegt und mit 1\Unit{ex}
voreingestellt.
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex
index 5d595de2c55..5cd5cce2ea5 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlttr2.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlttr2.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ============================================================================
-\ProvidesFile{scrlttr2.tex}[2012/01/01 KOMA-Script guide (chapter: scrlttr2)]
+\KOMAProvidesFile{scrlttr2.tex}%
+ [$Date: 2013-12-12 12:01:33 +0100 (Do, 12. Dez 2013) $
+ KOMA-Script guide (chapter: scrlttr2)]
\chapter{Die Briefklasse \Class{scrlttr2}}
\labelbase{scrlttr2}
@@ -97,8 +99,6 @@ nachfolgenden Abschnitten. \autoref{tab:scrlttr2.variables} gibt eine
Übersicht über alle in \Class{scrlttr2} definierten Variablen.
%
\begin{desclist}
- % Umbruchkorrektur
- \renewcommand*{\abovecaptionskipcorrection}{-\normalbaselineskip}%
\desccaption{Von der Klasse \Class{scrlttr2} unterstützte
Variablen\label{tab:scrlttr2.variables}} {Von der Klasse \Class{scrlttr2}
unterstützte Variablen (\emph{Fortsetzung})}
@@ -152,6 +152,10 @@ nachfolgenden Abschnitten. \autoref{tab:scrlttr2.variables} gibt eine
\ventry{fromlogo}{Anweisungen zum Setzen des Absenderlogos
(\autoref{sec:scrlttr2.firstpage},
\autopageref{desc:scrlttr2.variable.fromlogo})}%
+ \ventry{frommobilephone}{%
+ \ChangedAt{v3.12}{\Class{scrlttr2}}%
+ Handynummer des Absenders (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.frommobilephone})}%
\ventry{fromname}{vollständiger Absendername
(\autoref{sec:scrlttr2.firstpage},
\autopageref{desc:scrlttr2.variable.fromname})}%
@@ -169,6 +173,9 @@ nachfolgenden Abschnitten. \autoref{tab:scrlttr2.variables} gibt eine
\ventry{location}{erweiterte Absenderangabe
(\autoref{sec:scrlttr2.firstpage},
\autopageref{desc:scrlttr2.variable.location})}%
+ \ventry{mobilephoneseparator}{Trennzeichen zwischen Handybezeichner und
+ Handynummer (\autoref{sec:scrlttr2.firstpage},
+ \autopageref{desc:scrlttr2.variable.mobilephoneseparator})}%
\ventry{myref}{Geschäftszeilenfeld »Mein Zeichen«
(\autoref{sec:scrlttr2.firstpage},
\autopageref{desc:scrlttr2.variable.myref})}%
@@ -342,13 +349,14 @@ normale Variante den Inhalt behandelt.%
\label{sec:scrlttr2.pseudoLength}
\BeginIndex{}{Pseudolängen}
-Längen werden bei \LaTeX{} mit den Anweisungen \Macro{newlength},
-\Macro{setlength}, \Macro{addtolength} und \Macro{the}\PName{Länge}
-verarbeitet. Sehr viele Pakete nutzen aber auch Makros, also Anweisungen, um
-Längen zu speichern. \KOMAScript{} erweitert dieses Verfahren um die
-Möglichkeit, solche in Makros gespeicherten Längen mit ähnlichen Anweisungen
-zu verarbeiten wie echte Längen. Diese eigentlich in Makros abgelegten Längen
-heißen bei \KOMAScript{} daher Pseudolängen.
+Längen werden bei \LaTeX{} mit den drei Anweisungen
+\Macro{newlength}\IndexCmd{newlength}, \Macro{setlength}\IndexCmd{setlength}
+und \Macro{addtolength}\IndexCmd{addtolength} verarbeitet. Sehr viele Pakete
+nutzen aber auch Makros, also Anweisungen, um Längen zu
+speichern. \KOMAScript{} erweitert dieses Verfahren um die Möglichkeit, solche
+in Makros gespeicherten Längen mit ähnlichen Anweisungen zu verarbeiten wie
+echte Längen. Diese eigentlich in Makros abgelegten Längen heißen bei
+\KOMAScript{} daher Pseudolängen.
Eine Liste aller in \Class{scrlttr2} definierten Pseudolängen findet sich in
\autoref{tab:scrlttr2-experts.pseudoLengths},
@@ -368,6 +376,11 @@ Setzen von Pseudolängen eher dem fortgeschrittenen Anwender vorbehalten. Also
wird auch dies im Abschnitt für Experten ab
\autopageref{desc:scrlttr2-experts.cmd.@setplength} erklärt.
+Bitte beachten\textnote{Achtung!} Sie unbedingt, dass die Pseudolängen zwar
+intern als Makros implementiert sind, bei den Befehlen zur Nutzung der
+Pseudolängen jedoch nur die Namen anzugeben sind. Diese werden wie die Namen
+von \LaTeX-Zählern und im Gegensatz zu Makros oder echten Längen ohne
+umgekehrten Schrägstrich geschrieben!
\begin{Declaration}
\Macro{useplength}\Parameter{Name}
@@ -401,17 +414,25 @@ verwendet werden.%
Dies ist insbesondere dann lästig, wenn man einer echten
\PName{Länge} den Wert einer \PName{Pseudolänge} zuweisen will.
\end{Explain}
-Mit der Anweisung \Macro{setlengthtoplength} kann man einer echten
-\PName{Länge} das Vielfache einer \PName{Pseudolänge} zuweisen.
-Allerdings wird hier ein \PName{Faktor} nicht direkt der
-\PName{Pseudolänge} vorangestellt, sondern als optionales Argument
-übergeben. Man sollte diese Anweisung auch verwenden, wenn man einer
-\PName{Länge} den negativen Wert einer \PName{Pseudolänge} zuweisen
-will. Als \PName{Faktor} kann dann wahlweise ein Minuszeichen oder
-\PValue{-1} verwendet werden. Die Anweisung
-\Macro{addtolengthplength} arbeitet ganz ähnlich. Allerdings wird
-hier zur \PName{Länge} das Vielfache der \PName{Pseudolänge}
-addiert.%
+Mit der Anweisung
+\Macro{setlengthtoplength}\important{\Macro{setlengthtoplength}} kann man
+einer echten \PName{Länge} das Vielfache einer \PName{Pseudolänge} zuweisen.
+Allerdings wird hier ein \PName{Faktor} nicht direkt der \PName{Pseudolänge}
+vorangestellt, sondern als optionales Argument übergeben. Man sollte diese
+Anweisung auch verwenden, wenn man einer \PName{Länge} den negativen Wert
+einer \PName{Pseudolänge} zuweisen will. %
+\iffalse % Umbruchkorrektur
+ Als \PName{Faktor} kann dann wahlweise ein Minuszeichen oder \PValue{-1}
+ verwendet werden.
+%
+\else %
+ \PName{Faktor} ist dann \PValue{-1}.
+%
+\fi
+%
+Die Anweisung\important{\Macro{addtolengthplength}} \Macro{addtolengthplength}
+arbeitet ähnlich. Nur wird die mit \PName{Faktor} multiplizierte
+\PName{Pseudolänge} zur \PName{Länge} addiert.%
%
\EndIndex{Cmd}{setlengthtoplength}%
\EndIndex{Cmd}{addtolengthplength}%
@@ -422,7 +443,7 @@ addiert.%
\LoadCommon[scrlttr]{1} % \section{Kompatibilität zu früheren Versionen von \KOMAScript}
-\iffree{}{\vfill}% Umbruchoptimierung!
+%\iffree{}{\vfill}% Umbruchoptimierung!
\LoadCommon[scrlttr]{2} % \section{Entwurfsmodus}
@@ -704,14 +725,13 @@ gesetzt werden, so muss eben das Argument von \Macro{opening} leer bleiben.
\label{fig:scrlttr2.letter-0}
\end{figure}
\end{Example}
-\iffalse% Umbruchkorrekturtext
-
-Bei\textnote{Tipp!} maschinell erstellten Briefen wurde früher häufig auf
-eine Anrede verzichtet. Das lag daran, dass die Möglichkeiten für
-individualisierte Serienbriefe noch kaum vorhanden waren. Heute sind
-persönliche Anreden auch bei massenhaft erzeugten Werbebriefen üblich.%
+\iftrue % Umbruchkorrekturtext
+\begin{Explain}
+ Bei\textnote{Tipp!} maschinell erstellten Briefen wurde früher meist auf
+ eine Anrede verzichtet, da individualisierte Serienbriefe kaum möglich
+ waren. Heute sind persönliche Anreden auch bei Massensendungen üblich.%
+\end{Explain}%
\fi
-%
\EndIndex{Cmd}{opening}%
@@ -785,10 +805,12 @@ automatisch noch optional.
sehr beliebt. Es handelte sich bei diesen Nachsätzen ursprünglich um
Angaben, die im eigentlichen Brief vergessen wurden. Bei Briefen,
die mit \LaTeX{} geschrieben werden, ist es natürlich einfach,
- Vergessenes nachträglich in den Brief einzuarbeiten. Trotzdem ist
- das Postskriptum noch immer sehr beliebt, kann man damit doch sehr
- schön noch einmal auf ganz andere äußerst wichtige oder eigentlich
- ganz unwichtige Dinge hinweisen.
+ Vergessenes nachträglich in den Brief einzuarbeiten. %
+\iffalse % Umbruchkorrektur
+ Trotzdem ist das Postskriptum noch immer sehr beliebt, kann man damit doch
+ sehr schön noch einmal auf ganz andere äußerst wichtige oder eigentlich
+ ganz unwichtige Dinge hinweisen.%
+\fi
\end{Explain}
%
\EndIndex{Cmd}{ps}
@@ -915,121 +937,8 @@ hier von der \PName{Bezeichnung} und dem \PName{Inhalt} der Variablen
%
\EndIndex{}{Schrift>Groesse=Größe}
-
\LoadCommon[scrlttr]{5} % \section{Textauszeichnungen}
-Mit der Anweisung \Macro{usekomafont} kann die aktuelle Schriftart auf
-diejenige umgeschaltet werden, die für das angegebene \PName{Element}
-definiert ist.
-
-Ein allgemeines Beispiel für die Anwendung von \Macro{setkomafont} und
-\Macro{usekomafont} finden Sie in \autoref{sec:maincls.textmarkup},
-\autopageref{desc:maincls.setkomafont.example}.
-
-\begin{desclist}
- \desccaption{%
- Elemente, deren Schrift bei der Klasse \Class{scrlttr2} mit
- \Macro{setkomafont} und \Macro{addtokomafont} verändert werden
- kann\label{tab:scrlttr2.elementsWithoutText}%
- }{%
- Elemente, deren Schrift verändert werden kann (\emph{Fortsetzung})%
- }%
- \feentry{addressee}{Name und Anschrift im Anschriftfenster
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.option.addrfield})}%
- \feentry{backaddress}{Rücksendeadresse für einen Fensterbriefumschlag
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.option.backaddress})}%
- \feentry{descriptionlabel}{Label, also das optionale Argument von
- \Macro{item}, in einer \Environment{description}-Umgebung
- (\autoref{sec:scrlttr2.lists},
- \autopageref{desc:scrlttr2.env.description})}%
- \feentry{foldmark}{Faltmarke auf dem Briefpapier; ermöglicht Änderung der
- Linienfarbe (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.option.foldmarks})}%
- \feentry{footnote}{%
- Marke und Text einer Fußnote (\autoref{sec:scrlttr2.footnotes},
- \autopageref{desc:scrlttr2.cmd.footnote})}%
- \feentry{footnotelabel}{%
- Marke einer Fußnote; Anwendung erfolgt nach dem Element
- \FontElement{footnote} (\autoref{sec:scrlttr2.footnotes},
- \autopageref{desc:scrlttr2.cmd.footnote})}%
- \feentry{footnotereference}{%
- Referenzierung der Fußnotenmarke im Text
- (\autoref{sec:scrlttr2.footnotes},
- \autopageref{desc:scrlttr2.cmd.footnote})}%
- \feentry{footnoterule}{%
- Linie\ChangedAt{v3.07}{\Class{scrlttr2}} über dem Fußnotenapparat
- (\autoref{sec:scrlttr2.footnotes},
- \autopageref{desc:scrlttr2.cmd.setfootnoterule})}%
- \feentry{fromaddress}{Absenderadresse im Briefkopf
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.variable.fromaddress})}%
- \feentry{fromname}{Name des Absenders im Briefkopf abweichend von
- \PValue{fromaddress} (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.variable.fromname})}%
- \feentry{fromrule}{Linie im Absender im Briefkopf; gedacht für
- Farbänderungen (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.option.fromrule})}%
- \feentry{labelinglabel}{%
- Label, also das optionale Argument der \Macro{item}-Anweisung, und
- Trennzeichen, also das optionale Argument der
- \Environment{labeling}-Umgebung, in einer \Environment{labeling}-Umgebung
- (siehe \autoref{sec:scrlttr2.lists},
- \autopageref{desc:scrlttr2.env.labeling})}%
- \feentry{labelingseparator}{%
- Trennzeichen, also das optionale Argument der
- \Environment{labeling}-Umgebung, in einer \Environment{labeling}-Umgebung;
- Anwendung erfolgt nach dem Element \FontElement{labelinglabel} (siehe
- \autoref{sec:scrlttr2.lists}, \autopageref{desc:scrlttr2.env.labeling})}%
- \feentry{pagefoot}{%
- wird nach dem Element \FontElement{pageheadfoot} für den mit Variable
- \Variable{nextfoot}\IndexVariable{nextfoot} definieren Seitenfuß verwendet
- oder wenn das Paket \Package{scrpage2} geladen ist (\autoref{cha:scrpage},
- \autopageref{desc:scrpage.fontelement.pagefoot})}%
- \feentry{pagehead}{%
- alternative Bezeichnung für \FontElement{pageheadfoot}}%
- \feentry{pageheadfoot}{%
- Seitenkopf und Seitenfuß bei allen von \KOMAScript{} definierten
- Seitenstilen (\autoref{sec:scrlttr2.pagestyle},
- \autopageref{desc:scrlttr2.fontelement.pageheadfoot})}%
- \feentry{pagenumber}{%
- Seitenzahl im Kopf oder Fuß der Seite (\autoref{sec:scrlttr2.pagestyle},
- \autopageref{desc:scrlttr2.fontelement.pagenumber})}%
- \feentry{pagination}{%
- alternative Bezeichnung für \FontElement{pagenumber}}%
- \feentry{refname}{%
- Bezeichnung der Felder in der Geschäftszeile
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.variable.yourref})}%
- \feentry{refvalue}{%
- Werte der Felder in der Geschäftszeile (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.variable.yourref})}%
- \feentry{specialmail}{Versandart im Anschriftfenster
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.variable.specialmail})}%
- \feentry{subject}{Betreff in der Brieferöffnung
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.variable.subject})}%
- \feentry{title}{Titel in der Brieferöffnung
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.variable.title})}%
- \feentry{toaddress}{Abweichung vom Element \FontElement{addressee} für die
- Anschrift (ohne Name) des Empfängers im Anschriftfeld
- (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.variable.toaddress})}%
- \feentry{toname}{Abweichung vom Element \FontElement{addressee} für den
- Namen des Empfängers im Anschriftfeld (\autoref{sec:scrlttr2.firstpage},
- \autopageref{desc:scrlttr2.variable.toname})}%
-\end{desclist}
-%
-\EndIndex{Cmd}{setkomafont}%
-\EndIndex{Cmd}{addtokomafont}%
-\EndIndex{Cmd}{usekomafont}%
-%
-\EndIndex{}{Schrift>Art}%
-\EndIndex{}{Text>Auszeichnung}
-
\section{Briefbogen}
\label{sec:scrlttr2.firstpage}
\BeginIndex{}{Briefbogen}
@@ -1066,7 +975,6 @@ Briefseiten abgesehen von der ersten.
\KOption{foldmarks}\PName{Einstellung}
\end{Declaration}
\BeginIndex{Option}{foldmarks~=\PName{Einstellung}}%
-\looseness=-1 % Umbruchkorrektur
Falt- oder Falzmarken sind kleine horizontale Striche am linken und kleine
vertikale Striche am oberen Rand. \KOMAScript{} unterstützt für den Briefbogen
derzeit drei konfigurierbare horizontale und eine konfigurierbare vertikale
@@ -1133,7 +1041,7 @@ abhängig. Voreingestellt sind \PValue{true} und \PValue{TBMPL}.
abschalten. Wenn die Voreinstellung zuvor noch nicht geändert wurde, können
Sie das Abschalten wie folgt erreichen:
\begin{lstcode}
- \KOMAoption{foldmarks=blmt}
+ \KOMAoptions{foldmarks=blmt}
\end{lstcode}
Besteht die Möglichkeit, dass die Voreinstellung bereits geändert wurde, so
sollten Sie lieber auf Nummer Sicher gehen. Unser Beispiel ist dann
@@ -1168,16 +1076,25 @@ keine Änderung.%
\KOption{enlargefirstpage}\PName{Ein-Aus-Wert}
\end{Declaration}
\BeginIndex{Option}{enlargefirstpage~=\PName{Ein-Aus-Wert}}%
-Die erste Seite eines Briefes fällt immer aus dem normalen Satzspiegel. Von
-\Class{scrlttr2} werden Mechanismen bereitgestellt, um die Höhe und vertikale
-Ausrichtung von Kopf und Fuß der ersten Seite unabhängig von den Folgeseiten
-zu bestimmen. Würde dadurch der Fuß der ersten Seite in den
-Textbereich\Index{Text>Bereich} ragen, so wird der Textbereich der ersten Seite
-automatisch mit Hilfe von \Macro{enlargethispage}\IndexCmd{enlargethispage}
-verkleinert. Soll der Textbereich umgekehrt auch vergrößert werden, falls der
-Fuß der ersten Seite dies erlaubt, so kann das mit dieser Option erreicht
-werden. Es passt dann bestenfalls etwas mehr Text auf die erste Seite. Siehe
-hierzu auch die Erklärung zur Pseudolänge \PLength{firstfootvpos} auf
+\begin{Explain}
+ Die erste Seite eines Briefes fällt %
+ \iftrue % Umbruchkorrektur
+ aufgrund der vielen Konsultationselemente wie dem Briefkopf oder der
+ Anschrift
+ %
+ \fi %
+ immer aus dem normalen Satzspiegel. Von \Class{scrlttr2} werden Mechanismen
+ bereitgestellt, um die Höhe und vertikale Ausrichtung von Kopf und Fuß der
+ ersten Seite unabhängig von den Folgeseiten zu bestimmen. Würde dadurch der
+ Fuß der ersten Seite in den Textbereich\Index{Text>Bereich} ragen, so wird
+ der Textbereich der ersten Seite automatisch mit Hilfe von
+ \Macro{enlargethispage}\IndexCmd{enlargethispage} verkleinert.
+\end{Explain}
+Soll der Textbereich auch automatisch mit \Macro{enlargethispage} vergrößert
+werden, falls der Fuß der ersten Seite dies erlaubt, so kann das mit dieser
+Option erreicht werden. Es passt dann bestenfalls etwas mehr Text auf die
+erste Seite. Siehe hierzu auch die Erklärung zur Pseudolänge
+\PLength{firstfootvpos} auf
\autopageref{desc:scrlttr2-experts.plength.firstfootvpos}. Als
\PName{Ein-Aus-Wert} kann dabei einer der Standardwerte für einfache Schalter
aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet
@@ -1338,7 +1255,11 @@ können, um etwa Grau an Stelle von Schwarz zu verwenden. Siehe hierzu
\EndIndex{FontElement}{fromaddress}%
\begin{Example}
- Geben wir nun dem Absender aus den bisherigen Beispielen einen Namen.
+ Geben wir nun dem Absender
+ \iffalse % Umbruchkorrektur
+ aus den bisherigen Beispielen
+ \fi %
+ einen Namen.
\lstinputcode[xleftmargin=1em]{letter-8.tex}
\begin{figure}
\centering
@@ -1370,7 +1291,16 @@ können, um etwa Grau an Stelle von Schwarz zu verwenden. Siehe hierzu
Nun soll der Brief mit aktivierter Erweiterung für den Briefkopf mit Hilfe
der Option \Option{fromrule} auch noch eine Linie unter dem Namen erhalten:%
\lstinputcode[xleftmargin=1em]{letter-11.tex}%
- Das Ergebnis ist in \autoref{fig:scrlttr2.letter-10-11}, rechts zu sehen.
+ Das Ergebnis ist in \autoref{fig:scrlttr2.letter-10-11} rechts zu sehen. %
+ \iffalse % Umbruchkorrektur
+ Im Vergleich dazu ist links daneben das gleiche Beispiel noch einmal mit dem
+ Standardbriefkopf und ohne Reaktion auf die zusätzliche Option.
+ %
+ \else %
+ Links steht zum Vergleich ein Beispiel mit Standardbriefkopf.
+ %
+ \fi
+ %
\begin{figure}
\centering
\frame{\includegraphics[width=.4\textwidth]{letter-10}}\quad
@@ -1385,24 +1315,29 @@ können, um etwa Grau an Stelle von Schwarz zu verwenden. Siehe hierzu
Briefkopf mit \OptionValue{fromalign}{center}}
\label{fig:scrlttr2.letter-10-11}
\end{figure}
- Im Vergleich dazu ist links daneben das gleiche Beispiel noch einmal mit dem
- Standardbriefkopf und ohne Reaktion auf die zusätzliche Option.
\end{Example}
-Ein\textnote{Achtung!} wichtiger Hinweis betrifft noch die Absenderadresse:
-Innerhalb der Absenderadresse werden einzelne Teilangaben durch doppelten
-Backslash voneinander getrennt. Solche Teilangaben sind beispielsweise Straße
-und Hausnummer, Postleitzahl und Ort oder eine Länderangabe. Dieser doppelte
-Backslash wird je nach Verwendung der Absenderadresse unterschiedlich
-interpretiert und ist nicht zwangsläufig als Zeilenumbruch zu verstehen.
-Absätze, vertikale Abstände und Ähnliches sind innerhalb der Absenderangaben
-normalerweise nicht gestattet. Man muss \Class{scrlttr2} schon sehr genau
-kennen, um solche Mittel gegebenenfalls sinnvoll im Absender einsetzen zu
-können. Außerdem sollte man in dem Fall unbedingt die Variablen für
-Rücksendeadresse (siehe Variable \Variable{backaddress},
+Ein\textnote{Achtung!} wichtiger Hinweis betrifft \iffree{noch}{\unskip} die
+Absenderadresse: Innerhalb der Absenderadresse werden einzelne Teilangaben
+durch doppelten Backslash voneinander getrennt. Solche Teilangaben sind
+beispielsweise Straße und Hausnummer, Postleitzahl und Ort oder eine
+Länderangabe. Dieser doppelte Backslash wird je nach Verwendung der
+Absenderadresse unterschiedlich interpretiert und ist nicht zwangsläufig als
+Zeilenumbruch zu verstehen. Absätze, vertikale Abstände und Ähnliches sind
+innerhalb der Absenderangaben normalerweise nicht gestattet%
+\iffalse % Umbruchkorrektur
+. Man muss \Class{scrlttr2} schon sehr genau kennen, um solche Mittel
+gegebenenfalls sinnvoll im Absender einsetzen zu können. Außerdem sollte man
+in dem Fall unbedingt die Variablen für Rücksendeadresse (siehe Variable
+\Variable{backaddress}, \autopageref{desc:scrlttr2.variable.backaddress}) und
+Signatur (siehe Variable \Variable{signature},
+\autopageref{desc:scrlttr2.variable.signature}) selbst setzen.%
+\else %
+\ und hätten außerdem gegebenenfalls Auswirkungen auf die Rücksendeadresse
+(siehe Variable \Variable{backaddress},
\autopageref{desc:scrlttr2.variable.backaddress}) und Signatur (siehe Variable
-\Variable{signature}, \autopageref{desc:scrlttr2.variable.signature}) selbst
-setzen.%
+\Variable{signature}, \autopageref{desc:scrlttr2.variable.signature}).%
+\fi %
%
\EndIndex{Variable}{fromname}%
\EndIndex{Variable}{fromaddress}%
@@ -1410,12 +1345,16 @@ setzen.%
\begin{Declaration}
+ \KOption{symbolicnames}\PName{Ein-Aus-Wert}\\
\KOption{fromphone}\PName{Ein-Aus-Wert}\\
+ \KOption{frommobilephone}\PName{Ein-Aus-Wert}\\
\KOption{fromfax}\PName{Ein-Aus-Wert}\\
\KOption{fromemail}\PName{Ein-Aus-Wert}\\
\KOption{fromurl}\PName{Ein-Aus-Wert}\\
\Macro{setkomavar}\PParameter{\Variable{fromphone}}%
\OParameter{Bezeichnung}\Parameter{Inhalt}\\
+ \Macro{setkomavar}\PParameter{\Variable{frommobilephone}}%
+ \OParameter{Bezeichnung}\Parameter{Inhalt}\\
\Macro{setkomavar}\PParameter{\Variable{fromfax}}%
\OParameter{Bezeichnung}\Parameter{Inhalt}\\
\Macro{setkomavar}\PParameter{\Variable{fromemail}}%
@@ -1424,6 +1363,8 @@ setzen.%
\OParameter{Bezeichnung}\Parameter{Inhalt}\\
\Macro{setkomavar}\PParameter{\Variable{phoneseparator}}%
\OParameter{Bezeichnung}\Parameter{Inhalt}\\
+ \Macro{setkomavar}\PParameter{\Variable{mobilephoneseparator}}%
+ \OParameter{Bezeichnung}\Parameter{Inhalt}\\
\Macro{setkomavar}\PParameter{\Variable{faxseparator}}%
\OParameter{Bezeichnung}\Parameter{Inhalt}\\
\Macro{setkomavar}\PParameter{\Variable{emailseparator}}%
@@ -1431,30 +1372,50 @@ setzen.%
\Macro{setkomavar}\PParameter{\Variable{urlseparator}}%
\OParameter{Bezeichnung}\Parameter{Inhalt}%
\end{Declaration}%
+\BeginIndex{Option}{symbolicnames~=\PName{Ein-Aus-Wert}}%
\BeginIndex{Option}{fromphone~=\PName{Ein-Aus-Wert}}%
+\BeginIndex{Option}{frommobilephone~=\PName{Ein-Aus-Wert}}%
\BeginIndex{Option}{fromfax~=\PName{Ein-Aus-Wert}}%
\BeginIndex{Option}{fromemail~=\PName{Ein-Aus-Wert}}%
\BeginIndex{Option}{fromurl~=\PName{Ein-Aus-Wert}}%
\BeginIndex{Variable}{fromphone}%
+\BeginIndex{Variable}{frommobilephone}%
\BeginIndex{Variable}{fromfax}%
\BeginIndex{Variable}{fromemail}%
\BeginIndex{Variable}{fromurl}%
\BeginIndex{Variable}{emailseparator}%
\BeginIndex{Variable}{faxseparator}%
\BeginIndex{Variable}{phoneseparator}%
+\BeginIndex{Variable}{mobilephoneseparator}%
\BeginIndex{Variable}{urlseparator}%
-Mit den Optionen \Option{fromphone}, \Option{fromfax}, \Option{fromemail} und
-\Option{fromurl} kann bestimmt werden, ob die Telefonnummer\Index{Telefon},
-die Faxnummer\Index{Fax}, die E-Mail-Adresse und die URL im
-Absender\Index{Absender} gesetzt werden soll. Als \PName{Ein-Aus-Wert} kann
-dabei einer der Standardwerte für einfache Schalter aus
-\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet
-werden. Voreingestellt ist jeweils \PValue{false}. Die Inhalte selbst werden
-über die gleichnamigen Variablen bestimmt. Die Voreinstellungen für die dabei
-verwendeten Bezeichnungen sind \autoref{tab:scrlttr2.fromTerm} zu entnehmen,
-die verwendeten Trennzeichen, die zwischen der \PName{Bezeichnung} und dem
-\PName{Inhalt} einer Variablen eingefügt werden,
-\autoref{tab:scrlttr2.fromSeperator}.
+Mit Hilfe der fünf Optionen \Option{fromphone},
+\Option{frommobilephone}\ChangedAt{v3.12}{\Class{scrlttr2}}, \Option{fromfax},
+\Option{fromemail} und \Option{fromurl} kann bestimmt werden, ob die
+Telefonnummer\Index{Telefon}, die
+Mobiltelefonnummer\Index{Mobiltelefon}\Index{Handy}, die Faxnummer\Index{Fax},
+die E-Mail-Adresse und die URL im Absender\Index{Absender} gesetzt werden
+soll. Als \PName{Ein-Aus-Wert} kann dabei einer der Standardwerte für einfache
+Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}
+verwendet werden. Voreingestellt ist jeweils \PValue{false}. Die Inhalte
+selbst werden über die gleichnamigen Variablen bestimmt. Die Voreinstellungen
+für die dabei verwendeten Bezeichnungen sind \autoref{tab:scrlttr2.fromTerm}
+zu entnehmen, die verwendeten Trennzeichen, die zwischen der
+\PName{Bezeichnung} und dem \PName{Inhalt} einer Variablen eingefügt werden,
+\autoref{tab:scrlttr2.fromSeparator}.
+
+Mit\ChangedAt{v3.12}{\Class{scrlttr2}}\important{\Option{symbolicnames}}
+Option \Option{symbolicnames} kann diese Voreinstellung auf einen Schlag
+geändert werden. Die Option versteht die \PName{Ein-Aus-Werte} für einfache
+Schalter, wie sie in \autoref{tab:truefalseswitch},
+\autopageref{tab:truefalseswitch} angegeben sind. Durch Aktivierung der Option
+werden statt der sprachabhängigen Bezeichner \Macro{emailname},
+\Macro{faxname}, \Macro{mobilephonename} und \Macro{phonename} Symbole aus dem
+\Package{marvosym}\IndexPackage{marvosym}-Paket
+verwendet. Gleichzeitig entfällt der Doppelpunkt bei der Definition der
+Trennzeichen. Für die URL entfallen in diesem Fall sowohl der sprachabhängige
+Bezeichner als auch das Trennzeichen. Es ist zu beachten\textnote{Achtung!},
+dass das Paket \Package{marvosym} gegebenenfalls selbst zu laden ist, falls
+die Option erst nach \Macro{begin}\PParameter{document} aktiviert wird.
\begin{table}
\centering
@@ -1462,12 +1423,15 @@ die verwendeten Trennzeichen, die zwischen der \PName{Bezeichnung} und dem
Absenderangaben im Briefkopf}]{Vordefinierte Bezeichnungen der Variablen
für die Absenderangaben im Briefkopf (die Bezeichnungen und Inhalte der
verwendeten Variablen für Trennzeichen ist
- \autoref{tab:scrlttr2.fromSeperator} zu entnehmen)}
+ \autoref{tab:scrlttr2.fromSeparator} zu entnehmen)}
\begin{desctabular}[1.8em]
\ventry{fromemail}{\Macro{usekomavar*}\PParameter{emailseparator}%
\Macro{usekomavar}\PParameter{emailseparator}}%
\ventry{fromfax}{\Macro{usekomavar*}\PParameter{faxseparator}%
\Macro{usekomavar}\PParameter{faxseparator}}%
+ \ventry{frommobilephone}{%
+ \Macro{usekomavar*}\PParameter{mobilephoneseparator}%
+ \Macro{usekomavar}\PParameter{mobilephoneseparator}}%
\ventry{fromname}{\Macro{headfromname}}%
\ventry{fromphone}{\Macro{usekomavar*}\PParameter{phoneseparator}%
\Macro{usekomavar}\PParameter{phoneseparator}}%
@@ -1478,25 +1442,29 @@ die verwendeten Trennzeichen, die zwischen der \PName{Bezeichnung} und dem
\end{table}
\begin{table}[tp]
-% \centering
- \KOMAoptions{captions=topbeside}%
- \setcapindent{0pt}%
-% \caption
- \begin{captionbeside}{Vordefinierte Bezeichnungen und Inhalte der Trennzeichen
- für die Absenderangaben im Briefkopf}
- [l]
- \begin{tabular}[t]{lll}
+ \centering
+% \KOMAoptions{captions=topbeside}%
+% \setcapindent{0pt}%
+ \caption
+% \begin{captionbeside}
+ {Vordefinierte Bezeichnungen und Inhalte der Trennzeichen
+ für die Absenderangaben im Briefkopf ohne Option
+ \Option{symbolicnumbers}}
+% [l]
+ \begin{tabularx}{\textwidth}{llX}
\toprule
Name & Bezeichnung & Inhalt \\
\midrule
\Variable{emailseparator} & \Macro{emailname} & \texttt{:\~} \\
\Variable{faxseparator} & \Macro{faxname} & \texttt{:\~} \\
+ \Variable{mobilephoneseparator} & \Macro{mobilephonename} &
+ \Macro{usekomavar}\PParameter{phoneseparator} \\
\Variable{phoneseparator} & \Macro{phonename} & \texttt{:\~} \\
\Variable{urlseparator} & \Macro{wwwname} & \texttt{:\~} \\
\bottomrule
- \end{tabular}
- \end{captionbeside}
- \label{tab:scrlttr2.fromSeperator}
+ \end{tabularx}
+% \end{captionbeside}
+ \label{tab:scrlttr2.fromSeparator}
\end{table}
\begin{Example}
@@ -1527,8 +1495,8 @@ die verwendeten Trennzeichen, die zwischen der \PName{Bezeichnung} und dem
\lstinputcode[xleftmargin=1em]{letter-13.tex}
Den Vergleich zweier Alternativen mit linksbündigem Absender durch
- Einstellung \OptionValue{fromalign}{left} und rechtsbündigem Absender
- durch Einstellung \OptionValue{fromalign}{right} zeigt
+ Einstellung \OptionValue{fromalign}{left} und rechtsbündigem
+ Absender durch Einstellung \OptionValue{fromalign}{right} zeigt
\autoref{fig:scrlttr2.letter-14-15}.
\begin{figure}
\centering
@@ -1547,17 +1515,21 @@ die verwendeten Trennzeichen, die zwischen der \PName{Bezeichnung} und dem
\end{Example}
%
\EndIndex{Variable}{urlseparator}%
+\EndIndex{Variable}{mobilephoneseparator}%
\EndIndex{Variable}{phoneseparator}%
\EndIndex{Variable}{faxseparator}%
\EndIndex{Variable}{emailseparator}%
\EndIndex{Variable}{fromurl}
\EndIndex{Variable}{fromemail}
\EndIndex{Variable}{fromfax}
+\EndIndex{Variable}{frommobilephone}%
\EndIndex{Variable}{fromphone}%
\EndIndex{Option}{fromurl~=\PName{Ein-Aus-Wert}}%
\EndIndex{Option}{fromemail~=\PName{Ein-Aus-Wert}}%
\EndIndex{Option}{fromfax~=\PName{Ein-Aus-Wert}}%
+\EndIndex{Option}{frommobilephone~=\PName{Ein-Aus-Wert}}%
\EndIndex{Option}{fromphone~=\PName{Ein-Aus-Wert}}%
+\EndIndex{Option}{symbolicnames~=\PName{Ein-Aus-Wert}}%
\begin{Declaration}
\KOption{fromlogo}\PName{Ein-Aus-Wert}\\
@@ -1581,10 +1553,11 @@ auch \autoref{tab:scrlttr2.fromTerm}).%
zusätzlich das Paket \Package{graphics}\IndexPackage{graphics} (siehe
\cite{package:graphics}) ein.%
\lstinputcode[xleftmargin=1em]{letter-16}%
- Das Ergebnis ist in \autoref{fig:scrlttr2.letter-16-18} links oben zu
- sehen. Die beiden anderen Bilder in dieser Abbildung zeigen das Ergebnis bei
- rechtsbündigem und bei zentriertem Absender.
- \begin{figure}
+ Das Ergebnis ist in \autoref{fig:scrlttr2.letter-16-18},
+ \autopageref{fig:scrlttr2.letter-16-18} links oben zu sehen. Die beiden
+ anderen Bilder in dieser Abbildung zeigen das Ergebnis bei rechtsbündigem
+ und bei zentriertem Absender.
+ \begin{figure}
\setcapindent{0pt}%
{\hfill
\frame{\includegraphics[width=.4\textwidth]{letter-16}}\quad
@@ -1684,16 +1657,16 @@ mehr verwendet werden.%
Mit der Option \Option{addrfield} kann gewählt werden, ob ein Anschriftfeld
gesetzt werden soll oder nicht. Voreingestellt ist die Verwendung eines
Anschriftfeldes. Die Option versteht die in
-\autoref{tab:scrlttr2.addrfield}\ChangedAt{v3.03}{\Class{scrlttr2}}
-angegebenen Werte für den \PName{Modus}. Voreingestellt ist \PValue{true}. Bei
-den Werten \PValue{true}, \PValue{PP} und \PValue{backgroundimage} werden Name
-und Adresse des Empfängers, die im Anschriftfeld gesetzt werden, über das
-Argument der Umgebung \Environment{letter} (siehe
-\autoref{sec:scrlttr2.document}, \autopageref{desc:scrlttr2.env.letter})
-bestimmt. Diese Angaben werden außerdem in die Variablen \Variable{toname} und
-\Variable{toaddress} kopiert. Die voreingestellten Schriftarten
-können\ChangedAt{v2.97c}{\Class{scrlttr2}} über die Anweisungen
-\Macro{setkomafont} und \Macro{addtokomafont} (siehe
+\autoref{tab:scrlttr2.addrfield}\ChangedAt{v3.03}{\Class{scrlttr2}},
+\autopageref{tab:scrlttr2.addrfield} angegebenen Werte für den
+\PName{Modus}. Voreingestellt ist \PValue{true}. Bei den Werten \PValue{true},
+\PValue{PP} und \PValue{backgroundimage} werden Name und Adresse des
+Empfängers, die im Anschriftfeld gesetzt werden, über das Argument der
+Umgebung \Environment{letter} (siehe \autoref{sec:scrlttr2.document},
+\autopageref{desc:scrlttr2.env.letter}) bestimmt. Diese Angaben werden
+außerdem in die Variablen \Variable{toname} und \Variable{toaddress} kopiert.
+Die voreingestellten Schriftarten können\ChangedAt{v2.97c}{\Class{scrlttr2}}
+über die Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} (siehe
\autoref{sec:scrlttr2.textmarkup}, ab
\autopageref{desc:scrlttr2.cmd.setkomafont}) verändert werden. Dabei
existieren drei Elemente. Zunächst gibt es das Element
@@ -1824,8 +1797,8 @@ wobei vor der Anwendung der konfigurierten Schriftumschaltung noch auf
\end{table}
\BeginIndex{FontElement}{specialmail}
-Zwischen Rücksendeadresse und Empfängeradresse kann bei der
-Standardeinstellung \OptionValue{addrfield}{true} noch eine optionale
+Zwischen Rücksendeadresse und Empfängeradresse kann bei \iffree{der
+}{}Standardeinstellung \OptionValue{addrfield}{true} noch eine optionale
Versandart\Index{Versandart} gesetzt werden. Diese wird genau dann gesetzt,
wenn die Variable \Variable{specialmail} einen \PName{Inhalt} hat und
\OptionValue{priority}{manual}\ChangedAt{v3.03}{\Class{scrlttr2}} gewählt
@@ -1883,13 +1856,13 @@ Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} (siehe
\end{table}
Bei\ChangedAt{v3.03}{\Class{scrlttr2}}\important{\OptionValue{addrfield}{PP}}
-\OptionValue{addrfield}{PP} wird im Port-Payé-Kopf außerdem die Postleitzahl
-aus der Variablen \Variable{fromzipcode} und der Ort aus der Variablen
-\Variable{place} gesetzt. Dabei wird der Postleitzahl aus dem \PName{Inhalt} der
-Variablen \Variable{fromzipcode} die \PName{Bezeichnung} der Variablen
-\Variable{fromzipcode} gefolgt vom \PName{Inhalt} der Variablen
-\Variable{zipcodeseparator} vorangestellt. Die Voreinstellung dieser
-\PName{Bezeichnung} hängt von der verwendeten \File{lco}-Datei (siehe
+\OptionValue{addrfield}{PP} wird im Port-Payé-Kopf die Postleitzahl aus der
+Variablen \Variable{fromzipcode} und der Ort aus der Variablen
+\Variable{place} gesetzt. Dabei wird der Postleitzahl, also dem \PName{Inhalt}
+von \Variable{fromzipcode}, die \PName{Bezeichnung} der Variablen
+\Variable{fromzipcode} gefolgt vom \PName{Inhalt} von
+\Variable{zipcodeseparator} vorangestellt. Für diese \PName{Bezeichnung} hängt
+die Voreinstellung von der verwendeten \File{lco}-Datei (siehe
\autoref{sec:scrlttr2.lcoFile} ab \autopageref{sec:scrlttr2.lcoFile}) ab. Für
den \PName{Inhalt} von \Variable{zipcodeseparator} ist hingegen ein kleiner
Abstand, gefolgt von einem Streckenstrich, gefolgt von einem kleinen Abstand
@@ -1958,8 +1931,8 @@ Anweisung \Macro{includegraphics} zu verwenden.%
\BeginIndex{}{Absenderergaenzung=Absenderergänzung}%
\BeginIndex{Option}{locfield~=\PName{Einstellung}}%
Neben dem Anschriftfeld setzt \Class{scrlttr2} noch ein Feld mit erweiterter
-Absenderangabe. Dieses Feld kann beispielsweise für Bankverbindungen und
-Ähnliches verwendet werden. Je\important[i]{\OptionValue{fromalign}{center}\\
+Absenderangabe. Der Inhalt ist frei wählbar.
+Je\important[i]{\OptionValue{fromalign}{center}\\
\begin{tabular}[t]{@{}l@{}}
\KOption{fromalign}\\\quad\PValue{locationleft}\end{tabular}\\
\begin{tabular}[t]{@{}l@{}}
@@ -2059,10 +2032,13 @@ die Standardwerte für einfache Schalter, die in \autoref{tab:truefalseswitch},
Das Datum in der gewählten Darstellung wird in im \PName{Inhalt} der Variablen
\Variable{date} abgelegt. Die Einstellung von \Option{numericaldate} hat keine
Auswirkung, wenn diese Variable überschrieben wird. Gesetzt wird das Datum
-normalerweise als Teil der Geschäftszeile. Dies ist auch dann der Fall, wenn
-die Geschäftszeile ansonsten leer bleibt. Für weitere Angaben zum
-automatischen Setzen des Datums siehe die nachfolgend beschriebene Option
-\Option{refline}.%
+normalerweise als Teil der Geschäftszeile. Wenn die Geschäftszeile ansonsten
+leer bleibt wird allerdings nur eine Datumszeile, bestehend aus dem Ort und
+dem Datum gesetzt. Trotzdem haben auch in diesem Fall die Einstellungen der
+nachfolgend beschriebenen Option \Option{refline} Auswirkungen auf diese
+Datumszeile. Weitere Informationen zum Ort finden Sie in der Beschreibung zur
+Variablen \Variable{place}\IndexVariable{place} auf
+\autopageref{desc:scrlttr2.variable.placeseparator}.%
%
\EndIndex{Variable}{date}%
\EndIndex{Option}{numericaldate~=\PName{Ein-Aus-Wert}}%
@@ -2126,9 +2102,14 @@ weitere Angaben aufnehmen. Mögliche Werte für diese Option sind
\BeginIndex{Variable}{invoice}%
Typische Felder der Geschäftszeile werden über die fünf Variablen
\Variable{yourref}, \Variable{yourmail}, \Variable{myref}, \Variable{customer}
-und \Variable{invoice} verwaltet. Die Bedeutung dieser Felder sind
-\autoref{tab:scrlttr2.variables} auf \autopageref{tab:scrlttr2.variables} zu
-entnehmen. Jede dieser Variablen hat außerdem eine vordefinierte
+und \Variable{invoice} verwaltet. %
+\iffalse % Umbruchkorrektur
+Die Bedeutung dieser Felder %
+\else %
+Ihre Bedeutung %
+\fi %
+ist \autoref{tab:scrlttr2.variables}, \autopageref{tab:scrlttr2.variables} zu
+entnehmen. Jede dieser Variablen hat auch eine vordefinierte
\PName{Bezeichnung}, die in \autoref{tab:scrlttr2.reflineTerm} zu finden
ist. Wie weitere Variablen zur Geschäftszeile hinzugefügt werden können, ist
in \autoref{sec:scrlttr2-experts.variables} ab
@@ -2207,7 +2188,7 @@ der beiden Elemente sind \autoref{tab:scrlttr2.refnamerefvalue} zu entnehmen.%
\BeginIndex{Variable}{placeseparator}%
Sind bis auf \Variable{date} alle Variablen der Geschäftszeile leer, so wird
keine eigentliche Geschäftszeile gesetzt. Stattdessen werden dann nur
-rechtsbündig Ort\Index{Ort} und Datum\Index{Datum} ausgegeben. Dabei bestimmt
+Ort\Index{Ort} und Datum\Index{Datum} ausgegeben. Dabei bestimmt
der \PName{Inhalt} der Variablen \Variable{place} den Ort. Für das
Trennzeichen, das in diesem Fall nach dem Ort gesetzt wird, ist der
\PName{Inhalt} der Variablen \Variable{placeseparator} zuständig. Der
@@ -2218,13 +2199,31 @@ Trennzeichen nicht gesetzt. Der vordefinierte \PName{Inhalt} der Variablen
Einstellung der Option \Option{numericaldate} ab (siehe
\autopageref{desc:scrlttr2.option.numericaldate}).
+Seit Version~3.09\ChangedAt{v3.09}{\Class{scrlttr2}} werden Ort und Datum
+nicht mehr zwingend rechtsbündig ausgegeben. Stattdessen findet auch im Falle
+der Datumszeile die Datumseinstellung von Option \Option{refline}, wie sie in
+\autoref{tab:scrlttr2.refline} angegeben ist, Anwendung.
+
+\BeginIndex{FontElement}{placeanddate}%
+Falls\ChangedAt{v3.12}{\Class{scrlttr2}} statt der Geschäftszeile eine solche
+Datumszeile mit Ort gesetzt wird, so findet nicht die Schrifteinstellung des
+Elements \FontElement{refvalue} Anwendung. Stattdessen wird in diesem Fall das
+Element \FontElement{placeanddate}\important[i]{\FontElement{placeanddate}}
+verwendet, dessen leere Voreinstellung wie gewohnt mit Hilfe der
+Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} (siehe
+\autoref{sec:scrlttr2.textmarkup},
+\autopageref{desc:scrlttr2.cmd.setkomafont}) geändert werden kann.%
+\EndIndex{FontElement}{placeanddate}%
+
\begin{Example}
Herr Musterfrau setzt nun auch die Variable für den Ort:
\lstinputcode[xleftmargin=1em]{letter-20.tex}%
- Damit erscheint vor dem Datum, wie in \autoref{fig:scrlttr2.letter-20} zu
- sehen, der Ort gefolgt von den automatischen Trennzeichen vor dem
- Datum. Dieses wurde nun ebenfalls explizit gesetzt, damit bei einem späteren
- \LaTeX-Durchlauf des Briefes das ursprüngliche Datum erhalten bleibt.
+ Damit erscheint vor dem Datum, wie in \autoref{fig:scrlttr2.letter-20},
+ \autopageref{fig:scrlttr2.letter-20} zu sehen, der Ort gefolgt von den
+ automatischen Trennzeichen vor dem Datum. Dieses Datum wurde im Beispielcode
+ über Variable \Variable{date} ebenfalls explizit gesetzt, damit bei einem
+ späteren \LaTeX-Durchlauf des Briefes das ursprüngliche Datum erhalten
+ bleibt und nicht etwa automatisch das Datum des \LaTeX-Laufs verwendet wird.
\begin{figure}
\setcapindent{0pt}%
\begin{captionbeside}[{Beispiel: Brief mit erweitertem Absender, Logo,
@@ -2468,7 +2467,7 @@ neue Festlegung zu treffen. Die \PName{Bezeichnung} der Variablen wird von
\end{tabular}%
\hfill
\begin{tabular}[t]{l@{}}%
- \multicolumn{1}{@{}l@{}}{Geschäftsführerin:}\\
+ \multicolumn{1}{@{}l@{}}{Geschäftsführung:}\\
Liselotte Mayer\\[1ex]
\multicolumn{1}{@{}l@{}}{Gerichtsstand:}\\
Hinterdupfeldingen
@@ -2587,9 +2586,13 @@ Verwendung der Klassenoption \Option{headsepline} automatisch die Paketoption
\Option{footinclude}\important{\Option{footinclude}}. Im\important{\Pagestyle{plain}}
Gegensatz zu \Option{headsepline} wirkt sich die Option \Option{footsepline}
auch beim Seitenstil \PValue{plain} aus, da \PValue{plain} eine Seitenzahl im
-Fuß ausgibt. Das Paket \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}} (siehe
-\autoref{cha:scrpage}) bietet weitere Einflussmöglichkeiten für Linien im Kopf
-und Fuß und kann auch mit \Class{scrlttr2} kombiniert werden.%
+Fuß ausgibt. Das Paket
+\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage}\important{\Package{scrlayer-scrpage}}
+\iffree{oder das veraltete
+ \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}}}%
+{\unskip} (siehe \autoref{cha:scrlayer-scrpage} \iffree{beziehungsweise
+ \autoref{cha:scrpage}}{\unskip}) bietet weitere Einflussmöglichkeiten für
+Linien im Kopf und Fuß und kann auch mit \Class{scrlttr2} kombiniert werden.%
%
\EndIndex{Option}{headsepline~=\PName{Ein-Aus-Wert}}%
\EndIndex{Option}{footsepline~=\PName{Ein-Aus-Wert}}%
@@ -2604,14 +2607,17 @@ Folgeseiten gesetzt werden soll. Die Option wirkt sich auf die
Seitenstile\important[i]{\Pagestyle{headings}\\
\Pagestyle{myheadings}\\
\Pagestyle{plain}} \PValue{headings}, \PValue{myheadings} und \PValue{plain}
-aus. Sie beeinflusst außerdem die Voreinstellung der Seitenstile des
-\Package{scrpage2}-Paketes\important{\Package{scrpage2}}, soweit sie vor dem
-Laden dieses Paketes gesetzt wird (siehe \autoref{cha:scrpage}). Es gibt
-Werte, die sich nur auf die horizontale Position auswirken, Werte, die nur die
-vertikale Position beeinflussen, und Werte, die zugleich die vertikale und die
-horizontale Position festlegen. Mögliche Werte sind
-\autoref{tab:scrlttr2.pagenumber} zu entnehmen. Voreingestellt ist
-\PValue{botcenter}.
+aus. Sie beeinflusst außerdem die Voreinstellung der Seitenstile des Pakets
+\Package{scrlayer-scrpage}\important{\Package{scrlayer-scrpage}}%
+\IndexPackage{scrlayer-scrpage} \iffree{oder des veralteten
+ \Package{scrpage2}\important{\Package{scrpage2}}%
+ \IndexPackage{scrpage2}}{\unskip}, soweit sie vor dem Laden des Paketes
+gesetzt wird (siehe \autoref{cha:scrlayer-scrpage} \iffree{oder
+ \autoref{cha:scrpage}}{\unskip}). Es gibt Werte, die sich nur auf die
+horizontale Position auswirken, Werte, die nur die vertikale Position
+beeinflussen, und Werte, die zugleich die vertikale und die horizontale
+Position festlegen. Mögliche Werte sind \autoref{tab:scrlttr2.pagenumber} zu
+entnehmen. Voreingestellt ist \PValue{botcenter}.
\begin{table}[t!]% Umbruchkorrektur
\caption[{Mögliche Werte für Option \Option{pagenumber} bei
@@ -2684,14 +2690,19 @@ Seitenstilen unterschieden.
\Variable{nextfoot}\IndexVariable{nextfoot} ab. Der Autor kann die Marken
aber auch noch nach \Macro{opening} manuell beeinflussen. Hierzu stehen wie
üblich die Anweisungen \Macro{markboth} und \Macro{markright}, bei
- Verwendung von \Package{scrpage2} auch \Macro{markleft} (siehe
- \autoref{sec:scrpage.basics.mark}, \autopageref{desc:scrpage.cmd.automark}),
- zur Verfügung.
+ Verwendung von
+ \Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage}\important{\Package{scrlayer-scrpage}}
+ \iffree{oder \Package{scrpage2}}{\unskip} auch \Macro{markleft} (siehe
+ \autoref{sec:scrlayer-scrpage.pagestyle.content},
+ \autopageref{desc:scrlayer-scrpage.cmd.markleft} \iffree{oder
+ \autoref{sec:scrpage.basics.mark},
+ \autopageref{desc:scrpage.cmd.markleft}}{\unskip}), zur Verfügung.
\item[{\Pagestyle{myheadings}}] ist der Seitenstil für manuelle Kolumnentitel
auf Folgeseiten. Im Unterschied zu \PValue{headings} müssen die Marken vom
Anwender gesetzt werden. Er verwendet dazu die Anweisungen
\Macro{markboth}\IndexCmd{markboth} und
- \Macro{markright}\IndexCmd{markright}. Bei Verwendung von \Package{scrpage2}
+ \Macro{markright}\IndexCmd{markright}. Bei Verwendung von
+ \Package{scrlayer-scrpage} \iffree{oder \Package{scrpage2}}{\unskip}
steht außerdem \Macro{markleft}\IndexCmd{markleft} zur Verfügung.
\item[{\Pagestyle{plain}}] ist der voreingestellte Seitenstil, bei dem auf
Folgeseiten keinerlei Kolumnentitel verwendet, sondern nur eine Seitenangabe
@@ -2723,10 +2734,16 @@ Fuß\ChangedAt{v3.00}{\Class{scrlttr2}} ist zusätzlich auch noch das Element
\FontElement{pagefoot}\important{\FontElement{pagefoot}} zuständig, das nach
\FontElement{pageheadfoot} in mit Variable
\Variable{nextfoot}\IndexVariable{nextfoot} oder per Paket
-\Package{scrpage2}\IndexPackage{scrpage2} (siehe \autoref{cha:scrpage},
-\autopageref{desc:scrpage.fontelement.pagefoot}) definierten Seitenstilen zur
-Anwendung kommt. Das Element für die Seitenzahl innerhalb des Kopfes oder
-Fußes heißt \FontElement{pagenumber}\important{\FontElement{pagenumber}}. Die
+\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage}%
+\important{\Package{scrlayer-scrpage}} \iffree{oder
+ \Package{scrpage2}\IndexPackage{scrpage2}}{\unskip} (siehe
+\autoref{cha:scrlayer-scrpage},
+\autopageref{desc:scrlayer-scrpage.fontelement.pagefoot} \iffree{oder
+ \autoref{cha:scrpage},
+ \autopageref{desc:scrpage.fontelement.pagefoot}}{\unskip}) definierten
+Seitenstilen zur Anwendung kommt. Das Element für die Seitenzahl innerhalb des
+Kopfes oder Fußes heißt
+\FontElement{pagenumber}\important{\FontElement{pagenumber}}. Die
Voreinstellungen sind in \autoref{tab:maincls.defaultFontsHeadFoot},
\autopageref{tab:maincls.defaultFontsHeadFoot} zu finden. Beachten Sie dazu
auch das Beispiel aus \autoref{sec:maincls.pagestyle},
@@ -2760,10 +2777,17 @@ vollkommen ausreichen. Dies umso mehr, als man zusätzlich mit
\Macro{markboth}\IndexCmd{markboth} und \Macro{markright}\IndexCmd{markright}
können insbesondere mit dem Seitenstil
\PValue{myheadings}\IndexPagestyle{myheadings}\important{\Pagestyle{myheadings}}
-verwendet werden. Bei Verwendung des Paketes
-\Package{scrpage2}\IndexPackage{scrpage2} gilt dies natürlich auch für den
-Seitenstil \PValue{scrheadings}\IndexPagestyle{scrheadings}. Dort steht
-außerdem die Anweisung \Macro{markleft}\IndexCmd{markleft} zur Verfügung.
+verwendet werden. Bei Verwendung des Pakets
+\Package{scrlayer-scrpage}\IndexPackage{scrlayer-scrpage}\important{\Package{scrlayer-scrpage}}
+\iffree{oder \Package{scrpage2}}{\unskip} gilt dies natürlich auch für den
+Seitenstil
+\Pagestyle{scrheadings}\IndexPagestyle{scrheadings}\important{\Pagestyle{scrheadings}}.
+Dort steht außerdem die Anweisung
+\Macro{markleft}\IndexCmd{markleft}\important{\Macro{markleft}} zur Verfügung
+(siehe \autoref{sec:scrlayer-scrpage.pagestyle.content},
+\autopageref{desc:scrlayer-scrpage.cmd.markleft} \iffree{oder
+ \autoref{sec:scrpage.basics.mark},
+ \autopageref{desc:scrpage.cmd.markleft}}{\unskip}).
\begin{Declaration}
\Macro{setkomavar}\PParameter{\Variable{nexthead}}%
@@ -3058,21 +3082,17 @@ haben.
\end{captionbeside}
\label{fig:scrlttr2.letter-23}
\end{figure}
-
- Bitte\textnote{Achtung!} beachten Sie, dass in der Bankverbindung in
- \File{ich.lco} für »ß« die \TeX-Schreibweise »\Macro{ss}« verwendet
- wurde. Dies hat seinen Grund darin, dass direkt nach
- \Macro{documentclass} weder ein Paket für die Eingabecodierung,
- beispielsweise mit
- \Macro{usepackage}\POParameter{ansinew}\PParameter{inputenc} für typische
- Windows-Editoren oder
- \Macro{usepackage}\POParameter{utf8}\PParameter{inputenc} für
- moderne Editoren, noch ein
- Paket zur Sprachumschaltung, beispielsweise für die neue, deutsche
- Rechtschreibung mit
- \Macro{usepackage}\POParameter{ngerman}\PParameter{babel}, geladen ist.
\end{Example}
+Bitte\textnote{Achtung!} beachten Sie, dass im Beispiel in der Bankverbindung
+der Datei \File{ich.lco} für »ß« die \TeX-Schreibweise »\Macro{ss}« verwendet
+wurde. Dies hat seinen Grund darin, dass während des Ladens der Klasse
+weder ein Paket für die Eingabecodierung, beispielsweise mit
+\Macro{usepackage}\POParameter{utf8}\PParameter{inputenc} für moderne
+Editoren, noch ein Paket zur Sprachumschaltung, beispielsweise für die neue,
+deutsche Rechtschreibung mit
+\Macro{usepackage}\POParameter{ngerman}\PParameter{babel}, geladen ist.
+
In \autoref{tab:lcoFiles} finden Sie eine Liste aller vordefinierten
\File{lco}-Dateien. Falls\textnote{Achtung!} Sie einen Drucker verwenden, der
einen sehr großen unbedruckbaren Rand links oder rechts besitzt, werden Sie
@@ -3440,8 +3460,8 @@ ignoriert diese Anweisung ebenso wie \Macro{addrchar}.
{}{}{}{Gefallener Engel ohne Telefon}
{LUZIFER}
\end{lstcode}
- Diese bearbeiten Sie nun unter Verwendung von \File{adrdir.tex} aus
- \cite{package:adrconv}. Eine Seite des Ergebnisses sieht dann etwa so aus:
+ Diese verarbeiten Sie nun unter Verwendung des Dokuments \File{adrdir.tex}
+ aus \cite{package:adrconv}. Eine Seite des Ergebnisses sieht dann etwa so aus:
\begin{center}
\setlength{\unitlength}{1mm}
\begin{picture}(80,58)
@@ -3485,6 +3505,10 @@ Version von \Package{adrconv} bereits mit \Macro{addrentry} und
%%% Local Variables:
%%% mode: latex
+%%% mode: flyspell
%%% coding: iso-latin-1
+%%% ispell-local-dictionary: "de_DE"
%%% TeX-master: "../guide.tex"
%%% End:
+
+% LocalWords: Paketoption
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrpage2.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrpage2.tex
index 5483bbefa51..17671189bdf 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrpage2.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrpage2.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrpage2.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrpage2.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,9 @@
%
% ============================================================================
-\ProvidesFile{scrpage2.tex}[2012/07/07 KOMA-Script guide (chapter:scrpage2)]
+\KOMAProvidesFile{scrpage2.tex}%
+ [$Date: 2013-07-22 $
+ KOMA-Script guide (chapter:scrpage2)]
\chapter{Kopf- und Fußzeilen mit \Package{scrpage2}}
\labelbase{scrpage}
@@ -58,14 +60,30 @@ Inhalt der Kopf- und Fußzeilen gibt. Bereits seit 2001 wird hierfür nicht mehr
\Package{scrpage2} verwendet. Diese Anleitung beschreibt daher auch nur noch
\Package{scrpage2}. Das Paket \Package{scrpage} ist obsolet.
+Mit \KOMAScript~3.12 wurde außerdem das komplett neu implementierte Paket
+\Package{scrlayer-scrpage} vorgestellt, das eine konsequente Weiterführung des
+Designs von \Package{scrpage2} mit anderen Mitteln darstellt. Siehe dazu
+\autoref{cha:scrlayer-scrpage} ab \autopageref{cha:scrlayer-scrpage}. Während
+\Package{scrpage2} die erweiterte Optionen-Schnittstelle der
+\KOMAScript-Klassen nicht unterstützt, kommt diese in
+\Package{scrlayer-scrpage} selbstverständlich zum Einsatz. Da der Ansatz von
+\Package{scrlayer-scrpage} gegenüber \Package{scrpage2} als überlegen
+betrachtet wird, wird somit empfohlen, \Package{scrlayer-scrpage} an Stelle
+von \Package{scrpage2} zu verwenden. Die aktuelle Version von
+\Package{scrpage2} ist daher auch als final zu betrachten. Sämtliche
+Entwicklungsresourcen im Bereich Kopf- und Fußzeilen werden zukünftig in
+\Package{scrlayer-scrpage} einfließen.
+
\begin{Explain}
- An Stelle von \Package{scrpage2} kann natürlich auch \Package{fancyhdr}
- (siehe \cite{package:fancyhdr}) verwendet werden. \Package{scrpage2}
- harmoniert jedoch mit den \KOMAScript-Klassen deutlich besser. Genau deshalb
- und weil der Vorläufer von \Package{fancyhdr} damals viele Möglichkeiten
- vermissen lies, ist \Package{scrpage2} entstanden. Natürlich ist das Paket
- \Package{scrpage2} nicht an eine \KOMAScript-Klasse gebunden, sondern kann
- auch sehr gut mit anderen Klassen verwendet werden.
+ An Stelle von \Package{scrpage2} oder \Package{scrlayer-scrpage} kann
+ natürlich auch \Package{fancyhdr} (siehe \cite{package:fancyhdr}) verwendet
+ werden. \Package{scrpage2} und insbesondere \Package{scrlayer-scrpage}
+ harmonieren jedoch mit den \KOMAScript-Klassen deutlich besser. Genau
+ deshalb und weil der Vorläufer von \Package{fancyhdr} damals viele
+ Möglichkeiten vermissen lies, ist \Package{scrpage2} entstanden. Natürlich
+ ist das Paket \Package{scrpage2} ebenso wie das Paket
+ \Package{scrlayer-scrpage} nicht an eine \KOMAScript-Klasse gebunden,
+ sondern kann auch sehr gut mit anderen Klassen verwendet werden.
\end{Explain}
\section{Grundlegende Funktionen}\label{sec:scrpage.basics}
@@ -743,7 +761,7 @@ Farbe\Index{Kopf>Farbe}\Index{Fuss=Fuß>Farbe}\Index{Farbe>im
\FontElement{footbottomline}\IndexFontElement[indexmain]{footbottomline} oder
auch \FontElement{footbotline}\IndexFontElement[indexmain]{footbotline}
gesetzt und mit \Macro{addtokomafont}\IndexCmd{addtokomafont} erweitert
-werden. Die beiden Anweisungen \Macro{setkomafont} und \Macro{addkomafont}
+werden. Die beiden Anweisungen \Macro{setkomafont} und \Macro{addtokomafont}
sind in \autoref{sec:maincls.textmarkup},
\autopageref{desc:maincls.cmd.setkomafont} näher beschrieben.
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/tocbasic.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/tocbasic.tex
index aa6e50df240..d470aae319b 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/tocbasic.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/tocbasic.tex
@@ -1,6 +1,6 @@
% ======================================================================
% tocbasic.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% tocbasic.tex
-% Copyright (c) Markus Kohm, 2002-2012
+% Copyright (c) Markus Kohm, 2002-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,7 @@
%
% ======================================================================
-\ProvidesFile{tocbasic.tex}[2012/03/14 KOMA-Script package tocbasic]
+\ProvidesFile{tocbasic.tex}[2013/10/02 KOMA-Script package tocbasic]
\chapter{Verzeichnisse verwalten mit Hilfe von \Package{tocbasic}}
\labelbase{tocbasic}
@@ -65,6 +65,13 @@ werden. Durch Verwendung von \Package{tocbasic} soll dem Paketautor die Mühe
genommen werden, selbst solche Anpassungen an andere Pakete oder an Klassen
vornehmen zu müssen.
+Als kleiner Nebeneffekt kann das Paket auch verwendet werden, um neue
+Gleitumgebungen oder den Gleitumgebungen ähnliche nicht gleitende Umgebungen
+für Konsultationsobjekte zu definieren. Näheres dazu ist nach den
+grundlegenden Anweisungen in \autoref{sec:tocbasic.toc}, verdeutlicht durch
+ein Beispiel in \autoref{sec:tocbasic.example} und kompakt in
+\autoref{sec:tocbasic.declarenewtoc} zu finden.
+
\KOMAScript{} verwendet \Package{tocbasic} sowohl für das Inhaltsverzeichnis
als auch für die bereits erwähnten Verzeichnisse für Abbildungen und Tabellen.
@@ -77,7 +84,7 @@ bekannten Dateierweiterungen\textnote{Dateierweiterung, Verzeichnis}, die für
Verzeichnisse stehen, zu verwalten. Einträge in Dateien mit solchen
Dateierweiterungen werden typischerweise mit
\Macro{addtocontents}\important{\Macro{addtocontents},
- \Macro{addcontentsline}} oder \Macro{addcontentsline} vorgenommen. Darüber
+ \Macro{addxcontentsline}} oder \Macro{addxcontentsline} vorgenommen. Darüber
hinaus gibt es Anweisungen, mit denen eine Aktion für all diese
Dateierweiterungen durchgeführt werden können. Außerdem gibt es Anweisungen,
um Einstellungen für die Datei vorzunehmen, die zu einer gegebenen
@@ -365,23 +372,69 @@ wie bei \Macro{addtocontents} mit \Macro{protect} geschützt werden.
\begin{Declaration}
- \Macro{addcontentslinetoeachtocfile}\OParameter{Besitzer}\Parameter{Ebene}\Parameter{Inhalt}
+ \Macro{addxcontentsline}\Parameter{Dateierweiterung}\Parameter{Ebene}%
+ \OParameter{Gliederungsnummer}\Parameter{Inhalt}
+\end{Declaration}
+\BeginIndex{Cmd}{addxcontentsline}%
+Diese\ChangedAt{v3.12}{\Package{tocbasic}}
+Anweisung ähnelt sehr der Anweisung
+\Macro{addcontentsline}\IndexCmd{addcontentsline} aus dem
+\LaTeX-Kern. Allerdings besitzt sie ein zusätzliches optionales Argument für
+die \PName{Gliederungsnummer} des Eintrags, während diese bei
+\Macro{addcontentsline} im Argument \PName{Inhalt} mit angegeben wird. Die
+Anweisung wird verwendet, um nummerierte oder nicht nummerierte Einträge in
+das über die \PName{Dateierweiterung} spezifierte Verzeichnis
+aufzunehmen. Dabei ist \PName{Ebene} der symbolische Name der Gliederungsebene
+und \PName{Inhalt} der entsprechende Eintrag. Die Seitenzahl wird automatisch
+bestimmt.
+
+Die Anweisung selbst testet zunächst, ob eine Anweisung
+\Macro{add\PName{Ebene}\PName{Dateierweiterung}entry} definiert ist. Wenn dies
+der Fall ist, wird diese für den Eintrag verwendet, wobei
+\PName{Gliederungsnummer} als optionales Argument in \PName{Inhalt} als
+obligatorisches Argument übergeben wird. Ein Beispiel für eine solche
+Anweisung, die von den \KOMAScript-Klassen bereitgestellt wird, wäre
+\Macro{addparttocentry} (siehe \autoref{sec:maincls-experts.experts},
+\autopageref{desc:maincls-experts.cmd.addparttocentry}). Ist die entsprechend
+Anweisung nicht definiert, wird stattdessen die interne Anweisung
+\Macro{tocbasic@addxcontentsline} verwendet. Diese erhält alle vier Argument
+als obligatorische Argumente und verwendet dann seinerseits
+\Macro{addcontentsline}, um den gewünschten Eintrag vorzunehmen. Näheres zu
+\Macro{tocbasic@addxcontentsline} ist \autoref{sec:tocbasic.internals},
+\autopageref{desc:tocbasic.cmd.tocbasic@addxcontentsline} zu entnehmen.
+
+Ein Vorteil der Verwendung von \Macro{addxcontentsline} gegenüber
+\Macro{addcontentsline} ist zum einen, dass die Eigenschaft
+\PValue{numberline} (siehe \autopageref{desc:tocbasic.cmd.setuptoc}) beachtet
+wird. Zum anderen kann die Form der Einträge über die Definition
+entsprechender, für die \PName{Ebene} und \PName{Dateierweiterung}
+spezifischer Anweisungen konfiguriert werden.%
+%
+\EndIndex{Cmd}{addxcontentsline}%
+
+
+\begin{Declaration}
+ \Macro{addxcontentslinetoeachtocfile}%
+ \OParameter{Besitzer}\Parameter{Ebene}\OParameter{Gliederungsnummer}%
+ \Parameter{Inhalt}\\
+ \Macro{addcontentslinetoeachtocfile}%
+ \OParameter{Besitzer}\Parameter{Ebene}\Parameter{Inhalt}%
\end{Declaration}
\BeginIndex{Cmd}{addcontentslinetoeachtocfile}%
-Diese Anweisung ist mit \Macro{addcontentsline} aus dem \LaTeX-Kern
-vergleichbar. Der Unterschied besteht darin, dass diese Anweisung
-\PName{Inhalt} nicht nur in eine einzelne Datei, sondern in alle Dateien eines
-angegebenen \PName{Besitzers} und bei Verzicht auf das optionale Argument in
-alle Dateien aus der Liste der bekannten Dateierweiterungen schreibt.
+Diese Anweisungen sind mit der oben erklärten Anweisung
+\Macro{addxcontentsline}\ChangedAt{v3.12}{\Package{tocbasic}}
+beziehungsweise \Macro{addcontentsline} aus dem \LaTeX-Kern vergleichbar. Der
+Unterschied besteht darin, dass diese Anweisungen \PName{Inhalt} nicht nur in
+eine einzelne Datei, sondern in alle Dateien eines angegebenen
+\PName{Besitzers} und bei Verzicht auf das erste optionale Argument in alle
+Dateien aus der Liste der bekannten Dateierweiterungen schreibt.
\begin{Example}
Angenommen, Sie sind Klassen-Autor und wollen den Kapiteleintrag nicht nur in
das Inhaltsverzeichnis, sondern in alle Verzeichnisdateien schreiben. Nehmen
wir weiter an, dass aktuell \PName{\#1} den Titel enthält, der geschrieben
werden soll.
\begin{lstcode}
- \addcontentslinetoeachtocfile{chapter}{%
- \protect\numberline{\thechapter}#1%
- }%
+ \addxcontentslinetoeachtocfile{chapter}[\thechapter]{#1}
\end{lstcode}
In diesem Fall soll natürlich die aktuelle Kapitelnummer direkt beim
Schreiben in die Verzeichnisdatei expandiert werden, weshalb sie nicht mit
@@ -390,7 +443,14 @@ alle Dateien aus der Liste der bekannten Dateierweiterungen schreibt.
Während des Schreibens von \PName{Inhalt} ist auch hier wie schon bei
\Macro{addtoeachtocfile}
\Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} die
-Dateierweiterung der Datei, in die aktuell geschrieben wird.
+Dateierweiterung der Datei, in die aktuell geschrieben wird.%
+
+Anweisung\ChangedAt{v3.12}{\Package{tocbasic}}
+\Macro{addxcontentslinetoeachtocfile} ist wann immer möglich gegenüber
+\Macro{addcontentslinetoeachtocfile} der Vorrang zu gewähren, da die
+Erweiterungen von \Macro{addxcontentsline} nur damit Anwendung finden. Näheres
+zu diesen Erweiterungen und Vorteilen ist in der vorausgehenden Erklärung der
+Anweisung \Macro{addxcontentsline} zu finden.%
%
\EndIndex{Cmd}{addcontentslinetoeachtocfile}%
@@ -626,6 +686,27 @@ getrennte Aneinanderreihung von \PName{Eigenschaften}. Das Paket
\OptionValue{listof}{leveldown}\important{\OptionValue{listof}{leveldown}}%
\IndexOption{listof~=\PValue{leveldown}}
für alle Dateierweiterungen des Besitzers \PValue{float}.
+\item[\PValue{numberline}] \ChangedAt{v3.12}{\Package{tocbasic}}%
+ bedeutet, dass auch diejenigen Einträge, die mit \Macro{addxcontentsline}
+ oder \Macro{addxcontentslinetoceachtocfile} in das Verzeichnis geschrieben
+ werden und bei denen das optionale Argument für die Nummer fehlt oder leer
+ ist, mit einer (leeren) \Macro{numberline}-Anweisung verstehen werden. Das
+ führt in der Regel dazu, dass diese Einträge nicht linksbündig mit der
+ Nummer, sondern mit dem Text der nummerierten Einträge gleicher Ebene
+ gesetzt werden. Die \KOMAScript-Klassen setzen diese Eigenschaft bei
+ Verwendung der Option \OptionValue{listof}{numberline}%
+ \important{\OptionValue{listof}{numberline}}%
+ \IndexOption{listof~=\PValue{numberline}} für die Dateierweiterungen des
+ Besitzers \PValue{float} und bei Verwendung der Option
+ \OptionValue{toc}{numberline}\important{\OptionValue{toc}{numberline}}%
+ \IndexOption{toc~=\PValue{numberline}} für die Dateierweiterung
+ \PValue{toc}. Entsprechend wird die Eigenschaft bei Verwendung von Option
+ \OptionValue{listof}{nonumberline}%
+ \important{\OptionValue{listof}{nonumberline}}%
+ \IndexOption{listof~=\PValue{nonumberline}} oder
+ \OptionValue{toc}{nonumberline}%
+ \important{\OptionValue{toc}{nonumberline}}%
+ \IndexOption{toc~=\PValue{nonumberline}} wieder zurückgesetzt.
\item[\PValue{nobabel}] bedeutet, dass die normalerweise automatisch
verwendete Erweiterung für die Sprachumschaltung mit
\Package{babel}\IndexPackage{babel} für diese Dateierweiterung nicht
@@ -919,6 +1000,33 @@ definiert \Macro{tocbasic@listhead} diese und ruft sie dann auf.
%
\EndIndex{Cmd}{tocbasic@listhead@\PName{Dateierweiterung}}
+\begin{Declaration}
+ \Macro{tocbasic@addxcontentsline}%
+ \Parameter{Dateierweiterung}\Parameter{Ebene}%
+ \Parameter{Gliederungsnummer}\Parameter{Eintrag}\\
+ \Macro{nonumberline}
+\end{Declaration}
+\BeginIndex{Cmd}{tocbasic@addxcontentsline}%
+\BeginIndex{Cmd}{nonumberline}%
+Die\ChangedAt{v3.12}{\Package{tocbasic}} Anweisung
+\Macro{tocbasic@addxcontentsline} nimmt einen \PName{Eintrag} der angegebenen
+\PName{Ebene} in das über die \PName{Dateierweiterung} spezifizierte
+Verzeichnis vor. Ob der Eintrag nummeriert wird oder nicht, hängt davon ab, ob
+das Argument \PName{Gliederungsnummer} leer ist oder nicht. Im Falle eines
+leeren Argument wird dem \PName{Eintrag} ein \Macro{nonumberline} ohne
+Argument vorangestellt. Anderenfalls wird wie gewohnt \Macro{numberline} mit
+\PName{Gliederungsnummer} als Argument verwendet.
+
+Die Anweisung \PName{nonumberline} wird innerhalb \Macro{listoftoc} (siehe
+\autoref{sec:tocbasic.toc}, \autopageref{desc:tocbasic.cmd.listoftoc})
+entsprechend der Eigenschaft \PValue{numberline} (siehe
+\autoref{sec:tocbasic.toc}, \autopageref{desc:tocbasic.cmd.setuptoc})
+umdefiniert. Dadurch wirkt sich das Setzen oder Löschen dieser Eigenschaft
+bereits beim nächsten \LaTeX-Lauf aus.%
+%
+\EndIndex{Cmd}{nonumberline}%
+\EndIndex{Cmd}{tocbasic@addxcontentsline}%
+
\section{Ein komplettes Beispiel}
\label{sec:tocbasic.example}
@@ -1256,6 +1364,81 @@ die möglichen Optionen bietet \autoref{tab:tocbasic.DeclareNewTOC-options}.
die Option \Option{nonfloat} angegeben, wird außerdem eine nicht gleitende
Umgebung \Environment{remarkbox-} definiert, in der ebenfalls
\Macro{caption}\IndexCmd{caption} verwendet werden kann.
+
+ Zum besseren Verständnis zeigt \autoref{tab:tocbasic.comparison} eine
+ Gegenüberstellung der Anweisungen und Umgebungen für die neu erstellte
+ Beispielumgebung \Environment{remarkbox} mit den entsprechenden Befehlen und
+ Umgebungen für Abbildungen.%
+ \begin{table}
+ \centering
+ \caption{Gegenüberstellung von Beispielumgebung \Environment{remarkbox}
+ und Umgebung \Environment{figure}}
+ \label{tab:tocbasic.comparison}
+ \begin{tabularx}{\textwidth}{ll>{\raggedright}p{7em}X}
+ \toprule
+ \Environment{remarkbox} & \Environment{figure}
+ & Optionen von \Macro{DeclareNewTOC} & Kurzbeschreibung \\[1ex]
+ \midrule
+ \Environment{remarkbox} & \Environment{figure}
+ & \Option{type}, \Option{float}
+ & Gleitumgebung des jeweiligen Typs.\\[1ex]
+ \Environment{remarkbox*} & \Environment{figure*}
+ & \Option{type}, \Option{float}
+ & spaltenübergreifende Gleitumgebung des jeweiligen Typs \\[1ex]
+ \Counter{remarkbox} & \Counter{figure}
+ & \Option{type}, \Option{float}
+ & Zähler, der von \Macro{caption} verwendet wird \\[1ex]
+ \Macro{theremarkbox} & \Macro{thefigure}
+ & \Option{type}, \Option{float}
+ & Anweisung zur Ausgabe des jeweiligen Zählers \\[1ex]
+ \Macro{remarkboxformat} & \Macro{figureformat}
+ & \Option{type}, \Option{float}
+ & Anweisung zur Formatierung des jeweiligen Zählers in der Ausgabe von
+ \Macro{caption}\\[1ex]
+ \Macro{remarkboxname} & \Macro{figurename}
+ & \Option{type}, \Option{float}, \Option{name}
+ & Name, der im Label von \Macro{caption} verwendet wird \\[1ex]
+ \Macro{listofremarkboxes} & \Macro{listoffigures}
+ & \Option{types}, \Option{float}
+ & Anweisung zur Ausgabe des jeweiligen Verzeichnisses \\[1ex]
+ \Macro{listremarboxname} & \Macro{listfigurename}
+ & \Option{type}, \Option{float}, \Option{listname}
+ & Überschrift des jeweiligen Verzeichnisses \\[1ex]
+ \Macro{fps@remarkbox} & \Macro{fps@figure}
+ & \Option{type}, \Option{float}, \Option{floattype}
+ & nummerischer Gleitumge\-bungstyp zwecks Reihen\-fol\-gen\-erhalts \\[1ex]
+ \File{lor} & \File{lof}
+ &
+ & Dateiendung der Hilfsdatei für das jeweilige Verzeichnis \\
+ \bottomrule
+ \end{tabularx}
+ \end{table}
+
+ Und hier nun eine mögliche Verwendung der Umgebung:
+\begin{lstcode}
+ \begin{remarkbox}
+ \centering
+ Gleiches sollte immer auf gleiche Weise und
+ mit gleichem Aussehen gesetzt werden.
+ \caption{Erster Hauptsatz der Typografie}
+ \label{rem:typo1}
+ \end{remarkbox}
+\end{lstcode}
+ Ein Ausschitt aus einer Beispielseite mit dieser Umgebung könnte dann so
+ aussehen:
+ \begin{center}\footnotesize
+ \begin{tabular}
+ {|!{\hspace{.1\linewidth}}p{.55\linewidth}!{\hspace{.1\linewidth}}|}
+ \\
+ \centering
+ Gleiches sollte immer auf gleiche Weise und
+ mit gleichem Aussehen gesetzt werden.\\[\abovecaptionskip]
+ {%
+ \usekomafont{caption}\footnotesize{\usekomafont{captionlabel}%
+ Merksatz 1: }Erster Hauptsatz der Typografie
+ }\\
+ \end{tabular}%
+ \end{center}%
\end{Example}%
%
\EndIndex{Cmd}{DeclareNewTOC}%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex
index dddf176f5d5..aaf5a99c47b 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex
@@ -1,6 +1,6 @@
% ======================================================================
% typearea-experts.tex
-% Copyright (c) Markus Kohm, 2008-2012
+% Copyright (c) Markus Kohm, 2008-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% typearea-experts.tex
-% Copyright (c) Markus Kohm, 2008-2012
+% Copyright (c) Markus Kohm, 2008-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,7 +45,7 @@
%
% ======================================================================
-\ProvidesFile{typearea-experts.tex}[2012/04/17 KOMA-Script guide (chapter:
+\ProvidesFile{typearea-experts.tex}[2013/05/31 KOMA-Script guide (chapter:
typearea for experts)]
\chapter{Zusätzliche Informationen zum Paket \Package{typearea.sty}}
@@ -111,21 +111,25 @@ Einstellungen wieder zu reaktivieren.
\documentclass[pagesize]{scrartcl}
\begin{document}
- \rule{\textwidth}{\textheight}
+ \noindent\rule{\textwidth}{\textheight}
\storeareas\meinegespeichertenWerte
\KOMAoptions{paper=landscape,DIV=current}
- \rule{\textwidth}{\textheight}
+ \noindent\rule{\textwidth}{\textheight}
\clearpage
\meinegespeichertenWerte
- \rule{\textwidth}{\textheight}
+ \noindent\rule{\textwidth}{\textheight}
\end{document}
\end{lstcode}
Wichtig\textnote{Achtung!} ist dabei die Anweisung \Macro{clearpage} vor dem
Aufruf von \Macro{meinegespeichertenWerte}, damit die Wiederherstellung erst
auf der nächsten Seite erfolgt.
\end{Example}
+Im Beispiel wird \Macro{noindent} verwendet, um den normalen Absatzeinzug vor
+den schwarzen Kästen zu verhindern. Sie würden sonst kein korrektes Bilde des
+Seitenlayouts wiedergeben.
+
Bei\textnote{Achtung!} der Verwendung von \Macro{storeareas} ist zu beachten,
dass sowohl \Macro{storeareas} als auch die damit definierte \PName{Anweisung}
nicht innerhalb einer Gruppe aufgerufen werden sollten. Die Definition der
@@ -148,7 +152,8 @@ Diese Anweisungen dienen der Verwaltung zweier
ermöglichen es dem Experten jedes Mal, nachdem \Package{typearea} eine neue
Aufteilung in Satzspiegel und Ränder berechnet hat, also nach jeder impliziten
oder expliziten Ausführung von \Macro{typearea}, \PName{Anweisungen} ausführen
-zu lassen. Entsprechendes leisten \Macro{AfterSettingArea} und dessen
+zu lassen. Entsprechendes leisten
+\Macro{AfterSettingArea}\ChangedAt{v3.11}{\Package{typearea}} und dessen
Stern-Form für die Ausführung von \Macro{areaset}. Die Normalformen arbeiten
dabei global, während die Änderungen durch die Sternformen nur lokal wirksam
sind. Die \PName{Anweisungen} werden jeweils unmittelbar vor
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea.tex
index 1c2c74c78a6..d5d273e3e7f 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea.tex
@@ -1,6 +1,6 @@
% ======================================================================
% typearea.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% typearea.tex
-% Copyright (c) Markus Kohm, 2001-2012
+% Copyright (c) Markus Kohm, 2001-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,9 @@
% ======================================================================
-\ProvidesFile{typearea.tex}[2012/07/22 KOMA-Script guide (chapter: typearea)]
+\KOMAProvidesFile{typearea.tex}%
+ [$Date: 2013-12-16 09:10:28 +0100 (Mo, 16. Dez 2013) $
+ KOMA-Script guide (chapter: typearea)]
\chapter{Satzspiegelberechnung mit \Package{typearea.sty}}
\labelbase{typearea}
@@ -288,7 +290,7 @@ Paketautoren.
Damit sind alle Grundlagen der Satzspiegelberechnung, die bei
{\KOMAScript} eine Rolle spielen, erklärt.
-\iftrue% Umbruchkorrektur
+\iffalse% Umbruchkorrektur
Wir können also mit den konkreten Konstruktionen beginnen.
\else
In den folgenden beiden Abschnitten werden die von {\KOMAScript} angebotenen
@@ -424,24 +426,25 @@ Paketautoren.
Textbereichs der Breite der Seite entspricht. Das genaue Verfahren ist
beispielsweise in \cite{JTsch87} nachzulesen.
- Als Nachteil dieses spätmittelalterlichen Buchseitenkanons ergibt
- sich, dass die Breite des Textbereichs nicht mehr von der Schriftart
- abhängt. Es wird also nicht mehr der zur Schrift passende
- Textbereich gewählt, stattdessen muss der Autor oder Setzer unbedingt die zum
- Textbereich passende Schrift wählen.
-\iffalse
+ Als Nachteil dieses spätmittelalterlichen Buchseitenkanons ergibt sich, dass
+ die Breite des Textbereichs nicht mehr von der Schriftart abhängt. Es wird
+ also nicht mehr der zur Schrift passende Textbereich gewählt, stattdessen
+ muss der Autor oder Setzer unbedingt die zum Textbereich passende Schrift
+ wählen.
+%
+\iftrue
% Umbruchkorrekturtext
Dies ist als zwingend zu betrachten.
\fi
- Im \Package{typearea}-Paket wird diese Konstruktion dahingehend
- abgewandelt, dass durch Auswahl eines ausgezeichneten -- normalerweise
- unsinnigen -- \Var{DIV}-Wertes oder eine spezielle Paket-Option
- derjenige \Var{DIV}-Wert ermittelt wird, bei dem der resultierende
- Satzspiegel dem spätmittelalterlichen Buchseitenkanon am nächsten
- kommt. Es wird also wiederum auf die Satzspiegelkonstruktion durch Teilung
- zurückgegriffen.
-\iffalse
+ Im \Package{typearea}-Paket wird diese Konstruktion dahingehend abgewandelt,
+ dass durch Auswahl eines ausgezeichneten -- normalerweise unsinnigen --
+ \Var{DIV}-Wertes oder eine spezielle Paket-Option derjenige \Var{DIV}-Wert
+ ermittelt wird, bei dem der resultierende Satzspiegel dem
+ spätmittelalterlichen Buchseitenkanon am nächsten kommt. Es wird also
+ wiederum auf die Satzspiegelkonstruktion durch Teilung zurückgegriffen.
+%
+\iftrue
% Umbruchkorrekturtext
Bei Wahl einer guten Schrift stimmt dieses Ergebnis nicht selten mit der
Suche nach dem optimalen \Var{DIV}-Wert überein. Siehe hierzu ebenfalls
@@ -452,8 +455,6 @@ Paketautoren.
\LoadCommon{0} % \section{Frühe oder späte Optionenwahl}
-\iffree{}{\vfill}% Umbruchoptimierung
-
\LoadCommon{1} % \section{Kompatibilität zu früheren Versionen von \KOMAScript}
\section{Einstellung des Satzspiegels und der \texorpdfstring{Seitenauf"|teilung}{Seitenaufteilung}}
@@ -665,13 +666,13 @@ sehr rasch zu unangenehm hoher Zeichenzahl je Zeile führen. Siehe hierzu die
Überlegungen in \autoref{sec:typearea.basics}. Wird ein anderes Papierformat
gewählt, so berechnet \Package{typearea} selbst einen guten \Var{DIV}-Wert.
Natürlich können Sie diese Berechnung auch für A4 wählen. Hierzu verwenden Sie
-einfach die Option \OptionValue{DIV}{calc}\important{\OptionValue{DIV}{calc}}
-an Stelle von \KOption{DIV}\PName{Faktor}. Selbstverständlich können Sie
-diese Option auch explizit bei allen anderen Papierformaten angeben. Wenn Sie
-die automatische Berechnung wünschen, ist diese Angabe sogar sinnvoll, da die
-Möglichkeit besteht, in einer Konfigurationsdatei andere Voreinstellungen zu
-setzen (siehe \autoref{sec:typearea-experts.cfg}). Eine explizit angegebene
-Option \OptionValue{DIV}{calc} überschreibt diese Vorkonfiguration aber.
+\OptionValue{DIV}{calc}\important{\OptionValue{DIV}{calc}} an Stelle von
+\KOption{DIV}\PName{Faktor}. Selbstverständlich können Sie diese Option auch
+explizit bei allen anderen Papierformaten angeben. Wenn Sie die automatische
+Berechnung wünschen, ist diese Angabe sogar sinnvoll, da die Möglichkeit
+besteht, in einer Konfigurationsdatei andere Voreinstellungen zu setzen (siehe
+\autoref{sec:typearea-experts.cfg}). Eine explizit angegebene Option
+\OptionValue{DIV}{calc} überschreibt diese Vorkonfiguration aber.
\begin{table}
% \centering
@@ -693,7 +694,6 @@ Option \OptionValue{DIV}{calc} überschreibt diese Vorkonfiguration aber.
\end{table}
\iffree{}{\BeginIndex{Option}{DIV~=\PValue{classic}}}%
-\looseness=1 % Umbruchoptimierung!!!
Die in \autoref{sec:typearea.circleConstruction} erwähnte klassische
Konstruktion, der mittelalterliche Buchseitenkanon, ist ebenfalls auswählbar.
Verwenden Sie in diesem Fall an Stelle von \KOption{DIV}\PName{Faktor} oder
@@ -804,7 +804,7 @@ andere Schrift lädt.
\begin{table}
\caption[{Symbolische Werte für Option \Option{DIV} und das
\PName{DIV}-Argument von \Macro{typearea}}]{Mögliche symbolische Werte
- für die Option \Option{DIV} oder das \PName{DIV}-Argument von
+ für die Option \Option{DIV} oder das \PName{DIV}-Argument der Anweisung
\Macro{typearea}\OParameter{BCOR}\Parameter{DIV}}
\label{tab:symbolicDIV}
\begin{desctabular}
@@ -847,12 +847,14 @@ normalen der Satzspiegel für diesen Zeilenabstand neu berechnet werden.
\linespread{1.25}
\KOMAoptions{DIV=last}
\end{lstcode}\IndexCmd{linespread}
- \looseness=1 % Umbruchkorrektur
Da \Package{typearea} selbst immer die Anweisung \Macro{normalsize} bei
Berechnung eines neuen Satzspiegels ausführt, ist es nicht zwingend
notwendig, nach \Macro{linespread} den gewählten Durchschuss mit
- \Macro{selectfont} zu aktivieren, damit dieser auch tatsächlich für die
- Neuberechnung verwendet wird.
+ \Macro{selectfont} zu aktivieren, damit dieser %
+\iffalse % Umbruchkorrektur
+ auch tatsächlich
+\fi %
+ für die Neuberechnung verwendet wird.
Das gleiche Beispiel sähe unter Verwendung des
\Package{setspace}-Pakets (siehe \cite{package:setspace}) wie folgt
@@ -860,8 +862,7 @@ normalen der Satzspiegel für diesen Zeilenabstand neu berechnet werden.
\begin{lstcode}
\documentclass[10pt,twoside,BCOR=12mm,DIV=calc]
{scrreprt}
- \usepackage{setspace}
- \onehalfspacing
+ \usepackage[onehalfspacing]{setspace}
\KOMAoptions{DIV=last}
\end{lstcode}
\end{Example}
@@ -869,31 +870,41 @@ normalen der Satzspiegel für diesen Zeilenabstand neu berechnet werden.
Wie\textnote{Tipp!} man an dem Beispiel sieht, spart man sich mit dem
\Package{setspace}-Paket das Wissen um den korrekten Dehnungswert. Dies gilt
allerdings nur für die Standardschriftgrößen 10\Unit{pt}, 11\Unit{pt} und
-12\Unit{pt}. Für alle anderen Schriftgrößen verwendet das Paket einen
-näherungsweise passenden Dehnungswert.
+12\Unit{pt}. Für alle anderen Schriftgrößen verwendet das Paket
+%
+\iffalse % Umbruchkorrektur
+einen näherungsweise passenden Dehnungswert.
+%
+\else %
+eine Näherung.
+\fi
An\textnote{Achtung!} dieser Stelle erscheint es mir angebracht, darauf
hinzuweisen, dass der Zeilenabstand für die Titelseite wieder auf den normalen
-Wert zurückgesetzt werden sollte.
+Wert zurückgesetzt werden sollte und außerdem auch die Verzeichnisse mit dem
+normalen Zeilenabstand gesetzt werden sollten.
\begin{Example}
Ein vollständiges Beispiel wäre also:
\begin{lstcode}
\documentclass[10pt,twoside,BCOR=12mm,DIV=calc]
{scrreprt}
- \usepackage{setspace}
- \onehalfspacing
+ \usepackage[onehalfspacing]{setspace}
+ \AfterTOCHead{\singlespacing}
\KOMAoptions{DIV=last}
\begin{document}
\title{Titel}
\author{Markus Kohm}
\begin{spacing}{1}
\maketitle
- \tableofcontents
\end{spacing}
+ \tableofcontents
\chapter{Ok}
\end{document}
\end{lstcode}
- Siehe hierzu auch die Anmerkungen in \autoref{sec:typearea.tips}.
+ Siehe hierzu auch die Anmerkungen in \autoref{sec:typearea.tips}. Die
+ Anweisung \Macro{AfterTOCHead}\IndexCmd{AfterTOCHead} wird in
+ \autoref{part:forExperts}, \autoref{cha:tocbasic} auf
+ \autopageref{desc:tocbasic.cmd.AfterTOCHead} vorgestellt.
\end{Example}
Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Optionen auch zur
@@ -956,14 +967,13 @@ bei der Änderung für \PName{DIV} und dann zusätzlich bei der Änderung für
Seitenumbruch.
\end{Explain}
-\begin{sloppypar}% Umbruchoptimierung!!!
-Da \Macro{KOMAoption}\PParameter{DIV}\PParameter{last},
-\Macro{KOMAoptions}\PParameter{DIV=last} oder
+Da\important{\Macro{recalctypearea}}
+\Macro{KOMAoption}\PParameter{DIV}\PParameter{last} oder
+\Macro{KOMAoptions}\PParameter{DIV=last} beziehungsweise
\Macro{typearea}\POParameter{current}\PParameter{last} für die Neuberechnung
-des Satzspiegels und der Ränder recht häufig benötigt
-werden, gibt es dafür die abkürzende Anweisung
+des Satzspiegels und der Ränder recht häufig benötigt werden, gibt es dafür
+die abkürzende Anweisung
\Macro{recalctypearea}\ChangedAt{v3.00}{\Package{typearea}}.
-\end{sloppypar}
\begin{Example}
Wenn Ihnen die Schreibweisen
\begin{lstcode}
@@ -1009,21 +1019,19 @@ doppelseitiger Satz verwendet. Deaktivieren der
Option\important{\OptionValue{twoside}{false}} führt zu einseitigem Satz.
\begin{table}
-% \begin{minipage}{\linewidth}
% \centering
% \caption
\KOMAoptions{captions=topbeside}\setcapindent{0pt}
- \begin{captionbeside}
- [{Standardwerte für einfache Schalter in \KOMAScript}]
- {\label{tab:truefalseswitch}Standardwerte für alle einfachen Schalter in \KOMAScript}
+ \begin{captionbeside}%
+ [{Standardwerte für einfache Schalter in \KOMAScript}]%
+ {\label{tab:truefalseswitch}Standardwerte für alle einfachen Schalter in
+ \KOMAScript}%
[l]
\begin{tabular}[t]{ll}
\toprule
Wert & Bedeutung \\
\midrule
- \PValue{true}\footnote{Dieser Wert wird auch
- eingesetzt, wenn die entsprechende Option ohne Wertangabe verwendet
- wird.} & aktiviert die Option\\
+ \PValue{true} & aktiviert die Option\\
\PValue{on} & aktiviert die Option \\
\PValue{yes} & aktiviert die Option \\
\PValue{false}& deaktiviert die Option \\
@@ -1032,7 +1040,6 @@ Option\important{\OptionValue{twoside}{false}} führt zu einseitigem Satz.
\bottomrule
\end{tabular}
\end{captionbeside}
-% \end{minipage}
\end{table}
\iffree{}{\BeginIndex{Option}{twoside~=\PValue{semi}}}%
@@ -1040,13 +1047,26 @@ Außer den Werten aus \autoref{tab:truefalseswitch} kann jedoch auch noch der
Wert \PValue{semi}\ChangedAt{v3.00}{\Package{typearea}}%
\important{\OptionValue{twoside}{semi}} angegeben werden. Dieser Wert
\PValue{semi} führt zu doppelseitigem Satz mit einseitigen Rändern und
-einseitigen, also nicht alternierenden Marginalien.
-
-Die Option kann wahlweise als Klassenoption bei \Macro{documentclass}, als
+einseitigen, also nicht alternierenden
+Marginalien. Eine\ChangedAt{v3.12}{\Package{typearea}} eventuelle
+Bindekorrektur (siehe Option \Option{BCOR},
+\autopageref{desc:typearea.option.BCOR}) wird jedoch ab \KOMAScript~Version
+3.12 wie beim doppelseitigen Satz auf Seiten mit ungerader Nummer dem linken
+Rand und auf Seiten mit gerader Nummer dem rechten Rand zugeschlagen. Wird auf
+Kompatibilität zu einer Version früheren Version zurückgeschaltet (siehe
+\autoref{sec:typearea.compatibilityOptions},
+\autopageref{sec:typearea.compatibilityOptions}), so ist die Bindekorrektur
+jedoch auch bei \OptionValue{twoside}{semi} immer Teil des linken Randes.
+
+Die Option kann %
+\iffalse % Umbruchkorrektur
+wahlweise
+\fi %
+als Klassenoption bei \Macro{documentclass}, als
Paketoption bei \Macro{usepackage} oder auch nach dem Laden von
\Package{typearea} per \Macro{KOMAoptions} oder \Macro{KOMAoption} gesetzt
werden. Eine Verwendung dieser Option nach dem Laden von \Package{typearea}
-führt dabei\textnote{automatische Neuberechnung} automatisch zur
+führt\textnote{automatische Neuberechnung} automatisch zur
Neuberechnung des Satzspiegels mittels \Macro{recalctypearea} (siehe
\autopageref{desc:typearea.cmd.recalctypearea}). War vor der Option
doppelseitiger Satz aktiv, wird noch vor der Neuberechnung auf die nächste
@@ -1077,11 +1097,15 @@ doppelspaltiger Satz verwendet. Ein
Deaktivieren der Option führt wieder zum voreingestellten,
einspaltigen Satz.
-Die Option kann wahlweise als Klassenoption bei \Macro{documentclass}, als
+Die Option kann %
+\iffalse % Umbruchkorrektur
+wahlweise
+\fi %
+als Klassenoption bei \Macro{documentclass}, als
Paketoption bei \Macro{usepackage} oder auch nach dem Laden von
\Package{typearea} per \Macro{KOMAoptions} oder \Macro{KOMAoption} gesetzt
werden. Eine Verwendung dieser Option nach dem Laden von \Package{typearea}
-führt dabei\textnote{automatische Neuberechnung} automatischen zur
+führt\textnote{automatische Neuberechnung} automatisch zur
Neuberechnung des Satzspiegels mittels \Macro{recalctypearea} (siehe
\autopageref{desc:typearea.cmd.recalctypearea}).%
%
@@ -1114,21 +1138,22 @@ Neuberechnung des Satzspiegels mittels \Macro{recalctypearea} (siehe
leerer Kopf zum Rand zu rechnen sind. Schließlich können sie nicht vom
restlichen Rand unterschieden werden. Ein Fuß, der nur die
Paginierung\Index[indexmain]{Paginierung}\footnote{Unter der Paginierung
- versteht man die Angabe der Seitenzahl.} enthält, wirkt optisch ebenfalls
- eher wie Rand und sollte deshalb zu diesem gerechnet werden. Für die
- optische Wirkung ist dabei unwesentlich, ob der Fuß beim Lesen oder
- Überfliegen leicht als Fuß erkannt werden kann oder nicht. Entscheidend ist,
- wie eine wohlgefüllte Seite bei \emph{unscharfer Betrachtung} wirkt. Dazu
- bedient man sich beispielsweise seiner altersweitsichtigen Großeltern, denen
- man die Brille stibitzt und dann die Seite etwa einen halben Meter von der
- Nasenspitze entfernt hält. In Ermangelung erreichbarer Großeltern kann man
- sich auch damit behelfen, dass man die eigenen Augen auf Fernsicht stellt,
- die Seite aber nur mit ausgestreckten Armen hält. Brillenträger sind hier
- deutlich im Vorteil. Hat man eine Fußzeile, die neben der Paginierung
- weitere, weitschweifige Angaben enthält, beispielsweise einen
- Copyright-Hinweis, so wirkt die Fußzeile eher wie ein etwas abgesetzter Teil
- des Textkörpers. Bei der Berechnung des Satzspiegels sollte das
- berücksichtigt werden.
+ versteht man die Angabe der Seitenzahl, wahlweise innerhalb oder außerhalb
+ des Satzspiegels, meist im Kopf oder Fuß der Seite.} enthält, wirkt
+ optisch ebenfalls eher wie Rand und sollte deshalb zu diesem gerechnet
+ werden. Für die optische Wirkung ist dabei unwesentlich, ob der Fuß beim
+ Lesen oder Überfliegen leicht als Fuß erkannt werden kann oder
+ nicht. Entscheidend ist, wie eine wohlgefüllte Seite bei \emph{unscharfer
+ Betrachtung} wirkt. Dazu bedient man sich beispielsweise seiner
+ altersweitsichtigen Großeltern, denen man die Brille stibitzt und dann die
+ Seite etwa einen halben Meter von der Nasenspitze entfernt hält. In
+ Ermangelung erreichbarer Großeltern kann man sich auch damit behelfen, dass
+ man die eigenen Augen auf Fernsicht stellt, die Seite aber nur mit
+ ausgestreckten Armen hält. Brillenträger sind hier deutlich im Vorteil. Hat
+ man eine Fußzeile, die neben der Paginierung weitere, weitschweifige Angaben
+ enthält, beispielsweise einen Copyright-Hinweis, so wirkt die Fußzeile eher
+ wie ein etwas abgesetzter Teil des Textkörpers. Bei der Berechnung des
+ Satzspiegels sollte das berücksichtigt werden.
Bei der Kopfzeile sieht es noch schwieriger aus. In der Kopfzeile
wird häufig der
@@ -1173,14 +1198,13 @@ angegeben sind. Man kann die Optionen auch ohne Wertzuweisung verwenden. In
diesem Fall wird \PValue{true} als \PName{Ein-Aus-Wert} verwendet, also der
Kopf oder Fuß zum Satzspiegel gerechnet.
-\iffree{}{\enlargethispage{\dp\strutbox}}% Umbruchkorrektur
Wenn Sie unsicher sind, was die richtige Einstellung ist, lesen Sie bitte
obige Erläuterungen. Voreingestellt sind normalerweise
\OptionValue{headinclude}{false} und
\OptionValue{footinclude}{false}. Dies kann sich jedoch bei den
\KOMAScript-Klassen je nach Klassenoption oder bei Verwendung anderer
\KOMAScript-Pakete generell ändern (siehe \autoref{sec:maincls.options} und
-\autoref{cha:scrpage}).
+\iffree{\autoref{cha:scrpage} oder }{}\autoref{cha:scrlayer-scrpage}).
Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Optionen bei
Verwendung einer der \KOMAScript-Klassen als Klassenoptionen oder per
@@ -1249,7 +1273,17 @@ bleiben.
Da es derzeit keine Option gibt, um mehr Platz für die Randnotizen innerhalb
des Textbereichs vorzusehen, gibt es nur eine Möglichkeit, dies zu
- erreichen. Man verzichtet auf die Option \Option{mpinclude} oder setzt
+ erreichen: %
+\iftrue % Umbruchkorrektur
+ Die Anpassung von \Length{textwidth}\IndexLength{textwidth} und
+ \Length{marginparwidth}\IndexLength{marginparwidth} nach der Berechnung des
+ Satzspiegels. Siehe dazu \Macro{AfterCalculatingTypearea} in
+ \autoref{sec:typearea-experts.experts},
+ \autopageref{desc:typearea-experts.cmd.AfterCalculatingTypearea}.
+%
+\else
+%
+ Man verzichtet auf die Option \Option{mpinclude} oder setzt
\Option{mpinclude} auf \PValue{false}, verringert nach der
Satzspiegelberechnung die Breite des Textbereichs \Macro{textwidth} und
setzt die Breite des Bereichs der Randnotizen auf den Wert, um den man die
@@ -1258,6 +1292,8 @@ bleiben.
Demgegenüber wird \Option{mpinclude} bei
\OptionValue{DIV}{calc}\IndexOption{DIV=calc} (siehe
\autopageref{desc:typearea.option.DIV.calc}) berücksichtigt.
+%
+\fi
\end{Explain}
Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Option bei
@@ -1316,8 +1352,9 @@ Erfordernissen anpassen.
\begin{lstcode}
\documentclass[headlines=2.1]{scrartcl}
\end{lstcode}
- Befehle, mit denen dann der Inhalt der zweizeiligen Kopfzeile
- definiert werden kann, sind in \autoref{cha:scrpage} zu finden.
+ Befehle, mit denen dann der Inhalt der zweizeiligen Kopfzeile definiert
+ werden kann, sind in \autoref{cha:scrlayer-scrpage}\iffree{oder
+ \autoref{cha:scrpage}}{} zu finden.
\end{Example}
In einigen Fällen ist es nützlich, wenn man die Kopfhöhe nicht in Zeilen,
@@ -1346,6 +1383,88 @@ Option \Option{DIV} mit den Werten \PValue{last} oder \PValue{current} (siehe
\EndIndex{Option}{headlines~=\PName{Anzahl}}
+\BeginIndex{Option}{footlines~=\PName{Anzahl}}%
+\BeginIndex{Option}{footheight~=\PName{Höhe}}%
+\begin{Declaration}
+ \KOption{footlines}\PName{Zeilenanzahl}\\
+ \KOption{footheight}\PName{Höhe}
+\end{Declaration}%
+Ebenso wie für den Kopf fehlt aber noch die Angabe, wie hoch der Fuß sein
+soll. Hierzu dienen die Optionen \Option{footlines} und
+\Option{footheight}\ChangedAt{v3.12}{\Package{typearea}}. Allerdings ist die
+Höhe des Fußes im Gegensatz zur Höhe des Kopfes keine Länge des \LaTeX-Kerns
+selbst. Daher definiert \Package{typearea} zur Einführung eine neue Länge
+\Length{footheight}\IndexLength[indexmain]{footheight}, falls diese noch nicht
+existiert. Ob diese dann auch beispielsweise von Klassen und Paketen für die
+Gestaltung von Kopf und Fuß verwendet wird, hängt von den verwendeten Klassen
+und Paketen ab. Das \KOMAScript-Paket \Package{scrlayer-scrpage}
+berücksichtigt\iffree{ im Gegensatz zu \Package{scrpage2}}{}
+\Length{footheight} und arbeitet somit aktiv mit \Package{typearea}
+zusammen. Die \KOMAScript-Klassen berücksichtigen \Length{footheight} hingegen
+nicht, da sie ohne Paketunterstützung nur Seitenstile mit einzeilige
+Seitenfüßen anbieten.
+
+Die Option \Option{footlines}\important{\Option{footlines}} setzt man
+vergleichbar zu \Option{headlines} auf die Anzahl der Fußzeilen.
+Normalerweise arbeitet das \Package{typearea}-Paket mit 1,25
+Fußzeilen. Dieser Wert stellt einen Kompromiss dar. Zum einen ist er groß
+genug, um auch für eine über- und unterstrichene Fußzeile (siehe
+\autoref{sec:maincls.options}) Platz zu bieten, zum anderen ist er klein
+genug, um das Randgewicht nicht zu stark zu verändern, wenn mit einer
+einfachen Fußzeile ohne Trennlinien gearbeitet wird. Damit ist der
+voreingestellte Wert in den meisten Standardfällen ein guter Wert. In einigen
+Fällen will oder muss man aber die Fußhöhe genauer den tatsächlichen
+Erfordernissen anpassen.
+
+\begin{Example}
+ Angenommen, im Fuß soll eine zweizeilige Copyright-Angabe gesetzt
+ werden. Zwar gibt es in \LaTeX{} selbst keinen Test, ob der für den Fuß
+ vorgesehene Platz dafür genügend Raum bietet, die Überschreitung der
+ vorgesehenen Höhe resultiert aber wahrscheinlich in einer unausgeglichenen
+ Verteilung von Satzspiegeln und Rändern. Außerdem führt beispielsweise das
+ Paket \Package{scrlayer-scrpage}, mit dem ein solcher Fuß\-in\-halt gesetzt
+ werden könnte, durchaus eine entsprechende Überprüfung durch und meldet
+ gegebenenfalls auch Überschreitungen. Daher ist es sinnvoll, die benötigte
+ größere Fußhöhe bereits bei der Berechnung des Satzspiegels anzugeben:
+\begin{lstcode}
+ \documentclass[a4paper]{article}
+ \usepackage[footlines=2.1]{typearea}
+\end{lstcode}
+ Es ist auch wieder möglich und bei Verwendung einer \KOMAScript-Klasse
+ empfehlenswert, diese Option direkt an die Klasse zu übergeben:
+\begin{lstcode}
+ \documentclass[footlines=2.1]{scrartcl}
+\end{lstcode}
+ Befehle, mit denen dann der Inhalt der zweizeiligen Fußzeile
+ definiert werden kann, sind in \autoref{cha:scrlayer-scrpage} zu finden.
+\end{Example}
+
+In einigen Fällen ist es nützlich, wenn man die Fußhöhe nicht in Zeilen,
+sondern direkt als Längenwert angeben kann. Dies ist mit Hilfe der alternativ
+verwendbaren Option \Option{footheight}\important{\Option{footheight}}
+möglich. Als \PName{Höhe} sind alle Längen und Größen verwendbar, die \LaTeX{}
+kennt. Es ist jedoch zu beachten, dass bei Verwendung einer \LaTeX-Länge wie
+\Length{baselineskip} nicht deren Größe zum Zeitpunkt des Setzens der Option,
+sondern zum Zeitpunkt der Berechnung des Satzspiegels und der Rändern
+entscheidend ist.
+
+Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Optionen bei
+Verwendung einer der \KOMAScript-Klassen als Klassenoptionen oder per
+\Macro{KOMAoptions} beziehungsweise \Macro{KOMAoption} nach dem Laden der
+Klasse übergeben werden müssen. Eine Änderung dieser Optionen nach dem Laden
+von \Package{typearea} führt nicht\textnote{keine automatische
+ Neuberechnung} zu einer automatischen Neuberechnung des
+Satzspiegels. Vielmehr wirkt sich die Änderung erst bei der nächsten
+Neuberechnung des Satzspiegels aus. Zur Neuberechnung des Satzspiegels siehe
+Option \Option{DIV} mit den Werten \PValue{last} oder \PValue{current} (siehe
+\autopageref{desc:typearea.option.DIV.last}) oder die Anweisung
+\Macro{recalctypearea} (siehe
+\autopageref{desc:typearea.cmd.recalctypearea}).%
+%
+\EndIndex{Option}{footheight~=\PName{Höhe}}%
+\EndIndex{Option}{footlines~=\PName{Anzahl}}
+
+
\BeginIndex{Cmd}{areaset}%
\begin{Declaration}
\Macro{areaset}\OParameter{BCOR}\Parameter{Breite}\Parameter{Höhe}
@@ -1388,18 +1507,26 @@ unberücksichtigt!
\Macro{topskip} ist. Die oberste Zeile benötigt damit keine Höhe. Die
Unterlängen der untersten Zeile ragen dafür unter den Satzspiegel.
-\item Soll stattdessen ein Gedichtband gesetzt werden, bei dem es nur
+\iffalse % Umbruchkorrekturtext
+ Soll stattdessen ein Gedichtband gesetzt werden, bei dem es nur
darauf ankommt, dass der Textbereich genau quadratisch mit einer
Seitenlänge von 15\Unit{cm} ist, wobei ein Binderand von
1\Unit{cm} zu berücksichtigen ist, so kann dies wie folgt
erreicht werden:
+%
+\else %
+ Soll stattdessen ein Gedichtband mit quadratischem Textbereich der
+ Seitenlänge 15\Unit{cm} und einem Binderand von 1\Unit{cm} gesetzt
+ werden, so ist folgendes möglich:
+%
+\fi
\begin{lstcode}
\documentclass{gedichte}
\usepackage{typearea}
\areaset[1cm]{15cm}{15cm}
-\end{lstcode}
-\end{Example}
-\EndIndex{Cmd}{areaset}
+\end{lstcode}%
+\end{Example}%
+\EndIndex{Cmd}{areaset}%
\BeginIndex{Option}{DIV~=\PValue{areaset}}%
@@ -1428,7 +1555,8 @@ Paketes
\Package{geometry}\IndexPackage{geometry}\important{\Package{geometry}} (siehe
\cite{package:geometry}) empfehlenswert.
%
-\else
+\fi
+\iffalse
%
Das Paket \Package{typearea} ist nicht dafür gedacht, bestimmte Randbreiten
einzustellen. Dafür ist das Paket \Package{geometry}\IndexPackage{geometry}
@@ -1458,8 +1586,7 @@ Seitengrößen.
\BeginIndex{Option}{paper~=\PName{Format}}%
\BeginIndex{Option}{paper~=\PName{Ausrichtung}}%
Die Option \Option{paper}\ChangedAt{v3.00}{\Package{typearea}} ist das
-zentrale Element der Formatauswahl bei \KOMAScript. Als
-\PName{Format}\important[i]{%
+zentrale Element der Formatauswahl\important[i]{%
\begin{tabular}[t]{@{}l@{}l@{}}
\KOption{paper} & \PValue{letter}, \\
& \PValue{legal}, \\
@@ -1467,12 +1594,11 @@ zentrale Element der Formatauswahl bei \KOMAScript. Als
& \PValue{A0}, \PValue{A1}, \PValue{A2} \dots\\
& \PValue{B0}, \PValue{B1}, \PValue{B2} \dots\\
& \PValue{C0}, \PValue{C1}, \PValue{C2} \dots\\
- & \PValue{D0}, \PValue{D1}, \PValue{D2} \dots\end{tabular}}
-wird
-dabei zunächst das amerikanische \Option{letter}, \Option{legal} und
-\Option{executive} unterstützt. Darüber hinaus sind die ISO-Formate der Reihen
-A, B, C und D möglich, also beispielsweise
-\PValue{A4} oder -- klein geschrieben -- \PValue{a4}.
+ & \PValue{D0}, \PValue{D1}, \PValue{D2} \dots\end{tabular}} %
+bei \KOMAScript. Als \PName{Format} wird dabei zunächst das amerikanische
+\Option{letter}, \Option{legal} und \Option{executive} unterstützt. Darüber
+hinaus sind die ISO-Formate der Reihen A, B, C und D möglich, also
+beispielsweise \PValue{A4} oder -- klein geschrieben -- \PValue{a4}.
Querformate\important{%
\begin{tabular}[t]{@{}l@{}l@{}}
@@ -1570,11 +1696,11 @@ Option \Option{DIV} mit den Werten \PValue{last} oder \PValue{current} (siehe
DVI-Formats\Index{DVI} sieht aber an keiner Stelle Angaben zum Papierformat
vor. Wird direkt aus dem DVI-Format in eine Low-Level-Druckersprache wie
PCL%
- \iffalse% Umbruchkorrektur
+ \iftrue% Umbruchkorrektur
\footnote{PCL ist die Druckersprache, die HP für seine Tinten- und
Laserdrucker verwendet.}%
\fi \ oder ESC/P2%
- \iffalse% Umbruchkorrektur
+ \iftrue% Umbruchkorrektur
\footnote{ESC/P2 ist die Druckersprache, die EPSON für seine Nadel-, Tinten-
und Laserdrucker benutzt.}%
\fi \ ausgegeben, spielt dies normalerweise keine Rolle, da auch bei diesen
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/scrguide.cls b/Master/texmf-dist/source/latex/koma-script/doc/scrguide.cls
index 1e397e31138..e4d540c3ffb 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/scrguide.cls
+++ b/Master/texmf-dist/source/latex/koma-script/doc/scrguide.cls
@@ -1,6 +1,6 @@
% ======================================================================
% scrguide.cls
-% Copyright (c) Markus Kohm, 2005-2012
+% Copyright (c) Markus Kohm, 2005-2013
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrguide.cls
-% Copyright (c) Markus Kohm, 2005-2012
+% Copyright (c) Markus Kohm, 2005-2013
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -38,7 +38,7 @@
% \section{Identification}
%
% \begin{macrocode}
-\ProvidesClass{scrguide}[2011/10/18 v1.6 internal KOMA-Script guide class]
+\ProvidesClass{scrguide}[2013/10/13 v1.7c internal KOMA-Script guide class]
% \end{macrocode}
%
%
@@ -92,8 +92,32 @@
%
% \section{Load the Base Class and Packages}
%
+% \begin{macro}{\KOMAProvidesFile}
+% \begin{macro}{\@KOMAProvidesFile}
+% Extended version of |\ProvidesFile|, that uses the date from the
+% repository.
+% \begin{macrocode}
+\newcommand*{\KOMAProvidesFile}{}
+\def\KOMAProvidesFile#1{%
+ \@ifnextchar [%]
+ {\@KOMAProvidesFile{#1}}{\ProvidesFile{#1}\relax}%
+}
+\newcommand*{\@KOMAProvidesFile}{}
+\def\@KOMAProvidesFile#1[$#2: #3-#4-#5 #6$#7]{%
+ \ifstr{#2}{Date}{%
+ \ProvidesFile{#1}[#3/#4/#5 #6 #7]\relax
+ }{%
+ \ClassError{scrguide}{missmatch repository date string}{%
+ It seams, that you haven't used $%
+ Date: YYYY-MM-DD $ for the date of \string\KOMAProvidesFile.}%
+ \ProvidesFile{#1}[$#2: #3/#4/#5 #6$#7]\relax
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
% NOTE: I use \texttt{latin1} instead of the prefered \texttt{utf8} because of
-% problems of package \textsf{listings}.
+% problems of early versions of package \textsf{listings}.
% \begin{macrocode}
\LoadClassWithOptions{scrbook}
\RequirePackage[latin1]{inputenc}
@@ -112,6 +136,7 @@
\RequirePackage{makeidx}
\RequirePackage{scrdate}
\RequirePackage{scrtime}
+\RequirePackage{picture}
\RequirePackage{graphicx}
\RequirePackage{booktabs}
\RequirePackage{longtable}
@@ -119,6 +144,7 @@
\RequirePackage{listings}
\RequirePackage{multicol}
\RequirePackage{marginnote}
+\RequirePackage{tabularx}
\RequirePackage{xcolor,tocstyle}% hyperref needs xcolor with tocstyle
\RequirePackage[\uselanguage]{hyperref}
\RequirePackage[open,openlevel=0]{bookmark}% improved pdf bookmarks
@@ -658,6 +684,9 @@
% This may already be defined.
% \begin{macrocode}
\providecommand*{\eTeX}{\ensuremath{\varepsilon}-\TeX}
+\providecommand*{\NTS}{%
+ \leavevmode\hbox{$\cal N\kern-0.35em\lower0.5ex\hbox{$\cal T$}%
+ \kern-0.2emS$}}
% \end{macrocode}
% \end{macro}
%
@@ -1027,6 +1056,8 @@
% to allow page breaks.
% \begin{macrocode}
\newenvironment{desctable}[1][\descdefaultindent]{%
+ \ClassError{scrguide}{deprecated environment}{%
+ please replace desctable by desclist}%
\onelinecaptionsfalse
\start@desctab{#1}%
\newcommand{\Endfirsthead}{\toprule\endfirsthead}%
@@ -1046,6 +1077,8 @@
% \end{environment}
%
% \begin{macro}{\start@desctab}
+% \changes{v1.7c}{2013/10/13}{\cs{leavevmode}\cs{ignorespaces} added to
+% \cs{nentry}}
% This is the \emph{worker} macro of \texttt{desctable} and
% \texttt{desctabular}. It does the complete calculations and definition of
% the entry (something like |\item|) commands.
@@ -1058,7 +1091,7 @@
\addtolength{\labelwidth}{-2\tabcolsep}%
\newcommand{\nentry}[2]{%
\multicolumn{2}{p{\labelwidth}}{\raggedright##1}\tabularnewline*%
- \hspace*{#1} & ##2\tabularnewline%
+ \hspace*{#1} & \leavevmode\ignorespaces ##2\tabularnewline%
}%
\newcommand{\entry}[2]{\nentry{##1}{##2}[.5\baselineskip]}%
\newcommand*{\pentry}[1]{%
@@ -1105,8 +1138,11 @@
\setbox\desccaptionb@xfirst\vbox{%
\tabular{p{\labelwidth}}%
\multicolumn{1}{@{}p{\dimexpr\labelwidth+2\tabcolsep}@{}}{%
- \captionaboveof{table}[##1]{##2}%
- }\tabularnewline[\dimexpr \abovecaptionskip\abovecaptionskipcorrection\relax]
+ \captionaboveof{table}[##1]{##2\unskip\strut}%
+ }\tabularnewline[%
+ \dimexpr \abovecaptionskip-\normalbaselineskip\relax
+% \dimexpr \abovecaptionskip-\abovecaptionskipcorrection\relax
+ ]
\toprule\tabularnewline
\endtabular
\vskip -\baselineskip
@@ -1135,21 +1171,35 @@
\ifx\relax##1\relax\else\vskip##1\relax\fi
}%
\renewcommand{\nentry}[2]{%
+ \typeout{TRACE: Generate entry}%
\setbox\descentryb@x\vbox{%
\ifx\desccaptionb@xnext\desccaptionb@xfirst\copy\desccaptionb@xnext\fi
- \tabular{lp{\descwidth}}%
+ \makebox[\linewidth][l]{\begin{tabular}{lp{\descwidth}}%
\multicolumn{2}{p{\labelwidth}}{\raggedright##1}\tabularnewline
\hspace*{#1} & ##2\tabularnewline
- \endtabular
+ \end{tabular}}%
}%
+ \typeout{TRACE: entry done}%
\begingroup
- \dimen@ \ht\descentryb@x \advance \dimen@ \dp\descentryb@x
- \advance \dimen@ \ht\descfootb@x \advance \dimen@ \dp\descfootb@x
+ \dimen@ \ht\descentryb@x
+ \advance \dimen@ \dp\descentryb@x
+ \ifdim \ht\descfootb@x>\ht\strutbox
+ \advance \dimen@ \ht\descfootb@x
+ \else
+ \advance \dimen@ \ht\strutbox
+ \fi
+ \ifdim \dp\descfootb@x>\dp\strutbox
+ \advance \dimen@ \dp\descfootb@x
+ \else
+ \advance \dimen@ \dp\strutbox
+ \fi
\advance \dimen@ \baselineskip
\dimen@ii \pagegoal \advance \dimen@ii -\pagetotal
- \typeout{TRACE: \the\dimen@>\the\dimen@ii?}%
+ \typeout{TRACE: \the\dimen@>\the\dimen@ii\space (footbox
+ ht=\the\ht\descfootb@x, dp=\the\dp\descfootb@x; strutbox
+ ht=\the\ht\strutbox, dp=\the\dp\strutbox)?}%
\ifdim \dimen@>\dimen@ii
- \typeout{TRACE: Break table}%
+ \typeout{TRACE: Break table \thetable}%
\ifx\desccaptionb@xnext\@empty
\csname @desclistentryhook\endcsname
{\copy\descfootb@x}%
@@ -1186,7 +1236,7 @@
}%
\csname @desclistentryhook\endcsname
{\copy\descfootb@x}%
- \par
+ \par\nobreak
\vskip -\baselineskip \vskip \intextsep
}
% \end{macrocode}
@@ -1207,72 +1257,54 @@
columns=fullflexible,keepspaces,%
aboveskip=.4\baselineskip,%
belowskip=0pt%
-}
-\lstdefinestyle{code}{%
+} \lstdefinestyle{code}{%
style=basics,%
language=[LaTeX]TeX,%
moretexcs={%
- @auxout,
- @currext,
- @empty,
- @float,
- @ifpackagelater,
- @ifundefined,
- @rightmark,
- @secondoftwo,
- @tempswafalse,@tempswatrue,
- @undefined,
- AtBeginDocument,AtEndDocument,
- appendix,
- ClassWarningNoLine,CurrentOption,
- DeclareOption,DeclareRobustCommand,dimexpr,
- end@float,
- ExecuteOptions,
- if@filesw,if@tempswa,if@twoside,
- includegraphics,
- MessageBreak,
+ @auxout, @currext, @empty, @float, @ifpackagelater, @ifundefined,
+ @rightmark, @secondoftwo, @tempswafalse,@tempswatrue, @undefined,
+ AtBeginDocument,AtEndDocument, appendix, ClassWarningNoLine,CurrentOption,
+ DeclareOption,DeclareRobustCommand,dimexpr, end@float, ExecuteOptions,
+ if@filesw,if@tempswa,if@twoside, includegraphics, MessageBreak,
onehalfspacing,
PackageError,PackageInfo,PackageWarning,PassOptionsToPackage,
ProcessOptions,protected@write,ProvidesFile,ProvidesPackage,
- RequirePackage,RequirePackageWithOptions,
- setkey,setlength,
+ RequirePackage,RequirePackageWithOptions,setkey,setlength,
+ SelectInputMappings,
textsuperscript}%
-}
-\lstdefinestyle{output}{%
+} \lstdefinestyle{output}{%
style=basics,breaklines,prebreak=\mbox{$\hookleftarrow$}%
-}
-\lstdefinestyle{KOMA}{%
+} \lstdefinestyle{KOMA}{%
style=code,%
moretexcs={%
- @addtoplength,@setplength,@newplength,
- activateareas,
+ @addtoplength,@setplength,@newplength, activateareas,
addchap,addrentry,Address,addcontentslinetoeachtocfile,addsec,
addtoeachtocfile,
addtokomafont,addtolengthplength,addtoreffields,addtotoclist,
adrchar,adrentry,AfterBibliographyPreamble,AfterCalculatingTypearea,
- AfterFile,AfterPackage,AfterStartingTOC,
+ AfterFile,AfterPackage,AfterStartingTOC,AfterTOCHead,
appendixmore,appendixname,areaset,autodot,automark,AtAddToTocList,
AtBeginLetter,
BeforeClosingMainAux,BeforePackage,bib@beginhook,bib@endhook,
+ blinddocument,blindtext,Blinddocument,Blindtext,
cc,captionabove,captionaboveof,captionbelow,captionbelowof,captionformat,
- captionof,cefoot,cfoot,chapapp,
- chapappifchapterprefix,
+ captionof,cefoot,cfoot,chapapp, chapappifchapterprefix,
chapter,chapterformat,chaptermarkformat,chapterpagestyle,chead,
cleardoubleevenemptypage,clearscrheadfoot,closing,cofoot,Comment,
DeclareNewTOC,
dedication,deffootnote,deffootnotemark,DefineFamily,DefineFamilyKey,
DefineFamilyMember,defpagestyle,deftripstyle,
dictum,dictumauthorformat,dictumrule,dictumwidth,doforeachtocfile,
- encl,extratitle,
- FamilyBoolKey,FamilyExecuteOptions,FamilyNumericalKey,%
+ encl,extratitle, FamilyBoolKey,FamilyExecuteOptions,FamilyNumericalKey,%
FamilyOption,FamilyOptions,FamilyProcessOptions,FamilySetBool,
figureformat,figurename,firstfoot,firsthead,FirstName,footfont,footref,
FreeI,FreeII,FreeIII,FreeIV,
+ GenericMarkFormat,
headfont,headmark,
ifattoclist,ifoot,ihead,ifkomavarempty,ifstr,ifthispageodd,InputAddressFile,
- KOMAoption,KOMAoptions,KOMAScript,
- l@addto@macro,LastName,LetterOptionNeedsPapersize,listoffigures,
- listoftables,listoftoc,LoadLetterOption,lohead,lowertitleback,
+ KOMAoption,KOMAoptions,KOMAScript, l@addto@macro,
+ LastName,lefoot,lehead,LetterOptionNeedsPapersize,lipsum,listoffigures,
+ listoftables,listoftoc,LoadLetterOption,lofoot,lohead,lowertitleback,
MakeMarkcase,maketitle,manualmark,marginline,minisec,
multfootsep,multiplefootnoteseparator,
Name,nameday,newbibstyle,newcaptionname,newkomavar,nexthead,
@@ -1281,11 +1313,11 @@
part,partformat,partname,partpagestyle,pnumfont,
PreventPackageFromLoading,publishers,ps,
raggedsection,raggedpart,raggedsignature,recalctypearea,
- refL,refS,refN,refParagraph,refParagraphN,refPar,refParL,refParS,refParN,
- refSentence,refSentenceL,refSentenceS,refSentenceN,
- rehead,
+ refL,refS,refN,refoot,
+ refParagraph,refParagraphN,refPar,refParL,refParS,refParN,
+ refSentence,refSentenceL,refSentenceS,refSentenceN,rehead,
removereffields,ReplaceInput,ReplacePackage,ResetPreventPackageFromLoading,
- sectionmarkformat,Sentence,sentencename,sentenceshortname,
+ rohead, sectionmarkformat,Sentence,sentencename,sentenceshortname,
setbibpreamble,setcapindent,setcapwidth,
setchapterpreamble,setfootbotline,setfootsepline,setfootwidth,
setheadsepline,setheadtopline,setheadwidth,setindexpreamble,setkomafont,
@@ -1296,19 +1328,13 @@
tableformat,tablename,tableofcontents,textsubscript,thechapter,thefigure,
thefootnotemark,thepar,thepart,thesection,thesentence,thesubsection,
thetable,thistime,
- titlehead,tocbasic@extend@babel,TOCclone,todaysname,typearea,
- unitfactor,
- unsettoc,usekomafont,useplength,usekomavar,uppertitleback
- }%
-}
-\lstset{style=basics}
-\lstnewenvironment{lstoutput}[1][]{%
+ titlehead,tocbasic@extend@babel,TOCclone,todaysname,typearea, unitfactor,
+ unsettoc,usekomafont,useplength,usekomavar,uppertitleback }%
+} \lstset{style=basics} \lstnewenvironment{lstoutput}[1][]{%
\lstset{style=output,basicstyle=\ttfamily\small,#1}%
-}{}
-\lstnewenvironment{lstcode}[1][]{%
+}{} \lstnewenvironment{lstcode}[1][]{%
\lstset{style=KOMA,basicstyle=\ttfamily\small,#1}%
-}{}
-\newcommand*{\lstinputcode}[1][]{%
+}{} \newcommand*{\lstinputcode}[1][]{%
\lstinputlisting[style=KOMA,basicstyle=\ttfamily\small,#1]%
}
% \end{macrocode}
@@ -1332,12 +1358,12 @@ KOMAScript \endcsname
%
% \begin{macro}{\url@}
% Redefine to make \texttt{CTAN://} be an alias for
-% \texttt{ftp://|\GuideCTANserver|/tex-archive/}.
+% \texttt{http://|\GuideCTANserver|/tex-archive/}.
% \begin{macrocode}
\def\url@#1{\expandafter\url@@#1\@nil}
\def\url@@#1://#2\@nil{%
\def\@tempa{#1}\def\@tempb{CTAN}\ifx\@tempa\@tempb
- \hyper@linkurl{\Hurl{#1://#2}}{ftp://\GuideCTANserver/tex-archive/#2}%
+ \hyper@linkurl{\Hurl{#1://#2}}{http://\GuideCTANserver/tex-archive/#2}%
\else
\hyper@linkurl{\Hurl{#1://#2}}{#1://#2}%
\fi